Compaq COBOL for OpenVMS VAX

Compaq COBOL for OpenVMS VAX

Installation Guide

Order Number: AA--K026S--TE

November 2000

This document contains instructions for installing Compaq COBOL for OpenVMS VAX (formerly known as DIGITAL VAX COBOL, or as VAX COBOL) on the OpenVMS VAX operating system. It also explains how to read the online release notes before or after installing the product. This document applies to Compaq COBOL Version 5.7 for OpenVMS VAX and any maintenance updates for that version.

Compaq's COBOL compilers are also available on other platforms, including OpenVMS Alpha, Compaq Tru64 UNIX, and Windows NT Alpha.

In this document, references to the name Compaq COBOL mean Compaq COBOL for OpenVMS VAX.

Revision/Update Information: This revised manual supersedes the Compaq COBOL for OpenVMS VAX Systems Installation Guide (Order Number AA--K026R--TE).

Operating System and Version: VAX/VMS Version 5.5-2, or OpenVMS VAX Version 6.1, or higher.
Future releases may require
higher versions.

Software Version: Compaq COBOL Version 5.7




Compaq Computer Corporation Houston, Texas

© 2000 Compaq Computer Corporation

COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo Registered in U.S. Patent and Trademark Office.

OpenVMS and Tru64 are trademarks of Compaq Information Technologies Group, L.P. in the United States and other countries.

Windows NT is a trademark of Microsoft Corporation.

OSF/1 and UNIX are trademarks of The Open Group.

All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS" 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 OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND WHETHER IN AN ACTION OF CONTRACT OR TORT, INCLUDING NEGLIGENCE.

The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty.

ZK5514

Contents

Preface

This guide describes how to install Compaq COBOL on the OpenVMS VAX operating system, or VAX/VMS, in the case of Version 5.5-2. It is intended for system managers. This document applies to Compaq COBOL Version 5.7 and any maintenance updates for that version.

For more information about installing Compaq COBOL on OpenVMS VAX or VAX/VMS systems, refer to your processor-specific installation or operations guide.

The installation procedure is described step-by-step and is, for the most part, self-explanatory. The system prompts you to answer questions and to change volumes, and waits for you to tell it to continue.

Associated Documentation

In addition to this guide, the Compaq COBOL documentation set includes:

You may also find the following documentation useful:

Conventions

The following conventions are used in this guide:
Convention Meaning
[YES]
[NO] 		Default answers to system questions are framed in square brackets. Simply press [Return] to accept the default response.
UPPERCASE In text, uppercase letters indicate the name of a command, a file, a parameter, a procedure, or a Compaq COBOL utility.
$ @SYS$UPDATE:VMSINSTAL saveset-name In interactive examples, prompts or displayed text appear in a monospace font. User input appears in bold monospace. Lowercase indicates a name that you supply. Uppercase is to be typed as shown.
$ The dollar sign is used to indicate the DCL prompt. This prompt may be different on your system.
[Ctrl/x] In procedures, a sequence such as [Ctrl/x] indicates that you must hold down the key labeled Ctrl while you press another key.
n The minor (point) release of Compaq COBOL for OpenVMS VAX in examples is shown by n, as in COBOL05 n. For Version 5.7, you type COBOL057.

References

The following table shows certain references and their respective meanings in this manual:

Reference Meaning
OpenVMS OpenVMS VAX or VAX/VMS operating system
Tru64 UNIX Compaq Tru64 UNIX operating system 1
CDD/Plus Oracle CDD/Repository 2
   

1Compaq Tru64 UNIX was formerly known as DIGITAL UNIX or DEC OSF/1. As of Version 4.0F, the name DIGITAL UNIX is changed to Compaq Tru64 UNIX.
2Oracle CDD/Repository is a product of Oracle Corporation.

How to Order Additional Documentation

For information on pricing and where to buy documentation 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 to comment about this manual or if you should find errors in it, please send the manual title, order number, and your comments by one of the following methods:

Chapter 1
Preparing to Install Compaq COBOL

Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to check the contents of your kit against this information. If your kit is damaged or if you find that parts of it are missing, call your Compaq representative.

Your distribution kit includes a letter titled Read Before Installing or Using Compaq COBOL Version 5.7 for OpenVMS VAX Systems. The letter discusses important information that might not be included in this guide. You should read this letter before beginning the installation.

Distribution media must be mounted in numerical order. The installation procedure prompts you to mount the volumes. For more information on how to mount distribution media, refer to your processor-specific installation or operations guide.

This guide also details several options to the installation procedure.

1.1 Accessing the Online Release Notes

Compaq COBOL provides online release notes. The prompt to display or print the release notes before installation appears in Step 4 of the installation procedure when you invoke VMSINSTAL with the OPTIONS N parameter. Please read the release notes before you install COBOL, as they may contain important information about changes.

After the installation, the release notes are available in text format and PostScript format in the following files:

SYS$HELP:COBOL05n.RELEASE_NOTES (text file)
SYS$HELP:COBOL05n_RELEASE_NOTES.PS

Where n represents version point release number.

Online help also directs you to the release notes file. After the installation, type the following: 


$ HELP COBOL RELEASE_NOTES   [Return]

1.2 System Prerequisites

This is a complete kit for Compaq COBOL. You do not need to have installed any earlier versions of Compaq COBOL before installing Version 5.n. (Note that for n you should use the actual maintenance-update number after the decimal point, for example, 7 in Version 5.7, which appears on the title page as the Software Version.)

Compaq COBOL for OpenVMS VAX Version 5.7 requires VAX/VMS Version 5.5-2 or OpenVMS VAX Version 6.1 or higher. Certain Compaq COBOL features may require higher versions of OpenVMS VAX. See the SPD for information about specific system dependencies.

If you are installing Oracle Rdb or Oracle CDD/Repository, you should make certain that they have been successfully installed before you attempt to install Compaq COBOL. To eliminate possible installation errors, execute the following command procedure to start up Oracle CDD/Repository: 


$ @SYS$STARTUP:CDDSTRTUP.COM   [Return]

1.3 Installation Procedure Requirements

The installation should take approximately 5 to 10 minutes, depending on the type of media and your system configuration. Before installing Compaq COBOL, you must have the following privileges and resources:

Note
You must ensure that your system has the necessary global page and global section SYSGEN quotas for the installation. Failure to do so could cause the DCL tables to be corrupted in some situations.

To determine the number of available global pages on your system, invoke the OpenVMS Install utility (INSTALL) by typing the following command: 


$ INSTALL   [Return]

Then type the following command: 


INSTALL> LIST/GLOBAL/SUMMARY   [Return]
        Summary of Local Memory Global Sections
     nn Global Sections Used,  nnn/nnnn Global Pages Used/Unused
INSTALL> EXIT   [Return]

When you issue these commands, the system displays a summary of the number of global sections used, the number of global pages used, and the number of global pages unused. To exit from the OpenVMS Install utility, type the EXIT command.

Compaq COBOL requires approximately 950 free global pages. If fewer than 950 pages are available, you can delete an existing known image using the OpenVMS Install utility, or you can increase the GBLPAGES system parameter with the OpenVMS System Generation utility (SYSGEN), as described below..

You can determine the number of available global sections by invoking SYSGEN as follows: 


$ RUN SYS$SYSTEM:SYSGEN   [Return]
SYSGEN>USE CURRENT   [Return]
SYSGEN>SHOW GBLSECTIONS   [Return]
SYSGEN>EXIT   [Return]

The last number displayed is the maximum number of global sections. Compare this to the number of global sections in use displayed by the OpenVMS Install utility. Compaq COBOL requires 3 global sections. Therefore, if the number of global sections used plus 3 exceeds the current number of global sections, you must increase the number of available global sections before you can install Compaq COBOL.

To increase the number, you must increase the GBLSECTIONS system parameter with SYSGEN by editing the file SYS$SYSTEM:MODPARAMS.DAT and then invoking the SYS$UPDATE:AUTOGEN.COM procedure. For more information on the AUTOGEN.COM procedure, refer to your processor-specific installation or operations guide.

If the number of global sections used plus 3 is less than the maximum number of global sections, you can exit from SYSGEN and continue.

1.4 Special Requirements

A license Product Authorization Key (PAK) must be registered with the License Management Facility in order to use Compaq COBOL:

You can register the information contained in the PAK that is shipped to new customers with Compaq COBOL by using either the OpenVMS License command procedure (VMSLICENSE) or the LICENSE REGISTER command, as described in the OpenVMS License Management Utility Manual.

Note
If you are missing your PAK and you have purchased a software support contract, you can obtain a Temporary Service PAK. For more information, call your Customer Support Center.

Hardware Requirements

Object modules produced by the Compaq COBOL compiler can be executed incorrectly if your OpenVMS VAX operating system does not meet the following requirements when you install the compiler:

The Compaq COBOL Installation Verification Procedure (IVP) checks for the presence or absence of these two ECO and WCS status requirements.

If you plan to use the Oracle Database Management System (Oracle DBMS), Oracle CDD/Repository, or both, refer to the installation guides for these products for information on their ECO requirements.

1.5 Backing Up Your System Disk

At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Compaq recommends that you do a system disk backup before installing any software.

Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on backing up the system disk in the OpenVMS System Manager's Manual.

Chapter 2
Installing Compaq COBOL

This chapter describes:

2.1 Using VMSINSTAL

After you log in to a privileged account to install Compaq COBOL, set the default to SYS$UPDATE: and then invoke VMSINSTAL, the command procedure that installs this product, as follows: 


$ SET DEFAULT SYS$UPDATE   [Return]
$ @VMSINSTAL COBOLver ddn: option-list   [Return]

The following paragraphs describe the command parameters.

ver

Represents the version and maintenance update number of Compaq COBOL (for example, 057). Refer to the label on the Compaq COBOL distribution kit or the Compaq COBOL BOM or BIL for the number.

ddn:

Represents a device name where the distribution volumes will be mounted for the Compaq COBOL installation media; dd is the device code and n is the unit number. It is not necessary to use the console drive to install Compaq COBOL. If you do use the console drive, you should replace any media you removed from the drive. MYCPU$MUA100: is the device name used in examples in this document.

option-list

The word OPTIONS followed by one or more of the option designators A, G, L, N, R, as shown in Table 2-1.

Table 2-1 Installation Option Designators
Option Name Description
A Auto_answer Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system).
G Get saveset
G device:[directory] 		Copies kit save set(s) to device:[directory]. Specifying a fast system storage device could speed up installations, if you install from there. Or this could be a group distribution resource.
L File Log Logs all activity to the terminal during installation.
N Display or Print the Release Notes Indicates that you want to see the installation question on release notes. If you do not include the N option, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in case they contain additional information about the installation.
    If you are restarting the installation and have already reviewed the release notes, you may omit the N option. (The Compaq COBOL Release Notes will be available regardless because VMSINSTAL copies them to the SYS$HELP directory.)
R Alternate Root Lets you install Compaq COBOL to a system root other than that of the running system.

You can also type an asterisk (*) in place of COBOL and its version number if you are installing from magnetic tape to save installation time. The asterisk causes Compaq COBOL to be installed with a minimum of tape passes.

For example, the first parameter to VMSINSTAL for Compaq COBOL Version 5.7 could be either COBOL057 or *.

When you invoke VMSINSTAL, it checks the following:

VMSINSTAL then checks whether or not the following conditions exist:

If VMSINSTAL detects either of these conditions, you will be asked whether or not you want to continue the installation. If you want to continue, type YES. If you want to stop the installation, press Return.

Note that if another user accesses the Help file during your installation, it will be locked and cannot be updated. In this case you will have to update Help manually after the installation. Informational messages will be displayed (see Step 9).

2.2 Step-by-Step Installation

This section contains excerpts from the installation procedure and explains each step.

Defaults appear in brackets throughout the installation procedure. To take a default, you can simply press Return. You can type Y or N for YES or NO.

To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and then returns you to DCL level. If you want to retry the installation procedure after pressing Ctrl/Y, you must proceed from Step 2.

Step 1: Log in to a privileged account and set your default device and directory to SYS$UPDATE. 


                  [Return]
Username: SYSTEM    [Return]
Password:         [Return]
$ SET DEFAULT SYS$UPDATE   [Return]

Step 2: Invoke VMSINSTAL. 


$ @VMSINSTAL COBOLver MYCPU$MUA100: OPTIONS N   [Return]
      OpenVMS VAX Software Product Installation Procedure Vn.n
 
 
It is dd-mmm-yyyy at hh:mm.
Enter a question mark (?) at any time for help.
                              
* Are you satisfied with the backup of your
   system disk [YES]? [Return]

If you are satisfied with the backup of your system disk, press Return. Otherwise, type NO and press Return to discontinue the installation.

Step 3: Insert the first installation kit volume.

Depending on your media, you may get the following prompts: 


Please mount the first volume of the set on MYCPU$MUA100:.
* Are you ready? YES   [Return]

To indicate that you want to continue the installation:

  1. Mount the installation volume.
  2. Type YES.
  3. Press Return. 


The following products will be processed:
 
  COBOL V5.n
 
    Beginning installation of COBOL V5.n at hh:mm
 
%VMSINSTAL-I-RESTORE, Restoring product save set A...
 
    Release notes included with this kit are always copied to
    SYS$HELP.

Step 4: Select a release notes option.

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]

If you select option 1, VMSINSTAL displays the release notes on line immediately. They are lengthy. You can terminate the display at any time by pressing Ctrl/C.

If you select option 2, VMSINSTAL prompts you for a queue name. Either type a queue name or press Return to send the file to the default output print device. 


* Queue name [SYS$PRINT]:   [Return]

If you select option 3, VMSINSTAL displays the release notes on line immediately and then prompts you for a queue name.

Note
This version of the release notes file installed by VMSINSTAL is labeled with the current product name and version number. Take care not to delete release notes for previous versions. They still may contain information that is useful to you.

Next, VMSINSTAL displays the following prompt: 


* Do you want to continue the installation [NO]? Y   [Return]
%VMSINSTAL-I-RELMOVED, The product's release notes have been
 moved to SYS$HELP.

If you want to continue the installation, type YES and press Return. Otherwise, VMSINSTAL discontinues the installation. In either case, VMSINSTAL moves the release notes to SYS$HELP.

Step 5: Install the COBOL Run-Time Library image separately (if applicable).

Compaq COBOL allows you to install the COBOL Run-Time Library (COBRTL) image (COBRTL.EXE) separately from the full product installation. This option can be useful if your COBRTL has been overwritten or lost, or if you need to run a COBOL application compiled with Compaq COBOL V5.n on a system that does not have Compaq COBOL V5.n installed.

Type NO or press Return at the prompt to continue with the full installation of Compaq COBOL.

If you want to install the COBRTL image only, type YES and press Return in response to the prompt, as follows: 


* Do you want to install only the COBRTL [NO]? Y   [Return]

Next Contents