|
|
HP C++Installation Guide for OpenVMS AlphaOrder Number: AA-PY27K-TE
November 2005
This guide contains instructions for installing HP C++ on OpenVMS Alpha systems. It also explains how to read the online release notes before or after installing the product. This guide applies to HP C++ Version 7.1 for OpenVMS Alpha, and all subsequent point releases for Version 7.0. Revision/Update Information: This is a revised manual, replacing AA-PY27J-TE
Operating System & Version:
OpenVMS Alpha Version 7.3-2 or higher.
Software Version: HP C++ Version 7.1 for OpenVMS Alpha
© 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. 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. This document is available on CD-ROM. This document was prepared using DECdocument, Version 3.3-1e. Printed in the U.S.
PrefaceThis guide describes how to install HP C++ on the OpenVMS Alpha operating system. It is intended for system managers. Keep this guide with your distribution kit, in case you need it to reinstall HP C++ for any reason. You may send comments or suggestions concerning this guide, or any HP C++ document, by electronic mail to the following Internet address: c_docs@hp.com Document StructureThis guide contains three chapters and three appendixes:
Associated DocumentationIn addition to this guide, the HP C++ 7.1 documentation set includes the following books:
For information on the HP C++ online release notes, see Chapter 1. For general information on OpenVMS system management, see the OpenVMS operating system documentation set. For help understanding OpenVMS system error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. ConventionsTable 1 lists the conventions used in this guide.
In this manual, some version numbers are given as Vn.n. When you install HP C, the actual version numbers appear on your screen.
Chapter 1
|
Name | Quota |
---|---|
ASTLM | 190 |
BIOLM | 160 |
BYTLM | 99,000 |
DIOLM | 160 |
ENQLM | 4000 |
FILLM | 300 |
Use the OpenVMS Authorize Utility to verify and change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the OpenVMS Authorize Utility to certain accounts or people.) For instance, to change the BYTLM quota for the account-name installation account, you might enter the following command sequence:
$ RUN SYS$SYSTEM:AUTHORIZE UAF> MODIFY account-name /BYTLM = 99000 UAF> SHOW account-name UAF> EXIT $ LOGOUT |
After the quotas for the installation account have been changed, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation.
User account quotas are stored in the file SYSUAF.DAT. For more information on modifying account quotas, see the description of the Authorize Utility in the OpenVMS System Management documentation set.
Table 1-2 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 | Default Value |
---|---|---|
CLISYMTBL 1 | 500 | 500 |
GBLPAGES 2 | 8400 | 8400 |
GBLPAGFIL | 1024 | 1024 |
GBLSECTIONS 2 | 2 | 2 |
Requirements for free disk storage space are different during installation and after installation. Table 1-3 summarizes the storage requirements.
Component | Blocks After Installation | Peak During Installation |
---|---|---|
Compiler | 150,000 | 160,000 |
Text Header Files | 13,000 | 13,000 |
CXXLINK | 500 | 500 |
All Components | 163,500 | 173,500 |
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 |
At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. HP recommends that you back up your system disk 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 the Backup Utility in the OpenVMS System Management documentation set.
This section explains how to use the System Generation Utility (SYSGEN) and the AUTOGEN Utility to prepare your system for an installation of HP C++. AUTOGEN uses system configuration data to automatically set system parameters.
To check the values of your system parameters, enter the following command:
$ RUN SYS$SYSTEM:SYSGEN SYSGEN> |
At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The following example displays the value for the WSMAX system parameter:
SYSGEN> SHOW WSMAX |
Parameter Name Current Default Min. Max. Unit -------------- ------- ------- ---- ------- ---- WSMAX 81920 4096 1024 1048576 Pagelets internal value 5120 256 64 65536 Pages |
After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level. For information on setting dynamic system parameter values, see Section 1.5.6.4.
To install and run HP C++, you must have sufficient free global pagelets and global sections. You must first find out how many free global pagelets and sections you have on your system. Then use AUTOGEN if you need to increase the global pagelets and global sections system parameters.
Enter the following DCL command to determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE:
$ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE |
This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pagelets for the file.
You can use the WRITE command with the F$GETSYI lexical function to find the number of free global pagelets and global sections. 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 |
If the values displayed by the system are greater than the values in Table 1-2, you do not need to increase the values for these parameters. If the value of free global pagelets or global sections is less than the value in Table 1-2, you must increase the system parameter setting.
Section 1.5.6.3 describes the procedures for increasing these values using 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 following file:
SYS$SYSTEM:MODPARAMS.DAT |
Use an editor to access the 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_GBLPAGES or ADD_GBLSECTS. The following example increases the global page setting by 2000:
ADD_GBLPAGES = 2000 |
When you set the page file quota, 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.
AUTOGEN 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 system management documentation for your operating system.
Use SYSGEN to set dynamic parameters. Dynamic parameters changed with the SYSGEN command WRITE ACTIVE become active immediately without any need to reboot your system. Rebooting returns dynamic system parameter values to their previous settings.
After you change the dynamic parameter values, you should complete the installation before rebooting the system. After you finish the installation, you can reset the dynamic parameters to their previous values or let them be reset automatically when you reboot your system the next time.
If the dynamic parameter values on your system are less than the values previously listed, use the following series of commands to change the values. This example changes the GBLPAGES value to 100000:
$ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE ACTIVE SYSGEN> SET GBLPAGES 100000 SYSGEN> WRITE ACTIVE SYSGEN> EXIT |
After you register and load the License Product Authorization Key (License PAK), the installation takes approximately 10 to 15 minutes, depending on your system configuration and the kit components chosen.
C++ Version 7.1 provides support for installing and using multiple versions of the compiler on the same node.
During installation of Version 7.n, if a Version 6.n of the compiler is already installed, you have the opportunity to preserve that compiler rather than overwrite it. If you choose to preserve the currently installed compiler, you are then given a choice to keep the currently installed compiler as the system default and install the new compiler as an alternate.
By default, the currently installed system compiler is preserved by making it an alternate compiler and installing the new compiler as the system default. Users can make the choice to use an alternate compiler instead of the installed system compiler by running a command procedure that changes the behavior of the cxx command for the process that invokes it.
Some details of the following description may change, but the mechanism is essentially as follows.
This kit provides two command procedures to display and control which C++ compiler is used by a process:
$ @sys$system:cxx$show_versions.com The following C++ compiler(s) are available in SYS$SYSTEM: Filename Version --------------------------------------- CXX$COMPILER.EXE V6.5-020 CXX$COMPILER_V06_04-002.EXE V6.5-002 CXX$COMPILER_V06_04-001.EXE V6.5-001 CXX$COMPILER_V06_00-001.EXE V6.0-001 Process Default CXX$COMPILER_V06_02-008.EXE V6.2-008 |
$ @sys$system:cxx$show_versions.com V6.0 The following C++ compiler(s) are available in SYS$SYSTEM: Filename Version --------------------------------------- CXX$COMPILER_V06_00-001.EXE V6.0-001 Process Default |
$ @sys$system:cxx$set_version.com V6.2-008 $ show logical CXX$* (LNM$PROCESS_TABLE) "CXX$COMPILER" = "SYS$SYSTEM:CXX$COMPILER_V06_02-008.EXE" "CXX$MSG_SHR" = "SYS$MESSAGE:CXX$MSG_SHR_V06_02-008.EXE" $ @CXX$set_version.com 6.5 The following 6.5 C++ compiler(s) are available in SYS$SYSTEM: Filename Version --------------------------------------- CXX$COMPILER.EXE V6.5-020 CXX$COMPILER_V06_04-001.EXE V6.5-001 CXX$COMPILER_V06_04-002.EXE V6.5-002 Ambiguous version number, please be specify a full version number, ex: V6.5-020 Version number : V6.5-020 $ show logical CXX$COMPILER "CXX$COMPILER" = "SYS$SYSTEM:CXX$COMPILER_V06_04-005.EXE" (LNM$PROCESS_TABLE) $ show logical CXX$msg_shr "CXX$MSG_SHR" = "SYS$MESSAGE:CXX$MSG_SHR_V06_04-005.EXE" (LNM$PROCESS_TABLE) |
$ @sys$system:cxx$delete_version V6.5-001 The following V6.5-001 HP C++ compiler(s) are available in SYS$SYSTEM Filename Version --------------------------------------- CXX$COMPILER_V06_05-001.EXE V6.5-001 Really delete these compiler(s)? yes Deleting HP C++ V6.5-001 Deleting SYS$COMMON:[CXX$LIB]CXX$CLD_V06_05-001.CLD; Deleting SYS$COMMON:[SYSEXE]CXX$COMPILER_V06_05-001.EXE;1 Deleting SYS$COMMON:[SYSMSG]CXX$COMPILER_MSG_V06_05-001.EXE;1 Deleting SYS$COMMON:[SYSEXE]CXX$LINK_V06_05-001.EXE;1 Deleting SYS$COMMON:[SYSMSG]CXX$LINK_MSG_V06_05-001.EXE;1 Deleting SYS$COMMON:[SYSEXE]CXX$DEMANGLE_V06_05-001.EXE;1 Deleting SYS$COMMON:[SYSLIB]CXXL$ANSI_DEF_V06_05-001.TLB;1 Deleting SYS$COMMON:[SYSLIB]LIBCXXSTD_V06_05-001.OLB;1 Deleting SYS$COMMON:[CXX$LIB]CXXDEMANGLE_V06_05-001.CLD; Deleting SYS$COMMON:[CXX$LIB]CXXLINK_V06_05-001.CLD; |
When you install C++ Version 7.1 or higher on a system that already has a Version 6.0 or higher compiler installed, you are given the chance to preserve the currently installed system compiler. To do this, answer YES to the following question (the xxx will be replaced by the full version number of the existing system compiler):
"Should the existing xxx system compiler be preserved [NO]:" |
If you answer NO, the installation proceeds in the traditional manner, overwriting the currently installed system compiler.
If you answer YES, you are then asked an additional question. To get the traditional behavior of installing the kit compiler as the system default, answer NO to the question:
"Should this xxx system compiler remain the default when cxx is typed [NO]:" |
Because you have previously asked to preserve the existing system compiler, that compiler is made an alternate compiler before the new system compiler is installed from the kit. If you answer YES to the question, the kit compiler is installed as an alternate compiler with a name that is based on its ident, and the existing system default compiler remains the default.
If it is not already inserted, place the compact disc (CD-ROM) media into the CD-ROM drive.
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. You can then start the installation again.
The kit installation procedure invokes a utility program to manipulate header file text libraries. Attempts to abort the installation might be ignored while the program is executing. If the procedure does not abort immediately, press Ctrl/Y until it does. |
When the system prompts you with a question during the installation procedure, the default answer is often listed in brackets ([]).
Username: SYSTEM Password: |
@SYS$UPDATE:VMSINSTAL saveset-name device-name option-list |
saveset-name
The installation name for the component. For HP C++, use the following installation name:
CXX07n
n represents the minor (point) release number for HP C++ such as CXX071 for Version 7.1.
To obtain the directory location of the HP C++ save set on the CD-ROM, refer to the Software Product Library CD-ROM User's Guide booklet that accompanies the CD-ROM distribution kit, or before starting installation, complete these steps:
- To determine whether the CD-ROM drive is already mounted (with the MOUNT command), enter the following command:
$ SHOW DEVICE DKA400:- If it is not mounted, enter the appropriate MOUNT command to mount the CD-ROM (omit the /FOREIGN qualifier).
- To obtain the save-set name, enter a DIRECTORY command specifying the directory file from the previous command:
$ DIRECTORY DKA400:[CXX07n.KIT]CXX07n.A
n represents the minor release of HP C++.device-name
The name of the device on which you plan to mount the media and the directory containing the HP C++ save set. For example, DKA400: is the device name used in examples in this guide. The directory is [CXX07n], where n is the minor release number.
To specify the device name on the @VMSINSTAL command line, enter:
DKA400:[CXX07n]option-list
The word OPTIONS followed by one or more of the following option designators---A, G, L, N, R:
- Auto_answer option (A)
Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system).- Get save-set option (G)
Lets you store product save sets temporarily on a magnetic tape or in a disk directory.- File log option (L)
Logs all activity to the terminal during installation.- Display or print the release notes (N)
Indicates that you want to see the installation question on release notes. If you do not include the N option, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in case they contain additional information about the installation.
If you are restarting the installation and have already reviewed the release notes, you do not need to specify the N option. (Even if you omit the N option when you invoke VMSINSTAL, the HP C++ release notes are copied automatically to the SYS$HELP directory.)- Alternate root option (R)
Lets you install the product to a system root other than that of the running system.
For detailed information on these software installation options, see the OpenVMS operating system documentation. If you specify more than one option, separate the options with commas, such as OPTIONS A,N.
$ @SYS$UPDATE:VMSINSTAL CXX07n DKA400:[CXX07n] OPTIONS N OpenVMS Alpha Software Product Installation Procedure V8.2 It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. |
* Do you want to continue anyway [NO]? YES |
* Are you satisfied with the backup of your system disk [YES]? |
* Where will the distribution volumes be mounted: DKA400:[CXX07n] |
Enter the products to be processed from the first distribution volume set. * Products: CXX07n |
The following products will be processed: CXX V7.n Beginning installation of CXX V7.n at hh:mm %VMSINSTAL-I-RESTORE, Restoring product save set A... |
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. HP C++ V7.n for OpenVMS Alpha Systems |
SYS$HELP:CXX.RELEASE_NOTES SYS$HELP:CXX_RELEASE_NOTES.PS |
$ HELP CXX RELEASE_NOTES |
* Do you want to run the IVP after the installation [YES]? |
SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_HXX] SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_H] SYS$COMMON:[CXX$LIB.REFERENCE.CXX$RTLDEF_HXX] SYS$COMMON:[CXX$LIB.REFERENCE.CXX$RTLDEF] |
The header files (text libraries) are now automatically installed based on the time stamps found within them. Time stamps on the kit versions are compared to those on the system, and the kit libraries are installed only if they are found to be more recent. All of this occurs without prompting. |
The HP C++ compiler component requires a Product Authorization Key (PAK) for HP C++ to be registered and loaded. Answer the following question with YES if a PAK with the specified product name and a date equal to or later than the date shown is registered and loaded, otherwise answer NO. Product: CXX-V Producer: DEC Version: 7.n Release Date: dd-mmm-yyyy |
* Does this product have an authorization key registered and loaded?: YES |
%VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... |
HP C++ V7.n Installation Verification Procedure completed successfully. |
Installation of CXX V7.n completed at hh:mm Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CXX07n.VMI_DATA |
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. 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 will see the following message:
%VMSINSTAL-E-INSFAIL, The installation of HP C++ Version 7.n has failed. |
If the IVP fails, you will see these messages:
The HP C++ Version 7.n Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for HP C++ Version 7.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 Chapter 1.
If the installation fails, you must restart the installation procedure from step 2. 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 an HP field service representative.
HP C++ is now installed and can be invoked by all users with the cxx command.
The installation procedure modifies the DCL command table so that the cxx 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 cxx command must log out and log in again, or use the following DCL command:
$ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES |
The following tasks can be performed after HP C++ is installed:
The following sections describe these tasks in detail.
You usually run the Installation Verification Procedure (IVP) during installation. To run the IVP separately to ensure the integrity of installed files should system problems occur, type the following:
$ @SYS$TEST:CXX$IVP.COM |
If the IVP fails, you see these messages:
The HP C++ 7.1 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for HP C++ 7.1 has failed. |
You do not need to edit the compiler system startup (CCXX$STARTUP.COM) and shutdown files to provide for automatic startup and shutdown of HP C++ when your system is rebooted. You may optionally add SYS$STARTUP:CCXX$STARTUP.COM to the system startup procedure to install the images.
After completing the initial installation, if you want to install HP C++ on multiple nodes in a cluster, you must run INSTALL on each of the other nodes and enter the following command:
INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE |
If you are using a dual-architecture (VAX and Alpha systems) 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 Manager's Manual.
Many 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 at least the 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 the working set (WSDEF, WSQUOTA, WSEXTENT) and pagefile (PGFLQUOTA) account quotas to improve performance.
See Section 1.5.2 for a description of how to verify and change account quotas.
HP highly recommends that you reduce the system overhead and memory requirements by installing the HP C++ compiler and the C++ Class Library as shared images. To install HP C++ as a shared image on a system that is currently running, use the INSTALL Utility. HP recommends that you install HP C++ as shared on a system that has been rebooted recently because the available space in the global pagelet table is less likely to be fragmented.
To install HP C++ and the Class Library as a shared image:
After you reset the system parameter values, invoke the INSTALL Utility from a privileged account and install the HP C++ compiler as a shared image:
$ INSTALL INSTALL> ADD SYS$SYSTEM:CXX$COMPILER.EXE /OPEN /SHARED INSTALL> EXIT |
Similarly, install the C++ Class Library as a shared image:
$ INSTALL INSTALL> ADD SYS$LIBRARY:CXXL$011_SHR.EXE /OPEN /SHARED INSTALL> EXIT |
Add the following lines to the appropriate system startup command file so that HP C++ is available as a shared image each time the system is started. (If your site has modularized its startup procedures, be sure you add the lines to the correct file.) The default startup command file is SYS$MANAGER:SYSTARTUP_VMS.COM.
$ INSTALL ADD SYS$SYSTEM:CXX$COMPILER.EXE /OPEN /SHARED ADD SYS$LIBRARY:CXXL$011_SHR.EXE /OPEN /SHARED EXIT |
Using the /PRIVILEGED qualifier is neither necessary nor recommended.
To install the compiler message file, enter the following commands:
$ INSTALL INSTALL> ADD SYS$MESSAGE:CXX$COMPILER_MSG.EXE INSTALL> EXIT |
To install the Class Library message file, enter the following commands:
$ INSTALL INSTALL> ADD SYS$MESSAGE:CXXL$MSG_SHR.EXE INSTALL> EXIT |
When you install HP C++ as a shared image you need to increase the global pagelets and global sections parameters. See Section 1.5.6.2 for information on changing these parameters.
A command procedure CXX$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:CXX$PRODUCT_REMOVE Do you wish to proceed with removing HP C++ <No>? Yes [Ret] |
Enter "Yes" to remove the compiler from your system.
If an error occurs while HP C++ is in use and you believe the error is caused by a problem with the product, please report it to HP.
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:
Whether you submit information electronically or contact the appropriate support specialist by telephone, please take the following steps:
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 Software Product Services Support Agreement or other support services, please contact your local HP sales representative or business partner.
This appendix contains a sample installation for the HP C++ kit. It is only a sample. Sometimes the installation procedure is modified in maintenance updates of this product.
Because this installation guide is not usually revised for maintenance updates, be sure to read the applicable Read Before Installing or Using HP C++ letter before you install this product. This letter notes any significant changes to the installation sample shown here. Such information also appears in the online release notes.
Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation.
This sample installation assumes that DECnet has been shut down, that no users are logged in to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation.
Example A-1 shows a sample installation of HP C++ 7.1 on an OpenVMS Alpha Version 8.2 system.
Example A-1 Sample HP C++ Installation on OpenVMS Alpha Version 8.2 |
---|
$ @sys$update:vmsinstal OpenVMS Alpha Software Product Installation Procedure V8.2 It is 16-June-2005 at 13:35. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? Y * Where will the distribution volumes be mounted: DKA400:[CXX071] Enter the products to be processed from the first distribution volume set. * Products: cxx * Enter installation options you wish to use (none): n The following products will be processed: CXX V7.1 Beginning installation of CXX V7.1 at 13:35 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. HP C++ Version V7.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. * Should this V7.1-001 system compiler remain the default when cxx is typed [NO]: The newly installed compiler will become the system default compiler. * Do you want to purge files replaced by this installation [YES]? This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of the HP C++ compiler component and class library headers. IVP will be placed in: SYS$TEST:CXX$IVP.COM After the installation is complete, you can invoke the command file at any time to reverify that HP C++ is installed and working correctly. If you wish to invoke it automatically at the completion of this installation procedure, answer Yes to the following question. * Do you want to run the IVP after the installation [YES]? Y The C Runtime Library, and C++ Class Library, headers will be installed as Text Libraries (.TLBs). If you also wish to install the traditional text form of the headers (.H and .HXX files) for reference purposes, please answer yes to the following question. The text headers will be placed in a subdirectory that will not be searched by the compiler. Instead, they will be placed the subdirectory tree: SYS$COMMON:[CXX$LIB.REFERENCE...] ( SYS$COMMON:[CXX$LIB.REFERENCE...] for the HP C RTL header library, CXX$RTLDEF, and the system definition header library, SYS$STARLET_C.) Note that doing this may double the disk space used for the headers. * Do you want to install the text form of the headers? [YES]? Y The HP C++ compiler component requires a Product Authorization Key (PAK) for HP C++ to be registered and loaded. Answer the following question with YES if a PAK with the specified product name and a date equal to or later than the date shown is registered and loaded, otherwise answer NO. Product: CXX-V Producer: DEC Version: 7.1 Release Date: dd-mmm-2005 * Does this product have an authorization key registered and loaded? Y All questions and validations regarding the installation of HP C++ kit components have now been asked. Depending upon your configuration, time estimates for the installation(s) are as follows: Compiler/Linker/Library: 2 minutes Text form of headers: 4 minutes IVP: 2 minutes Moving files: 6 minutes You may optionally add the SYS$STARTUP:CCXX$STARTUP.COM to the system startup procedure. To use HP C++ for OpenVMS Alpha on other Alpha nodes of a VMScluster, from a privileged account on each such node enter the command "$ @SYS$STARTUP:CCXX$STARTUP.COM". This will install images. The existing version of VMI$ROOT:[SYSLIB]DECC$RTLDEF.TLB is identical or newer than the one on this installation kit. Installation of the kit version will not be performed. Your OpenVMS system will now be updated to include the following new and modified file(s): SYS$HELP:CXX.RELEASE_NOTES [new] SYS$HELP:CXX_RELEASE_NOTES.PS [new] SYS$TEST:CXX$IVP.COM [new] SYS$SYSTEM:CXX$DELETE_VERSION.COM [new] SYS$SYSTEM:CXX$SET_VERSION.COM [new] SYS$SYSTEM:CXX$SHOW_VERSIONS.COM [new] SYS$SYSTEM:CXX$COMPILER.EXE [new] SYS$MESSAGE:CXX$COMPILER_MSG.EXE [new] SYS$LIBRARY:DCLTABLES.EXE [modified] SYS$COMMON:[CXX$LIB]CXX$CLD.CLD [new] SYS$SYSTEM:CXX$COMPILER_V07_01-001.EXE [new] SYS$MESSAGE:CXX$COMPILER_MSG_V07_01-001.EXE [new] SYS$COMMON:[CXX$LIB]CXX$CLD_V07_01-001.CLD [new] SYS$HELP:HELPLIB.HLB [modified] SYS$SYSTEM:CXX$LINK.EXE [new] SYS$MESSAGE:CXX$LINK_MSG.EXE [new] SYS$COMMON:[CXX$LIB]CXXLINK.CLD [new] SYS$SYSTEM:CXX$LINK_V07_01-001.EXE [new] SYS$MESSAGE:CXX$LINK_MSG_V07_01-001.EXE [new] SYS$COMMON:[CXX$LIB]CXXLINK_V07_01-001.CLD [new] SYS$SYSTEM:CXX$DEMANGLE.EXE [new] SYS$COMMON:[CXX$LIB]CXXDEMANGLE.CLD [new] SYS$SYSTEM:CXX$DEMANGLE_V07_01-001.EXE [new] SYS$COMMON:[CXX$LIB]CXXDEMANGLE_V07_01-001.CLD [new] SYS$HELP:[CXX$HELP]INTZLN.PDF [new] SYS$HELP:[CXX$HELP]IOSTREAM.PDF [new] SYS$HELP:[CXX$HELP]INTZLN.PS [new] SYS$HELP:[CXX$HELP]IOSTREAM.PS [new] SYS$HELP:[CXX$HELP]CXX_CLASSLIB.PS [new] SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.PS [new] SYS$HELP:[CXX$HELP]CXX_CLASSLIB.TXT [new] SYS$HELP:[CXX$HELP]CXX_USERSGUIDE.TXT [new] SYS$STARTUP:CCXX$STARTUP.COM [new] SYS$LIBRARY:LIBCXXSTD.OLB [new] SYS$LIBRARY:LIBCXXSTD_MA.OLB [new] SYS$LIBRARY:LIBCXXSTD_NOINST.OLB [new] SYS$LIBRARY:LIBCXXSTD_MA_NOINST.OLB [new] SYS$LIBRARY:LIBCXXSTD_V07_01-001.OLB [new] SYS$LIBRARY:LIBCXXSTD_MA_V07_01-001.OLB [new] SYS$LIBRARY:LIBCXXSTD_NOINST_V07_01-001.OLB [new] SYS$LIBRARY:LIBCXXSTD_MA_NOINST_V07_01-001.OLB [new] SYS$LIBRARY:CXXL$ANSI_DEF.TLB [new] SYS$LIBRARY:CXXL$ANSI_DEF_V07_01-001.TLB [new] %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning HP C++ V7.1-001 Installation Verification Procedure 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. Test compiler operation and error messages... Test Class Library operation... HP C++ V7.1-001 Installation Verification Procedure completed successfully Installation of CXX V7.1 completed at 13:45 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CXX071.VMI_DATA Enter the products to be processed from the next distribution volume set. * Products: VMSINSTAL procedure done at 13:45 $ |
The HP C++ installation procedure installs and modifies a number of files on your system, as listed in Table B-1.
This appendix provides information to help you with failures or errors that might occur during product installation or product use.
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++ 7.1 has failed. |
If the IVP fails, you see these messages:
The HP C++ 7.1 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for HP C++ 7.1 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 Chapter 1.
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:
Contents |
|