 


















                     ______________________________________________
                     VMS DECwindows Motif Installation Guide

                     Order Number: AA-PH9BA-TE


                     August 1991

                     This manual describes the VMS DECwindows Motif
                     installation procedure.





                     Revision/Update Information: This is a new manual.

                     Operating System:            VMS Version 5.4

                     Software Version:            VMS DECwindows Motif
                                                  Version 1.0








                     Digital Equipment Corporation
                     Maynard, Massachusetts

 






           __________________________________________________________
           August 1991

           The information in this document is subject to change
           without notice and should not be construed as a commitment
           by Digital Equipment Corporation. Digital Equipment
           Corporation assumes no responsibility for any errors that
           may appear in this document.

           The software described in this document is furnished under
           a license and may be used or copied only in accordance
           with the terms of such license.

           No responsibility is assumed for the use or reliability
           of software on equipment that is not supplied by Digital
           Equipment Corporation or its affiliated companies.

           Restricted Rights: Use, duplication, or disclosure by the
           U.S. Government is subject to restrictions as set forth in
           subparagraph (c)(1)(ii)  of the Rights in Technical Data
           and Computer Software clause at DFARS 252.227-7013.

            Digital Equipment Corporation 1991.

           All Rights Reserved.

           The postpaid Reader's Comments forms at the end of this
           document request your critical evaluation to assist in
           preparing future documentation.

           The following are trademarks of Digital Equipment
           Corporation: Bookreader, CDA, DEC, DECnet, DECwindows,
           DECwrite, Digital, LinkWorks, LiveLink, LN03, MicroVAX,
           PrintServer, ReGIS, ULTRIX, VAX, VAXcluster, VAXserver,
           VAXstation, VMS, VT, XUI, and the DIGITAL logo.

           Display PostScript and PostScript are registered
           trademarks of Adobe Systems Incorporated.

           Open Software Foundation, OSF, OSF/Motif, and Motif are
           trademarks of the Open Software Foundation, Inc.

                                                               ZK5656

           This document was prepared using VAX DOCUMENT, Version 1.2

 













   ________________________________________________________________

                                                           Contents


   Preface..................................................    vii


   1  Preparing to Install VMS DECwindows Motif Software

         1.1   Supported Hardware...........................    1-1
         1.2   Prerequisite Software........................    1-2
         1.3   License Registration.........................    1-2
         1.4   Privileges Needed for Installation...........    1-2
         1.5   Product and Device Names.....................    1-3
         1.6   Disk Space Considerations....................    1-3
         1.6.1     Setting up an Alternate Working Device...    1-5
         1.6.1.1     Using the Distributed File Service.....    1-6
         1.7   Installation Procedure Requirements..........    1-6
         1.7.1     VMSINSTAL Requirements...................    1-7
         1.7.1.1     System Account Quotas and Limits.......    1-8
         1.7.1.2     System Parameters......................    1-9
         1.7.1.3     Notify Other Users.....................   1-11
         1.7.1.4     Shut Down DECnet.......................   1-11
         1.7.1.5     Backing Up Your System Disk............   1-12
         1.7.2     Font Installation Consideration..........   1-12
         1.7.3     Checking AUTOGEN Feedback Data...........   1-13

   2  Installing VMS DECwindows Motif Software

         2.1   The Installation Procedure...................    2-2
         2.1.1     Starting the Installation................    2-2
         2.2   Error Recovery...............................   2-17
         2.3   Accessing the Release Notes..................   2-17





                                                                iii

 






     3  Customizing VMS DECwindows Motif Software

           3.1   Customizing the Server Startup...............    3-1
           3.2   Using Customer-Written Transports with
                 VMS DECwindows...............................   3-11
           3.3   Using the Example Transport..................   3-12
           3.4   Defining Print Formats.......................   3-13
           3.5   Compiling Ada Source Files...................   3-14

     4  Starting VMS DECwindows Motif

           4.1   Starting the VMS DECwindows Motif Software...    4-1
           4.2   Running the Installation Verification
                 Procedure....................................    4-3
           4.3   Choosing an Alternative Console..............    4-4

     5  Managing VMS DECwindows Motif

           5.1   Tuning Your System...........................    5-1
           5.2   Using DECW$MOTIF_TAILOR......................    5-1
           5.2.1     Removing VMS DECwindows Motif Files from
                     the System Disk..........................    5-4
           5.2.2     Adding VMS DECwindows Motif Files to the
                     System Disk..............................    5-7
           5.3   Determining and Reporting Problems...........    5-8

     A  VMS DECwindows Motif Sample Installation


     B  Sample Installation Verification Procedure

     C  VMS DECwindows Motif Software Components


     Index










     iv

 






        Examples

              5-1       Sample DECW$MOTIF_TAILOR Session.........    5-5

              A-1       Sample Installation......................    A-1

              B-1       Sample IVP...............................    B-1

        Tables

              1-1       Minimum System Parameter Values Required.   1-10

              3-1       VMS DECwindows Keymap....................    3-3

              3-2       Print Dialog Box Logical Names...........   3-13

              5-1       Classes of VMS Files
                        That Can Be Removed with
                        DECW$MOTIF_TAILOR........................    5-2

              C-1       VMS DECwindows Motif Software Components.    C-1
























                                                                       v

 











        ________________________________________________________________

                                                                 Preface



        Intended Audience

              This document is intended for anyone who plans to install
              the
              VMS DECwindows Motif software.

        Document Structure

              This document contains five chapters of information on
              VMS DECwindows Motif installation procedures and three
              appendixes.

              This document provides the following information:

              o  Chapter 1-Preparing a VMS system for the installation

              o  Chapter 2-Installing the software

              o  Chapter 3-Customizing the software

              o  Chapter 4-Starting VMS DECwindows Motif

              o  Chapter 5-Managing VMS DECwindows Motif

              o  Appendix A-Provides a sample VMS DECwindows Motif
                 installation

              o  Appendix B-Provides a sample Installation Verification
                 Procedure

              o  Appendix C-Provides a list of VMS DECwindows Motif
                 components


                                                                     vii

 






     Associated Documents

           The following documents are useful when installing VMS
           DECwindows Motif:

           o  The upgrade and installation supplement for your VAX
              computer

           o  Guide to Setting Up a VMS System

           o  VMS V5.4 Upgrade and Installation Manual

           o  VMS Authorize Utility Manual

           o  VMS System Generation Utility Manual

           o  VMS System Messages and Recovery Procedures

           o  VMS License Management Utility Manual

           o  Overview of VMS DECwindows Motif Programming Documentation

           o  VMS DECwindows Motif User's Guide

           The VMS DECwindows Motif Release Notes, contained on the
           media, may also be useful during the installation.

     Conventions

           The following conventions are used in this manual:

           Ctrl+x            A sequence such as Ctrl+x (or Ctrl/x)
                             indicates that you must hold down the
                             key labeled Ctrl while you press another
                             key or a pointing device button.

           <Return>          In examples, a key name is shown
                             enclosed in a box to indicate that you
                             press a key on the keyboard.

           blue-green ink    Blue-green ink indicates information
                             that you must enter from the keyboard or
                             a screen object that you must choose to
                             click on.

     viii

 







               . . .            In examples, a horizontal ellipsis
                                indicates one of the following
                                possibilities:

                                o  Additional optional arguments in a
                                   statement have been omitted.

                                o  The preceding item or items can be
                                   repeated one or more times.

                                o  Additional parameters, values, or
                                   other information can be entered.

                                A vertical ellipsis indicates the
                  .             omission of items from a code example or
                  .             command format; the items are omitted
                  .             because they are not important to the
                                topic being discussed.

              ( )               In format descriptions, parentheses
                                indicate that, if you choose more than
                                one option, you must enclose the choices
                                in parentheses.

              [ ]               In format descriptions, brackets
                                indicate that whatever is enclosed
                                within the brackets is optional; you
                                can select none, one, or all of the
                                choices. (Brackets are not, however,
                                optional in the syntax of a directory
                                name in a file specification or in the
                                syntax of a substring specification in
                                an assignment statement.)

              boldface text     Boldface text represents the intro-
                                duction of a new term or the name of
                                an argument, a field, a resource, or a
                                reason.

                                Boldface text is also used to show user
                                input in online versions of the book.



                                                                      ix

 







           italic text       Italic text represents information
                             that can vary in system messages (for
                             example, Internal error number).

           UPPERCASE TEXT    Uppercase letters indicate that you
                             must enter a command (for example, enter
                             OPEN/READ), or they indicate the name
                             of a routine, the name of a file, the
                             name of a file protection code, or the
                             abbreviation for a system privilege.

           -                 Hyphens in coding examples indicate that
                             additional arguments to the request are
                             provided on the line that follows.

           numbers           Unless otherwise noted, all numbers
                             in the text are assumed to be decimal.
                             Nondecimal radixes-binary, octal, or
                             hexadecimal-are explicitly indicated.

























     x

 









                                                                       1
        ________________________________________________________________

                      Preparing to Install VMS DECwindows Motif Software



              This chapter discusses the preparations and requirements
              necessary to install VMS DECwindows Motif software.

              Your bill of materials (BOM) and indented bills report
              (BIL) specify the number and contents of your kit. Be sure
              to verify the contents of your kit with this information.
              If your kit is damaged, or if you find that parts are
              missing, contact your Digital representative.

                ________________________Note  ________________________

                Digital strongly recommends that you read the VMS
                DECwindows Motif Release Notes before completing
                the installation. For information on accessing the
                release notes during the installation, see step 4 in
                Section 2.1.1.

                _____________________________________________________

        1.1 Supported Hardware

              The VMS DECwindows Motif software can be installed on any
              supported
              VAX computer. However, workstation device support for
              the VMS DECwindows Motif environment is limited to the
              following VAX computers:

                 VAXstation II
                 VAXstation II/RC
                 VAXstation II/GPX
                 VAXstation 2000
                 VAXstation 2000/GPX
                 VAXstation 3100/SPX
                 VAXstation 3200
                 VAXstation 35xx

                  Preparing to Install VMS DECwindows Motif Software 1-1

 






     1.2 Prerequisite Software

           VMS Version 5.4 (or a later version of VMS) provides the
           base system support for VMS DECwindows Motif. Your system
           must be running VMS Version 5.4 or a later version of VMS
           before you attempt to install VMS DECwindows Motif or the
           installation will fail. See the VMS Version 5.4 Upgrade
           and Installation Manual for instructions on how to install
           VMS Version 5.4.

     1.3 License Registration

           The License Management Facility (LMF) is used to register
           software product licenses in the LICENSE database. A soft-
           ware Product Authorization Key (PAK) for VMS DECwindows
           Motif is required to run DECwindows applications. The
           product name on the PAK must be DW-MOTIF. The DW-DEV-
           KIT-OSF-V PAK for the DECwindows Developer Kit on VMS for
           OSF/MOTIF product does not work with VMS DECwindows Motif.

              ________________________Note ________________________

              The VMS DECwindows Motif PAK must be registered
              and loaded before starting the VMS DECwindows Motif
              software installation or the installation will fail.

              _____________________________________________________

           If you plan to use VMS DECwindows Motif on more than one
           node in a VAXcluster, you must load a license on each of
           the other nodes after you complete this installation.

           For complete information on using the License Management
           Facility, see the VMS License Management Utility Manual.

     1.4 Privileges Needed for Installation

           To install VMS DECwindows Motif, you must be logged in
           to an account that has SETPRV or at least the following
           privileges:

           o  CMKRNL

           o  WORLD

           o  SYSPRV

     1-2 Preparing to Install VMS DECwindows Motif Software

 






              Digital recommends that you use the SYSTEM account for
              layered product installations. The SYSTEM account has the
              necessary privileges to perform product installations.
              Note that VMSINSTAL turns off the BYPASS privilege at the
              start of the installation and turns it back on when the
              installation completes.

        1.5 Product and Device Names

              During the installation, you need to tell the system
              which product is being installed and which drive contains
              the distribution media. You refer to a product with its
              facility name and version. You refer to a drive with its
              device name. Product and device names have the following
              format:

                 facvvu represents the facility name and version number
                 of the product being installed.

                 ddcu is the device name of the source drive that holds
                 the distribution media.

              For the VMS DECwindows Motif installation, the facvvu is
              DECW$MOTIF010. For additional information about the device
              names of devices on your system, see the installation
              supplement for your VAX computer.

        1.6 Disk Space Considerations

              Approximately 90,000 blocks of free disk space on the
              system disk would be required to install all of the VMS
              DECwindows Motif components. However, because you need not
              install all of the VMS DECwindows Motif components, your
              actual disk space requirement may be less.

              To determine the number of free blocks on the system disk,
              enter the following command:

              $ SHOW DEVICE SYS$SYSDEVICE

              The following list describes the approximate number of
              blocks needed for each portion of the software:

              o  Base kit: 32,000 blocks

                  Preparing to Install VMS DECwindows Motif Software 1-3

 






           o  Workstation device support: 21,000 blocks

              (This number includes both the 75 dots-per-inch (2600
              blocks) and 100 dots-per-inch (3600 blocks) fonts. You
              can install one or both font sets.)

           o  Programming environment: 37,000 blocks

              (This number includes all programming language support.
              The actual number of blocks required may be fewer
              depending on the language support that you select.)

           The installation procedure checks for free disk space on
           the system disk. If sufficient space is not found, the
           installation procedure provides options:

           o  You can install fewer optional files.

           o  You can restart the installation and specify an
              alternate working device (AWD) for the temporary
              working directory. See Section 1.6.1 for information on
              how to use an alternate working device.

           o  You can abort the installation and then create more
              free disk space on the system disk.

           To create free disk space, choose one of the following
           options:

           _  Delete or purge all unwanted files from the system

              disk.

           _  Copy the following files to another media type and

              delete them from the system disk:

              o  All files with file types of .JNL, .MAP, and .LOG

              o  All files in SYS$EXAMPLES and SYS$TEST

           _  Remove VMS operating system files that you do not need

              by using VMSTAILOR.

           _  Remove existing VMS DECwindows files that you do not

              need by using DECW$TAILOR.

           See the VMS Version 5.4 Upgrade and Installation Manual
           for information on using VMSTAILOR and DECW$TAILOR to
           remove files.

     1-4 Preparing to Install VMS DECwindows Motif Software

 






        1.6.1 Setting up an Alternate Working Device

              The AWD option lets you specify an alternate working
              device as the location for the temporary working
              directory. This allows you to perform the installation
              with fewer free blocks on the system disk than are
              otherwise required. Approximately 90,000 blocks of free
              disk space on the alternate working device are required to
              install all of the VMS DECwindows Motif components.

              To set up a temporary working directory (using an
              alternate working device) use the following format to
              invoke VMSINSTAL and specify the AWD option:

              $ @SYS$UPDATE:VMSINSTAL facvvu ddcu OPTIONS N,AWD=ddcu:[dir]

              where:

                 facvvu represents the product name and version number,

                 the first ddcu is the device name of the source drive
                 that holds the distribution media,

                 the second ddcu is the device name of the alternate
                 working device,

                 the dir is the name of the directory on the alternate
                 working device in which the product subdirectory is
                 created.

              For the VMS DECwindows Motif installation, the facvvu is
              DECW$MOTIF010.

              For example, if you are installing VMS DECwindows Motif
              from a TK50 cartridge and you want to create the working
              directory [INSTALL.DECW$MOTIF010] on the alternate device
              DUA2, enter the following command:

              $ @SYS$UPDATE:VMSINSTAL DECW$MOTIF010 MUA0: OPTIONS N,AWD=DUA2:[INSTALL]

              Specifying a directory is optional, but the following
              guidelines apply:

              o  If you specify a directory, VMSINSTAL creates a working
                 subdirectory for the product.

                  Preparing to Install VMS DECwindows Motif Software 1-5

 






           o  If you do not specify a directory, VMSINSTAL creates
              the working directory on the specified device with
              a directory specification of [000000.facvvu]. Again,
              facvvu represents the facility name and version number
              of the product.

           o  If you specify a nonexistent directory, VMSINSTAL does
              not create one. The directory that you specify must
              already exist.

           If you lack sufficient free disk space for installation
           and have no alternate working device, the installation
           procedure exits.

     1.6.1.1 Using the Distributed File Service

           A temporary working directory can be specified on a disk
           which utilizes the Distributed File Service (DFS).

           However, if you use a DFS-mounted disk as your alternate
           working device, the installation procedure erroneously
           reports that there are -1 free blocks on the alternate
           working device. This happens because it is impossible
           for the DFS client (the installation procedure, in this
           case) to determine the blocks of free disk space on the
           DFS-mounted disk.

           Before using a DFS-mounted disk, you should determine its
           free disk space. Do this by logging in to the system on
           which the disk is locally mounted and entering the command
           SHOW DEVICE. There must be approximately 90,000 blocks of
           free disk space on the DFS-mounted disk to complete the
           VMS DECwindows Motif installation.

     1.7 Installation Procedure Requirements

           The following sections discuss requirements for installing
           VMS DECwindows Motif.

           The installation takes approximately 1.5 to 3.5 hours,
           depending on the distribution medium, your system
           configuration, and which components you select.

           For example, installing the complete VMS DECwindows Motif
           kit on a standalone VAXstation 3500 system from TK50 media
           takes approximately
           2 hours.

     1-6 Preparing to Install VMS DECwindows Motif Software

 






              To run VMS DECwindows Motif, Digital requires a minimum
              system configuration of 8 megabytes of memory.

                ________________________Note  ________________________

                When VMS DECwindows Motif components are installed
                on a VAXcluster, only one installation per system
                root is required. No system-specific files are
                installed.

                _____________________________________________________

        1.7.1 VMSINSTAL Requirements

              The VMSINSTAL command procedure is the primary tool used
              by Digital to install VMS updates and layered software
              products. You use the VMSINSTAL command procedure to
              install VMS DECwindows Motif. Chapter 2 contains detailed
              instructions on installing VMS DECwindows Motif on your
              system.

              When you invoke VMSINSTAL, it checks to see:

              o  If you have set your default device and directory to
                 SYS$UPDATE

              o  If you are logged in to a privileged account

              o  If you have the minimum system account quotas and
                 limits required

              o  If you have the minimum system parameter values
                 required

              o  If any other users are logged in to the system

              o  If DECnet is running

              Prepare to install the VMS DECwindows Motif software by
              following these steps:

              1. Log in to a privileged account, such as the system
                 manager's (SYSTEM) account. While it is preferable to
                 perform the installation using the operator console
                 or other hardcopy terminal, it is possible to perform
                 the installation from a DECterm window. If you use a
                 DECterm window, make sure that no other VMS DECwindows
                 functions are invoked while the installation is

                  Preparing to Install VMS DECwindows Motif Software 1-7

 






              running. Do not switch input focus to other windows
              during the installation.

           2. Install VMS DECwindows Motif (see Chapter 2) before
              adding workstations to a VAXcluster with the CLUSTER_
              CONFIG command file. Installing VMS DECwindows Motif
              beforehand allows you to select VMS DECwindows Motif
              for each workstation in the VAXcluster.

     1.7.1.1 System Account Quotas and Limits

           Use the VMS Authorize Utility to make sure that the SYSTEM
           account has sufficient quotas and limits.

           1. Enter the following commands:

              $ SET DEFAULT SYS$SYSTEM
              $ RUN AUTHORIZE
              UAF> SHOW SYSTEM

           2. Compare the SYSTEM account's limits and quotas to the
              following minimum required values:

              _______________________________________________________
              Limit_or_quota__________________Value__________________

              Open file quota (FILLM)         20

              Buffered I/O limit (BIOLM)      18

              Direct I/O limit (DIOLM)        18

              AST limit (ASTLM)               24

              Enqueue quota (ENQLM)           30

              Buffered byte quota count       18000
              (BYTLM)________________________________________________

           3. Adjust the limits and quotas so that they are equal to
              or greater than the required values. You can change
              each value by entering a command in the following
              format:

              UAF> MODIFY SYSTEM/limit=new_value

              For example:

     1-8 Preparing to Install VMS DECwindows Motif Software

 






                 UAF> MODIFY SYSTEM/DIOLM=18

              4. When the adjustments are made, exit the Authorize
                 Utility by entering the following command:

                 UAF> EXIT

                 For more information on modifying quotas, see the VMS
                 Authorize Utility Manual.

              If you adjusted any of the SYSTEM account's values, log
              out and log in again so that the new values take effect.

        1.7.1.2 System Parameters

              VMS DECwindows Motif requires certain system parameter
              values. The VMSINSTAL procedure checks for the minimum
              values. In addition, the
              VMS DECwindows Motif startup procedure checks for
              correct values. Depending on the kinds of programs and
              applications running on your system, you might need higher
              values for some settings.

              Use the VMS System Generation Utility to make sure that
              the system parameter values are correct.

              1. Enter the following commands:

                 $ RUN SYS$SYSTEM:SYSGEN
                 SYSGEN> SHOW/ALL

              2. Compare your system's parameter values to the minimum
                 values shown in Table 1-1. Adjust the values on your
                 system so that they are equal to or greater than the
                 minimum values.

                 Many of the system generation parameters can affect
                 other parameters or the performance of a system. The
                 recommended method of modifying system parameters is
                 to modify the SYS$SYSTEM:MODPARAMS.DAT file and then
                 invoke AUTOGEN.

                 For more information on modifying system parameter
                 values using AUTOGEN, see the Guide to Setting Up a VMS
                 System.

                  Preparing to Install VMS DECwindows Motif Software 1-9

 






           Table 1-1 lists the minimum system parameter values re-
           quired for
           VMS DECwindows Motif.


           Table_1-1_Minimum_System_Parameter_Values_Required________

           Parameter_____________Minimum_Value____Unit_______________

           CHANNELCNT            255              channels

           GBLPAGES              n + 30000[1]     pages

           GBLPAGFIL             6024             pages

           GBLSECTIONS           n + 400[1]       sections

           MAXBUF                2048             bytes

           PQL_DPGFLQUOTA        5000             pages

           PQL_DWSEXTENT         500              pages

           PQL_MASTLM            100              AST

           PQL_MBIOLM            40               I/O

           PQL_MBYTLM            32768            bytes

           PQL_MDIOLM            40               I/O

           PQL_MFILLM            8                files

           PQL_MPRCLM            8                processes

           SWPOUTPGCNT           500              pages

           [1]The_value_n_represents_your_system's_current_setting.__

           The values listed for global pages and global sections
           must be added to n since the increased values are required
           for the installation. They do not represent the total
           number you need to run your system and other software.

                                             (continued on next page)

     1-10 Preparing to Install VMS DECwindows Motif Software

 






              Table 1-1 (Cont.) Minimum System Parameter Values
              __________________Required________________________________

              Parameter_____________Minimum_Value____Unit_______________

              SPTREQ                2500             pages

              VIRTUALPAGECNT________20000____________pages______________

        1.7.1.3 Notify Other Users

              Make sure that you are the only user logged in by doing
              the following:

              a. Notify current users that they must log out by entering
                 the following command:

                 $ REPLY/ALL/BELL/SHUTDOWN "Log out for DECwindows installation please..."

              b. Enter the following command to prevent nonprivileged
                 users from logging in to the system:

                 $ SET LOGINS/INTERACTIVE=0

        1.7.1.4 Shut Down DECnet

              You are not required to shut the network down, but you
              can if you wish to do so. To check whether your system
              includes DECnet-VAX software, enter the following command:

              $ SHOW NETWORK

              Proceed to Section 1.7.1.5 if your system displays the
              following message:

              %SHOW-I-NONET, network unavailable

              If your system includes DECnet-VAX software, and you want
              to shut it down, enter the following commands:

              $ RUN SYS$SYSTEM:NCP
              NCP> SET EXECUTOR STATE OFF
              NCP> EXIT

              Although not required, Digital recommends that you back up
              your system disk as discussed in Section 1.7.1.5.

                 Preparing to Install VMS DECwindows Motif Software 1-11

 






     1.7.1.5 Backing Up Your System Disk

           At the beginning of the installation, VMSINSTAL asks if
           you have backed up your system disk. Digital recommends
           that you back up your system disk before installing any
           software.

           Use the backup procedures established at your site.
           For details on performing a system disk backup, see the
           upgrade and installation supplement for your VAX computer.

     1.7.2 Font Installation Consideration

           During the VMS DECwindows Motif installation, you can
           choose to install workstation device support. Font files,
           which are needed for server text display and application
           support, are provided in the workstation device support.

           As part of its function, the font file installation
           procedure deletes font files, font directory files, and
           font alias files from the following system directories:

              [SYSFONT.DECW.75DPI]
              [SYSFONT.DECW.100DPI]
              [SYSFONT.DECW.COMMON]
              [SYSFONT.DECW.CURSOR16]
              [SYSFONT.DECW.CURSOR32]
              [SYSFONT.XDPS.FONT_MAP]*.DAT;*

           All font files in those system directories, including
           any that were installed by a previous version of VMS
           DECwindows and any that were installed by a user, are
           deleted by the installation procedure. The installation
           procedure deletes font files from the system font
           directories only.

           If you want to retain a font file currently contained in
           any of those directories, you must move the font file to
           one of the following user font directories before starting
           the installation:

              SYS$COMMON:[SYSFONT.DECW.USER_75DPI]
              SYS$COMMON:[SYSFONT.DECW.USER_100DPI]
              SYS$COMMON:[SYSFONT.DECW.USER_COMMON]
              SYS$COMMON:[SYSFONT.DECW.USER_CURSOR16]

     1-12 Preparing to Install VMS DECwindows Motif Software

 






                 SYS$COMMON:[SYSFONT.DECW.USER_CURSOR32]

              All user and layered-product fonts should be placed in the
              user font directories.

        1.7.3 Checking AUTOGEN Feedback Data

              The AUTOGEN command procedure included in the VMS
              operating system establishes initial values for all
              the configuration-dependent system parameters so that
              they match your particular configuration. After the VMS
              DECwindows Motif installation is finished, AUTOGEN may
              run, depending on the type of system you are using. If
              AUTOGEN finds valid feedback data on your system, it tries
              to use the AUTOGEN feedback mechanism. Feedback data is
              produced by the SAVPARAMS phase of AUTOGEN and is stored
              in SYS$SYSTEM:AGEN$FEEDBACK.DAT.

              However, before you start the VMS DECwindows Motif
              installation, you should ensure that AUTOGEN will use
              valid feedback data.

              Valid feedback data is defined as follows:

              o  The system was up for at least 24 hours when the
                 feedback data was gathered.

              o  The feedback data is not over 30 days old.

                ________________________Note  ________________________

                If your feedback data is NOT valid, AUTOGEN
                runs WITHOUT feedback (all previous feedback-
                generated parameters will be replaced by the AUTOGEN
                NOFEEDBACK calculations.)

                _____________________________________________________

              You should follow these steps before starting the
              installation to ensure that the feedback data is valid:

              1. Check the validity of your current feedback data by
                 entering the following command:

                 $ @SYS$UPDATE:AUTOGEN GETDATA TESTFILES

                 This command is for test purposes and does not result
                 in the modification of SYSGEN parameters or changes

                 Preparing to Install VMS DECwindows Motif Software 1-13

 






              to the page and swap files. System page, swap, and
              dump file sizes generated by AUTOGEN are displayed
              and are also placed in the PARAMS.DAT file. If your
              current feedback is valid, AUTOGEN uses it during the
              installation.

              AUTOGEN issues several warnings if your current
              feedback data is invalid. If your current feedback
              data is invalid, go to step 2.

           2. If your current feedback in invalid, you can generate
              new feedback data (assuming your system was up for at
              least 24 hours). Enter the following command:

              $ @SYS$UPDATE:AUTOGEN SAVPARAMS TESTFILES

              This command is for test purposes and does not result
              in the modification of SYSGEN parameters or changes to
              the page and swap files. System page, swap, and dump
              file sizes generated by AUTOGEN are displayed. Feedback
              information is recorded in AGEN$FEEDBACK.DAT. Again,
              AUTOGEN warns you if the feedback data just produced is
              invalid.

           3. If your current feedback data is valid, AUTOGEN uses
              your current feedback-generated parameters during
              the installation. Your current feedback-generated
              parameters are not lost during the installation.

              For more information about using AUTOGEN, see the Guide
              to Setting Up a VMS System.














     1-14 Preparing to Install VMS DECwindows Motif Software

 









                                                                       2
        ________________________________________________________________

                                Installing VMS DECwindows Motif Software



              This chapter explains how to install VMS DECwindows Motif
              using the VMSINSTAL procedure. Section 2.1 contains a
              step-by-step description of the installation procedure.

              The VMS DECwindows Motif installation takes approximately
              1.5 to 3.5 hours, depending on the distribution medium and
              the processor type. The VMSINSTAL procedure installs VMS
              DECwindows Motif on your system disk.

                ________________________Note  ________________________

                A Product Authorization Key for VMS DECwindows Motif
                must be registered and loaded before starting the
                VMS DECwindows Motif installation. See Section 1.3
                for more information on license registration.

                If you do not have a satisfactory backup copy
                of your system disk, do not attempt to install
                the VMS DECwindows Motif software. You should
                back up the system disk (as described in the VMS
                upgrade and installation supplement for your VAX
                computer) before you install the VMS DECwindows
                Motif software.

                Before beginning the installation procedure, you
                should review Chapter 1 for more information on
                installation preparations and requirements.

                _____________________________________________________






                            Installing VMS DECwindows Motif Software 2-1

 






     2.1 The Installation Procedure

           The VMS DECwindows Motif installation procedure consists
           of a series of questions, which require user responses,
           and informational messages. You can enter a question mark
           (?) for help at any time during the installation. See
           Appendix A for a sample installation.

           To abort the installation procedure at any time, press
           Ctrl+Y. When you press Ctrl+Y, the installation procedure
           deletes all files it has created up to that point and
           exits. You can then start the installation again.

     2.1.1 Starting the Installation

           Perform the following steps to run the VMSINSTAL command
           procedure and to install the VMS DECwindows Motif
           software:

           1. Locate the VMS DECwindows Motif distribution media.

           2. If your system is not already running, start up the
              system and log in to a privileged account such as the
              system manager (SYSTEM) account.

           3. Put the distribution medium in the source drive. If
              your VMS DECwindows Motif distribution kit contains
              more than one piece of media, put the first one in the
              drive. During the installation procedure, you will be
              prompted to load the next piece of media. The paper
              labels on the media indicate the order in which you use
              them.

           4. Start the VMSINSTAL procedure. You must specify a
              product name on the command line. The product name
              for the VMS DECwindows Motif software is DECW$MOTIF010.

              Specify OPTIONS N on the command line to access the
              release notes contained in your kit. The VMS DECwindows
              Motif Release Notes can be displayed or printed before
              the installation begins, as described in step 9. Enter
              the following command:

              $ @SYS$UPDATE:VMSINSTAL DECW$MOTIF010 ddcu: OPTIONS N

     2-2 Installing VMS DECwindows Motif Software

 






                 where ddcu is the device name of the source drive that
                 holds the distribution media. See Section 1.5 for more
                 information about the format of product and device
                 names. Also refer to the VMS upgrade and installation
                 supplement for your VAX computer.

                 For example, if you are installing VMS DECwindows Motif
                 from a magnetic tape cartridge in drive MUA0:, enter
                 the following command to invoke the VMSINSTAL command
                 procedure:

                 $ @SYS$UPDATE:VMSINSTAL DECW$MOTIF010 MUA0: OPTIONS N

                 If you are installing VMS DECwindows Motif using the
                 alternate working device (AWD) option described in
                 Chapter 1, invoke the VMSINSTAL command procedure as
                 follows:

                 $ @SYS$UPDATE:VMSINSTAL DECW$MOTIF010 ddcu: OPTIONS N,AWD=ddcu:[INSTALL]

                 The first variable ddcu is the device name of the
                 source drive that holds the distribution media.
                 The second variable ddcu is the device name of the
                 alternate working device which is the target device.

                 For example, if you are installing VMS DECwindows Motif
                 from a magnetic tape cartridge in drive MUA0: using an
                 alternate working device DUA2: and directory [INSTALL],
                 enter the following command:

                 $ @SYS$UPDATE:VMSINSTAL DECW$MOTIF010 MUA0: OPTIONS N,AWD=DUA2:[INSTALL]

                 If the VMSINSTAL command fails, check to see if any of
                 the following conditions occurred:

                 o  You entered the product name incorrectly. VMSINSTAL
                    displays the following message:

                    %VMSINSTAL-E-NOPRODS, None of the specified products were found

                 o  You specified an incorrect name for the source
                    drive. VMSINSTAL displays an "invalid device" error
                    message and prompts you until you enter the name of
                    a source device that exists on the system. Remember
                    to enter a colon (:) after the device name.

                            Installing VMS DECwindows Motif Software 2-3

 






              o  You specified an AWD directory that does not exist.
                 Create the directory and restart the VMSINSTAL
                 procedure.

           5. The VMSINSTAL procedure displays messages similar to
              the following:

                     VAX/VMS Software Product Installation Procedure V5.4

              It is 1-Sep-1991 at 08:02
              Enter a question mark (?) at any time for help.

           6. The procedure asks the following question:

              * Are you satisfied with the backup of your system disk [YES]?

              If you made a backup copy of your system disk, press
              the Return key and go to step 7.

              If you did not make a backup copy of the system disk,
              do the following:

              a. Enter NO and press the Return key. The VMSINSTAL
                 procedure exits and returns to DCL level.

              b. Back up the system disk as described in the VMS
                 upgrade and installation supplement for your VAX
                 computer.

              c. After you have made a backup copy of the system
                 disk, start the installation procedure again from
                 step 4.

           7. VMSINSTAL instructs you to mount the first volume of
              the set. Load the medium and enter YES, as follows:

              (Please mount the first volume of the set on MUA0:.
              * Are you ready?) (YES)
              %MOUNT-I-MOUNTED, DWM010 mounted on _MUA0:

           8. When the installation begins, VMSINSTAL displays
              informational text similar to the following:

              The following products will be processed:

                DECW$MOTIF V1.0

                      Beginning installation of DECW$MOTIF V1.0 at 08:10

     2-4 Installing VMS DECwindows Motif Software

 






                 %VMSINSTAL-I-RESTORE, Restoring product save set  A...

              9. If you specified OPTIONS N in step 4, VMSINSTAL now
                 prompts you to select a release notes option:

                 Release notes included with this kit are always copied to SYS$HELP.

                     Additional Release Notes Options:

                  1.  Display release notes
                  2.  Print release notes
                  3.  Both 1 and 2
                  4.  None of the above

                 * Select option [2]:

                 o  Select option 1 to display the release notes on the
                    terminal.

                 o  Select option 2 to print the release notes.

                 o  Select option 3 to display and print the release
                    notes.

                 o  Select option 4 if you do not want to display or
                    print the release notes.

                 Enter the number of the option you want. Option 2 is
                 the default. If you select option 2 or 3, you are
                 prompted for the name of the print queue. If you do
                 not specify a print queue, the release notes are queued
                 to SYS$PRINT by default.

                ________________________Note  ________________________

                Digital recommends that you read the release notes
                before completing the installation.

                _____________________________________________________

                 After you select a release notes option, the VMSINSTAL
                 procedure displays the following message:

                 * Do you want to continue the installation [NO]?

                 If you want to continue with the installation, enter
                 YES. If you want to abort the installation, press the
                 Return key.

                            Installing VMS DECwindows Motif Software 2-5

 






              Regardless of the release notes option selected,
              the VMSINSTAL procedure copies the release notes
              to the SYS$HELP directory. See Section 2.3 for more
              information on accessing the release notes once they
              have been copied to the SYS$HELP directory.


              %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

                     *** Installing VMS DECwindows Motif software ***

              You can install the VMS DECwindows Motif kit completely or in selected
              portions.  A complete installation requires as much as 90,000 blocks.
              If you choose to perform a partial installation, you can tailor the device
              support that you want provided for VMS DECwindows Motif workstations and
              the programming support that you want provided for VMS DECwindows Motif
              application development.  Whether you perform a complete or partial
              installation, this kit provides support for running VMS DECwindows Motif
              applications on VMS compute servers.

           10.You can install the entire VMS DECwindows Motif
              software kit, or you can install parts of the kit.
              The VMS DECwindows base kit is always installed. The
              following parts of the kit are optional:

              o  VMS DECwindows workstation device support

              o  PEX, which is the PHIGS Extension to X

              o  VMS DECwindows Motif programming environment

              The procedure asks you if you want to install the
              entire kit:

              * Do you want to install the entire kit [Y]?

              ________________________Note ________________________

              If you install the entire kit, the installation
              procedure deletes all previously installed font
              files from the system directories listed in
              Section 1.7.2. If you want to retain an existing
              font file, you must move it to a directory other
              than the system directories listed in Section 1.7.2
              before proceeding with the installation. Press
              Ctrl+Y if you want to abort the installation now.

     2-6 Installing VMS DECwindows Motif Software

 






                See Section 1.7.2 for more information on retaining
                existing font files.

                _____________________________________________________

                 If you want the entire kit installed, press the Return
                 key and proceed to step 16. If you do not want to
                 install the entire kit, enter NO.

              11.The procedure asks you if you want to install
                 workstation device support by prompting you with the
                 following message:

                 If you are not installing this kit on a workstation, or on a VAXcluster
                 that includes workstations, you can save up to 17,000 blocks by omitting
                 the device support required to make workstation graphics hardware
                 available to VMS DECwindows Motif.

                 * Do you want to install VMS DECwindows workstation device support [Y]?

                 To install workstation device support, press the Return
                 key. If you enter NO, the messages in steps 12 and 13
                 do not appear and the VMSINSTAL procedure continues
                 with the programming environment messages in step 14.

              12.If you selected workstation device support, you must
                 specify the type of video fonts you want installed (75
                 dpi or 100 dpi). The procedure prompts you with the
                 following message:

                 This installation procedure provides video fonts for specific monitor
                 resolutions. Fonts are supplied for the following monitor resolutions:

                      75 dots per inch
                     100 dots per inch

                 All VMS DECwindows Motif applications run with 75 dots per inch (dpi)
                 fonts.  Some applications take advantage of 100 dpi fonts. If you
                 select 100 dpi fonts, 75 dpi fonts are automatically provided. Both
                 font resolutions are provided to allow your system to run those VMS
                 DECwindows Motif applications that require 100 dpi fonts and those that
                 require 75 dpi fonts.

                 For instructions on how to configure your system with both 75 and 100 dpi
                 fonts, see the installation guide or examine the template command
                 procedure SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.TEMPLATE.  By default,
                 systems start up using 75 dpi fonts.

                            Installing VMS DECwindows Motif Software 2-7

 






              Note that this procedure deletes previously installed fonts before
              installing new ones.  If you choose to reinstall this kit at a later
              date, be sure to install all required fonts.

              * Do you want both sets of video fonts installed [Y]?

              ________________________Note ________________________

              The installation procedure deletes all previously
              installed font files from the system directories
              listed in Section 1.7.2. If you want to retain
              an existing font file, you must move it to a
              directory other than the system directories
              listed in Section 1.7.2 before proceeding with the
              installation. Press Ctrl+Y if you want to abort the
              installation now.

              See Section 1.7.2 for more information on retaining
              existing font files.

              _____________________________________________________

              Press the Return key if you want both the 75-dpi
              and 100-dpi fonts installed. If you enter NO, you
              are prompted to select the font you want installed.
              (If you select 100-dpi fonts, 75-dpi fonts are also
              automatically installed.)

           13.Optionally, you can install support for the PHIGS
              Extension to X (PEX). PEX is the 3D extension of X that
              allows 3D graphics functionality within an X window
              for users of PHIGS or PEX protocol-producing clients.
              The procedure asks you if you want to install PEX by
              prompting you with the following message:

              If you are not installing this kit on a workstation, or on a VAXcluster
              that includes workstations, you can save up to 4000 blocks by omitting
              PEX (PHIGS Extensions to X) support for PHIGS.

              * Do you want to install VMS DECwindows Motif PEX support for PHIGS [Y]?

              Press the Return key if you want PEX support installed.
              Enter NO if you do not want PEX support installed.


     2-8 Installing VMS DECwindows Motif Software

 






              14.The installation procedure asks you if you want to
                 install programming support by prompting you with the
                 following message:


                 This installation procedure provides support files for developing VMS
                 DECwindows Motif applications in several programming languages.  These
                 files are needed only to develop applications and are not required to run
                 VMS DECwindows Motif applications.  Support for each programming language
                 requires approximately 3,400 blocks.

                 * Do you want to install VMS DECwindows Motif programming support [Y]?

                 If you do not want to install programming support,
                 enter NO and proceed to step 16. Press the Return key
                 to install programming support.

                 Support files are supplied for the following VAX programming languages:

                          Ada, BASIC, BLISS, C, FORTRAN, MACRO, Pascal, PL/1

                 In addition, support files are supplied for programming in the C language
                 using conventions and standards developed at the Massachusetts Institute
                 of Technology.

                 Note that this procedure deletes previously installed programming
                 language support files before installing new ones.  If you choose to
                 reinstall this kit at a later date, be sure to install all required
                 programming language support files.

                 The eight programming languages listed (Ada, BASIC,
                 BLISS, C, FORTRAN, MACRO, Pascal, and PL/1) are all
                 supported for Xlib and the XUI toolkit. However, only
                 four of the programming languages (Ada, C, FORTRAN,
                 and Pascal) are supported for the VMS DECwindows Motif
                 toolkit.

              15.The procedure asks you if you want to install all of
                 the programming support files by prompting you with the
                 following message:

                 * Do you want to install all programming language support files [Y]?

                 Press the Return key if you want all the languages
                 installed. If you do not want all of the languages
                 installed, enter NO. Each language is then displayed.
                 Enter YES for each language you want installed.

                            Installing VMS DECwindows Motif Software 2-9

 






           16.The kit parts that you have chosen are now displayed,
              allowing you to verify that these selections are
              correct. A message similar to the following is
              displayed:

              You have selected the following portions of the kit:

                o VMS DECwindows Motif Compute Server Support

                o VMS DECwindows Workstation Device Support

                  75 dots per inch video fonts

                o VMS DECwindows Motif Programming Support

                  MIT C language programming conventions

              * Are these selections correct [Y]?

              Press the Return key if the selections are correct. If
              you want to change your selections, enter NO. You are
              prompted by the previous questions again, starting at
              step 10. Once you have repeated the selection procedure
              and are satisfied with your selections, answer YES.

           17.The installation procedure checks to see if your system
              disk has enough free blocks.

              a. If the blocks are available, the installation
                 continues at step 18.

              b. If you do not have sufficient system disk space
                 to install the portions you have chosen, the
                 installation displays a message similar to the
                 following:

     Your system disk has only 25364 free blocks, and
     you have selected to install approximately 76050 blocks.

       *  *  *  NOTE  *  *  *

     Although the installation procedure estimates you do not have enough disk
     space to complete the installation, it may be possible to continue
     successfully if you are installing VMS DECwindows Motif on a system which
     already has VMS DECwindows installed.

     * Do you want to reselect which VMS DECwindows Motif options to install [Y]?

     2-10 Installing VMS DECwindows Motif Software

 






                    If you press the Return key, you can reselect the
                    VMS DECwindows Motif options starting at step 10. If
                    you enter NO, the procedure asks you if you want to
                    continue the installation:

                    * Do you want to continue the installation anyway [Y]?

                    If you press the Return key, the installation
                    continues. If you enter NO, the installation exits.
                    You can then free up blocks on the system disk. See
                    Section 1.6 for information on creating more free
                    blocks on the system disk.

                    After you create more free blocks on the system
                    disk, start the
                    VMS DECwindows Motif installation again at step
                    4.

                 c. If you still do not have sufficient free blocks on
                    the system disk to install the portions you have
                    chosen and you did not specify an alternate working
                    device (AWD), the installation displays a message
                    similar to the following:

        Your system disk has only 25364 free blocks, and
        you have selected to install approximately 76050 blocks.

        You should either reselect which VMS DECwindows Motif options to install, or
        restart this installation using the AWD=dev:[dir] option.

           *  *  *  NOTE  *  *  *

        Although the installation procedure estimates you do not have enough disk
        space to complete the installation, it may be possible to continue
        successfully if you are installing VMS DECwindows Motif on a system which
        already has VMS DECwindows installed.

        * Do you want to reselect which VMS DECwindows Motif options to install [Y]?

                    If you press the Return key, you can reselect the
                    VMS DECwindows Motif options starting at step 10. If
                    you enter NO, the procedure asks you if you want to
                    continue the installation:

                    * Do you want to continue the installation anyway [Y]?

                           Installing VMS DECwindows Motif Software 2-11

 






                 If you press the Return key, the installation
                 continues. If you enter NO, the installation
                 exits. Start the installation again (step 4) and
                 specify the AWD on the VMSINSTAL command line.
                 See Section 1.6.1 for information on using the AWD
                 directory.

              d. If you specify an AWD that does not have sufficient
                 disk space to install the portions you have chosen,
                 the installation displays a message similar to the
                 following:

                 Your specified alternate working directory device has only 68977
                 free blocks, and this installation will require approximately 76050 blocks.

                 You should either reselect which VMS DECwindows Motif options to install, or
                 restart this installation using an alternate working directory device with
                 more free blocks.

                    *  *  *  NOTE  *  *  *

                 Although the installation procedure estimates you do not have enough disk
                 space to complete the installation, it may be possible to continue
                 successfully if you are installing VMS DECwindows Motif on a system which
                 already has VMS DECwindows installed.

                 * Do you want to reselect which VMS DECwindows Motif options to install [Y]?

                 If you press the Return key, you can reselect the
                 VMS DECwindows Motif options starting at step 10. If
                 you enter NO, the procedure asks you if you want to
                 continue the installation:

                 * Do you want to continue the installation anyway [Y]?

                 If you press the Return key, the installation
                 continues. If you enter NO, the installation exits.
                 Restart the installation once you have set up an AWD
                 with sufficient disk space. See Section 1.6.1 for
                 more information on using an AWD.

           18.The installation procedure continues and displays
              license information similar to the following:


     2-12 Installing VMS DECwindows Motif Software

 






                 A registered and loaded Product Authorization Key for DW-MOTIF is
                 required to run any applications with VMS DECwindows Motif.
                 If you answer NO to the next question, the installation of
                 VMS DECwindows Motif will be aborted.

                   Product: DW-MOTIF
                   Producer: DEC
                   Version: 1.0
                   Release Date: 1-JUL-1991

                 * Does this product have an authorization key registered and loaded ?

                 Enter YES to continue with the installation if your
                 authorization key is registered and loaded. If you
                 enter NO, the following message is displayed and the
                 installation is aborted:

                 Installation of VMS DECwindows Motif cannot continue because you do
                 not have a registered and loaded authorization key.

                 See Section 1.3 for more information on license regis-
                 tration. After you have registered and loaded your au-
                 thorization key, restart the
                 VMS DECwindows Motif installation, beginning at step 4.

              19.The installation procedure informs you that you
                 should perform a system reboot to ensure successful
                 installation of VMS DECwindows Motif. A system reboot
                 is required for all workstations and all nonworkstation
                 cluster boot nodes. The installation procedure informs
                 you if a system reboot is needed for your system.

                  To complete the installation of this product, you should reboot
                  the system.  If it is not convenient to reboot at this time, then
                  enter NO to the following question.

                  If you enter NO, the installation procedure will continue.

                 * Will you allow a system shutdown after this product is installed [YES]?

                 If you enter NO to the shutdown question, the VMSINSTAL
                 procedure displays the following message:



                           Installing VMS DECwindows Motif Software 2-13

 






                 * * * NOTE * * *

              Successful installation of this product may require a reboot.  You will
              be informed at the end of this installation, based upon your system type
              and its system parameter values, whether or not a reboot is required.

              If you answered YES to the shutdown question, the
              VMSINSTAL procedure displays the following questions
              about the shutdown:

              * How many minutes for system shutdown [0]?
              * Do you want to do an automatic system reboot [YES]?
              * Do you want to purge files replaced by this installation [YES]?

              Purging files deletes multiple copies of files and
              increases space on the system disk. If you want
              to purge files replaced by the installation, press
              the Return key. If you do not want to purge these
              files, enter NO. The VMSINSTAL procedure displays the
              following message:

              No further questions will be asked.

              If your media kit contained more than one piece of
              media, the installation procedure prompts you to load
              the next piece of media when it is finished with the
              first piece of media.

           20.VMSINSTAL lists the directories that are created and
              the save sets that are restored. Messages similar to
              the following are displayed:

              %VMSINSTAL-I_RESTORE, Restoring product saveset C...
              %VMSINSTAL-I-SYSDIR, This product creates system disk directory
              VMI$ROOT:[SYSFONT.DECW.COMMON].

           21.VMSINSTAL moves files to their target directories. The
              following text is displayed:

              %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

              If you have previously installed any layered products
              on your system that provide X server font files,
              you will see informational messages similar to the
              following:

     2-14 Installing VMS DECwindows Motif Software

 






                 Creating sys$common:[sysfont.decw.user_75dpi]DECW$FONT_DIRECTORY.DAT
                 30 fonts loaded
                 Creating sys$common:[sysfont.decw.user_100dpi]DECW$FONT_DIRECTORY.DAT

                 The installation procedure informs you that a spurious
                 error message will be displayed and that you can safely
                 ignore it:

                   You may safely ignore the following NCP error message(s).

                 %NCP-W-UNRCMP, unrecognized component , object

                 You are then notified that the Installation Verification
                 Procedure (IVP) should be run after the installation
                 has completed and after you have started VMS DECwindows
                 Motif. See Section 4.2 for more information on running
                 the IVP.

                 The Installation Verification Procedure (IVP) should be run after the
                 installation has completed and DECwindows has been restarted.  The IVP
                 can be found in SYS$TEST:DECW$IVP.COM.

              22.The installation procedure may run AUTOGEN, depending
                 on the type of system you are using. The types of
                 systems are as follows:

                 o  A nonworkstation system

                    If you are installing VMS DECwindows Motif on a
                    nonworkstation system (that is, a VMS host system),
                    the following message is displayed:

                    This system is not a workstation.
                    It will not be necessary to run AUTOGEN.

                 o  A workstation system running VMS DECwindows Motif
                    with correct SYSGEN parameters.

                    If you are installing VMS DECwindows Motif on a
                    workstation system and your SYSGEN parameters are
                    correct, the following message is displayed:

                    Your SYSGEN parameters are correctly set.
                    It will not be necessary to run AUTOGEN.

                           Installing VMS DECwindows Motif Software 2-15

 






              o  A workstation system running VMS DECwindows Motif
                 with incorrect SYSGEN parameters.

                 If you are installing VMS DECwindows Motif on a
                 workstation system and your SYSGEN parameters need
                 to be reset, the following message is displayed:

                 The VMS AUTOGEN procedure will now be automatically run
                 so that your system parameters will be set, and your
                 system will be properly configured. After that, your
                 system will be automatically shut down.

                 When the shut down is complete, press the RESTART button
                 to reboot the system.

                 After the system has been rebooted and initialized,
                 successful installation of the workstation software will
                 be indicated by the appearance of the Start Session window.

           23.When the installation is completed, the following text
              is displayed:

                     Installation of DECW$MOTIF V1.0 completed at 10:17

                     VMSINSTAL procedure done at 10:17

              These messages indicate that the installation procedure
              completed successfully.

           24.Your system automatically shuts down if AUTOGEN has
              been run. If that happens, reboot your system.

              ________________________Note ________________________

              If you upgrade your system with a newer version of
              VMS at a later time, you may need to reinstall the
              VMS DECwindows Motif software.

              _____________________________________________________

           25.Customize VMS DECwindows Motif as described in
              Chapter 3.



     2-16 Installing VMS DECwindows Motif Software

 






        2.2 Error Recovery

              Errors can occur during the installation if any of the
              following conditions exist:

              o  The VMS operating system version is incorrect.

              o  Quotas necessary for successful installation are
                 insufficient.

              o  System parameter values for successful installation are
                 insufficient.

              o  The VMS help library is currently in use.

              o  The product license has not been registered and loaded.

              For descriptions of the error messages generated by
              these conditions, refer to the documents listed in
              the Associated Documents section in the Preface. These
              documents may help you diagnose errors and decide which
              corrective actions to take.

        2.3 Accessing the Release Notes

              During the installation, the VMSINSTAL procedure copies
              the
              VMS DECwindows Motif release notes to the file
              SYS$HELP:DECW$MOTIF010.RELEASE_NOTES. Once you have
              returned to DCL level, you can print this file on a line
              printer or display it at a terminal.














                           Installing VMS DECwindows Motif Software 2-17

 









                                                                       3
        ________________________________________________________________

                               Customizing VMS DECwindows Motif Software



              This chapter describes the tasks that you must perform to
              customize
              VMS DECwindows Motif software. These tasks should be
              performed before starting VMS DECwindows Motif. Depending
              on your configuration, VMS DECwindows Motif customization
              tasks include the following:

              o  Customizing the server startup as described in
                 Section 3.1

              o  Setting up VMS/ULTRIX Connection software as a VMS
                 DECwindows transport as described in Section 3.1

              o  Setting up customer-written transports as VMS
                 DECwindows transports as described in Section 3.2

              o  Using the example transport as described in Section 3.3

              o  Defining print formats as described in Section 3.4

              o  Compiling the optional Ada software as described in
                 Section 3.5

        3.1 Customizing the Server Startup

              The VMS DECwindows server manages the graphics devices on
              your workstation, such as the display, the keyboard, and
              the mouse. The
              VMS DECwindows server needs to be started on workstation
              systems only.

              If you are not planning on starting the VMS DECwindows
              server, proceed to Section 3.4.


                           Customizing VMS DECwindows Motif Software 3-1

 






           The startup command procedures automatically determine
           most of the configuration parameters for the VMS
           DECwindows server. However, there are three items that
           the command procedures cannot determine; as a result, the
           following default actions are taken:

           o  The startup procedures execute as if you have a single
              75-dpi monitor.

           o  If you have a VAXstation II/GPX, a VAXstation 2000
              /GPX, a VAXstation 3xxx/GPX, or a VAXstation 3100/SPX,
              the startup procedures execute as if you have a color
              monitor.

           o  The startup procedures execute as if you have a North
              American keyboard layout (such as for an LK201-AA or
              -LA or an LK401-AA or -LA keyboard).

           If the defaults are not appropriate for your configura-
           tion, override them by modifying the server startup file
           as follows:

           1. Make a copy of the file SYS$MANAGER:DECW$PRIVATE_
              SERVER_SETUP.TEMPLATE and rename it SYS$MANAGER:DECW$PRIVATE_
              SERVER_SETUP.COM. This server startup file shows how to
              customize individual workstations by adding a section
              of DCL commands for each workstation.

              You can add setup options in either of two sections
              in the server startup file. Setup options added to
              the "Cluster Common or Standalone Workstation Setup"
              section affect all nodes in a cluster. Setup options
              added to the "Cluster Member Workstation-Specific
              Setup" section affect only individual nodes. If you
              add a workstation-specific option, you must also update
              the variable node_list.

           2. If your screen supports 100 dpi, add the following
              line:

              $ DECW$SERVER_DENSITY == "100"

              Add this line to the section for each workstation that
              has a 100-dpi monitor, or add it to the common section
              for all workstations (if all the workstations have
              100-dpi monitors).

     3-2 Customizing VMS DECwindows Motif Software

 






              3. Add the following line to the section for monochrome
                 GPX workstations:

                 $ DECW$COLOR == "FALSE"

                 No modification is necessary for grayscale (intensity)
                 screens.

              4. Add the following line to the section for workstations
                 with keyboards that are not North American LK201
                 models:

                 $ DECW$DEFAULT_KEYMAP == "xxxxx"

                 o  In the previous line, you must replace "xxxxx" with
                    the correct
                    VMS DECwindows keymap name. You can determine the
                    correct name from the model number of your LK201 or
                    LK401 keyboard. Turn the keyboard upside down, and
                    look for a label that specifies the model number.
                    The model number should be in a format similar to
                    LK201-xx or LK401-xx. The model number may also
                    be listed as LK201 or LK401. In this case, the
                    "xx" that you need is in another part of the label
                    where there is a number that looks similar to the
                    following:

                      nn-nnnnn-xx.

                 o  Use the xx part of this number to choose a keymap
                    name from Table 3-1. Choose the keymap ending in
                    _DP for the data processing keyboard layout, or the
                    keymap ending in _TW for the typewriter layout.

                    Table 3-1 is arranged based on the dialect that each
                    keyboard is designed for.

        Table_3-1_VMS_DECwindows_Keymap_________________________________

        Dialect_________Model_____________VMS_DECwindows_Keymap_________

        Austrian        LK201-            AUSTRIAN_GERMAN_LK201LG_DP
        /German         (AG,LG,BG,MG)

                                                (continued on next page)

                           Customizing VMS DECwindows Motif Software 3-3

 






     Table_3-1_(Cont.)_VMS_DECwindows_Keymap_________________________

     Dialect_________Model_____________VMS_DECwindows_Keymap_________

                                       AUSTRIAN_GERMAN_LK201LG_TW

                     LK201-(NG,PG)     AUSTRIAN_GERMAN_LK201NG_DP

                                       AUSTRIAN_GERMAN_LK201NG_TW

                     LK401-(AG)        AUSTRIAN_GERMAN_LK401AG_TW

     Belgian/French  LK201-            BELGIAN_FRENCH_LK201LP_DP
                     (AP,LP,BP,MP)

                                       BELGIAN_FRENCH_LK201LP_TW

     Belgian/French  LK401-(AP)        BELGIAN_FRENCH_LK401AP_DP

                                       BELGIAN_FRENCH_LK401AP_TW

     British         LK201-            BRITISH_LK201LE_DP
                     (AE,LE,BE,ME)

                                       BRITISH_LK201LE_TW

     British         LK401-(AA,PA)     BRITISH_LK401AA_DP

                                       BRITISH_LK401AA_TW

     Canadian        LK201-            CANADIAN_FRENCH_LK201LC_DP
     /French         (AC,LC,BC,MC)

                                       CANADIAN_FRENCH_LK201LC_TW

     Canadian        LK401-            CANADIAN_FRENCH_LK401AC_DP
     /French         (AC,LC,BC,MC)

                                       CANADIAN_FRENCH_LK401AC_TW

                                             (continued on next page)




     3-4 Customizing VMS DECwindows Motif Software

 






        Table_3-1_(Cont.)_VMS_DECwindows_Keymap_________________________

        Dialect_________Model_____________VMS_DECwindows_Keymap_________

        Danish          LK201-            DANISH_LK201LD_DP
                        (AD,LD,BD,MD)

                                          DANISH_LK201LD_TW

                        LK201-(ED,RD,FD)  DANISH_LK201RD_DP

                                          DANISH_LK201RD_TW

        Danish          LK401-            DANISH_LK401AD_DP
                        (AD,LD,BD,MD)

                                          DANISH_LK401AD_TW

        Dutch           LK201-            DUTCH_LK201LH_DP
                        (AH,LH,BH,MH)

                                          DUTCH_LK201LH_TW

                        LK201-(NH,PH)     DUTCH_LK201NH

                        LK401-(NH,PH)     DUTCH_LK401AH

        Finnish         LK201-            FINNISH_LK201LF_DP
                        (AF,LF,BF,MF)

                                          FINNISH_LK201LF_TW

                        LK201-(NX,PX)     FINNISH_LK201NX_DP

                                          FINNISH_LK201NX_TW

        Finnish         LK401-            FINNISH_LK401AF_DP
                        (AF,LF,BF,MF)

                                                (continued on next page)





                           Customizing VMS DECwindows Motif Software 3-5

 






     Table_3-1_(Cont.)_VMS_DECwindows_Keymap_________________________

     Dialect_________Model_____________VMS_DECwindows_Keymap_________

                                       FINNISH_LK401AF_TW

     Flemish         LK201-            FLEMISH_LK201LB_DP
                     (AB,LB,BB,MB)

                                       FLEMISH_LK201LB_TW

     Flemish         LK401-            FLEMISH_LK401AB_DP
                     (AB,LB,BB,MB)

                                       FLEMISH_LK401AB_TW

     Icelandic       LK201-            ICELANDIC_LK201LU_DP
                     (AU,LU,BU,MU)

                                       ICELANDIC_LK201LU_TW

     Italian         LK201-            ITALIAN_LK201LI_DP
                     (AI,LI,BI,MI)

                                       ITALIAN_LK201LI_TW

     Italian         LK401-            ITALIAN_LK401AI_DP
                     (AI,LI,BI,MI)

                                       ITALIAN_LK401AI_TW

     North American  LK201-            NORTH_AMERICAN_LK201LA
                     (AA,LA,BA,MA)

     North American  LK401-            NORTH_AMERICAN_LK401AA
                     (AA,LA,BA,MA)

     Norwegian       LK201-            NORWEGIAN_LK201LN_DP
                     (AN,LN,BN,MN)

                                             (continued on next page)




     3-6 Customizing VMS DECwindows Motif Software

 






        Table_3-1_(Cont.)_VMS_DECwindows_Keymap_________________________

        Dialect_________Model_____________VMS_DECwindows_Keymap_________

                                          NORWEGIAN_LK201LN_TW

                        LK201-(EN,RN,FN)  NORWEGIAN_LK201RN_DP

                                          NORWEGIAN_LK201RN_TW

        Norwegian       LK401-            NORWEGIAN_LK401AN_DP
                        (AN,LN,BN,MN)

                                          NORWEGIAN_LK401AN_TW

        Portuguese      LK201-            PORTUGUESE_LK201LV
                        (AV,LV,BV,MV)

        Portuguese      LK401-            PORTUGUESE_LK401AV
                        (AV,LV,BV,MV)

        Spanish         LK201-            SPANISH_LK201LS_DP
                        (AS,LS,BS,MS)

                                          SPANISH_LK201LS_TW

        Spanish         LK401-            SPANISH_LK401AS_DP
                        (AS,LS,BS,MS)

                                          SPANISH_LK401AS_TW

        Swedish         LK201-            SWEDISH_LK201LM_DP
                        (AM,LM,BM,MM)

                                          SWEDISH_LK201LM_TW

                        LK201-(NM,PM)     SWEDISH_LK201NM_DP

                                          SWEDISH_LK201NM_TW

                                                (continued on next page)




                           Customizing VMS DECwindows Motif Software 3-7

 






     Table_3-1_(Cont.)_VMS_DECwindows_Keymap_________________________

     Dialect_________Model_____________VMS_DECwindows_Keymap_________

     Swedish         LK401-            SWEDISH_LK401AM_DP
                     (AM,LM,BM,MM)

                                       SWEDISH_LK401AM_TW

     Swiss/French    LK201-            SWISS_FRENCH_LK201LK_DP
                     (AK,LK,BK,MK)

                                       SWISS_FRENCH_LK201LK_TW

     Swiss/French    LK401-            SWISS_FRENCH_LK401AK_DP
                     (AK,LK,BK,MK)

                                       SWISS_FRENCH_LK401AK_TW

     Swiss/German    LK201-            SWISS_GERMAN_LK201LL_DP
                     (AL,LL,BL,ML)

                                       SWISS_GERMAN_LK201LL_TW

     Swiss/German    LK401-            SWISS_GERMAN_LK401AL_DP
                     (AL,LL,BL,ML)

                                       SWISS_GERMAN_LK401AL_TW

     Combined US/UK  LK201-(EE,RE,PE)  UK_LK201RE

                                       US_LK201RE

     Combined US/UK  LK401-(EE,RE,PE)  UK_LK401AA

     __________________________________US_LK401AA____________________


              o  After you choose a keymap name, modify the server
                 startup file if necessary. For example, to change
                 the keyboard layout to a Dutch typewriter layout,
                 add the following line to the server startup file:



     3-8 Customizing VMS DECwindows Motif Software

 






                    $ DECW$DEFAULT_KEYBOARD_MAP == "DUTCH_LK201LH_TW"

                    Add a line similar to this for each workstation
                    that does not have a North American LK201 keyboard
                    layout, or add the line to the common section for
                    all workstations (if all the workstations use the
                    same keyboard layout).

              5. VMS DECwindows Motif contains built-in support for
                 the TCP/IP transport. This support depends on the VMS
                 /ULTRIX Connection software (UCX), a Digital layered
                 product. Before you can use the VMS DECwindows Motif
                 TCP/IP transport interface, you must install UCX.
                 For more information about TCP/IP concepts, see the
                 appropriate VMS/ULTRIX Connection documentation. It is
                 not necessary to install a UCX PAK in order to use UCX
                 with VMS DECwindows.

                ________________________Note  ________________________

                Other vendors' implementations of TCP/IP transports
                use different call interfaces. For this reason,
                the built-in VMS DECwindows Motif support for TCP
                /IP is compatible only with UCX. You must obtain a
                VMS DECwindows transport interface from the third-
                party vendor in order to use that vendor's TCP/IP
                transport with VMS DECwindows.

                _____________________________________________________

                 You can conserve memory and process slots by config-
                 uring UCX software for the minimum VMS DECwindows re-
                 quirements to support the
                 X protocol. VMS DECwindows only requires that INET_
                 ACP be running. VMS DECwindows does not require that
                 the NFS server, the FTPD server, or the remote terminal
                 servers be running. For information on how to configure
                 the UCX software, see the appropriate VMS/ULTRIX
                 Connection documentation.

                 To add support for the Transmission Control Protocol
                 /Internet Protocol (TCP/IP) transport using the
                 VMS/ULTRIX Connection software (UCX), include the
                 following line in the SYS$MANAGER:SYSTARTUP_V5.COM
                 file:

                           Customizing VMS DECwindows Motif Software 3-9

 






              $ @SYS$STARTUP:UCX$STARTUP

              UCX should be started after DECnet has been started.

              Then add the following line to the file SYS$MANAGER:DECW$PRIVATE_
              SERVER_SETUP.COM:

              $ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,TCPIP"

              Add this line to the section for each workstation that
              will use TCP/IP, or add it to the common section for
              all workstations if all workstations will use TCP/IP.

              To include support for other transports, add the
              last part of the transport image name to the list
              of transports. For example, suppose you want to add
              support for a customer-written transport that has the
              following image name:

              SYS$SHARE:DECW_TRANSPORT_MYNET

              You would add the following line to the server startup
              file:

              $ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,MYNET"

              For more information on using customer-written
              transports, see Section 3.2.

           6. A new server option is available that relaxes the
              protocol enforcement for the event masks passed to
              the following X library calls:

                 XChangeWindowAttributes (when specifying the
                 CWDontPropagate value mask)
                 XGrabPointer
                 XGrabButton

              The default value for this option is ON, but this
              may change in a future release of VMS DECwindows.
              To disable this option, define the global symbol
              DECW$SERVER_BUG_COMPATIBILITY to be FALSE in the file
              SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM as follows:

              $ DECW$SERVER_BUG_COMPATIBILITY == "FALSE"

     3-10 Customizing VMS DECwindows Motif Software

 






                 This option should be disabled unless your application
                 requires this compatibility to run, in which case you
                 should either recode (remove undefined bits from these
                 event masks) or contact your software supplier.

              7. Restart VMS DECwindows on the workstations for
                 which you customized the server startup by using the
                 following command:

                 $ @SYS$MANAGER:DECW$STARTUP RESTART

              8. Customize security by following the steps described in
                 the
                 VMS DECwindows Motif User's Guide.

        3.2 Using Customer-Written Transports with
            VMS DECwindows

              VMS DECwindows supports DECnet, local, and TCP/IP
              transports. However, you can use other transports with VMS
              DECwindows by writing a
              VMS DECwindows transport interface layer.

              For information on writing a transport interface, see the
              VMS DECwindows Transport Manual.

              The transport interface image's filename must have the
              following format where name is the unique transport name:

              DECW$TRANSPORT_name (for transports supplied by Digital)

              DECW_TRANSPORT_name (for customer-written transports)

              Install the image as a protected image in the SYS$SHARE
              directory (as defined by an executive mode logical name)
              by adding the following line to SYS$MANAGER:SYSTARTUP_
              V5.COM:

        $ INSTALL CREATE SYS$SHARE:DECW_TRANSPORT_name/OPEN/SHARED/HEADER_RES/PROTECTED

              You can also include this command in a startup file that
              SYSTARTUP_V5.COM calls.

              To use this transport with the VMS DECwindows server,
              customize the server startup as described in Section 3.1.

                          Customizing VMS DECwindows Motif Software 3-11

 






     3.3 Using the Example Transport

           VMS DECwindows Motif supplies an example transport
           interface based upon the UCX software. It is similar to
           the VMS DECwindows TCP/IP transport interface. You cannot
           run the example transport interface simultaneously with
           the TCP/IP transport interface.

           If you have installed UCX software, you can install and
           use the example transport by doing the following:

           1. Copy the example transport to the SYS$SHARE directory
              as follows:

              $ COPY DECW$EXAMPLES:DECW$TRANSPORT_EXAMPLE.EXE SYS$SHARE:/PROT=W:RE

           2. Add the following line to SYS$MANAGER:SYSTARTUP_V5.COM
              and execute the command on all nodes in the cluster:

     $ INSTALL CREATE SYS$SHARE:DECW$TRANSPORT_EXAMPLE/OPEN/SHARED/HEADER_RES/PROTECTED

           3. Customize the private server startup as described in
              Section 3.1 for TCP/IP, except use the transport name
              EXAMPLE. For example, you could add the following line:

              $ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,EXAMPLE"

           4. Restart VMS DECwindows with the following command:

              $ @SYS$MANAGER:DECW$STARTUP RESTART

           5. Customize security as described in the VMS DECwindows
              Motif User's Guide for TCP/IP, but use the transport
              name EXAMPLE instead of TCPIP.

           6. Create a DECterm window on the workstation and enter
              the following command:

              $ SET DISPLAY /CREATE /NODE="your_node" /TRANSPORT=EXAMPLE

              Substitute the Internet node name of your workstation
              for your_node.

           7. Run any VMS DECwindows Motif application from the
              DECterm window. It now uses the example transport
              to display graphics on your workstation screen. For
              example, enter the following command to run the clock:

     3-12 Customizing VMS DECwindows Motif Software

 






                 $ RUN SYS$SYSTEM:DECW$CLOCK


        3.4 Defining Print Formats

              Many applications use the Print dialog box to queue files
              or screens to a printer. By default, all printing devices
              on the system are displayed in the Printer list box.
              However, print queues can be associated with print formats
              through the definition of logical names. The logical name
              is defined to be a comma-separated or space-separated list
              of print queues with the first queue being the default
              choice.

              For example, if DECW$PRINTER_FORMAT_ANSI2 is defined
              as "MY_PRINTER, CLUSTER_LN03, ANOTHER_LN03", then when
              you select "ANSI2" from the print format list box, only
              MY_PRINTER, CLUSTER_LN03, and ANOTHER_LN03 are shown in
              the Printer list box, with MY_PRINTER being the default
              choice.

              Table 3-2 lists the logical names and the print formats
              associated with each:

              Table_3-2_Print_Dialog_Box_Logical_Names__________________

              Logical_name_________________Print_format_________________

              DECW$PRINTER_FORMAT_DEFAULT  Default

              DECW$PRINTER_FORMAT_TEXT     Text

              DECW$PRINTER_FORMAT_LINE     Line printer

              DECW$PRINTER_FORMAT_TERM     Terminal

              DECW$PRINTER_FORMAT_ANSI2    ANSI2

              DECW$PRINTER_FORMAT_ANSI     ANSI

              DECW$PRINTER_FORMAT_PS       Postscript(R)

                                                (continued on next page)


                          Customizing VMS DECwindows Motif Software 3-13

 






           Table_3-2_(Cont.)_Print_Dialog_Box_Logical_Names__________

           Logical_name_________________Print_format_________________

           DECW$PRINTER_FORMAT_REGIS    ReGIS

           DECW$PRINTER_FORMAT_TEK      Tektronix

           DECW$PRINTER_FORMAT_DDIF_____DDIF_________________________


           The logical names can be defined by system managers in
           system-wide logical name tables and can be overridden by
           users.

           If you have any of the logical names listed in Table 3-2
           defined in your environment, they comprise the list of
           printer queue names to be presented when the corresponding
           print format is selected. This method is much faster
           than making the Print dialog box derive the names of all
           the queues on the system (see the following example),
           most of which do not apply to the print format under
           consideration.

               $ Define DECW$PRINTER_FORMAT_TEXT   "CLUSTER_LN03,CLUSTER_PRINT, -
               _$ ANSI_ARTWRK,ANSI_PROTON"
               $ Define DECW$PRINTER_FORMAT_LINE   "CLUSTER_PRINT"
               $ Define DECW$PRINTER_FORMAT_ANSI2  "CLUSTER_LN03,ANSI_ARTWRK,ANSI_PROTON"
               $ Define DECW$PRINTER_FORMAT_ANSI   "CLUSTER_LN03,ANSI_ARTWRK,ANSI_PROTON"
               $ Define DECW$PRINTER_FORMAT_PS     "PS_ARTWRK,PS_PROTON"
               $ Define DECW$PRINTER_FORMAT_REGIS  "SYS$NULL"

     3.5 Compiling Ada Source Files

           VMS DECwindows Motif provides programming interface
           definitions for the Ada language. If you have not
           installed Ada programming software on your system, proceed
           to Chapter 4.

           When you select Ada support at the time of the VMS
           DECwindows Motif kit installation, four Ada package source
           files are placed in the SYS$LIBRARY directory of your
           system. These files are:

           o  CDA$CDA_.ADA-Package CDA-Compound Document Architecture

     3-14 Customizing VMS DECwindows Motif Software

 






              o  DDIF$DDIF_.ADA-Package DDIF-Digital Document Interchange
                 Format

              o  DDIF$DTIF_.ADA-Package DTIF-Digital Table Interchange
                 Format

              o  DECW$DWT_.ADA-Package DWT-VMS DECwindows Motif Toolkit

              o  DECW$MOTIF_.ADA-Package MOTIF-VMS DECwindows Motif
                 Toolkit

              o  DECW$X_.ADA-Package X-Xlib

              These package source files can be individually compiled
              into your Ada program libraries or compiled into the
              system-wide Ada predefined library.

              The command file SYS$UPDATE:DECW$COMPILE_ADA_UNITS.COM
              is provided to make the packages available system-wide.
              This command procedure compiles all four packages into
              the predefined Ada library, and if the VAX Source Code
              Analyzer (SCA) product is installed, loads SCA analysis
              data for the packages into the SCA library for the
              predefined library. The command procedure should be
              run as a batch job. You should have a minimum of 2000
              pages available in the working set, but 3000 pages are
              preferable. A page file quota of at least 30000 pages is
              suggested.

              Once the units are compiled into the predefined Ada
              library, you must execute the following Ada program
              library manager command to make the units visible:

              $ ACS ENTER UNIT ADA$PREDEFINED CDA,DDIF,DTIF,DWT,MOTIF,X

              You need to do this only once. This step is also performed
              automatically for all Ada program libraries created after
              the VMS DECwindows Motif units are compiled into the
              predefined library.

              Future installations of VMS DECwindows Motif might replace
              Ada packages. If so, the new packages must be compiled
              as shown in this section. If you have already entered the
              units into your own library, you must then execute the
              following command to make your library current:

              $ ACS REENTER *

                          Customizing VMS DECwindows Motif Software 3-15

 






           Future installations of VAX Ada might replace the Ada
           predefined library and remove the VMS DECwindows Motif
           units. If this occurs, execute the DECW$COMPILE_ADA_
           UNITS.COM command procedure again.









































     3-16 Customizing VMS DECwindows Motif Software

 









                                                                       4
        ________________________________________________________________

                                           Starting VMS DECwindows Motif



              This chapter discusses the tasks that need to be performed
              after the
              VMS DECwindows Motif installation is complete. You should
              customize the
              VMS DECwindows Motif software as described in Chapter 3
              before proceeding with this chapter.

              Perform the following tasks after installing the VMS
              DECwindows Motif software:

              o  Start VMS DECwindows Motif

              o  Run the Installation Verification Procedure (IVP)

              o  Choose an alternative console

        4.1 Starting the VMS DECwindows Motif Software

                ________________________Note  ________________________

                You must reboot all workstations and all nonwork-
                station cluster boot nodes before starting VMS
                DECwindows Motif. All other nodes in the VAXcluster
                and all satellite systems must be rebooted before
                the installation is considered complete.

                _____________________________________________________

              Follow these steps to start VMS DECwindows Motif:

              1. If your system was not automatically shut down at the
                 end of the installation procedure, perform an orderly
                 system shutdown by entering the following command:

                 $ @SYS$SYSTEM:SHUTDOWN

              2. Once your system has been shut down, halt the system.

                                       Starting VMS DECwindows Motif 4-1

 






           3. You must specifically set the SYSGEN parameter
              WINDOW_SYSTEM to 1 the first time that you start VMS
              DECwindows Motif on a workstation. Enter the following
              commands at the workstation console prompt (>>>) to set
              the WINDOW_SYSTEM parameter:

              >>> B/1

                 .
                 .
                 .

              SYSBOOT> SET WINDOW_SYSTEM 1
              SYSBOOT> CONTINUE

              ________________________Note ________________________

              If you are booting as a member of a Local Area
              VAXcluster (LAVc), the SYSGEN cluster parameter
              NISCS_CONV_BOOT must be set to 1 to allow a
              conversational boot. See the VMS System Generation
              Utility Manual for information about setting SYSGEN
              parameters.

              _____________________________________________________

           If your system does not have valid VAX-VMS or DW-MOTIF
           licenses installed, appropriate messages are displayed on
           your console terminal and
           VMS DECwindows Motif is not automatically started. If
           this happens, log in to the console terminal, install
           the valid licenses, and reboot the system. See the VMS
           License Management Utility Manual for more information on
           installing licenses.

           After the system is rebooted and the startup is complete,
           the Start Session window should appear.

           The VMS DECwindows Motif software is now installed
           and is running on your system. You should now run the
           Installation Verification Procedure as described in
           Section 4.2 to verify that the installation of VMS
           DECwindows Motif was complete and accurate.


     4-2 Starting VMS DECwindows Motif

 






        4.2 Running the Installation Verification Procedure

              The Installation Verification Procedure (IVP), located
              in SYS$TEST:DECW$IVP.COM, should be run after you have
              installed and started VMS DECwindows Motif. This procedure
              contains four tests which verify that the software
              installation was complete and accurate.

              First, the IVP attempts to run two display-oriented
              tests. When the IVP is invoked, it determines the type
              of machine you are using. If you are using a workstation,
              you are asked where the display-oriented tests should be
              displayed. Your current workstation is the default. If you
              are using a nonworkstation, the procedure prompts you for
              a display name. Press Ctrl+Z at the prompt if you do not
              want to run the display-oriented tests. These tests are
              run only if the images exist on the system. If the images
              are not found, a message is displayed informing you that
              the tests will be skipped.

              Next, the IVP runs two nondisplay-oriented tests. The
              first of these tests invokes the Motif UIL compiler. If
              you did not install programming support, the IVP informs
              you that this test will not be run because the Motif UIL
              image does not exist. If the first test runs, you are
              notified of its completion status.

              The last test converts a text file to DDIF format and
              then converts it back to text, comparing the original
              text file with the result. If the files match, the test is
              successful. You are notified of its completion status.

              To run the IVP, enter the following command:

              $ @SYS$TEST:DECW$IVP

              See Appendix B for a sample of the Installation Verification
              Procedure.







                                       Starting VMS DECwindows Motif 4-3

 






     4.3 Choosing an Alternative Console

           The VMS DECwindows Motif software allows you to boot
           all configurations from the main console. You can then
           toggle between displaying or not displaying the operator
           window by pressing Ctrl+F2. The main console is always a
           workstation screen.

           For an alternative console, you can use a terminal
           connected to the workstation by means of a terminal port.

           If you boot from the main console, the alternative console
           is connected when you invoke the VMS DECwindows Motif
           startup command procedure.































     4-4 Starting VMS DECwindows Motif

 









                                                                       5
        ________________________________________________________________

                                           Managing VMS DECwindows Motif



              This chapter contains information on enhancing VMS
              DECwindows Motif performance. It also describes how to
              remove VMS DECwindows Motif files from the system disk by
              using DECW$MOTIF_TAILOR.

        5.1 Tuning Your System

              After you install VMS DECwindows Motif, you may want to
              tune your system to enhance performance or lower the use
              of some system resources. Information about tuning your
              system is included in the VMS System Manager's Manual.

        5.2 Using DECW$MOTIF_TAILOR

              Use DECW$MOTIF_TAILOR to remove some or all VMS DECwindows
              Motif files from the system disk. For example, if you are
              not planning on using the VMS DECwindows Motif programming
              support, you can remove those files. Later, if you decide
              you want VMS DECwindows Motif programming support, you
              can add the files to the system disk by reinstalling VMS
              DECwindows Motif.

              DECW$MOTIF_TAILOR has two phases:

              1. The first phase lists each class of VMS DECwindows
                 Motif files and asks you if you want to delete the
                 class from the system disk.

              2. The second phase deletes the files you indicated from
                 the system disk.

              Table 5-1 lists the classes and subclasses of VMS
              DECwindows Motif files that you can delete using
              DECW$MOTIF_TAILOR. For a list of VMS DECwindows Motif
              files and their functions, see Appendix C.

                                       Managing VMS DECwindows Motif 5-1

 






           Table 5-1 Classes of VMS Files That Can Be Removed with
           __________DECW$MOTIF_TAILOR_______________________________

           VMS_DECwindows_Motif_Applications_Files___________________

           No subclasses in this tailor class

           __________________________________________________________
           VMS_DECwindows_Motif_Device_Support_Files[1]______________

           PEX for PHIGS support files

           __________________________________________________________
           75_Dots_Per_Inch_Video_Font_Files_________________________

           No subclasses in this tailor class

           __________________________________________________________
           100_Dots_Per_Inch_Video_Font_Files________________________

           No subclasses in this tailor class

           __________________________________________________________
           VMS_DECwindows_Motif_Programming_Support_Files____________

           Ada files
           BASIC files
           BLISS files
           VAXC (MIT binding) files
           VAXC (VAX binding) files
           FORTRAN files
           Macro files
           Pascal files
           PL/1 files

           __________________________________________________________
           Example_Files_____________________________________________

           No subclasses in this tailor class
           [1]If_you_tailor_device_support_files_OFF,_the_system_____

           reboots
           __________________________________________________________

           The classes and subclasses of VMS DECwindows Motif files
           are described in the following items:

     5-2 Managing VMS DECwindows Motif

 






              o  Applications files: VMS DECwindows Motif provides a
                 variety of applications including the following:

                 _  Bookreader

                 _  Calculator

                 _  Calendar

                 _  Cardfiler

                 _  Clock

                 _  DDIF Document Viewer

                 _  DECterm

                 _  EVE Text Editor

                 _  FileView

                 _  Mail

                 _  Notepad Text Editor

                 _  Paint Graphics Editor

                 _  Session Manager

                 _  Window Manager

                 If you are installing VMS DECwindows Motif on a
                 VAXstation, you need these files. You may also want
                 these files on a nonworkstation
                 VAX computer, because you can run VMS DECwindows
                 Motif applications on a nonworkstation VAX computer
                 and display them on a workstation.

              o  Device support files: If you are installing VMS
                 DECwindows Motif on a VAXstation or in a cluster that
                 includes VAXstations, you need these files. Otherwise
                 you do not need them.

              o  100 dots-per-inch (100-dpi) video font files: If you
                 have a workstation monitor capable of displaying 100
                 dpi (for example, a VR150, VR160, or VR295), selecting
                 100-dpi fonts gives you a more readable display when
                 you run VMS DECwindows Motif applications. If your
                 workstation monitor cannot display 100-dpi fonts (for
                 example, a VR260 or VR290), you can save disk space
                 by tailoring off this option. For more information on

                                       Managing VMS DECwindows Motif 5-3

 






              the capabilities of your particular monitor, see the
              owner's guide for your monitor.

           o  Programming support files: The VMS DECwindows Motif
              programming support files are needed only to develop
              applications and are not required to run VMS DECwindows
              Motif applications. Support files are provided for the
              following VAX programming languages: Ada, BASIC, BLISS,
              C, FORTRAN, MACRO, Pascal, and PL/1. In addition,
              support files are provided for programming in the C
              language using conventions and standards developed at
              the Massachusetts Institute of Technology.

     5.2.1 Removing VMS DECwindows Motif Files from the System Disk

           To remove VMS DECwindows Motif files from the system disk,
           do the following:

           1. Log in to the SYSTEM account.

           2. Enter the following command:

              $ RUN SYS$UPDATE:DECW$MOTIF_TAILOR

              After a brief overview, the DECW$MOTIF_TAILOR program
              lists each group, or class, of files and its size in
              blocks. Files are grouped according to their function.
              For example, all the files required for VMS DECwindows
              device support are in one class. A file class is made
              up of many small subclasses. You can eliminate an
              entire class of files, or you can eliminate one or
              more of its subclasses. For example:

              CLASS - DECwindows device support files
                        Size of entire class (with subclasses): 13959
                        Size of common files required for any subclass: 10498
                        Do you wish to select the entire class (default = NO)?
                 .
                 .
                 .

           3. Decide which file classes or subclasses are not needed
              to support your system. DECW$MOTIF_TAILOR displays
              step-by-step instructions. Follow these instructions to
              specify which of the classes or subclasses you want to
              remove.

     5-4 Managing VMS DECwindows Motif

 






              4. DECW$MOTIF_TAILOR deletes the files you selected and
                 displays the names of those files. If you deleted
                 device support files, the system automatically shuts
                 down and reboots after the files have been tailored
                 off.

                ______________________ Caution ______________________

                To cancel DECW$MOTIF_TAILOR during the first phase,
                press Ctrl+C, Ctrl+Y, or Ctrl+Z. If you cancel
                DECW$MOTIF_TAILOR during the last phase, you may end
                up with a partially tailored disk. For a description
                of both phases, see Section 5.2.

                _____________________________________________________

              Example 5-1 illustrates how to use DECW$MOTIF_TAILOR to
              remove the application files, device support files, font
              files, programming support files, and example files from a
              system disk.

        Example 5-1 Sample DECW$MOTIF_TAILOR Session

        $ RUN SYS$UPDATE:DECW$MOTIF_TAILOR
           .
           .
           .

        TAILOR-OFF
        ----------
         You will now be prompted with a list of the classes and subclasses of
         DECwindows files that are optional. The size of each class and subclass is
         included in the list. This will help you decide whether or not you want to
         remove a class or subclass from your system.

         Under some classes there is a set of common files that is required in order
         for any subclasses to work. These files will only be deleted if you remove
         the ENTIRE class. If you choose to keep any subclass, this set of files is
         not deleted.

         NOTE: The files associated with selected classes and subclasses will
               be removed from your system.

                                                (continued on next page)

                                       Managing VMS DECwindows Motif 5-5

 






     Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session

     Total size of the system disk is 891072 blocks.
     Total space used on the system disk is 832161 blocks.
     Total space left on the system disk is 58911 blocks.

     CLASS - DECwindows applications files
               Size of entire class (with subclasses): 18999
               Size of common files required for any subclass: 17282
        Do you wish to select the entire class (default = NO)? <Return>
        Do you wish to select any of its subclasses (default = NO)? YES
           Select the subclasses that you wish to delete:
                  SUBCLASS - DECwindows computer-based instruction files (1717 blocks
     ) [NO]: YES

     CLASS - DECwindows device support files
               Size of entire class (with subclasses): 13959
               Size of common files required for any subclass: 10498
        Do you wish to select the entire class (default = NO)? <Return>
           Do you wish to select any of its subclasses (default = NO)? YES
           Select the subclasses that you wish to delete:
                  SUBCLASS - PEX for PHIGS support files (3461 blocks) [NO]: YES

     CLASS - 75 dots per inch video font files
               Size of entire class (with subclasses): 2510
               No subclasses in this tailor class.
               Do you wish to select the entire class (default = NO)? YES

     CLASS - 100 dots per inch video font files
               Size of entire class (with subclasses): 3578
               No subclasses in this tailor class.
               Do you wish to select the entire class (default = NO)? YES

                                             (continued on next page)











     5-6 Managing VMS DECwindows Motif

 






        Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session

        CLASS - DECwindows programming support files
                  Size of entire class (with subclasses): 33972
                  Size of common files required for any subclass: 2303
           Do you wish to select the entire class (default = NO)? <Return>
              Do you wish to select any of its subclasses (default = NO)? YES
              Select the subclasses that you wish to delete:
                     SUBCLASS - Ada files (4769 blocks) [NO]: YES
                 SUBCLASS - BASIC files (2755 blocks) [NO]: YES
                 SUBCLASS - BLISS files (2128 blocks) [NO]: YES
                 SUBCLASS - VAX C (MIT binding) files (3580 blocks) [NO]: YES
                 SUBCLASS - VAX C (VAX binding) files (3007 blocks) [NO]: YES
                 SUBCLASS - FORTRAN files (3028 blocks) [NO]: YES
                 SUBCLASS - Macro files (3695 blocks) [NO]: YES
                 SUBCLASS - Pascal files (6094 blocks) [NO]: YES
                 SUBCLASS - PL/1 files (2613 blocks) [NO]: YES

        CLASS - Example files
                  Size of entire class (with subclasses): 3377
                  No subclasses in this tailor class.
                  Do you wish to select the entire class (default = NO)? YES
        Files have been selected
        Do you wish to remove all of the options selected? YES
        Removing files, please wait...
        %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSCBI.DECW$CBI]DECW00010.CBI;*
        %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSCBI.DECW$CBI]DECW00020.CBI;*

           .
           .
           .

        5.2.2 Adding VMS DECwindows Motif Files to the System Disk

              To add VMS DECwindows Motif files that you previously
              chose not to install or that you removed, do the
              following:

              1. Follow the installation procedure as described in
                 Section 2.1.1.





                                       Managing VMS DECwindows Motif 5-7

 






           2. When the installation procedure (in step 10) asks you
              if you want to install the entire kit, enter NO. The
              procedure displays optional parts of the kit and asks
              you if you want to install each part. Enter YES for
              each part that you want to install.

           3. As noted in step 16 of the installation procedure,
              all kit parts that you chose are displayed and you are
              asked to verify that the selections are correct.

           4. Once you have verified the selections, the installation
              procedure continues.

     5.3 Determining and Reporting Problems

           If you encounter a problem while using VMS DECwindows
           Motif, review the Software Product Description (SPD) and
           Warranty Addendum for an explanation of the warranty.
           If you encounter a problem during the warranty period,
           report the problem as indicated below or follow alternate
           instructions provided by Digital for reporting problems.

           o  Call Digital if your software contract or warranty
              agreement includes telephone support.

           o  If you discover a problem with the documentation, fill
              out and submit a Reader's Comments form, located in the
              back of each manual.

















     5-8 Managing VMS DECwindows Motif

 









                                                                       A
        ________________________________________________________________

                                VMS DECwindows Motif Sample Installation



              Example A-1 contains a sample registration of a DW-MOTIF
              Product Authorization Key and a sample installation of VMS
              DECwindows Motif.

              The sample installation assumes that DECnet has been
              shut down, that no users are logged on to the system,
              and that OPTIONS N is specified to display the release
              notes options.

        Example A-1 Sample Installation

        $ @SYS$UPDATE:VMSLICENSE

            VMS License Management Utility Options:

                1. Register a Product Authorization Key
                2. Amend an existing Product Authorization Key
                3. Cancel an existing Product Authorization Key
                4. List Product Authorization Keys
                5. Modify an existing Product Authorization Key

                9. Exit this procedure

            Type '?' at any prompt for a description of the information
            requested.

        Enter one of the above choices [1]<RETURN>
        Do you have your Product Authorization Key? [YES]<RETURN>

           The REGISTER option allows you add a new license to a license
           database.  A Product Authorization Key (PAK) provides the product
           name and information you need to register the license.  You must
           enter all the information provided by your PAK exactly as specified.

                                                (continued on next page)

                            VMS DECwindows Motif Sample Installation A-1

 






     Example A-1 (Cont.) Sample Installation

     PAK ID:
                            Issuer [DEC]<RETURN>
              Authorization Number []LAB030419

     PRODUCT ID:
                      Product Name []DW-MOTIF

                          Producer [DEC]<RETURN>

     NUMBER OF UNITS:
                   Number of Units []400

     KEY LEVEL:
                           Version []

     PRODUCT RELEASE DATE:         []1-Jul-1991

     KEY TERMINATION DATE:
              Key Termination Date []<RETURN>

     RATING:
           Availability Table Code []f
               Activity Table Code []<RETURN>

     MISCELLANEOUS:
                       Key Options []<RETURN>
                     Product Token []<RETURN>
                       Hardware-Id []<RETURN>
                          Checksum []2-fbic-odnh-enwj-lled

                                             (continued on next page)












     A-2 VMS DECwindows Motif Sample Installation

 






        Example A-1 (Cont.) Sample Installation

              License Database File:  SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB
                             Issuer:  DEC
                      Authorization:  LAB030419
                           Producer:  DEC
                       Product Name:  DW-MOTIF
                              Units:  400
                               Date:  1-JUL-1991
                            Version:
                   Termination Date:
                       Availability:  F
                           Activity:
                            Options:
                              Token:
                        Hardware ID:
                           Checksum:  2-FBIC-ODNH-ENWJ-LLED

        Is this information correct? [YES]<RETURN>

        Registering DW-MOTIF license in SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB...

        Do you want to LOAD this license on this system? [YES]<RETURN>

        %LICENSE-I-LOADED, DEC DW-MOTIF was successfully loaded with 400 units

            VMS License Management Utility Options:

                1. Register a Product Authorization Key
                2. Amend an existing Product Authorization Key
                3. Cancel an existing Product Authorization Key
                4. List Product Authorization Keys
                5. Modify an existing Product Authorization Key

                9. Exit this procedure

            Type '?' at any prompt for a description of the information
            requested.

        Enter one of the above choices [1]9

        $
        .
        .
        .

                                                (continued on next page)

                            VMS DECwindows Motif Sample Installation A-3

 






     Example A-1 (Cont.) Sample Installation

     $ @SYS$UPDATE:VMSINSTAL DECW$MOTIF010 MUA0: OPTIONS N

      VAX/VMS Software Product Installation Procedure V5.4

     It is 1-Sep-1991 at 09:02.

     Enter a question mark (?) at any time for help.

     * Are you satisfied with the backup of your system disk [YES]? YES

     Please mount the first volume of the set on MUA0:.

     * Are you ready? Y

     %MOUNT-I-MOUNTED, DWM010 mounted on _MUA0:

     The following products will be processed:

       DECW$MOTIF V1.0

      Beginning installation of DECW$MOTIF V1.0 at 09:02

     %VMSINSTAL-I-RESTORE, Restoring product save set A ...

         Release notes included with this kit are always copied to SYS$HELP.

         Additional Release Notes Options:

      1.  Display release notes
      2.  Print release notes
      3.  Both 1 and 2
      4.  None of the above

     * Select option [2]: 4

     * Do you want to continue the installation [NO]? YES

     %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

        *** Installing VMS DECwindows Motif software ***

                                             (continued on next page)

     A-4 VMS DECwindows Motif Sample Installation

 






        Example A-1 (Cont.) Sample Installation

        You can install the VMS DECwindows Motif kit completely or in selected
        portions. A complete installation requires as much as 90,000 blocks.  If
        you choose to perform a partial installation, you can tailor the device
        support that you want provided for VMS DECwindows Motif workstations and
        the programming support that you want provided for VMS DECwindows Motif
        application development.  Whether you perform a complete or partial
        installation, this kit provides support for running VMS DECwindows Motif
        applications on VMS compute servers.

        * Do you want to install the entire kit [Y]? NO

        If you are not installing this kit on a workstation, or on a VAXcluster
        that includes workstations, you can save up to 17,000 blocks by omitting
        the device support required to make workstation graphics hardware
        available to VMS DECwindows Motif.

        * Do you want to install VMS DECwindows Motif device support [Y]? YES

        This installation procedure provides video fonts for specific monitor
        resolutions.  Fonts are supplied for the following monitor resolutions:

          75 dots per inch
         100 dots per inch

        All VMS DECwindows Motif applications run with 75 dots per inch (dpi) fonts.
        Some applications take advantage of 100 dpi fonts.  If you select 100 dpi
        fonts, 75 dpi fonts are automatically provided.  Both font resolutions are
        provided to allow your system to run those VMS DECwindows Motif applications
        that require 100 dpi fonts and those that require 75 dpi fonts.

        For instructions on how to configure your system with both 75 and 100 dpi
        fonts, see the installation guide or examine the template command procedure
        SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.TEMPLATE.  By default, systems start
        up using 75 dpi fonts.

        Note that this procedure deletes previously installed fonts before installing
        new ones.  If you choose to reinstall this kit at a later date, be sure to
        install all required fonts.

        * Do you want both sets of video fonts installed [Y]? NO

        * Do you want 75 dpi video fonts installed [Y]? <RETURN>

                                                (continued on next page)

                            VMS DECwindows Motif Sample Installation A-5

 






     Example A-1 (Cont.) Sample Installation

     * Do you want 100 dpi video fonts installed [Y]? NO

     If you are not installing this kit on a workstation, or on a VAXcluster
     that includes workstations, you can save up to 4000 blocks by omitting
     PEX (PHIGS Extension to X) support for PHIGS.

     * Do you want to install VMS DECwindows Motif PEX support for PHIGS [Y]? NO

     This installation procedure provides support files for developing
     VMS DECwindows Motif applications in several programming languages.  These files
     are needed only to develop applications and are not required to run
     VMS DECwindows Motif applications. Support for each programming language
     requires approximately 3,400 blocks.

     * Do you want to install VMS DECwindows Motif programming support [Y]? <RETURN>

     Support files are supplied for the following VAX programming languages:

             Ada, BASIC, BLISS, C, FORTRAN, MACRO, Pascal, PL/1

     In addition, support files are supplied for programming in the C language
     using conventions and standards developed at the Massachusetts Institute
     of Technology.

     Note that this procedure deletes previously installed programming
     language support files before installing new ones.  If you choose to
     reinstall this kit at a later date, be sure to install all required
     programming language support files.

     * Do you want to install all programming language support files [Y]? NO

     Do you want support files provided for each of the following programming
     languages?  Type Yes or No for each language.

     *     VAX Ada [N]? <RETURN>
     *     VAX BASIC [N]? <RETURN>
     *     VAX BLISS [N]? <RETURN>
     *     VAX C [N]? YES
     *     VAX FORTRAN [N]? <RETURN>
     *     VAX MACRO [N]? <RETURN>
     *     VAX Pascal [N]? <RETURN>
     *     VAX PL/1 [N]? <RETURN>
     *     MIT-compatible C [N]? YES

                                             (continued on next page)

     A-6 VMS DECwindows Motif Sample Installation

 






        Example A-1 (Cont.) Sample Installation

        You have selected the following portions of the kit:

                o  VMS DECwindows Motif compute server support

                o  VMS DECwindows Motif device support

                       75 dots per inch video fonts

                o  VMS DECwindows Motif programming support requiring approximately
                   13146 blocks

                       VAX C
                       MIT C language programming conventions

        * Are these selections correct [Y]? YES

        A registered and loaded Product Authorization Key for DW-MOTIF is required
        to run any applications with VMS DECwindows Motif.  If you answer NO to
        the next question, the installation of VMS DECwindows Motif will be aborted.

                Product:      DW-MOTIF
                Producer:     DEC
                Version:      1.0
                Release Date: 1-JUL-1991

        * Does this product have an authorization key registered and loaded? YES

        No further questions will be asked.
         .
         .
         .

        %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
         .
         .
         .

         Installation of DECW$MOTIF V1.0 completed at 10:57

         VMSINSTAL procedure done at 10:57



                            VMS DECwindows Motif Sample Installation A-7

 









                                                                       B
        ________________________________________________________________

                              Sample Installation Verification Procedure



              Example B-1 contains a sample of the Installation
              Verification Procedure (IVP). See Chapter 4 for infor-
              mation about running the IVP.

              Example B-1 Sample IVP

              $ @SYS$TEST:DECW$IVP

                        VMS DECwindows Motif Installation Verification Procedure (IVP)

                  This IVP is intended to test some of the functionality of VMS DECwindows
                  Motif, and provide a quick method of verifying the installation.

                  This machine is not a workstation.  Please provide the nodename of a
                  workstation on which to display the IVP tests.  You must be sure that this
                  account and node have security access to the display node, or the IVP will
                  fail.

                  To skip the display-oriented tests, press Ctrl/Z at the following prompt.

              _Display: NODE33::0.0

                                                (continued on next page)












                          Sample Installation Verification Procedure B-1

 






           Example B-1 (Cont.) Sample IVP

           %DECW-I-IVP, The IVP will display on NODE33
           %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute.
           %DECW-I-IVP, Press Ctrl/Y to interrupt test.
           %DCL-S-SPAWNED, process DECW$IVP_ICO spawned
           %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute.
           %DECW-I-IVP, Press Ctrl/Y to interrupt test.
           %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned
           %DECW-W-IVP, Could not find any .UIL source files in DECW$EXAMPLES.  Skipping UI
           L compiler test...
           %DECW-I-IVP, Beginning CONVERT/DOCUMENT IVP...
           %DECW-S-IVP, CONVERT/DOCUMENT IVP passed.
           %DECW-S-IVP, The IVP has completed.
           $






























     B-2 Sample Installation Verification Procedure

 









                                                                       C
        ________________________________________________________________

                                VMS DECwindows Motif Software Components



              Table C-1 contains the name of each VMS DECwindows Motif
              software component, the directory where the component can
              be found, a brief description of what the component does,
              and one of the following three component classifications:

              o  ALL-The component is part of all installations.

              o  PROG-The component is part of the programming
                 environment.

              o  WS-The component is part of the workstation device
                 support.

        Table_C-1_VMS_DECwindows_Motif_Software_Components______________

                                                                   Component
        Directory______File___________________________Purpose______Class

        CDA$LIBRARY:   CL_DAY.DOC_STYLE               Calendar     ALL
                                                      day style
                                                      file

                       DEFSTYLE.DDIF                  DDIF         ALL
                                                      document
                                                      style guide

        DECW$EXAMPLES: ALLOBJS.H                      Demo source  PROG

                       BITMAP.C                       Demo source  PROG

                       BITMAP.EXE                     Demo image   PROG

                                                (continued on next page)


                            VMS DECwindows Motif Software Components C-1

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    CLOCK.DDIF                     Paint        ALL
                                                   example

                    DECBURGER.C                    UIL DRM      PROG
                                                   Demo source

                    DECBURGER.COM                  UIL DRM      PROG
                                                   Demo file

                    DECBURGER.EXE                  UIL DRM      PROG
                                                   Demo image

                    DECBURGER.HLP                  UIL DRM      PROG
                                                   Demo source

                    DECBURGER_HELP.DECW$BOOK       UIL DRM      PROG
                                                   Demo source

                    DECBURGER_HELP.DECW$BOOKSHELF  UIL DRM      PROG
                                                   Demo source

                    DECBURGER.UID                  UIL DRM      PROG
                                                   Demo file

                    DECBURGER.UIL                  UIL DRM      PROG
                                                   Demo file

                    DECW$CDPLAYER.C                Demo image   PROG

                    DECW$CDPLAYER.EXE              Demo image   PROG

                    DECW$DXM_PORT.COM              Demo image   PROG

                    DECW$DXM_PORT_CALL.EXE         Demo image   PROG

                                             (continued on next page)




     C-2 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$DXM_PORT_CLASS.EXE        Demo image   PROG

                       DECW$DXM_PORT_DATA.EXE         Demo image   PROG

                       DECW$DXM_PORT_DRM.EXE          Demo image   PROG

                       DECW$DXM_PORT_HILEVELS.EXE     Demo image   PROG

                       DECW$DXM_PORT_INCLUDES.EXE     Demo image   PROG

                       DECW$DXM_PORT_LOLEVELS.EXE     Demo image   PROG

                       DECW$DXM_PORT_RESOURCES.EXE    Demo image   PROG

                       DECW$DXM_PORT_UIL.EXE          Demo image   PROG

                       DECW$FONT_ALIAS_CHARTER.DAT    Demo font    PROG
                                                      alias file

                       DECW$FONT_ALIAS_CHARTER_       Demo font    PROG
                       100DPI.DAT                     alias file

                       DECW$FONT_ALIAS_FILENAMES.DAT  Demo font    PROG
                                                      alias file

                       DECW$FONT_ALIAS_KANJI.DAT      Demo font    PROG
                                                      alias file

                       DECW$FONT_ALIAS_LUCIDA.DAT     Demo font    PROG
                                                      alias file

                       DECW$FONT_ALIAS_LUCIDA_        Demo font    PROG
                       100DPI.DAT                     alias file

                                                (continued on next page)





                            VMS DECwindows Motif Software Components C-3

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$TRANSPORT_EXAMPLE.EXE     Demo image   PROG

                    DEMO_BUILD.COM                 Procedure    PROG
                                                   to compile
                                                   demo
                                                   sources

                    DIALOG.C                       Demo source  PROG

                    ENCODEFONT.PS

                    FONTS.ALIAS                    Font alias   ALL
                                                   file for
                                                   non-DEC
                                                   servers

                    HELLOMOTIF.ADA                 XUI Toolkit  PROG
                                                   demo source

                    HELLOMOTIF.FOR                 XUI Toolkit  PROG
                                                   demo source

                    HELLOMOTIF.PAS                 XUI Toolkit  PROG
                                                   demo source

                    HELLOMOTIF.UIL                 XUI Toolkit  PROG
                                                   demo source

                    ICO.C                          Demo source  PROG

                    ICO.EXE                        Demo image   PROG

                    ICON.XBM                       Demo image   PROG

                                             (continued on next page)





     C-4 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       MOTIFBURGER.ADA                Demo source  PROG

                       MOTIFBURGER.FOR                Demo source  PROG

                       MOTIFBURGER_DEFS.FOR           Demo source  PROG

                       MOTIFBURGER.UIL                Demo source  PROG

                       OBJCUBE.H                      Demo source  PROG

                       OBJICO.H                       Demo source  PROG

                       OBJTETRA.H                     Demo source  PROG

                       PERIODIC.C                     Demo source  PROG

                       PERIODIC.EXE                   Demo image   PROG

                       PERIODIC.UID                   Demo source  PROG

                       PERIODIC.UIL                   Demo source  PROG

                       POLYINFO.H                     Demo source  PROG

                       STRINGS.MAR                    Low-level    PROG
                                                      DECwindows
                                                      utility
                                                      routine

                       SVNMSAMPLE.C                   Demo source  PROG

                       SVNMSAMPLE.EXE                 Demo image   PROG

                       SVNMSAMPLESOURCE.C             Demo source  PROG

                                                (continued on next page)




                            VMS DECwindows Motif Software Components C-5

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    UILWMDCREATE.C                 Demo source  PROG

                    UILWMDCREATE.COM               Demo image   PROG

                    XLIBINTRO.ADA                  Xlib demo    PROG
                                                   source

                    XLIBINTRO.C                    Xlib demo    PROG
                                                   source

                    XLIBINTRO.EXE                  Xlib demo    PROG
                                                   image

                    XLIBINTRO.FOR                  Xlib demo    PROG
                                                   source

                    XPORTEXAMPLEDEF.R32            Demo source  PROG

                    XPORT_EXAMPLE.B32              Demo source  PROG

                    XPORT_EXAMPLE_XFER.MAR         Demo source  PROG



     DECW$FONT:     *.DECW$FONT                    Font files   WS

                    DECW$FONT_ALIAS.DAT            Font alias   WS
                                                   file

                    DECW$FONT_ALIAS_100DPI.DAT     Font alias   WS
                                                   file

                    DECW$FONT_ALIAS_COMMON.DAT     Font alias   WS
                                                   file

                                             (continued on next page)




     C-6 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$FONT_DIRECTORY.DAT        Font         WS
                                                      directory
                                                      file

                       DECW$FONT_DIRECTORY_           Font         WS
                       100DPI.DAT                     directory
                                                      file

                       DECW$FONT_DIRECTORY_           Font         WS
                       COMMON.DAT                     directory
                                                      file

                       DECW$FONT_DIRECTORY_           Font         WS
                       CURSOR16.DAT                   directory
                                                      file

                       DECW$FONT_DIRECTORY_           Font         WS
                       CURSOR32.DAT                   directory
                                                      file

                       *.XDPS$OUTLINE                 Display      WS
                                                      PostScript
                                                      font
                                                      outlines



                       See either the VAX or MIT C    DECwindows   WS
                       version of the VMS DECwindows  fonts
                       Guide to Xlib (Release 4)
                       Programming for a complete
                       list of DECwindows fonts.



                                                (continued on next page)




                            VMS DECwindows Motif Software Components C-7

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

     DECW$INCLUDE:  ARROWB.H                       C language   PROG
                                                   include
                                                   file

                    ARROWBG.H                      C language   PROG
                                                   include
                                                   file

                    ARROWBGP.H                     C language   PROG
                                                   include
                                                   file

                    ARROWBP.H                      C language   PROG
                                                   include
                                                   file

                    ATOMMGR.H                      C language   PROG
                                                   include
                                                   file

                    BASECLASSI.H                   C language   PROG
                                                   include
                                                   file

                    BITMAPS.H                      C language   PROG
                                                   include
                                                   file

                    BULLETINB.H                    C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-8 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       BULLETINBP.H                   C language   PROG
                                                      include
                                                      file

                       CACHEP.H                       C language   PROG
                                                      include
                                                      file

                       CASCADEB.H                     C language   PROG
                                                      include
                                                      file

                       CASCADEBG.H                    C language   PROG
                                                      include
                                                      file

                       CASCADEBGP.H                   C language   PROG
                                                      include
                                                      file

                       CASCADEBP.H                    C language   PROG
                                                      include
                                                      file

                       COMMAND.H                      C language   PROG
                                                      include
                                                      file

                       COMMANDP.H                     C language   PROG
                                                      include
                                                      file

                                                (continued on next page)







                            VMS DECwindows Motif Software Components C-9

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    COMPOBJ.H                      C language   PROG
                                                   include
                                                   file

                    COMPOBJP.H                     C language   PROG
                                                   include
                                                   file

                    COMPOSITE.H                    C language   PROG
                                                   include
                                                   file

                    COMPOSITEP.H                   C language   PROG
                                                   include
                                                   file

                    CONSTRAINP.H                   C language   PROG
                                                   include
                                                   file

                    CONSTRAINT.H                   C language   PROG
                                                   include
                                                   file

                    CONVERT.H                      C language   PROG
                                                   include
                                                   file

                    CORE.H                         C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-10 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       COREP.H                        C language   PROG
                                                      include
                                                      file

                       CSTEXTP.H                      C language   PROG
                                                      include
                                                      file

                       CURSORFONT.H                   C language   PROG
                                                      include
                                                      file

                       CUTPASTE.H                     C language   PROG
                                                      include
                                                      file

                       CUTPASTEP.H                    C language   PROG
                                                      include
                                                      file

                       D2DX.H                         C language   PROG
                                                      include
                                                      file

                       D2DXSTR.H                      C language   PROG
                                                      include
                                                      file

                       DECSPECIFIC.H                  C language   PROG
                                                      include
                                                      file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-11

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$GBLSTRINGS.H              C language   PROG
                                                   include
                                                   file

                    DECWDWTAPPLPROG.H              C language   PROG
                                                   include
                                                   file

                    DECWDWTAPPLPROG.UIL            C language   PROG
                                                   include
                                                   file

                    DECWDWTWIDGETPROG.H            C language   PROG
                                                   include
                                                   file

                    DECWI18N.H                     C language   PROG
                                                   include
                                                   file

                    DECWMHINTS.H                   C language   PROG
                                                   include
                                                   file

                    DIALOGS.H                      C language   PROG
                                                   include
                                                   file

                    DIALOGSP.H                     C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-12 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DRAWINGA.H                     C language   PROG
                                                      include
                                                      file

                       DRAWINGAP.H                    C language   PROG
                                                      include
                                                      file

                       DRAWNB.H                       C language   PROG
                                                      include
                                                      file

                       DRAWNBP.H                      C language   PROG
                                                      include
                                                      file

                       DRMDECLS.H                     C language   PROG
                                                      include
                                                      file

                       DRMPUBLIC.H                    C language   PROG
                                                      include
                                                      file

                       DWTAPPL.H                      C language   PROG
                                                      include
                                                      file

                       DWTAPPL.UIL                    UIL          PROG
                                                      language
                                                      include
                                                      file

                                                (continued on next page)






                           VMS DECwindows Motif Software Components C-13

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DWTSTRING.H                    C language   PROG
                                                   include
                                                   file

                    DWTWIDGET.H                    C language   PROG
                                                   include
                                                   file

                    DWTXLATARG.UIL                 C language   PROG
                                                   include
                                                   file

                    DWTXLATTEXT.UIL                C language   PROG
                                                   include
                                                   file

                    DXMCOLOR.H                     C language   PROG
                                                   include
                                                   file

                    DXMCOLORP.H                    C language   PROG
                                                   include
                                                   file

                    DXMCSTEXT.H                    C language   PROG
                                                   include
                                                   file

                    DXMCSTEXTP.H                   C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-14 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DXMHELPB.H                     C language   PROG
                                                      include
                                                      file

                       DXMHELPBP.H                    C language   PROG
                                                      include
                                                      file

                       DXMHELPSP.H                    C language   PROG
                                                      include
                                                      file

                       DXMPRINT.H                     C language   PROG
                                                      include
                                                      file

                       DXMPRINTP.H                    C language   PROG
                                                      include
                                                      file

                       DXMSVN.H                       C language   PROG
                                                      include
                                                      file

                       DXMSVNP.H                      C language   PROG
                                                      include
                                                      file

                       DXMXLATARG.UIL                 C language   PROG
                                                      include
                                                      file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-15

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DXMXLATTEXT.UIL                C language   PROG
                                                   include
                                                   file

                    EVENT.H                        C language   PROG
                                                   include
                                                   file

                    EXTOBJECT.H                    C language   PROG
                                                   include
                                                   file

                    EXTOBJECTP.H                   C language   PROG
                                                   include
                                                   file

                    FILESB.H                       C language   PROG
                                                   include
                                                   file

                    FILESBP.H                      C language   PROG
                                                   include
                                                   file

                    FORM.H                         C language   PROG
                                                   include
                                                   file

                    FORMP.H                        C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-16 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       FRAME.H                        C language   PROG
                                                      include
                                                      file

                       FRAMEP.H                       C language   PROG
                                                      include
                                                      file

                       GETSECRES.H                    C language   PROG
                                                      include
                                                      file

                       IDB.H                          C language   PROG
                                                      include
                                                      file

                       INTRINSIC.H                    C language   PROG
                                                      include
                                                      file

                       INTRINSICP.H                   C language   PROG
                                                      include
                                                      file

                       KEYSYM.H                       C language   PROG
                                                      include
                                                      file

                       KEYSYMDEF.H                    C language   PROG
                                                      include
                                                      file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-17

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    LABEL.H                        C language   PROG
                                                   include
                                                   file

                    LABELG.H                       C language   PROG
                                                   include
                                                   file

                    LABELGP.H                      C language   PROG
                                                   include
                                                   file

                    LABELP.H                       C language   PROG
                                                   include
                                                   file

                    LIST.H                         C language   PROG
                                                   include
                                                   file

                    LISTP.H                        C language   PROG
                                                   include
                                                   file

                    MAINW.H                        C language   PROG
                                                   include
                                                   file

                    MAINWP.H                       C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-18 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       MENUSHELL.H                    C language   PROG
                                                      include
                                                      file

                       MENUSHELLP.H                   C language   PROG
                                                      include
                                                      file

                       MESSAGEB.H                     C language   PROG
                                                      include
                                                      file

                       MESSAGEBP.H                    C language   PROG
                                                      include
                                                      file

                       MRM.H                          C language   PROG
                                                      include
                                                      file

                       MRMAPPL.H                      C language   PROG
                                                      include
                                                      file

                       MRMDECLS.H                     C language   PROG
                                                      include
                                                      file

                       MRMPUBLIC.H                    C language   PROG
                                                      include
                                                      file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-19

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    MRMWIDGET.H                    C language   PROG
                                                   include
                                                   file

                    MWMUTIL.H                      C language   PROG
                                                   include
                                                   file

                    OBJECT.H                       C language   PROG
                                                   include
                                                   file

                    OBJECTP.H                      C language   PROG
                                                   include
                                                   file

                    PANEDW.H                       C language   PROG
                                                   include
                                                   file

                    PANEDWP.H                      C language   PROG
                                                   include
                                                   file

                    PROTOCOLS.H                    C language   PROG
                                                   include
                                                   file

                    PROTOCOLSP.H                   C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-20 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       PUSHB.H                        C language   PROG
                                                      include
                                                      file

                       PUSHBG.H                       C language   PROG
                                                      include
                                                      file

                       PUSHBGP.H                      C language   PROG
                                                      include
                                                      file

                       PUSHBP.H                       C language   PROG
                                                      include
                                                      file

                       QUARKS.H                       C language   PROG
                                                      include
                                                      file

                       RECTOBJ.H                      C language   PROG
                                                      include
                                                      file

                       RECTOBJP.H                     C language   PROG
                                                      include
                                                      file

                       ROWCOLUMN.H                    C language   PROG
                                                      include
                                                      file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-21

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    ROWCOLUMNP.H                   C language   PROG
                                                   include
                                                   file

                    SASHP.H                        C language   PROG
                                                   include
                                                   file

                    SCALE.H                        C language   PROG
                                                   include
                                                   file

                    SCALEP.H                       C language   PROG
                                                   include
                                                   file

                    SCROLLBAR.H                    C language   PROG
                                                   include
                                                   file

                    SCROLLBARP.H                   C language   PROG
                                                   include
                                                   file

                    SCROLLEDW.H                    C language   PROG
                                                   include
                                                   file

                    SCROLLEDWP.H                   C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-22 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       SELECTIOB.H                    C language   PROG
                                                      include
                                                      file

                       SELECTIOBP.H                   C language   PROG
                                                      include
                                                      file

                       SELECTION.H                    C language   PROG
                                                      include
                                                      file

                       SEPARATOG.H                    C language   PROG
                                                      include
                                                      file

                       SEPARATOGP.H                   C language   PROG
                                                      include
                                                      file

                       SEPARATOR.H                    C language   PROG
                                                      include
                                                      file

                       SEPARATORP.H                   C language   PROG
                                                      include
                                                      file

                       SHELL.H                        C language   PROG
                                                      include
                                                      file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-23

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    SHELLP.H                       C language   PROG
                                                   include
                                                   file

                    STRINGDEFS.H                   C language   PROG
                                                   include
                                                   file

                    STRINGSRCP.H                   C language   PROG
                                                   include
                                                   file

                    TEXT.H                         C language   PROG
                                                   include
                                                   file

                    TEXTF.H                        C language   PROG
                                                   include
                                                   file

                    TEXTFP.H                       C language   PROG
                                                   include
                                                   file

                    TEXTINP.H                      C language   PROG
                                                   include
                                                   file

                    TEXTOUTP.H                     C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-24 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       TEXTP.H                        C language   PROG
                                                      include
                                                      file

                       TEXTSRCP.H                     C language   PROG
                                                      include
                                                      file

                       TOGGLEB.H                      C language   PROG
                                                      include
                                                      file

                       TOGGLEBG.H                     C language   PROG
                                                      include
                                                      file

                       TOGGLEBGP.H                    C language   PROG
                                                      include
                                                      file

                       TOGGLEBP.H                     C language   PROG
                                                      include
                                                      file

                       TRANSLATE.H                    C language   PROG
                                                      include
                                                      file

                       TRAVERSAL.H                    C language   PROG
                                                      include
                                                      file

                       UILDBDEF.H                     Demo image   PROG

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-25

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    UILLEXPARS.H                   C language   PROG
                                                   include
                                                   file

                    VASIMPLE.H                     C language   PROG
                                                   include
                                                   file

                    VENDOR.H                       C language   PROG
                                                   include
                                                   file

                    VENDORE.H                      C language   PROG
                                                   include
                                                   file

                    VENDOREP.H                     C language   PROG
                                                   include
                                                   file

                    VENDORP.H                      C language   PROG
                                                   include
                                                   file

                    VIRTKEYS.H                     C language   PROG
                                                   include
                                                   file

                    VIRTKEYSP.H                    C language   PROG
                                                   include
                                                   file

                                             (continued on next page)







     C-26 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       WINDOWOBJ.H                    C language   PROG
                                                      include
                                                      file

                       WINDOWOBJP.H                   C language   PROG
                                                      include
                                                      file

                       X.H                            C language   PROG
                                                      include
                                                      file

                       XATOM.H                        C language   PROG
                                                      include
                                                      file

                       XLIB.H                         C language   PROG
                                                      include
                                                      file

                       XM.H                           C language   PROG
                                                      include
                                                      file

                       XMAPPL.UIL                     C language   PROG
                                                      include
                                                      file

                       XMD.H                          C language   PROG
                                                      include
                                                      file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-27

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    XMP.H                          C language   PROG
                                                   include
                                                   file

                    XOS.H                          C language   PROG
                                                   include
                                                   file

                    XPROTO.H                       C language   PROG
                                                   include
                                                   file

                    XPROTOSTR.H                    C language   PROG
                                                   include
                                                   file

                    XRESOURCE.H                    C language   PROG
                                                   include
                                                   file

                    XTOS.H                         C language   PROG
                                                   include
                                                   file

                    XUTIL.H                        C language   PROG
                                                   include
                                                   file



                                             (continued on next page)









     C-28 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

        SYS$LIBRARY:   CDA$ACCESS.EXE                 The CDA      ALL
                                                      Toolkit
                                                      and CDA
                                                      converter
                                                      Toolkit
                                                      run-time-
                                                      library
                                                      shareable
                                                      image

                       CDA$CDA_.ADA                   CDA Ada      PROG
                                                      binding

                       CDA$DEF.*[1]                   CDA          PROG
                                                      language
                                                      bindings

                       CDA$DTIF_TO_DDIF.EXE           CDA DTIF     ALL
                                                      to DDIF
                                                      converter
                                                      image

                       CDA$MSG.*[1]                   CDA message  PROG
                                                      symbols

                       CDA$PTP.H                      CDA C        PROG
                                                      langugage
                                                      include
                                                      file

        [1]Indicates_that_BASIC,_BLISS,_FORTRAN,_C,_Macro,_Pascal,_and__

        PL/I languages are supported.

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-29

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    CDA$TYP.H                      CDA C        PROG
                                                   langugage
                                                   include
                                                   file

                    CDA$WRITE_ANALYSIS.EXE         CDA image    ALL

                    DDIF$DDIF_.ADA                 DDIF Ada     PROG
                                                   binding

                    DDIF$DEF.*[1]                  DDIF         PROG
                                                   language
                                                   bindings

                    DDIF$READ_TEXT.EXE             Text         ALL
                                                   front end
                                                   shareable
                                                   image

                    DDIF$VIEWSHR.EXE               DDIF viewer  ALL
                                                   shareable
                                                   image

                    DDIF$WRITE_PS.EXE              Text image   ALL

                    DDIF$WRITE_TEXT.EXE            Text         ALL
                                                   back end
                                                   shareable
                                                   image

                    DECW$AILSHR.EXE                Shareable    ALL
                                                   image

     [1]Indicates_that_BASIC,_BLISS,_FORTRAN,_C,_Macro,_Pascal,_and__

     PL/I languages are supported.

                                             (continued on next page)


     C-30 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$CALENDAR_PROLOG.PS        PostScript   ALL
                                                      initial-
                                                      ization
                                                      file

                       DECW$CURSOR.H                  Cursor       PROG
                                                      include
                                                      file

                       DECW$D2DXLIBSHR.EXE            CDA image    ALL

                       DECW$DRIVER.MLB                Driver       WS
                                                      macro
                                                      library

                       DECW$DWT_.ADA                  XUI Toolkit  PROG
                                                      Ada binding

                       DECW$DWTDEF.*[1]               XUI Toolkit  PROG
                                                      Widget
                                                      include
                                                      file

                       DECW$DWTDEF.UIL                XUI          PROG
                                                      Toolkit UIL
                                                      definitions

                       DECW$DWTENTRY.*[1]             XUI Toolkit  PROG
                                                      Widget
                                                      include
                                                      files

        [1]Indicates_that_BASIC,_BLISS,_FORTRAN,_C,_Macro,_Pascal,_and__

        PL/I languages are supported.

                                                (continued on next page)



                           VMS DECwindows Motif Software Components C-31

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$DWTLIBSHR.EXE             XUI Toolkit  ALL
                                                   thin-layer
                                                   shareable
                                                   image

                    DECW$DWTMSG.*[1]               XUI Toolkit  PROG
                                                   include
                                                   files

                    DECW$DWTSHR.EXE                XUI Toolkit  ALL
                                                   shareable
                                                   image

                    DECW$DWTSTRUCT.*[1]            XUI Toolkit  PROG
                                                   Widget
                                                   include
                                                   files

                    DECW$DWTWIDGETDEF.*[1]         XUI Toolkit  PROG
                                                   Widget
                                                   include
                                                   files

                    DECW$DWTWIDGETSTRUCT.*[1]      XUI Toolkit  PROG
                                                   Widget
                                                   include
                                                   files

     [1]Indicates_that_BASIC,_BLISS,_FORTRAN,_C,_Macro,_Pascal,_and__

     PL/I languages are supported.

                                             (continued on next page)







     C-32 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$DXMLIBSHR.EXE             Digital      ALL
                                                      Extended
                                                      Motif
                                                      Toolkit
                                                      thin-layer
                                                      shareable
                                                      image

                       DECW$FONTCOMPILER.CLD          Font         WS
                                                      compile
                                                      command
                                                      language
                                                      definition
                                                      file

                       DECW$LOGINOUT.EXE              DECwindows   ALL
                                                      extension
                                                      to VMS
                                                      LOGINOUT
                                                      image

                       DECW$MAILSHR.EXE               DECwindows   ALL
                                                      Mail
                                                      shareable
                                                      image

                       DECW$MOTIF.FOR                 MOTIF        PROG
                                                      toolkit
                                                      include
                                                      file

                       DECW$MOTIF.PAS                 MOTIF        PROG
                                                      toolkit
                                                      include
                                                      file

                                                (continued on next page)



                           VMS DECwindows Motif Software Components C-33

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$MOTIF_.ADA                MOTIF        PROG
                                                   toolkit
                                                   include
                                                   file

                    DECW$PRINTWGTSHR.EXE           Print        ALL
                                                   widget
                                                   shareable
                                                   image

                    DECW$SERVER_DDX_GA.EXE         Server       WS
                                                   shareable
                                                   image for
                                                   color
                                                   device
                                                   support

                    DECW$SERVER_DDX_GB.EXE         Server       WS
                                                   shareable
                                                   image for
                                                   VS35xx
                                                   device
                                                   support

                    DECW$SERVER_DDX_GC.EXE         Server       WS
                                                   shareable
                                                   image for
                                                   monochrome
                                                   frame
                                                   buffer
                                                   device
                                                   support

                                             (continued on next page)






     C-34 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$SERVER_DDX_GE.EXE         Server       WS
                                                      shareable
                                                      image for
                                                      SPX device
                                                      support

                       DECW$SERVER_DDX_GF.EXE         Server       WS
                                                      shareable
                                                      image for
                                                      LCG device
                                                      support

                       DECW$SERVER_DIX.EXE            Server       WS
                                                      shareable
                                                      image for
                                                      device
                                                      independent
                                                      support

                       DECW$SVEXT_ADOBE_DPS_          Display      WS
                       EXTENSION.EXE                  PostScript
                                                      server
                                                      extension
                                                      shareable
                                                      image file

                       DECW$SVEXT_D2DX_EXTENSIONS.EXE D2DX server  WS
                                                      extension
                                                      shareable
                                                      image file

                                                (continued on next page)








                           VMS DECwindows Motif Software Components C-35

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$SVEXT_DEC_XTRAP.EXE       Xtrap        WS
                                                   server
                                                   extension
                                                   shareable
                                                   image file

                    DECW$SVEXT_MULTI_BUFFERING.EXE Multi-       WS
                                                   buffering
                                                   server
                                                   extension
                                                   shareable
                                                   image file

                    DECW$SVEXT_X3D_PEX.EXE         PEX server   WS
                                                   extension
                                                   shareable
                                                   image file

                    DECW$SVEXT_X3D_PEX_GB.EXE      PEX server   WS
                                                   extension
                                                   on VS35xx
                                                   shareable
                                                   image file

                    DECW$SVEXT_X3D_PEX_GB_         Microcode    WS
                    UCODE.EXE                      image file
                                                   for PEX
                                                   server
                                                   extension
                                                   on VS35xx

                                             (continued on next page)








     C-36 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$SVEXT_X3D_PEX_GE.EXE      PEX server   WS
                                                      extension
                                                      on SPX
                                                      shareable
                                                      image file

                       DECW$SVEXT_XIE.EXE             X imaging    WS
                                                      server
                                                      extension
                                                      shareable
                                                      image file

                       DECW$TERMINALSHR.EXE           DECterm      ALL
                                                      terminal
                                                      emulator
                                                      shareable
                                                      image

                       DECW$TRANSPORT_COMMON.EXE      Transport    ALL
                                                      common
                                                      routines
                                                      shareable
                                                      image

                       DECW$TRANSPORT_DECNET.EXE      DECnet       ALL
                                                      transport
                                                      interface
                                                      shareable
                                                      image

                                                (continued on next page)









                           VMS DECwindows Motif Software Components C-37

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$TRANSPORT_LOCAL.EXE       Local        ALL
                                                   (shared
                                                   memory)
                                                   transport
                                                   interface
                                                   image

                    DECW$TRANSPORT_TCPIP.EXE       TCP/IP       ALL
                                                   (UCX)
                                                   transport
                                                   interface
                                                   image

                    DECW$UIL.ENV                   LSE          PROG
                                                   template
                                                   for UIL
                                                   compilier

                    DECW$UILCOMPILER.CLD           UIL          PROG
                                                   compiler
                                                   command
                                                   language
                                                   definition
                                                   file

                    DECW$WML_TOKENS.DAT            Widget       PROG
                                                   meta-
                                                   language
                                                   tokens data

                    DECW$XKEYSYMDB.DAT             Key symbols  WS
                                                   data

                                             (continued on next page)






     C-38 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$XLIBDEF.*[1]              Xlib         PROG
                                                      language
                                                      bindings

                       DECW$XLIBMSG.*[1]              Xlib         PROG
                                                      message
                                                      symbols

                       DECW$XLIBSHR.EXE               Xlib         ALL
                                                      shareable
                                                      image

                       DECW$XMLIBSHR.EXE              Motif        ALL
                                                      toolkit
                                                      thin-layer
                                                      shareable
                                                      image

                       DECW$XTSHR.EXE                 Xtoolkit     ALL
                                                      (Intrinsics)
                                                      shareable
                                                      image

                       DECW$X_.ADA                    Xlib Ada     PROG
                                                      bindings

                       DECW$XPORTCOM.*[2]             Transport    PROG
                                                      programmer
                                                      files

        [1]Indicates_that_BASIC,_BLISS,_FORTRAN,_C,_Macro,_Pascal,_and__

        PL/I languages are supported.
        [2]Indicates that only BLISS, Macro, and C languages are
        supported.

                                                (continued on next page)



                           VMS DECwindows Motif Software Components C-39

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$XPORTDEF.*[2]             Transport    PROG
                                                   programmer
                                                   files

                    DECW$XPORTMAC.R32              Transport    PROG
                                                   programmer
                                                   file

                    DECW$XPORTMSG.R32              Transport    PROG
                                                   programmer
                                                   file

                    DGIT$LIBSHR.EXE                Digital      ALL
                                                   extended
                                                   toolkit
                                                   shareable
                                                   image

                    DTIF$DEF.*[1]                  DTIF         PROG
                                                   programmer
                                                   files

                    DTIF$DTIF_.ADA                 DTIF Ada     PROG
                                                   language
                                                   support
                                                   file

                    DVR$CC_DEF.H                   DDIF viewer  PROG
                                                   C language
                                                   support
                                                   file

     [1]Indicates_that_BASIC,_BLISS,_FORTRAN,_C,_Macro,_Pascal,_and__

     PL/I languages are supported.
     [2]Indicates that only BLISS, Macro, and C languages are
     supported.

                                             (continued on next page)

     C-40 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DVR$CC_PTP.H                   DDIF viewer  PROG
                                                      C language
                                                      support
                                                      file

                       DVR$DECW_DEF.H                 DDIF viewer  PROG
                                                      C language
                                                      support
                                                      file

                       DVR$DECW_PTP.H                 DDIF viewer  PROG
                                                      C language
                                                      support
                                                      file

                       DVR$MSG.H                      DDIF viewer  PROG
                                                      C language
                                                      support
                                                      file

                       IMG$SHRLIB.EXE                 DECimage     ALL
                                                      Application
                                                      Services
                                                      (DAS)
                                                      library
                                                      shareable
                                                      image

                       LWK$DXMSHR.EXE                 Linkworks    ALL
                                                      shareable
                                                      image

                       VUE$MASTERSHR.EXE              Fileview     ALL
                                                      shareable
                                                      image

                                                (continued on next page)



                           VMS DECwindows Motif Software Components C-41

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    XDPS$DPSBINDINGSSHR.EXE        Display      ALL
                                                   PostScript
                                                   client
                                                   library
                                                   VAX binding
                                                   shareable
                                                   image

                    XDPS$DPSCLIENTSHR.EXE          Display      ALL
                                                   PostScript
                                                   client
                                                   library
                                                   C binding
                                                   shareable
                                                   image

                    XDPS$DPSLIBSHR.EXE             Display      ALL
                                                   PostScript
                                                   Xlib
                                                   extension
                                                   shareable
                                                   image

                    XDPS$DPSOPS.*[3]               X Display    PROG
                                                   PostScript
                                                   language
                                                   support
                                                   files

     [3]Indicates_that_BASIC,_BLISS,_FORTRAN,_C,_and_Macro_languages_

     are supported.

                                             (continued on next page)






     C-42 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       XDPS$DPSXCLIENT.*[3]           X Display    PROG
                                                      PostScript
                                                      language
                                                      support
                                                      files

                       XDPS$MASTERDPSVM.DAT           X Display    WS
                                                      PostScript
                                                      data file
                                                      used by
                                                      server

                       XDPS$PSOPS.*[3]                X Display    PROG
                                                      PostScript
                                                      language
                                                      support
                                                      files

                       XDPS$XDPS.*[3]                 X Display    PROG
                                                      PostScript
                                                      language
                                                      support
                                                      files

                       XDPS$XDPSLIB.*[3]              X Display    PROG
                                                      PostScript
                                                      language
                                                      support
                                                      files

        [3]Indicates_that_BASIC,_BLISS,_FORTRAN,_C,_and_Macro_languages_

        are supported.

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-43

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    XIE$SHRLIB.EXE                 X Imaging    ALL
                                                   Extension
                                                   library
                                                   shareable
                                                   image

                    XNL$DEF.*[4]                   Extended     PROG
                                                   Native
                                                   Language
                                                   support
                                                   files

                    XNL$MSG.*[4]                   Extended     PROG
                                                   Native
                                                   Language
                                                   support
                                                   files

                    XNL$SHR.EXE                    Language     ALL
                                                   switching
                                                   shareable
                                                   image

     SYS$MANAGER:   AGENPARAMS.EXE                 Installation ALL
                                                   file

                    DECW$CHECK_PARAMS.COM          Check        ALL
                                                   AUTOGEN
                                                   parameters

     [4]Indicates_that_Ada,_BASIC,_BLISS,_FORTRAN,_C,_Macro,_Pascal,_

     and PL/I languages are supported.

                                             (continued on next page)





     C-44 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$DEVICE.COM                Device       ALL
                                                      detection
                                                      and config-
                                                      uration

                       DECW$DEVICE_GE.COM             SPX device   WS
                                                      configura-
                                                      tion

                       DECW$DEVICE_GG.COM             SPX device   WS
                                                      configura-
                                                      tion

                       DECW$DEVICE_GF.COM             LCG device   WS
                                                      configura-
                                                      tion

                       DECW$LOGICALS.COM              Logical      ALL
                                                      name table
                                                      initializa-
                                                      tion and
                                                      start

                       DECW$MWM.COM                   Starts       ALL
                                                      the Motif
                                                      window
                                                      manager

                       DECW$PRIVATE_APPS_SETUP.TEMPLATApplications ALL
                                                      cus-
                                                      tomization
                                                      template

                                                (continued on next page)






                           VMS DECwindows Motif Software Components C-45

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$PRIVATE_SERVER_           Server cus-  WS
                    SETUP.TEMPLATE                 tomization
                                                   template

                    DECW$RGB.COM                   Definitions  WS
                                                   of
                                                   DECwindows
                                                   color names

                    DECW$STARTAPPS.COM             Applications ALL
                                                   and user
                                                   environment
                                                   startup

                    DECW$STARTI18N.COM             DECwindows   WS
                                                   layered
                                                   product
                                                   support
                                                   file

                    DECW$STARTLIBS.COM             Programming  ALL
                                                   environment
                                                   startup

                    DECW$STARTSERVER.COM           Server ini-  WS
                                                   tialization
                                                   and startup

                    DECW$STARTSM.COM               Starts the   ALL
                                                   session
                                                   manager

                    DECW$STARTUP.COM               Starts the   ALL
                                                   DECwindows
                                                   environment

                                             (continued on next page)



     C-46 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$SYLOGIN.TEMPLATE          System       ALL
                                                      login file
                                                      template

                       DECW$VMSPARAMS.COM             Installation ALL
                                                      file


        SYS$MESSAGE:   CDA$ACCESSMSG.EXE              CDA message  ALL
                                                      image

                       DDIF$VIEWMSG.EXE               Viewer       ALL
                                                      message
                                                      file

                       DECW$DWTERRDB.DAT              XUI and      ALL
                                                      Motif
                                                      Toolkit
                                                      message
                                                      data file

                       DECW$DWTMSG.EXE                XUI and      ALL
                                                      Motif
                                                      Toolkit
                                                      message
                                                      image file

                       DECW$TERMINALMSG.EXE           DECterm      ALL
                                                      terminal
                                                      emulator
                                                      message
                                                      file


                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-47

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$TRANSPORTMSG.EXE          Transport    ALL
                                                   message
                                                   image

                    DECW$XLIBERRDB.DAT             Xlib         ALL
                                                   message
                                                   data file

                    DECW$XLIBMSG.EXE               Xlib         ALL
                                                   message
                                                   image file


     SYS$SYSTEM:    CDA$CONVERT.EXE                DDIF         ALL
                                                   converter
                                                   image

                    DDIF$VIEW.EXE                  DDIF viewer  ALL
                                                   image

                    DECW$BOOKREADER.EXE            Bookreader   ALL
                                                   image

                    DECW$CALC.EXE                  Calculator   ALL
                                                   image

                    DECW$CALENDAR.EXE              Calendar     ALL
                                                   image

                    DECW$CARDFILER.EXE             Cardfiler    ALL
                                                   image


                                             (continued on next page)






     C-48 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$CBI.EXE                   Computer     ALL
                                                      based
                                                      instruction
                                                      image

                       DECW$CLOCK.EXE                 Clock image  ALL

                       DECW$ENDSESSION.EXE            Session      ALL
                                                      manager
                                                      image

                       DECW$FONTCOMPILER.EXE          Font         WS
                                                      compiler
                                                      image

                       DECW$LWK_MANAGER.EXE           LinkWorks    ALL
                                                      manager
                                                      image

                       DECW$LWK_SETUP.EXE             LinkWorks    ALL
                                                      setup image

                       DECW$MAIL.EXE                  DECwindows   ALL
                                                      Mail image

                       DECW$MESSAGEPANEL.EXE          Message      ALL
                                                      panel image

                       DECW$MKFONTDIR.EXE             Make font    WS
                                                      directory
                                                      image

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-49

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$MWM.EXE                   Motif        ALL
                                                   Window
                                                   Manager
                                                   image

                    DECW$NOTEPAD.EXE               Notepad      ALL
                                                   image

                    DECW$PAINT.EXE                 Paint image  ALL

                    DECW$PAUSESESSION.EXE          Pause        ALL
                                                   session
                                                   image

                    DECW$PRINTSCREEN.EXE           Print        ALL
                                                   Screen
                                                   image

                    DECW$PUZZLE.EXE                Puzzle       ALL
                                                   image

                    DECW$SERVER_MAIN.EXE           Server       WS
                                                   device
                                                   independent
                                                   support
                                                   image

                    DECW$SESSION.EXE               Session      ALL
                                                   manager
                                                   image

                    DECW$SETSHODIS.EXE             SET/SHOW     ALL
                                                   DISPLAY
                                                   command
                                                   image

                                             (continued on next page)



     C-50 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$STARTLOGIN.EXE            Image to     ALL
                                                      start the
                                                      DECwindows
                                                      Start Login
                                                      box

                       DECW$TERMINAL.EXE              DECterm      ALL
                                                      terminal
                                                      emulator
                                                      controller
                                                      image

                       DECW$TERMINAL_CREATE.EXE       DECterm      ALL
                                                      terminal
                                                      emulator
                                                      creation
                                                      image

                       DECW$UILCOMPILER.EXE           UIL          PROG
                                                      compiler
                                                      image

                       DECW$UILMOTIF.EXE              Motif UIL    PROG
                                                      compiler
                                                      image file

                       DECW$WAITFORSM.EXE             Session      ALL
                                                      manager
                                                      support
                                                      image

                       DECW$WINMGR.EXE                XUI window   ALL
                                                      manager
                                                      image

                                                (continued on next page)




                           VMS DECwindows Motif Software Components C-51

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$WML.EXE                   Widget       PROG
                                                   meta-
                                                   language
                                                   image

                    DECW$WSCUST.EXE                Session      ALL
                                                   manager
                                                   customiza-
                                                   tion image

                    DECW$WSINIT.EXE                Session      ALL
                                                   manager
                                                   initial-
                                                   ization
                                                   image

                    VUE$MASTER.EXE                 FileView     ALL
                                                   image

                    XDPS$PSWRAP.EXE                PSWrap       PROG
                                                   utility
                                                   image

     SYS$LOADABLE_  GAADRIVER.EXE                  VAXstation   WS
     IMAGES:                                       II/GPX
                                                   device
                                                   driver

                    GABDRIVER.EXE                  VAXstation   WS
                                                   2000/GPX
                                                   device
                                                   driver

                                             (continued on next page)






     C-52 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       GBBDRIVER.EXE                  VS35xx       WS
                                                      device
                                                      driver

                       GCADRIVER.EXE                  VAXstation   WS
                                                      II
                                                      monochrome
                                                      frame
                                                      buffer
                                                      device
                                                      driver

                       GCBDRIVER.EXE                  VAXstation   WS
                                                      2000
                                                      monochrome
                                                      frame
                                                      buffer
                                                      device
                                                      driver

                       GEBDRIVER.EXE                  SPX device   WS
                                                      driver

                       GFBDRIVER.EXE                  LCG device   WS
                                                      driver

                       IKDRIVER.EXE                   Keyboard     WS
                                                      decoder
                                                      driver

                       IMDRIVER.EXE                   Mouse        WS
                                                      decoder
                                                      driver

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-53

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    INDRIVER.EXE                   Common       WS
                                                   input
                                                   function
                                                   driver

                    WSDRIVER.EXE                   SET/SHOW     ALL
                                                   DISPLAY
                                                   driver


     DECW$BOOK:     BOOKREADER.DECW$BOOK           Online       ALL
                                                   user's
                                                   guide
                                                   for the
                                                   Bookreader

                    LIBRARY.DECW$BOOKSHELF         Bookreader   ALL
                                                   bookshelf

     DECW$KEYMAP:   *.DECW$KEYMAP                  DECwindows   WS
                                                   Keymap
                                                   files (see
                                                   Table 3-1)



     SYS$HELP:      DDIF$VIEW.HLB                  View help    ALL
                                                   file

                    DECW$BOOKREADER.HLB            Bookreader   ALL
                                                   help file

                    DECW$CALC.HLB                  Calculator   ALL
                                                   help file


                                             (continued on next page)



     C-54 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$CALENDAR.HLB              Calendar     ALL
                                                      help file

                       DECW$CARDFILER.HLB             Cardfiler    ALL
                                                      help file

                       DECW$CLOCK.HLB                 Clock help   ALL
                                                      file

                       DECW$DXMCOLOR_HELP.HLB         Color mixer  ALL
                                                      help file

                       DECW$DXMHELP_HELP.HLB          HELP help    ALL
                                                      file

                       DECW$DXMPRINTWGT_HELP.HLB      PRINT help   ALL
                                                      file

                       DECW$HELPHELP.HLB              HELP help    ALL
                                                      file

                       DECW$LWK_MANAGER.HLB           LinkWorks    ALL
                                                      help file

                       DECW$MAIL.HLB                  Mail help    ALL
                                                      file

                       DECW$MESSAGEPANEL.HLB          Message      ALL
                                                      panel help
                                                      file

                       DECW$MOTIF010.RELEASE_NOTES    Release      ALL
                                                      Notes

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-55

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$MWM.HLB                   Window       ALL
                                                   Manager
                                                   help file

                    DECW$NOTEPAD.HLB               Notepad      ALL
                                                   help file

                    DECW$PAINT.HLB                 Paint help   ALL
                                                   file

                    DECW$PRINTSCREEN.HLB           Print        ALL
                                                   Screen
                                                   help file

                    DECW$PRINTWGT.HLB              Print help   ALL
                                                   file

                    DECW$PUZZLE.HLB                Puzzle help  ALL
                                                   file

                    DECW$SESSIONMANAGER.HLB        Session      ALL
                                                   Manager
                                                   help file

                    DECW$TERMINAL.HLB              DECterm      ALL
                                                   terminal
                                                   emulator
                                                   help file

                    DECW$VUE.HLB                   FileView     ALL
                                                   help file

                                             (continued on next page)







     C-56 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$WSCUST.HLB                Workstation  ALL
                                                      customiza-
                                                      tion help
                                                      file

                       EXAMPLES.DIR                   Examples     ALL
                                                      directory

                       LWK$DXMHELP.HLB                Help file    ALL

        SYS$UPDATE:    DECW$COMPARE_VERSIONS.COM      DECwindows   ALL
                                                      layered
                                                      product
                                                      support
                                                      file

                       DECW$COMPILE_ADA_UNITS.COM     Ada build    PROG
                                                      file

                       DECW$GET_IMAGE_VERSION.COM     DECwindows   ALL
                                                      layered
                                                      product
                                                      support
                                                      file

                       DECW$MKFONTDIR.COM             DECwindows   ALL
                                                      layered
                                                      product
                                                      support
                                                      file

                       DECW$MOTIF_TAILOR.EXE          Tailor       ALL
                                                      utility
                                                      image

                                                (continued on next page)




                           VMS DECwindows Motif Software Components C-57

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$VERSIONS.COM              DECwindows   ALL
                                                   layered
                                                   product
                                                   support
                                                   file


     VUE$LIBRARY:   VUE$*.COM                      FileView     ALL
                                                   verb
                                                   command
                                                   files



     DECW$SYSTEM_   DDIF$CSW.UID                   DDIF user    ALL
     DEFAULTS:                                     interface
                                                   data file

                    DDIF$VIEW.UID                  CDA viewer   ALL
                                                   user
                                                   interface
                                                   data file

                    DDIF$VIEWWGT.UID               CDA viewer   ALL
                                                   user
                                                   interface
                                                   data file

                    DECW$BOOKREADER.DAT            Bookreader   ALL
                                                   resource
                                                   file


                                             (continued on next page)






     C-58 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$BOOKREADER.UID            Bookreader   ALL
                                                      user
                                                      interface
                                                      data file

                       DECW$CALC.DAT                  Calculator   ALL
                                                      resource
                                                      file

                       DECW$CALC.UID                  Calculator   ALL
                                                      user
                                                      interface
                                                      data file

                       DECW$CALENDAR.DAT              Calendar     ALL
                                                      resource
                                                      file

                       DECW$CALENDAR.UID              Calendar     ALL
                                                      user
                                                      interface
                                                      data file

                       DECW$CARDFILER.DAT             Cardfiler    ALL
                                                      resource
                                                      file

                       DECW$CARDFILER.UID             Cardfiler    ALL
                                                      user
                                                      interface
                                                      data file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-59

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$CBI.UID                   Computer     ALL
                                                   based
                                                   instruction
                                                   user
                                                   interface
                                                   data file

                    DECW$CLOCK.DAT                 Clock        ALL
                                                   resource
                                                   file

                    DECW$CLOCK.UID                 Clock user   ALL
                                                   interface
                                                   data file

                    DECW$DXMPRINTWGT_UI.UID        Print        ALL
                                                   widget user
                                                   interface
                                                   data file

                    DECW$ENDSESSION.DAT            Session      ALL
                                                   manager
                                                   resource
                                                   file

                    DECW$ENDSESSION.UID            Session      ALL
                                                   manager
                                                   user
                                                   interface
                                                   data file

                    DECW$LOGIN.DAT                 Login        ALL
                                                   resource
                                                   file

                                             (continued on next page)




     C-60 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$LOGIN.UID                 Login user   ALL
                                                      interface
                                                      data file

                       DECW$LWK_MGR_ENV.UID           LinkWorks    ALL
                                                      manager
                                                      interface
                                                      data file

                       DECW$LWK_MGR_LB.UID            LinkWorks    ALL
                                                      manager
                                                      interface
                                                      data file

                       DECW$LWK_MGR_MISC.UID          LinkWorks    ALL
                                                      manager
                                                      interface
                                                      data file

                       DECW$MAIL.DAT                  DECwindows   ALL
                                                      Mail
                                                      resource
                                                      file

                       DECW$MAIL_MAIN.UID             DECwindows   ALL
                                                      Mail user
                                                      interface
                                                      data file

                       DECW$MAIL_MISC.UID             DECwindows   ALL
                                                      Mail user
                                                      interface
                                                      data file

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-61

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$MAIL_READ.UID             DECwindows   ALL
                                                   Mail user
                                                   interface
                                                   data file

                    DECW$MAIL_SEND.UID             DECwindows   ALL
                                                   Mail user
                                                   interface
                                                   data file

                    DECW$MESSAGEPANEL.DAT          Message      ALL
                                                   panel user
                                                   interface
                                                   resource
                                                   file

                    DECW$MESSAGEPANEL.UID          Message      ALL
                                                   panel user
                                                   interface
                                                   data file

                    DECW$MWM.DAT                   Motif        ALL
                                                   window
                                                   manager
                                                   resource
                                                   file

                    DECW$MWM.UID                   Motif        ALL
                                                   window
                                                   manager
                                                   user
                                                   interface
                                                   data file

                                             (continued on next page)





     C-62 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$MWM_BW.DAT                Motif        ALL
                                                      window
                                                      manager
                                                      resource
                                                      file

                       DECW$MWM_COLOR.DAT             Motif        ALL
                                                      window
                                                      manager
                                                      resource
                                                      file

                       DECW$MWM_GRAY.DAT              Motif        ALL
                                                      window
                                                      manager
                                                      resource
                                                      file

                       DECW$MWM_RC.DAT                Motif        ALL
                                                      window
                                                      manager
                                                      config-
                                                      uration
                                                      file

                       DECW$NOTEPAD.DAT               Notepad      ALL
                                                      resource
                                                      file

                       DECW$NOTEPAD.UID               Notepad      ALL
                                                      user
                                                      interface
                                                      data file

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-63

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$PAINT.DAT                 DECwindows   ALL
                                                   Paint
                                                   resource
                                                   file

                    DECW$PAINT.UID                 DECwindows   ALL
                                                   Paint user
                                                   interface
                                                   data file

                    DECW$PAUSESESSION.DAT          Session      ALL
                                                   Manager
                                                   resource
                                                   file

                    DECW$PAUSESESSION.UID          Session      ALL
                                                   Manager
                                                   user
                                                   interface
                                                   data file

                    DECW$PRINTSCREEN.UID           Print        ALL
                                                   Screen user
                                                   interface
                                                   data file

                    DECW$PRINTWGT_UI.UID           Print user   ALL
                                                   interface
                                                   data file

                    DECW$PUZZLE.DAT                Puzzle       ALL
                                                   resource
                                                   file

                                             (continued on next page)





     C-64 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$PUZZLE.UID                Puzzle user  ALL
                                                      interface
                                                      data file

                       DECW$SMB_BACKGROUND.DAT        Session      ALL
                                                      Manager
                                                      resource
                                                      file

                       DECW$SMB_BACKGROUND_BW.DAT     Session      ALL
                                                      Manager
                                                      resource
                                                      file

                       DECW$SMB_BACKGROUND_COLOR.DAT  Session      ALL
                                                      Manager
                                                      resource
                                                      file

                       DECW$SMB_BACKGROUND_GRAY.DAT   Session      ALL
                                                      Manager
                                                      resource
                                                      file

                       DECW$SMB_KEYBOARD.DAT          Session      ALL
                                                      Manager
                                                      resource
                                                      file

                       DECW$SMB_LANGUAGE.DAT          Session      ALL
                                                      Manager
                                                      resource
                                                      file

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-65

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$SMB_POINTER.DAT           Session      ALL
                                                   Manager
                                                   resource
                                                   file

                    DECW$SMB_POINTER_BW.DAT        Session      ALL
                                                   Manager
                                                   resource
                                                   file

                    DECW$SMB_POINTER_COLOR.DAT     Session      ALL
                                                   Manager
                                                   resource
                                                   file

                    DECW$SMB_POINTER_GRAY.DAT      Session      ALL
                                                   Manager
                                                   resource
                                                   file

                    DECW$SMB_SECURITY.DAT          Session      ALL
                                                   Manager
                                                   resource
                                                   file

                    DECW$SMB_WINDOW.DAT            Session      ALL
                                                   Manager
                                                   resource
                                                   file

                    DECW$SMB_WINDOW_BW.DAT         Session      ALL
                                                   Manager
                                                   resource
                                                   file

                                             (continued on next page)




     C-66 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DECW$SMB_WINDOW_COLOR.DAT      Session      ALL
                                                      Manager
                                                      resource
                                                      file

                       DECW$SMB_WINDOW_GRAY.DAT       Session      ALL
                                                      Manager
                                                      resource
                                                      file

                       DECW$TERMINAL.DAT              DECterm      ALL
                                                      terminal
                                                      emulator
                                                      file

                       DECW$TERMINAL.UID              DECterm      ALL
                                                      terminal
                                                      emulator
                                                      file

                       DECW$UIL_DXM_MOTIF.WMD         UIL support  PROG
                                                      file

                       DECW$UIL_DXM_MOTIF.WML         UIL support  PROG
                                                      file

                       DECW$UIL_OSF_MOTIF_1_1.WMD     UIL support  PROG
                                                      file

                       DECW$UIL_OSF_MOTIF_1_1.WML     UIL support  PROG
                                                      file

                                                (continued on next page)







                           VMS DECwindows Motif Software Components C-67

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    DECW$WINMGR.DAT                XUI window   ALL
                                                   manager
                                                   resource
                                                   file

                    DECW$WINMGR.UID                Window       ALL
                                                   manager
                                                   user
                                                   interface
                                                   data file

                    DECW$WSCUST.UID                Workstation  ALL
                                                   customiza-
                                                   tion user
                                                   interface
                                                   data file

                    DECW$WSINIT.UID                Workstation  ALL
                                                   initializa-
                                                   tion user
                                                   interface
                                                   data file

                    LWK$DXM.UID                    Linkworks    ALL
                                                   user
                                                   interface
                                                   data file

                    LWK_REG_BOOKREADER.UID         Linkworks    ALL
                                                   user
                                                   interface
                                                   data file

                                             (continued on next page)






     C-68 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       LWK_REG_DWCALENDAR.UID         Linkworks    ALL
                                                      user
                                                      interface
                                                      data file

                       LWK_REG_DWCF.UID               Linkworks    ALL
                                                      user
                                                      interface
                                                      data file

                       LWK_REG_DWMDRAWER.UID          Linkworks    ALL
                                                      user
                                                      interface
                                                      data file

                       LWK_REG_DWMFOLDER.UID          Linkworks    ALL
                                                      user
                                                      interface
                                                      data file

                       LWK_REG_DWMMESSAGE.UID         Linkworks    ALL
                                                      user
                                                      interface
                                                      data file

                       VUE$MASTER.UID                 FileView     ALL
                                                      user
                                                      interface
                                                      data file

                       VUE$SYSTEM_PROFILE.VUE$DAT     FileView     ALL
                                                      profile
                                                      file

                                                (continued on next page)





                           VMS DECwindows Motif Software Components C-69

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    XNL*.UID                       Language     ALL
                                                   switching
                                                   user
                                                   interface
                                                   data file


     DECW$CBI_      DECW*.CBI                      Computer     ALL
     SUPPORT:                                      based
                                                   instruction
                                                   support
                                                   files

                    DECW*.DAT                      Computer     ALL
                                                   based
                                                   instruction
                                                   support
                                                   file

                    DECWCBI.DATA                   Computer     ALL
                                                   based
                                                   instruction
                                                   support
                                                   file

     XDPS$EXAMPLES: ACTIONPRCS.H                   DPS demo     PROG
                                                   support
                                                   file

                    ACTIONS.C                      DPS demo     PROG
                                                   source file


                                             (continued on next page)






     C-70 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       ACTIONS.H                      DPS demo     PROG
                                                      support
                                                      file

                       BIGICON.BIT                    DPS demo     PROG
                                                      support
                                                      file

                       BUILD_PSDRAW.COM               DPS demo     PROG
                                                      build file

                       BUTTON.C                       DPS demo     PROG
                                                      source file

                       BUTTON.H                       DPS demo     PROG
                                                      support
                                                      file

                       BUTTONP.H                      DPS demo     PROG
                                                      support
                                                      file

                       COLOR.C                        DPS demo     PROG
                                                      source file

                       COLOR.H                        DPS demo     PROG
                                                      support
                                                      file

                       COORDS.C                       DPS demo     PROG
                                                      source file

                       COORDS.H                       DPS demo     PROG
                                                      support
                                                      file

                                                (continued on next page)



                           VMS DECwindows Motif Software Components C-71

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    COORDSP.H                      DPS demo     PROG
                                                   support
                                                   file

                    DRAWING.C                      DPS demo     PROG
                                                   source file

                    DRAWING.H                      DPS demo     PROG
                                                   support
                                                   file

                    DRAWINGP.H                     DPS demo     PROG
                                                   support
                                                   file

                    KNOBS.C                        DPS demo     PROG
                                                   source file

                    KNOBS.H                        DPS demo     PROG
                                                   support
                                                   file

                    KNOBSP.H                       DPS demo     PROG
                                                   support
                                                   file

                    MENUS.C                        DPS demo     PROG
                                                   source file

                    MENUS.H                        DPS demo     PROG
                                                   support
                                                   file

                    MODE.C                         DPS demo     PROG
                                                   source file

                                             (continued on next page)



     C-72 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       MODE.H                         DPS demo     PROG
                                                      support
                                                      file

                       MODEP.H                        DPS demo     PROG
                                                      support
                                                      file

                       M_PI.H                         DPS demo     PROG
                                                      support
                                                      file

                       OPS.C                          DPS demo     PROG
                                                      source file

                       PANE.C                         DPS demo     PROG
                                                      source file

                       PANE.H                         DPS demo     PROG
                                                      support
                                                      file

                       PANEP.H                        DPS demo     PROG
                                                      support
                                                      file

                       PIXMGR.C                       DPS demo     PROG
                                                      source file

                       PIXMGR.H                       DPS demo     PROG
                                                      support
                                                      file

                       POPUP.C                        DPS demo     PROG
                                                      source file

                                                (continued on next page)



                           VMS DECwindows Motif Software Components C-73

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    POPUP.H                        DPS demo     PROG
                                                   support
                                                   file

                    PROP.C                         DPS demo     PROG
                                                   source file

                    PROP.H                         DPS demo     PROG
                                                   support
                                                   file

                    PROPP.H                        DPS demo     PROG
                                                   support
                                                   file

                    PSDRAW.C                       DPS demo     PROG
                                                   source file

                    PSDRAW.COM                     DPS demo     PROG
                                                   build
                                                   command
                                                   file

                    PSDRAW.DAT                     DPS demo     PROG
                                                   support
                                                   file

                    PSDRAW.EXE                     DPS demo     PROG
                                                   program
                                                   image

                    PSDRAW.H                       DPS demo     PROG
                                                   support
                                                   file

                                             (continued on next page)




     C-74 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       PSDRAW_README.PS               DPS demo     PROG
                                                      documen-
                                                      tation
                                                      file

                       PSDRAWCOMPLIB.DAT              DPS demo     PROG
                                                      support
                                                      file

                       PSDRAWKINDS.DAT                DPS demo     PROG
                                                      support
                                                      file

                       PSWINDOW.C                     DPS demo     PROG
                                                      source file

                       PSWINDOW.H                     DPS demo     PROG
                                                      support
                                                      file

                       PSWINDOWP.H                    DPS demo     PROG
                                                      support
                                                      file

                       PSWINDW.C                      DPS demo     PROG
                                                      source file

                       PSWINDW.H                      DPS demo     PROG
                                                      support
                                                      file

                       PSWINDW.PSW                    DPS demo     PROG
                                                      support
                                                      file

                                                (continued on next page)




                           VMS DECwindows Motif Software Components C-75

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    RECT.C                         DPS demo     PROG
                                                   source file

                    RECT.H                         DPS demo     PROG
                                                   support
                                                   file

                    RECTP.H                        DPS demo     PROG
                                                   support
                                                   file

                    ROUND.C                        DPS demo     PROG
                                                   source file

                    SCRN.C                         DPS demo     PROG
                                                   source file

                    SCRN.H                         DPS demo     PROG
                                                   support
                                                   file

                    SCRNP.H                        DPS demo     PROG
                                                   support
                                                   file

                    SCROLLW.C                      DPS demo     PROG
                                                   source file

                    SCROLLW.H                      DPS demo     PROG
                                                   support
                                                   file

                    SCROLLWP.H                     DPS demo     PROG
                                                   support
                                                   file

                                             (continued on next page)



     C-76 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       SMALLICON.BIT                  DPS demo     PROG
                                                      support
                                                      file

                       STRING.H                       DPS demo     PROG
                                                      support
                                                      file

                       UTIL.C                         DPS demo     PROG
                                                      source file

                       UTIL.H                         DPS demo     PROG
                                                      support
                                                      file

                       VALUE.C                        DPS demo     PROG
                                                      source file

                       VALUE.H                        DPS demo     PROG
                                                      support
                                                      file

                       VALUEP.H                       DPS demo     PROG
                                                      support
                                                      file

                       WIDGET.C                       DPS demo     PROG
                                                      source file

                       WIDGET.H                       DPS demo     PROG
                                                      support
                                                      file

                       WIDGETINFO.C                   DPS demo     PROG
                                                      source file

                                                (continued on next page)



                           VMS DECwindows Motif Software Components C-77

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    WIDGETINFO.H                   DPS demo     PROG
                                                   support
                                                   file

                    WRAPS.C                        DPS demo     PROG
                                                   source file

                    WRAPS.PSW                      DPS demo     PROG
                                                   support
                                                   file

                    XMAPRGBTOPIXEL.C               DPS demo     PROG
                                                   source file

                    WRAPS.H                        DPS demo     PROG
                                                   support
                                                   file

     XDPS$INCLUDE:  DPSCLIENT.H                    Display      PROG
                                                   Postscript
                                                   C language
                                                   include
                                                   file

                    DPSCUSTOMOPS.H                 Display      PROG
                                                   Postscript
                                                   C language
                                                   include
                                                   file

                    DPSEXCEPT.H                    Display      PROG
                                                   Postscript
                                                   C language
                                                   include
                                                   file

                                             (continued on next page)



     C-78 VMS DECwindows Motif Software Components

 






        Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                   Component
        Directory______File___________________________Purpose______Class

                       DPSFRIENDS.H                   Display      PROG
                                                      Postscript
                                                      C language
                                                      include
                                                      file

                       DPSOPS.H                       Display      PROG
                                                      Postscript
                                                      C language
                                                      include
                                                      file

                       DPSXCLIENT.H                   Display      PROG
                                                      Postscript
                                                      C language
                                                      include
                                                      file

                       PSCUSTOMOPS.H                  Display      PROG
                                                      Postscript
                                                      C language
                                                      include
                                                      file

                       PSOPS.H                        Display      PROG
                                                      Postscript
                                                      C language
                                                      include
                                                      file

                       XDPLIB.H                       Display      PROG
                                                      Postscript
                                                      C language
                                                      include
                                                      file

                                                (continued on next page)



                           VMS DECwindows Motif Software Components C-79

 






     Table_C-1_(Cont.)_VMS_DECwindows_Motif_Software_Components______

                                                                Component
     Directory______File___________________________Purpose______Class

                    XDPS.H                         Display      PROG
                                                   Postscript
                                                   C language
                                                   include
     ______________________________________________file______________



































     C-80 VMS DECwindows Motif Software Components

 













     ________________________________________________________________

                                                                Index



     A__________________________          B__________________________

     Ada                                  Back up
       compiling source files,             of system disk, 1-12, 2-4
         3-14                             Blocks
       programming interfaces,             determining number of
         3-14                                 free, 1-3
     Adding VMS DECwindows Motif          Booting VMS DECwindows
        files, 5-7                          Motif, 4-1
     Alternate working device
       as installation option,            C__________________________
         1-5                              CLUSTER_CONFIG command
       setting up directory, 1-5            file, 1-8
       specifying for                     Components
         installation, 1-5,                table of software, C-1
         2-11                             Console
     Alternative console, 4-4              alternative, 4-4
     AUTOGEN                               main, 4-4
       checking feedback data              prompt, 4-1
         before installation,
         1-13                             D
       invoked by installation,           ___________________________
         2-15                             DECW$MOTIF_TAILOR
     AWD                                   overview of, 5-1
       see alternate working               using to remove files
         device                               from a system disk, 5-4
                                          DECwindows

                                           See VMS DECwindows Motif
                                          Device name
                                           specifying for
                                              installation, 1-3
                                          Device support
                                           installing, 2-6

                                                              Index-1

 






     DFS-mounted disk                     Installing VMS DECwindows
       determining free disk                Motif (Cont.)
         space, 1-6                        required limits and
     Disk space, 1-3                          quotas, 1-8
       on DFS-mounted AWD, 1-6             required system parameter
     Distributed File Service                 settings, 1-9
       using for AWD, 1-6                  starting the installation

     E                                        , 2-2
     ___________________________          IVP
     Error recovery, 2-17                  see Installation

                                              Verification Procedure
     F__________________________

     Fonts                                K__________________________

       deleted by installation            Keyboard layout, 3-2
         procedure, 1-12                   customizing, 3-3
       installation                       Keyboard model number, 3-3
         consideration, 1-12              Keymap names
       installing 100 dpi, 2-7             determining, 3-3
       installing 75 dpi, 2-7              list of, 3-3
       retaining existing, 1-12           Kit
                                           installing parts of, 2-6
     H__________________________           installing programming
     Hardware                                 environment, 2-6
       supported by VMS                    installing workstation
         DECwindows Motif, 1-1                device support, 2-6
                                           loading distribution
     I                                        media, 2-2
     ___________________________
     Installation                         L__________________________
       sample, A-1                        Languages
     Installation Verification             installing, 2-9
        Procedure                         License registration
       notification during                 using the License
         product installation,                Management Facility,
         2-15                                 1-2
       running after starting
         VMS DECwindows Motif,            M
         4-3                              ___________________________
       sample, B-1                        Main console, 4-4
     Installing VMS DECwindows            Monitor
        Motif, 2-1                         100 dpi, 3-2
       privileges needed, 1-2             Monochrome workstation, 3-3

     Index-2

 







        N__________________________         R__________________________

        NISCS_CONV_BOOT SYSGEN              Release notes
          parameter                           accessing, 2-2, 2-5, 2-17
         setting, 4-2                         displaying, 2-5, 2-17
        North American keyboard               printing, 2-5, 2-17

          layout, 3-2
                                            S__________________________

        O__________________________         Sample Installation

        Operator window, 4-4                   Verification Procedure,
                                               B-1
        P__________________________         Sample VMS DECwindows Motif
        PEX Support                            installation, A-1
         installing, 2-8                    Save sets, C-1
        Post installation problems          Server startup
         determining and reporting            customizing, 3-1
            , 5-8                           Shutting down DECnet, 1-11
        Post installation tasks             Software components, C-1
         customizing VMS                    Standalone system
            DECwindows Motif, 3-1             memory, 1-7
        Print Dialog Box                    Starting VMS DECwindows
         logical names, 3-13                   Motif, 4-1
        Print formats                       SYSGEN parameters
         defining for VMS                     reset by AUTOGEN, 2-15
            DECwindows Motif, 3-13            setting NISCS_CONV_BOOT,
        Print queues, 3-13                       4-2
        Product name                          setting WINDOW_SYSTEM,
         specifying for                          4-1
            installation, 1-3               SYSTEM account, 2-2
        Programming environment               performing the
         installing, 2-6, 2-9                    installation from,
                                                 1-8
        Q                                     required limits and
        ___________________________              quotas, 1-8
        Quotas                              System disk
         setting for VMS                      adding VMS DECwindows
            DECwindows Motif, 1-8                Motif files, 5-7

                                              backing up, 2-4
                                              free space required for
                                                 installation, 1-3, 2-11
                                              using DECW$MOTIF_TAILOR
                                                 to customize, 5-4
                                            System shutdown, 4-1

                                                                 Index-3

 






     System shutdown (Cont.)              VMS/ULTRIX Connection
       notifying users, 1-11                software (UCX)
     System tuning, 5-1                    function, 3-9

     ___________________________          W__________________________

     TCP/IP software                      Window
       adding support for, 3-10            operator, 4-4
       using with VMS DECwindows          WINDOW_SYSTEM SYSGEN
         Motif, 3-9                         parameter
     Transports                            setting, 4-1
       support for TCP/IP, 3-9            Workstation
       using customer-written,             customizing, 3-3
         3-11                              installing device support
       using the example                      , 2-6, 2-8
         transport, 3-12                   installing kit on, 2-7
                                           memory, 1-7

     U__________________________

     UCX
       installing, 3-9
       starting, 3-10

     V__________________________

     VMS DECwindows Motif
       booting, 4-1
       compiling Ada software,
         3-14
       components, C-1
       installation procedure
         requirement, 1-6
       preparing to install, 1-1
       prerequisite software for
         installation, 1-2
       starting, 4-1
       tuning system after
         installation, 5-1
     VMS DECwindows server
       customizing the startup,
         3-1
     VMSINSTAL procedure, 2-2
       starting, 2-2
       using alternate working
         directory, 2-3
     VMSINSTAL requirements, 1-7

     Index-4
