United States    
COMPAQ
Compaq C/C++ Run-Time Component for OpenVMS VAX

Compaq C/C++ Run-Time Component for OpenVMS VAX
Reference and Installation Guide


Previous Contents


SYS$HELP:CRT06n.RELEASE_NOTES
SYS$HELP:CRT06n_RELEASE_NOTES.PS 
SYS$HELP:CRT06n_RELEASE_NOTES.DECW$BOOK 

Note

The name of the release notes file (installed by VMSINSTAL) consists of the current product name and version number.
  • Heed warning message about image dependency.
    The installation procedure now displays the following message:


        This kit  provides  new  versions  of  several  OpenVMS  VAX  standard 
        shareable   images  and  object  libraries  in  SYS$LIBRARY,  such  as 
        VAXCRTL.EXE,  CMA$RTL.EXE, and  SMGSHR.EXE.  These provide support for 
        several programming  capabilities provided by  OpenVMS VAX Version 6.0 
        for C, C++, and other languages. 
     
        ********************************************************************** 
        *                          W A R N I N G                             * 
        ********************************************************************** 
     
        Programs  that link  against the new  versions of any of  these files, 
        EVEN THOSE NOT WRITTEN IN Compaq C OR C++, will NOT run on older versions 
        of OpenVMS (V5.5-2 or earlier)  unless steps are taken to save the old 
        SYS$LIBRARY configuration or redistribute this kit to additional sites. 
        See Chapter 1 of the Compaq C/C++ Run-Time Components for OpenVMS VAX 
        Reference and Installation Guide for more details. 
      
        In  addition,  if you  update the system  version of  OpenVMS VAX, the 
        enhanced  versions of the new images and libraries may be overwritten 
        with  versions that lack the  enhanced support.  Be sure to reinstall 
        the Compaq C/C++ Run-Time Components kit after each OpenVMS VAX system 
        update. 
    

    VMSINSTAL now asks if you wish to continue with the installation.


    * Continue with the installation? [N]? YES
    

    If you have adequately saved your old system development environment as described in Section 1.2, enter YES and press Return. If you have not saved the old environment, you can abort the installation by pressing Return, save the environment, and then restart the installation.

  • Purge files.
    VMSINSTAL now asks you if you want to purge files replaced by the installation procedure.


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

    The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, and SYS$TEST may contain previous versions of Compaq C/C++ Run-Time Components files. These files are replaced during the installation with new files, but the old files are not automatically purged. 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.

  • Choose the Installation Verification Procedure option.
    VMSINSTAL 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.


    This kit contains an Installation Verification Procedure (IVP) to verify 
    the correct installation of the Compaq C/C++ Run-Time Components.  The IVP 
    will be placed in: 
     
       SYS$TEST:CRT$IVP.COM. 
     
    After the installation is complete, you can invoke the command file 
    at any time to reverify that the Compaq C/C++ Run-Time Components are 
    installed and working correctly. Answer YES to the next question 
    if you wish to run the IVP at the completion of this installation 
    procedure. 
    


    * Do you want to run the IVP after the installation [YES]? 
    

    After Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX 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 users can access Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX.

  • 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 files to their target directories. The new files include the following:


    SYS$HELP:CRT06n.RELEASE_NOTES                       [new] 
    SYS$HELP:CRT06n.RELEASE_NOTES.PS                    [new] 
    SYS$HELP:CRT06n.RELEASE_NOTES.DECW$BOOK             [new] 
    SYS$HELP:CRT060_REF_INST.PS                         [new] 
    SYS$HELP:CRT060_REF_INST.TXT                        [new] 
    SYS$HELP:CRT060_RBI.PS                              [new] 
    SYS$HELP:CRT060_RBI.TXT                             [new] 
    SYS$TEST:CRT$IVP.COM                                [new] 
    SYS$TEST:[CRT]CRT$ERR1.OBJ                          [new] 
    SYS$TEST:[CRT]CRT$ERR2.OBJ                          [new] 
    SYS$TEST:[CRT]CRT$IVP1.OBJ                          [new] 
    SYS$TEST:[CRT]CRT$IVP2.OBJ                          [new] 
    SYS$TEST:[CRT]CRT$IVP3.OBJ                          [new] 
    SYS$TEST:[CRT]CRT$IVP4.OBJ                          [new] 
    

    Also, if you answered YES in response to the prompt that requests a file purge at step 7, previous versions of the Compaq C/C++ Run-Time Components files are now purged.
    Additional components follow that are the primary functional components supplied by the kit. The actual functional components supplied will differ depending on: the OpenVMS VAX version your system is running, the layered products already installed on your system, and whether or not this is a reinstallation.
    VMSINSTAL displays the following reminder to invoke the CRT$STARTUP.COM command procedure:


    ********************************************************************** 
    *                         R E M I N D E R                            * 
    ********************************************************************** 
     
    If you are  installing on a  VMScluster, you  MUST execute the command 
    file  SYS$STARTUP:CRT$STARTUP.COM on all members of the  cluster after 
    installing the Compaq C/C++ Run-Time Components kit. 
     
    If you are  installing on an OpenVMS VAX system  prior to Version 6.0, 
    ensure that you invoke the  SYS$STARTUP:CRT$STARTUP.COM  startup  file 
    prior to  starting up any other  products in the system  startup file, 
    SYS$MANAGER:SYSTARTUP_V5.COM.  See Chapter 4 of the Compaq C/C++ Run-Time 
    Components for OpenVMS VAX  Reference and Installation Guide  for more 
    details on postinstallation operations. 
    

    The end of the installation is indicated by the following message:


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

  • Observe the IVP.
    If you chose to run the IVP (step 8), VMSINSTAL now invokes the IVP to verify that Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX was installed successfully.
    If Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX was installed successfully, the IVP displays the following:


    ** Compaq C/C++ Run-Time Components Installation Verification Procedure ** 
    ** Ending at hh:mm ** 
    

  • End the installation procedure.


       Installation of AACRT V6.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.

    3.2 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, Compaq C/C++ Run-Time Components Installation Aborted. 
    

    If the IVP fails, you will see this message:


    ** Compaq C/C++ Run-Time Components Installation Verification 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 VAX documentation on system messages, recovery procedures, and OpenVMS VAX 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 2.

    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 4
    After Installation

    Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX is now installed and can be used by all applications written in Compaq C or Compaq C++, or that use the DECthreads facility.

    The following tasks can be performed after Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX is installed:

    The following sections describe these tasks in detail.

    4.1 Running the Installation Verification Procedure Separately

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


    $ @SYS$TEST:CRT$IVP.COM
    

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


    ** Compaq C/C++ Run-Time Components Installation Verification FAILED **
    

    4.2 Editing the System Files

    To use Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX with DECwindows or other applications written in the C language, you need to edit the system startup file to provide for automatic inclusion of the Compaq C/C++ Run-Time Components as known images when your system is rebooted. This step is required only on OpenVMS VAX systems prior to Version 6.0.

    Add the command line that starts the Compaq C/C++ Run-Time Components kit to the system startup file, SYS$MANAGER:SYSTARTUP_V5.COM. You should 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/C++ Run-Time Components Version 6.0 for OpenVMS VAX startup command line:


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

    Note

    This line should also precede the startup invocation of any applications written in the C or C++ languages, or that use the DECthreads facility. Examples of such applications are the DEC TCP/IP Services for OpenVMS (UCX$STARTUP.COM), DEC DCE, and DECmcc. This startup file must be invoked on all OpenVMS VAX nodes in a VMScluster.

    4.3 VMScluster Considerations

    After completing the initial installation on OpenVMS VAX systems prior to Version 6.0, you must install the Compaq C/C++ Run-Time Components kit on all nodes in a cluster. You must run the startup on each of the other nodes and enter the following command:


    $ @SYS$STARTUP:CRT$STARTUP.COM
    

    If you are using a dual-architecture (VAX and AXP systems) heterogeneous cluster, make sure the appropriate logical names have been set to define the scope of the SYSMAN DO commands before executing these commands. For more information, see the OpenVMS System Manager's Manual.

    4.4 Reinstalling After an OpenVMS VAX Intermediate Upgrade

    If you upgrade your operating system to OpenVMS VAX Version 5.5-1 or 5.5-2 after installing this kit, you must reinstall the Compaq C/C++ Run-Time Components kit. Unless you do reinstall this kit, applications that use new features of the Compaq C/C++ Run-Time Components kit may fail to work properly, because the kit supplies versions of several OpenVMS VAX component files that are more recent than versions supplied as part of the previous intermediate upgrades.

    4.5 Getting Help and Reporting Problems

    If an error occurs while Compaq C/C++ Run-Time Components Version 6.0 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/C++ Run-Time Components Version 6.0 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).
    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/C++ Run-Time Components Version 6.0 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/C++ Run-Time Components Version 6.0 for OpenVMS VAX documentation to the following Internet address:

    c_docs@zko.dec.com

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


    Appendix A
    Sample Installation

    This appendix contains a sample installation for the Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX kit. This is only a sample. Sometimes the installation procedure is modified in maintenance updates of this product.

    The following sample was installed on a system where Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX 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 the Compaq C/C++ Run-Time Components on an OpenVMS VAX system.

    Example A-1 Sample Compaq C/C++ Run-Time Components Installation on an OpenVMS VAX System

     
            Welcome to VAX/VMS V5.5-2  
     
    Username: SYSTEM 
    Password: 
            Welcome to VAX/VMS version V5.5-2 on node SUBTLE 
        Last interactive login on Thursday, 19-AUG-1993 14:39 
        Last non-interactive login on Monday,  9-AUG-1993 15:48 
     
    $ @sys$update:vmsinstal aacrt060 sys$update 
     
    VAX/VMS Software Product Installation Procedure V5.5-2 
     
    It is 19-AUG-1993 at 14:43. 
     
    Enter a question mark (?) at any time for help. 
     
    * Are you satisfied with the backup of your system disk [YES]? 
    * Enter installation options you wish to use (none): 
     
    The following products will be processed: 
      AACRT V6.0 
     
    Beginning installation of AACRT V6.0 at 14:43 
     
    %VMSINSTAL-I-RESTORE, Restoring product save set A ... 
    %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. 
      Compaq C/C++ Version V06.0-60 Run-Time components for OpenVMS/VAX systems 
     
        Copyright (c) Digital Equipment Corporation, 1993. All rights reserved. 
     
     
        This kit  provides  new  versions  of  several  OpenVMS  VAX  standard 
        shareable   images  and  object  libraries  in  SYS$LIBRARY,  such  as 
        VAXCRTL.EXE,  CMA$RTL.EXE, and  SMGSHR.EXE.  These provide support for 
        several programming  capabilities provided by  OpenVMS VAX Version 6.0 
        for C, C++, and other languages. 
     
        ********************************************************************** 
        *                          W A R N I N G                             * 
        ********************************************************************** 
     
        Programs  that link  against the new  versions of any of  these files, 
        EVEN THOSE NOT WRITTEN IN Compaq C OR C++, will NOT run on older versions 
        of OpenVMS (V5.5-2 or earlier)  unless steps are taken to save the old 
        SYS$LIBRARY configuration or redistribute this kit to additional sites. 
        See Chapter 1 of the  Compaq C/C++  Run-Time Components for OpenVMS VAX 
        Reference and Installation Guide for more details. 
     
        In  addition,  if you  update the system  version of  OpenVMS VAX, the 
        enhanced  versions of the new images and libraries may be  overwritten 
        with  versions that lack the  enhanced support.  Be sure to  reinstall 
        the Compaq C/C++ Run-Time Components kit after each OpenVMS VAX  system 
        update. 
     
    * Continue with the installation? [N]? y 
     
    * Do you want to purge files replaced by this installation [YES]? n 
     
        This kit  contains an  Installation  Verification  Procedure  (IVP) to 
        verify the correct installation of the Compaq C/C++ Run-Time Components. 
        The IVP will be placed in: 
     
            SYS$TEST:CRT$IVP.COM 
     
        After the installation is complete, you can invoke the command file at 
        any time to reverify that Compaq C/C++ Run-Time Components are installed 
        and working correctly.  Answer yes to the next question if you wish to 
        run the IVP at the completion of this installation procedure. 
     
    * Do you want to run the IVP after the installation [YES]? y 
     
            All questions and verifications regarding the installation of the 
            Compaq C/C++ Run-Time Components have been completed.  Depending on 
            your configuration, time estimates for the remainder of the 
            installation are 1 to 3 minutes. 
     
    %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSTEST.CRT]. 
     
      Your OpenVMS system will now be updated to include the following new file(s): 
     
        SYS$HELP:CRT060.RELEASE_NOTES                       [new] 
        SYS$HELP:CRT060_RELEASE_NOTES.PS                    [new] 
        SYS$HELP:CRT060_RELEASE_NOTES.DECW$BOOK             [new] 
        SYS$HELP:CRT060_REF_INST.PS                         [new] 
        SYS$HELP:CRT060_REF_INST.TXT                        [new] 
        SYS$HELP:CRT060_RBI.PS                              [new] 
        SYS$HELP:CRT060_RBI.TXT                             [new] 
        SYS$TEST:CRT$IVP.COM                                [new] 
        SYS$TEST:[CRT]CRT$ERR1.OBJ                          [new] 
        SYS$TEST:[CRT]CRT$ERR2.OBJ                          [new] 
        SYS$TEST:[CRT]CRT$IVP1.OBJ                          [new] 
        SYS$TEST:[CRT]CRT$IVP2.OBJ                          [new] 
        SYS$TEST:[CRT]CRT$IVP3.OBJ                          [new] 
        SYS$TEST:[CRT]CRT$IVP4.OBJ                          [new] 
        SYS$STARTUP:CRT$STARTUP.COM                         [new] 
        SYS$LIBRARY:CMA$RTL.EXE                             [new] 
        SYS$LIBRARY:CMA$OPEN_RTL.EXE                        [new] 
        SYS$LIBRARY:CMA$LIB_SHR.EXE                         [new] 
        SYS$LIBRARY:CMA$OPEN_LIB_SHR.EXE                    [new] 
        SYS$LIBRARY:CMA$TIS_SHR.EXE                         [new] 
        SYS$LIBRARY:CXXL$011_SHR.EXE                        [new] 
        SYS$MESSAGE:CXXL$MSG_SHR.EXE                        [new] 
        SYS$LIBRARY:DECC$SHR.EXE                            [new] 
        SYS$LIBRARY:DECCCURSE.OLB                           [new] 
        SYS$LIBRARY:DECCRTL.OLB                             [new] 
        SYS$LIBRARY:DECCRTLG.OLB                            [new] 
        SYS$LIBRARY:UCX$CRTLIBXFR.OBJ                       [new] 
        SYS$LIBRARY:VAXC$EMPTY.EXE                          [new] 
        SYS$LIBRARY:VAXC$LCL.OPT                            [new] 
        SYS$LIBRARY:VAXC2DECC.EXE                           [new] 
        SYS$LIBRARY:VAXCRTL.EXE                             [new] 
        SYS$LIBRARY:VAXCG2DECC.EXE                          [new] 
        SYS$MESSAGE:VAXCMSG.EXE                             [new] 
        SYS$LIBRARY:VAXCCURSE.OLB                           [new] 
        SYS$LIBRARY:VAXCRTL.OLB                             [new] 
        SYS$LIBRARY:VAXCRTLG.EXE                            [new] 
        SYS$LIBRARY:VAXCRTLG.OLB                            [new] 
        SYS$LIBRARY:DECC$EMPTY.EXE                          [new] 
     
        ********************************************************************** 
        *                         R E M I N D E R                            * 
        ********************************************************************** 
     
        If you are  installing on a  VMScluster, you  MUST execute the command 
        file  SYS$STARTUP:CRT$STARTUP.COM on all members of the  cluster after 
        installing the Compaq C/C++ Run-Time Components kit. 
     
        If you are  installing on an OpenVMS VAX system  prior to Version 6.0, 
        ensure that you invoke the  SYS$STARTUP:CRT$STARTUP.COM  startup  file 
        prior to  starting up any other  products in the system  startup file, 
        SYS$MANAGER:SYSTARTUP_V5.COM. See Chapter 4 of the Compaq C/C++ Run-Time 
        Components  for OpenVMS VAX  Reference and Installation Guide for more 
        details on postinstallation operations. 
     
    %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... 
     
       Copyright (c) Digital Equipment Corporation, 1993. All rights reserved. 
     
        *-------------------------------------------* 
        *    Installation Verification Procedure    * 
        *     for Compaq C/C++ Run-Time Components * 
        *-------------------------------------------* 
     
     
        *-------------------------------------------* 
        *    Test that components LINK properly     * 
        *-------------------------------------------* 
     
     
        *-------------------------------------------* 
        *    Test that components RUN properly      * 
        *-------------------------------------------* 
     
        Testing Compaq C RTL . . . 
        Testing Compaq C++ Class Library . . . 
        Testing curses . . . 
        Testing Compaq C RTL . . . 
        Testing Compaq C++ Class Library . . . 
        Testing curses . . . 
            Testing VAX C RTL . . . 
            Testing curses . . . 
            Testing DECthreads . . . 
            Testing VAX C RTL . . . 
            Testing curses . . . 
            Testing DECthreads . . . 
            Testing VAX C RTL . . . 
            Testing curses . . . 
            Testing DECthreads . . . 
            Testing VAX C RTL . . . 
            Testing curses . . . 
            Testing DECthreads . . . 
            Testing VAX C RTL . . . 
            Testing curses . . . 
            Testing DECthreads . . . 
            Testing VAX C shareable usage . . . 
            Testing shareable portion . . . 
            Testing main portion . . . 
            Testing VAX C shareable usage . . . 
            Testing shareable portion . . . 
            Testing main portion . . . 
     
      ** Compaq C/C++ Run-Time Components Installation Verification Procedure ** 
      ** Ending at 19-AUG-1993 14:47:05.63 ** 
     
            Installation of AACRT V6.0 completed at 14:47 
     
            VMSINSTAL procedure done at 14:50 
    

    Previous Contents Contents
      

    1.800.AT.COMPAQ

    privacy and legal statement