Compaq_Pascal_______________________________________ Installation Guide for OpenVMS Order Number: AA-PXSPC-TK June 1999 This guide explains how to install the Compaq Pascal compiler and related software components on an OpenVMS Alpha or OpenVMS VAX system. Revision/Update Information: This is a updated guide. Operating System: OpenVMS Alpha Version 6.1 or higher. OpenVMS VAX Version 5.5 or higher. Future maintenance releases may require higher versions. Software Version: Compaq Pascal Version 5.7 Compaq Computer Corporation Houston, Texas ________________________________________________________________ June 1999 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 1999. All Rights Reserved. COMPAQ, the Compaq logo and the DIGITAL logo Registered in the U.S. Patent and Trademark Office. Bookreader, Compaq Pascal, DEC, DEC Ada, DEC C, DECdocument, Debugger, DECnet, DECset, DECstation, DECthreads, DIGITAL, DIGITAL Fortran, DIGITAL FUSE, DIGITAL Ladebug, Digital UNIX, OpenVMS, Tru64 UNIX, ULTRIX, VAX, VAXcluster, VAX DOCUMENT, VMScluster are trademarks of Compaq Computer Corporation.) ZK6141 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ______________________________________________________________ Contents ................................................... v Preparing to Install Compaq Pascal 1.1 Required Operating System Components.......... 1-1 1.2 Optional Software............................. 1-2 1.3 License Registration.......................... 1-2 1.4 Multiple Version Support...................... 1-3 1.5 Installation Procedure Requirements........... 1-4 1.5.1 Installation Account Privileges and Disk Space..................................... 1-4 1.5.2 System Parameters......................... 1-6 1.5.2.1 Calculating the Values for GBLPAGES and GBLSECTIONS............................. 1-8 1.5.2.2 Changing System Parameter Values with AUTOGEN................................. 1-8 1.5.3 Backing Up Your System Disk............... 1-11 1.6 Stopping the Installation..................... 1-11 1.6.1 Reader's Comments......................... 1-11 Installing Compaq Pascal 2.1 Installation Procedure........................ 2-1 2.2 Error Recovery................................ 2-13 iii 3 After Installing Compaq Pascal 3.1 Running the Installation Verification Procedure (IVP) Separately.................... 3-1 3.2 User Account Requirements..................... 3-1 3.2.1 Privileges................................ 3-2 3.2.2 Quotas.................................... 3-2 3.3 Editing System Files.......................... 3-2 3.4 Enhancing Compaq Pascal Performance........... 3-2 3.4.1 Using Multiple Environment Files On OpenVMS VAX systems only.................. 3-2 3.4.2 Installing Compaq Pascal as a Shared Image..................................... 3-3 3.4.3 Improving Compaq Pascal Compilation Performance on OpenVMS Alpha Systems...... 3-3 3.4.3.1 Required Virtual Memory................. 3-6 3.4.3.2 Required Physical Memory................ 3-7 3.4.3.3 Effects of Physical Memory.............. 3-9 3.5 Determining and Reporting Problems............ 3-9 A Sample Installation Tables 1-1 Disk Space Requirements................... 1-4 iv _________________________________________________________________ Preface This guide explains how to: o Install Compaq Pascal on OpenVMS Alpha or OpenVMS VAX o Read the online release notes This guide applies to Compaq Pascal Version 5.7 and all subsequent maintenance releases up to the next major product release. Intended Audience This guide is intended for the system manager who installs Compaq Pascal. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall Compaq Pascal for any other reason. Document Structure This guide contains the following chapters: o Chapter 1 describes the hardware and software requirements for Compaq Pascal installation and related procedures that you complete before installation. o Chapter 2 describes the Compaq Pascal installation procedure. o Chapter 3 describes the Compaq Pascal Installation Verification Procedure (IVP) and any postinstallation procedures you must complete to use Compaq Pascal. ( o Appendix A contains a sample Compaq Pascal installation and the IVP.) v Associated Documents In addition to this guide, the Compaq Pascal documentation set includes the following books: o Compaq Pascal User Manual for OpenVMS o Compaq Pascal Language Reference Manual For general information on OpenVMS system management, see the OpenVMS operating system documentation set. For help understanding OpenVMS system error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. vi Conventions This guide uses the following documentation conventions: vii viii ___________________________________________________________ Convention____________Meaning______________________________ $ The dollar sign ($) is the default DCL prompt. In code examples, an enclosed symbol indicates that you must press the named key on the keyboard. Ctrl/Y In interactive examples, this symbol indicates that you must press the Ctrl key while you simultaneously press another key (in this case, Y). Username: In interactive examples, prompts or @SYS$UPDATE:VMSINSTAL displayed text appears in a monospace font. User input appears in bold monospace font. UPPERCASE In syntax descriptions and interactive examples, uppercase letters indicate the name of a command, a file, a parameter, a procedure, or a utility. lowercase Lowercase letters indicate variable information such as a file name or a device name. file-spec,... Horizontal ellipses indicate that you can enter additional parameters, values, or information. [YES] Square brackets indicate that the enclosed item is a default value in a VMSINSTAL prompt. Also, square brackets serve as delimiters for a directory name in a file specification. VMS system All references to VMS system refer to the OpenVMS Alpha or the OpenVMS VAX operating system. On OpenVMS Alpha This guide uses labels to indicate systems only information that applies to one or On OpenVMS VAX more platforms. systems only n In some code examples, version numbers are given as n. When you install Compaq Pascal, the actual version numbers appear on your ______________________screen.____________________________ix Unless otherwise noted, press the Return key after entering commands and responses to command prompts. x 1 _________________________________________________________________ Preparing to Install Compaq Pascal This chapter discusses the preparations and requirements necessary for installing Compaq Pascal Version 5.7. Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Compaq representative. Compaq Pascal provides online release notes, which are copied to the following file during installation: SYS$HELP:PASCAL05n.RELEASE_NOTES Compaq strongly recommends that you read the release notes before proceeding with the installation. For information on accessing the online release notes, see Section 2.1. Your distribution kit includes a "Read First" cover letter. Please read this cover letter for information that is important for you to know before installing Compaq Pascal. This information may not be included in this installation guide or in the release notes. 1.1 Required Operating System Components Compaq Pascal Version 5.7 requires OpenVMS Alpha Version 6.1 or higher, or OpenVMS VAX Version 5.5 or higher. Future Compaq Pascal releases may require higher versions of the OpenVMS operating system, as described in the online release notes or the Read First cover letter for your operating system. The OpenVMS operating system comes with a variety of support options or components. Preparing to Install Compaq Pascal 1-1 1.2 Optional Software The following is a list of optional software that you can use with Compaq Pascal: o Oracle CDD/Repository o DECset 1.3 License Registration You must register the Compaq Pascal license through the OpenVMS License Management Facility (LMF) in accordance with the license agreement signed by your site. The license registration information you need is contained in the Product Authorization Key (PAK) that is shipped with Compaq Pascal if you ordered the license and media together; otherwise, the PAK is shipped separately to a location based on your license order. The PAK is a paper certificate that contains information about the license to run a particular piece of software. If you are installing Compaq Pascal as an update on a node or cluster that is licensed for this software, you have already completed the License PAK registration requirements. During the installation, the system asks whether you have registered the Compaq Pascal license and loaded the appropriate PAK. Before you start the installation, you must register and load your license for Compaq Pascal to be able to run the Installation Verification Procedure (IVP) and for users to be able to run Compaq Pascal. To register a license, first log in to the system manager's account (username: SYSTEM). You then have a choice of two ways to perform the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. 1-2 Preparing to Install Compaq Pascal o At the DCL prompt ($), enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. For complete information on using LMF, see the manual on the License Management Utility in the OpenVMS documentation set. 1.4 Multiple Version Support Compaq Pascal provides support for using multiple versions of the compliler on the same OpenVMS system. During installation, you have the opportunity to save the current version of the compiler for later use. If chosen, the installation copies the current compiler before installing the new compiler. The kit provides 3 command files to display and control which Compaq Pascal compiler is used. o SYS$SYSTEM:PASCAL$SHOW_VERSIONS.COM is used to display all Compaq Pascal compilers saved on the system and their version numbers. It also shows the current settings for process, job, group, and system-wide compiler settings. This command file has no parameters. o SYS$SYSTEM:PASCAL$SET_VERSION.COM is used to select a Compaq Pascal compiler other than SYS$SYSTEM:PASCAL.EXE. If invoked without parameters, it will display the currently available compilers and ask for a filename to use for the process-wide compiler setting. It has 2 optional parameters. The first parameter can be PROCESS, JOB, GROUP, or SYSTEM. This selects the level of visibility for the selected compiler. The second parameter can be a filename to use instead of being prompted for a file. This allows you to place a compiler selection in a LOGIN.COM or some other command file. All saved compilers are located in SYS$SYSTEM:. o SYS$SYSTEM:PASCAL$DEFAULT_VERSION.COM is used to select the default Compaq Pascal compiler when SYS$SYSTEM:PASCAL$SET_VERSION.COM has not be used. The installation always provides a new SYS$SYSTEM:PASCAL.EXE and copies existing compilers. You can use this command file to select one of the saved compilers to be SYS$SYSTEM:PASCAL.EXE and rename Preparing to Install Compaq Pascal 1-3 the existing SYS$SYSTEM:PASCAL.EXE for later use via SYS$SYSTEM:PASCAL$SET_VERSION.COM. 1.5 Installation Procedure Requirements The installation of Compaq Pascal takes approximately 5 to 45 minutes, depending on your system configuration. 1.5.1 Installation Account Privileges and Disk Space To install Compaq Pascal, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV ________________________ Note ________________________ VMSINSTAL turns off the BYPASS privilege at the start of the installation. ______________________________________________________ Compaq Pascal's requirements for free disk storage space are different during installation and after installation. Table 1-1 summarizes the storage requirements. Table_1-1__Disk_Space_Requirements_________________________ Number of Blocks Required During After Kit_____________________Installation__Installation_________ Compaq Pascal Version 17,000 16,500 5.7 On OpenVMS Alpha systems only (continued on next page) 1-4 Preparing to Install Compaq Pascal Table_1-1_(Cont.)_Disk_Space_Requirements__________________ Number of Blocks Required During After Kit_____________________Installation__Installation_________ Compaq Pascal Run-Time 500 500 Library on OpenVMS Alpha systems only and only when that kit is newer than the installed version Compaq Pascal Version 3,500 3,000 5.7 On OpenVMS VAX systems only Compaq Pascal STARLET 11,500 10,000 files Compaq_Pascal_examples___150___________150_________________ Preparing to Install Compaq Pascal 1-5 To determine the number of free disk blocks on the current system disk, enter the following DCL command: $ SHOW DEVICE SYS$SYSDEVICE ________________________ Note ________________________ The Compaq Pascal STARLET files (STARLET.PAS, PASCAL$xxxROUTINES.PAS, and so on) are built during the Compaq Pascal installation from a file shipped with the OpenVMS operating system kit. This allows the same Compaq Pascal kit to produce STARLET files that reflect the version of OpenVMS being used on the system. Since updating the version of OpenVMS may add new definitions, the peak and net block count requirements for installing Compaq Pascal (see Table 1-1) may not always be accurate. The values in Table 1-1 are meant to accommodate the larger definition files. ______________________________________________________ 1.5.2 System Parameters Installing Compaq Pascal requires certain system parameter settings. The minimum number of free global pagelets (512- byte subpage unit) and global sections needed for the installation depends on whether SYS$SYSTEM:PASCAL.EXE was previously installed as a shared image, as follows: o If not previously installed as a shared image: - One global section and a sufficient number of contiguous free global pagelets to contain the file SYS$LIBRARY:DCLTABLES.EXE. o If previously installed as a shared image or will be subsequently installed with the PASCAL$STARTUP command file (Section 3.4.2) - Two global sections and a sufficient number of contiguous free global pagelets to contain the file SYS$LIBRARY:DCLTABLES.EXE. 1-6 Preparing to Install Compaq Pascal - 8,500 additional global pagelets on OpenVMS Alpha systems. - 1,500 additional global pagelets on OpenVMS VAX systems. These values represent the number of free global pagelets and global sections required for the installation, not the total number you need to run your system and other software. Preparing to Install Compaq Pascal 1-7 ________________________ Note ________________________ If you do not ensure that your system has the necessary global pagelets and global section SYSGEN parameters for the installation, the DCL tables can become corrupted in some situations. ______________________________________________________ 1.5.2.1 Calculating the Values for GBLPAGES and GBLSECTIONS To install and run Compaq Pascal, you must have sufficient free contiguous global pagelets and global sections. To determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE, enter the following DCL command: $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pagelets for the file. To find the number of free contiguous global pagelets and free global sections, use the WRITE command with the F$GETSYI lexical function. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT): $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 If the value of free global pagelets or global sections is less than the required value (see Section 1.5.2), you must increase the system parameter setting. Section 1.5.2.2 describes the procedures for increasing these values using AUTOGEN. 1.5.2.2 Changing System Parameter Values with AUTOGEN If you do not have enough free global pagelets or free global sections to install Compaq Pascal, you can do either of the following: o Delete an existing known image using the OpenVMS Install Utility. 1-8 Preparing to Install Compaq Pascal o Use the AUTOGEN command procedure to increase the GBLPAGES or GBLSECTIONS system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file: SYS$SYSTEM:MODPARAMS.DAT To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value. To add a new parameter, insert a line in the file that includes both the name of the parameter and its value. For example: WSMAX = 1024 To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use ADD_. The following example increases the global pagelet setting by 2000: ADD_GBLPAGES = 2000 ________________________ Note ________________________ When you set the page file quota, do not use a value that exceeds the amount of page file space available on the system. ______________________________________________________ After you make all your changes, exit from the editor and then execute the AUTOGEN procedure to recalculate your system parameters. Enter the following command at the DCL prompt to recalculate your system parameters and to reboot the system: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT When you specify REBOOT, AUTOGEN does an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect. Preparing to Install Compaq Pascal 1-9 AUTOGEN 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-10 Preparing to Install Compaq Pascal 1.5.3 Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Compaq recommends that you do a system disk backup before installing Compaq Pascal or any other software. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the OpenVMS system management documentation. 1.6 Stopping the Installation To stop the installation procedure at any time, use Ctrl/C. However, files created up to that point are not deleted. You must then delete these files interactively. Chapter 2 lists the directories and files created during the Compaq Pascal installation. 1.6.1 Reader's Comments Compaq appreciates your comments. If you find errors or want to comment about this manual, please send the manual title, order number, and your comments by one of the following methods: o Electronic Internet mail: pascal_docs@bookie.enet.dec.com o Fax: 603-884-0120 Attn: Languages Documentation, ZKO2-3/K35 o A letter sent to the following address: Compaq Computer Corporation Languages Documentation, ZKO2-3/K35 110 Spit Brook Road Nashua, NH 03062-2698 USA Preparing to Install Compaq Pascal 1-11 2 _________________________________________________________________ Installing Compaq Pascal This chapter explains how to install Compaq Pascal: o Section 2.1 contains a step-by-step description of the installation procedure. o Section 2.2 describes error recovery considerations. For a sample Compaq Pascal installation, see Appendix A. 2.1 Installation Procedure The Compaq Pascal installation procedure consists of a series of questions and informational messages. See Appendix A for a sample Compaq Pascal installation. If you have not already done so, insert the Compact Disc (CD) or tape media into the CD drive or tape drive. 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. When the system prompts you with a question during the installation procedure, the default answer, if any, is enclosed in brackets ([]). To start the installation: 1. Invoke the VMSINSTAL command procedure. You should invoke the VMSINSTAL command procedure from privileged account, such as the SYSTEM account. The VMSINSTAL procedure is in the SYS$UPDATE directory. For example: Installing Compaq Pascal 2-1 Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE $ @SYS$UPDATE:VMSINSTAL (saveset-name) (device-name) [option-list] 2-2 Installing Compaq Pascal The following list defines the elements of the VMSINSTAL procedure: saveset-name The installation name for the component. For Compaq Pascal, use the following installation name: PASCAL05n To obtain the directory location of the Compaq Pascal saveset on the CD, refer to the OpenVMS Alpha Layered Products Disc User's Guide that accompanies the CD distribution kit. Or, you can do the following before starting the installation: o To determine whether the CD drive is already mounted, enter the following command: $ SHOW DEVICE DKA400: If it is not mounted, enter the appropriate MOUNT command to mount the CD (omit the /FOREIGN qualifier). o To obtain the directory name, enter the following command: $ DIRECTORY DKA400:[000000]*pascal*.dir Directory DKA400:[000000] PASCAL05n.DIR;1 o To obtain the saveset name, use the DIRECTORY command specifying the directory file from the previous command: $ DIRECTORY DKA400:[PASCAL05n.KIT]*.A device-name The name of the device on which you plan to mount the media and the directory containing the Compaq Pascal save set. In the following example, the device name is DKA400: and the directory is [PASCAL05n.KIT]. For tape installations, just enter the name of the tape device. To specify the device name on the @VMSINSTAL command line, enter: DKA400:[PASCAL05n.KIT] Installing Compaq Pascal 2-3 DKA400: is the name of the CD drive used in the rest of the examples in this guide. option-list The word OPTIONS followed by one or more of the following option designators: A, L, N, R. Their meanings are as follows: o Auto_answer option (A) Initially creates a file that contains your answers to VMSINSTAL 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 File log option (L) Logs all activity to the terminal during installation. o Display or print the release notes (N) Indicates that you want to see the installation question on 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 in case they contain additional information about the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N. ________________________ Note ________________________ Even if you omit the N option when you invoke VMSINSTAL, the Compaq Pascal release notes are copied automatically to the SYS$HELP directory. ______________________________________________________ o Alternate root option (R) Allows you to install the product to a system root other than that of the running system. For detailed information on these VMSINSTAL options, see the OpenVMS documentation on software installation in the OpenVMS System Management Subkit. 2-4 Installing Compaq Pascal If you specify multiple options, use commas to separate the options, for example: OPTIONS A,N When you invoke VMSINSTAL, it checks the following: o Whether you are logged in to a privileged account Compaq recommends that you install software from the system manager's account with your default device and directory set to SYS$UPDATE. o Whether you have sufficient quotas for installation This following example invokes VMSINSTAL to install Compaq Pascal and shows the system response. This example uses the OPTIONS N release note option. $ @SYS$UPDATE:VMSINSTAL PASCAL05n DKA400:[PASCAL05n.kit] OPTIONS N OpenVMS Software Product Installation Procedure Vn.n It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. If you do not supply the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include whatever option you want on the VMSINSTAL command line. 2. Confirm system backup. * Are you satisfied with the backup of your system disk [YES]? VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press the Return key. Otherwise, enter NO to discontinue the installation. After you back up your system disk, you can restart the installation. If you fail to include the device name of the VMSINSTAL command line, the following prompt is displayed: * Where will the distribution volumes be mounted: If this prompt is displayed, type the name of the distribution (media) device and directory that contains Installing Compaq Pascal 2-5 the Compaq Pascal kit (save set). For example, if the media is contained on a CD located on unit DKA400:, type DKA400:[PASCAL05n.KIT] in reply to this question, as shown in the following example: * Where will the distribution volumes be mounted:DKA400:[PASCAL05n.KIT] 2-6 Installing Compaq Pascal 3. Verify the product being installed. The following products will be processed: PASCAL V5.n Beginning installation of PASCAL V5.n at hh:mm %VMSINSTAL-I-RESTORE, Restoring product saveset A... The product name and version are displayed. The first save set (A) is restored to a subdirectory of SYS$UPDATE. 4. Select a release notes option. Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the four options for reviewing the release notes: o 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. o If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: You can then enter a queue name or press Return to send the file to the default output print device. o If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version of the release notes. Installing Compaq Pascal 2-7 o If you choose option 4, the release notes are not displayed or printed but are still copied to the following file in the SYS$HELP directory: SYS$HELP:PASCAL05n.RELEASE_NOTES 2-8 Installing Compaq Pascal You can later use the HELP command to find the location of the release notes in the Help facility: $ HELP PASCAL RELEASE_NOTES Whichever option you choose, VMSINSTAL next asks the following question: * Do you want to continue the installation [NO]?: YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. To continue the installation, enter YES. Otherwise, press Return. In either case, the release notes are copied to a file in the SYS$HELP directory: SYS$HELP:PASCAL057.RELEASE_NOTES ________________________ Note ________________________ The name of the release notes file installed by VMSINSTAL consists of the current product name (in this case, PASCAL) and version number (in this case, 057 for Version 5.7). Do not delete release notes for previous versions of Compaq Pascal. ______________________________________________________ 5. Install the compiler. * Do you want to install the Compaq Pascal compiler [YES]? The Compaq Pascal kit contains the compiler, message files, command line definition, and help files. 6. Install STARLET. * Do you want to install the Compaq Pascal definition files [YES]? The Compaq Pascal kit contains definition files for OpenVMS System Services and several run-time library facility codes. These system definition files are built using information shipped with the OpenVMS operating system. The installation procedure determines whether Compaq Pascal definition files already exist. If the files do not exist, the installation procedure notifies you of this and advises you to create the definition files. Installing Compaq Pascal 2-9 If the Compaq Pascal definition files exist, but the OpenVMS-supplied system definitions, which are the basis for the Compaq Pascal definition files, have been modified since the last time the Compaq Pascal definition files were created, the installation procedure advises you to recreate the files. If the Compaq Pascal definition files exist and if the OpenVMS-supplied system definitions have not been modified since the last time the Compaq Pascal definition files were created, the procedure tells you that it is not necessary to recreate the definition files. 7. Install the examples. * Do you want to install the Compaq Pascal example programs [YES]? The Compaq Pascal kit contains a set of example programs using many features of Compaq Pascal and OpenVMS. The examples are installed in the directory SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]. You can access them using the logical PASCAL$EXAMPLES, if you run the optional startup file SYS$STARTUP:PASCAL$STARTUP.COM (see Section 3.3). 8. Save previous compiler. * Do you want to save your existing Compaq Pascal compiler [NO]? The Compaq Pascal kit contains support to save your existing Compaq Pascal compiler for access later. The installation provides various command files to display and select the saved Compaq Pascal compilers. See Section 1.4 for more information. 9. Purge files. * Do you want to purge files replaced by this installation [YES]? You have the option to purge files from previous versions of Compaq Pascal that are superseded by this installation. Purging is recommended. If you answered YES to question 8, you can answer YES to this question with no danger of deleting any saved compilers. 10.Choose the Installation Verification Procedure (IVP) option. 2-10 Installing Compaq Pascal The installation procedure now asks if you want to run the IVP. The IVP for Compaq Pascal checks that the installation is successful. Compaq recommends that you run the IVP. * Do you want to run the IVP after the installation [YES]? This kit contains an IVP that is used to verify the correct installation of the Compaq Pascal compiler. The IVP is located in: SYS$TEST:PASCAL$IVP.COM After Compaq Pascal is installed, you can run the IVP independently to verify that the software is available on your system. You might need to run the IVP after a system failure to make sure that users can access Compaq Pascal. Installing Compaq Pascal 2-11 11.Respond to license registration queries. Product: PASCAL Producer: Compaq Version: 5.7 Release Date: dd-mmm-yyyy * Does this product have an authorization key registered and loaded? The installation procedure displays license information about your product and then asks if you have registered and loaded your Product Authorization Key (PAK). If you have not registered and loaded your PAK, you must answer NO to this question. You must register and load your PAK to successfully complete the installation. If you have not done so, you should stop the installation, register and load your PAK, and then start the installation procedure again. 12.Read informational messages. At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. 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 chose to have files purged, that work is done now. The following message is displayed: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... 13.Observe the Installation Verification Procedure (IVP). If you chose to run the IVP, VMSINSTAL runs it now. When the IVP runs successfully, you see the following messages displayed: ** Successful Installation of Compaq Pascal V5.7 on 14-APR-1999 at 13:35 ** Compiler Version = Compaq Pascal V5.7-80 *-----------------------------------------------* * Installation Verification Procedure for * * Compaq Pascal STARLET libraries * *-----------------------------------------------* 2-12 Installing Compaq Pascal 14.End the installation procedure. Installation of Compaq Pascal V(n.n) completed at hh:mm VMSINSTAL procedure done at hh:mm These messages indicate that the entire installation procedure is complete. You can now log out of the privileged account: $ LOGOUT SYSTEM logged out at dd-mmm-yyyy 20:20:02 ________________________ Note ________________________ 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 the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of Compaq Pascal V(n.n) has failed. If the IVP fails, you see these messages: The Compaq Pascal V(n.n) Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for Compaq Pascal V(n.n) has failed. Errors can occur during the installation if any of the following conditions exist: o The operating system 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. Installing Compaq Pascal 2-13 o The product license has not been registered and loaded. For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. For information on installation requirements, see Section 1.5. 2-14 Installing Compaq Pascal 3 _________________________________________________________________ After Installing Compaq Pascal Compaq Pascal is now installed and can be invoked by all users with the PASCAL command. The following tasks can be performed after installing Compaq Pascal: o Running the Installation Verification Procedure (IVP) separately o Editing the system startup and shutdown files o Making the product usable on a VMScluster o Enhancing performance o Reporting problems The following sections describe these tasks in detail. 3.1 Running the Installation Verification Procedure (IVP) Separately You usually run the Installation Verification Procedure (IVP) during installation. If you want to run the IVP separately to ensure the integrity of installed files should system problems occur, execute the following command procedure: $ @SYS$TEST:PASCAL$IVP.COM If the IVP fails for any reason, the following message is displayed: Compaq Pascal VERSION V5.n TEST FAILED 3.2 User Account Requirements Several products cannot be used unless certain privilege and quota requirements are met by user accounts. The following sections describe the privilege and quota requirements needed to work with Compaq Pascal. After Installing Compaq Pascal 3-1 3.2.1 Privileges Compaq Pascal does not require any special privileges. There is no benefit from installing the Compaq Pascal compiler with privileges. 3.2.2 Quotas See Section 3.4 for information. 3.3 Editing System Files You can edit the system startup file to provide for automatic startup of Compaq Pascal when your system is rebooted. Use the optional startup file to define the PASCAL$EXAMPLES logical name and to install Compaq Pascal as a shared image (see Section 3.4.2). Edit the system startup file SYS$STARTUP:SYSTARTUP_VMS.COM (or SYS$STARTUP:SYSTARTUP_V5.COM on OpenVMS VAX V5.n systems) to include the following line: $ @sys$startup:pascal$startup.com 3.4 Enhancing Compaq Pascal Performance This section includes information on system tuning and explains how to install Compaq Pascal as a shared image. 3.4.1 Using Multiple Environment Files On OpenVMS VAX systems only If you intend to use multiple Compaq Pascal environment files, you can increase the compilation speed by modifying the FILLM quota of those processes that run the compiler. The Compaq Pascal compiler will keep more than one environment file open during the compilation (with a maximum of 50 environment files). If you inherit more than 50 environment files, the compiler will close some of them in order to open other files. 3-2 After Installing Compaq Pascal 3.4.2 Installing Compaq Pascal as a Shared Image If you expect Compaq Pascal to be used extensively on your system, you can reduce the system overhead and memory requirements by installing it as a shared image. To install Compaq Pascal as a shared image on a system that is currently running, use the optional Compaq Pascal startup file: SYS$STARTUP:PASCAL$STARTUP.COM Compaq recommends that you install Compaq Pascal as shared on a system that has been rebooted recently because the available space in the global page table is less likely to be fragmented. The requirements for additional global pages and global sections are listed in section Section 1.5.2. 3.4.3 Improving Compaq Pascal Compilation Performance on OpenVMS Alpha Systems For many user applications, the Compaq Pascal for OpenVMS Alpha compiler requires significantly more system resources than Compaq Pascal for OpenVMS VAX. The compiler will sometimes fail with a "%LIB-E-INSVIRMEM, insufficient virtual memory" error. Also, for very large programs (greater than 10,000 lines) there could be a report of an extremely long compile time. The following sections explain why Compaq Pascal for OpenVMS Alpha requires more memory, and suggests actions to be taken to avoid resource problems. The Alpha architecture is a RISC (Reduced Instruction Set Computer) architecture. The VAX architecture is a CISC (Complex Instruction Set Computer) architecture. The main distinguishing characteristic of a RISC machine is that it has few instructions, and each instruction does a small amount of work. A CISC machine generally has many instructions, most of which perform many complicated operations in one step. By reducing the amount of work that is done in each instruction (and by reducing the number of instructions), the complexity of the hardware is reduced. This reduction in complexity allows the hardware designers to raise the After Installing Compaq Pascal 3-3 clock speed (and thus the number of instructions per second that can be completed). This results in better overall system performance. Another characteristic of RISC systems is that compilers for these architectures generally must do a great deal more work than a corresponding compiler for a CISC architecture. For example, the compiler must compute the best way to use all of the functional units of the processor, and it must determine how to make the best use of registers and on- chip data cache because reads and writes to main memory are generally slow compared to the speed of the processor. The Compaq Pascal for OpenVMS Alpha compiler is a globally optimizing compiler. The compiler constructs an internal representation of the entire Pascal program, and repeatedly traverses this structure at compile time, so that it can produce the most efficient machine code for the program. This results in high performance code, but the drawback is that the compiler requires more resources than the Compaq Pascal for OpenVMS VAX compiler. 3-4 After Installing Compaq Pascal The Compaq Pascal for OpenVMS Alpha compiler will require more resources than the Compaq Pascal for OpenVMS VAX compiler because it must do more work. However, there are some things that can be done to reduce system resource usage: o Use the /NOOPTIMIZE qualifier when "checking" programs. The optimizer is one of the biggest users of system resources in the Pascal compiler and is turned on by default. Also, the higher the optimization level, the more memory required by the compiler. o Check system tuning. Since the Pascal compiler often needs a great deal of virtual memory, increase working-set limits for developers that use the compiler. This results in decreased paging and improvements in compile time. o Check program sizes. The bigger the program is, the more resources it requires. Section 3.4.3.1 and Section 3.4.3.2 provide basic guidance about memory requirements for Compaq Pascal programs on OpenVMS Alpha. In many tuning exercises, it is instructive to work with a relatively quiet system, submit batch jobs, and retain the log files for later analysis. ________________________ Note ________________________ The guidance in the following section is based on a study of a set of large modules. Please note that your results may differ. ______________________________________________________ For detailed information on OpenVMS tuning, see the OpenVMS System Manager's Manual, sections "Managing System Parameters" and "Managing System Page, Swap, and Dump Files". After Installing Compaq Pascal 3-5 3.4.3.1 Required Virtual Memory If there is not enough virtual memory, the compile command may fail with the message "insufficient virtual memory". OpenVMS has two parameters that control the amount of virtual memory available to a process: o The system generation parameter VIRTUALPAGECNT, which sets an upper bound on the number of pagelets of virtual memory for any process in the system. o The AUTHORIZE parameter PGFLQUOTA, which determines the number of pagelets a process can reserve in the system's page file(s). After an "insufficient virtual memory" error, issue the following DCL command to see the Peak virtual size used by the process, or look at the Peak page file size at the end of a batch job's log: SHOW PROCESS/ACCOUNTING If the peak size is at the system generation parameter VIRTU you will need to raise this value. If the peak size is below VIRTUALPAGECNT, and at or above PGFLQUOTA, run AUTHORIZE to increase PGFLQUOTA for the Pascal users. Peak size can exceed PGFLQUOTA because some virtual memory, such as read-only image code, is not allocated page file space. It is difficult to predict precisely how much virtual memory will be required for a compilation, but a starting point for system tuning can be computed by either of the following: o Multiply 250 times the size of the largest program in disk blocks (including all INCLUDE files referenced). o Multiply 25 times the number of lines in the program (including all INCLUDE files. The resulting figure can then be used as a starting point for the system generation parameter VIRTUALPAGECNT. Place a line in the parameter file SYS$SYSTEM:MODPARAMS.DAT. For example, if you estimate 370,000 pages, add the following line in MODPARAMS, run AUTOGEN and reboot. MIN_VIRTUALPAGECNT = 400000 3-6 After Installing Compaq Pascal If the compilation now completes successfully, use the command SHOW PROCESS/ACCOUNTING to determine the Peak Virtual Size; if the actual peak is significantly less than the value computed above, you can reduce VIRTUALPAGECNT. When modifying VIRTUALPAGECNT and PGFLQUOTA, you may also need to increase the size of the page file. 3.4.3.2 Required Physical Memory When dealing with physical memory you must know: o If there enough memory on the system o If enough available to the process running the compilation If the physical memory on the system is too small, the command LOGOUT/FULL (which is automatically issued at the end of a batch job) will show a high number of faults, for example, > 100,000 for a single compilation, and an "Elapsed time" that greatly exceeds the "Charged CPU time", as the system waits for disk I/Os to resolve page faults. In this situation, tuning attempts may be of limited benefit. If the physical memory on the system is adequate, but the physical memory allotted to the process running the compilation is too small, you may still observe a large number of faults, but elapsed time may remain closer to CPU time. This is because OpenVMS resolves page faults from the page caches (free list, modified list) whenever possible, avoiding the relatively slow disk I/Os. In this situation, basic tuning may also be beneficial. The amount of physical memory required will vary, but it should be a large fraction of the process peak virtual size-as close to 1.0 as practical. The reason for this is that the compiler makes multiple passes over the internal representation of the program; therefore a page which falls out of the working set in one pass is probably going to be needed again on the very next pass. The physical memory present on the system can be determined by the command SHOW MEMORY/PHYSICAL. The physical memory used by the compilation is reported as "Peak working set size" by the command SHOW PROCESS/ACCOUNTING or at the end of a batch log file. After Installing Compaq Pascal 3-7 More physical memory can be made available to a process by minimizing the number of competing processes on the system (for example, by compiling one module at a time, or scheduling large compiles for off hours.) It can also be made available to a process (if it is present on the machine) by adjusting the system generation parameter WSMAX and the corresponding WSEXTENT (in AUTHORIZE). Such adjustments must be attempted with great caution, as the system may hang if memory is oversubscribed and you create a situation where OpenVMS effectively has no options to reclaim memory. The following guidelines have been found useful: o Set the Pascal users' WSEXTENT (in AUTHORIZE or INITIALIZE/QUEUE) to match WSMAX. o Keep WSQUOTA (in AUTHORIZE or INITIALIZE/QUEUE) low. Make sure that no process or batch queue has a WSQUOTA of more than about 20% of physical memory. The difference between WSEXTENT and WSQUOTA allows OpenVMS to manage memory to meet varying demands. o Use AUTOGEN. AUTOGEN will attempt to make a consistent set of changes that do not interfere with each other. By default, AUTOGEN will set the maximum working set (system generation parameter WSMAX) to 25% of physical memory. This value is reasonable for a workstation or multi-user system with many active processes. o WSMAX can be increased to a somewhat larger value by editting MODPARAMS.DAT. For a system with 64 MByte of physical memory, try setting WSMAX to no more than about 40% of physical memory, or 52000 pagelets. With 128 MByte or more of physical memory, a setting of 50% of physical memory can be attempted. 3-8 After Installing Compaq Pascal 3.4.3.3 Effects of Physical Memory The effects of physical memory on compilation time were studied for a set of seven large modules. The modules ranged in size from about 1600 to 3300 disk blocks. Your results may differ; but to help to give a rough appreciation for the effect of physical memory on compilation time, the following can be noted: o When the amount of physical memory available to the processes matched the amount of virtual memory, the elapsed times were close to the CPU times. o As the physical memory was reduced, CPU times rose only slightly, about ten percent. o As the physical memory was reduced, elapsed times were elongated, at the rate of about one hour for each 100MB of difference between Peak Virtual Size and the actual memory available. For example, when compiling a program that used a Peak Virtual Size of 947760 pagelets, or 463MB (1MB = 2048 pagelets), on a system where about 180MB of physical memory was available to user processes, the compile required about three hours longer than on a 512MB system. Your results will be strongly affected by the speed of the devices that are used for paging. Both virtual memory and physical memory requirements can be reduced by breaking large modules up into smaller modules. 3.5 Determining and Reporting Problems If an error occurs while using Compaq Pascal and you believe the error is caused by a problem with Compaq Pascal, take one of the following actions: o If you have a basic or DECsupport Software Agreement, call your Customer Support Center (CSC). The CSC provides telephone support for high-level advisory and remedial assistance. o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). o If you purchased Compaq Pascal within the last 90 days and you think the problem is caused by a software error, you can submit an SPR. After Installing Compaq Pascal 3-9 If you find an error in the Compaq Pascal documentation, please fill out one of the Reader's Comments forms at the back of the document containing the error and send the form to Compaq. Please include the section and page number where the error occurred. When you submit an SPR, please take the following steps: 1. Describe as accurately as possible the state of the system and the circumstances when the problem occurred. Include in the description the version number of Compaq Pascal being used. Demonstrate the problem with specific examples. 2. Reduce the problem to as small a size as possible. 3. Provide a listing of the program. Remember to include listings of any command files, relevant data files, and so forth. 4. If the program is longer than 50 lines, submit a copy of the program on machine-readable media (floppy diskette or magnetic tape). If necessary, also submit a copy of the program library used to build the application. 5. Report only one problem per SPR. This will facilitate a faster response. 6. Mail the SPR package to Compaq. Experience shows that many SPRs do not contain enough information to duplicate or identify the problem. Concise, complete information helps Compaq give accurate and timely service to software problems. 3-10 After Installing Compaq Pascal A _________________________________________________________________ Sample Installation This appendix contains a sample installation of Compaq Pascal. This sample was run on a system that had no previous version of Compaq Pascal installed. Depending on which version of layered products or which version of OpenVMS you have on your system, you might see additional messages and questions when you perform your installation. The Compaq Pascal installation procedure installs several files on your system and defines some logical names. The file names are listed at the end of the installation procedure (see Appendix A). The PASCAL$EXAMPLES logical name is entered into the system logical name table when the PASCAL$STARTUP.COM command file is invoked. This name points to the location of the optional Compaq Pascal examples. The sample installation assumes that DECnet has been shut down, that no users are logged on to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation. $ @vmsinstal OpenVMS AXP Software Product Installation Procedure V6.2-1H3 It is 14-APR-1999 at 13:32. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: dka300:[pascal057.kit] Enter the products to be processed from the first distribution volume set. * Products: pascal057 * Enter installation options you wish to use (none): The following products will be processed: Sample Installation A-1 PASCAL V5.7 Beginning installation of PASCAL V5.7 at 13:32 %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 1994, 1999. 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. *-------------------------------------------------------------* * Installation Command Procedure for * * Compaq Pascal V5.7 compiler, definition files, and examples * *-------------------------------------------------------------* The Compaq Pascal V5.7 kit contains the compiler, message files, command line definition and help files. These files require 17000 blocks during installation and will occupy 16500 blocks after installation. * Do you want to install the Compaq Pascal compiler [YES]? The Compaq Pascal V5.7 kit contains definition files for OpenVMS System Services and several Run-Time Library Facility codes. The definition files require 11500 blocks during installation and will occupy 10000 blocks after installation. In addition, if you have Compaq Pascal compilers that were saved from prior upgrades, the definition files will be built with the oldest possible compiler to allow for the older compilers to inherit the newly constructed definition files. The OpenVMS-supplied system symbol definitions, which are the basis for Compaq Pascal definition files (STARLET.PAS and others), have not been modified since the last time the Compaq Pascal definition files were created. It is not necessary to recreate the Compaq Pascal definition files at this time. * Do you want to install the Compaq Pascal definition files [YES]? A-2 Sample Installation The Compaq Pascal V5.7 kit contains a set of example programs using many features of Compaq Pascal and OpenVMS. The example files require 150 blocks during installation and will occupy 150 blocks after installation. * Do you want to install the Compaq Pascal example programs [YES]? The Compaq Pascal kit is capable of copying your existing Pascal compiler for later use. The kit will provide command files to show which versions of Compaq Pascal are on the system, to select a non-default compiler version, and to select which compiler is the default compiler. See the installation guide for more information on these command files. * Do you wish to save your existing Compaq Pascal compiler [NO]? * Do you want to purge files replaced by this installation [YES]? * Do you want to run the IVP after the installation [YES]? Product: PASCAL Producer: DEC Version: 5.7 Release Date: 20-JAN-1999 * Does this product have an authorization key registered and loaded? yes This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of Compaq Pascal. This file is named PASCAL057.RELEASE_NOTES and has been placed in SYS$HELP:. This file contains information valuable to Compaq Pascal programmers. Please inform your user community of this file's existence. In addition, a file describing record layout considerations to improve performance and/or coexistance between VAX and AXP systems has been provided in SYS$HELP:PASCAL_RECORD_LAYOUT_GUIDE.MEM This kit will construct the following definition files in SYS$LIBRARY: Sample Installation A-3 STARLET.PAS/PEN PASCAL$ACLEDIT_ROUTINES.PAS/PEN PASCAL$CLI_ROUTINES.PAS/PEN PASCAL$CONV_ROUTINES.PAS/PEN PASCAL$DCX_ROUTINES.PAS/PEN PASCAL$DTK_ROUTINES.PAS/PEN PASCAL$EDT_ROUTINES.PAS/PEN PASCAL$FDL_ROUTINES.PAS/PEN PASCAL$LIB_ROUTINES.PAS/PEN PASCAL$LBR_ROUTINES.PAS/PEN PASCAL$MAIL_ROUTINES.PAS/PEN PASCAL$MTH_ROUTINES.PAS/PEN PASCAL$NCS_ROUTINES.PAS/PEN PASCAL$OTS_ROUTINES.PAS/PEN PASCAL$PPL_ROUTINES.PAS/PEN PASCAL$PSM_ROUTINES.PAS/PEN PASCAL$SMB_ROUTINES.PAS/PEN PASCAL$SMG_ROUTINES.PAS/PEN PASCAL$SOR_ROUTINES.PAS/PEN PASCAL$STR_ROUTINES.PAS/PEN PASCAL$TPU_ROUTINES.PAS/PEN PASCAL$C_ROUTINES.PAS/PEN PASCAL$CMA_ROUTINES.PAS/PEN PASCAL$CVT_ROUTINES.PAS/PEN For compatibility with existing programs, symbols in previous versions of STARLET.PAS will remain in STARLET.PAS even though the symbols might be associated with a run-time library. For example, the SMG$K_* symbols are still in STARLET.PAS instead of PASCAL$SMG_ROUTINES.PAS, while the SMG$ entry points and the SMG message numbers are in PASCAL$SMG_ROUTINES.PAS. This kit provides several examples in SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]. The names of the files reflect the topic being demonstrated by the programs. The IVP (Installation Verification Procedure) will be left in SYS$TEST:PASCAL$IVP.COM. After the installation is complete, you can invoke the command file at any time to reverify that Compaq Pascal is installed and working correctly. An optional startup file has been placed in SYS$STARTUP:PASCAL$STARTUP.COM. The file installs the Compaq Pascal compiler, Run-Time Library, and message files as shared images to improve the performance of using the Compaq Pascal compiler or applications written in Compaq Pascal. If you wish to use this file, add the following DCL command to SYS$MANAGER:SYSTARTUP_VMS.COM $ @SYS$STARTUP:PASCAL$STARTUP.COM All questions regarding the installation have now been asked. The installation of Compaq Pascal V5.7 will now continue for 5 to 45 minutes depending on your configuration and the options requested. Installing Compaq Pascal compiler... %VMSINSTAL-I-RESTORE, Restoring product save set B ... A-4 Sample Installation Installing Compaq Pascal definition files... %VMSINSTAL-I-RESTORE, Restoring product save set C ... Generating STARLET.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$ACLEDIT_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$CLI_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$CONV_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$DCX_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$DTK_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$EDT_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$FDL_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$LIB_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V54-041.EXE... Generating PASCAL$LBR_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$MAIL_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$MTH_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V54-041.EXE... Generating PASCAL$NCS_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$OTS_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V54-041.EXE... Generating PASCAL$PPL_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$PSM_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$SMB_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$SMG_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$SOR_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$STR_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$TPU_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$CVT_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$CMA_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Generating PASCAL$C_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V52-026.EXE... Installing Compaq Pascal example programs... %VMSINSTAL-I-RESTORE, Restoring product save set D ... Your OpenVMS system will now be updated to include the following new and modified files: Sample Installation A-5 SYS$SYSTEM:PASCAL.EXE [new] SYS$HELP:PASCAL057.RELEASE_NOTES [new] SYS$COMMON:[SYSTEST.PASCAL]PASCAL$IVP.PAS [new] SYS$HELP:HELPLIB.HLB [modified] SYS$HELP:PASCAL_RECORD_LAYOUT_GUIDE.MEM [new] SYS$LIBRARY:DCLTABLES.EXE [modified] SYS$LIBRARY:LIBDEF.PAS [new] SYS$LIBRARY:MTHDEF.PAS [new] SYS$LIBRARY:PASDEF.PAS [new] SYS$LIBRARY:PASSTATUS.PAS [new] SYS$LIBRARY:SIGDEF.PAS [new] SYS$MESSAGE:PASCALER1.EXE [new] SYS$MESSAGE:PASCALER2.EXE [new] SYS$STARTUP:PASCAL$STARTUP.COM [new] SYS$SYSTEM:PASCAL$SHOW_VERSIONS.COM [new] SYS$SYSTEM:PASCAL$SET_VERSION.COM [new] SYS$SYSTEM:PASCAL$DEFAULT_VERSION.COM [new] SYS$TEST:PASCAL$IVP.COM [new] SYS$COMMON:[SYSTEST.PASCAL]PASSTR$IVP.PAS [new] SYS$LIBRARY:STARLET.PAS [new] SYS$LIBRARY:STARLET.PEN [new] SYS$LIBRARY:PASCAL$ACLEDIT_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$ACLEDIT_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$CLI_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$CLI_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$CONV_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$CONV_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$DCX_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$DCX_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$DTK_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$DTK_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$EDT_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$EDT_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$FDL_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$FDL_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$LIB_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$LIB_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$LBR_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$LBR_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$MAIL_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$MAIL_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$MTH_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$MTH_ROUTINES.PEN [new] A-6 Sample Installation SYS$LIBRARY:PASCAL$NCS_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$NCS_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$OTS_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$OTS_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$PPL_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$PPL_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$PSM_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$PSM_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$SMB_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$SMB_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$SMG_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$SMG_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$SOR_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$SOR_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$STR_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$STR_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$TPU_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$TPU_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$D_FLOAT.PAS [new] SYS$LIBRARY:PASCAL$D_FLOAT.PEN [new] SYS$LIBRARY:PASCAL$G_FLOAT.PAS [new] SYS$LIBRARY:PASCAL$G_FLOAT.PEN [new] SYS$LIBRARY:PASCAL$CVT_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$CVT_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$C_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$C_ROUTINES.PEN [new] SYS$LIBRARY:PASCAL$CMA_ROUTINES.PAS [new] SYS$LIBRARY:PASCAL$CMA_ROUTINES.PEN [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]CONSTRUCTOR_1.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]FUNCTION_CALLS.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]HANDLER.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]HELLOMOTIF.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]HELLOMOTIF.UIL [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]IMPLEMENTATION_MODULE.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]INITIAL_STATE_1.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]INITIAL_STATE_2.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]INTERFACE_MODULE.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]LIB$FIND_FILE.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]MAIN_PROGRAM.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]RFA_READ.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SCHEMA_PARAMETERS.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SCHEMA_PARAMETERS.DAT [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SMG_EXAMPLE.PAS [new] Sample Installation A-7 SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$ASCTIM_AND_GETTIM.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$CHECK_ACCESS.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$DCLEXH.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$DEVICE_SCAN.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$FAO.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETDVI.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETJPI.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETQUI.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETSYI.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETUAI.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$PROCESS_SCAN.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$PUTMSG.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$SNDJBC.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$TRNLNM.PAS [new] SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]USE_XABDAT.PAS [new] %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... *-----------------------------------------------* * Installation Verification Procedure * * for Compaq Pascal V5.7 * *-----------------------------------------------* Copyright Digital Equipment Corporation 1994, 1999. 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. ** Successful Installation of Compaq Pascal V5.7 on 14-APR-1999 at 13:35 ** Compiler Version = Compaq Pascal V5.7-80 *-----------------------------------------------* * Installation Verification Procedure for * * Compaq Pascal STARLET libraries * *-----------------------------------------------* Copyright Digital Equipment Corporation 1994, 1999. All rights reserved. A-8 Sample Installation 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. ** Compaq Pascal STARLET libraries are installed and functioning normally ** Installation of PASCAL V5.7 completed at 13:35 Sample Installation A-9