United States    
COMPAQ
cxxtitle.gif (12116 bytes)
Compaq C++

Compaq C++
Installation Guide for OpenVMS VAX


Previous Contents


%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... 

If Compaq C++ for OpenVMS VAX was installed successfully, the IVP displays the following:


   Compaq C++ V6.2 Installation Verification Procedure completed successfully 


   Installation of CXX V5.n completed at hh:mm
 
   VMSINSTAL procedure done at hh:mm

Depending on whether you specified parameters on the VMSINSTAL command line, the * Products: prompt or the DCL prompt ($) may appear. If the * Products: prompt appears, you can return to the DCL prompt by pressing Ctrl/Z.
If you removed any media from the console drive before beginning the installation, you should replace it now.
VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the installation account (such as SYSTEM) and you want to restore these symbols, you should log out and log in again.

2.3 Error Recovery

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++ for OpenVMS VAX Version 5.n has failed. 

If the IVP fails, you will see these messages:


The Compaq C++ for OpenVMS VAX Version 5.n Installation Verification Procedure failed. 
 
%VMSINSTAL-E-IVPFAIL, The IVP for Compaq C++ for OpenVMS VAX 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.


Chapter 3
After Installation

Compaq C++ for OpenVMS VAX 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++ for OpenVMS VAX is installed:

The following sections describe these tasks in detail.

3.1 Running the Installation Verification Procedures Separately

You usually run the Installation Verification Procedures (IVPs) during installation. If you want to run the IVPs separately to ensure the integrity of installed files should system problems occur, use the following IVP command procedures:


$ @SYS$TEST:DBG$IVP.COM
$ @SYS$TEST:DBG$DW$IVP.COM
$ @SYS$TEST:CXX$IVP.COM

If an IVP fails for any reason, the following message is displayed:


Compaq C++ for OpenVMS VAX VERSION V5.n TEST FAILED 

3.2 Editing and Organizing System Files

To provide for automatic startup of Compaq C++ when your system is rebooted, add the command line that starts Compaq C++ for OpenVMS VAX to the system startup file, SYS$MANAGER:SYSTARTUP_VMS.COM. Compaq C++ for OpenVMS VAX cannot start until after the network has started. You must position this new command line after the line that invokes the network startup command procedure. The following example shows the network startup command line followed by the Compaq C++ for OpenVMS VAX startup command line:


$ @SYS$MANAGER:STARTNET.COM
     .
     .
     .
$ @SYS$STARTUP:CCXX$STARTUP.COM

You must invoke this command procedure to define the logical names that the compiler needs to find the Compaq C++ Class Library header source files.

Note

SYS$STARTUP:CCXX$STARTUP.COM starts the Compaq C++ for OpenVMS VAX compiler only. To activate the OpenVMS Version 6.0 Debugger you must execute SYS$STARTUP:DEBUG$STARTUP.COM. To invoke the Compaq C/C++ Run-Time Components, execute SYS$STARTUP:CRT$STARTUP.COM.

If you have a system logical name or one or more options files that point to the old linker and the old run-time libraries (RTLs) that resided in dev:[CXX$LIBRARY.SYSTEM]LINK.EXE and dev:[DECC$LIBRARY.CRTL]*.*, you should remove them. That linker is obsolete and the RTLs are made obsolete by the new Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX kit (or by your OpenVMS VAX system Version 6.0 or higher).

To let system users use the newly installed OpenVMS Version 6.0 Debugger kit, deactivate alternative versions of the OpenVMS Debugger that might have been installed by layered product kits. Remove the startup file, SYS$STARTUP:DEBUG$STARTUP.COM from the system startup file, SYS$STARTUP:SYSTARTUP_V5.COM. Also delete the following files to remove the obsolete DECset Debugger product from your system:


SYS$HELP:DBG$DSHELP.HLB 
SYS$HELP:DBG$DSUIHELP.HLB 
DECW$SYSTEM_DEFAULTS:DSDEBUG.DAT 
SYS$MESSAGE:DSDBGTBKMSG.EXE 
SYS$LIBRARY:DSDEBUG.EXE 
SYS$LIBRARY:DSDEBUGSHR.EXE 
SYS$LIBRARY:DSDEBUGUISHR.EXE 
SYS$LIBRARY:DSDEBUGUIL.UID 
SYS$STARTUP:DEBUG$STARTUP.COM 
SYS$STARTUP:DEBUGSETUP.COM 

The OpenVMS Version 6.0 Debugger .DAT file is VMSDEBUG.DAT. If your system has a customized DEBUG.DAT file used to configure the OpenVMS Debugger, copy DEBUG.DAT to SYS$LOGIN:VMSDEBUG.DAT so that the customizations are reflected upon starting up the Motif interface to the debugger.

3.3 VMScluster Considerations

After completing the initial installation, if you want to install Compaq C++ for OpenVMS VAX on multiple nodes in a cluster you must run INSTALL on each of the other nodes and enter the following commands:


INSTALL>  REPLACE SYS$LIBRARY:DCLTABLES.EXE
INSTALL>  REPLACE SYS$LIBRARY:DEBUG.EXE
INSTALL>  REPLACE SYS$LIBRARY:DEBUGSHR.EXE
INSTALL>  REPLACE SYS$LIBRARY:TRACE.EXE
INSTALL>  REPLACE SYS$MESSAGE:DBGTBKMSG.EXE

Execute CCXX$STARTUP.COM on all single-architecture (VAX only) clusters, that have a Compaq C++ license. To invoke OpenVMS Version 6.0 Debugger, execute DEBUG$STARTUP.COM. To invoke the Compaq C/C++ Run-Time Components, execute SYS$STARTUP:CRT$STARTUP.COM.

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++ for OpenVMS VAX.

3.4.1 User Privileges

To use Compaq C++ for OpenVMS VAX, 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++ for OpenVMS VAX, 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.3.3 for a description of how to verify and change account quotas.

3.5 Getting Help and Reporting Problems

If an error occurs while Compaq C++ for OpenVMS VAX 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:

  1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the Compaq C++ for OpenVMS VAX compiler being used. Demonstrate the problem with specific examples.
  2. Reduce the problem to as small a size as possible.
  3. Remember to include listings of any command files, INCLUDE files, or relevant data files, and so forth.
  4. Provide a listing of the program.
  5. If the program is longer than 50 lines, submit a copy of it on machine-readable media (diskette or magnetic tape). If necessary, also submit a copy of the program library used to build the application.
  6. Report only one problem per report. This will facilitate a faster response.
  7. Mail the problem report to Compaq.

If the problem is related to Compaq C++ for OpenVMS VAX 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++ for OpenVMS VAX documentation to the following Internet address:

cxx_docs@zko.dec.com

To obtain information about purchasing a Compaq Software Product Services Support Agreement or other support services, please contact your local sales representative.


Appendix A
Sample Installations

This appendix contains sample installations for each of the components on the Compaq C++ for OpenVMS VAX kit. These are only samples. Sometimes the installation procedure is modified in maintenance updates of this product.

Be sure to read the Read Before Installing or Using Compaq C++ Version 5.6C for OpenVMS VAX 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 samples were installed on an OpenVMS VAX system. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation.

These sample installations assume 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 the OpenVMS Version 6.0 Debugger on an OpenVMS VAX system.

Example A-1 Sample OpenVMS Version 6.0 Debugger Installation on OpenVMS VAX

@sys$update:vmsinstal dbg060 $disk1:[install_test.kits] options i
 
 
 VAX/VMS Software Product Installation Procedure V5.5-2 
 
 
It is 2-NOV-1999 at 15:12. 
 
Enter a question mark (?) at any time for help. 
 
%VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. 
%VMSINSTAL-W-ACTIVE, The following processes are still active: 
The following products will be processed: 
 
  DBG V6.0 
 
 
 Beginning installation of DBG V6.0 at 15:13 
 
%VMSINSTAL-I-RESTORE, Restoring product save set A ... 
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. 
 
      This kit installs Debug version V6.0C-000.  Note that it requires 
      at least OpenVMS VAX V5.4 and, at most, OpenVMS VAX V5.5-2.  If the 
      debugger's graphical user interface is to be used, it also requires 
      Motif V1.0 or later. 
 
     ********************************************************************* 
     *                                                                   * 
     *                                                                   * 
     *  THIS INSTALLATION WILL REPLACE YOUR CURRENT VMS SYSTEM DEBUGGER! * 
     *                                                                   * 
     *                                                                   * 
     ********************************************************************* 
 
      You should insure that you have saved the current version of the 
      system debugger by backing up the following files: 
 
                SYS$LIBRARY:DEBUG.EXE 
                SYS$LIBRARY:DEBUGSHR.EXE 
                SYS$LIBRARY:DBGSSISHR.EXE 
                SYS$LIBRARY:DEBUGUIL.UID 
                SYS$HELP:DBG$HELP.HLB 
                SYS$HELP:DBG$DWHELP.HLB 
                SYS$LIBRARY:TRACE.EXE 
                SYS$MESSAGE:DBGTBKMSG.EXE 
 
* Do you want to run the IVP after the installation [YES]? 
* Do you want to run the interactive DEC Windows Motif IVP? [NO]: 
* Do you want to purge files replaced by this installation [YES]? no
%DBG-I-DONEASK, No further questions will be asked during this installation. 
 
%DBG-I-ENDRESTORE, All Debugger savesets have been restored. 
%DBG-I-LINKDONE, DEBUGSHR has been linked. 
%DBG-I-LINKDONE, DEBUG has been linked. 
%DBG-I-LINKDONE, TRACE has been linked. 
%DBG-I-LINKDONE, DEBUGUISHR has been linked. 
%DBG-I-CLEANUP, Cleanup has been performed. 
%DBG-I-PROHELP, Providing Debugger Help files... 
%DBG-I-PRORES, Providing Resource file for Debugger visuals... 
%DBG-I-PROMSG, Providing Debugger message image... 
%DBG-I-PROEXE, Providing Debugger files... 
%DBG-I-PROIVP, Providing test files for IVP... 
****************************************************************************** 
*                                                                              * 
*  The Debugger IVP has been moved to the SYS$TEST directory.  To run          * 
*  the IVP after installation, enter @SYS$TEST:DBG$IVP.COM for the character   * 
*  cell IVP.  If DECWindows Motif has been installed on your system, enter     * 
*  @SYS$TEST:DBG$DW$IVP.COM for the interactive DECWindows Motif IVP.          * 
*                                                                              * 
****************************************************************************** 
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... 
******************************************************************************* 
*                                                                             * 
*            Beginning the Debug V6.0C Verification Procedure                 * 
*                                                                             * 
******************************************************************************* 
******************************************************************************** 
 
*                                                                              * 
 
*                   Debug verification procedure successful                    * 
 
*                                                                              * 
 
******************************************************************************** 
 
 Installation of DBG V6.0 completed at 15:21 
 
 
 VMSINSTAL procedure done at 15:21 

Example A-2 shows a sample installation of the Compaq C++ for OpenVMS VAX compiler Version 5.6C on an OpenVMS VAX system.

Example A-2 Sample Compaq C++ for OpenVMS VAX Installation

$ @sys$update:vmsinstal
 
        OpenVMS VAX Software Product Installation Procedure V7.1 
 
 
It is 2-NOV-1999 at 17:07. 
 
Enter a question mark (?) at any time for help. 
* Are you satisfied with the backup of your system disk [YES]? YES
* Where will the distribution volumes be mounted: DKA400:[CXX056]
 
Enter the products to be processed from the first distribution volume set. 
* Products: CXX056
* Enter installation options you wish to use (none): N
The following products will be processed: 
  CXX V5.6 
 
        Beginning installation of CXX V5.6C at 17:07 
 
%VMSINSTAL-I-RESTORE, Restoring product save set A ... 
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. 
 
    Compaq C++ Version V5.6 for OpenVMS VAX Systems 
 
  Copyright (c) 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]? YES
 
    Compaq C++ requires a Product Authorization Key (PAK) be registered and 
    loaded.  Answer the following question with YES if at least one 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,CXX-V-USER,CXX-V-G 
        Producer:     DEC 
        Version:      5.6 
        Release Date: 2-NOV-1999 
 
* Does this product have an authorization key registered and loaded? YES
 
    This kit contains an Installation Verification Procedure 
    (IVP) to  verify the correct  installation of the Compaq C++ 
    compiler.  The 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. 
 
* Do you want to run the IVP after the installation [YES]? YES
 
    All questions regarding the installation of Compaq C++ have been 
    asked.  The installation will now continue for 10 to 40 minutes 
    depending on your CPU type and the installation options you have chosen. 
 
    Providing  command support and HELP files 
 
    Providing compiler and message images 
 
    Providing .h headers in DECC$LIBRARY_INCLUDE: 
 
    Providing class library .h and .hxx headers in CXX$LIBRARY_INCLUDE: 
 
    File selection portion of installation is completed. 
 
    Your VMS system will now be updated to include the following new 
    and modified files: 
 
    SYS$HELP:CXX056.RELEASE_NOTES                                [new] 
    SYS$HELP:CXX056_RELEASE_NOTES.PS                             [new] 
    SYS$SYSTEM:CXX$COMPILER.EXE                                  [new] 
    SYS$MESSAGE:CXX$MSG_SHR.EXE                                  [new] 
    SYS$HELP:HELPLIB.HLB                                         [modified] 
    SYS$COMMON:[SYSHLP.CXX$HELP]*.*                              [new] 
    SYS$LIBRARY:DCLTABLES.EXE                                    [modified] 
    SYS$LIBRARY:DECC$RTLDEF.TLB                                  [new] 
    DECC$LIBRARY_INCLUDE:*.H                                     [new] 
    SYS$LIBRARY:DECC$RTLDEF_HXX.TLB                              [new] 
    SYS$LIBRARY:CXXL$DEF.TLB                                     [new] 
    SYS$LIBRARY:CXXL$DEF_HXX.TLB                                 [new] 
    CXX$LIBRARY_INCLUDE:*.H,*.HXX                                [new] 
    SYS$TEST:CXX$IVP.COM                                         [new] 
    SYS$STARTUP:CCXX$STARTUP.COM                                 [new] 
    SYS$HELP:CXX056.RELEASE_NOTES                                [new] 
    SYS$HELP:CXX056_RELEASE_NOTES.PS                             [new] 
    SYS$SYSTEM:CXX$COMPILER.EXE                                  [new] 
    SYS$MESSAGE:CXX$MSG_SHR.EXE                                  [new] 
    SYS$SYSTEM:CXX$DEMANGLE.EXE                                  [new] 
    SYS$SYSTEM:CXX$LINK.EXE                                      [new] 
    SYS$SYSTEM:CXX$LINK_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] 
    DECC$LIBRARY_INCLUDE:*.H                                     [new] 
    SYS$LIBRARY:CXXL$DEF_H.TLB                                   [new] 
    SYS$LIBRARY:CXXL$DEF_HXX.TLB                                 [new] 
    CXX$LIBRARY_INCLUDE:*.H,*.HXX                                [new] 
    SYS$TEST:CXX$IVP.COM                                         [new] 
    SYS$STARTUP:CCXX$STARTUP.COM                                 [new] 
    SYS$LIBRARY:CXXL$ANSI_DEF.TLB                                [new] 
    SYS$LIBRARY:LIBCXXSTD.OLB                                    [new] 
    SYS$LIBRARY:DECC$CRTL.OLB                                    [new] 
    SYS$LIBRARY:DECC$CRTL.EXE                                    [new] 
    SYS$LIBRARY:DECC$CRTL.README                                 [new] 
 
    Please add the SYS$STARTUP:CCXX$STARTUP.COM to the system startup 
    procedure (SYS$STARTUP:SYSTARTUP_V5.COM or SYSTARTUP_VMS.COM). 
 
    To use Compaq C++ for OpenVMS VAX on other VAX 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. 
 
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... 
 
    Beginning Compaq C++ Combined 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 headers... 
 
    Test Class Library operation... 
 
    Compaq C++ V6.2 Installation Verification Procedure completed successfully 
 
 Installation of CXX V5.6 completed at 17:26 
 
Enter the products to be processed from the next distribution volume set. 
* Products: ^Z 
        VMSINSTAL procedure done at 17:27 


Previous Next Contents
  

1.800.AT.COMPAQ

privacy and legal statement