| United States |
|
|
| Previous | Contents |
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).
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:
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.
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:
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:
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.
| 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.
| 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 |
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.
| 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 |
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 |
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 ([]).
Username: SYSTEM Password: |
|
@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.
$ @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.
|
$ @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.
|
* Do you want to continue anyway [NO]? YES |
* Are you satisfied with the backup of your system disk [YES]? |
* Where will the distribution volumes be mounted: DSK$:[CRT06n] |
Please mount the first volume of the set on DSK$:. * Are you ready? YES %MOUNT-I-MOUNTED, DSK$: mounted |
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...
|
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]: |
* Queue name [SYS$PRINT]: CLUSTER_PRINT |
%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.
|
| Previous | Next | Contents |
|
