|
|
HP C
|
Previous | Contents |
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:
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.
HP C is now installed and can be invoked by all users with the CC command.
The installation procedure modifies the DCL command table so that the CC 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 CC command must log out and log in again, or use the following DCL command:
$ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES |
You can perform the following system management tasks after HP C is installed:
The following sections describe these tasks in detail.
You usually run the IVP during installation. If you want to run the IVP separately to ensure the integrity of installed files if system problems should occur, execute the following command procedure:
$ @SYS$TEST:DECC$IVP.COM |
If the IVP fails for any reason, the following message is displayed:
HP C VERSION 7.n TEST FAILED |
You must edit the system startup file to provide for automatic startup of HP C when your system is rebooted.
Add the command line that starts HP C to the system startup file, SYS$MANAGER:SYSTARTUP_VMS.COM. HP C cannot start until after the network has started. You must position this new command line after the line that invokes the network startup command procedure. The following example shows the network startup command line followed by the HP C startup command line:
$ @SYS$MANAGER:STARTNET.COM . . . $ @SYS$STARTUP:DECC$STARTUP.COM |
If you want to run HP C on multiple nodes of an OpenVMS cluster, first check to see that you have the appropriate software license (see Section 1.4). Then perform the following steps after you install HP C:
$ INSTALL INSTALL> LIST SYS$SYSTEM:DECC$COMPILER.EXE |
INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE |
INSTALL> REPLACE SYS$SYSTEM:DECC$COMPILER.EXE |
Some products cannot be used unless certain privilege and quota requirements are met by user accounts. The following sections describe the privilege and quota requirements needed to work with HP C.
To use HP C, each account must have TMPMBX and NETMBX privileges. Use the OpenVMS AUTHORIZE utility to determine whether users have the privileges they require.
To use HP C, a user account does not need to meet any special quota requirements. However, for users who will be compiling very large programs (many program units compiled together), consider adjusting working set (WSDEF, WSQUOTA, WSEXTENT) and pagefile (PGFLQUOTA) account quotas to improve performance.
See Section 1.5.3.2 for a description of how to verify and change account quotas.
The following sections include information on system tuning and explain how to install HP C as a shared image.
After you install HP C, you might want to adjust your system to enhance performance or lower the use of some system resources. General information about tuning an OpenVMS system is included in the Guide to OpenVMS Performance Management.
If you expect HP C 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 HP C as a shared image on a system that is currently running, use the OpenVMS INSTALL utility. It is recommended that you install HP C 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.
To install HP C as a shared image:
$ $ @SYS$STARTUP:DECC$STARTUP |
A command procedure CC$PRODUCT_REMOVE is available should you wish to remove the HP C compiler product from your system for any reason. The procedure performs the equivalent of a PCSI PRODUCT REMOVE command.
Before issuing the command procedure, you are required to disable the product license to prevent a compilation from interfering with the delete process.
If the compiler has been installed as a shared image, the command procedure will uninstall the image.
The command procedure takes no parameters and can be run as follows:
$ @SYS$SYSTEM:CC$PRODUCT_REMOVE Do you wish to proceed with removing HP C <No>? Yes [Ret] |
Enter "Yes" to remove the compiler from your system.
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:
This appendix contains sample installations of the HP C kit. These are only samples. Sometimes the installation procedure is modified in maintenance updates of this product.
Because this installation guide is not always revised for maintenance updates, be sure to read the Read Before Installing HP C for OpenVMS Alpha Systems Version 7.n letter before you install this product. This letter notes any significant changes to the installation samples shown here.
Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation.
The sample installations assume that DECnet has been shut down, and that no users are logged on to your system. The Installation Verification Procedure (IVP) runs at the end of the installations.
This sample was run on a system that had no previous version of HP C installed.
$ @sys$update:vmsinstal CC071 DKA400:[CC071.KIT] OpenVMS AXP Software Product Installation Procedure V7.2-1 It is 11-June-2005 at 12:58. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. %VMSINSTAL-W-ACTIVE, The following processes are still active: TCPIP$NTP TCPIP$PORTM * Do you want to continue anyway [NO]? yes [Return] * 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 12:58 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %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. 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$TEST: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]: [Return] 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) is 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. The CXXDEMANGLE utility appears on this system. Installation of the kit version will not be performed. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSHLP.CC$ALPHA_HELP_071]. Your OpenVMS system will now be modified to include the following new and modified files: [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$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new] [SYSTEST]DECC$IVP.COM [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 start up 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 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 13:10 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CC071.VMI_DATA VMSINSTAL procedure done at 13:11 |
This sample was run on a system that had a previous version of HP C installed. The system is upgraded to the new version of the compiler, which replaces the old one.
$ @sys$update:vmsinstal CC071 DKA400:[CC071.KIT] OpenVMS Alpha Software Product Installation Procedure V7.2-1 It is 11-June-2005 at 14:24. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. %VMSINSTAL-W-ACTIVE, The following processes are still active: TCPIP$NTP TCPIP$PORTM * Do you want to continue anyway [NO]? yes [Return] * 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:24 (Waiting for demon to record initial state... ...done) %VMSINSTAL-I-RESTORE, Restoring product save set A ... %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.2-008 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.2-008. * Should the existing V6.2-008 system compiler be preserved [NO]: [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$TEST: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] 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) is 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. The CXXDEMANGLE utility appears on this system. Installation of the kit version will not be performed. Your OpenVMS system will now be modified to include the following new and modified files: [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$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYS$STARTUP]DECC$STARTUP.COM [modified] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSTEST]DECC$IVP.COM [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 start up 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 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:36 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CC071.VMI_DATA VMSINSTAL procedure done at 14:40 |
Previous | Next | Contents |
|