                                       D                 Compaq_Pascal_______________________________________.                 Installation Guide for OpenVMS  )                 Order Number: AA-PXSPC-TK                      June 1999   D                 This guide explains how to install the Compaq Pascal>                 compiler and related software components on an4                 OpenVMS Alpha or OpenVMS VAX system.              ?                 Revision/Update Information:  This is a updated 4                                               guide.  C                 Operating System:             OpenVMS Alpha Version <                                               6.1 or higher.E                                               OpenVMS VAX Version 5.5 8                                               or higher.@                                               Future maintenanceB                                               releases may require>                                               higher versions.  C                 Software Version:             Compaq Pascal Version 1                                               5.7   +                 Compaq Computer Corporation                  Houston, Texas                 F       ________________________________________________________________       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 a9       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.   5       Bookreader, Compaq Pascal, DEC, DEC Ada, DEC C, 8       DECdocument, Debugger, DECnet, DECset, DECstation,A       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.)   B                                                             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 6     1.5.1     Installation Account Privileges and Disk?               Space.....................................    1-4 ?     1.5.2     System Parameters.........................    1-6 7     1.5.2.1     Calculating the Values for GBLPAGES and ?                 GBLSECTIONS.............................    1-8 5     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   1       3.1   Running the Installation Verification B             Procedure (IVP) Separately....................     3-1B       3.2   User Account Requirements.....................     3-1B       3.2.1     Privileges................................     3-2B       3.2.2     Quotas....................................     3-2B       3.3   Editing System Files..........................     3-2B       3.4   Enhancing Compaq Pascal Performance...........     3-23       3.4.1     Using Multiple Environment Files On B                 OpenVMS VAX systems only..................     3-24       3.4.2     Installing Compaq Pascal as a SharedB                 Image.....................................     3-33       3.4.3     Improving Compaq Pascal Compilation B                 Performance on OpenVMS Alpha Systems......     3-3B       3.4.3.1     Required Virtual Memory.................     3-6B       3.4.3.2     Required Physical Memory................     3-7B       3.4.3.3     Effects of Physical Memory..............     3-9B       3.5   Determining and Reporting Problems............     3-9   A  Sample Installation     Tables  B       1-1       Disk Space Requirements...................     1-4                                       iv                             E     _________________________________________________________________   E                                                               Preface       %           This guide explains how to:   B           o  Install Compaq Pascal on OpenVMS Alpha or OpenVMS VAX  *           o  Read the online release notes  A           This guide applies to Compaq Pascal Version 5.7 and all >           subsequent maintenance releases up to the next major           product release.       Intended Audience   D           This guide is intended for the system manager who installs?           Compaq Pascal. Keep this guide with your distribution A           kit. You will need it to install maintenance updates or :           to reinstall Compaq Pascal for any other reason.       Document Structure  5           This guide contains the following chapters:   :           o  Chapter 1 describes the hardware and software              requirements for C              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 B              Verification Procedure (IVP) and any postinstallation0              procedures you must complete to use              Compaq Pascal. (   D           o  Appendix A contains a sample Compaq Pascal installation              and the IVP.)  E                                                                     v                     Associated Documents  @       In addition to this guide, the Compaq Pascal documentation'       set includes the following books:   .       o  Compaq Pascal User Manual for OpenVMS  0       o  Compaq Pascal Language Reference Manual  ?       For general information on OpenVMS system management, see 5       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   B           This guide uses the following documentation conventions:                                                                                    E                                                                   vii                                                                                                               viii                 E           ___________________________________________________________ E           Convention____________Meaning______________________________   C           $                     The dollar sign ($)  is the default +                                 DCL prompt.   D           <Return>              In code examples, an enclosed symbolA                                 indicates that you must press the :                                 named key on the keyboard.  D           Ctrl/Y                In interactive examples, this symbolA                                 indicates that you must press the A                                 Ctrl key while you simultaneously D                                 press another key (in this case, Y).  C           Username:             In interactive examples, prompts or E           @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 8                                 procedure, or a utility.  C           lowercase             Lowercase letters indicate variable D                                 information such as a file name or a,                                 device name.  A           file-spec,...         Horizontal ellipses indicate that D                                 you can enter additional parameters,7                                 values, or information.   =           [YES]                 Square brackets indicate that >                                 the enclosed item is a defaultB                                 value in a VMSINSTAL prompt. Also,C                                 square brackets serve as delimiters >                                 for a directory name in a file.                                 specification.  E           VMS system            All references to VMS system refer to D                                 the OpenVMS Alpha or the OpenVMS VAX1                                 operating system.   B           On OpenVMS Alpha      This guide uses labels to indicateB           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 youA                                 install Compaq Pascal, the actual >                                 version numbers appear on yourE           ______________________screen.____________________________ix                    A       Unless otherwise noted, press the Return key after entering 0       commands and responses to command prompts.                                                                                       x                          E                                                                     1 E     _________________________________________________________________   E                                    Preparing to Install Compaq Pascal     B           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  D           Compaq strongly recommends that you read the release notesE           before proceeding with the installation. For information on >           accessing the online release notes, see Section 2.1.  E           Your distribution kit includes a "Read First" cover letter. ?           Please read this cover letter for information that is D           important for you to know before installing Compaq Pascal.C           This information may not be included in this installation (           guide or in the release notes.  ,     1.1 Required Operating System Components  B           Compaq Pascal Version 5.7 requires OpenVMS Alpha VersionE           6.1 or higher, or OpenVMS VAX Version 5.5 or higher. Future ?           Compaq Pascal releases may require higher versions of B           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.  E                                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 9       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 9       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 A       must register and load your license for Compaq Pascal to be ?       able to run the Installation Verification Procedure (IVP) 4       and for users to be able to run Compaq Pascal.  A       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 itA          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 D              command with the appropriate qualifiers that correspond(              to License PAK information.  B           For complete information on using LMF, see the manual onE           the License Management Utility in the OpenVMS documentation            set.        1.4 Multiple Version Support  D           Compaq Pascal provides support for using multiple versions6           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 E           chosen, the installation copies the current compiler before &           installing the new compiler.  A           The kit provides 3 command files to display and control /           which Compaq Pascal compiler is used.   C           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-wideD              compiler settings. This command file has no parameters.  B           o  SYS$SYSTEM:PASCAL$SET_VERSION.COM is used to select aE              Compaq Pascal compiler other than SYS$SYSTEM:PASCAL.EXE. ?              If invoked without parameters, it will display the A              currently available compilers and ask for a filename_A              to use for the process-wide compiler setting. It has >              2 optional parameters. The first parameter can beC              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 beingE              prompted for a file. This allows you to place a compiler E              selection in a LOGIN.COM or some other command file. Allt8              saved compilers are located in SYS$SYSTEM:.  :           o  SYS$SYSTEM:PASCAL$DEFAULT_VERSION.COM is used9              to select the default Compaq Pascal compiler ;              when SYS$SYSTEM:PASCAL$SET_VERSION.COM has not <              be used. The installation always provides a newA              SYS$SYSTEM:PASCAL.EXE and copies existing compilers.e?              You can use this command file to select one of the C              saved compilers to be SYS$SYSTEM:PASCAL.EXE and rename   E                                Preparing to Install Compaq Pascal 1-3o q  m              =          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 to9       45 minutes, depending on your system configuration.   5 1.5.1  Installation Account Privileges and Disk Space   8       To install Compaq Pascal, you must be logged in to:       an account that has SETPRV or at least the following       privileges:l         o  CMKRNLw         o  WORLD         o  SYSPRVc  ?          ________________________ Note ________________________i  >          VMSINSTAL turns off the BYPASS privilege at the start          of the installation.m  ?          ______________________________________________________q  >       Compaq Pascal's requirements for free disk storage space?       are different during installation and after installation.P4       Table 1-1 summarizes the storage requirements.  A       Table_1-1__Disk_Space_Requirements_________________________,  8                                Number of Blocks Required1                               During        AfterlA       Kit_____________________Installation__Installation_________U  2       Compaq Pascal Version   17,000        16,500	       5.7t       On OpenVMS Alpha       systems only  B                                           (continued on next page)    ' 1-4  Preparing to Install Compaq Pascald i  V              E           Table_1-1_(Cont.)_Disk_Space_Requirements___________________  ;                                   Number of Blocks Required 5                                   During        After.E           Kit_____________________Installation__Installation_________n  3           Compaq Pascal Run-Time  500           500i           Library on OpenVMS           Alpha systems only           and only when that           kit is newer than the            installed version.  5           Compaq Pascal Version   3,500         3,000.
           5.7.            On OpenVMS VAX systems           only  6           Compaq Pascal STARLET   11,500        10,000           files   E           Compaq_Pascal_examples___150___________150_________________                                               E                                Preparing to Install Compaq Pascal 1-5n                   @       To determine the number of free disk blocks on the current3       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 al<          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..  6       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 9       previously installed as a shared image, as follows:.  7       o  If not previously installed as a shared image:p  9          -  One global section and a sufficient number ofs?             contiguous free global pagelets to contain the file.&             SYS$LIBRARY:DCLTABLES.EXE.  =       o  If previously installed as a shared image or will bef?          subsequently installed with the PASCAL$STARTUP commandm          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_ _  _              A              -  8,500 additional global pagelets on OpenVMS Alpha                  systems.  ?              -  1,500 additional global pagelets on OpenVMS VAX                  systems.  C           These values represent the number of free global pageletsr@           and global sections required for the installation, not@           the total number you need to run your system and other           software.                                                                       E                                Preparing to Install Compaq Pascal 1-7a K                 ?          ________________________ Note ________________________m  6          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.   ?          ______________________________________________________t  < 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 byA       SYS$LIBRARY:DCLTABLES.EXE, enter the following DCL command:   *       $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE  2       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 fore       SYS$OUTPUT):  4       $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")       15848 2       $ 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), youA       must increase the system parameter setting. Section 1.5.2.2 @       describes the procedures for increasing these values using       AUTOGEN.  6 1.5.2.2  Changing System Parameter Values with AUTOGEN  <       If you do not have enough free global pagelets or freeA       global sections to install Compaq Pascal, you can do either        of the following:   A       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 the7              GBLPAGES or GBLSECTIONS system parameters._  B           AUTOGEN automatically adjusts values for parameters that?           are associated with the values you reset manually. To C           change system parameters with AUTOGEN, edit the following            file:   "           SYS$SYSTEM:MODPARAMS.DAT  E           To change a parameter value listed in this file, delete the D           current value associated with that parameter and enter the           new value.  @           To add a new parameter, insert a line in the file thatD           includes both the name of the parameter and its value. For           example:             WSMAX = 1024  ?           To modify incremental parameters such as GBLPAGES ando@           GBLSECTIONS, use ADD_. The following example increases-           the global pagelet setting by 2000:              ADD_GBLPAGES = 2000   B             ________________________ 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.  B             ______________________________________________________  C           After you make all your changes, exit from the editor ando@           then execute the AUTOGEN procedure to recalculate yourC           system parameters. Enter the following command at the DCL D           prompt to recalculate your system parameters and to reboot           the system:n  .           $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT  C           When you specify REBOOT, AUTOGEN does an automatic systems@           shutdown and then reboots the system. Any users loggedB           on to the system are immediately disconnected during the?           shutdown. The automatic reboot puts the new parameterT           values into effect.   E                                Preparing to Install Compaq Pascal 1-9                    6       AUTOGEN automatically adjusts some of the SYSGENA       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.S  ?       For more information about using AUTOGEN, see the OpenVMSn       System Management Subkit.i                                                                          ( 1-10  Preparing to Install Compaq Pascal    n              %     1.5.3 Backing Up Your System Disk   E           At the beginning of the installation, VMSINSTAL asks if you E           have backed up your system disk. Compaq recommends that yousD           do a system disk backup before installing Compaq Pascal or           any other software.   @           Use the backup procedures that are established at yourC           site. For details on performing a system disk backup, see A           the section on the Backup Utility in the OpenVMS system #           management documentation.   !     1.6 Stopping the Installation   E           To stop the installation procedure at any time, use Ctrl/C._B           However, files created up to that point are not deleted.C           You must then delete these files interactively. Chapter 2c<           lists the directories and files created during the%           Compaq Pascal installation.V       1.6.1 Reader's Commentsb  A           Compaq appreciates your comments. If you find errors orcC           want to comment about this manual, please send the manualf>           title, order number, and your comments by one of the           following methods:  &           o  Electronic Internet mail:  /                 pascal_docs@bookie.enet.dec.com              o  Fax:P                   603-884-01209                 Attn: Languages Documentation, ZKO2-3/K35n  4           o  A letter sent to the following address:  +                 Compaq Computer Corporationt3                 Languages Documentation, ZKO2-3/K35e#                 110 Spit Brook Roadr%                 Nashua, NH 03062-2698i                 USA     E                               Preparing to Install Compaq Pascal 1-11e e  r                    E                                                                     2oE     _________________________________________________________________i  E                                              Installing Compaq Pascale    =           This chapter explains how to install Compaq Pascal:   C           o  Section 2.1 contains a step-by-step description of the $              installation procedure.  A           o  Section 2.2 describes error recovery considerations.e  B           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. Seet=           Appendix A for a sample Compaq Pascal installation.   B           If you have not already done so, insert the Compact Disc=           (CD) or tape media into the CD drive or tape drive.n  @           To abort the installation procedure at any time, pressC           Ctrl/Y. When you press Ctrl/Y, the installation procedure ?           deletes all files it has created up to that point andp;           exits. You can then start the installation again.e  @           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:  4           1. Invoke the VMSINSTAL command procedure.  C              You should invoke the VMSINSTAL command procedure fromt@              privileged account, such as the SYSTEM account. TheD              VMSINSTAL procedure is in the SYS$UPDATE directory. For              example:p  E                                          Installing Compaq Pascal 2-1a o                           Username: SYSTEMf          Password:  !          $ SET DEFAULT SYS$UPDATELM          $ @SYS$UPDATE:VMSINSTAL (saveset-name)  (device-name)  [option-list],                                                                                 2-2  Installing Compaq Pascal  .  f              E              The following list defines the elements of the VMSINSTALo              procedure:                 saveset-nameV@              The installation name for the component. For Compaq9              Pascal, use the following installation name:i                     PASCAL05n   B              To obtain the directory location of the Compaq PascalB              saveset on the CD, refer to the OpenVMS Alpha Layered?              Products Disc User's Guide that accompanies the CDaB              distribution kit. Or, you can do the following before'              starting the installation:   E              o  To determine whether the CD drive is already mounted,E,                 enter the following command:  %                 $ SHOW DEVICE DKA400:   ;                 If it is not mounted, enter the appropriatef@                 MOUNT command to mount the CD (omit the /FOREIGN                 qualifier).M  A              o  To obtain the directory name, enter the following                  command:  7                 $ DIRECTORY DKA400:[000000]*pascal*.dirt)                 Directory DKA400:[000000]                  PASCAL05n.DIR;1u  E              o  To obtain the saveset name, use the DIRECTORY commandi?                 specifying the directory file from the previous                  command:  5                 $ DIRECTORY DKA400:[PASCAL05n.KIT]*.Ah                device-nameB              The name of the device on which you plan to mount theA              media and the directory containing the Compaq PascaldC              save set. In the following example, the device name isyC              DKA400: and the directory is [PASCAL05n.KIT]. For tapenC              installations, just enter the name of the tape device.   A              To specify the device name on the @VMSINSTAL command               line, enter:C  )                    DKA400:[PASCAL05n.KIT]   E                                          Installing Compaq Pascal 2-3                    @          DKA400: is the name of the CD drive used in the rest of$          the examples in this guide.            option-list8          The word OPTIONS followed by one or more of theA          following option designators: A, L, N, R. Their meaningsE          are as follows:  "          o  Auto_answer option (A)  ?             Initially creates a file that contains your answersp@             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).  4             Logs all activity to the terminal during             installation.e  2          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 theA             release notes before proceeding with the installation A             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 ________________________   6          Even if you omit the N option when you invoke>          VMSINSTAL, the Compaq Pascal release notes are copied1          automatically to the SYS$HELP directory.   ?          ______________________________________________________   %          o  Alternate root option (R)   >             Allows you to install the product to a system root2             other than that of the running system.  A          For detailed information on these VMSINSTAL options, seel>          the OpenVMS documentation on software installation in.          the OpenVMS System Management Subkit.   2-4  Installing Compaq Pascal                    D              If you specify multiple options, use commas to separate&              the options, for example:                OPTIONS A,N  @              When you invoke VMSINSTAL, it checks the following:  A              o  Whether you are logged in to a privileged accountl  D                 Compaq recommends that you install software from theE                 system manager's account with your default device andn,                 directory set to SYS$UPDATE.  C              o  Whether you have sufficient quotas for installatione  @              This following example invokes VMSINSTAL to install>              Compaq Pascal and shows the system response. This<              example uses the OPTIONS N release note option.  O              $ @SYS$UPDATE:VMSINSTAL PASCAL05n DKA400:[PASCAL05n.kit] OPTIONS N_  E                  OpenVMS Software Product Installation Procedure Vn.ni  (              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 deviceC              name, VMSINSTAL prompts you for this information later E              in the installation procedure. VMSINSTAL does not promptp@              you for any options, so be sure to include whatever;              option you want on the VMSINSTAL command line._  #           2. Confirm system backup.   K              * Are you satisfied with the backup of your system disk [YES]?-  A              VMSINSTAL asks if you are satisfied with your systemb?              backup. You should always back up your system diskcD              before performing an installation. If you are satisfied;              with the backup of your system disk, press theC?              Return key. Otherwise, enter NO to discontinue theIB              installation. After you back up your system disk, you*              can restart the installation.  D              If you fail to include the device name of the VMSINSTAL=              command line, the following prompt is displayed:h  >              * Where will the distribution volumes be mounted:  >              If this prompt is displayed, type the name of theE              distribution (media)  device and directory that containsa  E                                          Installing Compaq Pascal 2-5.                   ?          the Compaq Pascal kit (save  set). For example, if theiA          media is contained on a CD located on unit DKA400:, type_=          DKA400:[PASCAL05n.KIT] in reply to this question, asC(          shown in the following example:  P          * Where will the distribution volumes be mounted:DKA400:[PASCAL05n.KIT]                                                                               2-6  Installing Compaq PascalP A  X              0           3. Verify the product being installed.  6              The following products will be processed:                PASCAL V5.n  ;              Beginning installation of PASCAL V5.n at hh:mmf  A              %VMSINSTAL-I-RESTORE, Restoring product saveset A...T  <              The product name and version are displayed. TheA              first save set (A)  is restored to a subdirectory ofU              SYS$UPDATE.  +           4. Select a release notes option.i  P              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 2p&                  4.  None of the above  !              * Select option [2]:o  C              If you specified OPTIONS N when you invoked VMSINSTAL,sD              you are now asked to choose one of the four options for)              reviewing the release notes:o  >              o  If you select option 1, VMSINSTAL displays theB                 release notes immediately on the console terminal.E                 You can terminate the display at any time by pressingg                 Ctrl/C.   E              o  If you select option 2, VMSINSTAL prompts you for the_=                 name of the print queue that you want to use:y  )                 * Queue name [SYS$PRINT]:e  B                 You can then enter a queue name or press Return toA                 send the file to the default output print device.   >              o  If you select option 3, VMSINSTAL displays theA                 release notes immediately on the console terminal E                 and then prompts you for a queue name for the printed -                 version of the release notes.c  E                                          Installing Compaq Pascal 2-7  Y  I              =          o  If you choose option 4, the release notes are notS<             displayed or printed but are still copied to the5             following file in the SYS$HELP directory:a  ,             SYS$HELP:PASCAL05n.RELEASE_NOTES                                                                                 2-8  Installing Compaq Pascal  e  o              D              You can later use the HELP command to find the location7              of the release notes in the Help facility:   (              $ HELP PASCAL RELEASE_NOTES  A              Whichever option you choose, VMSINSTAL next asks the                following question:  B              * Do you want to continue the installation [NO]?: YESI              %VMSINSTAL-I-RELMOVED, The product's release notes have beens4                      successfully moved to SYS$HELP.  @              To continue the installation, enter YES. Otherwise,@              press Return. In either case, the release notes are8              copied to a file in the SYS$HELP directory:  -              SYS$HELP:PASCAL057.RELEASE_NOTES   B             ________________________ Note ________________________  ;             The name of the release notes file installed byg>             VMSINSTAL consists of the current product name (in@             this case, PASCAL) and version number (in this case,A             057 for Version 5.7). Do not delete release notes forA/             previous versions of Compaq Pascal.   B             ______________________________________________________  "           5. Install the compiler.  G              * Do you want to install the Compaq Pascal compiler [YES]?   A              The Compaq Pascal kit contains the compiler, message <              files, command line definition, and help files.             6. Install STARLET.   O              * Do you want to install the Compaq Pascal definition files [YES]?a  @              The Compaq Pascal kit contains definition files forA              OpenVMS System Services and several run-time librarymD              facility codes. These system definition files are builtA              using information shipped with the OpenVMS operatingf              system.  A              The installation procedure determines whether Compaq_C              Pascal definition files already exist. If the files do_B              not exist, the installation procedure notifies you ofA              this and advises you to create the definition files.s  E                                          Installing Compaq Pascal 2-9_ _  _              9          If the Compaq Pascal definition files exist, bute;          the OpenVMS-supplied system definitions, which areG:          the basis for the Compaq Pascal definition files,:          have been modified since the last time the Compaq?          Pascal definition files were created, the installationh5          procedure advises you to recreate the files.E  ;          If the Compaq Pascal definition files exist and ifm>          the OpenVMS-supplied system definitions have not been)          modified since the last time thea9          Compaq Pascal definition files were created, the A          procedure tells you that it is not necessary to recreate           the definition files.         7. Install the examples.  K          * Do you want to install the Compaq Pascal example programs [YES]?e  8          The Compaq Pascal kit contains a set of example:          programs using many features of Compaq Pascal and=          OpenVMS. The examples are installed in the directoryd<          SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]. You can access?          them using the logical PASCAL$EXAMPLES, if you run then=          optional startup file SYS$STARTUP:PASCAL$STARTUP.COM           (see Section 3.3).           8. Save previous compiler.  I          * Do you want to save your existing Compaq Pascal compiler [NO]?t  <          The Compaq Pascal kit contains support to save your:          existing Compaq Pascal compiler for access later.;          The installation provides various command files toc>          display and select the saved Compaq Pascal compilers..          See Section 1.4 for more information.         9. Purge files.r  J          * Do you want to purge files replaced by this installation [YES]?  9          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 8          with no danger of deleting any saved compilers.  =       10.Choose the Installation Verification Procedure (IVP)e          option.   2-10  Installing Compaq Pascal    t              ?              The installation procedure now asks if you want to C              run the IVP. The IVP for Compaq Pascal checks that thesC              installation is successful. Compaq recommends that youy              run the IVP.   G              * Do you want to run the IVP after the installation [YES]?   @              This kit contains an IVP that is used to verify theD              correct installation of the Compaq Pascal compiler. The              IVP is located in:   $              SYS$TEST:PASCAL$IVP.COM  B              After Compaq Pascal is installed, you can run the IVPC              independently to verify that the software is availableRB              on your system. You might need to run the IVP after aE              system failure to make sure that users can access Compaq1              Pascal.                                                      E                                         Installing Compaq Pascal 2-11_ _  _              1       11.Respond to license registration queries.             Product:      PASCAL           Producer:     Compaqo          Version:      5.7"          Release Date: dd-mmm-yyyy  M          * 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 registered9          and loaded your Product Authorization Key (PAK).s  A          If you have not registered and loaded your PAK, you mustn?          answer NO to this question. You must register and loadm?          your PAK to successfully complete the installation. Ife@          you have not done so, you should stop the installation,7          register and load your PAK, and then start thet&          installation procedure again.  %       12.Read informational messages.r  =          At this point, the installation procedure displays ah<          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 newd?          or modified files to their target directories, updates A          help files, and updates DCL tables, if necessary. If youu?          chose to have files purged, that work is done now. The (          following message is displayed:  A          %VMSINSTAL-I-MOVEFILES, files will now be moved to theire"              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:  T          ** 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         *t;           *-----------------------------------------------*i   2-12  Installing Compaq Pascal                   ,           14.End the installation procedure.  D              Installation of Compaq Pascal V(n.n) completed at hh:mm  .              VMSINSTAL procedure done at hh:mm  A              These messages indicate that the entire installation,#              procedure is complete.   ;              You can now log out of the privileged account:r                $ LOGOUT :              SYSTEM     logged out at dd-mmm-yyyy 20:20:02  B             ________________________ Note ________________________  ?             VMSINSTAL deletes or changes entries in the processo@             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.  B             ______________________________________________________       2.2 Error Recovery  @           If errors occur during the installation itself or whenC           the Installation Verification Procedure (IVP) is running, B           VMSINSTAL displays failure messages. If the installation/           fails, you see the following message:   T           %VMSINSTAL-E-INSFAIL, The installation of Compaq Pascal V(n.n) has failed.  3           If the IVP fails, you see these messages:m  N           The Compaq Pascal V(n.n) Installation Verification Procedure failed.  L           %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:   7           o  The operating system version is incorrect.   =           o  Quotas necessary for successful installation are               insufficient.  D           o  System parameter values for successful installation are              insufficient.  :           o  The OpenVMS help library is currently in use.  E                                         Installing Compaq Pascal 2-13                    @       o  The product license has not been registered and loaded.  ?       For descriptions of the error messages generated by theseL9       conditions, see the OpenVMS documentation on systemp9       messages, recovery procedures, and OpenVMS software 9       installation. If you are notified that any of these A       conditions exist, you should take the appropriate action asa?       described in the message. For information on installation $       requirements, see Section 1.5.                                                                         2-14  Installing Compaq Pascal s  o                    E                                                                     3 E     _________________________________________________________________   E                                        After Installing Compaq Pascalc    B           Compaq Pascal is now installed and can be invoked by allC           users with the PASCAL command. The following tasks can ber3           performed after installing Compaq Pascal:   B           o  Running the Installation Verification Procedure (IVP)              separately_  :           o  Editing the system startup and shutdown files  6           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  A           You usually run the Installation Verification ProcedureF?           (IVP) during installation. If you want to run the IVP ?           separately to ensure the integrity of installed filestE           should system problems occur, execute the following command            procedure:  $           $ @SYS$TEST:PASCAL$IVP.COM  C           If the IVP fails for any reason, the following message is            displayed:  0           Compaq Pascal VERSION V5.n TEST FAILED  !     3.2 User Account Requirements   B           Several products cannot be used unless certain privilege>           and quota requirements are met by user accounts. The=           following sections describe the privilege and quota 9           requirements needed to work with Compaq Pascal.o  E                                    After Installing Compaq Pascal 3-1i o  w               3.2.1  Privilegesi  <       Compaq Pascal does not require any special privileges.;       There is no benefit from installing the Compaq Pascalo       compiler with privileges.A  
 3.2.2  QuotasA  &       See Section 3.4 for information.   3.3  Editing System Filesw  9       You can edit the system startup file to provide fors       automatic startup of9       Compaq Pascal when your system is rebooted. Use the A       optional startup file to define the PASCAL$EXAMPLES logical >       name and to install Compaq Pascal as a shared image (see       Section 3.4.2).h  @       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:i  '       $ @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 environmento@       files, you can increase the compilation speed by modifying?       the FILLM quota of those processes that run the compiler.y8       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 Pascaln    t              4     3.4.2 Installing Compaq Pascal as a Shared Image  ?           If you expect Compaq Pascal to be used extensively onqD           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 systemC           that is currently running, use the optional Compaq Pascalx           startup file:e  -                SYS$STARTUP:PASCAL$STARTUP.COM[  D           Compaq recommends that you install Compaq Pascal as sharedA           on a system that has been rebooted recently because the D           available space in the global page table is less likely to           be fragmented.  A           The requirements for additional global pages and globali7           sections are listed in section Section 1.5.2.%  D     3.4.3 Improving Compaq Pascal Compilation Performance on OpenVMS           Alpha Systems   C           For many user applications, the Compaq Pascal for OpenVMSuE           Alpha compiler requires significantly more system resourcess?           than Compaq Pascal for OpenVMS VAX. The compiler will ?           sometimes fail with a "%LIB-E-INSVIRMEM, insufficiente>           virtual memory" error. Also, for very large programs@           (greater than 10,000 lines) there could be a report of)           an extremely long compile time.t  >           The following sections explain why Compaq Pascal forB           OpenVMS Alpha requires more memory, and suggests actions1           to be taken to avoid resource problems.f  ?           The Alpha architecture is a RISC (Reduced Instructionf?           Set Computer) architecture. The VAX architecture is ae?           CISC (Complex Instruction Set Computer) architecture.oB           The main distinguishing characteristic of a RISC machine?           is that it has few instructions, and each instructionrC           does a small amount of work. A CISC machine generally haswC           many instructions, most of which perform many complicated !           operations in one step.n  =           By reducing the amount of work that is done in eachuC           instruction (and by reducing the number of instructions),MC           the complexity of the hardware is reduced. This reductioneB           in complexity allows the hardware designers to raise the  E                                    After Installing Compaq Pascal 3-3                    A       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 compilersA       for these architectures generally must do a great deal moreAA       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 musth=       determine how to make the best use of registers and on-iA       chip data cache because reads and writes to main memory arei<       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 internalA       representation of the entire Pascal program, and repeatedlyu>       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 CompaqO&       Pascal for OpenVMS VAX compiler.                                              # 3-4  After Installing Compaq Pascale s  l              C           The Compaq Pascal for OpenVMS Alpha compiler will require ?           more resources than the Compaq Pascal for OpenVMS VAX C           compiler because it must do more work. However, there arer@           some things that can be done to reduce system resource           usage:  D           o  Use the /NOOPTIMIZE qualifier when "checking" programs.  @              The optimizer is one of the biggest users of systemA              resources in the Pascal compiler and is turned on by B              default. Also, the higher the optimization level, the2              more memory required by the compiler.  !           o  Check system tuning.i  ?              Since the Pascal compiler often needs a great deale?              of virtual memory, increase working-set limits forr>              developers that use the compiler. This results in?              decreased paging and improvements in compile time.d  !           o  Check program sizes.   =              The bigger the program is, the more resources its              requires.  D           Section 3.4.3.1 and Section 3.4.3.2 provide basic guidanceA           about memory requirements for Compaq Pascal programs on            OpenVMS Alpha.  D           In many tuning exercises, it is instructive to work with aD           relatively quiet system, submit batch jobs, and retain the'           log files for later analysis.   B             ________________________ Note ________________________  ?             The guidance in the following section is based on ahB             study of a set of large modules. Please note that your             results may differ.i  B             ______________________________________________________  =           For detailed information on OpenVMS tuning, see the D           OpenVMS System Manager's Manual, sections "Managing System?           Parameters" and "Managing System Page, Swap, and Dumpt           Files".t  E                                    After Installing Compaq Pascal 3-5t                     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 ofC,       virtual memory available to a process:  >       o  The system generation parameter VIRTUALPAGECNT, whichA          sets an upper bound on the number of pagelets of virtualC.          memory for any process in the system.  @       o  The AUTHORIZE parameter PGFLQUOTA, which determines theA          number of pagelets a process can reserve in the system'st          page file(s).  =       After an "insufficient virtual memory" error, issue then@       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:s         SHOW PROCESS/ACCOUNTINGP  <       If the peak size is at the system generation parameter?       VIRTU you will need to raise this value. If the peak sizee=       is below VIRTUALPAGECNT, and at or above PGFLQUOTA, run @       AUTHORIZE to increase PGFLQUOTA for the Pascal users. PeakA       size can exceed PGFLQUOTA because some virtual memory, suchi@       as read-only image code, is not allocated page file space.  ;       It is difficult to predict precisely how much virtualt?       memory will be required for a compilation, but a startingf>       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 programC&          (including all INCLUDE files.  ?       The resulting figure can then be used as a starting pointh?       for the system generation parameter VIRTUALPAGECNT. Placeh@       a line in the parameter file SYS$SYSTEM:MODPARAMS.DAT. For?       example, if you estimate 370,000 pages, add the following 0       line in MODPARAMS, run AUTOGEN and reboot.  !       MIN_VIRTUALPAGECNT = 400000y  # 3-6  After Installing Compaq Pascaln t  t              @           If the compilation now completes successfully, use the?           command SHOW PROCESS/ACCOUNTING to determine the Peak E           Virtual Size; if the actual peak is significantly less than B           the value computed above, you can reduce VIRTUALPAGECNT.  C           When modifying VIRTUALPAGECNT and PGFLQUOTA, you may also 5           need to increase the size of the page file.   $     3.4.3.2 Required Physical Memory  :           When dealing with physical memory you must know:  1           o  If there enough memory on the system   ;           o  If enough available to the process running thes              compilation  @           If the physical memory on the system is too small, theC           command LOGOUT/FULL (which is automatically issued at theK@           end of a batch job) will show a high number of faults,A           for example, > 100,000 for a single compilation, and antE           "Elapsed time" that greatly exceeds the "Charged CPU time",oC           as the system waits for disk I/Os to resolve page faults.o>           In this situation, tuning attempts may be of limited           benefit.  ?           If the physical memory on the system is adequate, but A           the physical memory allotted to the process running thenA           compilation is too small, you may still observe a largesE           number of faults, but elapsed time may remain closer to CPUeE           time. This is because OpenVMS resolves page faults from the C           page caches (free list, modified list) whenever possible,dD           avoiding the relatively slow disk I/Os. In this situation,.           basic tuning may also be beneficial.  B           The amount of physical memory required will vary, but it@           should be a large fraction of the process peak virtualC           size-as close to 1.0 as practical. The reason for this istC           that the compiler makes multiple passes over the internalsE           representation of the program; therefore a page which fallscD           out of the working set in one pass is probably going to be-           needed again on the very next pass.l  E           The physical memory present on the system can be determinedoB           by the command SHOW MEMORY/PHYSICAL. The physical memoryB           used by the compilation is reported as "Peak working setD           size" by the command SHOW PROCESS/ACCOUNTING or at the end           of a batch log file.  E                                    After Installing Compaq Pascal 3-7                    =       More physical memory can be made available to a processt<       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 generation8       parameter WSMAX and the corresponding WSEXTENT (in?       AUTHORIZE). Such adjustments must be attempted with great A       caution, as the system may hang if memory is oversubscribed A       and you create a situation where OpenVMS effectively has no         options to reclaim memory.  6       The following guidelines have been found useful:  8       o  Set the Pascal users' WSEXTENT (in AUTHORIZE or*          INITIALIZE/QUEUE) to match WSMAX.  8       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.2          to manage memory to meet varying demands.  ?       o  Use AUTOGEN. AUTOGEN will attempt to make a consistenti>          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 physicalN>          memory. This value is reasonable for a workstation or6          multi-user system with many active processes.  =       o  WSMAX can be increased to a somewhat larger value byT>          editting MODPARAMS.DAT. For a system with 64 MByte ofA          physical memory, try setting WSMAX to no more than abouti<          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 PascalC a  a              &     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 aA           rough appreciation for the effect of physical memory onh7           compilation time, the following can be noted:t  @           o  When the amount of physical memory available to the@              processes matched the amount of virtual memory, the7              elapsed times were close to the CPU times.   D           o  As the physical memory was reduced, CPU times rose only)              slightly, about ten percent._  C           o  As the physical memory was reduced, elapsed times were D              elongated, at the rate of about one hour for each 100MBC              of difference between Peak Virtual Size and the actualrD              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 whereA              about 180MB of physical memory was available to usersE              processes, the compile required about three hours longer $              than on a 512MB system.  D           Your results will be strongly affected by the speed of theC           devices that are used for paging. Both virtual memory andrA           physical memory requirements can be reduced by breaking 0           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 Compaq4           Pascal, take one of the following actions:  B           o  If you have a basic or DECsupport Software Agreement,=              call your Customer Support Center (CSC). The CSCpC              provides telephone support for high-level advisory andt!              remedial assistance.n  C           o  If you have a Self-Maintenance Software Agreement, youa<              can submit a Software Performance Report (SPR).  C           o  If you purchased Compaq Pascal within the last 90 daysiE              and you think the problem is caused by a software error,n#              you can submit an SPR.   E                                    After Installing Compaq Pascal 3-9i p  i              >       If you find an error in the Compaq Pascal documentation,?       please fill out one of the Reader's Comments forms at the.A       back of the document containing the error and send the formdA       to Compaq. Please include the section and page number where        the error occurred.n  >       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 CompaqA          Pascal being used. Demonstrate the problem with specifict          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.  A       4. If the program is longer than 50 lines, submit a copy ofS?          the program on machine-readable media (floppy diskette ?          or magnetic tape). If necessary, also submit a copy ofp;          the program library used to build the application.o  @       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 enought@       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                       E                                                                     AyE     _________________________________________________________________   E                                                   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. DependingB           on which version of layered products or which version ofC           OpenVMS you have on your system, you might see additionalcD           messages and questions when you perform your installation.  C           The Compaq Pascal installation procedure installs several >           files on your system and defines some logical names.B           The file names are listed at the end of the installation%           procedure (see Appendix A).   E           The PASCAL$EXAMPLES logical name is entered into the systemo@           logical name table when the PASCAL$STARTUP.COM commandB           file is invoked. This name points to the location of the*           optional Compaq Pascal examples.  C           The sample installation assumes that DECnet has been shut D           down, that no users are logged on to your system, and that@           OPTIONS N is specified to print the release notes. TheC           Installation Verification Procedure (IVP) runs at the endr           of the installation.             $ @vmsinstal  G            OpenVMS AXP Software Product Installation Procedure V6.2-1H3C  %           It is 14-APR-1999 at 13:32.p  9           Enter a question mark (?) at any time for help.C  H           * Are you satisfied with the backup of your system disk [YES]?R           * Where will the distribution volumes be mounted: dka300:[pascal057.kit]  T           Enter the products to be processed from the first distribution volume set.           * Products: pascal057n>           * Enter installation options you wish to use (none):3           The following products will be processed:   E                                               Sample Installation A-1m    i                       PASCAL V5.7e  5        Beginning installation of PASCAL V5.7 at 13:32   <       %VMSINSTAL-I-RESTORE, Restoring product save set A ...Q       %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.   P         Copyright Digital Equipment Corporation 1994, 1999. All rights reserved.  F         Restricted Rights: Use, duplication, or disclosure by the U.S.J         Government is subject to restrictions as set forth in subparagraphJ         (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR*         52.227-14 Alt. III, as applicable.  E         This software is proprietary to and embodies the confidential I         technology of Digital Equipment Corporation.  Possession, use, or K         copying of this software and media is authorized only pursuant to a H         valid written license from Digital or an authorized sublicensor.  F        *-------------------------------------------------------------*F        *              Installation Command Procedure for             *F        * Compaq Pascal V5.7 compiler, definition files, and examples *F        *-------------------------------------------------------------*  P         The Compaq Pascal V5.7 kit contains the compiler, message files, commandP         line definition and help files.  These files require 17000 blocks duringE         installation and will occupy 16500 blocks after installation.X  @       * Do you want to install the Compaq Pascal compiler [YES]?  O         The Compaq Pascal V5.7 kit contains definition files for OpenVMS SystempM         Services and several Run-Time Library Facility codes.  The definitionsL         files require 11500 blocks during installation and will occupy 10000"         blocks after installation.  S         In addition, if you have Compaq Pascal compilers that were saved from priorOM         upgrades, the definition files will be built with the oldest possiblenR         compiler to allow for the older compilers to inherit the newly constructed         definition files.   O         The OpenVMS-supplied system symbol definitions, which are the basis forrN         Compaq Pascal definition files (STARLET.PAS and others), have not beenL         modified since the last time the Compaq Pascal definition files wereN         created.  It is not necessary to recreate the Compaq Pascal definition         files at this time.   H       * Do you want to install the Compaq Pascal definition files [YES]?   A-2  Sample Installation                   O             The Compaq Pascal V5.7 kit contains a set of example programs using R             many features of Compaq Pascal and OpenVMS.  The example files requireE             150 blocks during installation and will occupy 150 blocks              after installation.   L           * Do you want to install the Compaq Pascal example programs [YES]?  U             The Compaq Pascal kit is capable of copying your existing Pascal compiler_U             for later use.  The kit will provide command files to show which versionstY             of Compaq Pascal are on the system, to select a non-default compiler version, W             and to select which compiler is the default compiler.  See the installation_>             guide for more information on these command files.  J           * Do you wish to save your existing Compaq Pascal compiler [NO]?  K           * Do you want to purge files replaced by this installation [YES]? D           * Do you want to run the IVP after the installation [YES]?  &                   Product:      PASCAL#                   Producer:     DECf#                   Version:      5.7t+                   Release Date: 20-JAN-1999e  R           * Does this product have an authorization key registered and loaded? yes  K             This kit contains a file summarizing the new features, changes,sL             restrictions, and compatibility issues in this release of CompaqL             Pascal.  This file is named PASCAL057.RELEASE_NOTES and has beenL             placed in SYS$HELP:.  This file contains information valuable toQ             Compaq Pascal programmers.  Please inform your user community of thise             file's existence.c  J             In addition, a file describing record layout considerations toN             improve performance and/or coexistance between VAX and AXP systemsH             has been provided in SYS$HELP:PASCAL_RECORD_LAYOUT_GUIDE.MEM  R             This kit will construct the following definition files in SYS$LIBRARY:                E                                               Sample Installation A-3r o  P                        STARLET.PAS/PENI          PASCAL$ACLEDIT_ROUTINES.PAS/PEN      PASCAL$CLI_ROUTINES.PAS/PENeI          PASCAL$CONV_ROUTINES.PAS/PEN         PASCAL$DCX_ROUTINES.PAS/PENoI          PASCAL$DTK_ROUTINES.PAS/PEN          PASCAL$EDT_ROUTINES.PAS/PENcI          PASCAL$FDL_ROUTINES.PAS/PEN          PASCAL$LIB_ROUTINES.PAS/PENfJ          PASCAL$LBR_ROUTINES.PAS/PEN          PASCAL$MAIL_ROUTINES.PAS/PENI          PASCAL$MTH_ROUTINES.PAS/PEN          PASCAL$NCS_ROUTINES.PAS/PEN I          PASCAL$OTS_ROUTINES.PAS/PEN          PASCAL$PPL_ROUTINES.PAS/PENlI          PASCAL$PSM_ROUTINES.PAS/PEN          PASCAL$SMB_ROUTINES.PAS/PEN I          PASCAL$SMG_ROUTINES.PAS/PEN          PASCAL$SOR_ROUTINES.PAS/PEN I          PASCAL$STR_ROUTINES.PAS/PEN          PASCAL$TPU_ROUTINES.PAS/PEN I          PASCAL$C_ROUTINES.PAS/PEN            PASCAL$CMA_ROUTINES.PAS/PENl$          PASCAL$CVT_ROUTINES.PAS/PEN  E         For compatibility with existing programs, symbols in previous J         versions of STARLET.PAS will remain in STARLET.PAS even though theJ         symbols might be associated with a run-time library.  For example,?         the SMG$K_* symbols are still in STARLET.PAS instead ofPP         PASCAL$SMG_ROUTINES.PAS, while the SMG$ entry points and the SMG message/         numbers are in PASCAL$SMG_ROUTINES.PAS.R  R         This kit provides several examples in SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL].T         The names of the files reflect the topic being demonstrated by the programs.  E         The IVP (Installation Verification Procedure) will be left in I         SYS$TEST:PASCAL$IVP.COM.  After the installation is complete, youhN         can invoke the command file at any time to reverify that Compaq Pascal+         is installed and working correctly.l  S         An optional startup file has been placed in SYS$STARTUP:PASCAL$STARTUP.COM. K         The file installs the Compaq Pascal compiler, Run-Time Library, and,J         message files as shared images to improve the performance of usingL         the Compaq Pascal compiler or applications written in Compaq Pascal.F         If you wish to use this file, add the following DCL command to%         SYS$MANAGER:SYSTARTUP_VMS.COMe  +           $ @SYS$STARTUP:PASCAL$STARTUP.COM   E         All questions regarding the installation have now been asked.rF         The installation of Compaq Pascal V5.7 will now continue for 5E         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                   8             Installing Compaq Pascal definition files...@           %VMSINSTAL-I-RESTORE, Restoring product save set C ...  M             Generating STARLET.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... ]             Generating PASCAL$ACLEDIT_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Y             Generating PASCAL$CLI_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...iZ             Generating PASCAL$CONV_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...Y             Generating PASCAL$DCX_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Y             Generating PASCAL$DTK_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...OY             Generating PASCAL$EDT_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...rY             Generating PASCAL$FDL_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...fY             Generating PASCAL$LIB_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V54-041.EXE... Y             Generating PASCAL$LBR_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Z             Generating PASCAL$MAIL_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...Y             Generating PASCAL$MTH_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V54-041.EXE...tY             Generating PASCAL$NCS_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...iY             Generating PASCAL$OTS_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V54-041.EXE...UY             Generating PASCAL$PPL_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...hY             Generating PASCAL$PSM_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...yY             Generating PASCAL$SMB_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...dY             Generating PASCAL$SMG_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...UY             Generating PASCAL$SOR_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...lY             Generating PASCAL$STR_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Y             Generating PASCAL$TPU_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... Y             Generating PASCAL$CVT_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE...tY             Generating PASCAL$CMA_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V50-009.EXE... W             Generating PASCAL$C_ROUTINES.PAS/PEN using SYS$SYSTEM:PASCAL-V52-026.EXE...t  8             Installing Compaq Pascal example programs...@           %VMSINSTAL-I-RESTORE, Restoring product save set D ...  T             Your OpenVMS system will now be updated to include the following new and             modified files:n                        E                                               Sample Installation A-5n o  t              A            SYS$SYSTEM:PASCAL.EXE                            [new] A            SYS$HELP:PASCAL057.RELEASE_NOTES                 [new]yA            SYS$COMMON:[SYSTEST.PASCAL]PASCAL$IVP.PAS        [new] F            SYS$HELP:HELPLIB.HLB                             [modified]A            SYS$HELP:PASCAL_RECORD_LAYOUT_GUIDE.MEM          [new]eF            SYS$LIBRARY:DCLTABLES.EXE                        [modified]A            SYS$LIBRARY:LIBDEF.PAS                           [new]lA            SYS$LIBRARY:MTHDEF.PAS                           [new]gA            SYS$LIBRARY:PASDEF.PAS                           [new]pA            SYS$LIBRARY:PASSTATUS.PAS                        [new] A            SYS$LIBRARY:SIGDEF.PAS                           [new]mA            SYS$MESSAGE:PASCALER1.EXE                        [new]sA            SYS$MESSAGE:PASCALER2.EXE                        [new]rA            SYS$STARTUP:PASCAL$STARTUP.COM                   [new]nA            SYS$SYSTEM:PASCAL$SHOW_VERSIONS.COM              [new]sA            SYS$SYSTEM:PASCAL$SET_VERSION.COM                [new]uA            SYS$SYSTEM:PASCAL$DEFAULT_VERSION.COM            [new]iA            SYS$TEST:PASCAL$IVP.COM                          [new]nA            SYS$COMMON:[SYSTEST.PASCAL]PASSTR$IVP.PAS        [new] A            SYS$LIBRARY:STARLET.PAS                          [new] A            SYS$LIBRARY:STARLET.PEN                          [new]aA            SYS$LIBRARY:PASCAL$ACLEDIT_ROUTINES.PAS          [new]rA            SYS$LIBRARY:PASCAL$ACLEDIT_ROUTINES.PEN          [new] A            SYS$LIBRARY:PASCAL$CLI_ROUTINES.PAS              [new] A            SYS$LIBRARY:PASCAL$CLI_ROUTINES.PEN              [new] A            SYS$LIBRARY:PASCAL$CONV_ROUTINES.PAS             [new] A            SYS$LIBRARY:PASCAL$CONV_ROUTINES.PEN             [new]nA            SYS$LIBRARY:PASCAL$DCX_ROUTINES.PAS              [new]mA            SYS$LIBRARY:PASCAL$DCX_ROUTINES.PEN              [new]lA            SYS$LIBRARY:PASCAL$DTK_ROUTINES.PAS              [new]:A            SYS$LIBRARY:PASCAL$DTK_ROUTINES.PEN              [new]nA            SYS$LIBRARY:PASCAL$EDT_ROUTINES.PAS              [new] A            SYS$LIBRARY:PASCAL$EDT_ROUTINES.PEN              [new]tA            SYS$LIBRARY:PASCAL$FDL_ROUTINES.PAS              [new]SA            SYS$LIBRARY:PASCAL$FDL_ROUTINES.PEN              [new] A            SYS$LIBRARY:PASCAL$LIB_ROUTINES.PAS              [new] A            SYS$LIBRARY:PASCAL$LIB_ROUTINES.PEN              [new]tA            SYS$LIBRARY:PASCAL$LBR_ROUTINES.PAS              [new]bA            SYS$LIBRARY:PASCAL$LBR_ROUTINES.PEN              [new] A            SYS$LIBRARY:PASCAL$MAIL_ROUTINES.PAS             [new]rA            SYS$LIBRARY:PASCAL$MAIL_ROUTINES.PEN             [new]tA            SYS$LIBRARY:PASCAL$MTH_ROUTINES.PAS              [new]aA            SYS$LIBRARY:PASCAL$MTH_ROUTINES.PEN              [new]      A-6  Sample Installation                   E                SYS$LIBRARY:PASCAL$NCS_ROUTINES.PAS              [new]tE                SYS$LIBRARY:PASCAL$NCS_ROUTINES.PEN              [new] E                SYS$LIBRARY:PASCAL$OTS_ROUTINES.PAS              [new] E                SYS$LIBRARY:PASCAL$OTS_ROUTINES.PEN              [new]aE                SYS$LIBRARY:PASCAL$PPL_ROUTINES.PAS              [new].E                SYS$LIBRARY:PASCAL$PPL_ROUTINES.PEN              [new] E                SYS$LIBRARY:PASCAL$PSM_ROUTINES.PAS              [new]sE                SYS$LIBRARY:PASCAL$PSM_ROUTINES.PEN              [new].E                SYS$LIBRARY:PASCAL$SMB_ROUTINES.PAS              [new] E                SYS$LIBRARY:PASCAL$SMB_ROUTINES.PEN              [new] E                SYS$LIBRARY:PASCAL$SMG_ROUTINES.PAS              [new]eE                SYS$LIBRARY:PASCAL$SMG_ROUTINES.PEN              [new]yE                SYS$LIBRARY:PASCAL$SOR_ROUTINES.PAS              [new] E                SYS$LIBRARY:PASCAL$SOR_ROUTINES.PEN              [new]tE                SYS$LIBRARY:PASCAL$STR_ROUTINES.PAS              [new] E                SYS$LIBRARY:PASCAL$STR_ROUTINES.PEN              [new] E                SYS$LIBRARY:PASCAL$TPU_ROUTINES.PAS              [new] E                SYS$LIBRARY:PASCAL$TPU_ROUTINES.PEN              [new] E                SYS$LIBRARY:PASCAL$D_FLOAT.PAS                   [new] E                SYS$LIBRARY:PASCAL$D_FLOAT.PEN                   [new]_E                SYS$LIBRARY:PASCAL$G_FLOAT.PAS                   [new]aE                SYS$LIBRARY:PASCAL$G_FLOAT.PEN                   [new] E                SYS$LIBRARY:PASCAL$CVT_ROUTINES.PAS              [new] E                SYS$LIBRARY:PASCAL$CVT_ROUTINES.PEN              [new] E                SYS$LIBRARY:PASCAL$C_ROUTINES.PAS                [new] E                SYS$LIBRARY:PASCAL$C_ROUTINES.PEN                [new]eE                SYS$LIBRARY:PASCAL$CMA_ROUTINES.PAS              [new]hE                SYS$LIBRARY:PASCAL$CMA_ROUTINES.PEN              [new]eQ                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]CONSTRUCTOR_1.PAS         [new]eQ                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]FUNCTION_CALLS.PAS        [new] Q                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]HANDLER.PAS               [new]aQ                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]HELLOMOTIF.PAS            [new]pQ                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]HELLOMOTIF.UIL            [new] Q                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]IMPLEMENTATION_MODULE.PAS [new]nQ                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]INITIAL_STATE_1.PAS       [new] Q                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]INITIAL_STATE_2.PAS       [new]uQ                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]INTERFACE_MODULE.PAS      [new] Q                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]LIB$FIND_FILE.PAS         [new] Q                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]MAIN_PROGRAM.PAS          [new]CQ                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]RFA_READ.PAS              [new] Q                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SCHEMA_PARAMETERS.PAS     [new] Q                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SCHEMA_PARAMETERS.DAT     [new] Q                SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SMG_EXAMPLE.PAS           [new]u    E                                               Sample Installation A-7                    M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$ASCTIM_AND_GETTIM.PAS [new]VM            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$CHECK_ACCESS.PAS      [new]TM            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$DCLEXH.PAS            [new]oM            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$DEVICE_SCAN.PAS       [new] M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$FAO.PAS               [new]gM            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETDVI.PAS            [new] M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETJPI.PAS            [new].M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETQUI.PAS            [new]aM            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETSYI.PAS            [new] M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$GETUAI.PAS            [new] M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$PROCESS_SCAN.PAS      [new] M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$PUTMSG.PAS            [new]-M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$SNDJBC.PAS            [new] M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]SYS$TRNLNM.PAS            [new].M            SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]USE_XABDAT.PAS            [new]-T       %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  8        *-----------------------------------------------*8        *      Installation Verification Procedure      *8        *          for Compaq Pascal V5.7               *8        *-----------------------------------------------*  P         Copyright Digital Equipment Corporation 1994, 1999. All rights reserved.  F         Restricted Rights: Use, duplication, or disclosure by the U.S.J         Government is subject to restrictions as set forth in subparagraphJ         (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR*         52.227-14 Alt. III, as applicable.  E         This software is proprietary to and embodies the confidentialsI         technology of Digital Equipment Corporation.  Possession, use, or K         copying of this software and media is authorized only pursuant to a H         valid written license from Digital or an authorized sublicensor.  Q       ** Successful Installation of Compaq Pascal V5.7 on 14-APR-1999 at 13:35 **e8                 Compiler Version = Compaq Pascal V5.7-80  8        *-----------------------------------------------*8        *    Installation Verification Procedure for    *8        *       Compaq Pascal STARLET libraries         *8        *-----------------------------------------------*  P         Copyright Digital Equipment Corporation 1994, 1999. All rights reserved.     A-8  Sample Installation    a              J             Restricted Rights: Use, duplication, or disclosure by the U.S.N             Government is subject to restrictions as set forth in subparagraphN             (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR.             52.227-14 Alt. III, as applicable.  I             This software is proprietary to and embodies the confidentialhM             technology of Digital Equipment Corporation.  Possession, use, or O             copying of this software and media is authorized only pursuant to a L             valid written license from Digital or an authorized sublicensor.  V           ** Compaq Pascal STARLET libraries are installed and functioning normally **9            Installation of PASCAL V5.7 completed at 13:35                                                                   E                                               Sample Installation A-9S