|
HP OpenVMS SystemsC++ Programming Language |
|
HP C++Installation Guide for
|
| Contents |
This guide describes how to install HP C++ on an OpenVMS Industry Standard 64 (I64) system. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall HP C++ for any other reason.
This manual applies to 7.3 of HP C++ and all subsequent releases until a revised installation guide is issued.
This guide is intended for system managers who install HP C++.
This guide contains the following chapters and appendixes:
In addition to this guide, the HP C++ 7.3 documentation set includes the following books:
The following manuals in the OpenVMS documentation set contain information relevant to installing software:
Once installed, you can use HP C++ online HELP, which describes the command qualifiers, explains run-time messages, and provides a quick-reference summary of language topics. To use online HELP, type HELP followed by the command name as in the following example:
$ HELP CXX |
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 error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility.
HP welcomes your comments on this manual. You can send comments by email to:
c_docs@hp.com |
For additional product information, you can view the HP C++ for OpenVMS home page at the following URL:
http://h71000.www7.hp.com/commercial/cplus/cplus_index.html |
The following product names may appear in this manual:
All three names (the longer form and the two abbreviated forms) refer to the version of the OpenVMS operating system that runs on the Intel® Itanium® architecture.
Table 1 lists the typographic conventions used in this document.
In this manual, some version numbers are given as Vn.n. When you install HP C, the actual version number appears on your screen.
This chapter describes:
This guide applies to Version 7.3 of HP C++ for OpenVMS I64 Systems and all subsequent maintenance releases up to the next release of the product that includes an updated installation guide.
The OpenVMS Software Product Library CD-ROM (media CD-ROM) set provides the following files:
To determine whether the appropriate media CD-ROM is already mounted on your system, contact the appropriate system manager.
HP C++ provides release notes and a cover letter called Read Before Installing or Using HP C++ Version 7.3 for OpenVMS I64 Systems.
You can extract the HP C++ release notes to a file and type or print them before starting HP C++ installation. The HP C++ release notes are also installed on your system after installation.
You can read the online cover letter provided on the media CD-ROM set or read the printed hardcopy cover letter.
For information about using the CDMENU utility and locating the appropriate media CD-ROM and directory that contains the HP C++ cover letter, see the first few steps in Section 2.2.
Once the appropriate media CD-ROM has been mounted and the appropriate HP C++ documentation directory located, do one of the following:
For information about reading the online release notes before installation, use the PRODUCT EXTRACT RELEASE_NOTES command described in Section 2.2 (step 6).
HP strongly recommends that you read the release notes and the cover letter before installing HP C++. They contain information about changes to the installation and use of HP C++, such as the minimum version of the OpenVMS I64 operating system required for this release of HP C++.
After installation, the release notes are installed as text and PostScript form in:
SYS$HELP:CXX.RELEASE_NOTES SYS$HELP:CXX_RELEASE_NOTES.PS |
You can install HP C++ on any Itanium processor capable of running OpenVMS I64 Version 8.2 or higher. See the OpenVMS Operating System's Software Product Description (SPD 25.01.nn) for details.
HP C++ 7.3 requires the OpenVMS I64 operating system Version 8.2-1 or higher.
Future HP C++ releases may require higher versions of the OpenVMS operating system, as described in the release notes or the cover letter.
The OpenVMS I64 operating system comes with a variety of support options (or components). Components include such features as networking and RMS journaling. To use HP C, your system should be running a version of the OpenVMS I64 operating system that includes the base component and the following other components:
For a complete list of the required components, see the HP C++ Software Product Description (SPD) on the media CD-ROM.
You can use the following optional OpenVMS software with HP C++:
Before you install and run HP C++ 7.3 on a newly-licensed node or cluster, you must first register a License Product Authorization Key (License PAK), using the License Management Facility (LMF).
The LMF product name used by HP C++ is:
The HP C++ compiler accepts a CXX-V PAK. The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. If you are installing HP C++ as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements.
If you are installing prerequisite or optional software along with HP C++, review the PAK status and install the PAKs for any prerequisite or optional software before you install HP C++.
You must register and load your license for HP C++ before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software.
To register a license under OpenVMS, log in to a privileged account, such as the system manager's account, SYSTEM. You have a choice of two ways to register a license:
If you plan to use HP C++ on more than one node in a cluster, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.3.
For complete information on using LMF, see the VMS License Management Utility Manual or the online HELP LICENSE utility.
After you have registered and loaded the license PAK and read the appropriate parts of this installation guide, the installation takes approximately 5 to 15 minutes, depending on your type of media, your system configuration, and the kit components chosen.
To install HP C++, you must be logged in to an account that has the SETPRV privilege or at least the following privileges enabled:
The installation account must have minimum quotas as shown in Table 1-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.
Requirements for free disk storage space are different during installation and after installation. Table 1-2 summarizes the storage requirements.
| Component | Peak During Installation | Blocks After Installation |
|---|---|---|
| Compiler and documentation | 150,000 | 75,000 |
These counts refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options.
To determine the number of free disk blocks on the current system disk, enter the following DCL command:
$ SHOW DEVICE SYS$SYSDEVICE |
Table 1-3 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 |
To install and run HP C++, you must have sufficient free global pagelets and global sections.
Enter the following DCL command to determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE:
$ DIR/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 contiguous global pagelets and free 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 value of free global pagelets or global sections is less than the required value (see Section 1.7.4), you must increase the system parameter setting.
Section 1.7.4.2 describes the procedures for increasing these values using AUTOGEN.
If you do not have enough free global pages or free global sections to install HP C++, you can do either of the following:
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 specifies the name of the parameter and its value. For example:
WSMAX = 8096 |
To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use the ADD_ prefix. The following example increases the global page setting by 2000:
ADD_GBLPAGES = 2000 |
After you make all your changes, exit from the editor, then execute the AUTOGEN procedure to recalculate your system parameters and reboot the system:
$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT |
When you specify REBOOT, AUTOGEN does 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.
The AUTOGEN Utility 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 information about using AUTOGEN and its command-line parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems.
HP recommends that you do a system disk backup before installing any software. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the Using VMS BACKUP manual.
This chapter explains how to install HP C++:
C++ Version 7.3 and higher provides support for installing and using multiple versions of the compiler on the same node. It works by appending an ident name to a previously installed compiler and saving it alongside the new compiler from this kit. Users on your system can then execute the SYS$SYSTEM:CXX$SHOW_VERSIONS.COM and SYS$SYSTEM:CXX$SET_VERSION.COM command procedures to view the list of available compiler versions and to select the desired compiler for a given process.
During installation of Version 7.3, if a previous version 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, the new compiler version will become the system default, and the previous version will remain as an alternate.
Users can make the choice to use an alternate compiler instead of the installed default 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 T7.3-018 System Default CXX$COMPILER_T07_03-018.EXE T7.3-018 CXX$COMPILER_V07_01-011.EXE V7.1-011 CXX$COMPILER_V07_02-018.EXE V7.2-018 Process Default |
$ @SYS$SYSTEM:CXX$SHOW_VERSIONS.COM V7.2 The following C++ compiler(s) are available in SYS$SYSTEM: Filename Version --------------------------------------- CXX$COMPILER_V07_02-018.EXE V7.2-018 Process Default |
$ @SYS$SYSTEM:CXX$SET_VERSION V7.2-018 |
$ @SYS$SYSTEM:CXX$SET_VERSION The following HP C++ compiler(s) are available in SYS$SYSTEM Filename Version Defaults ------------------------------------------------------- CXX$COMPILER.EXE T7.3-018 System Default CXX$COMPILER_T07_03-018.EXE T7.3-018 CXX$COMPILER_V07_01-011.EXE V7.1-011 CXX$COMPILER_V07_02-018.EXE V7.2-018 Enter Version number or SYSTEM: V7.1-011 |
When you install HP C++ I64 Version 7.3 or higher on a system that already has a previous version of the compiler installed, you are given the chance to preserve that currently installed system compiler. To do this, during installation, your system administrator needs to answer NO to the question about default options:
Do you want the defaults for all options? [YES] NO <RET> |
And then answer YES to the question about making alternate compilers available:
Would you like to set up your system for running alternate versions of C? [NO] YES <RET> |
If you answer YES to the first question above (about the default options), you will not receive the second prompt (to set up your system for running alternate versions of C++), and the installation proceeds in the traditional manner, overwriting the currently installed system compiler.
If you answer YES to the second prompt, the new compiler is installed as the system default compiler, and the previously installed compiler is set up as an alternate compiler with a name based on its ident.
HP C++ is installed using PCSI for OpenVMS I64. The installation procedure loads HP C++ product distribution files onto the system disk on the system where you perform the installation.
A startup procedure, CXX$STARTUP.COM, has been added to the PCSI product install kit. It contains commands that can be executed after the product installation procedure has been run and at 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++.
Follow these steps to install HP C++ from the OpenVMS I64 Software Products Library CD-ROM set:
$ SET PROCESS/PRIVILEGE=(CMKRNL,WORLD,SYSPRV) |
$ SHOW PROCESS/PRIVILEGES |
$ SHOW DEVICE DKA400 |
DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted. |
$ MOUNT DKA400 label |
$ DIRECTORY *.PCSI Directory DKA400:[dir.subdir] HP-I64VMS-CXX-V0701-nnnn-1.PCSI Total of 2 files. |
$ PRODUCT EXTRACT RELEASE_NOTES CXX /SOURCE=disk:[dir] |
$ TYPE/PAGE CXX.RELEASE_NOTES |
$ PRODUCT INSTALL CXX /SOURCE=node::disk:[kit_dir] |
1 - HP I64VMS CXX V7.1-001 Layered Product
2 - All products listed above
? - Help
E - Exit
Choose one or more items from the menu: 1
The following product has been selected:
HP I64VMS CXX V7.1-001 Layered Product
Do you want to continue? [YES] [Return]
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.
HP I64VMS CXX V7.1-001: HP C++ for OpenVMS Industry Standard
Copyright 2004 Hewlett-Packard Development Company, L.P.
This software product is sold by Hewlett-Packard Company
PAKs used: CXX-V
Do you want the defaults for all options? [YES]
Copyright 2004 Hewlett-Packard Development Company, L.P.
HP, the HP logo, Alpha and OpenVMS are trademarks of
Hewlett-Packard Development Company, L.P. in the U.S. and/or
other countries.
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 Date for Commercial
Items are licensed to the U.S. Government under vendor's
standard commercial license.
Do you want to review the options? [NO] [Return]
Execution phase starting . . .
The following product will be installed to destination:
HP I64VMS CXX V7.1-001 DISK$ICXXSYS:[VMS$COMMON.]
Portion done: 0%...90%...100%
The following product has been installed:
HP I64VMS CXX V7.1-001 Layered Product
%PCSI-I-IVPEXECUTE, executing test procedure for HP I64VMS CXX V7.1-001 ...
%PCSI-I-IVPSUCCESS, test procedure completed successfully
HP I64VMS CXX V7.1-001: HP C++ for OpenVMS Industry Standard 64 for
Integrity Servers
The compiler is now available from the command line of newly created processes.
To enable access to the compiler from the command line of a currently
running process (such as this one), execute:
SET COMMAND/TABLE=SYS$COMMON:[SYSLIB]DCLTABLES
The release notes are located in the file SYS$HELP:CXX.RELEASE_NOTES
for the text form and SYS$HELP:CXX_RELEASE_NOTES.PS for the postscript form.
$
|
$ PRODUCT SHOW OBJECT /PRODUCT=CXX |
To use other features of the PCSI utility, see the POLYCENTER Software Installation Utility User's Guide.
The following is a sample installation run on a system that had a previous version of HP C++ installed. In this sample, the new version of the compiler is installed as the default compiler, but a previous version of the compiler is kept as an alternate compiler. See Section 2.1 for more information on installing and using multiple compiler versions.
$ product install cxx /source=decc$kit:[ipf]
1 - HP I64VMS CXX T7.3-21 Layered Product
2 - HP I64VMS CXX T7.3-14 Layered Product
3 - HP I64VMS CXX T7.3-4 Layered Product
4 - HP I64VMS CXX V7.2-21 Layered Product
? - Help
E - Exit
Choose one or more items from the menu: 1
Performing product kit validation ...
%PCSI-I-VALPASSED, validation of
$4$DKB300:[DECC.RELEASE.][IPF]HP-I64VMS-CXX-T0703-021-1.PCSI$COMPRESSED;1 succeeded
The following product has been selected:
HP I64VMS CXX T7.3-21 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.
HP I64VMS CXX T7.3-21: HP C++ for OpenVMS Industry Standard
Copyright 2003-2007 Hewlett-Packard Development Company, L.P.
This software product is sold by Hewlett-Packard Company
PAKs used: CXX-V or CXX-V-USER
Do you want the defaults for all options? [YES] no
HP I64VMS VMS V8.3 [Installed]
* Configuration options for this referenced product cannot
* be changed now because the product is already installed.
* (You can use PRODUCT RECONFIGURE later to change options.)
Copyright 2003-2007 Hewlett-Packard Development Company, L.P.
HP, the HP logo, Alpha and OpenVMS are trademarks of
Hewlett-Packard Development Company, L.P. in the U.S. and/or
other countries.
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.
Multi_Version Support:
If you would like to set up your system to be able to run different
versions of the compiler then answer yes. The installation procedure will
then copy the previously installed C++ compiler and associated files along
side the new compiler in this kit with a suffix appended to the name that
corresponds to the version number. Users may then execute
CXX$SET_VERSION.COM to run an alternate version of the compiler
and CXX$SHOW_VERSIONS.COM to show available versions at anytime
after this installation.
Would you like to set up your system for running alternate versions of C++? [NO] yes
Do you want to review the options? [NO] yes
HP I64VMS CXX T7.3-21: HP C++ for OpenVMS Industry Standard
HP I64VMS VMS V8.3 [Installed]
Would you like to set up your system for running alternate versions of C++?: YES
Are you satisfied with these options? [YES]
Execution phase starting ...
The following product will be installed to destination:
HP I64VMS CXX T7.3-21 DISK$ICXXSYS:[VMS$COMMON.]
The following product will be removed from destination:
HP I64VMS CXX V7.2-18 DISK$ICXXSYS:[VMS$COMMON.]
Portion done: 0%...60%...70%...80%...90%...100%
The following product has been installed:
HP I64VMS CXX T7.3-21 Layered Product
The following product has been removed:
HP I64VMS CXX V7.2-18 Layered Product
%PCSI-I-IVPEXECUTE, executing test procedure for HP I64VMS CXX T7.3-21 ...
%PCSI-I-IVPSUCCESS, test procedure completed successfully
HP I64VMS CXX T7.3-21: HP C++ for OpenVMS Industry Standard
Text form of the release notes are located in the file SYS$HELP:CXX.RELEASE_NOTES
SYS$HELP:CXX_RELEASE_NOTES.PS contains the postscript form.
A startup file SYS$STARTUP:CXX$STARTUP.COM has been provided.
It contains commands which can be executed after the product install
procedure has been run and at 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++.
|
Errors can occur during the installation if any of the following conditions exist:
For descriptions of error messages generated by these and related conditions, see the OpenVMS I64 documentation on system messages and software installation or the online HELP/MESSAGE command. Take the appropriate action described in the message.
For information on system requirements for installing HP C++, see Section 1.4.
To report a problem to HP, see Section 3.7.
You can perform the following tasks after HP C++ is installed:
The HP C++ Installation Verification Procedure (IVP) runs automatically during HP C++ installation.
If system problems occur, you should run the HP C++ IVP separately to ensure the integrity of the installed files. To run the IVP, enter the following command:
$ @SYS$TEST:CXX$IVP.COM |
If any problems are encountered, a message such as the following appears:
HP C++ VERSION 7.n Installation Verification Procedure Failed HP C++ VERSION 7.n Installation Verification did not run HP C++ VERSION 7.n Installation Verification ABORTED |
You must edit the system-wide 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, so 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:
$ @SYS$MANAGER:STARTNET.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.6). Then perform the following steps after you install HP C++:
$ INSTALL INSTALL> LIST SYS$SYSTEM:CXX$COMPILER.EXE |
INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE |
INSTALL> REPLACE SYS$SYSTEM:CXX$COMPILER.EXE |
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 |
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.
Use the OpenVMS Authorize Utility from a suitably privileged account to change the process quotas in the user authorization file (UAF). Some sites may restrict the use of the Authorize Utility to certain accounts or people.
After the quotas for the account have been changed, the user should log out of the account and log in again for the new quotas to take effect.
For information on using the Authorize Utility, see the OpenVMS System Manager's Manual: Essentials.
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, Determine the number of available global pagelets and global sections on your system. You will need to increase them. Section 1.7.4 contains guidelines for showing and setting these parameters.
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 lists the files that are added to or updated on your OpenVMS system during installation. Note that some files may not be installed depending on selected options or your system's configuration or operating system version.
SYS$SYSTEM:CXX$COMPILER.EXE [new] SYS$MESSAGE:CXX$COMPILER_MSG.EXE [new] SYS$COMMON:[CXX$LIB]CXX$CLD.CLD [new] SYS$LIBRARY:CXXL$ANSI_DEF.TLB [new] SYS$SYSTEM:CXX$LINK.EXE [new] SYS$MESSAGE:CXX$LINK_MSG.EXE [new] SYS$SYSTEM:CXX$DEMANGLE.EXE [new] SYS$HELP:[CXX$HELP]*.* [new] SYS$HELP:CXX.RELEASE_NOTES [new] SYS$HELP:CXX_RELEASE_NOTES.PS [new] SYS$TEST:CXX$IVP.COM [new] SYS$LIBRARY:DCLTABLES.EXE [modified] SYS$HELP:HELPLIB.HLB [modified] |
This appendix lists the more common diagnostic messages you might see during product installation. If you encounter a message not shown here, use the HELP/MESSAGE command to display information about it. If you add the /LOG qualifier to the PRODUCT INSTALL command, many additional informational messages will be displayed, which can be ignored.
FAILCONF, failed to resolve conflicting requirements for 'object-type'
'object-name'
Explanation: More than one product supplies a managed object of the same
name, type, and scope. They cannot coexist because of a
conflict in the objects' properties. Files, directories, and
library modules are examples of managed objects.
User Action: Report the problem to HP.
INSTALLERR, error executing DCL INSTALL command
Explanation: The POLYCENTER Software Installation utility installs a file
as a known image by having the DCL command INSTALL execute in
a subprocess. The INSTALL command failed.
User Action: Take action based on the accompanying messages. If you specify
the /TRACE qualifier when you retry the operation, you can
view the command sent to the subprocess.
IVPFAILURE, test procedure completed with an error status
Explanation: The installation verification test procedure for the product
completed with an exit status that indicates a failure. If you
were executing a PRODUCT INSTALL command, the product has been
completely installed, but its test procedure failed.
User Action: Take action based on the accompanying messages. If you specify
the /TRACE qualifier when you retry the operation, you can
view the commands sent to the subprocess and the output
generated when these commands are executed.
RETAIN, 'object' 'object-name' was not replaced because 'object'
from kit does not have higher generation number
Explanation: During installation of a software product (or a patch to
a software product), the specified object (either a file
or a library module) was not copied from the kit to the
destination disk. The installation utility found an object
with the same name already installed on the destination disk
and that object's generation (sequencing) number was the same
or greater than the generation number of the object from the
kit. Therefore, the object with the latest generation number
(the previously installed item) was left on your destination
disk.
This condition typically occurs when you install multiple
patches or updates to the same product. The installation
utility performs conflict detection and resolution so that
your system will always retain the most current files even if
updates are not installed in chronological order.
User Action: None.
|
| Contents |