HP OpenVMS Systems Documentation
This guide describes how to install HP COBOL on an OpenVMS Alpha or OpenVMS I64 system.
Revision/Update Information: This manual supersedes the Version 2.8 HP COBOL Installation Guide.
Operating System & Version: OpenVMS Alpha Version 7.3-2 or higher OpenVMS I64 Version 8.2-1 or higher
HP COBOL for OpenVMS Alpha
© Copyright 2007 Hewlett-Packard Development Company, L.P.
Confidential computer software. Valid license from HP 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.
The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
Printed in the US
The HP OpenVMS documentation set is available on CD-ROM.
This guide describes how to install HP COBOL on Alpha and I64 processors that are running the OpenVMS operating system.
Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall HP COBOL for any other reason.
In addition to this guide, the HP COBOL documentation set includes the following:
You may also find the following documentation useful:
For additional information about HP OpenVMS products and services, visit the following World Wide Web address:
How to Order Additional Documentation
For information about how to order additional documentation, visit the following World Wide Web address:
HP welcomes your comments on this manual. Please send comments to either of the following addresses:
The following product names may appear in this manual:
All three names---the longer form and the two abbreviated forms---refer to the version of the OpenVMS operating system that runs on the Intel® Itanium® architecture.
The following typographic conventions may be used in this manual:
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.
Field Test Sites
The HP 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.
Before you install and run HP COBOL Version 2.9 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 HP 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 HP COBOL, review the PAK status and install the PAKs for any prerequisite or optional software before you install HP COBOL.
If you are planning to use the Oracle DBMS programming capability on OpenVMS Alpha, you must purchase the HP COBOL Oracle DBMS programming license option, which includes a license PAK for use of this option. See the HP COBOL Software Product Description (SPD) for more information on the Oracle DBMS programming license option.
You must register and load your license for HP 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 HP 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 HP OpenVMS License Management Utility Manual.
1.3 Optional Software
You can use the following optional software together with HP 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 HP COBOL. To eliminate possible installation errors, execute the following command procedure to start up Oracle CDD/Repository on OpenVMS Alpha:
Consult the Oracle CDD/Repository documentation on how to start up
Oracle CDD/Repository on OpenVMS I64.
1.5 Installation Procedure Requirements
This section describes the requirements for installing HP COBOL, which include process account quotas, system parameters, disk space, and so on.
To install HP COBOL, you must be logged in to an account that has SETPRV or at least the following privileges:
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.
|System Parameter||Minimum Value|
|Contiguous free global pagelets 1||7000|
|Global sections 1||3|
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.
The HP COBOL requirements for free disk storage space are different during installation and after installation. Table 1-2 summarizes the storage requirements.
|Kit||Blocks During Installation||Blocks After Installation|
|HP COBOL (Alpha)||26,000||22,000|
|HP COBOL (I64)||48,000||44,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
Hewlett-Packard 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 HP OpenVMS System Manager's Manual.
1.6 Standard System Maintenance Procedures
This section explains how to do various standard procedures:
You must have an adequate number of free global pagelets and global sections to install and run HP 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
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.
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 HP OpenVMS System Manager's Manual.
After you register and load the license PAK (including the COBOL DBMS PAK, if you have it), the installation will take approximately 5 to 10 minutes, depending on your system configuration.
If you encounter any failures during installation, see Appendix B.
HP COBOL for OpenVMS Alpha is packaged as one PCSI kit:
HP COBOL for OpenVMS I64 is packaged as one PCSI kit:
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 exits to DCL level. To retry the installation procedure after pressing Ctrl/Y, proceed from Step 5.
When the system prompts you with a question during the installation procedure, the default answer is listed in brackets ().
To install HP COBOL, perform the following steps:
Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE
$ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK,SYSPRV)
$ SHOW PROCESS/PRIVILEGES
$ PRODUCT EXTRACT RELEASE_NOTES COBOL/FILE=SYS$HELP:COBOL029.RELEASE_NOTES - $_/SOURCE=device:[directory]
If you extract the Release Notes using CDMENU instead of PCSI, the Release Notes will be named COBOL.PCSI$RELEASE_NOTES instead of COBOL029.RELEASE_NOTES.
$ PRODUCT INSTALL COBOL/VERSION=2.9 $_/SOURCE=device:[directory]
$ INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE