This section and those that follow discuss various requirements for installing DEC C.
The installation takes approximately 5 minutes, depending on your type of media, your system configuration, and the kit components chosen.
To install DEC C, you must be logged in to an account that has the SETPRV privilege or at least the following privileges:
VMSINSTAL turns off BYPASS privilege at the start of the installation.
The DEC C compiler's requirements for free disk storage space are different during installation and after installation. Table 1-2 lists the storage requirements.
| Kit | Blocks During Installation | Blocks After Installation |
|---|---|---|
| Compiler | 34,000 | 22,000 |
To determine the number of free disk blocks on the current system disk, enter the following DCL command:
$ SHOW DEVICE SYS$SYSDEVICE
Installing DEC C requires certain system parameter settings.
The minimum number of free global pagelets (512-byte subpage unit) and global sections needed for the installation depends on whether SYS$SYSTEM:DECC$COMPILER.EXE was previously installed as a shared known image:
These values represent the number of free global pagelets and global sections required for the installation, not the total number you need to run your system and other software.
To install and run DEC C, you must have sufficient free global pagelets and global sections.
Enter the following DCL command to determine the number of global pagelets 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 pagelets needed for the file.
You can use the WRITE command with the F$GETSYI lexical function to find the number of free contiguous global pagelets and free 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 value of free global pagelets or global sections is less than the required value (see Section 1.4.2), you must increase the system parameter setting.
Section 1.4.2.2 describes the procedures for increasing these values using AUTOGEN.
If you do not have enough free global pages or free global sections to install DEC C, you can do either of the following:
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 GBLPAGES and GBLSECTIONS, use ADD_. The following example increases the global page setting by 2000:
ADD_GBLPAGES = 2000
After you make all your changes, exit from the editor, then execute the AUTOGEN procedure to recalculate your system parameters. Enter the following command to recalculate your system parameters and reboot the system:
$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT
When you specify REBOOT, AUTOGEN does 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.
The AUTOGEN Utility 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 OpenVMS System Management Subkit.
When you invoke VMSINSTAL, it checks the following:
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 type YES to continue. To stop the installation process and correct the situation, type NO or press Return. Then correct the problem and restart the installation.
VMSINSTAL requires that the installation account have the following minimum quotas:
Use the OpenVMS Authorize Utility to change the 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 example, 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 = 18000 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.
For more information on modifying account quotas, see the description of the AUTHORIZE utility in the OpenVMS System Management Subkit.
At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Digital recommends that you do a system disk backup before installing any software.
Use the backup procedures 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.