Digital PHIGS _______________________________________________ Installing Digital PHIGS for OpenVMS Alpha Systems Order Number: AA-PVTHL-TE October 1996 This document contains instructions for installing Digital PHIGS[TM] (formerly DEC PHIGS[TM]) on Alpha architecture running the OpenVMS[TM] Alpha operating system. It also explains how to read the online release notes before or after installing this product. This document applies to Digital PHIGS Version 5.0. Revision/Update Information: This revised manual supersedes Installing Digital PHIGS for OpenVMS Alpha Systems (Order Number: AA-PVTHK-TE). Operating System and Version: OpenVMS Alpha Version 6.2 or higher DECwindows[TM] Motif[R] Version 1.2-3 for OpenVMS Alpha Software Version: Digital PHIGS Version 5.0 Digital Open3D[TM] Version 3.4 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ First Printing, January 1993 Revised, July 1993 Revised, January 1994 Revised, July 1994 Revised, October 1994 Revised, April 1995 Revised, July 1995 Revised, October 1995 Revised, January 1996 Revised, April 1996 Revised, October 1996 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1993, 1994, 1995, 1996. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DDIF, DEC, DEC GKS, DEC PHIGS, DECnet, DECwindows, Digital, Digital Open3D, Digital PHIGS, OpenVMS, VAX, VMS, and the DIGITAL logo. 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. This document is available on CD-ROM. ZK6194 This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install Digital PHIGS 1.1 Prerequisite Software......................... 1-1 1.2 Online Release Notes.......................... 1-2 1.3 Media Distribution Kit........................ 1-2 1.4 License Registration.......................... 1-3 1.5 Installation Procedure Requirements........... 1-4 1.5.1 Privileges................................ 1-4 1.5.2 Disk Space................................ 1-4 1.5.3 Global Pagelets and Global Sections System Parameters................................ 1-5 1.5.3.1 Determining the Global Pagelets and Global Sections Available............... 1-6 1.5.3.2 Determining the Global Pagelets and Global Sections Used.................... 1-7 1.5.3.3 Modifying the Global Pagelets Parameter............................... 1-8 1.5.3.4 Modifying the Global Sections Parameter............................... 1-8 1.5.3.5 Recalculating the Global Pages and Global Sections Parameters.............. 1-9 1.5.4 Other System Parameters................... 1-9 1.5.5 User Account Quotas....................... 1-9 1.6 Backing Up Your System Disk................... 1-10 2 Installing Digital PHIGS 2.1 Installation Procedure........................ 2-1 2.2 Error Recovery................................ 2-15 iii 3 After Installing Digital PHIGS 3.1 Installing Digital PHIGS on an OpenVMS Alpha Cluster....................................... 3-1 3.2 Editing the Startup File...................... 3-2 3.3 Running the Installation Verification Procedure..................................... 3-2 3.4 Determining and Reporting Problems............ 3-3 A Files Installed on Your System A.1 Digital PHIGS Development Kit Files........... A-1 A.2 Digital PHIGS Run-Time-Only Kit Files......... A-11 B Sample Installations B.1 Digital PHIGS Development Kit Installation.... B-1 B.2 Digital PHIGS Run-Time-Only Kit Installation.................................. B-5 Figures 3-1 Sample IVP Display........................ 3-3 Tables 1-1 Disk Space Requirements................... 1-4 1-2 Minimum Required System Parameter Values.................................... 1-5 A-1 Installed Files for the Digital PHIGS Development Kit........................... A-1 A-2 Installed Files for the Digital PHIGS Run-Time-Only Kit......................... A-11 iv _________________________________________________________________ Preface This document describes how to install Digital PHIGS Version 5.0 on Alpha processors running the OpenVMS Alpha operating system. Because this installation guide is not usually revised for software maintenance updates, you should read the Read Before Installing or Using Digital PHIGS for OpenVMS Alpha Systems letter for a summary of the significant changes to the installation procedure. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall Digital PHIGS for any other reason. Intended Audience This manual is for system managers installing Digital PHIGS on OpenVMS Alpha systems. Structure of this Document This manual is organized as follows: o Chapter 1 describes the operating system requirements for Digital PHIGS installation, and the procedures that you should complete before installing Digital PHIGS. o Chapter 2 provides the step-by-step instructions for the installation. o Chapter 3 describes the operations you perform after installation. o Appendix A lists the files installed with Digital PHIGS. o Appendix B provides sample development kit and run-time- only kit installations. v Manuals in the Digital PHIGS Documentation Set In addition to this manual, the Digital PHIGS documentation set includes the following manuals: o DEC PHIGS Ada Binding Reference Manual o DEC PHIGS C Binding Reference Manual o DEC PHIGS ISO C Binding Reference Manual o DEC PHIGS ISO Fortran Binding Reference Manual o DEC PHIGS PHIGS$ Binding Reference Manual o Device Specifics Reference Manual for DEC GKS and DEC PHIGS o Getting Started with DEC PHIGS o DEC PHIGS Developer's Guide 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 o OpenVMS License Management Utility Manual o Guide to OpenVMS Performance Management Conventions Used in This Manual The following conventions are used in this guide: UPPERCASE TEXT Uppercase letters indicate the name of a command, file, parameter, procedure, or utility. Bold Boldface text is used in interactive examples to indicate typed user input. vi $ The dollar sign is used to indicate the DCL prompt. This prompt may be different on your system. system output This typeface is used in interactive and code examples to indicate system output. In text, this typeface is used to indicate the exact name of a command, option, partition, path name, directory, or file. [logical-name] Square brackets indicate that the enclosed item is optional. (Square brackets are not, however, optional in the syntax of a directory name in a file specification or in the syntax of a substring specification in an assignment statement.) In procedures, a sequence such as indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. In procedures, a key name is shown enclosed to indicate that you press a key on the keyboard. . Vertical ellipsis in an example . means that some information has been . omitted. VMS[TM] The terms VMS and OpenVMS refer to OpenVMS the same operating system. Digital PHIGS References to Digital PHIGS refer to the Digital PHIGS (formerly DEC PHIGS) product. vii 1 _________________________________________________________________ Preparing to Install Digital PHIGS This chapter describes the preparations and requirements necessary for installing Digital PHIGS Version 5.0. This chapter will help you determine the following: o Whether the system on which you will install Digital PHIGS has the prerequisite software installed o How to read the online release notes o If installing Digital PHIGS from media, whether your distribution kit includes all the components listed on the Bill of Materials (BOM) o How to register a software license o The privileges required to perform the installation o How much disk space you will need o Whether the global pagelets and sections parameters are defined properly o Whether the process account quotas are defined correctly o How to back up your system disk 1.1 Prerequisite Software To install Digital PHIGS on an Alpha workstation, you must have the following products installed: o OpenVMS Alpha operating system Version 6.2 or higher o DECwindows Motif Version 1.2-3 or higher for OpenVMS Alpha Preparing to Install Digital PHIGS 1-1 Preparing to Install Digital PHIGS 1.1 Prerequisite Software ________________________ Note _______________________ If you install Digital PHIGS on a workstation with three-dimensional graphics capabilities, and use a PEX workstation type, you must install Digital Open3D Version 3.4 for OpenVMS Alpha systems. ______________________________________________________ Digital PHIGS also requires the following OpenVMS Alpha classes for full functionality: o OpenVMS Alpha required save set o Network support--where full DECwindows network functionality is necessary o Programming support--required by the Digital PHIGS development kit o OpenVMS Alpha class for workstation support--required if you are using Digital PHIGS on a workstation 1.2 Online Release Notes Digital PHIGS provides online release notes. Digital strongly recommends that you read the release notes before using Digital PHIGS, because they may contain information about product changes. During installation, you can access release notes in the installation procedure when you invoke VMSINSTAL with the OPTIONS N parameter. This option lets you read or print the release notes before installing Digital PHIGS. After installation, you can obtain the Digital PHIGS release notes by printing the following files: o SYS$HELP:AXPPHIGS050.RELEASE_NOTES (ASCII format) o SYS$HELP:AXPPHIGS050_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 mount distribution media, see your processor-specific 1-2 Preparing to Install Digital PHIGS Preparing to Install Digital PHIGS 1.3 Media Distribution Kit installation/operations guide, which also details several options for the installation procedure. 1.4 License Registration Before you install and run Digital PHIGS Version 5.0 on a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The PAK is a paper certificate that contains information about the license that enables you to use the software. The License PAK is shipped with the kit if you ordered the license and media together; otherwise, the PAK is shipped separately to a location specified on your license order. If you are installing Digital PHIGS as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. If you are installing prerequisite or optional software along with Digital PHIGS, review the PAK status and install the PAKs for this prerequisite or optional software before you install Digital PHIGS. To register a license under the OpenVMS Alpha operating system, first log in to the system manager's account, SYSTEM. You can then register the license in one of two ways: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with the data from your License PAK. o Type the LICENSE REGISTER command with the qualifiers corresponding to the License PAK information. If you plan to use Digital PHIGS on more than one node in an OpenVMS Alpha cluster configuration, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.1 for details. For complete information on using LMF, see the OpenVMS License Management Utility Manual. 1.5 Installation Procedure Requirements The following sections describe the various requirements for installing Digital PHIGS. The installation takes approximately 5 to 30 minutes, depending on your system configuration. Preparing to Install Digital PHIGS 1-3 Preparing to Install Digital PHIGS 1.5 Installation Procedure Requirements 1.5.1 Privileges To install Digital PHIGS, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV When you invoke VMSINSTAL to begin the installation procedure, VMSINSTAL turns off the BYPASS privilege. After installation, each user account must have at least the TMPMBX and NETMBX privileges to use Digital PHIGS. Use the OpenVMS Authorize Utility to determine whether users have the privileges they require. 1.5.2 Disk Space The Digital PHIGS requirements for free disk space are different during installation and after installation. Table 1-1 summarizes these requirements. Table 1-1 Disk Space Requirements ___________________________________________________________ Blocks During Blocks After Kit Installation Installation ___________________________________________________________ Digital PHIGS Development 60,000 55,000 Kit Version 5.0 With Ada option 91,000 86,000 Digital PHIGS Run-Time- 35,000 30,000 Only Kit Version 5.0 ___________________________________________________________ To determine the number of free blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE 1-4 Preparing to Install Digital PHIGS Preparing to Install Digital PHIGS 1.5 Installation Procedure Requirements _______________________ Caution _______________________ You must ensure that your system has the necessary global pagelet (512-byte subpage unit) and global section SYSGEN quotas for the installation. Otherwise, the DCL tables may become corrupted in certain situations. ______________________________________________________ 1.5.3 Global Pagelets and Global Sections System Parameters The installation of Digital PHIGS requires minimum values for the system parameters defining the global pagelets and global sections. These values are shown in Table 1-2. Depending on the kinds of programs and applications running at your site, you may need to define larger values. Table 1-2 Minimum Required System Parameter Values ___________________________________________________________ System Parameter Minimum Value ___________________________________________________________ GBLPAGES[1] n + 25000 ___________________________________________________________ GBLSECTIONS[1] n + 75 ___________________________________________________________ [1]The n variable refers to the system parameter values that are currently in use. To install Digital PHIGS, you must increase those values by the number indicated. (See Section 1.5.3.2.) These dynamic system parameters must be set permanently to values equal to or greater than the values listed. Do not decrease these values after the installation. ___________________________________________________________ The following sections describe how to: o Determine the number of global pagelets and global sections available o Determine the global pagelets and global sections used o Modify the global pagelets parameter o Modify the global sections parameter o Recalculate the global pagelets and global sections parameters to take the new values into account Preparing to Install Digital PHIGS 1-5 Preparing to Install Digital PHIGS 1.5 Installation Procedure Requirements 1.5.3.1 Determining the Global Pagelets and Global Sections Available You can determine the available global pagelets and global sections using the WRITE command with the F$GETSYI lexical function. The following example shows how to display this information on your terminal (the default for SYS$OUTPUT): $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 If the values displayed by the system are greater than the values in Table 1-2, you do not need to increase the values for these parameters. If the value of free global pagelets or global sections is less than the value in Table 1-2, you must increase the parameter values, as described in the following sections. You also can determine the number of global sections available using the following procedure: 1. Invoke the SYSGEN Utility: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE CURRENT 2. Determine the number of global sections available: SYSGEN> SHOW GBLSECTIONS Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- GBLSECTIONS 400 250 20 4095 Sections The first number displayed is the current number of global sections. Compare this number to the number of global sections in use displayed by the OpenVMS Install Utility (see Section 1.5.3.2). 3. Exit from the SYSGEN Utility: SYSGEN> EXIT 1-6 Preparing to Install Digital PHIGS Preparing to Install Digital PHIGS 1.5 Installation Procedure Requirements 1.5.3.2 Determining the Global Pagelets and Global Sections Used To determine the global pagelets and global sections used: 1. Invoke the OpenVMS Install Utility: $ INSTALL :== $INSTALL/COMMAND_MODE $ INSTALL 2. Determine the number of global pagelets and global sections used: INSTALL> LIST/GLOBAL/SUMMARY Summary of Local Memory Global Sections nn Global Sections Used, nnnn/nnnn Global Pagelets Used/Unused INSTALL> EXIT The system displays a summary of the number of global sections used, the number of global pagelets used, and the number of global pagelets available. 3. Exit from the OpenVMS Install Utility: INSTALL> EXIT 1.5.3.3 Modifying the Global Pagelets Parameter To modify the number of global pagelets: 1. If there are fewer than 25,000 pagelets available, modify the GBLPAGES system parameter. You can modify the GBLPAGES parameter by editing the SYS$SYSTEM:MODPARAMS.DAT file. To change a parameter value in this file, delete the current value and enter the new value. (Another way of allocating space is to delete an existing known image with the OpenVMS Install Utility.) To modify GBLPAGES, use ADD_GBLPAGES as shown, where n is the number of global pagelets to add: ADD_GBLPAGES = n Preparing to Install Digital PHIGS 1-7 Preparing to Install Digital PHIGS 1.5 Installation Procedure Requirements ________________________ Note ________________________ When you set the pagelet file quota, you should not use a value that exceeds the amount of pagelet file space available on the system. ______________________________________________________ 2. Exit the editor. 3. Update the GBLPAGES parameter by invoking the AUTOGEN command procedure described in Section 1.5.3.5. 1.5.3.4 Modifying the Global Sections Parameter To modify the number of global sections: 1. If the number of global sections in use plus 75 exceeds the current number of global sections, modify the GBLSECTIONS parameter. You can modify the GBLSECTIONS parameter by editing the SYS$SYSTEM:MODPARAMS.DAT file. To change a parameter value in this file, delete the current value and enter the new value. 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. 3. Update the GBLSECTIONS parameter by invoking the AUTOGEN command procedure described in Section 1.5.3.5. 1.5.3.5 Recalculating the Global Pages and Global Sections Parameters To update the GBLPAGES and GBLSECTIONS parameters, invoke the AUTOGEN command procedure, SYS$UPDATE:AUTOGEN.COM: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT AUTOGEN automatically recalculates the parameters with the values you defined manually. When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. 1-8 Preparing to Install Digital PHIGS Preparing to Install Digital PHIGS 1.5 Installation Procedure Requirements AUTOGEN also automatically adjusts some of the SYSGEN parameters, based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK qualifier on the AUTOGEN command line. For more information about using AUTOGEN, see the OpenVMS System Management Subkit. 1.5.4 Other System Parameters The installation for Digital PHIGS requires that you increase the values of the CLISYMTBL and CTLPAGES system parameters. Once the installation is complete, you can decrease these values to ensure efficient system performance. 1.5.5 User Account Quotas To use Digital PHIGS, you must have an account with an open file limit (FILLM) of at least 20. In addition, if you are using the Ada binding, the FILLM should be set to 2000, and the BYTLM should be set to 200,000. Using the OpenVMS Authorize Utility (AUTHORIZE), you can compare the current values of these quotas with the requirements for Digital PHIGS. The account used in the following example is the SYSTEM account: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> SHOW SYSTEM To change the values of these quotas, use the MODIFY command. For more information, see the OpenVMS System Management Utilities Reference Manual. 1.6 Backing Up Your System Disk Digital recommends that you back up your system disk, before installing any software. Use the backup procedures that are established at your site. For details on performing a backup, see the section on the Backup Utility in the OpenVMS System Management Subkit. Preparing to Install Digital PHIGS 1-9 2 _________________________________________________________________ Installing Digital PHIGS This chapter describes the Digital PHIGS installation procedure and the operations you may need to perform after the installation. For a list of the files and directories created during the installation procedure, see Appendix A. For sample development kit and run-time-only installations, refer to Appendix B. To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again. 2.1 Installation Procedure Before you install Digital PHIGS, Digital recommends that you back up your system disk. Once you have done so, you can begin the installation. The installation takes approximately 5 to 30 minutes, depending on your system configuration. You should not install Digital PHIGS run-time-only Version 5.0 if you have already installed the full development kit of Digital PHIGS Version 5.0. If you do, the installation procedure will overwrite the development kit with the run- time-only kit. To determine which version of Digital PHIGS is currently installed, type the following DCL command: $ ANALYZE/IMAGE/INTERACTIVE HEADER SYS$COMMON:[SYSLIB]PHIGS$RTL Look for the following lines in the resulting display: . . . Image Identification Information Installing Digital PHIGS 2-1 Installing Digital PHIGS 2.1 Installation Procedure image name: "PHIGS$CRTL" image file identification: "APHIGS V5.0 SSB" . . . The procedure for installing Digital PHIGS is: 1. Log in to a privileged account and set your default device and directory to SYS$UPDATE. Digital recommends that you use the system manager's account. Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE 2. Define the destination for the output of the Installation Verification Procedure (IVP) with the following command, replacing node with your node name: $ DEFINE DECW$DISPLAY node::0.0 3. Invoke VMSINSTAL. When you invoke VMSINSTAL, it checks the following: o Whether you are logged in to a privileged account. You should install software from the system manager's account with your default device and directory set to SYS$UPDATE. o The installing account has adequate: Disk space Global pagelets Global sections Account quotas 2-2 Installing Digital PHIGS Installing Digital PHIGS 2.1 Installation Procedure o Whether you have adequate quotas for installation. VMSINSTAL requires the following minimum quota values: ASTLM = 24 BIOLM = 18 BYTLM = 18000 DIOLM = 18 ENQLM = 30 FILLM = 20 See Section 1.5.5 for details on defining this information. o Whether the following conditions exist: - DECnet[TM] network is up and running. - Users are logged in to the system. If VMSINSTAL detects problems, you will be asked whether you want to continue the installation. You should correct these problems before resuming the installation procedure. If you want to continue, type YES. If you want to stop the installation, press Return. To invoke the VMSINSTAL command procedure, enter: $ @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N The VMSINSTAL parameters are: saveset-name The installation name for the component. For the Digital PHIGS development kit, use the name: AXPPHIGS050 For the Digital PHIGS run-time-only kit, use the name: AXPPHIGSRTO050 device-name The name of the device on which you plan to mount the distribution volumes for the Digital PHIGS installation media. The format of the device name is ddcu, where dd is the device code, c is the controller code, and u is the unit number. For example, DKA400 is the device name for a CD-ROM. Installing Digital PHIGS 2-3 Installing Digital PHIGS 2.1 Installation Procedure You do not have to use the console drive to install Digital PHIGS. If you do use the console drive after the installation, you should replace any media you removed from the drive prior to the installation. For CD-ROM media, you must also supply the directory location of the Digital PHIGS save set on the CD-ROM. To obtain this location, see the Software Product Library Master Index that accompanies the CD-ROM distribution kit, or complete the following steps before starting the installation: a. Determine whether the CD-ROM drive is already mounted by entering the command: $ SHOW DEVICE DKA400: If the device is mounted, continue with the next step. If it is not mounted, type the appropriate MOUNT command to mount the CD-ROM, omitting the /FOREIGN qualifier. b. Obtain the directory name by entering the command: $ DIRECTORY DKA400:[000000]*axpphigs*.dir The directory name will be displayed; for example: Directory DKA400:[000000] AXPPHIGS050.DIR;1 (development kit) AXPPHIGSRTO050.DIR;1 (run-time-only kit) c. Obtain the save set name by using a DIRECTORY command specifying the directory file from the previous command. For example, for the development kit, enter: $ DIRECTORY DKA400:[AXPPHIGS050.KIT]*.A For the run-time-only kit, enter: $ DIRECTORY DKA400:[AXPPHIGSRTO050.KIT]*.A OPTIONS N An optional parameter that enables you to access the release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation, because they contain additional information about the installation. 2-4 Installing Digital PHIGS Installing Digital PHIGS 2.1 Installation Procedure Note that there are several other options you can select when you invoke VMSINSTAL: o Auto_answer option (A) This option initially creates a file that contains your answers to VMSINSTALL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system). o Get save set option (G) This option lets you temporarily store product save sets on a magnetic tape or in a disk directory. o File log option (L) This option logs all activity to the terminal during installation. o Alternate root option (R) 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 names, VMSINSTAL prompts you for them later in the installation. VMSINSTAL does not prompt you for any options, however, so be sure to include the desired options on the VMSINSTAL command line. If you specify more than one option, separate the options with commas (for instance, OPTIONS A,N). See the documentation on software installation in the OpenVMS System Management Subkit for detailed information on these options. The following example invokes VMSINSTAL to install the Digital PHIGS development kit from a CD-ROM, and shows the system response: $ @SYS$UPDATE:VMSINSTAL AXPPHIGS050 DKA400 OPTIONS N OpenVMS AXP Software Product Installation Procedure V6.2 It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. Installing Digital PHIGS 2-5 Installing Digital PHIGS 2.1 Installation Procedure If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter YES to continue. To stop the installation process and correct the situation, enter NO or press Return. Then, correct the problem and restart the installation. 4. Check the status of your processes. VMSINSTAL displays a list of all active processes and asks if you want to continue the installation: %VMSINSTAL-W-ACTIVE, The following processes are still active: DECW$SERVER_0 _FTA5: _FTA6: _RTA1: . . . * Do you want to continue anyway [NO]? Y You can install Digital PHIGS even if other processes are running. If you do not wish to continue the installation, press Return. If you wish to continue installing Digital PHIGS, enter YES and press Return. 5. Confirm system backup. * Are you satisfied with the backup of your system disk [YES]? You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, enter NO and press Return to stop the installation. After you back up your system disk, you can restart the installation. In most cases, the distribution media is a CD-ROM that has been mounted before the installation. If this is not the case, refer to your media documentation. 2-6 Installing Digital PHIGS Installing Digital PHIGS 2.1 Installation Procedure 6. Mount the media. If you omitted the device name on the VMSINSTAL command line, the following prompt appears: * Where will the distribution volume be mounted: DKA400: Enter the name of the distribution media device and directory that contains the Digital PHIGS save sets. For example, if the media is contained on a CD-ROM located on unit DKA400:, and the Digital PHIGS save sets are located in the directory AXPPHIGS050.KIT (for the development kit), enter: DKA400:[AXPPHIGS050.KIT] Depending on the type of device and whether the device is already mounted, the following may or may not appear: Please mount the first volume of the set on DKA400 * Are you ready? Y If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. If you respond YES to indicate that you are ready, VMSINSTAL indicates that the media containing Digital PHIGS has been mounted, and then prompts for the product name and any desired installation options: DIGITAL PHIGS DEVELOPMENT KIT Enter the products to be processed from the first distribution volume set. * Products: AXPPHIGS050 * Enter installation options you wish to use (none): The following products will be processed: AXPPHIGS V5.0 Beginning installation of AXPPHIGS V5.0 at hh:mm. %VMSINSTAL-I-RESTORE, Restoring product saveset A... Installing Digital PHIGS 2-7 Installing Digital PHIGS 2.1 Installation Procedure DIGITAL PHIGS RUN-TIME-ONLY KIT Enter the products to be processed from the first distribution volume set. * Products: AXPPHIGSRTO050 * Enter installation options you wish to use (none): The following products will be processed: AXPPHIGSRTO V5.0 Beginning installation of AXPPHIGSRTO V5.0 at hh:mm. %VMSINSTAL-I-RESTORE, Restoring product saveset A... 7. Select a release notes option. This step applies only if you specified OPTIONS N when starting the installation. Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 1 If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C. If you select option 2, VMSINSTAL prompts you for a queue name. Either type a queue name or press Return to send the file to the default output print device: * Queue name [SYS$PRINT]: If you select option 3, VMSINSTAL displays the release notes on the terminal and then prompts you for a queue name for the printed version. After you type a queue name or press Return to send the file to the default output print device, the release notes are copied to: o SYS$HELP:AXPPHIGS050.RELEASE_NOTES (ASCII format) o SYS$HELP:AXPPHIGS050_RELEASE_NOTES.PS (PostScript format) 2-8 Installing Digital PHIGS Installing Digital PHIGS 2.1 Installation Procedure If you select option 4, VMSINSTAL does not display, print, or copy the release notes. ________________________ Note ________________________ This version of the release notes file installed by VMSINSTAL is labeled with the current product name and version number. Be sure not to delete release notes for previous versions of Digital PHIGS. ______________________________________________________ VMSINSTAL then displays the following prompt: * Do you want to continue the installation [N]?: Y %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. If you selected release notes option 4 and now press Return to stop the installation, the release notes are copied to the SYS$HELP directory. If you selected release notes option 4 and now enter YES to continue the installation, the release notes are not copied to this directory. After the installation, you can enter the following command to review the release notes through the Help facility, for example: $ HELP PHIGS RELEASE_NOTES 8. Purge the old Digital PHIGS files. * Do you want to purge files replaced by this installation [YES]? The directories SYS$COMMON:[SYSLIB] and SYS$SYSTEM may contain previous versions of Digital PHIGS files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press Return to purge the files or type NO to keep them. Appendix A lists the files on the system that are added or modified when you install the Digital PHIGS development kit and the run-time-only kit. Installing Digital PHIGS 2-9 Installing Digital PHIGS 2.1 Installation Procedure 9. Respond to license registration queries. Digital PHIGS supports the OpenVMS License Management Facility (LMF). The installation procedure displays license information about your product and then asks if you have registered and loaded your authorization key for Digital PHIGS. The following is an example of this information: DIGITAL PHIGS DEVELOPMENT KIT Product: PHIGS Producer: DEC Version: 5.0 Release Date: 15-APR-1996 * Does this product have an authorization key registered and loaded? Y DIGITAL PHIGS RUN-TIME-ONLY KIT Product: PHIGS-RUNTIME Producer: DEC Version: 5.0 Release Date: 15-APR-1996 * Does this product have an authorization key registered and loaded? Y Your PAK must be registered and loaded for the installation to complete successfully. Therefore, if your PAK is not registered and loaded, you must answer NO to this question, stop the installation, register and load your PAK, and then restart the installation. 10.Install the ACS library containing the PHIGS Ada binding (development kit only). The Digital PHIGS Ada binding requires 20000 blocks of disk space. * Do you wish to install the ACS library containing the PHIGS Ada binding [NO]? Press Return if you do not want to install the ACS library. Type YES if you want to install the ACS library. 11.Install the PHIGS help library (development kit only). * Do you wish to have the help library for PHIGS [YES]? 2-10 Installing Digital PHIGS Installing Digital PHIGS 2.1 Installation Procedure Press Return if you want to install the PHIGS help library. Type NO if you do not want to install the help library. 12.Run the Installation Verification Procedure (IVP). * Do you want to run the IVP after the installation [YES]? Press Return if you want to run the IVP procedure. Type NO if you do not want to run this procedure. 13.Install examples from PHIGS documentation (development kit only). * Do you wish to install the examples from the PHIGS documentation [YES]? Press Return if you want to install the example programs from the Getting Started with DEC PHIGS manual and the DEC PHIGS Developer's Guide. Type NO if you do not want to install the programs. The Digital PHIGS example programs use approximately 2200 blocks and are installed in the PHIGS$EXAMPLES:[...] directories. 14.Install the Japanese PHIGS-related files. This kit contains Japanese-related files. They require Japanese OpenVMS. * Do you wish to install Japanese related files [NO]? If the Japanese version of OpenVMS Alpha is installed on your system, you will be asked if you want to install the Japanese components of Digital PHIGS. Press Return if you do not want to install the Japanese files. Type YES if you do want to install these files. 15.Read the informational messages. At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you requested that files be purged, they are purged at this time. Installing Digital PHIGS 2-11 Installing Digital PHIGS 2.1 Installation Procedure The messages displayed are: DIGITAL PHIGS DEVELOPMENT KIT: STARTING to perform all the installation work. No additional user actions are necessary from this point. The remaining part of the 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 ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set G ... . . . DIGITAL PHIGS RUN-TIME-ONLY KIT: STARTING to perform all the installation work. No additional user actions are necessary from this point. The remaining part of the 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 ... . . . 16.Choose a workstation type. Workstation types supported by Digital PHIGS: 7) CGM 61) PostScript (Black and White) 62) PostScript (Color) 231) Motif 241) Motif/PEX 250) DDIF Enter workstation type [231]: 241 17.Define the connection identifier. Enter the PHIGS connection identifier [DECW$DISPLAY]: 0::0 2-12 Installing Digital PHIGS Installing Digital PHIGS 2.1 Installation Procedure Enter the connection identifier for your workstation and press Return. Digital PHIGS then executes the installation verification procedure and completes installation. DIGITAL PHIGS DEVELOPMENT KIT: Executing SYS$TEST:PHIGS_IVP... If the output of the Installation Verification Procedure looks like the illustration provided with the Digital PHIGS for VMS Installation Guide, the installation was successful. Installation of AXPPHIGS V5.0 completed at hh:mm Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]AXPPHIGS050.VMI_DATA VMSINSTAL procedure done at hh:mm DIGITAL PHIGS RUN-TIME-ONLY KIT: Executing SYS$TEST:PHIGS_IVP... If the output of the Installation Verification Procedure looks like the illustration provided with the Digital PHIGS for VMS Installation Guide, the installation was successful. Installation of AXPPHIGSRTO V5.0 completed at hh:mm Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]AXPPHIGSRTO050.VMI_DATA VMSINSTAL procedure done at hh:mm 18.Run the Installation Verification Procedure (IVP). After Digital PHIGS is installed, you can run the IVP independently to verify that the software is available on your system. You might also need to run the IVP after a system failure to ensure that users can access Digital PHIGS. The installation procedure is complete. You can now install more products or log out. If you removed any media from the console drive before beginning the installation, you should replace it now. Installing Digital PHIGS 2-13 Installing Digital PHIGS 2.1 Installation Procedure 19.Log out of the privileged account. $ LOGOUT SYSTEM logged out at dd-mmm-yyyy hh:mm:ss.ss VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again. 2.2 Error Recovery If errors occur during installation, VMSINSTAL displays failure messages. If the installation procedure fails, one or more of the following messages may also appear: %VMSINSTAL-E-INSFAIL, The installation of AXPPHIGS V5.0 has failed. Digital PHIGS requires OpenVMS V6.2 or a subsequent version of OpenVMS System disk does not contain enough free blocks to install AXPPHIGS Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o A prerequisite software version is incorrect. o Quotas necessary for successful installation are insufficient. o System parameter values for successful installation are insufficient. o The OpenVMS help library is currently in use. o The product license has not been registered and loaded. If the Installation Verification Procedure fails for any reason, the following messages are displayed: AXPPHIGS V5.0 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for AXPPHIGS V5.0 has failed. 2-14 Installing Digital PHIGS Installing Digital PHIGS 2.1 Installation Procedure If you are notified that any of these conditions exist, you should take the appropriate action, as described in the error message. For descriptions of the error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual, your processor-specific installation /operations guide, or the OpenVMS License Management Utility Manual. Installing Digital PHIGS 2-15 3 _________________________________________________________________ After Installing Digital PHIGS The following tasks may be performed after Digital PHIGS installation: o Installing Digital PHIGS on a cluster o Editing the system startup file o Running the Installation Verification Procedure o Determining and reporting problems 3.1 Installing Digital PHIGS on an OpenVMS Alpha Cluster If you want to run Digital PHIGS on multiple nodes of an OpenVMS Alpha cluster, first check to see that you have the appropriate software license. Then, follow these steps after installing Digital PHIGS: 1. Issue the LICENSE LOAD command to activate the license on each node in the cluster on which Digital PHIGS is to be executed. Issue the command as described in the OpenVMS License Management Utility Manual. 2. Run SYS$STARTUP:PHIGS$STARTUP.COM on each node of the cluster that has a software license. Do not purge files during the installation. You can purge these files after you have run the Digital PHIGS startup command procedure on each node of the cluster. 3.2 Editing the Startup File To enable the automatic startup of Digital PHIGS when your system is rebooted, you must include the startup procedure PHIGS$STARTUP.COM in the startup file SYS$MANAGER:SYSTARTUP_VMS.COM. Because Digital PHIGS cannot be started before the network has been started, you must position this new command line after the line that invokes the network startup command procedure. The following example shows the network startup command line followed by the Digital PHIGS startup command line: After Installing Digital PHIGS 3-1 After Installing Digital PHIGS 3.2 Editing the Startup File $ @SYS$MANAGER:STARTNET.COM . . . $ @SYS$STARTUP:PHIGS$STARTUP.COM When you install Digital PHIGS on a cluster, PHIGS$STARTUP.COM is automatically executed for the system node from which the installation was performed. You may need to execute this file for other nodes in the cluster, however, to have the newest Digital PHIGS images installed on those systems. This is particularly true if you purged older versions of Digital PHIGS during the installation. 3.3 Running the Installation Verification Procedure The installation copies the Installation Verification Procedure (IVP) to SYS$SYSTEST. You should run this program after you reboot the system to complete the installation of Digital PHIGS. The IVP verifies that the installation procedure was successfully completed, and ensures the integrity of installed files if system problems occur. To run the IVP separately, enter the following command: $ @SYS$TEST:PHIGS_IVP.COM If the IVP runs successfully, it generates the picture shown in Figure 3-1. If your device produces color output, the image will appear in color. Figure 3-1 Sample IVP Display See the PostScript(R) or Bookreader[TM] version to view the figure. 3.4 Determining and Reporting Problems If you encounter a problem while using Digital PHIGS, report it to Digital. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call Digital if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). 3-2 After Installing Digital PHIGS After Installing Digital PHIGS 3.3 Running the Installation Verification Procedure o Send electronic mail to the "requests@bgsdev.enet.dec.com" account if the problem has to do with the Digital PHIGS documentation. Be sure to include the section and page number of the error. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of warranty. If you encounter a problem during the warranty period, report the problem as described in this section, or follow alternate instructions provided by Digital for reporting SPD nonconformance problems. After Installing Digital PHIGS 3-3 A _________________________________________________________________ Files Installed on Your System During installation, Digital PHIGS installs a number of files on your system. These files are listed in Section A.1 and Section A.2. A.1 Digital PHIGS Development Kit Files Table A-1 lists the files on the system that are added or modified when you install the Digital PHIGS development kit. ----------------------------------------------------------------- Table A-1 Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- PHIGS$EXAMPLES:[ADA]: Ada binding examples ADEMO1.ADA ADEMO2.ADA ADEMO3.ADA ADEMO4.ADA ADEMO5.ADA SHUTLE.DAT PHIGS$EXAMPLES:[BATTLEZONE]: Digital PHIGS Battlezone game BATTLE.HELP Help file BATTLE.MMS BATTLE.OPT BATTLE_CONFIG.H (continued on next page) Files Installed on Your System A-1 Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- BATTLE_DEFS.H BATTLE_EXTERNS.H BATTLE_GPR.C BATTLE_GRAPHICS.C BATTLE_MAIN.C BATTLE_MOVE.C BATTLE_PARSEOPTS.C BATTLE_PHIGS.C BATTLE_SCORES.C BATTLE_STRUCTS.H PHIGS_BATTLE.EXE VMS_UTIL.C PHIGS$EXAMPLES:[DEMO]: Digital PHIGS demo files PHIGS_DEMO_BUILD.COM PHIGS_DEMO_CHANGE_OBJECT_ SIZE.C PHIGS_DEMO_CHANGE_VIEW_ANGLE.C PHIGS_DEMO_CREATE_OBJECT.C PHIGS_DEMO_CREATE_STRUCT.C PHIGS_DEMO_MOVE_VIEW_PLANES.C PHIGS_DEMO_PHIGS.C PHIGS_DEMO_PHIGS.EXE PHIGS_DEMO_PHIGS.H (continued on next page) A-2 Files Installed on Your System Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- PHIGS_DEMO_README.TXT PHIGS_DEMO_README_JP.TXT Japanese PHIGS demo information PHIGS_DEMO_ROTATE_OBJECT.C PHIGS_DEMO_TRANSLATE_OBJECT.C PHIGS$DEMO.ARC PHIGS$EXAMPLES:[DEVELOPERS_GUIDE]: DEC PHIGS Developer's Guide programs DG_ANNO_TEXT.C DG_BUNDLE.C DG_CULL_DIAMOND.C DG_DEPTH_CUE.C DG_EDIT_WHEEL.C DG_EXECUTE_STRUC.C DG_FILL_AREA_SET.C DG_FILL_ATT.C DG_FOUR_WHEELS.C DG_GLOBAL_ROBOT.C DG_HELLO_PHIGS.C DG_HOUSE.C DG_HSV.C DG_INDEX_DATA.C DG_INHERIT.C (continued on next page) Files Installed on Your System A-3 Files Installed on Your System A.1 DigitalPHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- DG_LINE_ATTS.C DG_LOCAL_ROBOT.C DG_MULT_VIEWS.C DG_NURBS.C DG_PERSPECTIVE.C DG_PHIGS_DRAW.C DG_PICKPATH.C DG_QUAD_SPHERE.C DG_REQ_LOC.C DG_RGB.C DG_ROLL_WHEEL.C DG_SEE_VIEW.C DG_SHADE_DIAMOND.C DG_SPECULAR.C DG_STRUCT_ROBOT.C DG_TEXT3.C DG_TEXT_ATT.C DG_WHEEL.C PHIGS$EXAMPLES:[GETTING_STARTED]: Getting Started with DEC PHIGS programs GS_ARCS.C GS_FILL_AREA.C GS_LIGHT.C (continued on next page) A-4 Files Installed on Your System Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- GS_LINE_COLOR.C GS_LINE_TYPES.C GS_LINE_WIDTH.C GS_NAME_SETS.C GS_NURBS.C GS_POLYLINES.C GS_REQUEST.C GS_SAMPLE.FOR GS_SIMPLE.C GS_TEAPOT.C GS_TEXT.C PHIGS$EXAMPLES:[MISC]: CREATE_PHIGS_WIDGET.C CREATE_PHIGS_WIDGET.H CREATE_PHIGS_WINDOW.C CREATE_PHIGS_WINDOW.H ESCAPE_CB.C C binding program ESCAPE_DB.FOR PHIGS$ binding program ESCAPE_FB.FOR Fortran binding program FONTS_HEX.C JPHIGS_CHOICE_CB.C Japanese example files (continued on next page) Files Installed on Your System A-5 Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- JPHIGS_CHOICE_DOL.C JPHIGS_CHOICE_FB.FOR JPHIGS_STRING_CB.C JPHIGS_STRING_DOL.C JPHIGS_STRING_FB.FOR JPHIGS_TEXT_CB.C JPHIGS_TEXT_DOL.C JPHIGS_TEXT_FB.FOR MOTIF_233_243.C MOTIF_2X3.C PHIGS_PREDEF.C PHIGS_PREDEF.EXE PHIGS_PREDEF_BUILD.COM PHIGS_RINGS_3D.FOR Sample programs PHIGS_XDEMO.C PHIGS$EXAMPLES:[UTILS]: FORTRAN_CONVERTER.DAT ISO Fortran binding converter file PHIGS$CONVERTER.EXE SYS$COMMON:[DECW$DEFAULTS.SYSTEM]: GFX_MOTIF.UID GFX_MOTIF_EN.UID GKS_MOTIF_JP.UID (continued on next page) A-6 Files Installed on Your System Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- SYS$COMMON:[SYSHLP.JA_JP]: HELPLIB.HLB SYS$COMMON:[SYSLIB]: PHIGS.H Digital PHIGS include files PHIGS_DEC.H C binding include file PHIGS_DEFS.ADA PHIGS_DEFS.BAS PHIGS_DEFS.FOR PHIGS_DEFS.H PHIGS_DEFS.PAS PHIGS_DEFS.PL2 PHIGS_DEFS.PLI PHIGS_FOR_BND_CONSTS.FOR PHIGS_ISO.H ISO C binding include file PHIGS_MSGS.ADA PHIGS_MSGS.BAS PHIGS_MSGS.FOR PHIGS_MSGS.H PHIGS_MSGS.PAS PHIGS_MSGS.PL2 PHIGS_MSGS.PLI (continued on next page) Files Installed on Your System A-7 Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- PHIGS$ARCHIVE_CONVERTER.EXE Archive converter PHIGS$CGMO_DEV_HANDLER.EXE Device handlers PHIGS$CGMO_DEV_HANDLER_VF.EXE VAX[TM] float executables PHIGS$COLSIX_DEV_HANDLER.EXE PHIGS$COLSIX_DEV_HANDLER_ VF.EXE PHIGS$CRTL.EXE Digital PHIGS executables PHIGS$CRTL_VF.EXE VAX float executables PHIGS$DBM.EXE PHIGS$DBM_VF.EXE PHIGS$DEFS.BAS PHIGS$DEFS.FOR PHIGS$DEFS.H PHIGS$DEFS.PAS PHIGS$DEFS.PL2 PHIGS$DEFS.PLI PHIGS$DDIF_DEV_HANDLER.EXE DDIF[TM] device handler PHIGS$DDIF_DEV_HANDLER_VF.EXE PHIGS$FOR_BND.OLB Fortran binding PHIGS$FOR_BND_CONSTS.FOR (continued on next page) A-8 Files Installed on Your System Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- PHIGS$GLI3D.EXE OpenGL support PHIGS$HPGL_DEV_HANDLER.EXE PHIGS$HPGL_DEV_HANDLER_VF.EXE VAX float executables PHIGS$HPPCL_DEV_HANDLER.EXE PHIGS$HPPCL_DEV_HANDLER_VF.EXE PHIGS$I3D.EXE PHIGS$I3D_VF.EXE PHIGS$ISO_CRTL.EXE PHIGS$ISO_CRTL_VF.EXE PHIGS$MOTIF_DEV_HANDLER.EXE PHIGS$MOTIF_DEV_HANDLER_VF.EXE PHIGS$MSGS.BAS Message files PHIGS$MSGS.FOR PHIGS$MSGS.H PHIGS$MSGS.PAS PHIGS$MSGS.PL2 PHIGS$MSGS.PLI PHIGS$PS_DEV_HANDLER.EXE PHIGS$PS_DEV_HANDLER_VF.EXE PHIGS$REGIS_DEV_HANDLER.EXE PHIGS$REGIS_DEV_HANDLER_VF.EXE PHIGS$RTL.EXE PHIGS$RTL_VF.EXE (continued on next page) Files Installed on Your System A-9 Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- PHIGS$SIXEL_DEV_HANDLER.EXE PHIGS$SIXEL_DEV_HANDLER_VF.EXE PHIGS$TRACE.EXE Digital PHIGS tracer PHIGS$TRACE_VF.EXE Digital PHIGS tracer, VAX float PHIGS$WSIM.EXE PHIGS$WSIM_VF.EXE PHIGS$WSM.EXE PHIGS$WSM_VF.EXE VAXGFX$DDIF_COLOR_TABLE.DAT DDIF device handler color table VAXGFX$FONT_J0102.FNT VAXGFX$FONT_JISX0201.FNT VAXGFX$FONT_JISX0208.FNT VAXGFX$FONT_NEG01.FNT Stroke fonts 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 (continued on next page) A-10 Files Installed on Your System Files Installed on Your System A.1 Digital PHIGS Development Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- 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 SYS$HELP: AXPPHIGS050.RELEASE_NOTES AXPPHIGS050_RELEASE_NOTES.PS HELPLIB.HLB (continued on next page) Files Installed on Your System A-11 Files Installed on Your System A.2 Digital PHIGS Run-Time-Only Kit Files ----------------------------------------------------------------- Table A-1 (Cont.) Installed Files for the Digital PHIGS Development Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- SYS$MESSAGE: PHIGS$MSGS.EXE VAXGFX$MSGS.EXE SYS$STARTUP: PHIGS$STARTUP.COM SYS$TEST: PHIGS_IVP.COM PHIGS_IVP.EXE ----------------------------------------------------------------- A.2 Digital PHIGS Run-Time-Only Kit Files Table A-2 lists the files on the system that are added or modified when you install the Digital PHIGS run-time-only kit. ----------------------------------------------------------------- Table A-2 Installed Files for the Digital PHIGS Run-Time-Only Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- SYS$COMMON:[DECW$DEFAULTS.SYSTEM]: GFX_MOTIF.UID GFX_MOTIF_EN.UID GKS_MOTIF_JP.UID SYS$HELP: AXPPHIGS050.RELEASE_NOTES AXPPHIGS050_RELEASE_NOTES.PS (continued on next page) A-12 Files Installed on Your System Files Installed on Your System A.2 Digital PHIGS Run-Time-Only Kit Files ----------------------------------------------------------------- Table A-2 (Cont.) Installed Files for the Digital PHIGS Run-Time-Only Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- SYS$COMMON:[SYSHLP.JA_JP]: HELPLIB.HLB SYS$COMMON:[SYSLIB]: PHIGS$ARCHIVE_CONVERTER.EXE Archive converter PHIGS$CGMO_DEV_HANDLER.EXE Device handler files PHIGS$CGMO_DEV_HANDLER_VF.EXE VAX float executables PHIGS$COLSIX_DEV_HANDLER.EXE PHIGS$COLSIX_DEV_HANDLER_ VF.EXE PHIGS$CRTL.EXE Digital PHIGS executables PHIGS$CRTL_VF.EXE VAX float executables PHIGS$DBM.EXE PHIGS$DBM_VF.EXE PHIGS$DDIF_DEV_HANDLER.EXE DDIF device handler PHIGS$DDIF_DEV_HANDLER_VF.EXE PHIGS$GFXRTL.EXE PHIGS$GFXRTL_VF.EXE PHIGS$GLI3D.EXE OpenGL support PHIGS$HPGL_DEV_HANDLER.EXE PHIGS$HPGL_DEV_HANDLER_VF.EXE (continued on next page) Files Installed on Your System A-13 Files Installed on Your System A.2 Digital PHIGS Run-Time-Only Kit Files ----------------------------------------------------------------- Table A-2 (Cont.) Installed Files for the Digital PHIGS Run-Time-Only Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- PHIGS$HPPCL_DEV_HANDLER.EXE PHIGS$HPPCL_DEV_HANDLER_VF.EXE PHIGS$I3D.EXE PHIGS$I3D_VF.EXE PHIGS$ISO_CRTL.EXE PHIGS$ISO_CRTL_VF.EXE PHIGS$MOTIF_DEV_HANDLER.EXE PHIGS$MOTIF_DEV_HANDLER_VF.EXE PHIGS$PS_DEV_HANDLER.EXE PHIGS$PS_DEV_HANDLER_VF.EXE PHIGS$REGIS_DEV_HANDLER.EXE PHIGS$REGIS_DEV_HANDLER_VF.EXE PHIGS$RTL.EXE PHIGS$RTL_VF.EXE PHIGS$SIXEL_DEV_HANDLER.EXE PHIGS$SIXEL_DEV_HANDLER_VF.EXE PHIGS$TRACE.EXE PHIGS$TRACE_VF.EXE PHIGS$WSIM.EXE PHIGS$WSIM_VF.EXE PHIGS$WSM.EXE PHIGS$WSM_VF.EXE (continued on next page) A-14 Files Installed on Your System Files Installed on Your System A.2 Digital PHIGS Run-Time-Only Kit Files ----------------------------------------------------------------- Table A-2 (Cont.) Installed Files for the Digital PHIGS Run-Time-Only Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- VAXGFX$DDIF_COLOR_TABLE.DAT DDIF device handler color table VAXGFX$FONT_J0102.FNT VAXGFX$FONT_JISX0201.FNT VAXGFX$FONT_JISX0208.FNT VAXGFX$FONT_NEG01.FNT Stroke fonts 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 VAXGFX$FONT_NEG15.FNT VAXGFX$FONT_NEG16.FNT VAXGFX$FONT_NEG17.FNT VAXGFX$FONT_NEG18.FNT VAXGFX$FONT_NEG19.FNT (continued on next page) Files Installed on Your System A-15 Files Installed on Your System A.2 Digital PHIGS Run-Time-Only Kit Files ----------------------------------------------------------------- Table A-2 (Cont.) Installed Files for the Digital PHIGS Run-Time-Only Kit ----------------------------------------------------------------- Directory File Name Description ----------------------------------------------------------------- VAXGFX$FONT_NEG20.FNT VAXGFX$FONT_NEG21.FNT VAXGFX$FONT_NEG22.FNT VAXGFX$FONT_NEG23.FNT VAXGFX$FONT_NEG24.FNT SYS$MESSAGE: PHIGS$MSGS.EXE VAXGFX$MSGS.EXE SYS$STARTUP: PHIGS$STARTUP.COM SYS$TEST: PHIGS_IVP.COM PHIGS_IVP.EXE ----------------------------------------------------------------- A-16 Files Installed on Your System B _________________________________________________________________ Sample Installations This appendix provides sample installations of the development and run-time-only kits. B.1 Digital PHIGS Development Kit Installation This section contains a sample installation of the Digital PHIGS development kit. $ @VMSINSTAL AXPPHIGS050 OpenVMS AXP Software Product Installation Procedure V6.2 It is 23-OCT-1996 at 10:17. Enter a question mark (?) at any time for help. VMSINSTAL-W-ACTIVE, The following processes are still active: DECW$SERVER_0 _FTA5: _FTA6: _RTA1: * Do you want to continue anyway [NO]? Y * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: AXPPHIGS V5.0 Beginning installation of AXPPHIGS V5.0 at 10:17 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: * Queue name [sys$print]: * Do you want to continue the installation [NO]? Y Sample Installations B-1 Sample Installations B.1 Digital PHIGS Development Kit Installation %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. * Do you want to purge files replaced by this installation [YES]? Product: PHIGS Producer: DEC Version: 5.0 Release Date: 15-APR-1996 * Does this product have an authorization key registered and loaded? Y The Digital PHIGS Ada binding requires 20000 blocks of disk space. * Do you wish to install the ACS library containing the PHIGS Ada binding [NO]? Y * Do you wish to have the help library for PHIGS [YES]? * Do you want to run the IVP after the installation [YES]? * Do you wish to install the examples from the PHIGS documentation [YES]? This kit contains Japanese-related files. They require Japanese OpenVMS. Since SYS$LIBRARY:JSYSHR.EXE is not present, Japanese-related components will not be installed at this time. STARTING to perform all the installation work. No additional user actions are necessary from this point. The remaining part of the installation will take 5 - 20 minutes depending on your CPU. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set G ... B-2 Sample Installations Sample Installations B.1 Digital PHIGS Development Kit Installation WARNING: In order to update the Digital PHIGS Ada binding, all the files from the Digital PHIGS Ada ACS library in the system directory [SYSLIB.PHIGS_ADA] will be deleted and replaced with files from this kit. System Manager: Upon completion of this installation, please be sure to edit the system startup file and add the following line: $ @SYS$STARTUP:PHIGS$STARTUP.COM If you have a button or dial box connected to your workstation, edit the system file SYS$STARTUP:VMS$LPBEGIN-050_STARTUP.COM (refer to the release notes for details) and add the following line: $ @SYS$STARTUP:PCM$STARTUP.COM A copy of the Installation Verification Procedure has been put in SYS$TEST:PHIGS_IVP.COM. If you are installing Digital PHIGS on a 3D workstation and use a PEX workstation type, you need to restart the DECwindows server after the installation with the following line: $ @SYS$STARTUP:DECW$STARTUP.COM RESTART PHIGS demo programs, along with their sources have been put in: PHIGS$EXAMPLES:[DEMO] - PHIGS_DEMO_PHIGS example PHIGS$EXAMPLES:[DEVELOPERS_GUIDE] - Examples from the DEC PHIGS Developer's Guide PHIGS$EXAMPLES:[GETTING_STARTED] - Examples from the "Getting Started with DEC PHIGS" manual PHIGS$EXAMPLES:[MISC] - Assorted other PHIGS examples PHIGS$EXAMPLES:[ADA] - Assorted PHIGS Ada examples PHIGS$EXAMPLES:[UTILS] - Assorted utilities. To complete the installation of the Digital PHIGS Ada binding, please issue the following commands: Sample Installations B-3 Sample Installations B.1 Digital PHIGS Development Kit Installation $ ACS SET LIBRARY SYS$COMMON:[SYSLIB.PHIGS_ADA] $ ACS ENTER FOREIGN/REPLACE - SYS$COMMON:[SYSLIB.PHIGS_ADA]PHIGS$ADA.OLB/LIBRARY - PHIGS_INTERNALS_C %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Workstation types supported by Digital PHIGS: 7) CGM 61) PostScript (Black and White) 62) PostScript (Color) 231) Motif 241) Motif/PEX 250) DDIF Enter workstation type [231]: 241 Enter the PHIGS connection identifier [DECW$DISPLAY]: 0::0 Please ignore any messages about incorrect title size Executing SYS$TEST:PHIGS_IVP... If the output of the Installation Verification Procedure looks like the illustration provided with the Digital PHIGS for VMS Installation Guide, the installation was successful. Installation of AXPPHIGS V5.0 completed at 12:09 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]AXPPHIGS050.VMI_DATA VMSINSTAL procedure done at 12:09 B-4 Sample Installations Sample Installations B.2 Digital PHIGS Run-Time-Only Kit Installation B.2 Digital PHIGS Run-Time-Only Kit Installation This section contains a sample Digital PHIGS run-time-only kit installation. $ @VMSINSTAL AXPPHIGSRTO050 OpenVMS AXP Software Product Installation Procedure V6.2 It is 23-OCT-1996 at 08:07. Enter a question mark (?) at any time for help. VMSINSTAL-W-ACTIVE, The following processes are still active: DECW$SERVER_0 _FTA5: _FTA6: _RTA1: * Do you want to continue anyway [NO]? Y * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: AXPPHIGSRTO V5.0 Beginning installation of AXPPHIGSRTO V5.0 at 08:08 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. * Do you want to purge files replaced by this installation [YES]? Product: PHIGS-RUNTIME Producer: DEC Version: 5.0 Release Date: 15-APR-1996 * Does this product have an authorization key registered and loaded? Y Sample Installations B-5 Sample Installations B.2 Digital PHIGS Run-Time-Only Kit Installation * Do you want to run the IVP after the installation [YES]? This kit contains Japanese-related files. They require Japanese OpenVMS. Since SYS$LIBRARY:JSYSHR.EXE is not present, Japanese-related components will not be installed at this time. STARTING to perform all the installation work. No additional user actions are necessary from this point. The remaining part of the installation will take 5 - 20 minutes depending on your CPU. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... System Manager: Upon completion of this installation, please be sure to edit the system startup file and add the following line: $ @SYS$STARTUP:PHIGS$STARTUP.COM If you have a button or dial box connected to your workstation, edit the system file SYS$STARTUP:VMS$LPBEGIN-050_STARTUP.COM (refer to the release notes for details) and add the following line: $ @SYS$STARTUP:PCM$STARTUP.COM A copy of the Installation Verification Procedure has been put in SYS$TEST:PHIGS_IVP.COM. If you are installing Digital PHIGS on a 3D workstation and use a PEX workstation type, you need to restart the DECwindows server after the installation with the following line: $ @SYS$STARTUP:DECW$STARTUP.COM RESTART %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright Digital Equipment Corporation 1988, 1996. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. B-6 Sample Installations Sample Installations B.2 Digital PHIGS Run-Time-Only Kit Installation This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Workstation types supported by Digital PHIGS: 7) CGM 61) PostScript (Black and White) 62) PostScript (Color) 231) Motif 241) Motif/PEX 250) DDIF Enter workstation type [231]: 241 Enter the PHIGS connection identifier [DECW$DISPLAY]: 0::0 Please ignore any messages about incorrect title size Executing SYS$TEST:PHIGS_IVP... If the output of the Installation Verification Procedure looks like the illustration provided with the Digital PHIGS for VMS Installation Guide, the installation was successful. Installation of AXPPHIGSRTO V5.0 completed at 10:10 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]AXPPHIGSRTO050.VMI_DATA VMSINSTAL procedure done at 10:11 Sample Installations B-7