| Previous | Contents |
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.
2.1 Installation Procedure
As of Version 2.7, Compaq COBOL for OpenVMS Alpha is installed with the POLYCENTER Software Installation utility (PCSI) instead of VMSINSTAL so that its components will be registered in the PCSI Registry on your system. When the PCSI PRODUCT command is used for later installations of kits, such as for OpenVMS Alpha, which contain components of the Compaq COBOL product (for example, the COBRTL), the PRODUCT command will check in the PCSI Registry to see whether the registered version has a higher version number than the one about to be installed. If so, the PRODUCT command will bypass the installation of that component.
Compaq COBOL for OpenVMS Alpha is packaged in three PCSI kits:
Thus, you will install two kits: the appropriate RTL kit for your operating system, and then the compiler kit. The RTL kit should be installed first. (Users who install only the RTL will need to install only the RTL kit specified for their operating system.)
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 Compaq COBOL, perform the following steps:
Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE |
$ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK,SYSPRV) |
$ SHOW PROCESS/PRIVILEGES |
$ SHOW DEVICE DKA400 |
$ MOUNT DKA400 label |
$ DIRECTORY DKA400:[directory]*.PCSI |
$ PRODUCT EXTRACT RELEASE_NOTES COBOL - $_/SOURCE=SYS$HELP:COBOL027.RELEASE_NOTES |
$ PRODUCT INSTALL COBRTL/VERSION=2.7-603A - $_/SOURCE=DEVICE:[DIRECTORY] |
%PCSI-E-FAILCONF, failed to resolve conflicting requirements Terminating is strongly recommended. Do you want to terminate? [YES] |
$ PRODUCT INSTALL COBRTL/VERSION=2.7-603B - $_/SOURCE=DEVICE:[DIRECTORY] |
$ INSTALL REPLACE SYS$LIBRARY:DEC$COBRTL.EXE $ INSTALL REPLACE SYS$LIBRARY:LIBOTS2.EXE |
$ PRODUCT INSTALL COBOL/VERSION=2.7-1209 - ) $_/SOURCE=DEVICE:[DIRECTORY] |
$ INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE |
After Compaq COBOL is installed, it can be invoked by all users with the COBOL command.
The installation procedure modifies the DCL command table so that the COBOL command is recognized and processed. However, the previous command table is still in effect for those users who are currently logged in. All logged-in users who want to use the COBOL command or the newly updated version of the COBOL command must log out and log in again, or use the following DCL command:
$ SET COMMAND /TABLE=SYS$LIBRARY:DCLTABLES |
The following tasks can be performed after Compaq COBOL is installed:
The Installation Verification Procedure (IVP) runs automatically during installation of the COBOL compiler. It requires the installation of the COBOL compiler on your system. If you want to run the IVP separately to ensure the integrity of installed files should system problems occur, in a privileged account use the following command procedure:
$ @SYS$COMMON:[SYSTEST]COBOL$IVP.COM |
The PCSI installation automatically copies the Compaq COBOL message file, COBOL$MSG.MSG, into the system directory [SYSUPD]. You can edit COBOL$MSG.MSG to customize the error messages that users receive when using Compaq COBOL. Customized messages are often desirable for international users.
You must install Compaq COBOL before editing the message file. If you install Compaq COBOL after editing COBOL$MSG.MSG, the software installation will supersede the revised message file in the [SYSMSG] directory. Also, you must have the OpenVMS Message utility installed on your system before editing COBOL$MSG.MSG. The edited version of COBOL$MSG.MSG must be processed through the Message utility before the file can be accessed by Compaq COBOL.
The following steps explain how to edit the Compaq COBOL messages and install the customized message file on your system:
$ MESSAGE COBOL$MSG |
$ LINK/SHARE COBOL$MSG |
$ COPY COBOL$MSG.EXE SYS$COMMON:[SYSMSG]/PROT=W:RE |
$ INSTALL REPLACE SYS$MESSAGE:COBOL$MSG |
Compaq COBOL will now generate your customized error messages.
3.3 Making Compaq COBOL Usable on a VMScluster
If you want to run Compaq COBOL on multiple nodes of a VMScluster, first check to see that you have the appropriate software license (see Section 1.2). Then, perform the following steps after you install Compaq COBOL:
If you are using a mixed-architecture (VAX and Alpha) heterogeneous cluster, before executing these commands, make sure the appropriate logical names have been set to define the scope of the SYSMAN DO commands. For more information, see the OpenVMS system management documentation. |
While logged in as SYSTEM, or as another user name that has the
SETPRV privilege or the CMKRNL and SYSPRV privileges, use the SYSMAN
utility to update the version of DCLTABLES.EXE available, as follows:
$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> SET ENVIRONMENT/CLUSTER
%SYSMAN-I-ENV, current command environment:
Clusterwide on local cluster
Username SYSTEM will be used on nonlocal nodes
SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE
%SYSMAN-I-OUTPUT, command execution on node NODE1
%SYSMAN-I-OUTPUT, command execution on node NODE2
|
SYSMAN> DO INSTALL REPLACE SYS$SYSTEM:COBOL.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 |
SYSMAN> DO INSTALL REPLACE SYS$MESSAGE:COBOL$MSG.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 |
SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DEC$COBRTL.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:LIBOTS2.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 |
SYSMAN> EXIT $ |
To use Compaq COBOL, each user account must have at least TMPMBX and
NETMBX privileges. Use the OpenVMS Authorize utility to determine
whether users have the privileges they require.
3.5 Installing Compaq COBOL as a Shared Image
If you expect Compaq COBOL to be used extensively on your system, you can reduce the system overhead and memory requirements by installing it as a shared image. To install Compaq COBOL as a shared image on a system that is currently running, use the OpenVMS Install utility (INSTALL). It is recommended that you install Compaq COBOL as shared on a system that has been rebooted recently, because the available space in the global page table is less likely to be fragmented. Invoke the OpenVMS Install utility from a privileged account and install Compaq COBOL as a shared image:
$ INSTALL ADD SYS$SYSTEM:COBOL.EXE /OPEN/SHARED/HEADER_RESIDENT |
Add the following line to the appropriate system startup command file so that Compaq COBOL is available as a shared image each time the system is started:
$ INSTALL ADD SYS$SYSTEM:COBOL.EXE/OPEN/SHARED/HEADER_RESIDENT |
The default operating system startup command file, for example, is SYS$MANAGER:SYSTARTUP_VMS.COM (previously named SYSTARTUP_V5.COM). If your site has modularized the system startup procedure using multiple command files, add the lines to the correct file.
To install the message file, use the following commands:
$ INSTALL ADD SYS$MESSAGE:COBOL$MSG.EXE |
The PCSI installation automatically includes installation of REFORMAT.EXE, the REFORMAT utility. It is ready to run.
This appendix contains sample logs of installations on different versions of the OpenVMS Alpha operating system, a sample log of an installation verification (IVP), and a sample log of a deinstallation of the RTL and the compiler.
The lines regarding products removed reflect the fact that the actual installation replaced field test software.
Installation of the Run-Time Library and the Compiler on OpenVMS Alpha Version 7.1-2 and Higher
$ PRODUCT INSTALL COBRTL/VERSION=2.7-603B/SOURCE=SYS$UPDATE:
The following product has been selected:
DEC AXPVMS COBRTL V2.7-603B Layered Product
Do you want to continue? [YES]
Configuration phase starting ...
You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.
DEC AXPVMS COBRTL V2.7-603B: COBRTL for Compaq COBOL for OpenVMS Alpha Systems
Copyright 2000 by Compaq Computer Corporation.
This software is the product of Compaq Computer Corporation.
No PAKs are used by this COBRTL product.
Do you want the defaults for all options? [YES]
Do you want to review the options? [NO]
Execution phase starting ...
The following product will be installed to destination:
DEC AXPVMS COBRTL V2.7-603B DISK$YYYYYYSYSDSK:[VMS$COMMON.]
The following product will be removed from destination:
DEC AXPVMS COBRTL V2.7-588B DISK$YYYYYYSYSDSK:[VMS$COMMON.]
Portion done: 0%
...30%
...50%
...70%
...90%
...100%
The following product has been installed:
DEC AXPVMS COBRTL V2.7-603B Layered Product
The following product has been removed:
DEC AXPVMS COBRTL V2.7-588B Layered Product
$ PRODUCT INSTALL COBOL /VERSION=2.7-1209/SOURCE=SYS$UPDATE:
The following product has been selected:
DEC AXPVMS COBOL V2.7-1209 Layered Product
Do you want to continue? [YES]
Configuration phase starting ...
You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.
DEC AXPVMS COBOL V2.7-1209: Compaq COBOL for OpenVMS Alpha Systems
Copyright 2000 by Compaq Computer Corporation.
This software is the product of Compaq Computer Corporation.
A valid Product Authorization Key (PAK) is required to be
Do you want the defaults for all options? [YES]
Do you want to review the options? [NO]
Execution phase starting ...
The following product will be installed to destination:
DEC AXPVMS COBOL V2.7-1209 DISK$YYYYYYSYSDSK:[VMS$COMMON.]
The following product will be removed from destination:
DEC AXPVMS COBOL V2.7-1202 DISK$YYYYYYSYSDSK:[VMS$COMMON.]
Portion done: 0%
...70%
...80%
...90%
...100%
The following product has been installed:
DEC AXPVMS COBOL V2.7-1209 Layered Product
The following product has been removed:
DEC AXPVMS COBOL V2.7-1202 Layered Product
%PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS COBOL V2.7-1209 ...
%PCSI-I-IVPSUCCESS, test procedure completed successfully
|
Installation of the Run-Time Library and the Compiler on OpenVMS Alpha Version 6.2 Through 7.1-1
$ product install cobrtl/version=v2.7-603a/source=device:[directory]
The following product has been selected:
DEC AXPVMS COBRTL V2.7-603A [Available]
Do you want to continue? [YES]
*** DEC AXPVMS COBRTL V2.7-603A: COBRTL for Compaq COBOL for OpenVMS Alpha Systems
Copyright 2000 by Compaq Computer Corporation.
This software is the product of Compaq Computer Corporation.
No PAKs are used by this COBRTL product.
Do you want all the default values for this product? [YES]
Do you want to view the values? [NO]
%PCSIUI-I-DONEASK, execution phase starting
The following product will be installed:
DEC AXPVMS COBRTL V2.7-603A
%PCSI-I-VOLINFO, estimated space information for volume DISK$XXXXXX_SYS
-PCSI-I-VOLSPC, 0 required; 404637 available; 404637 net
Portion Done: 0%
...10%
...20%
...70%
...90%
...100%
The following product has been installed:
DEC AXPVMS COBRTL V2.7-603A
$ product install cobol/ver=2.7-1209/source=device:[directory]
The following product has been selected:
DEC AXPVMS COBOL V2.7-1209 Layered Product
Do you want to continue? [YES]
Configuration phase starting ...
You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.
DEC AXPVMS COBOL V2.7-1209: Compaq COBOL for OpenVMS Alpha Systems
Copyright 2000 by Compaq Computer Corporation.
This software is the product of Compaq Computer Corporation.
A valid Product Authorization Key (PAK) is required to be
Do you want the defaults for all options? [YES]
Do you want to review the options? [NO] y
DEC AXPVMS COBOL V2.7-1209: Compaq COBOL for OpenVMS Alpha Systems
DEC AXPVMS VMS V7.2 [Installed]
Are you satisfied with these options? [YES]
Execution phase starting ...
The following product will be installed to destination:
DEC AXPVMS COBOL V2.7-1209 DISK$YYYYYY_SYS:[VMS$COMMON.]
Portion done: 0%
...70%
...80%
...90%
...100%
The following product has been installed:
DEC AXPVMS COBOL V2.7-1209 Layered Product
%PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS COBOL V2.7-1209 ...
%PCSI-I-IVPSUCCESS, test procedure completed successfully
%PCSIUI-I-SUCINSTALL, INSTALL operation completed successfully
|
Installation Verification (IVP) Run Separately
$ @sys$test:cobol$ivp.com
Copyright 2000 Compaq Computer Corporation
COMPAQ Registered in U.S. Patent and Trademark Office.
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.
Successful test of Compaq COBOL V2.7-1209
$
|
Removal (Deinstallation) of the Run-Time Library and the COBOL Compiler
$ product remove cobrtl
The following product has been selected:
DEC AXPVMS COBRTL V2.7-603 Layered Product
Do you want to continue? [YES]
The following product will be removed from destination:
DEC AXPVMS COBRTL V2.7-603 DISK$AFSCOBSYSDSK:[VMS$COMMON.]
Portion done: 0%...10%...100%
The following product has been removed:
DEC AXPVMS COBRTL V2.7-603 Layered Product
|
$ product remove cobol
The following product has been selected:
DEC AXPVMS COBOL V2.7-1209 Layered Product
Do you want to continue? [YES]
The following product will be removed from destination:
DEC AXPVMS COBOL V2.7-1209 DISK$AFSCOBSYSDSK:[VMS$COMMON.]
Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...100%
The following product has been removed:
DEC AXPVMS COBOL V2.7-1209 Layered Product
|
| Previous | Next | Contents |