The DEC C 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 files it has created up to that point and exits. You can then start the installation again.
Defaults appear in brackets ([]) throughout the installation procedure.
Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE
@SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N
CC05n
Where n represents the minor (point) release number of DEC C, such as CC053 for Version 5.3. Refer to the label on the DEC C distribution kit or the DEC C BOM or BIL for the maintenance update number of your kit.
To specify the device name on the @VMSINSTAL command line, type:
DKA400:[CC05n.KIT]
There are several other options you can select when you invoke VMSINSTAL:
See the OpenVMS documentation on software installation in the OpenVMS System Management Subkit for detailed information on these options. If you specify more than one option, separate the options with commas (for example: OPTIONS A,N).
The following example invokes VMSINSTAL to install DEC C and shows the system response. This example uses the OPTIONS N release note parameter.
$ @SYS$UPDATE:VMSINSTAL CC05n DKA400:[CC05n.KIT] OPTIONS N
OpenVMS Alpha Software Product Installation Procedure V6.1
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 for the following requirements:
* Are you satisfied with the backup of your system disk [YES]?
VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. 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 in the VMSINSTAL command line, the following prompt appears:
Where will the distribution volumes be mounted: DKA400:[CC05n.KIT]
If this prompt appears, enter the name of the distribution (media) device and directory the contains the DEC C kit (save set). For example, if the media is contained on a CD located on unit DKA400:, enter DKA400:[CC05n.KIT] in reply to this question (where n is the minor release number.)
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 DKA400:. * Are you ready? YES %MOUNT-I-MOUNTED, DEC C mounted on DKA400:
If you have not already done so, you should now 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 you if you are ready to continue with the installation.
If you enter YES to indicate that you are ready, VMSINSTAL displays a message that the media containing DEC C has been mounted on the specified device and that the installation has started.
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.
The following products will be processed:
CC V5.n
Beginning installation of CC V5.n at 20:00
%VMSINSTAL-I-RESTORE, Restoring product saveset A...
The product name and version are displayed. The save set (A) is restored to a subdirectory of SYS$UPDATE.
Release notes included with this kit are always copied to SYS$HELP.
Additional Release Notes Options:
1. Display release notes
2. Print release notes
3. Both 1 and 2
4. None of the above
* Select option [2]:
If you specified OPTIONS N when you invoked VMSINSTAL, you are asked to choose one of the four options for reviewing the release notes.
* Queue name [SYS$PRINT]:
Either press Return to send the file to the default output print device (SYS$PRINT) or enter another queue name.
Next, VMSINSTAL displays the following question:
* Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.
To continue the installation, enter YES. Otherwise, press Return. In either case, the release notes are copied to the following file in the SYS$HELP directory (where n is the minor version number):
SYS$HELP:CC05n.RELEASE_NOTES
DEC C supports the OpenVMS License Management Facility (LMF). The installation procedure displays license information about your product and then asks if you have registered and loaded your Product Authorization Key (PAK) for DEC C. The following is an example of such information:
DEC C Version V5.n for OpenVMS Alpha Systems
Copyright Digital Equipment Corporation 1993, 1994, 1995, 1996. All
rights reserved.
Restricted Rights: Use, duplication, or disclosure by the U.S.
Government is subject to restrictions as set forth in subparagraph
(c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR
52.227-14 Alt. III, as applicable.
This software is proprietary to and embodies the confidential
technology of Digital Equipment Corporation. Possession, use, or
copying of this software and media is authorized only pursuant to a
valid written license from Digital or an authorized sublicensor.
This kit contains a file summarizing the new features, changes,
restrictions, and compatibility issues in this release of DEC C.
This file is named CC05n.RELEASE_NOTES and has been placed in
SYS$HELP:.
This file contains information valuable to DEC C programmers.
Please inform your user community of this file's existence.
Product: C
Producer: DEC
Version: 5.3
Release Date: dd-mmm-yyyy
* Does this product have an authorization key registered and loaded?: YES
If you have not registered and loaded your PAK, you must answer No to this question. You have to register and load your PAK to run the Installation Verification Procedure (IVP). If you have not done so, you should stop the installation, register and load your PAK, and then restart the installation.
The installation procedure asks if you want to run the IVP. The IVP for DEC C checks to be sure that the installation is successful. It is recommended that you run the IVP; answer YES to the following prompt:
This kit contains an Installation Verification Procedure (IVP)
to verify the correct installation of DEC C. The IVP will
be left in:
SYS$COMMON:[SYSTEST]DECC$IVP.COM
After the installation is complete, you can invoke the command
file at any time to verify that DEC C is installed and
working correctly.
* Do you want to run the IVP after the installation [YES]?
After DEC C 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 DEC C.
* Do you want to purge files replaced by this installation [YES]?
The directories SYS$HELP, SYS$MESSAGE, SYS$SYSTEM, DECC$LIBRARY, and SYS$TEST may contain previous versions of DEC C files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended.
In response to the purging prompt, press Return to purge the files or enter NO to keep them.
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 or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you chose to have files purged, that work is done now. The following messages are displayed:
You have answered all of the questions for this installation. The
installation will now execute in 1 to 5 minutes without further
intervention, depending on your configuration, installation media,
and so forth.
The C Runtime Library headers and Starlet headers are installed as
a Text Library (.TLB). The traditional text form of the headers
(.H files) are also provided for reference purposes only) in
the directories: SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and
SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C].
Please note that the compiler does not search the reference areas
SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and
SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C] during compilation.
Instead headers are taken from the text library.
%VMSINSTAL-I-SYSDIR, This product creates system disk directory
VMI$ROOT:[SYSTEST.DECC].
Your OpenVMS system will now be modified to include the
following new and modified files:
[SYSEXE]DECC$COMPILER.EXE [new]
[SYSHLP]HELPLIB.HLB [modified]
[SYSHLP]CC05n.RELEASE_NOTES [new]
[SYSLIB]DCLTABLES.EXE [modified]
[SYSLIB]DECC$RTLDEF.TLB [new]
[DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new]
[DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new]
[SYSMSG]DECC$COMPILER_MSG.EXE [new]
[SYS$STARTUP]DECC$STARTUP.COM [new]
[SYSTEST]DECC$IVP.COM [new]
[SYSTEST.DECC]DECC$IVP*.* [new]
The file SYS$STARTUP:DECC$STARTUP.COM contains commands to be
executed at system startup to allow for the best compilation
performance. You may want to invoke this command file from your
system's site specific startup file. This command file does not
have to be invoked for correct operation of DEC C.
The end of the installation is indicated by the following message:
%VMSINSTAL-I-MOVEFILES, files will now be moved to their target
directories...
Copyright Digital Equipment Corporation 1993, 1994, 1995, 1996. All
rights reserved.
Restricted Rights: Use, duplication, or disclosure by the U.S.
Government is subject to restrictions as set forth in subparagraph
(c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR
52.227-14 Alt. III, as applicable.
This software is proprietary to and embodies the confidential
technology of Digital Equipment Corporation. Possession, use, or
copying of this software and media is authorized only pursuant to a
valid written license from Digital or an authorized sublicensor.
If you chose to run the IVP, VMSINSTAL now invokes the IVP to verify that DEC C was installed successfully:
*-------------------------------------------*
* Installation Verification Procedure *
* for DEC C *
*-------------------------------------------*
***** DEC C Installation Verification Procedure SUCCESSFUL ******
Installation of CC V5.n completed at hh:mm Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]CC05n.VMI_DATA VMSINSTAL procedure done at hh:mm $ LOGOUT SYSTEM logged out at dd-mmm-yyyy hh:mm:ss.ss
When the installation is complete, you can choose to install more products or to log out (as shown here). If you removed any media from the console drive before beginning the installation, you should replace it now.
Be aware that VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again.