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.

* 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.

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.

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...

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

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:

• The operating system version is incorrect.
• A prerequisite software version is incorrect.
• Quotas necessary for successful installation are insufficient.
• System parameter values for successful installation are insufficient.
• The OpenVMS Help library is currently in use.
• The product license has not been registered and loaded.

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.

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:

• Running the Installation Verification Procedure (IVP) separately
• Editing the system startup file
• Making the product usable on a VMScluster
• Reinstalling after an OpenVMS VAX intermediate upgrade
• Reporting problems

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

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:

• The name and version number of the operating system you are using
• The version number of Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX you are using
• The hardware system you are using (such as a model number)
• A brief description of the problem (one sentence if possible)
• How critical the problem is

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.

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

privacy and legal statement