  K                     Compaq COBOL for OpenVMS VAX Systems Installation Guide   !                     November 2000   F                     This document contains instructions for installingC                     Compaq COBOL for OpenVMS VAX (formerly known as F                     DIGITAL VAX COBOL, or as VAX COBOL) on the OpenVMSF                     VAX operating system. It also explains how to readG                     the online release notes before or after installing F                     the product. This document applies to Compaq COBOLC                     Version 5.7 for OpenVMS VAX and any maintenance -                     updates for that version.   H                     Compaq's COBOL compilers are also available on otherD                     platforms, including OpenVMS Alpha, Compaq Tru64/                     UNIX, and Windows NT Alpha.   I                     In this document, references to the name Compaq COBOL 6                     mean Compaq COBOL for OpenVMS VAX.  E                     Revision/Update Information:  This revised manual G                                                   supersedes the Compaq G                                                   COBOL for OpenVMS VAX F                                                   Systems InstallationE                                                   Guide (Order Number ?                                                   AA-K026R-TE).   H                     Operating System and Version: VAX/VMS Version 5.5-2,H                                                   or OpenVMS VAX VersionA                                                   6.1, or higher. E                                                   Future releases may 9                                                   require B                                                   higher versions.  F                     Software Version:             Compaq COBOL Version5                                                   5.7                     /                     Compaq Computer Corporation "                     Houston, Texas                 J           ________________________________________________________________  ,            2000 Compaq Computer Corporation  A           COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo 9           Registered in U.S. Patent and Trademark Office.   @           OpenVMS and Tru64 are trademarks of Compaq Information"           Technologies Group, L.P.  =           Windows NT is a trademark of Microsoft Corporation.   :           OSF/1 and UNIX are trademarks of The Open Group.  D           All other product names mentioned herein may be trademarks(           of their respective companies.  C           Confidential computer software. Valid license from Compaq C           required for possession, use, or copying. Consistent with >           FAR 12.211 and 12.212, Commercial Computer Software,A           Computer Software Documentation, and Technical Data for D           Commercial Items are licensed to the U.S. Government under/           vendor's standard commercial license.   ?           Compaq shall not be liable for technical or editorial B           errors or omissions contained herein. The information in<           this document is subject to change without notice.  A           THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS" C           WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT @           OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT.<           IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT,@           CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHERC           DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES E           FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR LOSS C           OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED E           OF THE POSSIBILITY OF SUCH DAMAGES AND WHETHER IN AN ACTION 4           OF CONTRACT OR TORT, INCLUDING NEGLIGENCE.  D           The limited warranties for Compaq products are exclusivelyD           set forth in the documentation accompanying such products.>           Nothing herein should be construed as constituting a)           further or additional warranty.   E                                                                ZK5514   D           This document was prepared using DECdocument, Version 3.3-
           1b.                                  C   _________________________________________________________________   C                                                            Contents       C   Preface...................................................      v   &   1  Preparing to Install Compaq COBOL  C         1.1   Accessing the Online Release Notes............    1-1 C         1.2   System Prerequisites..........................    1-2 C         1.3   Installation Procedure Requirements...........    1-2 C         1.4   Special Requirements..........................    1-4 C         1.5   Backing Up Your System Disk...................    1-5      2  Installing Compaq COBOL  C         2.1   Using VMSINSTAL...............................    2-1 C         2.2   Step-by-Step Installation.....................    2-4 C         2.3   Installing Compaq COBOL on a VAXcluster.......   2-12 C         2.4   Installing Compaq COBOL as a Shared Image.....   2-13 7         2.5   Using the PCSI Transition Kit to Register C               Compaq COBOL V5.7 and the COBRTL..............   2-13      3  After Installation   3         3.1   Running the Installation Verification C               Procedure Separately..........................    3-1 C         3.2   Customizing Compaq COBOL Error Messages.......    3-3 C         3.3   Error Conditions..............................    3-4 C         3.4   Special Save Set for COBRTL Only..............    3-5 C         3.5   Maintenance Updates...........................    3-6               C                                                                 iii                         A  Sample Installation  %     B  Files Installed on Your System          C  Recovering from Errors   <           C.1   Failures During Installation of Compaq COBOLE                 for OpenVMS VAX Systems.......................    C-1 E           C.2   Diagnostic Message Table......................    C-2 7           C.3   Problems During Use of Compaq COBOL for E                 OpenVMS VAX Systems...........................    C-4   
     Tables  E           2-1       Installation Option Designators...........    2-2   7           B-1       Directories Containing Compaq COBOL E                     Installed Files ..........................    B-1   E           C-1       Installation Messages.....................    C-2                                                      iv                             I         _________________________________________________________________   I                                                                   Preface       E               This guide describes how to install Compaq COBOL on the C               OpenVMS VAX operating system, or VAX/VMS, in the case C               of Version 5.5-2. It is intended for system managers. G               This document applies to Compaq COBOL Version 5.7 and any 3               maintenance updates for that version.   C               For more information about installing Compaq COBOL on F               OpenVMS VAX or VAX/VMS systems, refer to your processor-8               specific installation or operations guide.  F               The installation procedure is described step-by-step andI               is, for the most part, self-explanatory. The system prompts F               you to answer questions and to change volumes, and waits-               for you to tell it to continue.             Associated Documentation  G               In addition to this guide, the Compaq COBOL documentation                set includes:   I               o  Read Before Installing or Using Compaq COBOL for OpenVMS /                  VAX Systems Version 5.7 letter   A               o  VAX COBOL Reference Manual (not revised for this                   release)   E               o  VAX COBOL User Manual (not revised for this release)   E               o  DIGITAL COBOL Multiplatform Overview & Compatibility G                  Guide (not revised for this release; new as of Version                   5.5A)  C               o  Compaq COBOL for OpenVMS VAX Systems Release Notes   :               o  Compaq COBOL for OpenVMS VAX Systems Help  I                                                                         v                    ?           You may also find the following documentation useful:   1           o  Guide to Software License Management   >           o  Guide to Sharing Software on a Local Area Network  6           o  OpenVMS License Management Utility Manual  ,           o  OpenVMS System Manager's Manual       Conventions   ;           The following conventions are used in this guide:   E           ___________________________________________________________ E           Convention____________________Meaning______________________   A           [YES]                         Default answers to system ?           [NO]                          questions are framed in ?                                         square brackets. Simply @                                         press <Return> to accept=                                         the default response.   B           UPPERCASE                     In text, uppercase letters>                                         indicate the name of aE                                         command, a file, a parameter, @                                         a procedure, or a Compaq6                                         COBOL utility.  @           $ @SYS$UPDATE:VMSINSTAL       In interactive examples,A           saveset-name                  prompts or displayed text =                                         appear in a monospace @                                         font. User input appearsD                                         in bold monospace. LowercaseA                                         indicates a name that you B                                         supply. Uppercase is to be7                                         typed as shown.   B           $                             The dollar sign is used toE                                         indicate the DCL prompt. This B                                         prompt may be different on4                                         your system.  A           <Ctrl/x>                      In procedures, a sequence B                                         such as <Ctrl/x> indicatesC                                         that you must hold down the B                                         key labeled Ctrl while you:                                         press another key.       vi                 I               ___________________________________________________________ I               Convention____________________Meaning______________________   H               n                             The minor (point) release ofH                                             Compaq COBOL for OpenVMS VAXI                                             in examples is shown by n, as I                                             in COBOL05n. For Version 5.7, I               ______________________________you_type_COBOL057.___________                  References  D               The following table shows certain references and their1               respective meanings in this manual:                                                                   I                                                                       vii                  E           ___________________________________________________________ E           Reference_____Meaning______________________________________   ?           OpenVMS       OpenVMS VAX or VAX/VMS operating system   =           Tru64 UNIX    Compaq Tru64 UNIX operating system[1]   0           CDD/Plus      Oracle CDD/Repository[2]  E           [1]Compaq_Tru64_UNIX_was_formerly_known_as_DIGITAL_UNIX____ D           or DEC OSF/1. As of Version 4.0F, the name DIGITAL UNIX is'           changed to Compaq Tru64 UNIX. 9           [2]Oracle CDD/Repository is a product of Oracle E           Corporation._______________________________________________   )     How to Order Additional Documentation   C           For information on pricing and where to buy documentation D           and other Compaq products in the United States and Canada,/           please call toll-free 1-800-282-6672.        Reader's Comments   @           Compaq appreciates user comments. If you would like toC           comment about this manual or if you should find errors in B           it, please send the manual title, order number, and your3           comments by one of the following methods:   &           o  Electronic Internet mail:  '                 LanguageDocs@compaq.com              o  Fax:                    603-884-01209                 Attn: Languages Documentation, ZKO2-3/K35   4           o  A letter sent to the following address:  +                 Compaq Computer Corporation 3                 Languages Documentation, ZKO2-3/K35 #                 110 Spit Brook Road %                 Nashua, NH 03062-2698                  USA        viii                         I                                                                         1 I         _________________________________________________________________   I                                         Preparing to Install Compaq COBOL     D               Your bill of materials (BOM) and indented bills reportB               (BIL) specify the number and contents of your media.D               Be sure to check the contents of your kit against thisE               information. If your kit is damaged or if you find that G               parts of it are missing, call your Compaq representative.   H               Your distribution kit includes a letter titled Read BeforeF               Installing or Using Compaq COBOL Version 5.7 for OpenVMSE               VAX Systems. The letter discusses important information G               that might not be included in this guide. You should read <               this letter before beginning the installation.  H               Distribution media must be mounted in numerical order. TheF               installation procedure prompts you to mount the volumes.F               For more information on how to mount distribution media,I               refer to your processor-specific installation or operations                guide.  I               This guide also details several options to the installation                procedure.  .         1.1 Accessing the Online Release Notes  D               Compaq COBOL provides online release notes. The promptG               to display or print the release notes before installation F               appears in Step 4 of the installation procedure when youH               invoke VMSINSTAL with the OPTIONS N parameter. Please readE               the release notes before you install COBOL, as they may :               contain important information about changes.  H               After the installation, the release notes are available inG               text format and PostScript format in the following files:   <                  SYS$HELP:COBOL05n.RELEASE_NOTES (text file)3                  SYS$HELP:COBOL05n_RELEASE_NOTES.PS   >               Where n represents version point release number.  I                                     Preparing to Install Compaq COBOL 1-1                    E               Online help also directs you to the release notes file. 9               After the installation, type the following:   3               $ HELP COBOL RELEASE_NOTES   <Return>             1.2 System Prerequisites  I               This is a complete kit for Compaq COBOL. You do not need to H               have installed any earlier versions of Compaq COBOL beforeI               installing Version 5.n. (Note that for n you should use the G               actual maintenance-update number after the decimal point, G               for example, 7 in Version 5.7, which appears on the title ,               page as the Software Version.)  G               Compaq COBOL for OpenVMS VAX Version 5.7 requires VAX/VMS I               Version 5.5-2 or OpenVMS VAX Version 6.1 or higher. Certain B               Compaq COBOL features may require higher versions ofE               OpenVMS VAX. See the SPD for information about specific "               system dependencies.  H               If you are installing Oracle Rdb or Oracle CDD/Repository,F               you should make certain that they have been successfullyC               installed before you attempt to install Compaq COBOL.M@               To eliminate possible installation errors, execute@               the following command procedure to start up Oracle               CDD/Repository:   5               $ @SYS$STARTUP:CDDSTRTUP.COM   <Return>   /         1.3 Installation Procedure Requirements   @               The installation should take approximately 5 to 10E               minutes, depending on the type of media and your system E               configuration. Before installing Compaq COBOL, you must :               have the following privileges and resources:  @               o  SETPRV privileges, or CMKRNL, WORLD, and SYSPRV                  privileges.  E               o  A minimum of 12,000 blocks of free disk space during D                  installation. After the installation, approximately'                  4,000 blocks are used.R      -         1-2 Preparing to Install Compaq COBOLr n  A              <               o  A minimum of 950 free global pages plus the<                  size (in number of disk blocks) of the fileE                  SYS$LIBRARY:DCLTABLES.EXE at installation. After the E                  installation, 950 free global pages plus the size of 4                  SYS$LIBRARY:DCLTABLES.EXE are used.  B               o  A minimum of 3 free global sections are needed at?                  installation; 3 global sections are used after                   installation.  F                 ________________________ Note ________________________  B                 You must ensure that your system has the necessaryD                 global page and global section SYSGEN quotas for theB                 installation. Failure to do so could cause the DCL:                 tables to be corrupted in some situations.  F                 ______________________________________________________  G               To determine the number of available global pages on yourwE               system, invoke the OpenVMS Install utility (INSTALL) byN+               typing the following command:   "               $ INSTALL   <Return>  .               Then type the following command:  5               INSTALL> LIST/GLOBAL/SUMMARY   <Return>a  =                       Summary of Local Memory Global Sections,  N                    nn Global Sections Used,  nnn/nnnn Global Pages Used/Unused  &               INSTALL> EXIT   <Return>  B               When you issue these commands, the system displays aG               summary of the number of global sections used, the numberoB               of global pages used, and the number of global pagesD               unused. To exit from the OpenVMS Install utility, type               the EXIT command.d  H               Compaq COBOL requires approximately 950 free global pages.F               If fewer than 950 pages are available, you can delete anE               existing known image using the OpenVMS Install utility,RH               or you can increase the GBLPAGES system parameter with theF               OpenVMS System Generation utility (SYSGEN), as described               below..   I                                     Preparing to Install Compaq COBOL 1-3S    I              G               You can determine the number of available global sectionsI,               by invoking SYSGEN as follows:  0               $ RUN SYS$SYSTEM:SYSGEN   <Return>+               SYSGEN>USE CURRENT   <Return>G0               SYSGEN>SHOW GBLSECTIONS   <Return>  $               SYSGEN>EXIT   <Return>  G               The last number displayed is the maximum number of globalhH               sections. Compare this to the number of global sections inH               use displayed by the OpenVMS Install utility. Compaq COBOLE               requires 3 global sections. Therefore, if the number ofuG               global sections used plus 3 exceeds the current number of H               global sections, you must increase the number of availableB               global sections before you can install Compaq COBOL.  G               To increase the number, you must increase the GBLSECTIONS >               system parameter with SYSGEN by editing the file<               SYS$SYSTEM:MODPARAMS.DAT and then invoking theG               SYS$UPDATE:AUTOGEN.COM procedure. For more information ontI               the AUTOGEN.COM procedure, refer to your processor-specifice/               installation or operations guide.   G               If the number of global sections used plus 3 is less thansF               the maximum number of global sections, you can exit from"               SYSGEN and continue.            1.4 Special Requirements  ?               A license Product Authorization Key (PAK) must belF               registered with the License Management Facility in order"               to use Compaq COBOL:  A               o  If this is a new installation, please be sure toVF                  register the Compaq COBOL for OpenVMS VAX Systems PAK<                  before starting the installation procedure.  F               o  If this is an update to an existing installation, theI                  PAK should already be registered in the license databaseo9                  and no further action needs to be taken.   H               You can register the information contained in the PAK thatD               is shipped to new customers with Compaq COBOL by usingG               either the OpenVMS License command procedure (VMSLICENSE) B               or the LICENSE REGISTER command, as described in the8               OpenVMS License Management Utility Manual.  -         1-4 Preparing to Install Compaq COBOLo q  B              F                 ________________________ Note ________________________  D                 If you are missing your PAK and you have purchased aE                 software support contract, you can obtain a Temporary E                 Service PAK. For more information, call your Customer                  Support Center.e  F                 ______________________________________________________  #               Hardware Requirementst  I               Object modules produced by the Compaq COBOL compiler can beaG               executed incorrectly if your OpenVMS VAX operating system G               does not meet the following requirements when you install_               the compiler:_  I               o  A VAX-11/780 computer must have the hardware engineering G                  change order (ECO) status of system level 4 or higher.w  H               o  A VAX-11/730 must have the writable control store (WCS)5                  status of system level 50 or higher.5  H               The Compaq COBOL Installation Verification Procedure (IVP)I               checks for the presence or absence of these two ECO and WCSo"               status requirements.  F               If you plan to use the Oracle Database Management SystemI               (Oracle DBMS), Oracle CDD/Repository, or both, refer to theiG               installation guides for these products for information onu%               their ECO requirements.   '         1.5 Backing Up Your System Diskt  I               At the beginning of the installation, VMSINSTAL asks if you I               have backed up your system disk. Compaq recommends that you E               do a system disk backup before installing any software.t  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.        I                                     Preparing to Install Compaq COBOL 1-5     s                    I                                                                         2 I         _________________________________________________________________   I                                                   Installing Compaq COBOLo    %               This chapter describes:p  7               o  Use of the VMSINSTAL command procedure   :               o  Installation of Compaq COBOL step by step  -               o  Installation on a VAXclustere  /               o  Installation as a shared imageL  @               o  Product registration in the POLYCENTER Software5                  Installation utility (PCSI) databasem           2.1 Using VMSINSTAL   A               After you log in to a privileged account to installhC               Compaq COBOL, set the default to SYS$UPDATE: and then_H               invoke VMSINSTAL, the command procedure that installs this"               product, as follows:  1               $ SET DEFAULT SYS$UPDATE   <Return> ?               $ @VMSINSTAL COBOLver ddn: option-list   <Return>   G               The following paragraphs describe the command parameters.a                 ver E               Represents the version and maintenance update number of H               Compaq COBOL (for example, 057). Refer to the label on theF               Compaq COBOL distribution kit or the Compaq COBOL BOM or!               BIL for the number.n                 ddn:E               Represents a device name where the distribution volumes F               will be mounted for the Compaq COBOL installation media;G               dd is the device code and n is the unit number. It is not I               necessary to use the console drive to install Compaq COBOL.mE               If you do use the console drive, you should replace anyi  I                                               Installing Compaq COBOL 2-1a                   D               media you removed from the drive. MYCPU$MUA100: is the<               device name used in examples in this document.                 option-listuD               The word OPTIONS followed by one or more of the option?               designators A, G, L, N, R, as shown in Table 2-1.r  I               Table_2-1_Installation_Option_Designators__________________o  I               Option_Name_____________Description________________________n  C               A      Auto_answer      Initially creates a file thatrH                                       contains your answers to VMSINSTALD                                       questions and prompts. You canB                                       then use the option (and theF                                       answer file) to save time duringG                                       a reinstallation (typically after =                                       upgrading your system)._  ?               G      Get saveset      Copies kit save set(s) to_F                      G de-            device:[directory]. Specifying aF                      vice:[directory] fast system storage device couldD                                       speed up installations, if youG                                       install from there. Or this couldBG                                       be a group distribution resource._  G               L      File Log         Logs all activity to the terminal :                                       during installation.  H               N      Display or       Indicates that you want to see theF                      Print the        installation question on releaseH                      Release Notes    notes. If you do not include the NH                                       option, VMSINSTAL does not ask youI                                       about the release notes. You should E                                       review the release notes before F                                       proceeding with the installationE                                       in case they contain additional_I                                       information about the installation.D  I                                                  (continued on next page)           #         2-2 Installing Compaq COBOL  o  r              I               Table_2-1_(Cont.)_Installation_Option_Designators__________u  I               Option_Name_____________Description________________________t  ?                                       If you are restarting theCC                                       installation and have alreadyrA                                       reviewed the release notes,wE                                       you may omit the N option. (The E                                       Compaq COBOL Release Notes willnE                                       be available regardless because B                                       VMSINSTAL copies them to the:                                       SYS$HELP directory.)  H               R      Alternate Root   Lets you install Compaq COBOL to aH                                       system root other than that of theI               ________________________running_system.____________________   I               You can also type an asterisk (*) in place of COBOL and its H               version number if you are installing from magnetic tape toI               save installation time. The asterisk causes Compaq COBOL to_9               be installed with a minimum of tape passes.   F               For example, the first parameter to VMSINSTAL for Compaq>               COBOL Version 5.7 could be either COBOL057 or *.  A               When you invoke VMSINSTAL, it checks the following:u  A               o  Whether or not you are logged in to a privilegediE                  account. Compaq recommends that you install softwareiD                  from the system manager's account with your default8                  device and directory set to SYS$UPDATE.  <               o  Whether or not you have adequate quotas for                  installation.  @               VMSINSTAL then checks whether or not the following               conditions exist:g  *               o  DECnet is up and running.  7               o  Any users are logged in to the system.l  B               If VMSINSTAL detects either of these conditions, youC               will be asked whether or not you want to continue thenE               installation. If you want to continue, type YES. If your:               want to stop the installation, press Return.  I                                               Installing Compaq COBOL 2-3i a                 E               Note that if another user accesses the Help file during I               your installation, it will be locked and cannot be updated.nF               In this case you will have to update Help manually afterH               the installation. Informational messages will be displayed               (see Step 9).u  %         2.2 Step-by-Step Installation   B               This section contains excerpts from the installation/               procedure and explains each step.   E               Defaults appear in brackets throughout the installationnH               procedure. To take a default, you can simply press Return.0               You can type Y or N for YES or NO.  D               To abort the installation procedure at any time, pressG               Ctrl/Y. When you press Ctrl/Y, the installation proceduresC               deletes all files it has created up to that point and E               then returns you to DCL level. If you want to retry the D               installation procedure after pressing Ctrl/Y, you must"               proceed from Step 2.  I               Step 1: Log in to a privileged account and set your default 1               device and directory to SYS$UPDATE.h  (                                 <Return>*               Username: SYSTEM    <Return>(               Password:         <Return>1               $ SET DEFAULT SYS$UPDATE   <Return>t  '               Step 2: Invoke VMSINSTAL.c  F               $ @VMSINSTAL COBOLver MYCPU$MUA100: OPTIONS N   <Return>  L                     OpenVMS VAX Software Product Installation Procedure Vn.n  )               It is dd-mmm-yyyy at hh:mm.q  =               Enter a question mark (?) at any time for help.   9               * Are you satisfied with the backup of your ,                  system disk [YES]? <Return>  G               If you are satisfied with the backup of your system disk,iB               press Return. Otherwise, type NO and press Return to+               discontinue the installation.e  #         2-4 Installing Compaq COBOLu m                 ?               Step 3: Insert the first installation kit volume.t  I               Depending on your media, you may get the following prompts:i  H               Please mount the first volume of the set on MYCPU$MUA100:.-               * Are you ready? YES   <Return>   E               To indicate that you want to continue the installation:a  /               1. Mount the installation volume.n                 2. Type YES.                 3. Press Return.  7               The following products will be processed:                    COBOL V5.n  ?                   Beginning installation of COBOL V5.n at hh:mmg  C               %VMSINSTAL-I-RESTORE, Restoring product save set A...K  K                   Release notes included with this kit are always copied tom                   SYS$HELP.i  4               Step 4: Select a release notes option.  G               This step applies only if you specified OPTIONS N in Step                2.  /               Additional Release Notes Options:   ,                    1.  Display release notes*                    2.  Print release notes#                    3.  Both 1 and 2 (                    4.  None of the above  -               * Select option [2]:   <Return>a  D               If you select option 1, VMSINSTAL displays the releaseB               notes on line immediately. They are lengthy. You canC               terminate the display at any time by pressing Ctrl/C.o  G               If you select option 2, VMSINSTAL prompts you for a queue H               name. Either type a queue name or press Return to send the6               file to the default output print device.  2               * Queue name [SYS$PRINT]:   <Return>  I                                               Installing Compaq COBOL 2-5e L                 D               If you select option 3, VMSINSTAL displays the releaseH               notes on line immediately and then prompts you for a queue               name.l  F                 ________________________ Note ________________________  C                 This version of the release notes file installed by B                 VMSINSTAL is labeled with the current product nameC                 and version number. Take care not to delete releaseeC                 notes for previous versions. They still may containn2                 information that is useful to you.  F                 ______________________________________________________  <               Next, VMSINSTAL displays the following prompt:  K               * Do you want to continue the installation [NO]? Y   <Return>oJ               %VMSINSTAL-I-RELMOVED, The product's release notes have been!                moved to SYS$HELP.e  D               If you want to continue the installation, type YES andA               press Return. Otherwise, VMSINSTAL discontinues the G               installation. In either case, VMSINSTAL moves the release                 notes to SYS$HELP.  I               Step 5: Install the COBOL Run-Time Library image separatelyG               (if applicable).  C               Compaq COBOL allows you to install the COBOL Run-Time E               Library (COBRTL) image (COBRTL.EXE) separately from theoE               full product installation. This option can be useful if I               your COBRTL has been overwritten or lost, or if you need tonH               run a COBOL application compiled with Compaq COBOL V5.n onF               a system that does not have Compaq COBOL V5.n installed.  H               Type NO or press Return at the prompt to continue with the0               full installation of Compaq COBOL.  H               If you want to install the COBRTL image only, type YES andA               press Return in response to the prompt, as follows:i  I               * Do you want to install only the COBRTL [NO]? Y   <Return>   A               In this case, the installation skips any subsequentrB               inquiries, including the question about the PAK, and8               proceeds to install only the COBRTL image.  E               As in the full installation, the version of the currento2               COBRTL.EXE is automatically checked.  #         2-6 Installing Compaq COBOL  e                 @               If the version already installed on your system isE               later than the COBRTL.EXE you are attempting to install I               separately, the installation procedure issues the followingt1               message followed by another prompt:t  M               %COBOL-I-IDNTCK, COBRTL found in SYS$SHARE has later ident than &                COBRTL to be installed.K               Do you still want to install COBRTL from kit [NO]?   <Return>   F               Press Return at the prompt to terminate the installationD               without installing the COBRTL image supplied with yourG               Compaq COBOL kit. Or type YES and press Return to installl               it.u  O               * Do you still want to install COBRTL from kit [NO]? Y   <Return> :               %COBOL-I-UPDIMG, Installing new COBRTL imageB               %PATCH-I-NOLCL, image does not contain local symbols6               %PATCH-I-WRTFIL, updating image file ...8                DKB300:[SYS0.SYSUPD.COBOLver]COBRTL.EXE;2=               %COBOL-I-UPDOBJ, Updating system object libraryiM               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target                 directories...   F                 ________________________ Note ________________________  >                 If your system includes a later version of theB                 COBRTL.EXE than the one that is supplied with your?                 Compaq COBOL kit, it is highly recommended that A                 you not install the earlier kit version. Backward F                 compatibility for your applications is not guaranteed;?                 that is, while applications compiled with olderr@                 versions of COBOL will run compatibly with newerD                 versions of the COBRTL, the reverse may not be true.  F                 ______________________________________________________  H               Remember to use the INSTALL utility to make the COBRTL.EXEF               that is replaced by the installation a known image. ThisE               must be done on every node in a VAXcluster. Use INSTALLsB               REPLACE or use the OpenVMS System Management utilityG               (SYSMAN) to facilitate the installation on multiple nodes                 (see Section 2.3).      I                                               Installing Compaq COBOL 2-7c r  s              -               Step 6: Respond to LMF queries.h  B               This product supports the OpenVMS License ManagementB               Facility (LMF). For more information on LMF, see the8               OpenVMS License Management Utility Manual.  I               During the installation procedure, the Compaq COBOL Product B               Authorization Key (PAK) is invoked and the following"               questions are asked:  J               * Does this product have an authorization key registered and'                  loaded? YES   <Return>s  F               This step allows you to indicate whether or not your LMF@               license for Compaq COBOL is registered and loaded.  E               It is strongly recommended that you install the PAK for ;               Compaq COBOL prior to installing the product.t  E               If the PAK is not installed, you can still proceed with I               the installation and install the PAK after the installationmF               is complete. However, a check for the PAK is done by theG               compiler during the IVP, and if the PAK is not installed, H               the IVP will fail. Also, the build of the REFORMAT utility>               (Step 7) requires prior installation of the PAK.  I               The following list summarizes the outcome of your responses                to this query:  @               o  If you answer YES and the PAK is installed, the0                  installation proceeds normally.  H               o  If you answer YES and the PAK is not installed, the IVP                  will fail.e  D               o  If you answer YES and the PAK is not installed, theH                  installation fails if you selected the REFORMAT utility                  option.  ?               o  If you answer NO, the installation terminates.o  E               In any case, the Compaq COBOL compiler will not execute :               until the PAK for Compaq COBOL is installed.  3               Step 7: Install the REFORMAT utility.   L               * Do you want the REFORMAT utility installed [YES]?   <Return>  D               Depending on your use of Compaq COBOL, you may want to4               install the optional REFORMAT utility.  #         2-8 Installing Compaq COBOLe                   8               Step 8: Respond to the message file query.  >               * Do you want to save the COBOL message file for.                  modification [NO]?   <Return>  E               This query enables you to edit the Compaq COBOL message                fileC               COBOLMSG.MSG. Customized messages are often desirable F               for international users. If you plan to edit the messageI               file, type YES and press Return. If you do not want to edit G               the message file, press Return. For more information, see                Section 3.2.  7               Step 9: Respond to the purge files query.                  If theE               installation is successful, the SYS$EXAMPLES, SYS$HELP,iD               SYS$LIBRARY, SYS$MANAGER, SYS$UPDATE, SYS$MESSAGE, andI               SYS$SYSTEM directories may contain previous versions of the +               following Compaq COBOL files:o  "               o  [SYSEXE]COBOL.EXE  %               o  [SYSEXE]REFORMAT.EXEe  &               o  [SYSLIB]DCLTABLES.EXE  -               o  [SYSTEST.COBOL]COBOL$IVP.COM   /               o  [SYSHLP]COBOLver.RELEASE_NOTES_  2               o  [SYSHLP]COBOLver_RELEASE_NOTES.PS  %               o  [SYSMSG]COBOLMSG.EXE   %               o  [SYSUPD]COBOLMSG.MSGs  3               o  [SYSLIB]LSE$SYSTEM_ENVIRONMENT.ENV   H               * Do you want to purge files replaced by this installation               [YES]?   <Return>   G               These files are replaced during the installation with new D               files, but the old files are not automatically purged.G               Purging is recommended. (Purging will not destroy earlier I               versions of the release notes, which you should retain.) In G               response to the purging prompt, press Return to purge the G               files or type NO to keep them. In either case, the system %               help files are updated.   I               Not purging these files allows you to go back to a previousl.               version of a file, if necessary.  I                                               Installing Compaq COBOL 2-9l t  t              C               The installation may also create a new version of the F               following file, which is not purged along with the other               files:  #               o  [SYSLIB]COBRTL.EXEn  G               The installation procedure may update the following fileseI               (it will not create new versions of them, nor will it purgek               them):  %               o  [SYSLIB]IMAGELIB.OLBo  $               o  [SYSLIB]STARLET.OLB  D               The query on purging files is the last one you have toF               respond to during the installation. After you respond to=               this query, the following message is displayed:   I                 No more questions will be asked during this installation.   A               If another user has locked the Help file during the F               installation, the following three informational messages               are issued:l  F               %VMSINSTAL-I-DCLHLPINUSE, DCL HELP could not be updated.L               -VMSINSTAL-I-DCLHLPINUSE, manually update HELP libraries after               installation.CO               -VMSINSTAL-I-DCLHLPINUSE, use SYS$COMMON:[SYSHLP]COBOLHLP.HLP for !               providing new HELP.d  C               You may need to mount additional distribution volumestI               depending on the media used. In this case, you will receivelH               a prompt from VMSINSTAL to determine that you are ready to%               proceed. (See Step 10.)   H               Step 10: Insert the subsequent installation kit volumes as               requested.  1               %BACKUP-I-READYREAD, mount volume 2s+               on _MYCPU$MUA100: for reading   4               Enter "YES" when ready: YES   <Return>  G               VMSINSTAL prompts you to insert the next volume and waits A               for you to type YES after inserting it. If you type E               NO, VMSINSTAL displays the prompt again. This prompt istH               displayed only if your installation kit contains more thanF               one volume. Exactly when these prompts appear depends on3               the type of media that you are using.I  $         2-10 Installing Compaq COBOL o  .              7               Step 11: Read the informational messages.S  G               The Compaq COBOL installation procedure produces a numberoF               of informational messages that report on the progress of               the installation.   A               The success of the installation is indicated by the                 following message:  F               %VMSINSTAL-I-MOVEFILES, files will now be moved to their#               target directories...   E               If the installation procedure is successful, the new or C               modified files are moved to their target directories.n  D               The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXEB               files are updated to include the new versions of theF               Compaq COBOL Help text and the Compaq COBOL command line               definition.w  G               Step 12: Observe the Installation Verification Procedure.t  I               VMSINSTAL now calls the IVP to verify that Compaq COBOL wasg%               installed successfully.   @               Start of Compaq COBOL for OpenVMS VAX Installation$               Verification Procedure  E               Successful test of Compaq COBOL for OpenVMS VAX V5.n-ccu;               Installation of COBOL V5.n completed at hh:mmn  B               If another user has locked the Help file during yourA               installation, the following messages are displayed:   D               %VMSINSTAL-I-REFDCLHLP, DCL HELP could not be updated.H               -VMSINSTAL-I-REFDCLHLP, Reference SYS$UPDATE:DODCLHELP.VMIK               for information on -VMSINSTAL-I-REFDCLHLP, updating DCL HELP.t  6               Step 13: End the installation procedure.  2                  VMSINSTAL procedure done at hh:mm  !               $ LOGOUT   <Return>e>               SYSTEM     logged out at dd-mmm-yyyy hh:mm:ss.ss  F               When the product installation procedure is complete, youI               can choose to install more products or to log out (as shown D               here). If you removed any media from the console driveF               before beginning the installation, you should replace it               now.  I                                              Installing Compaq COBOL 2-11h                   C               Note that VMSINSTAL deletes or changes entries in the G               process symbol tables during the installation. Therefore,PE               if you are going to continue using the system manager's G               account and you want to restore these symbols, you should '               log out and log in again.I  3         2.3 Installing Compaq COBOL on a VAXclusterm  H               You can use the OpenVMS System Management utility (SYSMAN)G               to facilitate running Compaq COBOL on multiple nodes in a F               cluster. With SYSMAN, you can define a system managementB               environment so that operations performed on one nodeB               are automatically executed on all other nodes in theE               VAXcluster. (See the OpenVMS VAX documentation for more                information.)t  E               Always check first to see that you have the appropriatenD               software license. Once you have installed Compaq COBOLB               on one system disk in the VAXcluster, you can updateB               the version of the DCL tables and the version of theD               COBRTL installed on the other nodes in the cluster. Do               the following:  @               1. Log in to a privileged account on a node on theB                  VAXcluster. Invoke SYSMAN and enter the following/                  command at the SYSMAN> prompt:t  :                  SYSMAN>SET ENVIRONMENT/CLUSTER   <Return>  H               2. If you are a new customer, ensure that the PAK has beenF                  registered before attempting to install Compaq COBOL.I                  To load the PAK on all nodes in your cluster environment F                  simultaneously, invoke SYSMAN and enter the following/                  command at the SYSMAN> prompt:O  5                  SYSMAN>LICENSE LOAD COBOL   <Return>   D               3. Enter the following commands at the SYSMAN> prompt:  M                  SYSMAN>DO INSTALL REPLACE SYS$SHARE:DCLTABLES.EXE   <Return>oJ                  SYSMAN>DO INSTALL REPLACE SYS$SHARE:COBRTL.EXE   <Return>        $         2-12 Installing Compaq COBOL i  l              5         2.4 Installing Compaq COBOL as a Shared Imagea  F               If Compaq COBOL will be used extensively on your system,H               you can reduce the system overhead and memory requirements@               by installing it as a shared image. To perform theE               installation on a system that is currently running, userF               the OpenVMS Install utility while you are logged in to aF               privileged account. If errors occur, consult the OpenVMS,               system messages documentation.  I               Do the following to install Compaq COBOL for OpenVMS VAX asl               a shared image:_  C               1. Determine the number of available global pages andiD                  global sections on your system. See Section 1.3 for/                  information on how to do this.   F               2. Invoke the OpenVMS Install utility and install Compaq5                  COBOL as a shared image, as follows:n  %                  $ INSTALL   <Return>f  I                  INSTALL> ADD SYS$SYSTEM:COBOL.EXE/OPEN/SHARED   <Return>_M                  INSTALL> ADD SYS$MESSAGE:COBOLMSG.EXE/OPEN/SHARED   <Return> )                  INSTALL> EXIT   <Return>l  H               3. Update the system startup file to install Compaq COBOL.  B               To ensure that Compaq COBOL is installed as a sharedA               image each time the system is bootstrapped, include C               the following lines in the site-specific startup file D               SYS$MANAGER:SYSTARTUP_V5.COM or SYS$MANAGER:SYSTARTUP_G               VMS.COM (SYS$MANAGER:SYSTARTUP_V5.COM has been changed toOI               SYS$MANAGER:SYSTARTUP_VMS.COM for OpenVMS V6.2 and higher).   <               $ INSTALL ADD SYS$SYSTEM:COBOL.EXE/OPEN/SHARED@               $ INSTALL ADD SYS$MESSAGE:COBOLMSG.EXE/OPEN/SHARED  G         2.5 Using the PCSI Transition Kit to Register Compaq COBOL V5.7i             and the COBRTL  B               After the installation of Compaq COBOL V5.7 has beenI               completed, the installer on OpenVMS VAX V6.2 and higher cantH               use five new files delivered with this kit to register theF               COBOL compiler and the COBRTL in the POLYCENTER SoftwareC               Installation utility (PCSI) database. These files arelC               placed in your SYS$UPDATE directory. These files are:e  I                                              Installing Compaq COBOL 2-13o                   8               DEC-VAXVMS-COBOL-V0507--6.PCSI$DESCRIPTION0               DEC-VAXVMS-COBOL-V0507--6.PCSI$TLB9               DEC-VAXVMS-COBRTL-V0506--6.PCSI$DESCRIPTIONr1               DEC-VAXVMS-COBRTL-V0506--6.PCSI$TLB %               COBOL_PCSI_REGISTER.COMv  E               The first four files provide binary product information.C               for the product registrations. They constitute a PCSI G               transition kit for the COBOL compiler and another for the G               COBRTL. The fifth file, COBOL_PCSI_REGISTER.COM, containseI               two DCL PRODUCT REGISTER commands, which accomplish the twoe               registrations.  H               After the successful completion of the kit using VMSINSTALE               as shown in the Installation Guide, you can execute theu4               following @ command at the DCL prompt:  $               $ @COBOL_PCSI_REGISTER  G               The procedure will ask you twice if you wish to continue:CG               once for COBOL V5.7 and once for COBRTL V5.6. Answer Y toEH               both inquiries. This procedure will take approximately one                minute to execute.  F                 ________________________ Note ________________________  D                 The file COBOL_PCSI_REGISTER.COM is only for OpenVMSD                 VAX V6.2 or higher, which has the PRODUCT command. AB                 user of OpenVMS VAX V5.5-2 who attempts to execute?                 this file will receive only diagnostic messagesVA                 indicating that the PRODUCT command was not found )                 by the command processor.   C                 WARNING: You are strongly urged not to remove these C                 two registrations from the PCSI database. They willOD                 not need to be redone. Their purpose is to tell PCSIE                 that you have the COBOL and COBRTL software installednC                 on your system. Further, the only PCSI command thattF                 could remove these database entries is the DCL command?                 PRODUCT REMOVE, which would not only remove the D                 references to the COBOL and COBRTL software from theA                 database, but would also remove all traces of the_B                 named software from your system, and this software:                 would have to be reinstalled from scratch.  F                 ______________________________________________________  $         2-14 Installing Compaq COBOL t                                                                                                           I                                              Installing Compaq COBOL 2-15i 2  .                    I                                                                         3 I         _________________________________________________________________h  I                                                        After InstallationM    H               Compaq COBOL is now installed on your local system and can=               be invoked by all users with the COBOL command.r  G               The installation procedure modifies the DCL command tablesD               so that the COBOL command is recognized and processed.D               However, the previous command table is still in effectH               for those users who are currently logged in. All logged inI               users who want to use the newly installed version of Compaqq7               COBOL should issue the following command:t  B               $ SET COMMAND/TABLE=SYS$LIBRARY:DCLTABLES   <Return>  F               If Compaq COBOL will be used extensively on your system,D               you can reduce system overhead and memory requirementsE               by installing it as a shared image by using the OpenVMStE               Install utility. For more information, see Section 2.4.d  F         3.1 Running the Installation Verification Procedure Separately  B               The Installation Verification Procedure (IVP) is runD               at installation. If you want to run the IVP separatelyE               to ensure the integrity of installed files, execute thei*               following command procedure:  C               $ @SYS$COMMON:[SYSTEST.COBOL]COBOL$IVP.COM   <Return>s  I               If the IVP fails for any reason, the following messages are,               displayed:  @               The Compaq COBOL for OpenVMS VAX V5.n Installation,               Verification Procedure failed.  L               %VMSINSTAL-E-IVPFAIL, The IVP for Compaq COBOL for OpenVMS VAX               V5.n has failed.    I                                                    After Installation 3-1l w                 B               What to Do If the Installation Fails During or After               Running the IVPO  G               Some causes of installation failure after running the IVPd?               can produce error messages such as the following:a  .               %CLI-F-SYNTAX, error parsing ...  #               %COBOL-F-BADVALUE ...   >               These errors indicate an incompatibility betweenB               SYS$SYSTEM:COBOL.EXE and the COBOL command syntax inE               SYS$LIBRARY:DCLTABLES. To understand the causes of such @               errors and to correct them, follow this procedure:  H               1. If either SYS$SYSTEM:COBOL.EXE or SYS$LIBRARY:DCLTABLESC                  exists in SYS$SPECIFIC, the SYS$SPECIFIC file willaH                  override the file in SYS$COMMON (where the installationF                  procedure places these files). Ensure that neither of4                  these files exists in SYS$SPECIFIC.  C               2. Deassign any logical names for COBOL or DCLTABLES.q  C               3. If neither 1 nor 2 applies and you are in the samel@                  account on the same node where Compaq COBOL wasG                  installed, this error indicates that DCLTABLES was notmI                  updated. This error usually occurs when another user hadfG                  DCLTABLES locked during the installation procedure. ToRD                  correct the error, you must reinstall Compaq COBOL.  D               Other causes of installation failure after running theC               IVP can produce RPC$SHARE error messages. Such errors F               occur because Compaq COBOL accesses RPC$SHARE indirectlyG               through CDDSHR.EXE (if you have a version of CDD prior to I               Version 5.0) and usually indicate a problem with the Oracle C               CDD/Repository installation. To correct these errors,d6               execute the following command procedure:  5               $ @SYS$STARTUP:CDDSTRTUP.COM   <Return>   H               If you encounter other errors after executing this commandH               procedure, consult the Oracle CDD/Repository documentationF               for further information or contact your Customer Support               Center.t           3-2 After Installation e                 3         3.2 Customizing Compaq COBOL Error Messages   G               If you choose to customize the Compaq COBOL message file,aH               the installation procedure copies the Compaq COBOL messageI               file COBOLMSG.MSG into the system directory [SYSUPD]. AfteriF               the file is copied to the system directory, you can editE               COBOLMSG.MSG to customize the error messages that users F               receive when using Compaq COBOL. Customized messages are6               often desirable for international users.  *               There are two prerequisites:  I               o  You must install Compaq COBOL before editing the message D                  file. If you install Compaq COBOL after editing theG                  message file, the software installation's COBOLMSG.MSG E                  file will supersede your revised message file in thew$                  [SYSMSG] directory.  D               o  You must have the OpenVMS Message utility installedG                  on your system before editing COBOLMSG.MSG. The edited F                  version of COBOLMSG.MSG must be processed through theC                  Message utility before the file can be accessed byP                  Compaq COBOL.  F               The following steps explain how to edit the Compaq COBOLF               messages and install the customized message file on your               system:L  G               1. Run the Compaq COBOL installation procedure and answerdC                  YES to the question "Do you want to save the COBOLn5                  message file for modification [NO]?"   D                  The installation procedure copies the message file,B                  COBOLMSG.MSG, into the system directory [SYSUPD].  3               2. Edit the message file in [SYSUPD].   E                  Each error message appears on a separate line and is H                  enclosed in angle brackets (< >). You can edit the textD                  portion of the error messages, but for Compaq COBOLG                  to correctly identify the error messages, you must nott&                  change the following:  F                  o  The 3- to 9-character mnemonic that appears in the                      first column  F                  o  The sequence in which the error messages appear in                     the file  ;                  o  The severity level of the error messagel  I                                                    After Installation 3-3m o                 F                  o  The number, type, and order of the formatted ASCIID                     ouput (FAO) arguments that appear in the message  1               3. Run the OpenVMS Message utility.   C                  To translate the new message text into a file thatlG                  Compaq COBOL can access, process the text file through G                  the Message utility by entering the following command:t  .                  $ MESSAGE COBOLMSG   <Return>  >                  The Message utility creates the object module                  COBOLMSG.OBJ.  D               4. Enter the LINK command with the /SHARE qualifier to9                  create the shareable image COBOLMSG.EXE:o  1                  $ LINK/SHARE COBOLMSG   <Return>e  F               5. Copy COBOLMSG.EXE into the system directory [SYSMSG]:  M                  $ COPY COBOLMSG.EXE SYS$COMMON:[SYSMSG]/PROT=W:RE   <Return>r  C               6. If Compaq COBOL is installed as a known image, you F                  must reinstall COBOLMSG.EXE by entering the following                  command:e  B                  $ INSTALL REPLACE SYS$MESSAGE:COBOLMSG   <Return>  B               Compaq COBOL will now generate your customized error               messages.u           3.3 Error Conditions  C               If the installation procedure fails for any reason, ay6               message like the following is displayed:  I               %VMSINSTAL-E-INSFAIL, The installation of Compaq COBOL V5.nA               has failed.   G               An error during the installation can occur if one or more 0               of the following conditions exist:  7               o  Operating system version is incorrect.   <               o  Prerequisite software version is incorrect.  A               o  Quotas necessary for successful installation area0                  insufficient (see Section 1.3).  H               o  Process quotas required by VMSINSTAL are incorrect (see                  Section 2.1).           3-4 After Installation    o              :               o  OpenVMS Help library is currently in use.  ?               o  Product Authorization Key (PAK) was registeredB/                  incorrectly or not registered.e  G               For descriptions of the error messages generated by thesey9               conditions, see the OpenVMS system messages 3               documentation,your processor-specificaF               installation or operations guide, or the OpenVMS License(               Management Utility Manual.  E               If you are notified that any of these conditions exist, F               take the appropriate action as described in the message.F               You may need to change a system parameter or increase an%               authorized quota value.a  =               If the installation fails, you must restart thepB               installation procedure from Step 2. The installationE               may fail due to an IVP failure. If so, you should firstVC               consult the instructions in Section 3.1. If you still @               need assistance, contact your Compaq field serviceG               representative or the Customer Support Center if you have                support.  ,         3.4 Special Save Set for COBRTL Only  G               Within the COBOL057.C save set, there is another save setOG               named COBRTL057.A containing files needed to install onlyoF               the COBOL Run-Time Library (COBRTL) image. Although mostD               users have no need of this, you may find this save setF               useful if you are a vendor distributing Compaq COBOL forE               OpenVMS VAX systems applications to your customers, andrH               have experienced incompatibility problems with the versionG               of the COBRTL on your customers' systems in the past. YoueE               can distribute the COBRTL057.A save set with your COBOLaH               application to enable your customers to install the COBRTLE               on their VAX systems. Note that the COBRTL.EXE image is<H               identical to the COBRTL.EXE image shipped on the main kit.  D               To extract the COBRTL057.A save set, copy the save setG               COBOL057.C from your media to your default directory, andB               do the following:   N   $ BACKUP COBOL057.C/SAVE/SELECT=COBRTL057.A destination-directory   <Return>  I                                                    After Installation 3-5n e  o              A               The COBRTL057.A save set can then be distributed torF               customers with your Compaq COBOL for OpenVMS VAX systems@               application and installed on their system with theG               VMSINSTAL utility, as described in Step 5 in Section 2.2. B               Note that there is no problem with licensing, as theG               COBRTL.EXE can be copied to any properly licensed OpenVMSo               VAX system.o           3.5 Maintenance Updates   B               Compaq may periodically issue maintenance updates ofH               Compaq COBOL. Each update consists of an installation kit.F               Install this kit as described in this document or in anyF               documentation that may accompany the maintenance update.  E               Each time a maintenance update is released, the version I               number changes. For example, if the current version is 1.0,BH               the version number of the first maintenance update will beI               1.1. The maintenance update also includes new release notesuE               that describe the changes that have been made to Compaqa/               COBOL since the previous release.O  H               The updated release notes are provided on line. You shouldI               read the release notes when you first install Compaq COBOL;cG               they are also accessible at any time after the product is:E               installed. For information on reading the release notesnC               at the time that you install Compaq COBOL, follow the D               installation procedure through Step 4 in Chapter 2. ToG               locate the release notes after Compaq COBOL is installed,HG               display or print the file SYS$HELP:COBOLver.RELEASE_NOTESL$               or type the following:  3               $ HELP COBOL RELEASE_NOTES   <Return>.                                 3-6 After Installation M  A                    I                                                                         AeI         _________________________________________________________________   I                                                       Sample Installation     B               This appendix contains a sample listing of a regular<               installation of Compaq COBOL, followed by PCSIC               registration. Please note: this is only a sample. TheID               installation procedure may be modified for maintenanceH               updates of this product. Because this guide is not usuallyB               revised for maintenance updates, be sure to read theF               Read Before Installing or Using Compaq COBOL Version 5.nD               for OpenVMS VAX Systems letter before you install thisG               product. This letter notes any significant changes in the 6               installation that vary from this sample.  :               In the sample installation, the generic termB               "device::[directory]" replaces the actual device and3               directory names on the user's system.e           Username: SYSTEM         Password:   7          COBOL Cluster- (VAXstation 4000-96) - VMS V6.2   ?             Last interactive login on Monday, 23-OCT-2000 12:04SF             Last non-interactive login on Wednesday, 30-AUG-2000 12:23           $ set def sys$update         $ Installn  $         INSTALL> list/global/summary  0          Summary of Local Memory Global SectionsK             679 Global Sections Used,  85944/77456 Global Pages Used/Unused_         INSTALL> exit           I                                                   Sample Installation A-1f O  V                       $ run sys$system:sysgena         SYSGEN>  USE CURRENT          SYSGEN>  SHO GBLSECTIONSP Parameter Name            Current    Default     Min.     Max.     Unit  DynamicP --------------            -------    -------    -------  -------   ----  -------I GBLSECTIONS                  1000        250        60      4095 Sectionsa         SYSGEN>  EXITo:         $ @vmsinstal cobol057 device:[directory] options n  A          OpenVMS VAX Software Product Installation Procedure V6.2r  #         It is 23-OCT-2000 at 14:52.   7         Enter a question mark (?) at any time for help.   F         %VMSINSTAL-W-ACTIVE, The following processes are still active:          UCX$REXE_BG5995          DECW$TE_0418t          LPS_FTEST          LPS_GUDWRKE          LPS_OB2PRT           LPS_PROTON           LPS_PS2          UCX$PORTM          SQLSRV$SERVER          DCE$RPCD           DECW$TE_0A74o          UCX$REXE_BG5449          UCX$REXE_BG2177          DECW$TE_0491,          DECW$TE_0DA3           NOTES$0021_1*          _FTA21:          NOTES$000D_13*           _FTA22:0         * Do you want to continue anyway [NO]? yF         * Are you satisfied with the backup of your system disk [YES]?  1         The following products will be processed:              COBOL V5.7  6          Beginning installation of COBOL V5.7 at 14:53  >         %VMSINSTAL-I-RESTORE, Restoring product save set A ...  O             Release notes included with this kit are always copied to SYS$HELP._           A-2 Sample Installation_ _                 -             Additional Release Notes Options:r  "          1.  Display release notes           2.  Print release notes          3.  Both 1 and 2           4.  None of the above           * Select option [2]: 2:         * Do you want to continue the installation [NO]? yL  %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.O  +----------------------------------------------------------------------------+ O  |                     Installation Command Procedure for                     | O  |                Compaq COBOL V5.7-63 Compiler for OpenVMS VAX.              |dO  +----------------------------------------------------------------------------+C  3          Copyright 2000 Compaq Computer Corporationl  ?          COMPAQ Registered in U.S. Patent and Trademark Office.s  O          Confidential computer software. Valid license from Compaq required foriK          possession, use or copying. Consistent with FAR 12.211 and 12.212,oK          Commercial Computer Software, Computer Software Documentation, andcP          Technical Data for Commercial Items are licensed to the U.S. Government4          under vendor's standard commercial license.  6         * Do you want to install only the COBRTL [NO]?            Product:      COBOL$                 Producer:     COMPAQ!                 Version:      5.7M)                 Release Date: 23-OCT-2000s  N         * Does this product have an authorization key registered and loaded? y  N         The ANSI/Terminal-Format REFORMAT Utility may optionally be installed.  <         * Do you want the REFORMAT Utility installed  [YES]?L         * Do you want to save the COBOL message file for modification  [NO]?  I          This installation procedure creates a new version of, or updates ,          some or all of the following files:        I                                                   Sample Installation A-3  u  n              !                 [SYSEXE]COBOL.EXEl$                 [SYSEXE]REFORMAT.EXE%                 [SYSLIB]DCLTABLES.EXEs,                 [SYSTEST.COBOL]COBOL$IVP.COM.                 [SYSHLP]COBOL057.RELEASE_NOTES1                 [SYSHLP]COBOL057_RELEASE_NOTES.PSi$                 [SYSMSG]COBOLMSG.EXE$                 [SYSUPD]COBOLMSG.MSGB                 [SYSUPD]DEC-VAXVMS-COBOL-V0507--6.PCSI$DESCRIPTION:                 [SYSUPD]DEC-VAXVMS-COBOL-V0507--6.PCSI$TLBC                 [SYSUPD]DEC-VAXVMS-COBRTL-V0506--6.PCSI$DESCRIPTIONS;                 [SYSUPD]DEC-VAXVMS-COBRTL-V0506--6.PCSI$TLBe/                 [SYSUPD]COBOL_PCSI_REGISTER.COMa  I         * Do you want to purge files replaced by this installation [YES]?   I           The installation procedure may also create a new version of the G           following file, which is not purged along with the previously            listed files:O  "                 [SYSLIB]COBRTL.EXE  O         This installation procedure additionally may update the following files J         (it will not create new versions of them, nor will it purge them):  $                 [SYSLIB]IMAGELIB.OLB#                 [SYSLIB]STARLET.OLBo  C           No more questions will be asked during this installation.t  N           Installing Compaq COBOL for OpenVMS VAX and running the IVP requiresP           approximately 5 to 10 minutes, depending on your system configuration.  4         %COBOL-I-UPDIMG, Installing new COBRTL image<         %PATCH-I-NOLCL, image does not contain local symbolsK         %PATCH-I-WRTFIL, updating image file device:[directory]COBRTL.EXE;2v7         %COBOL-I-UPDOBJ, Updating system object librarya>         %VMSINSTAL-I-RESTORE, Restoring product save set B ...  C                 The IVP has been moved to directory [SYSTEST.COBOL]c  N              To invoke the IVP, enter @SYS$COMMON:[SYSTEST.COBOL]COBOL$IVP.COM  >         %VMSINSTAL-I-RESTORE, Restoring product save set C ...           A-4 Sample Installation  r  d              E          The following PCSI-related files have been moved to [SYSUPD]m4           DEC-VAXVMS-COBOL-V0507--6.PCSI$DESCRIPTION,           DEC-VAXVMS-COBOL-V0507--6.PCSI$TLB5           DEC-VAXVMS-COBRTL-V0506--6.PCSI$DESCRIPTIONL-           DEC-VAXVMS-COBRTL-V0506--6.PCSI$TLB !           COBOL_PCSI_REGISTER.COMg  O  %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...   <                 Start of Installation Verification Procedure)          for Compaq COBOL for OpenVMS VAXd  3          Copyright 2000 Compaq Computer CorporationO  ?          COMPAQ Registered in U.S. Patent and Trademark Office.   O          Confidential computer software. Valid license from Compaq required foriK          possession, use or copying. Consistent with FAR 12.211 and 12.212, K          Commercial Computer Software, Computer Software Documentation, and P          Technical Data for Commercial Items are licensed to the U.S. Government4          under vendor's standard commercial license.  7                 Successful test of Compaq COBOL V5.7-63e6          Installation of COBOL V5.7 completed at 14:55  *          VMSINSTAL procedure done at 14:55  "         $ @COBOL_PCSI_REGISTER.COM  0         The following product has been selected:         DEC VAXVMS COBOL V5.7r  &         Do you want to continue? [YES]1         The following product will be registered:h         DEC VAXVMS COBOL V5.7 +         Portion Done: 0%...10%...20%...100%h2         The following product has been registered:          DEC VAXVMS COBOL V5.7-63  0         The following product has been selected:         DEC VAXVMS COBRTL V5.6        I                                                   Sample Installation A-5h u  i              &         Do you want to continue? [YES]1         The following product will be registered:          DEC VAXVMS COBRTL V5.6+         Portion Done: 0%...10%...70%...100%B2         The following product has been registered:!         DEC VAXVMS COBRTL V5.6-15e$         $ product show history cobol@         PRODUCT                        OPERATION       DATE/TIME@         -------                        ---------       ---------K         DEC VAXVMS COBOL V5.7-63       REG. PRODUCT    23-OCT-2000 15:11:55            1 item found%         $ product show history cobrtl @         PRODUCT                        OPERATION       DATE/TIME@         -------                        ---------       ---------K         DEC VAXVMS COBRTL V5.6-15      REG. PRODUCT    23-OCT-2000 15:12:04p           1 item found         $ install 5         INSTALL> add sys$system:cobol.exe/open/sharedl9         INSTALL> add sys$message:cobolmsg.exe/open/sharedr         INSTALL> exit .         $ @sys$common:[systest.cobol]cobol$ivp  3          Copyright 2000 Compaq Computer Corporation   ?          COMPAQ Registered in U.S. Patent and Trademark Office.   O          Confidential computer software. Valid license from Compaq required foreK          possession, use or copying. Consistent with FAR 12.211 and 12.212,sK          Commercial Computer Software, Computer Software Documentation, andeP          Technical Data for Commercial Items are licensed to the U.S. Government4          under vendor's standard commercial license.  7                 Successful test of Compaq COBOL V5.7-63t         $ lo;           SYSTEM      logged out at 23-OCT-2000 14:56:01.34h                         A-6 Sample Installation$ N  H                    I                                                                         BGI         _________________________________________________________________<  H                                           Files Installed on Your System    @               The Compaq COBOL installation procedure installs aF               number of files on your system. Table B-1 identifies the;               directories that contain the installed files.L  I         Table_B-1_Directories_Containing_Compaq_COBOL_Installed_Files____   I         Directory_____File_Name________________File_Content_Summary______   =         [SYSEXE]      COBOL.EXE                Compiler imagea  C         [SYSEXE]      REFORMAT.EXE             ANSI/Terminal-FormatC?                                                REFORMAT utilityd  ;         [SYSMSG]      COBOLMSG.EXE             Message file   F         [SYSUPD]      COBOLMSG.MSG             Customizable source for>                                                message file[1]  I         [SYSHLP]      COBOL05n.RELEASE_NOTES   Release notes (ASCII file)a  H         [SYSHLP]      COBOL05n_RELEASE_        Release notes (POSTSCRIPT4                       NOTES.PS                 file)  G         [SYSLIB]      COBRTL.EXE               Compaq COBOL for OpenVMS C                                                VAX Systems Run-TimetA                                                Support Library[2]r  H         [SYSLIB]      DCLTABLES.EXE            Updates to the system DCL5                                                tablesh  C         [SYSLIB]      IMAGELIB.OLB             New run-time symbols   H         [SYSLIB]      STARLET.OLB              Updated with Compaq COBOLF                                                for OpenVMS VAX Systems>                                                RTL routines[2]  I         [1]See_Section_3.2_for_information_on_customizing_the_Compaq_____d3         COBOL for OpenVMS VAX systems message file.eB         [2]This file is added or updated if an RTL installation is         performed.  I                                                  (continued on next page)i  I                                       Files Installed on Your System  B-1I f  u              G         Table B-1 (Cont.) Directories Containing Compaq COBOL Installed I         __________________Files__________________________________________e  I         Directory_____File_Name________________File_Content_Summary______   H         [SYSTEST.COBOLCOBOL$IVP.COM            Installation VerificationI         _______________________________________Procedure_________________                                                                             *         B-2 Files Installed on Your System .  t                    I                                                                         C I         _________________________________________________________________n  I                                                    Recovering from Errorsr    A               This appendix provides information to help you withC@               failures or errors that might occur during product*               installation or product use.  H         C.1 Failures During Installation of Compaq COBOL for OpenVMS VAX             Systems   H               If VMSINSTAL detects any problems during the installation,B               it notifies you and asks if you want to continue theC               installation. In some instances, you can enter YES to D               continue. To stop the installation process and correctH               the situation, enter NO and press Return. Then correct the3               problem and restart the installation.   D               If errors occur during the installation itself or whenG               the Installation Verification Procedure (IVP) is running,tF               VMSINSTAL displays failure messages. If the installation3               fails, you see the following message:e  I               %VMSINSTAL-E-INSFAIL, The installation of Compaq COBOL V5.nn               has failed.   7               If the IVP fails, you see these messages:   M               The Compaq COBOL for OpenVMS VAX V5.n Installation Verification                Procedure failed.n  L               %VMSINSTAL-E-IVPFAIL, The IVP for Compaq COBOL for OpenVMS VAX               V5.n has failed.  D               Errors can occur during the installation if any of the)               following conditions exist:n  ;               o  The operating system version is incorrect.n  >               o  A prerequisite software version is incorrect.  A               o  Quotas necessary for successful installation areh                  insufficient.  I                                                Recovering from Errors C-1     .              H               o  System parameter values for successful installation are                  insufficient.  >               o  The OpenVMS Help library is currently in use.  H               o  The product license has not been registered and loaded.  G               For descriptions of the error messages generated by these E               conditions, see the OpenVMS VAX documentation on system E               messages, recovery procedures, and OpenVMS VAX software A               installation. If you are notified that any of these F               conditions exist, you should take the appropriate actionC               as described in the message. Also see Section 3.1 andH               Section 3.3.  ?               For information on installation requirements, seep               Chapter 1.  $         C.2 Diagnostic Message Table  E               Table C-1 shows the messages that can occur during your D               installation and the actions you can take in response:  I         Table_C-1_Installation_Messages___________________________________  I         _____________________Warning-Level_Messages______________________   9         %DCL-W-ACTIMAGE, error activating image RPC$SHAREs  ;         Explanation:                    Solution or Action:o  H         RPC$SHARE image is not          Consult with your system manager<         available.                      to start up the CDD.  I                                                  (continued on next page)e                    "         C-2 Recovering from Errors e  c              I         _________________________________________________________________L  I         ______________________Error-Level_Messages_______________________   F         %VMSINSTAL-E-IVPFAIL, The IVP for Compaq COBOL 5.n has failed.  ;         Explanation:                    Solution or Action:   C         Compaq COBOL Version 5.n has    Rerun the IVP separately to C         been installed but the IVP run  determine the source of the 0         was unsuccessful.               failure.  "         -CLI-E-IMGNAME, image file6         DISK$:[SYS0.SYSCOMMON.][SYSLIB]RPC$SHARE.EXE;1  ;         Explanation:                    Solution or Action:   H         Attempt to execute RPC$SHARE    Consult with your system manager<         was unsuccessful.               to start up the CDD.  G         %VMSINSTAL-E-INSFAIL, The installation of Compaq COBOL V5.n has          failed.   ;         Explanation:                    Solution or Action:u  H         Compaq COBOL Version 5.n        Consult with your system managerI         has not been successfully       for system resources required for 5         installed.                      installation.   I                                                  (continued on next page)M                              I                                                Recovering from Errors C-3- -                 I         _________________________________________________________________N  I         ______________________Fatal-Level_Messages_______________________   (         %CLI-F-SYNTAX, error parsing ...  ;         Explanation:                    Solution or Action:   C         The DCL Command Line            Make sure you are using theTD         Interpreter encountered         correct .CLD, or log out and:         invalid syntax in a command.    log back in again.           %COBOL-F-BADVALUE ...2  ;         Explanation:                    Solution or Action:M  C         A value of invalid type or      Make sure you are using the D         a value of invalid range was    correct .CLD, or log out and:         encountered.                    log back in again.  @         SYSTEM-F-PROTINSTALL, protected images must be installed  ;         Explanation:                    Solution or Action:   H         Protected images must be        Installation of protected imagesH         installed.                      requires the /PROTECT qualifier.I                                         Consult with your system manager.d  C         SYSTEM-F-SHRIDMISMATCH, ident mismatch with shareable imagea  ;         Explanation:                    Solution or Action:o  H         The global section ID in a      Consult with your system managerG         shareable image does not match  to relink the executable image. I         its_executable_image.____________________________________________o  G         C.3 Problems During Use of Compaq COBOL for OpenVMS VAX Systems%  E               If you encounter a problem while using Compaq COBOL for.H               OpenVMS VAX systems, please report it to Compaq. DependingC               on the type of support you have and the nature of the 9               problem, take one of the following actions:3  @               o  If you have a Software Product Services SupportG                  Agreement, contact your Compaq Customer Support CenterrF                  (CSC), either by telephone or by using the electronicA                  means provided with your support agreement (suchrD                  as DSNlink). The CSC provides telephone support forB                  high-level advisory and remedial assistance. When  "         C-4 Recovering from Errors o  a              C                  you initially contact the CSC, please indicate theo                  following:   H                  -  The name (OpenVMS VAX) and the version number of the2                     operating system you are using  G                  -  The product name (Compaq COBOL for OpenVMS VAX) and F                     the version number of Compaq COBOL for OpenVMS VAX!                     you are usinge  F                  -  The hardware system you are using, such as a model                     number  I                  -  A very brief description of the problem (one sentence                       if possible)  <                  -  How critical the problem is to your site  G                  When you submit information electronically or speak on F                  the phone to the appropriate Compaq COBOL for OpenVMSF                  VAX support specialist, you can provide more detailedI                  information. The information should include the specificII                  commands used to compile and link the program, the error F                  messages displayed, and relevant detailed informationE                  (possibly including source program listings). PleaseSI                  attempt to narrow the cause of the problem to a specificD)                  module or lines of code.V  B                  Please submit electronic copy of all source filesC                  required to demonstrate the problem. This includes-?                  source program code, source copy libraries andOH                  dictionaries, data files and databases, as well as .COM=                  files to compile, link, and run the program.a                        I                                                Recovering from Errors C-5 