       !                      Compaq COBOL C                      for_OpenVMS_Alpha_Systems_____________________ '                      Installation Guide   .                      Order Number: AA-PXE7J-TE  !                      October 2000   E                      This guide describes how to install Compaq COBOL F                      (formerly known as DIGITAL COBOL or DEC COBOL) onH                      an Alpha system running the OpenVMS Alpha operating                      system.  G                      This guide applies to Compaq COBOL Version 2.7 and >                      any maintenance updates for that version.          D                      Revision/Update Information: This manual super-G                                                   sedes the Version 2.6 B                                                   Compaq COBOL forG                                                   OpenVMS Alpha Systems E                                                   Installation Guide.   G                      Operating System & Version:  OpenVMS Alpha Version G                                                   6.2 or higher. Future F                                                   releases may requireB                                                   higher versions.  F                      Software Version:            Compaq COBOL Version5                                                   2.7                       0                      Compaq Computer Corporation#                      Houston, Texas                  E            __________________________________________________________   -             2000 Compaq Computer Corporation   B            COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo:            Registered in U.S. Patent and Trademark Office.  A            OpenVMS and Tru64 are trademarks of Compaq Information #            Technologies Group, L.P.   @            Microsoft, MS-DOS, Win32, Windows, and Windows NT are/            trademarks of Microsoft Corporation.   D            Motif, OSF/1, UNIX, and X/Open are trademarks of The Open            Group.   E            All other product names mentioned herein may be trademarks )            of their respective companies.   D            Confidential computer software. Valid license from Compaq?            required for possession, use, or copying. Consistent D            with FAR 12.211 and 12.212, Commercial Computer Software,B            Computer Software Documentation, and Technical Data forE            Commercial Items are licensed to the U.S. Government under 0            vendor's standard commercial license.  @            Compaq shall not be liable for technical or editorialC            errors or omissions contained herein. The information in =            this document is subject to change without notice.   B            THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS"D            WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUTA            OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. =            IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, A            CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER D            DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGESA            FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR A            LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN D            ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND WHETHER IN?            AN ACTION OF CONTRACT OR TORT, INCLUDING NEGLIGENCE.   E            The limited warranties for Compaq products are exclusively E            set forth in the documentation accompanying such products. ?            Nothing herein should be construed as constituting a *            further or additional warranty.  E                                                                ZK6295   @            This document was prepared using DECdocument, Version            3.3-1b.                               C    ________________________________________________________________   C                                                            Contents     C    Preface..................................................      v     -    1  Preparing for Compaq COBOL Installation   C          1.1   Reading the Online Release Notes.............    1-1 C          1.2   Registering Your Software License............    1-2 C          1.3   Optional Software............................    1-3 <          1.4   Checks and Requirements for Installing CompaqC                COBOL........................................    1-3 C          1.5   Installation Procedure Requirements..........    1-3 C          1.5.1     Privileges...............................    1-4 C          1.5.2     System Parameters........................    1-4 C          1.5.3     Disk Space...............................    1-5 C          1.5.4     Backing Up Your System Disk..............    1-5 C          1.6   Standard System Maintenance Procedures.......    1-5 4          1.6.1     Calculating the Values for GlobalC                    Pagelets and Global Sections.............    1-6 8          1.6.2     Changing System Parameter Values withC                    AUTOGEN..................................    1-6       2  Installing Compaq COBOL   C          2.1   Installation Procedure.......................    2-1       3  After Installation  4          3.1   Running the Installation VerificationC                Procedure Separately.........................    3-1 C          3.2   Customizing Compaq COBOL Error Messages......    3-2 C          3.3   Making Compaq COBOL Usable on a VMScluster...    3-3 C          3.4   User Account Privileges......................    3-6 C          3.5   Installing Compaq COBOL as a Shared Image....    3-6   C                                                                 iii                  E            3.6   REFORMAT Utility.............................    3-6           A  Sample Installations        B  Recovering from Errors  :            B.1   Failures During Compaq COBOL and Run-TimeE                  Library Installations........................    B-1 E            B.2   Problems During Compaq COBOL Use.............    B-3 E            B.2.1     Run-Time Library Mismatch................    B-4 E            B.2.2     Other Problems...........................    B-4           Tables   6            1-1       Minimum Required System ParameterE                      Values...................................    1-4   E            1-2       Disk Space Requirements..................    1-5                                                         iv                            H         ________________________________________________________________  H                                                                  Preface      G               This guide describes how to install Compaq COBOL on Alpha E               processors that are running the OpenVMS Alpha operating                system.   E               Keep this document with your distribution kit. You will D               need it to install maintenance updates or to reinstall0               Compaq COBOL for any other reason.            Associated Documentation  G               In addition to this guide, the Compaq COBOL documentation )               set includes the following:   @               o  Compaq COBOL Reference Manual (revised for this                  release)   D               o  Compaq COBOL User Manual (revised for this release)  E               o  DIGITAL COBOL Multiplatform Overview & Compatibility                   Guide  8               o  DIGITAL COBOL DBMS Database Programming  =               o  Compaq COBOL Release Notes (see Section 1.1)   "               o  Compaq COBOL Help  E               o  Read Before Installing or Using Compaq COBOL Version ;                  2.7 for OpenVMS Alpha Systems cover letter   C               You may also find the following documentation useful:   5               o  Guide to Software License Management   B               o  Guide to Sharing Software on a Local Area Network  :               o  OpenVMS License Management Utility Manual  H                                                                        v                 -            o  OpenVMS System Manager's Manual                                                                                               vi                           Conventions   ?               The following conventions are used in this guide:   H               __________________________________________________________H               Convention____________________Meaning_____________________  E               [YES]                         Default answers to system C               [NO]                          questions are framed in C                                             square brackets. Simply H                                             press <Return> to accept the=                                             default response.   F               UPPERCASE                     In text, uppercase letters@                                             indicate the name of@                                             a command, a file, aC                                             parameter, a procedure, F                                             or a Compaq COBOL utility.  D               $ SET DEFAULT SYS$UPDATE      In interactive examples,E                                             prompts or displayed text A                                             appear in a monospace D                                             font. User input appearsH                                             in bold monospace. LowercaseE                                             indicates a name that you F                                             supply. Uppercase is to be;                                             typed as shown.   F               $                             The dollar sign is used toD                                             indicate the DCL prompt.H                                             This prompt may be different;                                             on your system.   E               <Ctrl/x>                      In procedures, a sequence F                                             such as <Ctrl/x> indicatesC                                             that you must hold down F                                             the key labeled Ctrl whileF                                             you press another key or aC                                             pointing device button.   H               n                             The minor (point) release ofG                                             Compaq COBOL in examples is G                                             shown by n, as in COBOL02n. E                                             For Version 2.7, you type H               ______________________________COBOL027.___________________  H                                                                      vii                       References   7            DIGITAL COBOL has been renamed Compaq COBOL.   E            In this manual, every use of OpenVMS Alpha and OpenVMS AXP D            means the OpenVMS Alpha operating system and every use ofC            Tru64 UNIX means the Compaq Tru64 UNIX operating system. D            Tru64 UNIX was formerly called DIGITAL UNIX or DEC OSF/1.  C            In this manual, every use of Oracle CDD/Repository means C            the Oracle CDD/Repository product of Oracle Corporation, A            every use of Oracle DBMS means the Oracle CODASYL DBMS E            product of Oracle Corporation, and every use of Oracle Rdb >            means the Oracle Rdb product of Oracle Corporation.  *      How to Order Additional Documentation  D            For information on pricing and where to buy documentationE            and other Compaq products in the United States and Canada, 0            please call toll-free 1-800-282-6672.        Reader's Comments  ?            Compaq appreciates your comments. If you find errors @            or want to comment about this manual, please send theB            manual title, order number, and your comments by one of!            the following methods:   '            o  Electronic Internet mail:   (                  LanguageDocs@compaq.com              o  Fax:                    603-884-0120 :                  Attn: Languages Documentation, ZKO2-3/K35  5            o  A letter sent to the following address:   ,                  Compaq Computer Corporation4                  Languages Documentation, ZKO2-3/K35$                  110 Spit Brook Road&                  Nashua, NH 03062-2698                  USA  	      viii                           Field Test Sites  A               The Compaq COBOL team would like to acknowledge the D               contributions of our field test sites in improving ourB               products. The people at these sites provided us withD               invaluable information, which ultimately resulted in a8               higher quality, more useful COBOL product.                                                                            H                                                                       ix                       H                                                                        1H         ________________________________________________________________  H                                  Preparing for Compaq COBOL Installation      D               Your bill of materials (BOM) and indented bills reportB               (BIL) specify the number and contents of your media.B               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.   H               Your distribution kit includes a letter titled Read BeforeF               Installing or Using Compaq COBOL Version 2.7 for OpenVMSG               Alpha Systems. The letter discusses important information G               that might not be included in this guide. You should read <               this letter before beginning the installation.  ,         1.1 Reading the Online Release Notes  @               Compaq COBOL provides online Release Notes. CompaqH               strongly recommends that you read the Release Notes beforeC               installing the product. The Release Notes may contain ;               information about changes to the application.   H               For information about accessing these Release Notes before?               installing Compaq COBOL, see Section 2.1, step 4.   E               The installed Release Notes for Compaq COBOL will be in !               the following file:   -               SYS$HELP:COBOL027.RELEASE_NOTES                 H                              Preparing for Compaq COBOL Installation 1-1           ,      Preparing for Compaq COBOL Installation*      1.2 Registering Your Software License  *      1.2 Registering Your Software License  C            Before you install and run Compaq COBOL Version 2.7 on a D            newly licensed node or cluster, you must first register aD            License Product Authorization Key (License PAK) using theD            License Management Facility (LMF). The License PAK may beD            shipped along with the kit if you ordered the license andC            media together; otherwise, it is shipped separately to a 0            location based on your license order.  ?            If you are installing Compaq COBOL as an update on a >            node or cluster already licensed for this software,B            you have already completed the License PAK registration            requirements.  B            If you are installing prerequisite or optional softwareE            along with Compaq COBOL, review the PAK status and install D            the PAKs for any prerequisite or optional software before$            you install Compaq COBOL.  A            If you are planning to use the Oracle DBMS programming @            capability, you must purchase the Compaq COBOL OracleD            DBMS programming license option, which includes a licenseD            PAK for use of this option. See the Compaq COBOL Software@            Product Description (SPD) for more information on the2            Oracle DBMS programming license option.  C            You must register and load your license for Compaq COBOLb@            before you start the installation in order to run theC            Installation Verification Procedure (IVP) and to use theO            software.  A            To register a license on OpenVMS, first log in to yourg@            SYSTEM account. You then have a choice of two ways to$            perform the registration:  B            o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. WhenD               it prompts you for information, respond with data from               your License PAK.   C            o  At the DCL prompt, enter the LICENSE REGISTER command @               with the appropriate qualifiers that correspond to&               License PAK information.    0      1-2 Preparing for Compaq COBOL Installation           H                                  Preparing for Compaq COBOL InstallationH                                    1.2 Registering Your Software License  F               If you plan to use Compaq COBOL on more than one node inF               a VMScluster, you will need to perform a license load onG               the other nodes after you complete this installation. SeeB               Section 3.3.  D               For complete information on using LMF, see the OpenVMS0               License Management Utility Manual.           1.3 Optional Software   G               You can use the following optional software together with_               Compaq COBOL:   &               o  Oracle CDD/Repository                 o  Oracle DBMS  F               o  Compaq Language Sensitive Editor/Source Code Analyzer&                  Version 4.5 or higher  ?         1.4 Checks and Requirements for Installing Compaq COBOLr  H               If you are installing Oracle Rdb or Oracle CDD/Repository,F               you should make certain that they have been successfullyA               installed before you begin to install Compaq COBOL.o@               To eliminate possible installation errors, execute@               the following command procedure to start up Oracle               CDD/Repository:w  *               $ @SYS$STARTUP:CDDSTRTUP.COM  /         1.5 Installation Procedure Requirements   D               This section describes the requirements for installingH               Compaq COBOL, which include process account quotas, system0               parameters, disk space, and so on.  B               Standard procedures for checking and setting various6               parameters are described in Section 1.6.            H                              Preparing for Compaq COBOL Installation 1-3 i  o      ,      Preparing for Compaq COBOL Installation,      1.5 Installation Procedure Requirements        1.5.1 Privileges   ?            To install Compaq COBOL, you must be logged in to an <            account that has SETPRV or at least the following            privileges:              o  BYPASS              o  CMKRNL              o  SYSLCK              o  SYSPRV  =            Privileges required for product use are defined inT            Section 3.4.         1.5.2 System Parameters  @            Table 1-1 lists the minimum required system parameterA            values for the installation. Depending on the kinds ofSD            programs and applications running at your site, you might0            need higher values for some settings.  E            Table_1-1_Minimum_Required_System_Parameter_Values________h  +                                     Minimum E            System_Parameter_________Value____________________________   (            Contiguous free global   7000            pagelets[1]  (            Global sections[1]          3  E            [1]These_values_represent_the_number_of_free_global_______   8            pagelets and global sections required for theB            installation, not the total number you need to run your%            system and other software. E            __________________________________________________________.  C               ________________________Note ________________________   ;               If you do not ensure that your system has the.A               necessary global pagelets and global section SYSGEN.A               parameters for the installation, the DCL tables can.2               become corrupted in some situations.  C               _____________________________________________________.  0      1-4 Preparing for Compaq COBOL Installation d         H                                  Preparing for Compaq COBOL InstallationH                                  1.5 Installation Procedure Requirements           1.5.3 Disk Space  G               The Compaq COBOL requirements for free disk storage space G               are different during installation and after installation.d<               Table 1-2 summarizes the storage requirements.  H               Table_1-2_Disk_Space_Requirements_________________________  A                                Blocks During         Blocks AftermH               Kit______________Installation__________Installation_______  H               Compaq_COBOL_____26,000________________22,000_____________  H               To determine the number of free disk blocks on the currentA               system disk, enter the following command at the DCL                prompt:l  )               $ SHOW DEVICE SYS$SYSDEVICE3  )         1.5.4 Backing Up Your System Disk.  G               Compaq recommends that you do a system disk backup before &               installing any software.  D               Use the backup procedures that are established at yourG               site. For details on performing a system disk backup, see F               the section on backing up the system disk in the OpenVMS&               System Manager's Manual.  2         1.6 Standard System Maintenance Procedures  >               This section explains how to do various standard               procedures:   @               o  Calculate values for global pagelets and global                  sections.  A               o  Change parameter values with the OpenVMS AUTOGENT#                  command procedure.             H                              Preparing for Compaq COBOL Installation 1-5 T  e      ,      Preparing for Compaq COBOL Installation/      1.6 Standard System Maintenance Procedures.  @      1.6.1 Calculating the Values for Global Pagelets and Global            Sections.  C            You must have an adequate number of free global pageletsi?            and global sections to install and run Compaq COBOL._=            First, determine how many free global pagelets and @            sections you have on your system, then use AUTOGEN toB            increase the global pagelets and global sections system#            parameters as necessary.n  >            The following DCL command will return a figure thatB            you can use as an approximation of the number of global            pagelets needed:l  /            $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE   B            You can use the WRITE command with the F$GETSYI lexicalB            function to find the number of free global pagelets and@            global sections on your system. The following exampleB            shows how to get this information at your terminal (the#            default for SYS$OUTPUT):m  9            $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")             158487            $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 
            24   @            Section 1.6.2 describes the procedures for increasing&            these values using AUTOGEN.  8      1.6.2 Changing System Parameter Values with AUTOGEN  =            Use the AUTOGEN command procedure to change system ?            parameters. AUTOGEN automatically adjusts values for C            parameters that are associated with the values you reset C            manually. To change system parameters with AUTOGEN, edit -            the SYS$SYSTEM:MODPARAMS.DAT file.t  B            To change a parameter value listed in this file, deleteE            the current value associated with that parameter and enterv            the new value.   >            To add a new parameter, add a line to the file thatA            includes both the name of the parameter and its value.             For example:               WSMAX = 8096   0      1-6 Preparing for Compaq COBOL Installation i         H                                  Preparing for Compaq COBOL InstallationH                               1.6 Standard System Maintenance Procedures  B               To modify incremental parameters such as free globalC               pagelets and global sections, use ADD_. The following @               example increases the global page setting by 2000:  !               ADD_GBLPAGES = 2000   D               Note that when you set the page file quota, you do notD               use a value that exceeds the amount of page file space&               available on the system.  G               After you make all your changes, exit from the editor and F               execute the AUTOGEN procedure to recalculate your systemH               parameters. The following command recalculates your system0               parameters and reboots the system:  2               $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT  D               When you specify REBOOT, AUTOGEN performs an automatic:               system shutdown and then reboots the system.  F                 ________________________Note  ________________________  A                 Any users logged on to the system are immediatelyb1                 disconnected during the shutdown.   E                 _____________________________________________________   E               The automatic reboot puts the new parameter values into                effect.s  C               The AUTOGEN utility automatically adjusts some of thesE               SYSGEN parameters based on the consumption of resourcesp?               since the last reboot. If you do not want to takeaA               advantage of this automatic adjustment, include the ?               NOFEEDBACK qualifier on the AUTOGEN command line.u  G               For more information about using AUTOGEN, see the OpenVMS/&               System Manager's Manual.              H                              Preparing for Compaq COBOL Installation 1-7                 H                                                                        2H         ________________________________________________________________  H                                                  Installing Compaq COBOL      D               After you register and load the license PAK (includingC               the COBOL DBMS PAK, if you have it), the installationnH               will take approximately 5 to 10 minutes, depending on your#               system configuration._  D               If you encounter any failures during installation, see               Appendix B.   "         2.1 Installation Procedure  F               As of Version 2.7, Compaq COBOL for OpenVMS Alpha is in-G               stalled with the POLYCENTER Software Installation utility H               (PCSI) instead of VMSINSTAL so that its components will beF               registered in the PCSI Registry on your system. When theE               PCSI PRODUCT command is used for later installations of G               kits, such as for OpenVMS Alpha, which contain components D               of the Compaq COBOL product (for example, the COBRTL),H               the PRODUCT command will check in the PCSI Registry to seeH               whether the registered version has a higher version numberD               than the one about to be installed. If so, the PRODUCTE               command will bypass the installation of that component.   F               Compaq COBOL for OpenVMS Alpha is packaged in three PCSI               kits:   D               o  A kit for the compiler for any OpenVMS Alpha system(                  Version 6.2 or higher: A                  [COBOL027.KIT]DEC-AXPVMS-COBOL-V0207-1209-1.PCSIs  G               o  A kit for the run-time library (RTL) for OpenVMS Alphao;                  systems Version 6.2 through Version 7.1-1: B                  [COBOL027.KIT]DEC-AXPVMS-COBRTL-V0207-603A-1.PCSI  D               o  A kit for the RTL for OpenVMS Alpha systems Version#                  7.1-2 and higher: aB                  [COBOL027.KIT]DEC-AXPVMS-COBRTL-V0207-603B-1.PCSI  H                                              Installing Compaq COBOL 2-1 g  D            Installing Compaq COBOL      2.1 Installation Procedure   C            Thus, you will install two kits: the appropriate RTL kit D            for your operating system, and then the compiler kit. TheE            RTL kit should be installed first. (Users who install only B            the RTL will need to install only the RTL kit specified'            for their operating system.)   A            To abort the installation procedure at any time, press D            Ctrl/Y. When you press Ctrl/Y, the installation procedure@            deletes all files it has created up to that point andB            exits to DCL level. To retry the installation procedure6            after pressing Ctrl/Y, proceed from Step 5.  A            When the system prompts you with a question during the_B            installation procedure, the default answer is listed in            brackets ([]).g  $            Step-by-Step Instructions  @            To install Compaq COBOL, perform the following steps:  A            1. Log in to a privileged account and set your default 1               device and directory to SYS$UPDATE.k                  Username: SYSTEMt                Password:  &               $ SET DEFAULT SYS$UPDATE  @               Your account must have the BYPASS, CMKRNL, SYSLCK,D               and SYSPRV privileges enabled. If your process has theB               SETPRV privilege, you can enable these privileges by+               typing the following command:T  C               $ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK,SYSPRV)t  A               To check whether you have these privileges enabled,e)               type the following command:   '               $ SHOW PROCESS/PRIVILEGES   <            2. Ascertain that the license registration PAK is'               installed on your system.y  B               Compaq COBOL utilizes the OpenVMS License ManagementC               Facility (LMF). If you have not registered and loadedn>               your PAK or PAKs, you must do so to successfully:               complete the installation (see Section 1.2).         2-2 Installing Compaq COBOL 4         H                                                  Installing Compaq COBOLH                                               2.1 Installation Procedure  9               3. Locate Compaq COBOL on the media CD-ROM.f  C                  To obtain the kit directory location of the CompaqaD                  COBOL distribution files on the appropriate OpenVMSF                  Alpha Software Product Library CD-ROM (media CD-ROM),)                  do one of the following:   H                  o  Use the CDMENU utility provided on the media CD-ROM.  F                  o  View the CD-ROM master index file on the media CD-                     ROM.  ;                  o  Contact the appropriate system manager.h  C                  For information about using the CDMENU utility andiG                  the CD-ROM files, see the Software Product Library CD-eE                  ROM User's Guide, which accompanies the media CD-ROMeH                  distribution kit. This user guide and the CD-ROM masterH                  index file are provided as online files in the [README]5                  directory on the first media CD-ROM.e  E                  To determine whether the appropriate media CD-ROM iswC                  already mounted on your system, type the followinge                  command:e  %                  $ SHOW DEVICE DKA400   H                  PLEASE NOTE: DKA400 is the device name used in examplesC                  in this document to show where the CD-ROM has beenDF                  mounted. You need to determine the name of the CD-ROM                   on your system.  G                  If the media CD-ROM is not mounted, either contact thetE                  appropriate system manager or insert the appropriate C                  media CD-ROM (write down the volume label) into an C                  available CD-ROM drive. Type the appropriate MOUNT G                  command (omitting the /FOREIGN qualifier), such as thef                  following:t  %                  $ MOUNT DKA400 labely  F                  Where label is the volume label of that media CD-ROM.  B                  To check that you have located the correct CD-ROMB                  device and directory, use the following DIRECTORY                  command:d  5                  $ DIRECTORY DKA400:[directory]*.PCSIo  4                  Where directory is like [COBOL027].  H                                              Installing Compaq COBOL 2-3    i            Installing Compaq COBOL      2.1 Installation Procedurel  C            4. Invoke PCSI and extract the Release Notes so that youm?               can read them before completing the installation.g  E               To extract the online Release Notes, type the following                command:  5               $ PRODUCT EXTRACT RELEASE_NOTES COBOL -o7               $_/SOURCE=SYS$HELP:COBOL027.RELEASE_NOTES   >               This command will extract the Release Notes into               SYS$HELP.e  ?               Read the Release Notes before continuing with the                installation.   ?            5. Use PCSI to install the Run-Time Library, COBRTL.l  @               Install the COBRTL before installing the compiler.  B               If you are running OpenVMS Alpha Version 6.2 through.               Version 7.1-1, do the following:  9               $ PRODUCT INSTALL COBRTL/VERSION=2.7-603A -o*               $_/SOURCE=DEVICE:[DIRECTORY]  E               Answer YES to terminate the installation if you get therB               following question for either DEC$COBRTL or LIBOTS2,+               and find out what went wrong:   J               %PCSI-E-FAILCONF, failed to resolve conflicting requirements2               Terminating is strongly recommended..               Do you want to terminate?  [YES]  ?               If you are running OpenVMS Alpha Version 7.1-2 orS'               higher, do the following:n  9               $ PRODUCT INSTALL COBRTL/VERSION=2.7-603B -i*               $_/SOURCE=DEVICE:[DIRECTORY]  C               If the system disk for this installation is shared intD               your cluster, do the following on the other nodes that$               share the system disk:  :               $ INSTALL REPLACE SYS$LIBRARY:DEC$COBRTL.EXE7               $ INSTALL REPLACE SYS$LIBRARY:LIBOTS2.EXEi  5            6. Use PCSI to install the COBOL compiler.P         2-4 Installing Compaq COBOL           H                                                  Installing Compaq COBOLH                                               2.1 Installation Procedure  "                  Use this command:  =                  $ PRODUCT INSTALL COBOL/VERSION=2.7-1209 - ) -                  $_/SOURCE=DEVICE:[DIRECTORY]   F                  If the system disk for this installation is shared inG                  your cluster, do the following on the other nodes that '                  share the system disk:t  <                  $ INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE                                                                      H                                              Installing Compaq COBOL 2-5    T                  H                                                                        3H         ________________________________________________________________  H                                                       After Installation      G               After Compaq COBOL is installed, it can be invoked by allr+               users with the COBOL command.   G               The installation procedure modifies the DCL command tablelD               so that the COBOL command is recognized and processed.D               However, the previous command table is still in effectF               for those users who are currently logged in. All logged-E               in users who want to use the COBOL command or the newlysG               updated version of the COBOL command must log out and logS9               in again, or use the following DCL command:D  8               $ SET COMMAND /TABLE=SYS$LIBRARY:DCLTABLES  H               The following tasks can be performed after Compaq COBOL is               installed:  @               o  Running the Installation Verification Procedure                  separately   6               o  Customizing the Compaq COBOL messages  ;               o  Making Compaq COBOL usable on a VMScluster   0               o  Setting user account privileges  :               o  Installing Compaq COBOL as a shared image  -               o  Running the REFORMAT utility   F         3.1 Running the Installation Verification Procedure Separately  @               The Installation Verification Procedure (IVP) runsF               automatically during installation of the COBOL compiler.H               It requires the installation of the COBOL compiler on yourE               system. If you want to run the IVP separately to ensure E               the integrity of installed files should system problems F               occur, in a privileged account use the following command               procedure:  H                                                   After Installation 3-1                 After InstallationuC      3.1 Running the Installation Verification Procedure Separatelyr  /            $ @SYS$COMMON:[SYSTEST]COBOL$IVP.COMa    0      3.2 Customizing Compaq COBOL Error Messages  @            The PCSI installation automatically copies the Compaq=            COBOL message file, COBOL$MSG.MSG, into the systemy<            directory [SYSUPD]. You can edit COBOL$MSG.MSG toE            customize the error messages that users receive when using D            Compaq COBOL. Customized messages are often desirable for            international users.l  ;            You must install Compaq COBOL before editing theeB            message file. If you install Compaq COBOL after editingB            COBOL$MSG.MSG, the software installation will supersedeD            the revised message file in the [SYSMSG] directory. Also,A            you must have the OpenVMS Message utility installed on ?            your system before editing COBOL$MSG.MSG. The edited A            version of COBOL$MSG.MSG must be processed through thefD            Message utility before the file can be accessed by Compaq            COBOL.   C            The following steps explain how to edit the Compaq COBOL C            messages and install the customized message file on youri            system:  $            1. Edit the message file.  B               Each error message appears on a separate line and isE               enclosed in angle brackets (< >). You can edit the textnD               portion of the error messages, but for Compaq COBOL toD               correctly identify the errors, you must not change the               following:  C               o  The 3- to 9-character mnemonic that appears in thee                  first columno  C               o  The sequence in which the error messages appear inh                  the filei  8               o  The severity level of the error message  C               o  The number, type, and order of the formatted ASCII B                  output (FAO) arguments that appear in the message  .            2. Run the OpenVMS Message utility.        3-2 After Installationt e  l      H                                                       After InstallationH                              3.2 Customizing Compaq COBOL Error Messages  C                  To translate the new message text into a file thatrG                  Compaq COBOL can access, run the text file through thelC                  Message utility by entering the following command:S  $                  $ MESSAGE COBOL$MSG  >                  The Message utility creates the object module                  COBOL$MSG.OBJ.   D               3. Enter the LINK command with the /SHARE qualifier to:                  create the shareable image COBOL$MSG.EXE:  '                  $ LINK/SHARE COBOL$MSGr  H               4. Install COBOL$MSG.EXE in the system directory [SYSMSG]:  C                  $ COPY COBOL$MSG.EXE SYS$COMMON:[SYSMSG]/PROT=W:RE   C               5. If Compaq COBOL is installed as a known image, you G                  must reinstall COBOL$MSG.EXE by entering the following                   command:a  8                  $ INSTALL REPLACE SYS$MESSAGE:COBOL$MSG  B               Compaq COBOL will now generate your customized error               messages.t  6         3.3 Making Compaq COBOL Usable on a VMScluster  B               If you want to run Compaq COBOL on multiple nodes of@               a VMScluster, first check to see that you have theC               appropriate software license (see Section 1.2). Then,eB               perform the following steps after you install Compaq               COBOL:  G               1. Issue the LICENSE LOAD command to activate the license H                  on each node in the VMScluster on which Compaq COBOL is                   to be executed.  F               2. Use the OpenVMS System Management utility (SYSMAN) toH                  execute a set of commands on all cluster nodes, whetherC                  or not the nodes are licensed to use Compaq COBOL;_H                  failure to do so may cause unexpected errors for users.  F                 ________________________Note  ________________________  >                 If you are using a mixed-architecture (VAX andD                 Alpha) heterogeneous cluster, before executing theseA                 commands, make sure the appropriate logical namesl  H                                                   After Installation 3-3 n               After Installation 3      3.3 Making Compaq COBOL Usable on a VMScluster   =               have been set to define the scope of the SYSMAN @               DO commands. For more information, see the OpenVMS.               system management documentation.  C               _____________________________________________________                                                                                       3-4 After Installation            H                                                       After InstallationH                           3.3 Making Compaq COBOL Usable on a VMScluster  C                  While logged in as SYSTEM, or as another user namefG                  that has the SETPRV privilege or the CMKRNL and SYSPRVOA                  privileges, use the SYSMAN utility to update thel@                  version of DCLTABLES.EXE available, as follows:  (                  $ RUN SYS$SYSTEM:SYSMAN0                  SYSMAN> SET ENVIRONMENT/CLUSTER<                  %SYSMAN-I-ENV, current command environment:5                          Clusterwide on local clusterOM                          Username SYSTEM       will be used on nonlocal nodesIE                  SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE B                  %SYSMAN-I-OUTPUT, command execution on node NODE1B                  %SYSMAN-I-OUTPUT, command execution on node NODE2  D                  The SYSMAN utility will cause each DO command to be<                  executed on all nodes of the local cluster.  D               3. If Compaq COBOL is installed as a known image, then'                  also do the following:e  @                  SYSMAN> DO INSTALL REPLACE SYS$SYSTEM:COBOL.EXEB                  %SYSMAN-I-OUTPUT, command execution on node NODE1B                  %SYSMAN-I-OUTPUT, command execution on node NODE2  D               4. If the Compaq COBOL messages file is installed as a9                  known image, then also do the following:k  E                  SYSMAN> DO INSTALL REPLACE SYS$MESSAGE:COBOL$MSG.EXEnB                  %SYSMAN-I-OUTPUT, command execution on node NODE1B                  %SYSMAN-I-OUTPUT, command execution on node NODE2  D               5. If the Compaq COBOL RTL installation was performed,3                  then complete the following steps:P  F                  SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DEC$COBRTL.EXEB                  %SYSMAN-I-OUTPUT, command execution on node NODE1B                  %SYSMAN-I-OUTPUT, command execution on node NODE2C                  SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:LIBOTS2.EXE2B                  %SYSMAN-I-OUTPUT, command execution on node NODE1B                  %SYSMAN-I-OUTPUT, command execution on node NODE2  +               6. Finally, exit from SYSMAN.                     SYSMAN> EXIT.                  $  H                                                   After Installation 3-5 l  e            After Installations       3.4 User Account Privileges         3.4 User Account Privileges  D            To use Compaq COBOL, each user account must have at leastB            TMPMBX and NETMBX privileges. Use the OpenVMS AuthorizeA            utility to determine whether users have the privileges             they require.  2      3.5 Installing Compaq COBOL as a Shared Image  D            If you expect Compaq COBOL to be used extensively on your@            system, you can reduce the system overhead and memory>            requirements by installing it as a shared image. ToB            install Compaq COBOL as a shared image on a system that@            is currently running, use the OpenVMS Install utilityE            (INSTALL). It is recommended that you install Compaq COBOLYA            as shared on a system that has been rebooted recently,wB            because the available space in the global page table isC            less likely to be fragmented. Invoke the OpenVMS InstallPE            utility from a privileged account and install Compaq COBOLi            as a shared image:i  J            $ INSTALL ADD SYS$SYSTEM:COBOL.EXE /OPEN/SHARED/HEADER_RESIDENT  C            Add the following line to the appropriate system startupcE            command file so that Compaq COBOL is available as a sharede1            image each time the system is started:S  I            $ INSTALL ADD SYS$SYSTEM:COBOL.EXE/OPEN/SHARED/HEADER_RESIDENT   A            The default operating system startup command file, forL@            example, is SYS$MANAGER:SYSTARTUP_VMS.COM (previouslyD            named SYSTARTUP_V5.COM). If your site has modularized theE            system startup procedure using multiple command files, adda)            the lines to the correct file.a  C            To install the message file, use the following commands:   2            $ INSTALL ADD SYS$MESSAGE:COBOL$MSG.EXE        3.6 REFORMAT Utility.  D            The PCSI installation automatically includes installation@            of REFORMAT.EXE, the REFORMAT utility. It is ready to            run.a        3-6 After Installationr t                     H                                                                        AH         ________________________________________________________________  H                                                     Sample Installations      D               This appendix contains sample logs of installations onG               different versions of the OpenVMS Alpha operating system, A               a sample log of an installation verification (IVP),iE               and a sample log of a deinstallation of the RTL and theD               compiler.U  H               The lines regarding products removed reflect the fact thatC               the actual installation replaced field test software.x  F               Installation of the Run-Time Library and the Compiler on4               OpenVMS Alpha Version 7.1-2 and Higher  D         $ PRODUCT INSTALL COBRTL/VERSION=2.7-603B/SOURCE=SYS$UPDATE:0         The following product has been selected:B             DEC AXPVMS COBRTL V2.7-603B            Layered Product  &         Do you want to continue? [YES]  (         Configuration phase starting ...  N You will be asked to choose options, if any, for each selected product and forO any products that may be installed to satisfy software dependency requirements.s  N DEC AXPVMS COBRTL V2.7-603B: COBRTL for Compaq COBOL for OpenVMS Alpha Systems  :             Copyright 2000 by Compaq Computer Corporation.  H             This software is the product of Compaq Computer Corporation.  4             No PAKs are used by this COBRTL product.  7         Do you want the defaults for all options? [YES]O  /         Do you want to review the options? [NO]l  $         Execution phase starting ...  H                                                 Sample Installations A-1 -  .            Sample Installationst    <      The following product will be installed to destination:O          DEC AXPVMS COBRTL V2.7-603B            DISK$YYYYYYSYSDSK:[VMS$COMMON.] <      The following product will be removed from destination:O          DEC AXPVMS COBRTL V2.7-588B            DISK$YYYYYYSYSDSK:[VMS$COMMON.]         Portion done: 0%L      ...30%       ...50%s      ...70%q      ...90%2      ...100%  .      The following product has been installed:?          DEC AXPVMS COBRTL V2.7-603B            Layered Producte,      The following product has been removed:?          DEC AXPVMS COBRTL V2.7-588B            Layered Product   A      $ PRODUCT INSTALL COBOL /VERSION=2.7-1209/SOURCE=SYS$UPDATE: -      The following product has been selected:L?          DEC AXPVMS COBOL V2.7-1209             Layered Product   #      Do you want to continue? [YES]E  %      Configuration phase starting ...t  N You will be asked to choose options, if any, for each selected product and forO any products that may be installed to satisfy software dependency requirements.L  G      DEC AXPVMS COBOL V2.7-1209: Compaq COBOL for OpenVMS Alpha SystemsS  7          Copyright 2000 by Compaq Computer Corporation.   E          This software is the product of Compaq Computer Corporation.   B          A valid Product Authorization Key (PAK) is required to be  4      Do you want the defaults for all options? [YES]  ,      Do you want to review the options? [NO]  !      Execution phase starting ...d  <      The following product will be installed to destination:O          DEC AXPVMS COBOL V2.7-1209             DISK$YYYYYYSYSDSK:[VMS$COMMON.]m<      The following product will be removed from destination:O          DEC AXPVMS COBOL V2.7-1202             DISK$YYYYYYSYSDSK:[VMS$COMMON.]r        A-2 Sample Installations     R      H                                                     Sample Installations             Portion done: 0%         ...70%         ...80%         ...90%         ...100%r  1         The following product has been installed: B             DEC AXPVMS COBOL V2.7-1209             Layered Product/         The following product has been removed:TB             DEC AXPVMS COBOL V2.7-1202             Layered Product  O         %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS COBOL V2.7-          1209 ...A         %PCSI-I-IVPSUCCESS, test procedure completed successfully   F               Installation of the Run-Time Library and the Compiler on5               OpenVMS Alpha Version 6.2 Through 7.1-1L  L         $ product install cobrtl/version=v2.7-603a/source=device:[directory]  0         The following product has been selected:3         DEC AXPVMS COBRTL V2.7-603A     [Available]   &         Do you want to continue? [YES]  A         *** DEC AXPVMS COBRTL V2.7-603A: COBRTL for Compaq COBOL R"          for OpenVMS Alpha Systems  :             Copyright 2000 by Compaq Computer Corporation.  H             This software is the product of Compaq Computer Corporation.  4             No PAKs are used by this COBRTL product.  F             Do you want all the default values for this product? [YES]  0             Do you want to view the values? [NO]  3         %PCSIUI-I-DONEASK, execution phase startinge0         The following product will be installed:#         DEC AXPVMS COBRTL V2.7-603AbL         %PCSI-I-VOLINFO, estimated space information for volume DISK$XXXXXX_        H                                                 Sample Installations A-3 o  n            Sample Installations           SYS=      -PCSI-I-VOLSPC, 0 required; 404637 available; 404637 net       Portion Done: 0%       ...10%       ...20%l      ...70%       ...90%u      ...100%.      The following product has been installed:       DEC AXPVMS COBRTL V2.7-603A  C      $ product install cobol/ver=2.7-1209/source=device:[directory]o  -      The following product has been selected: ?          DEC AXPVMS COBOL V2.7-1209             Layered Product   #      Do you want to continue? [YES]   %      Configuration phase starting ...   N You will be asked to choose options, if any, for each selected product and forO any products that may be installed to satisfy software dependency requirements.n  G      DEC AXPVMS COBOL V2.7-1209: Compaq COBOL for OpenVMS Alpha Systemso  7          Copyright 2000 by Compaq Computer Corporation.a  E          This software is the product of Compaq Computer Corporation.   B          A valid Product Authorization Key (PAK) is required to be  4      Do you want the defaults for all options? [YES]  .      Do you want to review the options? [NO] y  G      DEC AXPVMS COBOL V2.7-1209: Compaq COBOL for OpenVMS Alpha Systemso(          DEC AXPVMS VMS V7.2 [Installed]  0      Are you satisfied with these options? [YES]  !      Execution phase starting ...f  <      The following product will be installed to destination:M          DEC AXPVMS COBOL V2.7-1209             DISK$YYYYYY_SYS:[VMS$COMMON.]         Portion done: 0%       ...70%       ...80%       ...90%3      ...100%        A-4 Sample Installations  1  n      H                                                     Sample Installations    1         The following product has been installed:CB             DEC AXPVMS COBOL V2.7-1209             Layered Product  O         %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS COBOL V2.7-s         1209 ...  A         %PCSI-I-IVPSUCCESS, test procedure completed successfullyiF         %PCSIUI-I-SUCINSTALL, INSTALL operation completed successfully  <               Installation Verification (IVP) Run Separately  !         $ @sys$test:cobol$ivp.comu  3          Copyright 2000 Compaq Computer Corporation   ?          COMPAQ Registered in U.S. Patent and Trademark Office.   O          Confidential computer software. Valid license from Compaq required formK          possession, use or copying. Consistent with FAR 12.211 and 12.212,eK          Commercial Computer Software, Computer Software Documentation, andOP          Technical Data for Commercial Items are licensed to the U.S. Government4          under vendor's standard commercial license.  9                 Successful test of Compaq COBOL V2.7-1209e  	         $e  F               Removal (Deinstallation) of the Run-Time Library and the               COBOL Compiler           $ product remove cobrtl   0         The following product has been selected:A             DEC AXPVMS COBRTL V2.7-603            Layered Productl  &         Do you want to continue? [YES]  ?         The following product will be removed from destination:mM         DEC AXPVMS COBRTL V2.7-603            DISK$AFSCOBSYSDSK:[VMS$COMMON.]t  %         Portion done: 0%...10%...100%   /         The following product has been removed:iA             DEC AXPVMS COBRTL V2.7-603            Layered Producte           $ product remove cobol  0         The following product has been selected:B             DEC AXPVMS COBOL V2.7-1209             Layered Product  &         Do you want to continue? [YES]  H                                                 Sample Installations A-5                 Sample Installationst    <      The following product will be removed from destination:O          DEC AXPVMS COBOL V2.7-1209             DISK$AFSCOBSYSDSK:[VMS$COMMON.]   F      Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...100%  ,      The following product has been removed:?          DEC AXPVMS COBOL V2.7-1209             Layered Producth                                                                                  A-6 Sample InstallationsA C  L                  H                                                                        BH         ________________________________________________________________  H                                                   Recovering from Errors      A               This appendix provides information to help you withM@               failures or errors that might occur during product*               installation or product use.  =         B.1 Failures During Compaq COBOL and Run-Time Librarya             Installationsm  B               If PCSI detects any problems during installation, it?               notifies you and asks if you want to continue theB               installation.q  H               The following PCSI messages are issued if the PCSI product:               kit is not found in the specified directory:  :               $ product install /source=device:[directory]B               %PCSIUI-I-NOMATCH, no products found matching: COBOLM        %PCSIUI-E-NOPROD, no products found on which to perform this operation M               %PCSIUI-E-ABORT, fatal error encountered - operation terminated:  H               The following PCSI and RMS messages are issued if the PCSIE               product kit is not found in the specified directory and <               you have defined the logical name PCSI$SOURCE:  :               $ product install /source=device:[directory]J   %PCSI-E-OPENIN, error opening PCSI$SOURCE:[SYSUPD]*-*-*-%%%%%-*-*.PCSI*;     as inputM   -RMS-F-DEV, error in device name or inappropriate device type for operation $   %PCSI-E-S_OPFAIL, operation failedA   %PCSIUI-E-ABORT, fatal error encountered - operation terminated_  G               The following PCSI messages are issued when the installa- ?               tion and the IVP test procedure execute properly:       H                                               Recovering from Errors B-1                 Recovering from Errors H      B.1 Failures During Compaq COBOL and Run-Time Library Installations  7            $ product install /source=device:[directory]b               .                .S               . 4            The following product has been installed:%            DEC AXPVMS COBOL V2.7-1209e               .                ._               ._L            %PCSI-I-EXETSTOK, end of test procedure; completed with no errors  @            The following PCSI messages are issued when the COBOLA            installation fails only because the IVP test proceduren            fails.   C               ________________________Note ________________________   >               This failure is in the IVP test procedure. After;               reporting the failure it asks you if you wisha>               to terminate the installation. If you answer YES=               at this advanced stage (100%), the installationa@               terminates quietly. The product has been installed               on the system.  C               _____________________________________________________m  7            $ product install /source=device:[directory]O  B            The PRODUCT INSTALL fails, with the following messages:  A            Portion Done: 10%...30%...40%...70%...80%...90%...100%C?            %PCSI-I-PRCOUTPUT, output from subprocess follows...nJ            %LICENSE-F-NOAUTH, DEC COBOL use is not authorized on this nodeO            -LICENSE-F-NOLICENSE, no license is active for this software product <            -LICENSE-I-SYSMGR, please see your system manager!            %SYSTEM-F-ABORT, abort   E            The IVP test procedure fails, with the following messages:e  G       %PCSI-E-EXETSTFAIL, end of test procedure; completed with errors; &       status returned from DCL follows       -SYSTEM-F-ABORT, abort(       %PCSI-E-OPFAILED, operation failedM       Terminating is strongly recommended.  Do you want to terminate? [YES] yl        B-2 Recovering from Errorsa    n      H                                                   Recovering from ErrorsH      B.1 Failures During Compaq COBOL and Run-Time Library Installations  E               The following PCSI messages are issued when the instal-eC               lation fails and you ask PCSI to force completing theeC               installation. In this case a PCSI "execute" statement >               failed. It is recommended that you terminate theC               installation in response to the question "Do you want1F               to terminate?" If this message appears under the current@               setup, something has gone seriously wrong with the2               installation. Two possibilities are:  F               o  One or more necessary files are missing from the kit.  ?               o  A delete of modules in the STARLET.OLB library C                  has failed in the COBRTL installation, causing the 5                  succeeding PCSI update step to fail.   H               If you answer YES or take the default on the question, theF               installation will be backed out if it has gone less thanG               100%, and you will see the $ system prompt on the screen.e  @               $ product install cobrtl/source=device:[directory]  B               %PCSI-I-PRCOUTPUT, output from subprocess follows...$               %SYSTEM-F-ABORT, abort               Portion Done: 10%O  M   %PCSI-E-EXEFAIL, execute statement failed; status returned from DCL followse   -SYSTEM-F-ABORT, abort$   %PCSI-E-OPFAILED, operation failedI   Terminating is strongly recommended.  Do you want to terminate? [YES] ns2   Portion Done: 30%...40%...70%...80%...90%...100%+   The following product has been installed:    DEC AXPVMS COBRTL V2.7-603)   The following product has been removed:    DEC AXPVMS COBRTL V2.7-603F   %PCSIUI-I-COMPWERR, operation completed after explicit continuation      from errors   ,         B.2 Problems During Compaq COBOL Use  G               This section describes problems that might occur when youa               use Compaq COBOL.i          H                                               Recovering from Errors B-3                 Recovering from Errorse)      B.2 Problems During Compaq COBOL Usem  $      B.2.1 Run-Time Library Mismatch  A            The system issues a severe error message if there is a D            mismatch in RTL versions between the compiled program andD            the RTL installed on the system where the program is run.D            In this situation, the program exits after the message is            issued.        B.2.2 Other Problemsi  C            If you encounter a problem while using Compaq COBOL, seepD            the section on Troubleshooting Tips in the Release Notes.@            If the problem is unresolved, report it to Compaq. IfB            you have a Software Product Services Support Agreement,D            contact your Compaq Customer Support Center (CSC), eitherC            by telephone or using the electronic means provided withyE            your support agreement (such as DSNlink). The CSC provides A            telephone support for high-level advisory and remedial A            assistance. When you initially contact the CSC, please_"            indicate the following:  D            o  The name (OpenVMS Alpha) and the version number of the,               operating system you are using  D            o  The product name (Compaq COBOL) and the version number+               of Compaq COBOL you are using   @            o  The hardware system you are using, such as a model               number  C            o  A very brief description of the problem (one sentence                if possible)  )            o  How critical the problem is   E            When you submit information electronically or are speaking ?            on the phone to the appropriate Compaq COBOL support A            specialist, you can provide more detailed information.D?            The information should include the specific commandshC            used to compile and link the program, the error messages A            displayed, and relevant detailed information (possiblyi@            including source program listings). Please attempt toB            narrow the cause of the problem to a specific module or            lines of code.e        B-4 Recovering from Errorsn c  e      H                                                   Recovering from ErrorsH                                     B.2 Problems During Compaq COBOL Use  G               CSC personnel may ask for additional information, such asoD               listings of any command files, INCLUDE and COPY files,B               relevant data files, and so forth. If the program isF               longer than 50 lines, submit a copy of it electronicallyE               or provide machine-readable media (diskette or magnetics               tape).                                                                              H                                               Recovering from Errors B-5