HP C
Installation Guide for
OpenVMS Alpha Systems

Contents

A.3 Installation with Alternate Compiler

This sample was run on a system that had a previous version of HP C installed. In this sample, the new version of the compiler is installed, but a previous version of the compiler is kept as an alternate compiler. The installation procedure prompts you to designate one of the compiler versions as the system default compiler. See Section 1.6 for more information on installing and using multiple compiler versions.

Note that in this example, OPTIONS N is specified on the vmsinstal command to print the release notes.

$ @sys$update:vmsinstal CC071 DKA400:[CC071.KIT] options n OpenVMS Alpha Software Product Installation Procedure X5F7-SSB It is 12-June-2005 at 14:07. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. * Do you want to continue anyway [NO]? yes * Are you satisfied with the backup of your system disk [YES]? [Return] The following products will be processed: CC V7.1 Beginning installation of CC V7.1 at 14:07 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Release notes included with this kit are always copied to SYS$HELP. 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]: 2 * Queue name [SYS$PRINT]: * Do you want to continue the installation [NO]? yes [Return] %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. HP C Version 7.1 for OpenVMS Alpha Systems Copyright 2005 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. A C V6.0-001 compiler was found on your system. Type YES to keep this compiler on your system either as the default system compiler or as an alternate compiler. Type NO to supersede C V6.0-001. * Should the existing V6.0-001 system compiler be preserved [NO]: yes [Return] Type NO to have the compiler on this kit become the default system compiler and to have the currently installed compiler saved as an alternate compiler. Type YES to keep the current system compiler as the default compiler and to have the compiler on this kit available as an alternate compiler. Alternate compilers can be invoked with the cc command after invoking sys$system:decc$set_version.com passing a version_number. * Should this V6.0-001 system compiler remain the default when cc is typed [NO]: yes [Return] Product: C Producer: DEC Version: 7.1 Release Date: dd-mmm-2005 * Does this product have an authorization key registered and loaded? yes [Return] This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of HP C. The IVP will be left in: SYS$COMMON:[SYSTEST]DECC$IVP.COM After the installation is complete, you can invoke the command file at any time to verify that HP C is installed and working correctly. * Do you want to run the IVP after the installation [YES]? [Return] HTML, postscript and text versions of the HP C Users Guide, Language Reference Manual and RTL Reference Manual may be optionally installed into SYS$COMMON:[SYSHLP.CC$ALPHA_HELP_071]. These documents consume approximately 60000 blocks. * Should these manuals be provided? [NO]? yes [Return] %VMSINSTAL-I-RESTORE, Restoring product saveset B... This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of HP C. This file is named CC.RELEASE_NOTES and has been placed in SYS$HELP:. This file contains information valuable to HP C programmers. Please inform your user community of this file's existence. * Do you want to purge files replaced by this installation [YES]? [Return] You have answered all of the questions for this installation. The installation will now execute in 5 to 15 minutes without further intervention, depending on your configuration, installation media, and so forth. The C Runtime Library headers and Starlet headers are installed as a Text Library (.TLB). The traditional text form of the headers (.H files) are also provided for reference purposes only) in the directories: SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C]. Please note that the compiler does not search the reference areas SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C] during compilation. Instead headers are taken from the text library. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DECC]. Your OpenVMS system will now be modified to include the following new and modified files: [SYSEXE]DECC$COMPILER_V06_00-001.EXE [renamed] [SYSMSG]DECC$COMPILER_MSG_V06_01-001.EXE [renamed] [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$COMPILER_MSG.EXE [new] [SYSHLP]HELPLIB.HLB [modified] [SYSHLP]CC$HELP*.HTML [new] [SYSHLP.CC$ALPHA_HELP_071] [new] [SYSHLP]CC.RELEASE_NOTES [new] [SYSHLP]CC_RELEASE_NOTES.PS [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$COMPILED_PRINTF.OLB [new] [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSTEST]DECC$IVP.COM [new] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new] [SYSTEST.DECC]DECC$IVP*.* [new] The file SYS$STARTUP:DECC$STARTUP.COM contains commands to be executed at system startup to allow for the best compilation performance. You may want to invoke this command file from your system's site-specific startup file. This command file does not have to be invoked for correct operation of HP C. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright 2005 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. Beginning HP C V7.1 Installation Verification Procedure Image Check Complete License Check Complete Version Check Complete Help Check Complete Message Check Complete Header Check Complete Run Time Library Check Complete HP C V7.1 Installation Verification Procedure Successful Installation of CC V7.1 completed at 14:15 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CC071.VMI_DATA VMSINSTAL procedure done at 14:16

Appendix B
Files Installed

The HP C installation procedure installs and modifies a number of files on your system, as follows:

[SYSEXE]DECC$COMPILER_V06_00-001.EXE [renamed] [SYSMSG]DECC$COMPILER_MSG_V06_01-001.EXE [renamed] [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$COMPILER_MSG.EXE [new] [SYSHLP]HELPLIB.HLB [modified] [SYSHLP]CC$HELP*.HTML [new] [SYSHLP.CC$ALPHA_HELP_071] [new] [SYSHLP]CC.RELEASE_NOTES [new] [SYSHLP]CC_RELEASE_NOTES.PS [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$COMPILED_PRINTF.OLB [new] ! OpenVMS V7.2 or lower [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSTEST]DECC$IVP.COM [new] [SYSEXE]DECC$SET_VERSION.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new]

Note that the files [SYSEXE]DECC$COMPILER_V06_00-001.EXE and [SYSMSG]DECC$COMPILER_MSG_V06_01-001.EXE are examples of files installed only when installing an alternate compiler. In this case, the new version of the compiler is installed, but a previous version of the compiler is kept as an alternate compiler. The installation procedure prompts you to designate one of the compiler versions as the system default compiler. See Section 1.6 for more information on installing and using multiple compiler versions.

Appendix C
Recovering from Errors

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

C.1 Failures During HP C Installation

If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter yes to continue. To stop the installation process and correct the situation, enter no or press Return, then correct the problem and restart the installation.

If errors occur during the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message:

%VMSINSTAL-E-INSFAIL, The installation of HP C V7.n has failed.

If the IVP fails, you see these messages:

The HP C V7.n Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for HP C V7.n has failed.

Errors can occur during the installation if any of the following conditions exist:

The operating system version is incorrect.
A prerequisite software version is incorrect.
Quotas necessary for successful installation are insufficient.
System parameter values for successful installation are insufficient.
The OpenVMS help library is currently in use.
The product license has not been registered and loaded.

For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. For information on installation requirements, see Section 1.5.

If the installation fails, you must restart the installation procedure from step 2 in Section 2.1. For an explanation of any system messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. If the installation fails due to an IVP failure, contact a HP field service representative.

C.2 Problems During HP C Use

If you encounter a problem while using HP C, see the release notes. If the problem is unresolved, report it to HP. Depending on the type of support you have and the nature of the problem, take one of the following actions:

If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by 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, indicate the following:
- The name and version number of the operating system you are using
- The product name (HP C) and the version number of HP C you are using
- The hardware system you are using (such as a model number)
- A 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 HP C 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 might 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 (floppy diskette or magnetic tape).
If the problem is related to HP C documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe); otherwise, send your comments about HP C documentation to the following Internet address:
c_docs@hp.com
To obtain information about purchasing a HP Software Product Services Support Agreement or other support services, please contact your local HP sales representative.