______________________________________________ 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. 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)? 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)? 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)? 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] Do you have your Product Authorization Key? [YES] 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] Authorization Number []LAB030419 PRODUCT ID: Product Name []DW-MOTIF Producer [DEC] NUMBER OF UNITS: Number of Units []400 KEY LEVEL: Version [] PRODUCT RELEASE DATE: []1-Jul-1991 KEY TERMINATION DATE: Key Termination Date [] RATING: Availability Table Code []f Activity Table Code [] MISCELLANEOUS: Key Options [] Product Token [] Hardware-Id [] 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] Registering DW-MOTIF license in SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB... Do you want to LOAD this license on this system? [YES] %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]? (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]? 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]? * VAX BASIC [N]? * VAX BLISS [N]? * VAX C [N]? YES * VAX FORTRAN [N]? * VAX MACRO [N]? * VAX Pascal [N]? * VAX PL/1 [N]? * 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