|
|
|
|
| Updated: 21 April 1999 |
Compaq C++Installation Guide for OpenVMS AlphaOrder Number: AA-PY27G-TE
April 1999
This guide contains instructions for installing Compaq C++ on OpenVMS Alpha systems. It also explains how to read the online release notes before or after installing the product. Revision/Update Information: This is a revised manual, replacing AA-PY27F-TE
Operating System & Version:
OpenVMS Alpha Version 6.2 to 7.2
Software Version: Compaq C++ Version 6.2 to 7.2 for OpenVMS Alpha
Compaq Computer Corporation
First Printing, June 1993 Second Printing, May 1995 Third Printing, May 1996 Fourth Printing, January 1997 Fifth Printing, July 1997 Sixth Printing, January 1999 Seventh Printing, April 1999 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. ©1992-1999 Digital Equipment Corporation Compaq, the Compaq logo, Alpha, DEC, DECwindows, DIGITAL, OpenVMS, VAX, VMS are registered in the U.S. Patent and Trademark Office. The following are third-party trademarks: Motif is a registered trademark of Open Software Foundation Incorporated. PostScript is a registered trademark of Adobe Systems Incorporated. Other product names mentioned herein may be the trademarks of their respective companies. This document is available on CD-ROM.
PrefaceThis guide describes how to install Compaq 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 Compaq C++ for any reason. You may send comments or suggestions concerning this guide, or any Compaq C++ document, by electronic mail to the following Internet address:
Document StructureThis guide contains three chapters and three appendixes:
Associated DocumentationIn addition to this guide, the Compaq C++ Version 6.2 documentation set includes the following books:
For information on the Compaq 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.
Chapter 1
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Optional Product | Purpose |
|---|---|
| DEC Language-Sensitive Editor (LSE) Version 4.0 or higher | Formatted language constructs simplify editing source programs. Support for C++ requires that LSE be installed before the compiler is installed. |
This section discusses settings that you should check to be sure that
your system is ready for the installation of Compaq C++ to proceed.
1.1.1 Process Privileges
To install Compaq C++, you must be logged in to an account that has SETPRV or at least the following privileges:
VMSINSTAL turns off BYPASS privileges at the start of the installation.
1.1.2 Process Account Quotas
VMSINSTAL requires that the installation account have minimum quotas as shown in Table 1-2.
| 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 Subkit.
1.1.3 System Parameters
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 | 6300 | 6300 |
| GBLPAGFIL | 1024 | 1024 |
| GBLSECTIONS 2 | 2 | 2 |
Requirements for free disk storage space are different during installation and after installation. Table 1-4 summarizes the storage requirements.
| Component | Blocks After Installation | Peak During Installation |
|---|---|---|
| Compiler | 58,000 | 82,000 |
| Text Header Files | 13,000 | 13,000 |
| CXXLINK | 500 | 500 |
| Debugger | 15,500 | 79,500 |
| All Components | 87,000 | 151,000 |
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. Compaq 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 Subkit.
1.1.6 Additional System Maintenance Procedures
This section explains how to use the System Generation Utility (SYSGEN)
and the AUTOGEN Utility to prepare your system for an installation of
Compaq C++. AUTOGEN uses system configuration data to automatically
set system parameters.
1.1.6.1 Checking System Parameter Values
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.1.6.4.
1.1.6.2 Calculating the Values for Global Pagelets and Global Sections
To install and run Compaq 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:
$ 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 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-3, 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-3, you must increase the system parameter setting.
Section 1.1.6.3 describes the procedures for increasing these values using
AUTOGEN.
1.1.6.3 Changing System Parameter Values with 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.
1.1.6.4 Setting Dynamic System Parameter Values
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.
2.1 Installation Procedure
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 Compaq C++, use the following installation name:
CXX06n
n represents the minor (point) release number for Compaq C++.
To obtain the directory location of the Compaq 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:[CXX06n.KIT]CXX06n.A
n represents the minor release of Compaq C++.device-name
The name of the device on which you plan to mount the media and the directory containing the Compaq C++ save set. For example, DKA400: is the device name used in examples in this guide. The directory is [CXX06n], where n is the minor release number.
To specify the device name on the @VMSINSTAL command line, enter:
DKA400:[CXX06n]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 Compaq 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 CXX06n DKA400:[CXX06n] OPTIONS N
OpenVMS AXP Software Product Installation Procedure V6.2
It is dd-mmm-yyyy at hh:mm.
Enter a question mark (?) at any time for help.
|
Verify user's account and quotas
When you invoke VMSINSTAL, it checks the following:
* Do you want to continue anyway [NO]? YES |
Confirm system backup
* Are you satisfied with the backup of your system disk [YES]? |
Specify distribution
If you omitted the device name on the VMSINSTAL command line, the
following prompt appears:
* Where will the distribution volumes be mounted: DKA400:[CXX06n] |
Specify save set
If you omitted the product save set name on the VMSINSTAL command
line, the following prompt appears:
Enter the products to be processed from the first distribution
volume set.
* Products: CXX06n
|
Verify the product being installed
The following products will be processed:
CXX V6.n
Beginning installation of CXX V6.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.
Compaq C++ V6.n for OpenVMS Alpha Systems
|
SYS$HELP:CXX06n.RELEASE_NOTES SYS$HELP:CXX06n_RELEASE_NOTES.PS |
$ HELP CXX RELEASE_NOTES |
The name of the release notes file (installed by VMSINSTAL) consists of the current product name and version number. |
Choose the Installation Verification Procedure option
If you have chosen to install the compiler component, the
installation procedure now asks if you want to run the Installation
Verification Procedure (IVP). The IVP checks to be sure that the
installation is successful. Compaq recommends that you run the IVP.
* Do you want to run the IVP after the installation [YES]? |
Select components to install
The installation procedure lets you select the components of the
kit that you want to install. The choices are as follows:
SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_HXX] SYS$COMMON:[CXX$LIB.REFERENCE.CXXL$DEF_H] SYS$COMMON:[CXX$LIB.REFERENCE.DECC$RTLDEF_HXX] SYS$COMMON:[DECC$LIB.REFERENCE.DECC$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. |
Respond to license registration query
The Compaq C++ compiler component supports the OpenVMS License
Management Facility (LMF). (For complete information on using the LMF,
see the OpenVMS License Management Utility Manual.) If you entered YES to install the compiler
component, the installation procedure displays license information
about Compaq C++. It asks whether you have registered and loaded your
PAK for each product. The following is an example of the information
and the queries presented by the installation procedure:
The Compaq C++ compiler component requires a Product
Authorization Key (PAK) for Compaq 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: 6.n
Release Date: dd-mmm-yyyy
|
* Does this product have an authorization key registered and loaded?: YES |
Read informational messages
At this point, the installation procedure displays a number of
informational messages that report on the progress of the installation.
There are no further questions. If the installation procedure has been
successful up to this point, VMSINSTAL moves the new or modified files
to their target directories, updates help files, and updates DCL
tables, if necessary. The new files include the following:
SYS$HELP:CXX06n.RELEASE_NOTES [new] SYS$HELP:CXX06n_RELEASE_NOTES.PS [new] SYS$TEST:CXX$IVP.COM [new] SYS$TEST:CXX$IVP_C.COM [new] |
SYS$SYSTEM:CXX$COMPILER.EXE [new] SYS$MESSAGE:CXX$COMPILER_MSG.EXE [new] SYS$HELP:HELPLIB.HLB [modified] SYS$COMMON:[SYSHLP.CXX$HELP]*.* [new] SYS$LIBRARY:DCLTABLES.EXE [modified] |
SYS$LIBRARY:DECC$RTLDEF.TLB [new] SYS$LIBRARY:DECC$RTLDEF_HXX.TLB [new] SYS$LIBRARY:CXXL$DEF_HXX.TLB [new] SPS$LIBRARY:CXXL$DEF_HXX.TLB [new] |
%VMSINSTAL-I-MOVEFILES, files will now be moved to their target
directories...
|
Observe the IVP
If you chose to run the IVP, VMSINSTAL now invokes the IVP to
verify that Compaq C++ was installed successfully.
If
Compaq C++ was installed successfully, the IVP displays the following:
Compaq C++ V6.n Installation Verification Procedure completed
successfully.
|
End the installation procedure
Installation of CXX V6.n completed at hh:mm
Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY
Creating installation data file: VMI$ROOT:[SYSUPD]CXX062.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 Compaq C++
Version 5.n has failed.
|
If the IVP fails, you will see these messages:
The Compaq C++ Version 5.n Installation
Verification Procedure failed.
%VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++
Version 5.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 a Compaq field service representative.
Compaq 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 Compaq C++ is installed:
The following sections describe these tasks in detail.
3.1 Running the Installation Verification Procedure Separately
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 Compaq C++ Version 6.2 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++ Version 6.2 has failed. |
You do not need to edit the compiler system startup and shutdown files
to provide for automatic startup and shutdown of Compaq C++ when your
system is rebooted.
3.3 VMScluster Considerations
After completing the initial installation, if you want to install Compaq 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.
3.4 User Account Requirements
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 Compaq C++.
3.4.1 User Privileges
To use Compaq 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.
3.4.2 User Account Quotas
To use Compaq 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.1.2 for a description of how to verify and change account
quotas.
3.4.3 Installing the Compaq C++ Compiler and the C++ Class Library as a Shared Image
Compaq highly recommends that you reduce the system overhead and memory requirements by installing the Compaq C++ compiler and the C++ Class Library as shared images. To install Compaq C++ as a shared image on a system that is currently running, use the INSTALL Utility. Compaq recommends that you install Compaq 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 Compaq 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 Compaq 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 Compaq 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 Compaq C++ as a shared image you need to increase
the global pagelets and global sections parameters. See Section 1.1.3
for information on changing these parameters.
3.5 Getting Help and Reporting Problems
If an error occurs while Compaq C++ is in use and you believe the error is caused by a problem with the product, please report it to Compaq.
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 Compaq 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 Compaq C++ documentation to the following Internet address:
cxx_docs@bookie.enet.dec.com
To obtain information about purchasing a Software Product Services Support Agreement or other support services, please contact your local Compaq sales representative or business partner.
A special C++ debugger is provided with the Compaq C++ Version 6.2 kit and must be installed to debug programs compiled with Compaq C++ Version 6.2.
The special C++ debugger is an early copy of the standard OpenVMS debugger that will ship in a future release after OpenVMS Alpha Version 7.2 and provide full support for languages other than C++. The installation of this debugger kit does not replace the debugger supplied with the operating system. Thus, you can use either debugger after installation. Special steps must be taken if you want the special C++ debugger to be the default debugger on your system.
In an OpenVMS release after Version 7.2, the debugger that is shipped with the operating system will support the new C++ capabilities. If you are using an OpenVMS release after Version 7.2, please consult the OpenVMS New Features manual to determine if it is necessary to install the debugger shipped with C++. |
If you install the debugger on a version of the operating system that
does not have DECwindows Motif installed, or on a system that has a
version of DECwindows Motif prior to Version 1.2-4, the C++ debugger's
Graphic User Interface (GUI) image will not be installed. If you decide
later to install Motif, or to upgrade Motif to Version 1.2-4, and you
then want to use the debugger's GUI, you should then reinstall the C++
debugger, to create the debugger's GUI image.
4.1 Installing the Debugger
The C++ debugger must be installed in addition to the compiler. The installation procedure is similar to that for the compiler kit; to install the debugger, invoke the VMSINSTAL command procedure, as described in Section 2.1. The saveset-name for the debugger kit is ADX072. The other parameters to VMSINSTALL should be the same as specified when installing the compiler kit. For example:
@SYS$UPDATE:VMSINSTAL ADX072 device-name option-list |
The way in which the ADX072 kit links debugger images at VMSINSTAL time depends on the version of OpenVMS Alpha installed on your system. The ADX072 debugger linked with Version 6.n of OpenVMS Alpha does not function properly on Version 7.n systems. For example, if you install ADX072 on a Version 6.2 system and that system is later upgraded to Version 7.2, the ADX072 debugger will function improperly until you reinstall ADX072. |
The installation of this debugger kit does not replace the debugger supplied with the operating system. After installing the C++ debugger, you need to invoke a command procedure to install the C++ debugger images and define the default system debugger.
If you want the special C++ debugger to be the default debugger for the system, you should do the following from a privileged account, after installing the ADX072 kit:
@SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X |
$ COPY DECW$SYSTEM_DEFAULTS:CXXVMSDEBUG.DAT -
DECW$SYSTEM_DEFAULTS:VMSDEBUG.DAT
|
If you do not want the special C++ debugger to be the default debugger for the system, enter the following command from a privileged account and add it to the system startup procedure (SYS$STARTUP:SYSTARTUP_VMS.COM):
@SYS$STARTUP:DEBUG$STARTUP.COM VMS |
Regardless of which debugger you select as the default system debugger, individual users can choose the other debugger. See the release notes for more information.
This appendix contains a sample installation for the Compaq C++ kit. This 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 Compaq 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.
The following sample was installed on a system where Compaq C++ was not previously installed. 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 Compaq C++ Version 6.2 on an OpenVMS Alpha system.
| Example A-1 Sample Compaq C++ Installation on OpenVMS Alpha | ||||||
|---|---|---|---|---|---|---|
$ @sys$update:vmsinstal
OpenVMS AXP Software Product Installation Procedure V6.2
It is 6-APR-1999 at 17:30.
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:[CXX062]
Enter the products to be processed from the first distribution volume set.
* Products: CXX062
* Enter installation options you wish to use (none): N
The following products will be processed:
CXX V6.2
Beginning installation of CXX V6.2 at 17:30
%VMSINSTAL-I-RESTORE, Restoring product save set A ...
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.
Compaq C++ Version V6.2 for OpenVMS Alpha Systems
Copyright Digital Equipment Corporation 1993-1999. All rights reserved.
Restricted Rights: Use, duplication, or disclosure by the U.S.
Government is subject to restrictions as set forth in subparagraph
(c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR
52.227-14 Alt. III, as applicable.
This software is proprietary to and embodies the confidential
technology of Digital Equipment Corporation. Possession, use, or
copying of this software and media is authorized only pursuant to a
valid written license from Digital or an authorized sublicensor.
* Do you want to purge files replaced by this installation [YES]? Y
This kit contains an Installation Verification Procedure
(IVP) to verify the correct installation of the
Compaq 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 Compaq 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 Compaq C++ kit contains four components:
Compiler (includes help text, command definition, IVP)
C Runtime Library Header files (includes OpenVMS system
symbol definitions)
C++ Class Library Header files
CXXLINK facility
If you want a more detailed description of any component that
you are prompted for, answer with a question mark "?"; after
the explanation is displayed, you will be prompted again for
a response.
* Do you want to install the compiler component [YES]? Y
The C RTL is always provided.
The C++ Class Library headers are always provided.
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:[DECC$LIB.REFERENCE...] for the C RTL
header library, DECC$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
* Do you want to install the CXXLINK facility? [YES]? Y
The Compaq C++ compiler component requires a Product
Authorization Key (PAK) for Compaq 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: 6.2
Release Date: 02-APR-1999
* Does this product have an authorization key registered and loaded? Y
All questions and validations regarding the installation of Compaq C++
kit components have now been asked. Depending upon your configuration,
time estimates for the installation(s) are as follows:
Compiler: 1 minute
C RTL: 2 minutes
Class Library: 1 minute
CXXLINK: 1 minute
Moving files: 6 minutes
IVP: 2 minutes
Providing Startup Procedure
Please add the SYS$STARTUP:CCXX$STARTUP.COM to the system startup
procedure.
To use Compaq 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 and define system-wide logical names.
Your OpenVMS system will now be updated to include the following
new and modified file(s):
SYS$HELP:CXX062.RELEASE_NOTES [new]
SYS$HELP:CXX062_RELEASE_NOTES.PS [new]
SYS$TEST:CXX$IVP.COM [new]
SYS$SYSTEM:CXX$COMPILER.EXE [new]
SYS$LIBRARY:LIBCXXSTD.OLB [new]
SYS$MESSAGE:CXX$COMPILER_MSG.EXE [new]
SYS$LIBRARY:DCLTABLES.EXE [modified]
SYS$COMMON:[CXX$LIB]CXX$CLD.CLD [new]
SYS$HELP:HELPLIB.HLB [modified]
SYS$HELP:[CXX$HELP]CXX.HTML [new]
SYS$HELP:[CXX$HELP]INDEX.HTML [new]
SYS$HELP:[CXX$HELP]INDEX.HTM [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:DECC$CRTL.OLB [new]
SYS$LIBRARY:DECC$CRTL.EXE [new]
SYS$LIBRARY:DECC$CRTL.README [new]
SYS$LIBRARY:DECC$RTLDEF.TLB [new]
SYS$LIBRARY:CXXL$ANSI_DEF.TLB [new]
SYS$SYSTEM:CXX$LINK.EXE [new]
SYS$MESSAGE:CXX$LINK_MSG.EXE [new]
SYS$COMMON:[CXX$LIB]CXXLINK.CLD [new]
SYS$SYSTEM:CXX$DEMANGLE.EXE [new]
SYS$COMMON:[CXX$LIB]CXXDEMANGLE.CLD [new]
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
Beginning Compaq C++ Installation Verification Procedure
Copyright (c) Digital Equipment Corporation, 1999. All rights reserved.
Restricted Rights: Use, duplication, or disclosure by the U.S.
Government is subject to restrictions as set forth in subparagraph
(c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR
52.227-14 Alt. III, as applicable.
This software is proprietary to and embodies the confidential
technology of Digital Equipment Corporation. Possession, use, or
copying of this software and media is authorized only pursuant to a
valid written license from Digital or an authorized sublicensor.
Test compiler operation and error messages...
Test Class Library operation...
Compaq C++ V6.2 Installation Verification Procedure completed successfully
Installation of CXX V6.2 completed at 17:45
Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY
Creating installation data file: VMI$ROOT:[SYSUPD]CXX062.VMI_DATA
VMSINSTAL procedure done at 17:45
|
This appendix contains a sample installation for the C++ Debugger kit. This 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 Compaq 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.
The following sample was installed on a system where Compaq C++ was not previously installed. 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 B-1 shows a sample installation of the C++ defugger on an OpenVMS Alpha system.
| Example B-1 Sample C++ Debugger Installation on OpenVMS Alpha |
|---|
$ @sys$update:vmsinstal
OpenVMS AXP Software Product Installation Procedure V6.2
It is 6-APR-1999 at 16:10.
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:[INSTALL.CXX062]
Enter the products to be processed from the first distribution volume set.
* Products: ADX
* Enter installation options you wish to use (none): N
The following products will be processed:
ADX V72
Beginning installation of ADX V7.2 at 16:10
%VMSINSTAL-I-RESTORE, Restoring product save set A ...
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.
***********************************************************************
OpenVMS Alpha Debug V7.2X
COPYRIGHT (C) 1978, 1999 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD
MASSACHUSETTS. ALL RIGHTS RESERVED.
RESTRICTED RIGHTS: USE, DUPLICATION, OR DISCLOSURE BY THE U.S.
GOVERNMENT IS SUBJECT TO RESTRICTIONS AS SET FORTH IN SUBPARAGRAPH
(C) (1) (II) OF DFARS 252.227-7013, OR IN FAR 52.227-19, OR IN FAR
52.227-14 ALT. III, AS APPLICABLE.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE INCLUSION
OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER COPIES
THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY OTHER
PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY
TRANSFERRED.
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND
SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY DIGITAL.
***********************************************************************
This kit installs Debug version V7.2X. It will install on Alpha OpenVMS
V6.2 to V7.2 systems.
This kit requires an installed DCE for its client/server configurations
(see release motes). If DCE is not installed, the "server" portion of
the debugger cannot be linked and a warning is printed during the
installation, for example, "%ADX-W-LINKABORT, NO DEBUGSRVSHR linked,
SYS$LIBRARY:DCE$LIB_SHR missing (install DCE)". You can safely ignore
this message. The normal operation of the debugger is not affected,
however, the client/server mode will NOT be operational.
A new Heap Analyzer will be also installed on V7.1 or later systems.
If your system is later upgraded from V6 to V7 or if DCE or MOTIF are
later installed, then this kit MUST be rerun, i.e. the V7.2X debugger
MUST be reinstalled.
System Code Debugger features will NOT be installed as part of this kit,
use the system supplied debugger for that.
This installation will NOT replace your current OpenVMS system supplied
debugger. However, it will replace any previous versions of the V7.2X
debugger that may be installed AND it will remove any earlier network
kit debuggers, e.g. V71C.
This installation takes ~5 minutes.
* Do you want to run the IVP after the installation [YES]? Y
* Do you want to run the interactive DECwindows Motif IVP? [NO]? N
* Do you want to purge files replaced by this installation [YES]? Y
%ADX-I-DONEASK, No further questions will be asked during this installation.
%VMSINSTAL-I-RESTORE, Restoring product save set B ...
%VMSINSTAL-I-RESTORE, Restoring product save set C ...
%ADX-I-ENDRESTORE, All Debugger savesets have been restored.
%ADX-I-LINKING, Linking V6 images.
%ADX-I-LINKDONE, DEBUGSHR has been linked.
%ADX-I-LINKDONE, DEBUG has been linked.
%ADX-I-LINKDONE, DEBUGUISHR has been linked.
%ADX-W-LINKABORT, NO DEBUGSRVSHR linked, SYS$LIBRARY:DCE$LIB_SHR missing
(install DCE)
%ADX-I-LINKDONE, TRACE has been linked.
%ADX-I-CLEANUP, Cleanup has been performed.
%ADX-I-PROHELP, Providing Debugger Help files...
%ADX-I-PROMSG, Providing Debugger message image...
%ADX-I-PROMSG, Providing Debugger .CLD file...
%ADX-I-PROEXE, Providing Debugger files...
%ADX-I-PROMSG, Providing startup files ...
If you want the debugger installed by this kit to be the default system
debugger:
- Add add the following line to the system startup procedure:
$ @SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X
You should remove any other *DEBUG$STARTUP*.COM reference.
- Enter the following command from a privileged account:
@SYS$STARTUP:DEBUG$STARTUP_V72X.COM V72X
To install the images and define the default system debugger
on other Alpha nodes of a VMScluster, enter this command on
each such node. Note, however, that this is a /SYSTEM setup
(also see SYS$STARTUP:DEBUGSETUP.COM) and also modifies and
install/replaces your SYS$SHARE:DCLTABLES.EXE.
If you want the regular system debugger installed to be the default
system debugger, then do the same as above but use "VMS" as the input
parameter, for example:
@SYS$STARTUP:DEBUG$STARTUP_V72X.COM VMS
Users can also dynamically switch debuggers by using
SYS$STARTUP:DEBUGSETUP.COM. It's input options are VMS, V72X, V72,
V71C, or UNSET. It also needs the logical table switch /JOB or /SYSTEM.
For example:
@SYS$STARTUP:DEBUGSETUP.COM V72X /JOB
%ADX-I-PROIVP, Providing test files for IVP...
The Debugger IVP has been moved to the SYS$TEST directory. To run the
IVP after installation, first setup to use the V72X debugger by executing
the command "@SYS$STARTUP:DEBUGSETUP V72X /JOB" Then, run the character
cell IVP by executing the command "@SYS$TEST:DBG$IVP.COM" or, if
DECWindows Motif has been installed on your system, run the interactive
DECWindows Motif IVP by executing the command "
@SYS$TEST:DBG$DW$IVP.COM"
%ADX-I-INSTALLDONE, OpenVMS Alpha Debug V7.2X installation done
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
Beginning the Debug V7.2X Verification Procedure
COPYRIGHT (c) 1988, 1998 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS.
ALL RIGHTS RESERVED.
Debug verification procedure successful.
Installation of ADX V7.2 completed at 16:15
Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY
Creating installation data file: VMI$ROOT:[SYSUPD]ADX072.VMI_DATA
VMSINSTAL procedure done at 16:15
|
The Compaq C++ installation procedure installs and modifies a number of files on your system, as listed in Table C-1.
| File | New or Modified |
|---|---|
| SYS$HELP:CXX062.RELEASE_NOTES | new |
| SYS$HELP:CXX062_RELEASE_NOTES.PS | new |
| SYS$TEST:CXX$IVP.COM | new |
| SYS$SYSTEM:CXX$COMPILER.EXE | new |
| SYS$LIBRARY:LIBCXXSTD.OLB | new |
| SYS$MESSAGE:CXX$COMPILER_MSG.EXE | new |
| SYS$LIBRARY:DCLTABLES.EXE | modified |
| SYS$COMMON:[CXX$LIB]CXX$CLD.CLD | new |
| SYS$HELP:HELPLIB.HLB | modified |
| SYS$HELP:[CXX$HELP]CXX.HTML | new |
| SYS$HELP:[CXX$HELP]INDEX.HTML | new |
| SYS$HELP:[CXX$HELP]INDEX.HTM | 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_USERGUIDE.PS | new |
| SYS$HELP:[CXX$HELP]CXX_CLASSLIB.TXT | new |
| SYS$HELP:[CXX$HELP]CXX_USERGUIDE.TXT | new |
| SYS$STARTUP:CCXX$STARTUP.COM | new |
| SYS$LIBRARY:DECC$CRTL.OLB | new |
| SYS$LIBRARY:DECC$CRTL.EXE | new |
| SYS$LIBRARY:DECC$CRTL.README | new |
| SYS$LIBRARY:DECC$RTLDEF.TLB | new |
| SYS$LIBRARY:CXXL$ANSI_DEF.TLB | new |
| SYS$SYSTEM:CXX$LINK.EXE | new |
| SYS$MESSAGE:CXX$LINK_MSG.EXE | new |
| SYS$COMMON:[CXX$LIB]CXXLINK.CLD | new |
| SYS$SYSTEM:CXX$DEMANGLE.EXE | new |
| SYS$COMMON:[CXX$LIB]CXXDEMANGLE.CLD | new |
This appendix provides information to help you with failures or errors
that might occur during product installation or product use.
D.1 Failures During Compaq 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 Compaq C++ Version 6.2 has failed. |
If the IVP fails, you see these messages:
The Compaq C++ Version 6.2 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++ Version 6.2 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.
D.2 Problems During Compaq C++ Use
If you encounter a problem while using Compaq C++, see the Release Notes. If the problem is unresolved, report it to Compaq. Depending on the type of support you have and the nature of the problem, take one of the following actions:
| Contents |
 
 Legal |
||||||