[an error occurred while processing this directive]

HP OpenVMS Systems

C Programming Language
Content starts here

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


Previous Contents

1.6 Requirements for Redistribution of the Compaq C/C++ Run-Time Components Kit

The Compaq C/C++ Run-Time Components kit may be redistributed along with any application that requires any of the components that are contained in it. For more information, see the Compaq C/C++ Run-Time Components Software Product Description (SPD).

Note

The Compaq C/C++ Run-Time Components kit and the components contained within it are supported only when the entire kit is redistributed to an end-user target site. Compaq does not support redistribution of individual components contained in the kit.

To redistribute the Compaq C/C++ Run-Time Components kit, you must supply the items listed in Section 1.7 to the end-user target site.

1.7 Saving the Compaq C/C++ Run-Time Components Kit to Allow Redistribution

Compaq has engineered the Compaq C/C++ Run-Time Components kit specifically to allow redistribution with user-developed applications.

To facilitate redistribution, the Compaq C/C++ Run-Time Components kit installer should ensure that copies of the following items are saved:

  • A printed or binary copy of the read before installing cover letter for the Compaq C/C++ Run-Time Components kit.
    The installation procedure puts the read before installing cover letter into the SYS$HELP directory. The name of the PostScript file is CRT060_RBI.PS; the name of the text file is CRT060_RBI.TXT.

  • A printed or binary copy of the reference and installation guide for the Compaq C/C++ Run-Time Components kit.
    The installation procedure puts the reference and installation guide into the SYS$HELP directory. The name of the PostScript file is CRT060_REF_INST.PS; the name of the text file is CRT060_REF_INST.TXT.
  • The complete Compaq C/C++ Run-Time Components kit save set, AACRT060.A.

Save these items immediately after installing the Compaq C/C++ Run-Time Components kit. These items can either be saved online for easy access or on a separate medium that is available and appropriately labeled. You can copy the binary items from the media they are provided on with the DCL command COPY or BACKUP.

If you do not save the Compaq C/C++ Run-Time Components kit save set, it cannot be reconstituted later from the installed components.


Chapter 2
Preparing for Installation

Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Compaq representative.

Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX provides online release notes, which are copied to the following files during installation (n is the minor release number):


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

Compaq strongly recommends that you read the release notes before proceeding with the installation. For information on accessing the online release notes, see step 5 in Section 3.1.

2.1 Required Operating System Components and Software

Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX requires the OpenVMS VAX operating system Version 5.5 or higher. Future Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX releases may require higher versions of the operating system, as described in the online release notes.

The OpenVMS VAX operating system comes with a variety of support options or components. Components include such features as networking and RMS journaling. To use Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX, your system should be running a version of OpenVMS VAX that includes the base component and the following:

  • Programming support
  • Utilities

The run-time component kit supplies versions of several OpenVMS VAX component files that are more recent than versions supplied as part of the OpenVMS VAX upgrades for Version 5.5 through Version 5.5-2. After installing this kit, if you then upgrade your system to one of these intermediate versions, you will have to reinstall the component kit. Otherwise, applications that use new features of these components may fail to work properly.

2.2 Installation Procedure Requirements

This section discusses the settings to check to ensure that your system is ready for the installation of the Compaq C/C++ Run-Time Components to proceed.

2.2.1 Process Privileges

To install the Compaq C/C++ Run-Time Components, you must be logged in to an account that has SETPRV or at least the following privileges:

  • CMKRNL
  • WORLD
  • SYSPRV

VMSINSTAL turns off BYPASS privileges at the start of the installation.

2.2.2 Process Account Quotas

VMSINSTAL requires that the installation account have minimum quotas, as shown in Table 2-1.

Table 2-1 Process Quotas for the Installing Account
ASTLM 1000
BIOLM 1000
BYTLM 99,000
DIOLM 1000
ENQLM 4000
FILLM 300

Use the OpenVMS Authorize Utility to verify and change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the OpenVMS Authorize Utility to certain accounts or people.) For instance, to change the BYTLM quota for the account-name installation account, you might enter the following command sequence:


$ RUN SYS$SYSTEM:AUTHORIZE
UAF> MODIFY account-name /BYTLM = 99000
UAF> SHOW account-name
UAF> EXIT
$ LOGOUT

After the quotas for the installation account have been changed, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation.

User account quotas are stored in the file SYSUAF.DAT. For more information on modifying account quotas, see the description of the Authorize Utility in the OpenVMS System Management Subkit.

2.2.3 System Parameters

Table 2-2 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings.

Table 2-2 Minimum Required System Parameter Values
System Parameter Minimum Value Dynamic Value
OpenVMS VAX Version 6.0
CLISYMTBL 1 500 500
GBLPAGES 2 200 200
GBLPAGFIL 200 200
Global Sections 2 10 10
OpenVMS VAX Versions 5.5, 5.5-1, and 5.5-2
CLISYMTBL 1 500 500
GBLPAGES 2 1500 1500
     
GBLPAGFIL 1500 1500
Global Sections 2 33 33

1The CLISYMTBL dynamic system parameter must be set to a minimum value of 500 during the installation procedure. You can change the setting to its original value after the installation is finished.
2These values represent the number of free global pages and global sections required for the installation, not the total number you need to run your system and other software.
3These dynamic system parameters must be set permanently to values equal to or greater than the values listed. Do not lower these values after the installation.

2.2.4 Disk Space

The Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX requirements for free disk storage space are different during installation and after installation. Table 2-3 summarizes the storage requirements.

Table 2-3 Disk Space Requirements
Kit Blocks During Installation Blocks After Installation
OpenVMS VAX Version 6.0
Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX 13,000 2000
Installation Verification Procedures 150 50
OpenVMS VAX Versions 5.5, 5.5-1, and 5.5-2
Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX 17,000 6000
Installation Verification Procedures 150 50

To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt:


$ SHOW DEVICE SYS$SYSDEVICE

2.2.5 Backing Up Your System Disk

At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Compaq recommends that you back up your system disk before installing any software.

Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the OpenVMS System Management Subkit.

2.2.6 Additional System Maintenance Procedures

This section explains how to use the System Generation Utility (SYSGEN) and the AUTOGEN Utility to prepare your system for an installation of the Compaq C/C++ Run-Time Components. AUTOGEN uses system configuration data to automatically set system parameters.

2.2.6.1 Checking System Parameter Values

To check the values of your system parameters, enter the following command:


$ RUN SYS$SYSTEM:SYSGEN
SYSGEN>

At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The following example displays the value for the CLISYMTBL system parameter:


SYSGEN> SHOW CLISYMTBL

After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level. For information on setting dynamic system parameter values, see Section 2.2.6.4.

2.2.6.2 Calculating the Values for Global Pages and Global Sections

To install and run Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX, you must have sufficient free global pages and global sections. You must first find out how many free global pages and sections you have on your system. Then use AUTOGEN if you need to increase the global pages and global sections system parameters.

Enter the following DCL command to determine the number of global pages required by SYS$LIBRARY:DCLTABLES.EXE:


$ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE

This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pages for the file.

You can use the WRITE command with the F$GETSYI lexical function to find the number of free global pages and global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT):


$ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")
15848
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")
24

If the values displayed by the system are greater than the values in Table 2-2, you do not need to increase the values for these parameters. If the value of free global pages or global sections is less than the value in Table 2-2, you must increase the system parameter setting.

Section 2.2.6.3 describes the procedures for increasing these values using AUTOGEN.

2.2.6.3 Changing System Parameter Values with AUTOGEN

Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file:


SYS$SYSTEM:MODPARAMS.DAT

Use an editor to access the file. To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value.

To add a new parameter, add a line to the file that includes both the name of the parameter and its value. For example:


WSMAX = 8096

To modify incremental parameters such as free global pages and global sections, prefix GBLPAGES and GBLSECTS with ADD_. The following example increases the global page setting by 2000:


ADD_GBLPAGES = 2000

When you set the page file quota, do not use a value that exceeds the amount of page file space available on the system.

After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. The following command recalculates your system parameters and reboots the system:


$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect.

AUTOGEN automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the /NOFEEDBACK qualifier on the AUTOGEN command line.

For more information about using AUTOGEN, see the system management documentation for your operating system.

2.2.6.4 Setting Dynamic System Parameter Values

Use SYSGEN to set dynamic parameters. Dynamic parameters changed with the SYSGEN command WRITE ACTIVE become active immediately without any need to reboot your system. Rebooting returns dynamic system parameter values to their previous settings.

After you change dynamic parameter values, 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 3
Installing the Compaq C/C++ Run-Time Components

The installation takes approximately 3 to 10 minutes, depending on your system configuration and the kit components chosen.

3.1 Installation Procedure

The Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX installation procedure consists of a series of questions and informational messages. See Appendix A for a sample installation.

To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all the 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/C++ Run-Time Components Version 6.0 for OpenVMS VAX, use the following installation name:


    AACRT06n
    

    n represents the minor (point) release number for Compaq C/C++ Run-Time Components Version 6.0 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/C++ Run-Time Components Version 6.0 for OpenVMS VAX save set. For example, DSK$: is the device name used in examples in this guide. The directory used in examples in this guide is [CRT06n], where n is the minor release number. The actual directory name may differ because the Compaq C/C++ Run-Time Components may be included with another product's save set. If this is the case, for the correct directory specification, see the installation guide for the product that includes the Compaq C/C++ Run-Time Components save set.
    To specify the device name on the @VMSINSTAL command line, enter:


    DSK$:[CRT06n]
    

    option-list

    The word OPTIONS followed by one or more of the following option designators---A, G, L, N, R:
    • Auto_answer option (A)
      Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system).
    • Get save-set option (G)
      Lets you store product save sets temporarily on a magnetic tape or in a disk directory.
    • File log option (L)
      Logs all activity to the terminal during installation.

    • Display or print the release notes (N)
      Indicates that you want to see the installation question on release notes. If you do not include the N option, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in case they contain additional information about the installation.
      If you are restarting the installation and have already reviewed the release notes, you do not need to specify the N option. (Even if you omit the N option when you invoke VMSINSTAL, the Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX release notes are copied automatically to the SYS$HELP directory.)
    • Alternate root option (R)
      Lets you install the product to a system root other than that of the running system.

    For detailed information on these software installation options, see the OpenVMS VAX 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/C++ Run-Time Components Version 6.0 for OpenVMS VAX and shows the system response. This example uses the OPTIONS N release note option.


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

    The following example invokes VMSINSTAL to install Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX from tape drive MTA0: and shows the system response. This example uses the OPTIONS N release note parameter.


    $ @SYS$UPDATE:VMSINSTAL AACRT06n MTA0: OPTIONS N
    
          OpenVMS VAX Software Product Installation Procedure V5.5
    
    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. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation.
    When you invoke VMSINSTAL, it checks the following:
    • Whether you are logged in to a privileged account. Compaq recommends that you install software from the system manager's account with your default device and directory set to SYS$UPDATE.
    • Whether you have adequate quotas for installation. VMSINSTAL checks for the quota values shown in Table 2-1.

    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:
    DSK$:[CRT06n]
    

    If this prompt appears, enter the name of the distribution (media) device and directory that contains the Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX kit (save set). For example, if the media is contained on a CD-ROM located on unit DSK$:, enter DSK$:[CRT06n] in reply to this question (where n is the minor version number).
    You should now mount the first distribution volume on the device you specified when you invoked VMSINSTAL.
    Depending on the type of device and whether the device is already mounted, the following prompt may or may not appear:


    Please mount the first volume of the set on DSK$:.
    * Are you ready? YES
    %MOUNT-I-MOUNTED, DSK$:  mounted
    
    If you have not already done so, insert the distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL then asks if you are ready to continue with the installation.
    If you respond YES to indicate that you are ready, VMSINSTAL displays a message that the media containing Compaq C/C++ Run-Time Components Version 6.0 for OpenVMS VAX has been mounted on the specified device and that the installation has begun.
    If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the Are you ready? question. To abort the installation for other reasons, press Ctrl/Y.
  4. Verify the product being installed.


     The following products will be processed:
    
       AACRT V6.n
    
         Beginning installation of AACRT V6.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:.
  5. Select a release notes option.


    Release Notes Options:
    
     1.  Display release notes
     2.  Print release notes
     3.  Both 1 and 2
     4.  Copy release notes to SYS$HELP
    
    * Select option [2]:
    

    If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the options for reviewing the release notes. All options copy the release notes to SYS$HELP.
    If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C.
    If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use. Either supply the name of the print queue that you want to use or press Return to send the file to the default output print device. For example:


    * Queue name [SYS$PRINT]: CLUSTER_PRINT
    

    If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version.
    If you select option 4, the installation procedure will only copy the release notes to the SYS$HELP directory.
    Next, VMSINSTAL displays the following message:


    %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.
    
             Compaq C/C++ Run-Time Components V6.n for OpenVMS VAX Systems
    
      Copyright (c) Digital Equipment Corporation, 1993. All rights reserved.
    
    The release notes are copied to the following files in the SYS$HELP directory (where n is the minor version number):


    Previous Next Contents