Compaq COBOL
for OpenVMS Alpha Systems
Installation Guide

Appendix B
Recovering from Errors

This appendix provides information to help you with failures or errors that might occur during product installation or product use.

B.1 Failures During Compaq COBOL and Run-Time Library Installations

If PCSI detects any problems during installation, it notifies you and asks if you want to continue the installation.

The following PCSI messages are issued if the PCSI product kit is not found in the specified directory:

$ product install /source=device:[directory] %PCSIUI-I-NOMATCH, no products found matching: COBOL %PCSIUI-E-NOPROD, no products found on which to perform this operation %PCSIUI-E-ABORT, fatal error encountered - operation terminated

The following PCSI and RMS messages are issued if the PCSI product kit is not found in the specified directory and you have defined the logical name PCSI$SOURCE:

$ product install /source=device:[directory] %PCSI-E-OPENIN, error opening PCSI$SOURCE:[SYSUPD]*-*-*-%%%%%-*-*.PCSI*; as input -RMS-F-DEV, error in device name or inappropriate device type for operation %PCSI-E-S_OPFAIL, operation failed %PCSIUI-E-ABORT, fatal error encountered - operation terminated

The following PCSI messages are issued when the installation and the IVP test procedure execute properly:

$ product install /source=device:[directory] . . . The following product has been installed: DEC AXPVMS COBOL V2.7-1209 . . . %PCSI-I-EXETSTOK, end of test procedure; completed with no errors

The following PCSI messages are issued when the COBOL installation fails only because the IVP test procedure fails.

Note

This failure is in the IVP test procedure. After reporting the failure it asks you if you wish to terminate the installation. If you answer YES at this advanced stage (100%), the installation terminates quietly. The product has been installed on the system.

$ product install /source=device:[directory]

The PRODUCT INSTALL fails, with the following messages:

Portion Done: 10%...30%...40%...70%...80%...90%...100% %PCSI-I-PRCOUTPUT, output from subprocess follows... %LICENSE-F-NOAUTH, DEC COBOL use is not authorized on this node -LICENSE-F-NOLICENSE, no license is active for this software product -LICENSE-I-SYSMGR, please see your system manager %SYSTEM-F-ABORT, abort

The IVP test procedure fails, with the following messages:

%PCSI-E-EXETSTFAIL, end of test procedure; completed with errors; status returned from DCL follows -SYSTEM-F-ABORT, abort %PCSI-E-OPFAILED, operation failed Terminating is strongly recommended. Do you want to terminate? [YES] y

The following PCSI messages are issued when the installation fails and you ask PCSI to force completing the installation. In this case a PCSI "execute" statement failed. It is recommended that you terminate the installation in response to the question "Do you want to terminate?" If this message appears under the current setup, something has gone seriously wrong with the installation. Two possibilities are:

One or more necessary files are missing from the kit.
A delete of modules in the STARLET.OLB library has failed in the COBRTL installation, causing the succeeding PCSI update step to fail.

If you answer YES or take the default on the question, the installation will be backed out if it has gone less than 100%, and you will see the $ system prompt on the screen.

$ product install cobrtl/source=device:[directory] %PCSI-I-PRCOUTPUT, output from subprocess follows... %SYSTEM-F-ABORT, abort Portion Done: 10% %PCSI-E-EXEFAIL, execute statement failed; status returned from DCL follows -SYSTEM-F-ABORT, abort %PCSI-E-OPFAILED, operation failed Terminating is strongly recommended. Do you want to terminate? [YES] n Portion Done: 30%...40%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS COBRTL V2.7-603 The following product has been removed: DEC AXPVMS COBRTL V2.7-603 %PCSIUI-I-COMPWERR, operation completed after explicit continuation from errors

B.2 Problems During Compaq COBOL Use

This section describes problems that might occur when you use Compaq COBOL.

B.2.1 Run-Time Library Mismatch

The system issues a severe error message if there is a mismatch in RTL versions between the compiled program and the RTL installed on the system where the program is run. In this situation, the program exits after the message is issued.

B.2.2 Other Problems

If you encounter a problem while using Compaq COBOL, see the section on Troubleshooting Tips in the Release Notes. If the problem is unresolved, report it to Compaq. If you have a Software Product Services Support Agreement, contact your Compaq Customer Support Center (CSC), either by telephone or using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, please indicate the following:

The name (OpenVMS Alpha) and the version number of the operating system you are using
The product name (Compaq COBOL) and the version number of Compaq COBOL you are using
The hardware system you are using, such as a model number
A very brief description of the problem (one sentence if possible)
How critical the problem is

When you submit information electronically or are speaking on the phone to the appropriate Compaq COBOL support specialist, you can provide more detailed information. The information should include the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please attempt to narrow the cause of the problem to a specific module or lines of code.

CSC personnel may ask for additional information, such as listings of any command files, INCLUDE and COPY files, relevant data files, and so forth. If the program is longer than 50 lines, submit a copy of it electronically or provide machine-readable media (diskette or magnetic tape).

Previous Contents Contents