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

Compaq C++
Installation Guide for OpenVMS VAX


Previous Contents

1.3.7.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 pages 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 disconnected immediately 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.3.7.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 CLISYMTBL value to 500:


$ RUN SYS$SYSTEM:SYSGEN
SYSGEN> USE ACTIVE
SYSGEN> SET CLISYMTBL 500
SYSGEN> WRITE ACTIVE
SYSGEN> EXIT


Chapter 2
Installing Compaq C++ for OpenVMS VAX

After you register and load the License Product Authorization Key (License PAK), the installation takes approximately 5 to 30 minutes depending on your system configuration and the kit components chosen.

2.1 Installing the OpenVMS Version 6.0 Debugger

This section explains how to install the OpenVMS Version 6.0 Debugger on systems running OpenVMS VAX Version 5.5-2. This procedure does not apply to systems already running OpenVMS VAX Version 6.0 or higher.

The OpenVMS Version 6.0 Debugger has its own installation kit stored on the same media as the Compaq C++ installation kit and must be installed as a separate step before installing the compiler if the installing system is running a version of OpenVMS VAX lower than Version 6.0. If your installation medium is tape, install the OpenVMS Debugger before the Compaq C++ compiler to avoid errors when installing the compiler kit.

Note

If you try to install the OpenVMS Version 6.0 Debugger kit on a system running Version 6.0 or higher, the installation will fail.

This section contains excerpts from the installation procedure and explains each step. Defaults appear in brackets ([]) throughout the installation procedure.

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 then returns you to DCL level. If you want to retry the installation after pressing Ctrl/Y, you must proceed from step 2.

  1. Log in to a privileged account and set your default device and directory to SYS$UPDATE.


    Username: SYSTEM
    Password: 
    $ SET DEFAULT SYS$UPDATE
    

  2. Invoke VMSINSTAL.
    This example invokes VMSINSTAL to install the OpenVMS Version 6.0 Debugger using the N option and shows the system response.


    $ @VMSINSTAL DBG060 MUA0: OPTIONS N
          OpenVMS VAX Software Product Installation Procedure Vn.n
    It is dd-mmm-yyyy at hh:mm.
    Enter a question mark (?) at any time for help.
    * Are you satisfied with the backup of your system disk [YES]? [Return]
    

    If you are satisfied with the backup of your system disk, press Return. Otherwise, type NO and press Return to discontinue the installation.

  3. Insert the installation kit volume.


    Please mount the first volume of the set on MUA0:.
    * Are you ready? YES
    The following products will be processed:
      DBG V6.0
        Beginning installation of DBG V6.0 at hh:mm
    %VMSINSTAL-I-RESTORE, Restoring product save-set A...
    

    To indicate that you want to continue the installation, mount volume 1, type YES, and press Return.

  4. Select a release notes option.
    This step applies only if you specified OPTIONS N in step 2.


    Release Notes Options:
        1. Display release notes
        2. Print release notes
        3. Both 1 and 2
        4. Copy release notes to SYS$HELP
        5. Do not display, print, or copy release notes
    * Select option [2]: 
    

    If you select option 1, VMSINSTAL displays the release notes on line immediately. To terminate the display at any time, press Ctrl/C.
    If you select option 2 (the default), VMSINSTAL prompts you for a queue name. You can then type a queue name or press Return, which sends the file to the default output print device.


    * Queue name [SYS$PRINT]: CLUSTER_PRINT
    

    If you select option 3, VMSINSTAL displays on line the release notes immediately. To terminate the display at any time, press Ctrl/C. VMSINSTAL prompts you for a queue name for printing the release notes. Either type a queue name or press Return to send the file to the default output print device. The OpenVMS Version 6.0 Debugger release notes are then copied to SYS$HELP:DBG060.RELEASE_NOTES.
    If you select option 4, VMSINSTAL copies the release notes to SYS$HELP immediately.
    If you select option 5, VMSINSTAL does not display, print, or copy the release notes, but moves them to SYS$HELP. Typically, you select this option when you want to end the installation.
    Next, VMSINSTAL displays the following prompt:


    * Do you want to continue the installation [N]?: YES
    %VMSINSTAL-I-RELMOVED, The product release notes have been 
        successfully moved to SYS$HELP.
    

    If you want to continue the installation, type YES and press Return. If you type NO or press Return, VMSINSTAL discontinues the installation. In either case, VMSINSTAL moves the release notes to SYS$HELP.

  5. Select the Installation Verification Procedure (IVP) options.
    You are asked two questions about running the IVP. The first allows you to run the IVP for the character-cell debugger. The second allows you to run the DECwindows Motif IVP.


    * Do you want to run the IVP after the installation [YES]?
    * Do you want to run the interactive DECwindows Motif IVP [NO]?
    

    The purpose of the IVP is to verify that the installation was successful. If the IVP determines that you have insufficient quotas to run the IVP, you are notified about which quotas need to be increased. The procedure then asks if you want to complete the installation without running the IVP. Press Return to run the IVP after the installation. If you do not want to run the IVP, type NO and press Return.
    The DECwindows Motif IVP defaults to NO. If you want to run this IVP, type YES and press Return.

  6. Select installation options.


    * Do you want to purge files replaced by this installation [YES]?
    

    The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, SYS$STARTUP, and SYS$SYSTEM contain older versions of OpenVMS Debugger files. Some of these files are replaced during the installation with new files, and the following files are deleted because they would prevent the OpenVMS Version 6.0 Debugger from working:

    SYS$HELP:DBG$DSHELP.HLB
    SYS$HELP:DBG$DSUIHELP.HLB

    The old files are not automatically purged. Purging is recommended. To purge the old files, press Return at the prompt. If you want to keep the old files, type NO and press Return.
  7. Read the informational messages.
    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 is succeeding, VMSINSTAL moves new or modified files to their target directories.
    A successful installation is indicated by the following message:


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

    If you typed YES in response to the prompt that requests a file purge at step 6, previous versions of the OpenVMS Version 6.0 Debugger files are now purged.

  8. Observe the IVP.
    If you chose to run the IVP in step 5, VMSINSTAL calls the IVP to verify that the OpenVMS Version 6.0 Debugger was installed successfully.


    **************************************************************************** 
    *                                                                          * 
    *           Beginning the Debug V6.0 Verification Procedure                * 
    *                                                                          * 
    **************************************************************************** 
     
    **************************************************************************** 
    *                                                                          * 
    *                  Debug verification procedure successful                 * 
    *                                                                          * 
    **************************************************************************** 
    

    If you chose in step 5 to run the interactive DECwindows Motif IVP by answering YES, the procedure first checks to see that a suitable DISPLAY is defined and available on which to bring up the windows. It then displays the following message and instructions:


    **************************************************************************** 
    *                                                                          * 
    *           Beginning the Debug V6.0 Verification Procedure                * 
    *            using the Motif Windows User Interface                        * 
    *                                                                          * 
    **************************************************************************** 
    %DBG-I-IVP, The IVP will display on _WSA1: 
     
        When the windows come up, do the following: 
        -  Go to the command window and click on the STEP button twice. 
        -  Pull down the FILE menu and click on EXIT. 
        -  Click the OK button to exit the debugger. 
     
    

    When you complete the final step from the previous example, the IVP completes and displays the following message:


    %DBG-S-IVP, The IVP has completed. 
     
            Installation of DBG V6.0 completed at hh:mm 
    

    If a DISPLAY is not available, the following message appears and the IVP exits:


    This machine is not a workstation.  Skipping display-oriented tests. 
    

  9. End the installation procedure.


       Installation of DBG V6.0 completed at hh:mm
       VMSINSTAL procedure done at hh:mm
    $ LOGOUT
    SYSTEM     logged out at dd-mmm-yyyy hh:mm
    

    VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager account and you want to restore these symbols, you should log out and log in again.

The file DEBUG$STARTUP.COM contains commands to install the OpenVMS Version 6.0 Debugger images.

OpenVMS Version 6.0 Debugger Files

The installation procedure puts the following files in the following directories on the system:
Directory File Name
SYS$LIBRARY DEBUG.EXE
DEBUGSHR.EXE
DEBUGUISHR.EXE
TRACE.EXE
DEBUGUIL.UID
   
SYS$HELP DBG$HELP.HLB
DBG$DW$HELP.HLB
   
SYS$MESSAGE DBGTBKMSG.EXE
   
SYS$TEST DBG$IVP.COM
IVP_IMAGE.PAS
IVP_IMAGE.EXE
IVP_SCRIPT.TST
IVP_SCRIPT.OUT_OLD

2.2 Installing the Compaq C++ for OpenVMS VAX Compiler

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.

When the system prompts you with a question during the installation procedure, the default answer is often listed in brackets ([]).

  1. Log in to a privileged account and set your default device and directory to SYS$UPDATE.


     Username: SYSTEM
     Password:
     
    

  2. Invoke VMSINSTAL.

    @SYS$UPDATE:VMSINSTAL saveset-name device-name option-list


    To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. The elements that you specify when you invoke the VMSINSTAL command procedure are as follows:

    saveset-name

    The installation name for the component. For Compaq C++ for OpenVMS VAX, use the following installation name:


    CXX05n
    

    n represents the minor (point) release number for Compaq C++ for OpenVMS VAX.
    To obtain the save-set name, enter a DIRECTORY command specifying the directory file from the previous command:


    $ DIRECTORY DKA400:[CXX05n.KIT]CXX05n.A
    

    n represents the minor release of Compaq C++ for OpenVMS VAX.

    device-name

    The name of the device on which you plan to mount the media and the directory containing the Compaq C++ for OpenVMS VAX save set. For example, DKA400: is the device name used in examples in this guide. The directory is [CXX05n], where n is the minor release number.
    To specify the device name on the @VMSINSTAL command line, enter:


    DKA400:[CXX05n]
    

    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 DEC C++ for OpenVMS VAX Release Notes are copied automatically to the SYS$HELP directory.)
    • Alternative 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.

    The following example invokes VMSINSTAL to install Compaq C++ for OpenVMS VAX and shows the system response. This example uses the OPTIONS N release note option.


    $ @SYS$UPDATE:VMSINSTAL CXX05n DKA400:[CXX05n] OPTIONS N
     
          OpenVMS VAX Software Product Installation Procedure V6.1
     
    It is dd-mmm-yyyy at hh:mm.  
    Enter a question mark (?) at any time for help.
    

    If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure.
    When you invoke VMSINSTAL, it checks the following:


    VMSINSTAL then checks to determine whether any users are logged in to the system. If users are logged in, VMSINSTAL asks whether you want to continue the installation:


    * Do you want to continue anyway [NO]?  YES
    

    If you want to continue, enter YES. If you want to stop the installation, press Return.

  3. Confirm system backup.


    * Are you satisfied with the backup of your system disk [YES]?
    

    If you are satisfied with the backup of your system disk, press Return. Otherwise, enter NO to discontinue the installation. After you back up your system disk, you can restart the installation.
    If you omitted the device name on the VMSINSTAL command line, the following prompt appears:


    * Where will the distribution volumes be mounted: DKA400:[CXX05n]
    

    If this prompt appears, enter the name of the distribution (media) device and directory that contains the Compaq C++ for OpenVMS VAX kit (save set). For example, if the media is contained on a CD-ROM located on unit DKA400:, enter DKA400:[CXX05n] in reply to this question (where n is the minor version number).
    If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, or if you want to abort the installation for any other reason, press Ctrl/Y.

  4. Verify the product being installed.


     The following products will be processed: 
     
       CXX V5.n
     
         Beginning installation of CXX V5.n at hh:mm 
     
       %VMSINSTAL-I-RESTORE, Restoring product save set A... 
    

    The product name and version are displayed. This save set (A) is restored to a subdirectory of SYS$UPDATE:.
    %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.
    The release notes are copied to the following files in the SYS$HELP directory (where n is the minor version number):


    SYS$HELP:CXX05n.RELEASE_NOTES
    SYS$HELP:CXX05n_RELEASE_NOTES.PS 
    

    After the installation, you can enter the following command to view the location of the release notes through the Help facility:


    $ HELP CXX RELEASE_NOTES
    

    Note

    The name of the release notes file (installed by VMSINSTAL) consists of the current product name and version number.
  5. Purge files.


    * Do you want to purge files replaced by this installation [YES]? YES
    

    The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, SYS$SYSTEM, and SYS$TEST may contain previous versions of Compaq C++ files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press Return or enter YES and press Return to purge the files. To keep the files, enter NO and press Return.

  6. Respond to license registration queries.
    The Compaq C++ for OpenVMS VAX compiler component supports the OpenVMS License Management Facility (LMF). If you entered YES to install the compiler component, the installation procedure displays license information about Compaq C++ for OpenVMS VAX. 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:


        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.n
          Release Date: dd-mmm-yyyy 
    


    * Does this product have an authorization key registered and 
    loaded?: YES
    

    If you have not registered and loaded your PAK, you must answer NO to this question. You have to register and load your PAKs to successfully complete the installation (see Section 1.1). If you have not done so, you should stop the installation, register and load your PAKs, and then restart the installation.

  7. Choose the Installation Verification Procedure (IVP) option.
    If you have chosen to install the compiler component, the installation procedure now asks if you want to run the IVP.


        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]? 
    

    After the Compaq C++ for OpenVMS VAX compiler is installed, you can run the IVP independently to verify that the software is available on your system. You might need to run the IVP after a system failure to make sure that the users can access the Compaq C++ for OpenVMS VAX compiler.

  8. Read informational messages.
    The installation procedure now 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: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] 
    

    The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new versions of the Compaq C++ for OpenVMS VAX help text (module CXX$HELP.HLP) and the CXX command-line definition.
    The end of the installation is indicated by the following message:


    Previous Next Contents
      

    1.800.AT.COMPAQ

    privacy and legal statement