                           H                     DIGITAL_GKS_________________________________________.                     Installing DIGITAL GKS for)                     OpenVMS Alpha Systems   -                     Order Number: AA-PVT9J-TE                          April 1997  F                     This document contains instructions for installingF                     DIGITAL GKS[TM] (formerly DEC GKS[TM]) software onD                     Alpha architecture running the OpenVMS[TM] AlphaF                     operating system. It also explains how to read theH                     online release notes before or after installing thisI                     product. This document applies to DIGITAL GKS Version                      6.5.              E                     Revision/Update Information:  This revised manual @                                                   supersedes theD                                                   Installing DigitalG                                                   GKS for OpenVMS Alpha H                                                   Systems (Order Number:?                                                   AA-PVT9H-TE).   ?                     Operating System and Version: OpenVMS Alpha G                                                   Version 6.1 or higher I                                                   DECwindows[TM] Motif[R] I                                                   Version 1.2 for OpenVMS 7                                                   Alpha   I                     Software Version:             DIGITAL GKS Version 6.5   1                     Digital Equipment Corporation *                     Maynard, Massachusetts                 J           ________________________________________________________________&           First Printing, January 1993           Revised, August 1993           Revised, April 1994             Revised, November 1994           Revised, July 1995           Revised, October 1995            Revised, January 1996            Revised, July 1996           Revised, April 1997   @           Digital Equipment Corporation makes no representationsA           that the use of its products in the manner described in B           this publication will not infringe on existing or futureB           patent rights, nor do the descriptions contained in thisB           publication imply the granting of licenses to make, use,>           or sell equipment or software in accordance with the           description.  B           Possession, use, or copying of the software described inA           this publication is authorized only pursuant to a valid D           written license from Digital or an authorized sublicensor.  A            Digital Equipment Corporation 1993, 1994, 1995, 1996, $           1997. All Rights Reserved.  ;           The following are trademarks of Digital Equipment =           Corporation: DDIF, DEC, DEC GKS, DEC PHIGS, DECnet, B           DECwindows, DIGITAL, DIGITAL GKS, OpenVMS, VAX, VMS, and           the DIGITAL logo.   3           The following are third-party trademarks:   :           Motif is a registered trademark of Open Software           Foundation, Inc.  @           PostScript is a registered trademark of Adobe Systems,           Incorporated.   E                                                                ZK6201   /           This document is available on CD-ROM.   D           This document was prepared using VAX DOCUMENT Version 2.1.                                 C   _________________________________________________________________   C                                                            Contents       C   Preface...................................................      v   +   1  Preparing for DIGITAL GKS Installation   C         1.1   Prerequisite Software.........................    1-1 C         1.2   Online Release Notes..........................    1-2 C         1.3   Media Distribution Kit........................    1-2 C         1.4   License Registration..........................    1-3 C         1.5   Installation Procedure Requirements...........    1-3 C         1.5.1     Privileges................................    1-4 C         1.5.2     Disk Space................................    1-4 <         1.5.3     Global Pagelets and Global Sections SystemC                   Parameters................................    1-5 7         1.5.3.1     Determining the Global Pagelets and C                     Global Sections Available...............    1-6 7         1.5.3.2     Determining the Global Pagelets and C                     Global Sections Used....................    1-7 1         1.5.3.3     Modifying the Global Pagelets C                     Parameter...............................    1-7 1         1.5.3.4     Modifying the Global Sections C                     Parameter...............................    1-8 9         1.5.3.5     Recalculating the Global Pagelets and C                     Global Sections Parameters..............    1-8 C         1.5.4     Other System Parameters...................    1-9 C         1.5.5     User Account Quotas.......................    1-9 C         1.6   Backing Up Your System Disk...................   1-10                 C                                                                 iii                         2  Installing DIGITAL GKS   E           2.1   The Installation Procedure....................    2-1 E           2.2   Error Recovery................................   2-13   #     3  After Installing DIGITAL GKS   :           3.1   Installing DIGITAL GKS on an OpenVMS AlphaE                 Cluster.......................................    3-1 E           3.2   Editing the Startup File......................    3-2 5           3.3   Running the Installation Verification E                 Procedure.....................................    3-3 E           3.4   Determining and Reporting Problems............    3-3   %     A  Files Installed on Your System   E           A.1   DIGITAL GKS Development Kit Files.............    A-1 E           A.2   DIGITAL GKS Run-Time-Only Kit Files...........   A-15        B  Sample Installations   E           B.1   DIGITAL GKS Development Kit Installation......    B-1 E           B.2   DIGITAL GKS Run-Time-Only Kit Installation....    B-4        Figures   E           2-1       Sample IVP Display........................   2-11   
     Tables  E           1         Conventions Used in this Guide............     vi   E           1-1       Disk Space Requirements...................    1-4   5           1-2       Minimum Required System Parameter E                     Values....................................    1-5   5           1-3       Process Quotas for the Installing E                     Account...................................    1-9   7           A-1       Installed Files for the DIGITAL GKS E                     Development Kit...........................    A-1   7           A-2       Installed Files for the DIGITAL GKS E                     Run-Time-Only Kit.........................   A-15        iv                             I         _________________________________________________________________   I                                                                   Preface       H               This document describes how to install DIGITAL GKS VersionI               6.5 on Alpha processors running the OpenVMS Alpha operating D               system. Because this installation guide is not usuallyG               revised for software maintenance updates, you should read I               the Read Before Installing or Using DIGITAL GKS for OpenVMS C               Alpha Systems letter for a summary of the significant 4               changes to the installation procedure.  E               Keep this document with your distribution kit. You will D               need it to install maintenance updates or to reinstall/               DIGITAL GKS for any other reason.   G               If you have any comments about this document, please send C               electronic mail to the "requests@bgsdev.enet.dec.com" D               account. Your comments will be considered for the next1               revision of the installation guide.            Intended Audience   G               This manual is for system managers installing DIGITAL GKS '               on OpenVMS Alpha systems.   "         Structure of this Document  2               This manual is organized as follows:  F               o  Chapter 1 describes the operating system requirementsF                  for DIGITAL GKS installation, and the procedures thatC                  you should complete before installing DIGITAL GKS.   I               o  Chapter 2 provides the step-by-step instructions for the                   installation.  E               o  Chapter 3 describes the operations you perform after                   installation.  I                                                                         v                    C           o  Appendix A lists the files installed with DIGITAL GKS.   E           o  Appendix B provides sample logs from development kit and -              run-time-only kit installations.   0     Manuals in the DIGITAL GKS Documentation Set  C           In addition to this manual, the DIGITAL GKS documentation -           set includes the following manuals:   !           o  DEC GKS User's Guide   2           o  DEC GKS GKS$ Binding Reference Manual  4           o  DEC GKS GKS3D$ Binding Reference Manual  /           o  DEC GKS C Binding Reference Manual   5           o  DEC GKS FORTRAN Binding Reference Manual   B           o  Device Specifics Reference Manual for DEC GKS and DEC              PHIGS       Related Manuals   ?           For information on OpenVMS system management, see the            following manuals:  ,           o  OpenVMS System Manager's Manual  .           o  Guide to Maintaining a VMS System  6           o  OpenVMS License Management Utility Manual  4           o  Guide to OpenVMS Performance Management  #     Conventions Used in This Manual   C           The conventions used in this guide are listed in Table 1.   E           Table_1_Conventions_Used_in_this_Guide_____________________   ?           UPPERCASE TEXT         Uppercase letters indicate the D                                  name of a command, file, parameter,7                                  procedure, or utility.   E                                              (continued on next page)        vi                   I               Table_1_(Cont.)_Conventions_Used_in_this_Guide_____________   I               Bold                   Boldface text is used in interactive D                                      examples to indicate typed user+                                      input.   H               $                      The dollar sign is used to indicateG                                      the DCL prompt. This prompt may be >                                      different on your system.  I               system output          This typeface is used in interactive I                                      and code examples to indicate system F                                      output. In text, this typeface isG                                      used to indicate the exact name of G                                      a command, option, partition, path >                                      name, directory, or file.  F               [logical-name]         Square brackets indicate that theG                                      enclosed item is optional. (Square H                                      brackets are not, however, optionalF                                      in the syntax of a directory nameF                                      in a file specification or in theH                                      syntax of a substring specificationA                                      in an assignment statement.)   F               <Ctrl/X>               In procedures, a sequence such asE                                      <Ctrl/X> indicates that you must I                                      hold down the key labeled Ctrl while H                                      you press another key or a pointing3                                      device button.   G               <Return>               In procedures, a key name is shown H                                      enclosed to indicate that you press;                                      a key on the keyboard.   D                                      Vertical ellipsis in an exampleH                   .                  means that information not directlyD                   .                  related to the example has been-                   .                  omitted.   G               VMS[TM]                The terms VMS and OpenVMS refer to ?               OpenVMS[TM]            the same operating system.   H               DIGITAL GKS            References to DIGITAL GKS refers toG                                      the DIGITAL GKS (formerly DEC GKS) I               _______________________product.____________________________   I                                                                       vii                          I                                                                         1 I         _________________________________________________________________   I                                    Preparing for DIGITAL GKS Installation     F               This chapter describes the preparations and requirements?               necessary for installing DIGITAL GKS Version 6.5.   A               This chapter will help you determine the following:   I               o  Whether the system on which you will install DIGITAL GKS 8                  has the prerequisite software installed  5               o  How to read the online release notes   C               o  If installing DIGITAL GKS from media, whether your D                  distribution kit includes all the components listed/                  on the Bill of Materials (BOM)   3               o  How to register a software license   D               o  The privileges required to perform the installation  2               o  How much disk space you will need  H               o  Whether the global pagelets and sections parameters are!                  defined properly   I               o  Whether the process account quotas are defined correctly   0               o  How to back up your system disk  !         1.1 Prerequisite Software   F               To install DIGITAL GKS on an Alpha workstation, you must4               have the following products installed:  E               o  OpenVMS Alpha operating system Version 6.1 or higher   I               o  DECwindows Motif Version 1.2 or higher for OpenVMS Alpha E                  (if you are installing DIGITAL GKS on a workstation)   C               DIGITAL GKS also requires the following OpenVMS Alpha -               classes for full functionality:   0               o  OpenVMS Alpha required save set  I                                Preparing for DIGITAL GKS Installation 1-1            *     Preparing for DIGITAL GKS Installation     1.1 Prerequisite Software     :           o  Network support-where full DECwindows network'              functionality is necessary   <           o  Programming support-required by the DIGITAL GKS              development kit  C           o  OpenVMS Alpha class for workstation support-if you are /              using DIGITAL GKS on a workstation        1.2 Online Release Notes  E           DIGITAL GKS provides online release notes. DIGITAL strongly A           recommends that you read the release notes before using A           DIGITAL GKS, because they may contain information about            product changes.  B           During installation, you can access release notes in theC           installation procedure when you invoke VMSINSTAL with the E           OPTIONS N parameter. This option lets you read or print the 6           release notes before installing DIGITAL GKS.  D           After installation, you can obtain the DIGITAL GKS release0           notes by printing the following files:  ?           o  SYS$HELP:DECAXPGKS065.RELEASE_NOTES (ASCII format)   B           o  SYS$HELP:DECAXPGKS065_RELEASE_NOTES.PS (PostScript[R]              format)       1.3 Media Distribution Kit  @           Your bill of materials (BOM) and indented bills report>           (BIL) specify the number and contents of your media.@           Be sure to check the contents of your kit against this<           information. If your kit is damaged or if you find<           that parts of it are missing, contact your DIGITAL>           representative. For more information on how to mount9           distribution media, see your processor-specificdC           installation/operations guide, which also details severall1           options for the installation procedure.t          .     1-2 Preparing for DIGITAL GKS Installation           I                                    Preparing for DIGITAL GKS Installation I                                                  1.4 License Registration               1.4 License Registration  E               Before you install and run DIGITAL GKS Version 6.5 on a E               newly licensed node or cluster, you must first registeryE               a License Product Authorization Key (License PAK) using G               the License Management Facility (LMF). The PAK is a paperME               certificate that contains information about the license F               that enables you to use the software. The License PAK isG               shipped with the kit if you ordered the license and media E               together; otherwise, the PAK is shipped separately to ah7               location specified on your license order.I  A               If you are installing DIGITAL GKS as an update on arA               node or cluster already licensed for this software, E               you have already completed the License PAK registration_A               requirements. If you are installing prerequisite orAB               optional software along with DIGITAL GKS, review theF               PAK status and install the PAKs for this prerequisite or?               optional software before you install DIGITAL GKS.   E               To register a license under the OpenVMS Alpha operating C               system, first log in to the system manager's account,hE               SYSTEM. You can then register the license in one of two                ways:   H               o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When itH                  prompts you for information, respond with the data from"                  your License PAK.  G               o  Enter the LICENSE REGISTER command with the qualifiers >                  corresponding to the License PAK information.  E               If you plan to use DIGITAL GKS on more than one node inoC               an OpenVMS Alpha cluster configuration, you will needtD               to perform a license load on the other nodes after youF               complete this installation. See Section 3.1 for details.  D               For complete information on using LMF, see the OpenVMS0               License Management Utility Manual.  /         1.5 Installation Procedure Requirementsw  F               The following sections describe the various requirements@               for installing DIGITAL GKS. The installation takesE               approximately 5 to 30 minutes, depending on your systemt               configuration.  I                                Preparing for DIGITAL GKS Installation 1-3s a  b      *     Preparing for DIGITAL GKS Installation+     1.5 Installation Procedure Requirements          1.5.1 Privileges  E           To install DIGITAL GKS, you must be logged in to an account B           that has the SETPRV privilege, or at least the following           privileges:.             o  CMKRNL.             o  WORLD             o  SYSPRVg  =           When you invoke VMSINSTAL to begin the installationw>           procedure, VMSINSTAL turns off the BYPASS privilege.  B           After installation, each user account must have at leastB           the TMPMBX and NETMBX privileges to use DIGITAL GKS. UseB           the OpenVMS Authorize Utility to determine whether users+           have the privileges they require.        1.5.2 Disk Space  >           The DIGITAL GKS requirements for free disk space are?           different during installation and after installation. 2           Table 1-1 summarizes these requirements.  E           Table_1-1_Disk_Space_Requirements__________________________   B                                      Blocks During    Blocks AfterE           Kit________________________Installation_____Installation___e  <           DIGITAL GKS Development    46,000           45,000
           Kit.  <           DIGITAL GKS Development    51,000           50,000            Kit with Japanese save
           set.  <           DIGITAL GKS Run-Time-Only  25,000           24,000
           Kiti  <           DIGITAL GKS Run-Time-Only  29,000           28,000            Kit with Japanese saveE           set________________________________________________________n  ?           To determine the number of free blocks on the currentPE           system disk, enter the following command at the DCL prompt:o  .     1-4 Preparing for DIGITAL GKS Installation k         I                                    Preparing for DIGITAL GKS Installation I                                   1.5 Installation Procedure Requirements     2               $ SHOW DEVICE SYS$SYSDEVICE <Return>  G                 _______________________ Caution _______________________e  B                 You must ensure that your system has the necessaryA                 global pagelet (512-byte subpage unit) and globalSF                 section SYSGEN quotas for the installation. Otherwise,>                 the DCL tables may become corrupted in certain                 situations.   F                 ______________________________________________________  C         1.5.3 Global Pagelets and Global Sections System Parameters   E               The installation of DIGITAL GKS requires minimum valuesSD               for the system parameters defining the global pageletsG               and global sections. These values are shown in Table 1-2..I               Depending on the kinds of programs and applications runningeA               at your site, you may need to define larger values.   I               Table_1-2_Minimum_Required_System_Parameter_Values_________   I               System_Parameter___________Minimum_Value___________________   1               GBLPAGES[1]                n + 4000.  /               GBLSECTIONS[1]             n + 30e  I               [1]The_n_variable_refers_to_the_system_parameter_values____eD               that are currently in use. To install DIGITAL GKS, youF               must increase those values by the number indicated. (See               Section 1.5.3.1.).H               These dynamic system parameters must be set permanently toG               values equal to or greater than the values listed. Do not.9               reduce these values after the installation.eI               ___________________________________________________________.  5               The following sections describe how to:   C               o  Determine the number of global pagelets and global_#                  sections available   G               o  Determine the global pagelets and global sections usedc  5               o  Modify the global pagelets parameter   5               o  Modify the global sections parameter   I                                Preparing for DIGITAL GKS Installation 1-5l           *     Preparing for DIGITAL GKS Installation+     1.5 Installation Procedure Requirementsf    @           o  Recalculate the global pagelets and global sections;              parameters to take the new values into account   ?     1.5.3.1 Determining the Global Pagelets and Global Sections              Availabler  D           You can determine the available global pagelets and globalD           sections using the WRITE command with the F$GETSYI lexicalC           function. The following example shows how to display thiseD           information on your terminal (the default for SYS$OUTPUT):  ?           $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") <Return>            15848 ?           $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") <Return>d           24  D           If the values displayed by the system are greater than theE           values in Table 1-2, you do not need to increase the valuesuD           for these parameters. If the value of free global pageletsA           or global sections is less than the value in Table 1-2, E           you must increase the parameter values, as described in the            following sections.e  >           You can also determine the number of global sections2           available using the following procedure:  '           1. Invoke the SYSGEN Utility:   -              $ RUN SYS$SYSTEM:SYSGEN <Return>f)              SYSGEN> USE CURRENT <Return>   ?           2. Determine the number of global sections available:   .              SYSGEN> SHOW GBLSECTIONS <Return>  N Parameter Name             Current   Default   Minimum   Maximum Unit  DynamicN --------------             -------   -------   -------   ------- ----  -------I GBLSECTIONS                    400       250        20      4095 Sectionsd  @              The first number displayed is the current number ofB              global sections. Compare this number to the number ofD              global sections in use displayed by the OpenVMS Install+              Utility (see Section 1.5.3.2).   *           3. Exit from the SYSGEN Utility:  "              SYSGEN> EXIT <Return>  .     1-6 Preparing for DIGITAL GKS Installation c  e      I                                    Preparing for DIGITAL GKS Installation I                                   1.5 Installation Procedure Requirements     H         1.5.3.2 Determining the Global Pagelets and Global Sections Used  H               To determine the global pagelets and global sections used:  4               1. Invoke the OpenVMS Install Utility:  =                  $ INSTALL :== $INSTALL/COMMAND_MODE <Return> #                  $ INSTALL <Return>g  C               2. Determine the number of global pagelets and globalh                  sections used:   6                  INSTALL> LIST/GLOBAL/SUMMARY <Return>  @                          Summary of Local Memory Global Sections  P                  nn Global Sections Used,  nnnn/nnnn Global Pagelets Used/Unused  '                  INSTALL> EXIT <Return>n  F                  The system displays a summary of the number of globalG                  sections used, the number of global pagelets used, and 9                  the number of global pagelets available.   7               3. Exit from the OpenVMS Install Utility:r  '                  INSTALL> EXIT <Return>t  7         1.5.3.3 Modifying the Global Pagelets Parameteri  6               To modify the number of global pagelets:  H               1. If there are fewer than 4000 global pagelets available,6                  modify the GBLPAGES system parameter.  E                  You can modify the GBLPAGES parameter by editing the E                  SYS$SYSTEM:MODPARAMS.DAT file. To change a parameter F                  value in this file, delete the current value and typeG                  in a new value. (Another way of allocating space is to H                  delete an existing known image with the OpenVMS Install                  Utility.)  G                  To modify GBLPAGES, use ADD_GBLPAGES as shown, where n 9                  is the number of global pagelets to add:m  !                  ADD_GBLPAGES = n   F                 ________________________ Note ________________________  C                 When you set the pagelet file quota, you should not C                 use a value that exceeds the amount of pagelet file   I                                Preparing for DIGITAL GKS Installation 1-7            *     Preparing for DIGITAL GKS Installation+     1.5 Installation Procedure Requirementss    +              space available on the system.   C              ______________________________________________________              2. Exit the editor.d  B           3. Update the GBLPAGES parameter by invoking the AUTOGEN<              command procedure described in Section 1.5.3.5.  3     1.5.3.4 Modifying the Global Sections Parameterc  2           To modify the number of global sections:  D           1. If the number of global sections in use plus 30 exceeds>              the current number of global sections, modify the#              GBLSECTIONS parameter.n  D              You can modify the GBLSECTIONS parameter by editing theA              SYS$SYSTEM:MODPARAMS.DAT file. To change a parametermE              value in this file, delete the current value and type in               a new value.   A              To modify GBLSECTIONS, use ADD_GBLSECTIONS as shown, =              where n is the number of global sections to add:                  ADD_GBLSECTIONS = n             2. Exit the editor.   E           3. Update the GBLSECTIONS parameter by invoking the AUTOGEN_<              command procedure described in Section 1.5.3.5.  A     1.5.3.5 Recalculating the Global Pagelets and Global Sections              Parameters  C           To update the GBLPAGES and GBLSECTIONS parameters, invoke @           the AUTOGEN command procedure, SYS$UPDATE:AUTOGEN.COM:  7           $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT <Return>i  @           AUTOGEN automatically recalculates the parameters withC           the values you defined manually. When you specify REBOOT, @           AUTOGEN performs an automatic system shutdown and thenC           reboots the system. Any users logged on to the system aret7           immediately disconnected during the shutdown.   ?           AUTOGEN also automatically adjusts some of the SYSGEN A           parameters, based on the consumption of resources sincelB           the last reboot. If you do not want to take advantage ofE           this automatic adjustment, include the NOFEEDBACK qualifieri&           on the AUTOGEN command line.  .     1-8 Preparing for DIGITAL GKS Installation           I                                    Preparing for DIGITAL GKS Installation I                                   1.5 Installation Procedure Requirementsd    G               For more information about using AUTOGEN, see the OpenVMS '               System Management Subkit.   %         1.5.4 Other System Parametersw  I               The installation for DIGITAL GKS requires that you increase I               the values of the CLISYMTBL and CTLPAGES system parameters. G               Once the installation is complete, you can decrease thesea<               values to ensure efficient system performance.  !         1.5.5 User Account Quotas   I               The account you use to install DIGITAL GKS requires certainwF               minimum quota values. These values, which are defined in;               the SYSUAF.DAT file, are listed in Table 1-3.   I               Table_1-3_Process_Quotas_for_the_Installing_Account________   I               Account_Quota______________Value___________________________n  .               ASTLM                         24  .               BIOLM                         18  /               BYTLM                      18,000i  .               DIOLM                         18  .               ENQLM                         30  I               FILLM_________________________20___________________________   B               Using the OpenVMS Authorize Utility (AUTHORIZE), youE               can compare the current values of these quotas with the.C               requirements for DIGITAL GKS. The account used in thet6               following example is the SYSTEM account:  /               $ SET DEFAULT SYS$SYSTEM <Return>n&               $ RUN AUTHORIZE <Return>               UAF>  B               To change the values of these quotas, use the MODIFYC               command. For more information, see the OpenVMS Systeme4               Management Utilities Reference Manual.  I                                Preparing for DIGITAL GKS Installation 1-9L S  l      *     Preparing for DIGITAL GKS Installation#     1.6 Backing Up Your System DiskK    #     1.6 Backing Up Your System Disk   ?           DIGITAL recommends that you back up your system disk, C           before installing any software. Use the backup proceduresb;           that are established at your site. For details onBD           performing a backup, see the section on the Backup Utility2           in the OpenVMS System Management Subkit.                                                                            /     1-10 Preparing for DIGITAL GKS Installation     r                    I                                                                         2sI         _________________________________________________________________e  I                                                    Installing DIGITAL GKS     A               This chapter describes the DIGITAL GKS installation H               procedure and the operations you may need to perform afterG               the installation. For a list of the files and directories.H               created during the installation procedure, see Appendix A.I               For sample development kit and run-time-only installations,u"               refer to Appendix B.  D               To abort the installation procedure at any time, pressG               Ctrl/Y. When you press Ctrl/Y, the installation procedureeC               deletes all files it has created up to that point and ?               exits. You can then start the installation again.   &         2.1 The Installation Procedure  E               Before you install DIGITAL GKS, DIGITAL recommends thatpB               you back up your system disk. Once you have done so,D               you can begin the installation. The installation takesE               approximately 5 to 30 minutes, depending on your systemt               configuration.  F               You should not install DIGITAL GKS run-time-only VersionH               6.5 if you have already installed the full development kitE               of DIGITAL GKS Version 6.5. If you do, the installationaH               procedure will overwrite the development kit with the run-I               time-only kit. To determine which version of DIGITAL GKS ishB               currently installed, type the following DCL command:  Q               $ ANALYZE/IMAGE/INTERACTIVE SYS$COMMON:[SYSLIB]GKS3D$RTLIB <Return>   F               Look for lines similar to the following in the resulting               display:          I                                                Installing DIGITAL GKS 2-1r                Installing DIGITAL GKS"     2.1 The Installation Procedure                                 .                              .g                             ..  +            Image Identification InformationS  %             image name: "GKS3D$RTLIB" 4             image file identification: "DECGKS V6.5"/             image file build identification: ""o3             link date/time: 30-APR-1997 04:20:10.40t+             linker identification: "A11-14"                              .i                             .S                             .e  6           The procedure for installing DIGITAL GKS is:  @           1. Log in to a privileged account and set your default0              device and directory to SYS$UPDATE.  A              DIGITAL recommends that you use the system manager's3              account.   '              Username: SYSTEM  <Return> '              Password:         <Return>g.              $ SET DEFAULT SYS$UPDATE <Return>  9           2. Define the destination for the output of thea?              Installation Verification Procedure (IVP) with the C              following command, replacing node with your node name:   5              $ DEFINE DECW$DISPLAY node::0.0 <Return>i             3. Invoke VMSINSTAL.  @              When you invoke VMSINSTAL, it checks the following:  B              o  Whether you are logged in to a privileged account.E                 You should install software from the system manager'seE                 account with your default device and directory set toM                 SYS$UPDATE.s  4              o  The installing account has adequate:                      Disk space "                    Global pagelets"                    Global sections!                    Account quotass       2-2 Installing DIGITAL GKS i  r      I                                                    Installing DIGITAL GKStI                                            2.1 The Installation Procedure_    F                  o  Whether you have adequate quotas for installation.B                     VMSINSTAL requires the following minimum quota                     values:I  !                        ASTLM = 24 !                        BIOLM = 18 $                        BYTLM = 18000!                        DIOLM = 18h!                        ENQLM = 30 !                        FILLM = 202  >                     See Chapter 1 for details on defining this                      information.  ;                  o  Whether the following conditions exist:_  <                     -  DECnet[TM] network is up and running.  9                     -  Users are logged in to the system.y  I                  If VMSINSTAL detects problems, you will be asked whethernB                  you want to continue the installation. You shouldH                  correct these problems before resuming the installationE                  procedure. If you want to continue, type YES. If you =                  want to stop the installation, press Return._  B                  To invoke the VMSINSTAL command procedure, enter:  T                  $ @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N <Return>  .                  The VMSINSTAL parameters are:                    saveset-namelI                  The installation name for the component. For the DIGITALc3                  GKS development kit, use the name:                     AXPGKS065  E                  For the DIGITAL GKS run-time-only kit, use the name:c                    AXPGKSRT065                    device-nameF                  The name of the device on which you plan to mount theF                  distribution volumes for the DIGITAL GKS installationG                  media. The format of the device name is ddcu, where ddoG                  is the device code, c is the controller code, and u is H                  the unit number. For example, DKA400 is the device name                  for a CD-ROM.  I                                                Installing DIGITAL GKS 2-3_                Installing DIGITAL GKS"     2.1 The Installation Procedure    @              You do not have to use the console drive to installC              DIGITAL GKS. If you do use the console drive after thetC              installation, you should replace any media you removedh6              from the drive prior to the installation.  A              For CD-ROM media, you must also supply the directorytC              location of the DIGITAL GKS save set on the CD-ROM. To C              obtain this location, see the Software Product LibraryhB              Master Index that accompanies the CD-ROM distributionE              kit, or complete the following steps before starting theb              installation:  E              a. Determine whether the CD-ROM drive is already mounteds(                 by entering the command:  .                 $ SHOW DEVICE DKA400: <Return>  C                 If the device is mounted, skip to the next step. If E                 it is not mounted, type the appropriate MOUNT command E                 to mount the CD-ROM, omitting the /FOREIGN qualifier.   B              b. Obtain the directory name by entering the command:  @                 $ DIRECTORY DKA400:[000000]*axpgks*.dir <Return>  B                 The directory name will be displayed; for example:  )                 Directory DKA400:[000000]l  =                 AXPGKS065.DIR;1             (development kit)   ?                 AXPGKSRT065.DIR;1           (run-time-only kit)   E              c. Obtain the save-set name by using a DIRECTORY command ?                 specifying the directory file from the previous E                 command. For example, for the development kit, enter:   >                 $ DIRECTORY DKA400:[AXPGKS065.KIT]*.A <Return>  1                 For the run-time-only kit, enter:E  @                 $ DIRECTORY DKA400:[AXPGKSRT065.KIT]*.A <Return>                OPTIONS NA              An optional parameter that enables you to access then?              release notes. If you do not include the OPTIONS NoD              parameter, VMSINSTAL does not ask you about the release>              notes. You should review the release notes beforeC              proceeding with the installation, because they contain ;              additional information about the installation.        2-4 Installing DIGITAL GKS r  d      I                                                    Installing DIGITAL GKS:I                                            2.1 The Installation Procedure.    I                  Note that there are several other options you can selectO+                  when you invoke VMSINSTAL:   *                  o  Auto_answer option (A)  F                     This option initially creates a file that containsD                     your answers to VMSINSTAL questions and prompts.H                     You can then use the option (and the answer file) toF                     save time during a reinstallation (typically after+                     upgrading your system).i  +                  o  Get save set option (G)   G                     This option lets you temporarily store product savetC                     sets on a magnetic tape or in a disk directory.   '                  o  File log option (L)   H                     This option logs all activity to the terminal during!                     installation.n  -                  o  Alternate root option (R).  H                     This option lets you install the product to a system?                     root other than that of the current system.   =                  If you do not supply the save set and device C                  names, VMSINSTAL prompts you for them later in the D                  installation. VMSINSTAL does not prompt you for anyD                  options, however, so be sure to include the desiredF                  options on the VMSINSTAL command line. If you specifyG                  more than one option, separate the options with commascF                  (for instance, OPTIONS A,N). See the documentation onG                  software installation in the OpenVMS System ManagementoB                  Subkit for detailed information on these options.  C                  The following example invokes VMSINSTAL to installeE                  DIGITAL GKS development kit from a CD-ROM, and showsi%                  the system response:<  M      $ @SYS$UPDATE:VMSINSTAL AXPGKS DKA400:[AXPGKS065.KIT] OPTIONS N <Return>   O                        OpenVMS AXP Software Product Installation Procedure V6.1   ,                  It is 30-APR-1997 at 12:26.@                  Enter a question mark (?) at any time for help.  I                                                Installing DIGITAL GKS 2-5S :  P           Installing DIGITAL GKS"     2.1 The Installation Procedure    9              If VMSINSTAL detects any problems during the B              installation, it notifies you and asks if you want toB              continue the installation. In some instances, you canD              enter YES to continue. To stop the installation processA              and correct the situation, enter NO or press Return.gD              Then, correct the problem and restart the installation.  0           4. Check the status of your processes.  B              VMSINSTAL displays a list of all active processes and;              asks if you wish to continue the installation:f  K              %VMSINSTAL-W-ACTIVE, The following processes are still active:a                 DECW$SERVER_0                  DECW$MWM                 ..                 .e                 . 3              * Do you want to continue anyway [NO]?   @              You can install DIGITAL GKS even if other processes<              are running. If you do not wish to continue the@              installation, press Return. If you wish to continue@              installing DIGITAL GKS, enter YES and press Return.  #           5. Confirm system backup.   K              * Are you satisfied with the backup of your system disk [YES]?l  >              You should always back up your system disk beforeB              performing an installation. If you are satisfied withE              the backup of your system disk, press Return. Otherwise,e@              enter NO and press Return to stop the installation.D              After you back up your system disk, you can restart the              installation.  C              In most cases, the distribution media is a CD-ROM thatnE              has been mounted before the installation. If this is not 9              the case, refer to your media documentation.t             6. Mount the media.B  D              If you omitted the device name on the VMSINSTAL command0              line, the following prompt appears:  N              * Where will the distribution volume be mounted: DKA400: <Return>       2-6 Installing DIGITAL GKS G  E      I                                                    Installing DIGITAL GKSUI                                            2.1 The Installation Procedure     D                  Enter the name of the distribution media device andC                  directory that contains the DIGITAL GKS save sets. C                  For example, if the media is contained on a CD-ROMoG                  located on unit DKA400:, and the DIGITAL GKS save setstD                  are located in the directory AXPGKS065.KIT (for the)                  development kit), enter:   '                  DKA400:[AXPGKS065.KIT]   G                  Depending on the type of device and whether the deviceaI                  is already mounted, the following may or may not appear:f  C                  Please mount the first volume of the set on DKA400I,                  * Are you ready? Y <Return>  F                  If you entered the wrong device name when you invokedF                  VMSINSTAL and need to restart the installation, enterH                  NO in response to the "Are you ready?" question. If youF                  respond YES to indicate that you are ready, VMSINSTALI                  indicates that the media containing DIGITAL GKS has beentG                  mounted, and then prompts for the product name and anys.                  desired installation options:  ,                  DIGITAL GKS DEVELOPMENT KIT  D                  %MOUNT-I-MOUNTED, AXPGKS MOUNTED ON DKA400 (NODE 1)  \                   Enter the products to be processed from the first distribution volume set.1                    * Products: AXPGKS065 <Return>uP                    * Enter installation options you wish to use (none): <Return>  :                  The following products will be processed:                      AXPGKS V6.5  D                      Beginning installation of AXPGKS V6.5 at hh:mm.  E                  %VMSINSTAL-I-RESTORE, Restoring product saveset A...   .                  DIGITAL GKS RUN-TIME-ONLY KIT  F                  %MOUNT-I-MOUNTED, AXPGKSRT MOUNTED ON DKA400 (NODE 1)  \                   Enter the products to be processed from the first distribution volume set.3                    * Products: AXPGKSRT065 <Return>hP                    * Enter installation options you wish to use (none): <Return>  I                                                Installing DIGITAL GKS 2-7S h  c           Installing DIGITAL GKS"     2.1 The Installation Procedure    6              The following products will be processed:                AXPGKSRT V6.5  B                  Beginning installation of AXPGKSRT V6.5 at hh:mm.  A              %VMSINSTAL-I-RESTORE, Restoring product saveset A...o  +           7. Select a release notes option.e  C              This step applies only if you specified OPTIONS N whena'              starting the installation.S  #              Release Notes Options:K  )                  1. Display release notesm'                  2. Print release notesm                   3. Both 1 and 2%                  4. None of the above   ,              * Select option [2]: 1 <Return>  C              If you select option 1, VMSINSTAL displays the releaser?              notes immediately on the console terminal. You canhB              terminate the display at any time by pressing Ctrl/C.  @              If you select option 2, VMSINSTAL prompts you for aE              queue name. Either enter a queue name or press Return to >              send the file to the default output print device:  &              * Queue name [SYS$PRINT]:  C              If you select option 3, VMSINSTAL displays the release C              notes on the terminal and then prompts you for a queue B              name for the printed version. After you enter a queueA              name or press Return to send the file to the defaultmB              output print device, the release notes are copied to:  B              o  SYS$HELP:DECAXPGKS065.RELEASE_NOTES (ASCII format)  B              o  SYS$HELP:DECAXPGKS065_RELEASE_NOTES.PS (PostScript                 format)   @              If you select option 4, VMSINSTAL does not display,.              print, or copy the release notes.  C              ________________________ Note ________________________   ?              The version of the release notes file installed by C              VMSINSTAL is labeled with the current product name and        2-8 Installing DIGITAL GKS           I                                                    Installing DIGITAL GKS I                                            2.1 The Installation Procedurei    C                 version number. Be sure not to delete release notes 5                 for previous versions of DIGITAL GKS.   F                 ______________________________________________________  >                  VMSINSTAL then displays the following prompt:  L                  * Do you want to continue the installation [N]?: Y <Return>\                  %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.  E                  If you selected release notes option 4 and now press C                  Return to stop the installation, the release notes F                  are copied to the SYS$HELP directory. If you selectedI                  release notes option 4 and now enter YES to continue thesG                  installation, the release notes are not copied to this                   directory.I  D                  After the installation, you can enter the followingE                  command to review the release notes through the Help '                  facility, for example:   2                  $ HELP GKS RELEASE_NOTES <Return>  1               8. Purge the old DIGITAL GKS files.   [                  * Do you want to purge files replaced by this installation [YES]? <Return>   G                  The directories SYS$COMMON:[SYSLIB] and SYS$SYSTEM mayfF                  contain previous versions of DIGITAL GKS files. TheseD                  files are replaced during the installation with newG                  files, but the old files are not automatically purged.oC                  Purging is recommended. In response to the purgingDD                  prompt, press Return to purge the files or enter NO                  to keep them.  H                  Appendix A lists the files on the system that are addedI                  or modified when you install the DIGITAL GKS developmentn                  kit.h  9               9. Respond to license registration queries.e  D                  DIGITAL GKS supports the OpenVMS License ManagementD                  Facility (LMF). The installation procedure displaysH                  license information about your product and then asks ifF                  you have registered and loaded your authorization keyE                  for DIGITAL GKS. The following is an example of thisf                  information:e  I                                                Installing DIGITAL GKS 2-9                 Installing DIGITAL GKS"     2.1 The Installation Procedure    (              DIGITAL GKS DEVELOPMENT KIT                Product:      GKS              Producer:     DEC              Version:      6.5&              Release Date: 30-APR-1997  P  * Does this product have an authorization key registered and loaded? Y <Return>  *              DIGITAL GKS RUN-TIME-ONLY KIT  !              Product:      GKS-RT               Producer:     DEC              Version:      6.5&              Release Date: 30-APR-1997  _                 * Does this product have an authorization key registered and loaded? Y <Return>   ;              Your PAK must be registered and loaded for theTA              installation to complete successfully. Therefore, if C              your PAK is not registered and loaded, you must answer E              NO to this question, stop the installation, register ando>              load your PAK, and then restart the installation.  C           10.If installing the development kit, install the example.              programs.  J              * Do you wish to install the example programs [YES]? <Return>  B              The example programs are source code files written inA              various programming languages that illustrate how toeD              call various DIGITAL GKS functions. Press Return if youE              wish to install the example programs; enter NO if you dos0              not wish to install these programs.  4           11.Install the Japanese GKS-related files.  X              * Do you wish to install Japanese related images and files [NO]? Y <Return>  B              If the Japanese version of OpenVMS Alpha is installedE              on your system, you will be asked if you wish to installoD              the Japanese components of DIGITAL GKS. Press Return ifD              you do not want to install the Japanese files. Type YES3              if you do want to install these files.A  9           12.Run the Installation Verification Procedure.T  ]              * Do you wish to perform the Installation Verification Procedure [YES]? <Return>h       2-10 Installing DIGITAL GKS            I                                                    Installing DIGITAL GKS I                                            2.1 The Installation Procedure     G                  The Installation Verification Procedure (IVP) verifies.E                  that the installation is successful. The DIGITAL GKSKD                  IVP reads a three-dimensional image from a metafileD                  workstation (GKS$TEST:GKS$IVP.DAT). The metafile isC                  large, and executing the IVP tests the DIGITAL GKSr)                  installation thoroughly.y  E                  If the installation is successful, the IVP generatesoE                  a picture like the one in Figure 2-1. If your devicesG                  produces color output, the image will appear in color.n  +               Figure 2-1 Sample IVP Displayt  C         See the PostScript(R) or Bookreader[TM] version to view thea         figure.-  F                  The default workstation is defined by the workstationI                  identifier and connection identifier, represented by thetI                  logical names GKS$WSTYPE and GKS$CONID respectively. Theo/                  default workstation types are:R  :                  o  Nonworkstation: PostScript workstation  =                  o  Workstation running Motif software: Motifr                     workstation   G                  You can redirect the IVP output to another workstation I                  by modifying the values associated to the logical names.   C                  Press Return if you wish to run the IVP during theiF                  installation; enter NO if you do not wish to run thisC                  procedure. If you do not run the IVP at this time,vI                  DIGITAL recommends that you run this procedure after theyF                  installation to verify that the software is availableA                  on your system. You may also need to run the IVPeG                  after a system failure to ensure that users can accesst?                  DIGITAL GKS. Refer to Section 3.3 for details.t  1               13.Read the informational messages.t  E                  At this point, the installation procedure displays a D                  number of informational messages that report on theC                  progress of the installation; there are no furtherlB                  questions. If the installation procedure has beenE                  successful up to this point, VMSINSTAL moves the new G                  or modified files to their target directories, updates I                  help files, and updates DCL tables, if necessary. If you   I                                               Installing DIGITAL GKS 2-11                 Installing DIGITAL GKS"     2.1 The Installation Procedure    D              requested that files be purged, they are purged at this              time.  (              The messages displayed are:  )              DIGITAL GKS DEVELOPMENT KIT:   V                      STARTING to perform all the installation work. No additional userU                      actions are necessary from this point. The remaining part of the U                      installation will take ( 5 - 30 minutes ) depending on your CPU. D               %VMSINSTAL-I-RESTORE, Restoring product save set B ...D               %VMSINSTAL-I-RESTORE, Restoring product save set C ...                        .                        .                        .  C                      Installation of AXPGKS V6.5 completed at hh:mm   G              Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORYt  Q              Creating installation data file: VMI$ROOT:[SYSUPD]AXPGKS065.VMI_DATA   6                      VMSINSTAL procedure done at hh:mm  +              DIGITAL GKS RUN-TIME-ONLY KIT:u  S                  STARTING to perform all the installation work.  No additional user R                  actions are necessary from this point.  The remaining part of theQ                  installation will take ( 5 - 30 minutes ) depending on your CPU.TC              %VMSINSTAL-I-RESTORE, Restoring product save set B ...                         .                        .                        .  E                      Installation of AXPGKSRT V6.5 completed at hh:mm   G              Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY   S              Creating installation data file: VMI$ROOT:[SYSUPD]AXPGKSRT065.VMI_DATAg  6                      VMSINSTAL procedure done at hh:mm  @              The installation procedure is complete. You can nowA              install more products or log out. If you removed anyf>              media from the console drive before beginning the5              installation, you should replace it now.6       2-12 Installing DIGITAL GKS            I                                                    Installing DIGITAL GKS I                                            2.1 The Installation Procedure)    3               14.Log out of the privileged account.   "                  $ LOGOUT <Return>A                  SYSTEM     logged out at 30-APR-1997 12:31:47.15a  D                  VMSINSTAL deletes or changes entries in the processI                  symbol tables during the installation. Therefore, if you I                  are going to continue using the system manager's account F                  and you want to restore these symbols, you should log&                  out and log in again.           2.2 Error Recovery  E               If errors occur during installation, VMSINSTAL displaysCH               failure messages. If the installation procedure fails, one@               or more of the following messages may also appear:  O               %VMSINSTAL-E-INSFAIL, The installation of AXPGKS V6.5 has failed.s  R               DIGITAL GKS requires OpenVMS V6.1 or a subsequent version of OpenVMS  O               System disk does not contain enough free blocks to install AXPGKSt  J               Insufficient CLISYMTBL pagelets - the installation of AXPGKSG               requires at least 150 pagelets. Use SYSGEN to change thist5               parameter and restart the installation.h  D               Errors can occur during the installation if any of the)               following conditions exist:p  ;               o  The operating system version is incorrect.s  >               o  A prerequisite software version is incorrect.  A               o  Quotas necessary for successful installation arer                  insufficient.  H               o  System parameter values for successful installation are                  insufficient.  >               o  The OpenVMS help library is currently in use.  H               o  The product license has not been registered and loaded.  =               o  The metafile input handler is not installed.   I               o  The default output handler, defined by the logical namesr<                  GKS$WSTYPE and GKS$CONID, is not installed.  I                                               Installing DIGITAL GKS 2-13                 Installing DIGITAL GKS     2.2 Error Recovery    E           If the IVP fails for any reason, the following messages aren           displayed:  E           The AXPGKS V6.5 Installation Verification Procedure failed.n  C           %VMSINSTAL-E-IVPFAIL, The IVP for AXPGKS V6.5 has failed.a  A           Other errors can also occur during IVP execution in theb           following situations:   6           o  The workstation handler is not installed.  J              %GKS-E-ERROR_23, specified workstation type does not exist in&               routine OPEN WORKSTATION  =              First, verify that the metafile input handler isi;              installed. Then, ensure that the definition ofkA              GKS$WSTYPE is a valid workstation type including bit @              masks, and that GKS$CONID corresponds to a physical6              device that is supported and functioning.  C           o  The connection identifier and workstation type are not               compatible.  D              %GKS-E-ERROR_26, specified workstation cannot be opened)               in routine OPEN WORKSTATION   D              Ensure that the definitions of GKS$CONID and GKS$WSTYPE@              are compatible, and that GKS$CONID corresponds to a?              physical device that is supported and functioning.,  D           o  There are not enough unused color entries available for'              DIGITAL GKS in DECwindows.   I              %GKS-E-ERROR_NEG_2, requested color map could not be createda)               in routine OPEN WORKSTATIONL  @              Set n (the color table size) in the workstation bitA              mask %x0nmm00xx to a value, such as 16. For example, A              for workstation type 231, specify %x010000E7. in the >              workstation bit mask %x0nmm00xx. For example, for6              workstation type 231, specify %x010000E7.  A           If you are notified that any of these conditions exist, D           you should take the appropriate action as described in theD           error message. For descriptions of the error messages, seeC           OpenVMS System Messages and Recovery Procedures ReferenceMA           Manual, your processor-specific installation/operationsNB           guide, or the OpenVMS License Management Utility Manual.       2-14 Installing DIGITAL GKSl    .                    I                                                                         3 I         _________________________________________________________________   I                                              After Installing DIGITAL GKST    D               The following tasks may be performed after DIGITAL GKS               installation:   4               o  Installing DIGITAL GKS on a cluster  0               o  Editing the system startup file  @               o  Running the Installation Verification Procedure  3               o  Determining and reporting problems   >         3.1 Installing DIGITAL GKS on an OpenVMS Alpha Cluster  D               If you want to run DIGITAL GKS on multiple nodes of anE               OpenVMS Alpha cluster, first check to see that you havenH               the appropriate software license. Then, follow these steps+               after installing DIGITAL GKS:i  G               1. Issue the LICENSE LOAD command to activate the licenseyG                  on each node in the cluster on which DIGITAL GKS is too                  be executed.t  <                  For the development kit, enter the command:  ,                  $ LICENSE LOAD GKS <Return>  >                  For the run-time-only kit, enter the command:  /                  $ LICENSE LOAD GKS-RT <Return>p  H               2. Run the following command procedure on each node of the7                  cluster that has the software license:   6                  $ @SYS$STARTUP:GKSTARTUP.COM <Return>  D               3. Prepare the system-specific roots on other nodes by=                  issuing the following commands on each node:   O                  $ CREATE/DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.GKS] <Return> G                  $ CREATE/DIRECTORY SYS$SPECIFIC:[SYSTEST.GKS] <Return>   I                                          After Installing DIGITAL GKS 3-1o t               After Installing DIGITAL GKS:     3.1 Installing DIGITAL GKS on an OpenVMS Alpha Cluster    E           4. Verify the installation by running the IVP on each node:_  ,              $ RUN GKS$TEST:GKS$IVP <Return>  =              Information about running the IVP is provided in               Section 3.3.m  A           5. Determine if the INSTALL utility was used to install               GKS3D$RTLIB.EXE:   0              a. Log in to a node on the cluster.  B              b. Run INSTALL and enter the following command at the                  INSTALL> prompt:  B                 INSTALL> LIST SYS$LIBRARY:GKS3D$RTLIB.EXE <Return>  D                 The INSTALL utility displays how the GKS3D$RTLIB was'                 installed. For example:t  9                 DISK$SYSTEM01:<SYS0.SYSCOMMON.SYSLIB>.EXEoA                     GKS3D$RTLIB;1    Open     Share         Lnkbl   E                 If an error occurs with this command, DIGITAL GKS wasH'                 not properly installed.r  B              c. Repeat steps a and b for each node of the cluster.  C           Do not purge files during the installation. You can purgee@           these files after you have run the DIGITAL GKS startup8           command procedure on each node of the cluster.        3.2 Editing the Startup File  B           To enable the automatic startup of DIGITAL GKS when yourD           system is rebooted, you must include the startup procedureB           GKSTARTUP.COM in the startup file SYS$MANAGER:SYSTARTUP_>           VMS.COM. Because DIGITAL GKS cannot start before theA           network has started, you must position this new commandG>           line after the line that invokes the network startupD           command procedure. The following example shows the networkB           startup command line followed by the DIGITAL GKS startup           command line:o  %           $ @SYS$MANAGER:STARTNET.COM                 .                .                .&           $ @SYS$STARTUP:GKSTARTUP.COM  $     3-2 After Installing DIGITAL GKS           I                                              After Installing DIGITAL GKS,I                                              3.2 Editing the Startup File.    F               When you install DIGITAL GKS on a cluster, GKSTARTUP.COMF               is automatically executed for the system node from whichE               the installation was performed. You may need to executeiH               this file for other nodes in the cluster, however, to haveG               the newest DIGITAL GKS images installed on those systems.dG               This is particularly true if you purged older versions of 2               DIGITAL GKS during the installation.  ;         3.3 Running the Installation Verification ProcedureG  H               To run the Installation Verification Procedure (IVP) after.               installation, enter the command:  -               $ RUN GKS$TEST:GKS$IVP <Return>t  F               For example, if you wish to run the DECwindows Motif IVPF               on a remote node, ensure that you have the access rightsC               on the server for remote use and that the DIGITAL GKSlD               DECwindows Motif handler is installed. Then, enter theF               following commands, substituting your node name for node               REMOTE:   .               $ DEFINE GKS$WSTYPE 231 <Return>6               $ DEFINE GKS$CONID  REMOTE::0.0 <Return>-               $ RUN GKS$TEST:GKS$IVP <Return>s  H               In this example, the image is output to the remote server.  .         3.4 Determining and Reporting Problems  H               If you encounter a problem while using DIGITAL GKS, reportC               it to DIGITAL. Depending on the nature of the problemsG               and the type of support you have, you can take one of then                following actions:  C               o  Call DIGITAL if your software contract or warrantyl=                  agreement entitles you to telephone support.   <               o  Submit a Software Performance Report (SPR).  ,               o  Send electronic mail to theF                  "requests@bgsdev.enet.dec.com" account if the problemI                  has to do with the DIGITAL GKS documentation. Be sure toPB                  include the section and page number of the error.  I                                          After Installing DIGITAL GKS 3-3                  After Installing DIGITAL GKS*     3.4 Determining and Reporting Problems    D           Review the Software Product Description (SPD) and WarrantyE           Addendum for an explanation of warranty. If you encounter asC           problem during the warranty period, report the problem asnE           described in this section, or follow alternate instructions >           provided by DIGITAL for reporting SPD nonconformance           problems.t                                                                              $     3-4 After Installing DIGITAL GKS    t                    I                                                                         A I         _________________________________________________________________K  I                                            Files Installed on Your System     I               During installation, DIGITAL GKS installs a number of files G               on your system. These files are listed in Section A.1 and                Section A.2.  -         A.1 DIGITAL GKS Development Kit Files   G               Table A-1 lists the files on the system that are added or H               modified when you install the DIGITAL GKS development kit.  I         Table_A-1_Installed_Files_for_the_DIGITAL_GKS_Development_Kit____   I         Directory________File_Name_______________________Description_____   I         SYS$COMMON:[SYS$STARTUP]_________________________________________n  &                          GKSTARTUP.COM  I                                                  (continued on next page)v                                    I                                        Files Installed on Your System A-1     i      "     Files Installed on Your System)     A.1 DIGITAL GKS Development Kit Filesm    E     Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmentrE     __________________Kit____________________________________________w  E     _________________________________________________________________i  E     SYS$COMMON:[SYSHLP]______________________________________________   E                      DECAXPGKS065.RELEASE_NOTES      Release notes in A                                                      ASCII formatR  B                      DECAXPGKS065_RELEASE_NOTES.PS   Release notesB                                                      in PostScript;                                                      format   ,                      DECGKS_CBIND_OP_SPEC.PS  -                      DECGKS_CBIND_OP_SPEC.TXTv  ,                      DECGKS_FBIND_OP_SPEC.PS  -                      DECGKS_FBIND_OP_SPEC.TXTh  .                      DECGKS_G3DBIND_OP_SPEC.PS  /                      DECGKS_G3DBIND_OP_SPEC.TXTG  ,                      DECGKS_GBIND_OP_SPEC.PS  -                      DECGKS_GBIND_OP_SPEC.TXTt                         HELPLIB.HLB  E     _________________________________________________________________aE     SYS$COMMON:[SYSHLP.EXAMPLES.GKS]_________________________________s  C                      ACCUM_XFORM_MATRIX_ADD.C        Optional filess  0                      ACCUM_XFORM_MATRIX_ADD_3D.C  2                      ACCUM_XFORM_MATRIX_ADD_CBND.C  ,                      ACCUM_XFORM_MATRIX_ADD_                      FORBND.FOR   !                      ASS_SEG_WS.Ce  $                      ASS_SEG_WS_3D.C  &                      ASS_SEG_WS_CBND.C  *                      ASS_SEG_WS_FORBND.FOR  !                      BACKGAMMON.Ca  #                      BUILD_PROG.COMt  $                      BUILD_PROG.MAKE  E                                              (continued on next page)   &     A-2 Files Installed on Your System           I                                            Files Installed on Your SystemsI                                     A.1 DIGITAL GKS Development Kit Filesn    I         Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmentdI         __________________Kit____________________________________________c  I         Directory________File_Name_______________________Description_____s  I         SYS$COMMON:[SYSHLP.EXAMPLES.GKS]_________________________________   %                          CELL_ARRAY.Ct  (                          CELL_ARRAY_3D.C  *                          CELL_ARRAY_CBND.C  .                          CELL_ARRAY_FORBND.FOR  #                          CLEAR_WS.CD  &                          CLEAR_WS_3D.C  (                          CLEAR_WS_CBND.C  ,                          CLEAR_WS_FORBND.FOR  )                          DEVICE_BUILD.COMa  %                          DEVICE_DFT.C   '                          DEVICE_DFT.MARp  (                          DEVICE_SAMPLE.C  *                          DEVICE_SAMPLE.MMS  ,                          DEVICE_SAMPLE_DFT.C  #                          ERR_HAND.Ce  &                          ERR_HAND_3D.C  (                          ERR_HAND_CBND.C  ,                          ERR_HAND_FORBND.FOR  !                          ESCAPE.C   $                          ESCAPE_3D.C  &                          ESCAPE_CBND.C  *                          ESCAPE_FORBND.FOR  4                          ESC_CONID_STRING_FORBND.FOR  ,                          EVAL_XFORM_MATRIX.C  /                          EVAL_XFORM_MATRIX_3D.C   1                          EVAL_XFORM_MATRIX_CBND.Co  5                          EVAL_XFORM_MATRIX_FORBND.FORe  I                                                  (continued on next page)   I                                        Files Installed on Your System A-3            "     Files Installed on Your System)     A.1 DIGITAL GKS Development Kit FilesI    E     Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmentuE     __________________Kit____________________________________________   E     Directory________File_Name_______________________Description_____t  E     SYS$COMMON:[SYSHLP.EXAMPLES.GKS]_________________________________n  !                      EVENT_MODE.C   $                      EVENT_MODE_3D.C  &                      EVENT_MODE_CBND.C  *                      EVENT_MODE_FORBND.FOR  )                      EX_CHOICE_INPUT_CB.Cd  +                      EX_CHOICE_INPUT_FB.FOR   *                      EX_CHOICE_INPUT_G3B.C  )                      EX_CHOICE_INPUT_GB.Cr  )                      EX_STRING_INPUT_CB.Cl  +                      EX_STRING_INPUT_FB.FORm  *                      EX_STRING_INPUT_G3B.C  )                      EX_STRING_INPUT_GB.CV  (                      EX_TEXT_OUTPUT_CB.C  *                      EX_TEXT_OUTPUT_FB.FOR  )                      EX_TEXT_OUTPUT_G3B.Cs  (                      EX_TEXT_OUTPUT_GB.C                         FONTS_HEX.C                        GDP.C                        GDP_3D.C                         GDP_CBND.C   #                      GDP_FORBND.FORa  &                      GERHND_FORBND.FOR                        GFX_DFT.C  "                      GKS_PICK233.C  "                      GKS_PICK333.C  !                      GKS_PREDEF.Cs  !                      GKS_SAMPLE.C   E                                              (continued on next page)   &     A-4 Files Installed on Your System o  r      I                                            Files Installed on Your SystemrI                                     A.1 DIGITAL GKS Development Kit Files     I         Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmentuI         __________________Kit____________________________________________f  I         Directory________File_Name_______________________Description_____a  I         SYS$COMMON:[SYSHLP.EXAMPLES.GKS]_________________________________I  )                          INIT_INQ_ST_2D.C   +                          INIT_INQ_ST_2D.FOR2  +                          INIT_INQ_ST_2D.PAS   +                          INIT_INQ_ST_3D.ADAP  )                          INIT_INQ_ST_3D.C   +                          INIT_INQ_ST_3D.FORG  +                          INIT_INQ_ST_3D.PASl  2                          INIT_INQ_ST_3D_SIZEOF.ADA  &                          INIT_STRING.C  )                          INIT_STRING_3D.C   +                          INIT_STRING_CBND.C   /                          INIT_STRING_FORBND.FOR   '                          INQUIRY_CBND.Ck  ,                          INQ_DEF_DATA_2D.ADA  *                          INQ_DEF_DATA_2D.C  ,                          INQ_DEF_DATA_2D.FOR  ,                          INQ_DEF_DATA_2D.PAS  ,                          INQ_DEF_DATA_3D.ADA  *                          INQ_DEF_DATA_3D.C  ,                          INQ_DEF_DATA_3D.FOR  ,                          INQ_DEF_DATA_3D.PAS  %                          INSERT_SEG.Cd  (                          INSERT_SEG_3D.C  *                          INSERT_SEG_CBND.C  .                          INSERT_SEG_FORBND.FOR  *                          MANDELBROT_CBND.C  ,                          OUTPUT_INPUT_3D.ADA  I                                                  (continued on next page)d  I                                        Files Installed on Your System A-5            "     Files Installed on Your System)     A.1 DIGITAL GKS Development Kit Filesi    E     Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmentdE     __________________Kit____________________________________________   E     Directory________File_Name_______________________Description_____s  E     SYS$COMMON:[SYSHLP.EXAMPLES.GKS]_________________________________s  &                      OUTPUT_INPUT_3D.C  )                      OUTPUT_INPUT_3DF.FOR0  )                      OUTPUT_INPUT_3DP.PASn  (                      OUTPUT_INPUT_CBND.C  ,                      OUTPUT_INPUT_FORBND.FOR  !                      README.FIRSTh  #                      REQUEST_MODE.Ce  &                      REQUEST_MODE_3D.C  (                      REQUEST_MODE_CBND.C  ,                      REQUEST_MODE_FORBND.FOR                        SAMPLE.OPTe  %                      SAMPLE_ALPHA.OPT   (                      SAMPLE_DEVICE_DFT.C  "                      SAMPLE_MODE.C  %                      SAMPLE_MODE_3D.C   '                      SAMPLE_MODE_CBND.C   +                      SAMPLE_MODE_FORBND.FOR_  "                      SAMPLE_PICK.C  %                      SAMPLE_PICK_3D.C   '                      SAMPLE_PICK_CBND.Ca  +                      SAMPLE_PICK_FORBND.FORw  &                      SAMPLE_VALUATOR.C  )                      SAMPLE_VALUATOR_3D.C   +                      SAMPLE_VALUATOR_CBND.C   /                      SAMPLE_VALUATOR_FORBND.FOR                         SET_CLIP.Ct  "                      SET_CLIP_3D.C  E                                              (continued on next page)G  &     A-6 Files Installed on Your System           I                                            Files Installed on Your System I                                     A.1 DIGITAL GKS Development Kit Filesi    I         Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmentDI         __________________Kit____________________________________________   I         Directory________File_Name_______________________Description_____K  I         SYS$COMMON:[SYSHLP.EXAMPLES.GKS]_________________________________e  (                          SET_CLIP_CBND.C  ,                          SET_CLIP_FORBND.FOR  )                          SET_COLOUR_REP.Cn  ,                          SET_COLOUR_REP_3D.C  .                          SET_COLOUR_REP_CBND.C  2                          SET_COLOUR_REP_FORBND.FOR  ,                          SET_FILL_AREA_REP.C  /                          SET_FILL_AREA_REP_3D.C   1                          SET_FILL_AREA_REP_CBND.Ct  5                          SET_FILL_AREA_REP_FORBND.FORa  &                          SET_HILIGHT.C  )                          SET_HILIGHT_3D.C.  +                          SET_HILIGHT_CBND.CT  /                          SET_HILIGHT_FORBND.FOR   '                          SET_LINETYPE.Ca  *                          SET_LINETYPE_3D.C  ,                          SET_LINETYPE_CBND.C  0                          SET_LINETYPE_FORBND.FOR  )                          SET_TEXT_ALIGN.C   ,                          SET_TEXT_ALIGN_3D.C  .                          SET_TEXT_ALIGN_CBND.C  2                          SET_TEXT_ALIGN_FORBND.FOR  $                          SET_WS_VP.C  '                          SET_WS_VP_3D.C   )                          SET_WS_VP_CBND.C   I                                                  (continued on next page)l  I                                        Files Installed on Your System A-7T >  S      "     Files Installed on Your System)     A.1 DIGITAL GKS Development Kit Filess    E     Table A-1 (Cont.) Installed Files for the DIGITAL GKS Development E     __________________Kit____________________________________________   E     Directory________File_Name_______________________Description_____   E     SYS$COMMON:[SYSHLP.EXAMPLES.GKS]_________________________________p  )                      SET_WS_VP_FORBND.FORe  &                      USER_MANUAL_1_3.C  &                      USER_MANUAL_3_1.C  &                      USER_MANUAL_4_1.C  &                      USER_MANUAL_5_1.C  &                      USER_MANUAL_6_1.C  &                      USER_MANUAL_7_1.C  E     _________________________________________________________________TE     SYS$COMMON:[SYSHLP.JA_JP]________________________________________a                         HELPLIB.HLB  E                                              (continued on next page)e                                    &     A-8 Files Installed on Your System o  i      I                                            Files Installed on Your SystemtI                                     A.1 DIGITAL GKS Development Kit Files     I         Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmentmI         __________________Kit____________________________________________   I         _________________________________________________________________   I         SYS$COMMON:[SYSLIB]______________________________________________   I                          GKS$I3D.EXE                     High-level files   )                          GKS$I3D_IEEE.EXE   .                          GKS$MI_WS_HANDLER.EXE  3                          GKS$MI_WS_HANDLER_IEEE.EXEe  .                          GKS$MO_WS_HANDLER.EXE  3                          GKS$MO_WS_HANDLER_IEEE.EXEc  0                          GKS$WISS_WS_HANDLER.EXE  5                          GKS$WISS_WS_HANDLER_IEEE.EXET  +                          GKS$WS_MANAGER.EXE   0                          GKS$WS_MANAGER_IEEE.EXE                            GKS.F                            GKS.H  $                          GKS$BND.OPT  &                          GKS3D$BND.OPT  %                          GKS3D$CBND.He  '                          GKS3D$DEFS.ADAn  '                          GKS3D$DEFS.BAS   '                          GKS3D$DEFS.FOR   %                          GKS3D$DEFS.Hn  '                          GKS3D$DEFS.PASo  '                          GKS3D$DEFS.PEN   '                          GKS3D$DEFS.PLIa  '                          GKS3D$DEFS.R32w  )                          GKS3D$ERRORS.ADAr  )                          GKS3D$ERRORS.BASi  )                          GKS3D$ERRORS.FOR   '                          GKS3D$ERRORS.HP  I                                                  (continued on next page)   I                                        Files Installed on Your System A-9e a  i      "     Files Installed on Your System)     A.1 DIGITAL GKS Development Kit Files     E     Table A-1 (Cont.) Installed Files for the DIGITAL GKS Development E     __________________Kit____________________________________________   E     Directory________File_Name_______________________Description_____   E     SYS$COMMON:[SYSLIB]______________________________________________a  %                      GKS3D$ERRORS.PAS   %                      GKS3D$ERRORS.PENo  %                      GKS3D$ERRORS.PLIe  %                      GKS3D$ERRORS.R32   %                      GKS3D$FORBND.FOR   '                      GKS3D$GKSRTLIB.EXEo  ,                      GKS3D$GKSRTLIB_IEEE.EXE  $                      GKS3D$RTLIB.EXE  )                      GKS3D$RTLIB_IEEE.EXEa  #                      GKS3D_DEFS.ADA   #                      GKS3D_DEFS.BASI  #                      GKS3D_DEFS.FOR   !                      GKS3D_DEFS.H   #                      GKS3D_DEFS.PASs  #                      GKS3D_DEFS.PENd  #                      GKS3D_DEFS.PLI   #                      GKS3D_DEFS.R32r  %                      GKS3D_ERRORS.ADAb  %                      GKS3D_ERRORS.BASe  %                      GKS3D_ERRORS.FOR   #                      GKS3D_ERRORS.Hn  %                      GKS3D_ERRORS.PASo  %                      GKS3D_ERRORS.PENe  %                      GKS3D_ERRORS.PLI   %                      GKS3D_ERRORS.R32                          GKSCBND.OLB                         GKSCBND.OPT  E                                              (continued on next page)   '     A-10 Files Installed on Your System_ _  _      I                                            Files Installed on Your SystemoI                                     A.1 DIGITAL GKS Development Kit Files     I         Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmenttI         __________________Kit____________________________________________m  I         Directory________File_Name_______________________Description_____a  I         SYS$COMMON:[SYSLIB]______________________________________________m  )                          GKSCBND_IEEE.OLB_  $                          GKSDEFS.ADA  $                          GKSDEFS.BAS  $                          GKSDEFS.BND  $                          GKSDEFS.FOR  "                          GKSDEFS.H  $                          GKSDEFS.LIB  $                          GKSDEFS.PAS  $                          GKSDEFS.PEN  $                          GKSDEFS.PL2  $                          GKSDEFS.PLI  $                          GKSDEFS.R32  %                          GKSDESCRIP.H   &                          GKSFORBND.OLB  &                          GKSFORBND.OPT  +                          GKSFORBND_IEEE.OLB_  $                          GKSMSGS.ADA  $                          GKSMSGS.BAS  $                          GKSMSGS.FOR  "                          GKSMSGS.H  $                          GKSMSGS.LIB  $                          GKSMSGS.PAS  $                          GKSMSGS.PEN  $                          GKSMSGS.PLI  $                          GKSMSGS.R32  %                          GKSRTLIB.EXE.  *                          GKSRTLIB_IEEE.EXE  I                                                  (continued on next page)   I                                       Files Installed on Your System A-11            "     Files Installed on Your System)     A.1 DIGITAL GKS Development Kit Files     E     Table A-1 (Cont.) Installed Files for the DIGITAL GKS DevelopmentCE     __________________Kit____________________________________________X  E     Directory________File_Name_______________________Description_____   E     SYS$COMMON:[SYSLIB]_______________________________________________  C                      GKSGFX$CGMO_DEV_HANDLER.EXE     Device handler$:                                                      files  -                      GKSGFX$CGMO_DEV_HANDLER_.                      IEEE.EXE   2                      GKSGFX$COLSIX_DEV_HANDLER.EXE  /                      GKSGFX$COLSIX_DEV_HANDLER_                       IEEE.EXET  0                      GKSGFX$DDIF_DEV_HANDLER.EXE  -                      GKSGFX$DDIF_DEV_HANDLER_                       IEEE.EXE   0                      GKSGFX$HPGL_DEV_HANDLER.EXE  -                      GKSGFX$HPGL_DEV_HANDLER_C                      IEEE.EXE   1                      GKSGFX$HPPCL_DEV_HANDLER.EXE.  .                      GKSGFX$HPPCL_DEV_HANDLER_                      IEEE.EXE   %                      GKSGFX$IM_JP.EXE   *                      GKSGFX$IM_JP_IEEE.EXE  -                      GKSGFX$KEY_MAP_TABLE.EXE   2                      GKSGFX$KEY_MAP_TABLE_IEEE.EXE  1                      GKSGFX$MOTIF_DEV_HANDLER.EXE   .                      GKSGFX$MOTIF_DEV_HANDLER_                      IEEE.EXE_  .                      GKSGFX$PS_DEV_HANDLER.EXE  3                      GKSGFX$PS_DEV_HANDLER_IEEE.EXE_  1                      GKSGFX$REGIS_DEV_HANDLER.EXE_  .                      GKSGFX$REGIS_DEV_HANDLER_                      IEEE.EXE   #                      GKSGFX$RTL.EXE   E                                              (continued on next page)R  '     A-12 Files Installed on Your SystemC R  .      I                                            Files Installed on Your System_I                                     A.1 DIGITAL GKS Development Kit Files     I         Table A-1 (Cont.) Installed Files for the DIGITAL GKS Development I         __________________Kit____________________________________________   I         Directory________File_Name_______________________Description_____C  I         SYS$COMMON:[SYSLIB]______________________________________________   ,                          GKSGFX$RTL_IEEE.EXE  5                          GKSGFX$SIXEL_DEV_HANDLER.EXED  2                          GKSGFX$SIXEL_DEV_HANDLER_!                          IEEE.EXE   5                          GKSGFX$TEK41_DEV_HANDLER.EXE   2                          GKSGFX$TEK41_DEV_HANDLER_!                          IEEE.EXE   3                          GKSGFX$TEK_DEV_HANDLER.EXE   0                          GKSGFX$TEK_DEV_HANDLER_!                          IEEE.EXE   4                          VAXGFX$DDIF_COLOR_TABLE.DAT  .                          VAXGFX$FONT_J0102.FNT  1                          VAXGFX$FONT_JISX0201.FNT   1                          VAXGFX$FONT_JISX0208.FNT   .                          VAXGFX$FONT_NEG01.FNT  .                          VAXGFX$FONT_NEG02.FNT  .                          VAXGFX$FONT_NEG03.FNT  .                          VAXGFX$FONT_NEG04.FNT  .                          VAXGFX$FONT_NEG05.FNT  .                          VAXGFX$FONT_NEG06.FNT  .                          VAXGFX$FONT_NEG07.FNT  .                          VAXGFX$FONT_NEG08.FNT  .                          VAXGFX$FONT_NEG09.FNT  .                          VAXGFX$FONT_NEG10.FNT  .                          VAXGFX$FONT_NEG11.FNT  .                          VAXGFX$FONT_NEG12.FNT  .                          VAXGFX$FONT_NEG13.FNT  .                          VAXGFX$FONT_NEG14.FNT  I                                                  (continued on next page)P  I                                       Files Installed on Your System A-13  E  T      "     Files Installed on Your System)     A.1 DIGITAL GKS Development Kit Files     E     Table A-1 (Cont.) Installed Files for the DIGITAL GKS Development E     __________________Kit____________________________________________T  E     Directory________File_Name_______________________Description_____C  E     SYS$COMMON:[SYSLIB]______________________________________________   *                      VAXGFX$FONT_NEG15.FNT  *                      VAXGFX$FONT_NEG16.FNT  *                      VAXGFX$FONT_NEG17.FNT  *                      VAXGFX$FONT_NEG18.FNT  *                      VAXGFX$FONT_NEG19.FNT  *                      VAXGFX$FONT_NEG20.FNT  *                      VAXGFX$FONT_NEG21.FNT  *                      VAXGFX$FONT_NEG22.FNT  *                      VAXGFX$FONT_NEG23.FNT  *                      VAXGFX$FONT_NEG24.FNT  #                      VAXGFX$RTL.EXE   E     _________________________________________________________________nE     SYS$COMMON:[SYSMSG]_______________________________________________  !                      GKS$MSGS.EXE_  E     __________________________________________________________________E     SYS$COMMON:[SYSTEST]______________________________________________                        GKS.DIR  E     _________________________________________________________________IE     SYS$COMMON:[SYSTEST.GKS]_________________________________________                          GKS$IVP.DAT                         GKS$IVP.EXE  E     _________________________________________________________________ E     SYS$COMMON:[DECW$DEFAULTS.SYSTEM]________________________________N  "                      GKS_MOTIF.UID  %                      GKS_MOTIF_EN.UID   E     _________________GKS_MOTIF_JP.UID________________________________   '     A-14 Files Installed on Your SystemR .         I                                            Files Installed on Your SystemDI                                   A.2 DIGITAL GKS Run-Time-Only Kit Files     /         A.2 DIGITAL GKS Run-Time-Only Kit Files   G               Table A-2 lists the files on the system that are added or E               modified when you install the DIGITAL GKS run-time-onlyQ               kit.  I         Table_A-2_Installed_Files_for_the_DIGITAL_GKS_Run-Time-Only_Kit__R  I         Directory________File_Name_______________________Description_____   I         SYS$COMMON:[DECW$DEFAULTS.SYSTEM]________________________________   &                          GKS_MOTIF.UID  )                          GKS_MOTIF_EN.UID   )                          GKS_MOTIF_JP.UID   I         _________________________________________________________________sI         SYS$COMMON:[SYS$STARTUP]_________________________________________y  &                          GKSTARTUP.COM  I         _________________________________________________________________mI         SYS$COMMON:[SYSHLP]______________________________________________   I                          DECAXPGKS065.RELEASE_NOTES      Release notes in E                                                          ASCII format   F                          DECAXPGKS065_RELEASE_NOTES.PS   Release notesF                                                          in PostScript?                                                          formatU  $                          HELPLIB.HLB  I         _________________________________________________________________QI         SYS$COMMON:[SYSHLP.JA_JP]________________________________________   $                          HELPLIB.HLB  I         _________________________________________________________________ I         SYS$COMMON:[SYSLIB]______________________________________________   I                          GKS$I3D.EXE                     High-level filesN  )                          GKS$I3D_IEEE.EXEN  .                          GKS$MI_WS_HANDLER.EXE  3                          GKS$MI_WS_HANDLER_IEEE.EXE   I                                                  (continued on next page)   I                                       Files Installed on Your System A-153           "     Files Installed on Your System+     A.2 DIGITAL GKS Run-Time-Only Kit FilesR    C     Table A-2 (Cont.) Installed Files for the DIGITAL GKS Run-Time-CE     __________________Only_Kit_______________________________________n  E     Directory________File_Name_______________________Description_____   E     SYS$COMMON:[SYSLIB]______________________________________________   *                      GKS$MO_WS_HANDLER.EXE  /                      GKS$MO_WS_HANDLER_IEEE.EXEn  ,                      GKS$WISS_WS_HANDLER.EXE  1                      GKS$WISS_WS_HANDLER_IEEE.EXE_  '                      GKS$WS_MANAGER.EXEt  ,                      GKS$WS_MANAGER_IEEE.EXE  '                      GKS3D$GKSRTLIB.EXEE  ,                      GKS3D$GKSRTLIB_IEEE.EXE  $                      GKS3D$RTLIB.EXE  )                      GKS3D$RTLIB_IEEE.EXED  !                      GKSRTLIB.EXEC  &                      GKSRTLIB_IEEE.EXE  C                      GKSGFX$COLSIX_DEV_HANDLER.EXE   Device handler :                                                      files  /                      GKSGFX$COLSIX_DEV_HANDLER_                       IEEE.EXEP  0                      GKSGFX$DDIF_DEV_HANDLER.EXE  -                      GKSGFX$DDIF_DEV_HANDLER_A                      IEEE.EXE   0                      GKSGFX$HPGL_DEV_HANDLER.EXE  -                      GKSGFX$HPGL_DEV_HANDLER_S                      IEEE.EXE   1                      GKSGFX$HPPCL_DEV_HANDLER.EXE   .                      GKSGFX$HPPCL_DEV_HANDLER_                      IEEE.EXE   %                      GKSGFX$IM_JP.EXE   *                      GKSGFX$IM_JP_IEEE.EXE  -                      GKSGFX$KEY_MAP_TABLE.EXE   E                                              (continued on next page)   '     A-16 Files Installed on Your System            I                                            Files Installed on Your System I                                   A.2 DIGITAL GKS Run-Time-Only Kit Files     G         Table A-2 (Cont.) Installed Files for the DIGITAL GKS Run-Time- I         __________________Only_Kit_______________________________________T  I         Directory________File_Name_______________________Description_____o  I         SYS$COMMON:[SYSLIB]______________________________________________K  6                          GKSGFX$KEY_MAP_TABLE_IEEE.EXE  5                          GKSGFX$MOTIF_DEV_HANDLER.EXE_  2                          GKSGFX$MOTIF_DEV_HANDLER_!                          IEEE.EXE_  2                          GKSGFX$PS_DEV_HANDLER.EXE  7                          GKSGFX$PS_DEV_HANDLER_IEEE.EXE3  5                          GKSGFX$REGIS_DEV_HANDLER.EXE   2                          GKSGFX$REGIS_DEV_HANDLER_!                          IEEE.EXE   '                          GKSGFX$RTL.EXE   ,                          GKSGFX$RTL_IEEE.EXE  5                          GKSGFX$SIXEL_DEV_HANDLER.EXEO  2                          GKSGFX$SIXEL_DEV_HANDLER_!                          IEEE.EXEL  5                          GKSGFX$TEK41_DEV_HANDLER.EXEo  2                          GKSGFX$TEK41_DEV_HANDLER_!                          IEEE.EXEu  3                          GKSGFX$TEK_DEV_HANDLER.EXE   0                          GKSGFX$TEK_DEV_HANDLER_!                          IEEE.EXEI  4                          VAXGFX$DDIF_COLOR_TABLE.DAT  .                          VAXGFX$FONT_J0102.FNT  1                          VAXGFX$FONT_JISX0201.FNT_  1                          VAXGFX$FONT_JISX0208.FNT_  .                          VAXGFX$FONT_NEG01.FNT  .                          VAXGFX$FONT_NEG02.FNT  .                          VAXGFX$FONT_NEG03.FNT  .                          VAXGFX$FONT_NEG04.FNT  I                                                  (continued on next page)   I                                       Files Installed on Your System A-17X           "     Files Installed on Your System+     A.2 DIGITAL GKS Run-Time-Only Kit FilesL    C     Table A-2 (Cont.) Installed Files for the DIGITAL GKS Run-Time- E     __________________Only_Kit_______________________________________   E     Directory________File_Name_______________________Description_____E  E     SYS$COMMON:[SYSLIB]______________________________________________   *                      VAXGFX$FONT_NEG05.FNT  *                      VAXGFX$FONT_NEG06.FNT  *                      VAXGFX$FONT_NEG07.FNT  *                      VAXGFX$FONT_NEG08.FNT  *                      VAXGFX$FONT_NEG09.FNT  *                      VAXGFX$FONT_NEG10.FNT  *                      VAXGFX$FONT_NEG11.FNT  *                      VAXGFX$FONT_NEG12.FNT  *                      VAXGFX$FONT_NEG13.FNT  *                      VAXGFX$FONT_NEG14.FNT  *                      VAXGFX$FONT_NEG15.FNT  *                      VAXGFX$FONT_NEG16.FNT  *                      VAXGFX$FONT_NEG17.FNT  *                      VAXGFX$FONT_NEG18.FNT  *                      VAXGFX$FONT_NEG19.FNT  *                      VAXGFX$FONT_NEG20.FNT  *                      VAXGFX$FONT_NEG21.FNT  *                      VAXGFX$FONT_NEG22.FNT  *                      VAXGFX$FONT_NEG23.FNT  *                      VAXGFX$FONT_NEG24.FNT  #                      VAXGFX$RTL.EXEA  E     __________________________________________________________________E     SYS$COMMON:[SYSTEST.GKS]__________________________________________                         GKS$IVP.DAT  E     _________________GKS$IVP.EXE_____________________________________   '     A-18 Files Installed on Your System     S                    I                                                                         B3I         _________________________________________________________________G  I                                                      Sample Installations     @               This appendix provides sample installations of theE               development and run-time-only kits. These installationsF3               were run in the following conditions:   H               o  No previous version of DIGITAL GKS was installed on the                  system.  &               o  DECnet was shut down.  6               o  No users were logged onto the system.  4         B.1 DIGITAL GKS Development Kit Installation  H               This section contains a sample installation of the DIGITAL"               GKS development kit.  S         $ @SYS$UPDATE:VMSINSTAL AXPGKS065 DKA400:[AXPGKS065.KIT] OPTIONS N <Return>   G                OpenVMS AXP Software Product Installation Procedure V6.1   #         It is 30-APR-1997 at 11:06.   7         Enter a question mark (?) at any time for help.   Q         * Are you satisfied with the backup of your system disk [YES]? Y <Return>   1         The following products will be processed:F           AXPGKS V6.5S  >                 Beginning installation of AXPGKS V6.5 at 11:06  >         %VMSINSTAL-I-RESTORE, Restoring product save set A ...  )         Additional Release Notes Options:_  #            1. Display release notes_!            2. Print release notese            3. Both 1 and 2            4. None of the abovea  %         * Select option [2]: <Return>_  I                                                  Sample Installations B-1. _              Sample Installations0     B.1 DIGITAL GKS Development Kit Installation    &     * Queue name [sys$print]: <Return>?     * Do you want to continue the installation [NO]? Y <Return>SO     %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.S           DIGITAL GKS T         Copyright (C) Digital Equipment Corporation 1988-1997.  All rights reserved.  Q         Restricted Rights: Use, duplication, or disclosure by the U.S. GovernmentCO         is subject to restrictions as set forth in subparagraph (c) (1) (ii) ofON         DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III,         as applicable.  E         This software is proprietary to and embodies the confidential I         technology of Digital Equipment Corporation.  Possession, use, orBI         copying of this software and media is authorized only pursuant toS=         a valid written license from DIGITAL or an authorized          sublicensor.  N     * Do you want to purge files replaced by this installation [YES]? <Return>               Product:      GKS              Producer:     DECe             Version:      6.5 %             Release Date: 30-APR-1997e  S     * Does this product have an authorization key registered and loaded? Y <Return>A  N        This kit contains a set of example programs (4000 blocks).  They can be:        installed by answering "YES" to the EXAMPLE prompt.  A     * Do you wish to install the example programs [YES]? <Return>_  :        This kit contains Japanese-related images and file.%        They require Japanese OpenVMS._  M     * Do you wish to install Japanese related images and files [NO]? <Return>$  H        This kit contains an Installation Verification Procedure (IVP) toQ        verify the correct installation of the DIGITAL GKS product.  It can be run M        prior to the conclusion of the procedure by answering "YES" to the IVPH;        prompt or invoked after the installation as follows:   -          RUN SYS$SYSROOT:[SYSTEST.GKS]GKS$IVP      or          RUN GKS$TEST:GKS$IVP   T     * Do you wish to perform the Installation Verification Procedure [YES]? <Return>       B-2 Sample Installations C         I                                                      Sample Installations.I                              B.1 DIGITAL GKS Development Kit InstallationE    M             STARTING to perform all the installation work. No additional userJL             actions are necessary from this point. The remaining part of theL             installation will take ( 5 - 30 minutes ) depending on your CPU.>         %VMSINSTAL-I-RESTORE, Restoring product save set B ...>         %VMSINSTAL-I-RESTORE, Restoring product save set C ...  L             The DIGITAL GKS base kit files have been processed successfully.7             The installation procedure is continuing...   T             The DIGITAL GKS Development Environment has been processed successfully.7             The installation procedure is continuing...   N             The DIGITAL GKS Example Programs have been processed successfully.7             The installation procedure is continuing...   J             DIGITAL GKS has built successfully. Continuing installation...               System Manager:   L             Upon completion of this installation, please be sure to edit theT             system startup files as described in the DIGITAL GKS Installation Guide.  V         %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  P             Beginning the DIGITAL GKS Installation Verification Procedure (IVP).C             The IVP will take 1 to 5 minutes depending on your CPU.E  P             Since you are running on a workstation the Installation VerificationS             Procedure will be run with DIGITAL GKS device type 231 (MOTIF).  Output P             will be done to the node indicated by the logical name DECW$DISPLAY.  P             If the results of the Installation Verification Procedure (IVP) lookS             like the illustration provided with the DIGITAL GKS Installation Guide,F2             then installation has been successful.  J             The DIGITAL GKS V6.5 Installation Verification Procedure (IVP)#             completed successfully.J  >                 Installation of AXPGKS V6.5 completed at 11:10  F             Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  P             Creating installation data file: VMI$ROOT:[SYSUPD]AXPGKS065.VMI_DATA  1                 VMSINSTAL procedure done at 11:10   I                                                  Sample Installations B-3G F              Sample Installations2     B.2 DIGITAL GKS Run-Time-Only Kit Installation    2     B.2 DIGITAL GKS Run-Time-Only Kit Installation  B           This section contains a sample DIGITAL GKS run-time-only           kit installation.N  I     $ @SYS$UPDATE:VMSINSTAL AXPGKSRT065 DKA400:[AXPGKSRT065.KIT] <Return>   C            OpenVMS AXP Software Product Installation Procedure V6.1        It is 30-APR-1997 at 23:57.P  3     Enter a question mark (?) at any time for help.e  M     * Are you satisfied with the backup of your system disk [YES]? Y <Return>   -     The following products will be processed:          AXPGKSRT V6.5i  <             Beginning installation of AXPGKSRT V6.5 at 23:57  :     %VMSINSTAL-I-RESTORE, Restoring product save set A ...O     %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.B          DIGITAL GKSS        Copyright (C) Digital Equipment Corporation 1988-1997.  All rights reserved.   P        Restricted Rights: Use, duplication, or disclosure by the U.S. GovernmentN        is subject to restrictions as set forth in subparagraph (c) (1) (ii) ofM        DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III,X        as applicable.   D        This software is proprietary to and embodies the confidentialH        technology of Digital Equipment Corporation.  Possession, use, orH        copying of this software and media is authorized only pursuant to<        a valid written license from DIGITAL or an authorized        sublicensor._  N     * Do you want to purge files replaced by this installation [YES]? <Return>  "               Product:      GKS-RT               Producer:     DEC_               Version:      6.5_'               Release Date: 30-APR-1997R  S     * Does this product have an authorization key registered and loaded? Y <Return>M  :        This kit contains Japanese-related images and file.%        They require Japanese OpenVMS.   M     * Do you wish to install Japanese related images and files [NO]? <Return>_       B-4 Sample Installations N  E      I                                                      Sample InstallationsMI                            B.2 DIGITAL GKS Run-Time-Only Kit InstallationG    L            This kit contains an Installation Verification Procedure (IVP) toU            verify the correct installation of the DIGITAL GKS product.  It can be run Q            prior to the conclusion of the procedure by answering "YES" to the IVPi?            prompt or invoked after the installation as follows:   3                RUN SYS$SYSROOT:[SYSTEST.GKS]GKS$IVPa
            or #                RUN GKS$TEST:GKS$IVP   X         * Do you wish to perform the Installation Verification Procedure [YES]? <Return>  M             STARTING to perform all the installation work. No additional user_L             actions are necessary from this point. The remaining part of theL             installation will take ( 5 - 30 minutes ) depending on your CPU.>         %VMSINSTAL-I-RESTORE, Restoring product save set B ...  P             The DIGITAL GKS base kit files have been processed successfully. The3             installation procedure is continuing..._  J             DIGITAL GKS has built successfully. Continuing installation...               System Manager:_  L             Upon completion of this installation, please be sure to edit theT             system startup files as described in the DIGITAL GKS Installation Guide.  V         %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  P             Beginning the DIGITAL GKS Installation Verification Procedure (IVP).C             The IVP will take 1 to 5 minutes depending on your CPU.i  P             Since you are running on a workstation the Installation VerificationS             Procedure will be run with DIGITAL GKS device type 231 (MOTIF).  Output_P             will be done to the node indicated by the logical name DECW$DISPLAY.  P             If the results of the Installation Verification Procedure (IVP) lookS             like the illustration provided with the DIGITAL GKS Installation Guide,_2             then installation has been successful.  L             The DIGITAL GKSRT V6.5 Installation Verification Procedure (IVP)#             completed successfully.   @                 Installation of AXPGKSRT V6.5 completed at 23:58  F             Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  R             Creating installation data file: VMI$ROOT:[SYSUPD]AXPGKSRT065.VMI_DATA  1                 VMSINSTAL procedure done at 23:58i  I                                                  Sample Installations B-5                                                                                                                                                                                                                                                                                                                                                                   