Compaq COBOL for OpenVMS Alpha Systems

Compaq COBOL
for OpenVMS Alpha Systems

Installation Guide

Order Number: AA--PXE7J--TE

October 2000

This guide describes how to install Compaq COBOL (formerly known as DIGITAL COBOL or DEC COBOL) on an Alpha system running the OpenVMS Alpha operating system.

This guide applies to Compaq COBOL Version 2.7 and any maintenance updates for that version.

Revision/Update Information: This manual supersedes the Version 2.6 Compaq COBOL for OpenVMS Alpha Systems Installation Guide.

Operating System & Version: OpenVMS Alpha Version 6.2 or higher. Future releases may require higher versions.

Software Version: Compaq COBOL Version 2.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.

Microsoft, MS-DOS, Win32, Windows, and Windows NT are trademarks of Microsoft Corporation.

Motif, OSF/1, UNIX, and X/Open 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.

ZK6295

Contents

Preface

This guide describes how to install Compaq COBOL on Alpha processors that are running the OpenVMS Alpha operating system.

Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall Compaq COBOL for any other reason.

Associated Documentation

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

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.
$ SET DEFAULT SYS$UPDATE 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 or a pointing device button.
n The minor (point) release of Compaq COBOL in examples is shown by n, as in COBOL02 n. For Version 2.7, you type COBOL027.

References

DIGITAL COBOL has been renamed Compaq COBOL.

In this manual, every use of OpenVMS Alpha and OpenVMS AXP means the OpenVMS Alpha operating system and every use of Tru64 UNIX means the Compaq Tru64 UNIX operating system. Tru64 UNIX was formerly called DIGITAL UNIX or DEC OSF/1.

In this manual, every use of Oracle CDD/Repository means the Oracle CDD/Repository product of Oracle Corporation, every use of Oracle DBMS means the Oracle CODASYL DBMS product of Oracle Corporation, and every use of Oracle Rdb means the Oracle Rdb 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 your comments. If you find errors or want to comment about this manual, please send the manual title, order number, and your comments by one of the following methods:

Field Test Sites

The Compaq COBOL team would like to acknowledge the contributions of our field test sites in improving our products. The people at these sites provided us with invaluable information, which ultimately resulted in a higher quality, more useful COBOL product.

Chapter 1
Preparing for Compaq COBOL Installation

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

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

1.1 Reading the Online Release Notes

Compaq COBOL provides online Release Notes. Compaq strongly recommends that you read the Release Notes before installing the product. The Release Notes may contain information about changes to the application.

For information about accessing these Release Notes before installing Compaq COBOL, see Section 2.1, step 4.

The installed Release Notes for Compaq COBOL will be in the following file: 


SYS$HELP:COBOL027.RELEASE_NOTES

1.2 Registering Your Software License

Before you install and run Compaq COBOL Version 2.7 on a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order.

If you are installing Compaq COBOL as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements.

If you are installing prerequisite or optional software along with Compaq COBOL, review the PAK status and install the PAKs for any prerequisite or optional software before you install Compaq COBOL.

If you are planning to use the Oracle DBMS programming capability, you must purchase the Compaq COBOL Oracle DBMS programming license option, which includes a license PAK for use of this option. See the Compaq COBOL Software Product Description (SPD) for more information on the Oracle DBMS programming license option.

You must register and load your license for Compaq COBOL before you start the installation in order to run the Installation Verification Procedure (IVP) and to use the software.

To register a license on OpenVMS, first log in to your SYSTEM account. You then have a choice of two ways to perform the registration:

If you plan to use Compaq COBOL on more than one node in a VMScluster, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.3.

For complete information on using LMF, see the OpenVMS License Management Utility Manual.

1.3 Optional Software

You can use the following optional software together with Compaq COBOL:

1.4 Checks and Requirements for Installing Compaq COBOL

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


$ @SYS$STARTUP:CDDSTRTUP.COM

1.5 Installation Procedure Requirements

This section describes the requirements for installing Compaq COBOL, which include process account quotas, system parameters, disk space, and so on.

Standard procedures for checking and setting various parameters are described in Section 1.6.

1.5.1 Privileges

To install Compaq COBOL, you must be logged in to an account that has SETPRV or at least the following privileges:

Privileges required for product use are defined in Section 3.4.

1.5.2 System Parameters

Table 1-1 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings.

Table 1-1 Minimum Required System Parameter Values
System Parameter Minimum Value  
Contiguous free global pagelets 1 7000  
Global sections 1 3  
     

1These values represent the number of free global pagelets and global sections required for the installation, not the total number you need to run your system and other software.

Note
If you do not ensure that your system has the necessary global pagelets and global section SYSGEN parameters for the installation, the DCL tables can become corrupted in some situations.

1.5.3 Disk Space

The Compaq COBOL requirements for free disk storage space are different during installation and after installation. Table 1-2 summarizes the storage requirements.

Table 1-2 Disk Space Requirements
Kit Blocks During Installation Blocks After Installation
Compaq COBOL 26,000 22,000

To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: 


$ SHOW DEVICE SYS$SYSDEVICE

1.5.4 Backing 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.

1.6 Standard System Maintenance Procedures

This section explains how to do various standard procedures:

1.6.1 Calculating the Values for Global Pagelets and Global Sections

You must have an adequate number of free global pagelets and global sections to install and run Compaq COBOL. First, determine how many free global pagelets and sections you have on your system, then use AUTOGEN to increase the global pagelets and global sections system parameters as necessary.

The following DCL command will return a figure that you can use as an approximation of the number of global pagelets needed: 


$ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE

You can use the WRITE command with the F$GETSYI lexical function to find the number of free global pagelets and global sections on your system. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT): 


$ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")
15848
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")
24

Section 1.6.2 describes the procedures for increasing these values using AUTOGEN.

1.6.2 Changing System Parameter Values with AUTOGEN

Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the SYS$SYSTEM:MODPARAMS.DAT file.

To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value.

To add a new parameter, add a line to the file that includes both the name of the parameter and its value. For example: 


WSMAX = 8096

To modify incremental parameters such as free global pagelets and global sections, use ADD_. The following example increases the global page setting by 2000: 


ADD_GBLPAGES = 2000

Note that when you set the page file quota, you do not use a value that exceeds the amount of page file space available on the system.

After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. The following command recalculates your system parameters and reboots the system: 


$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system.

Note
Any users logged on to the system are immediately disconnected during the shutdown.

The automatic reboot puts the new parameter values into effect.

The AUTOGEN utility automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK qualifier on the AUTOGEN command line.

For more information about using AUTOGEN, see the OpenVMS System Manager's Manual.

Next Contents