The INSTALL (Install Software) command copies and installs system software from the system release media. It performs the following steps:

You can use the INSTALL APPLICATION command to install the KEYSFILE, the INSTALLDATA file, the Simple Installation (SI) program, and the files required for a minimal running system from a specified tape or CD-ROM. If you do not specify a tape or CD-ROM, the system uses the first ready and available library tape. If no ready library tape exists, the installation terminates.

The other forms of the INSTALL command install only system files. These files are needed for a running system environment and include the operating system, the message control systems (MCSs), and any libraries, compilers, utilities, help books, menugraphs, and so on. To install source files or generation data files such as sample files, test files, manuals, and notes, run the Simple Installation (SI) program interactively under either a privileged usercode or no usercode.

For more information about the Simple Installation program, refer to the Simple Installation Operations Guide.

Syntax

<application source>

Explanation

INSTALL APPLICATION

INSTALL NECESSARYONLY

INSTALL SYSTEMSOFTWARE

INSTALL ALL

INSTALL DATAONLY

INSTALL SUPPORT

Specify the files to copy and optionally install.

APPLICATION copies the KEYSFILE, the INSTALLDATA file, the Simple Installation (SI) program, and files required for a minimal running system from the specified tape or CD-ROM. If you do not specify a tape or CD-ROM, the system uses the first ready and available library tape. If no ready library tape exists, the installation terminates.

NECESSARYONLY (the default value) copies only files needed for a minimum running system. These files include the data comm files, Menu-Assisted Resource Control (MARC) files, and Print System files.

SYSTEMSOFTWARE copies all system software files, except Enterprise Database Server files, that are needed for a running system.

ALL copies all system software files, including Enterprise Database Server software files, needed for a running system environment. Symbol files and generation data files are not copied.

DATAONLY copies the INSTALLDATA file in the following form if SI is already resident on disk:

INSTALLDATAFILE/=

None of the support libraries are copied.

SUPPORT copies files from a support release. Information from the previous software installation is used to copy the updated files to the correct families. When you use this form of the command, the software assumes that the UPDATEINFO file (named INSTALLDATAFILE/SYSTEM/<processor-type>) is on one of the following packs:

INSTALL KEYSFILE

Copies and merges information into the system keys file *SYSTEM/KEYSFILE from the file SYSTEM/<release ID>/KEYSFILE for the current software release. Copies the optional keys file SYSTEM/DSAKEYSFILE from the media to the halt/load family if the file is on the media. The file from which information is to be copied must be on a CD-ROM named SYSTEM_KEYS. For more information about the keys file, refer to the IK (Install Keys) command.

INSTALL KEYSFILE = <release ID>

INSTALL KEYSFILE = <release ID> CDROM <cdrom name>

Merge information into the system keys file *SYSTEM/KEYSFILE from the file SYSTEM/<release ID>/KEYSFILE for the release specified by <release ID>. These commands also copy the optional keys file SYSTEM/DSAKEYSFILE from the media to the halt/load family if the file is on the media.

If you specify CDROM, FROM, or ON, the file from which information is to be copied must be on the media whose name is specified by <cdrom name>. If you omit the media, the default media is used (see INSTALL KEYSFILE above).

The default value for <release ID> is the current SSR number such as 62.0.

INSTALL KEYSFILE = <file name>

Merge information for the current software release into the system keys file *SYSTEM/KEYSFILE from the file specified by <file name>. These commands also copy the optional keys file SYSTEM/DSAKEYSFILE from the media to the halt/load family if the file is on the media.

The default value for <release ID> is the current software release (for example 60.0).

INSTALL RELEASEID = "<version ID>"

Specifies the name of the release being installed. If this specification is omitted, the release that created the Simple Installation (SI) program is assumed. The release name is used to form the name of the file that contains all the information needed to install the software. The file name is constructed as follows:

INSTALLDATAFILE/SYSTEM/<compressed release ID>

In the file name, <compressed release ID> is the <version ID> with all nonalphanumeric characters removed.

INSTALL DISK = <family name>

Copies software that does not need to be on the halt/load family to the specified family. If this specification is omitted, the software is copied to the DISK family. If there is no family named DISK on the system, the software is copied to the halt/load family.

INSTALL HLDISK = <family name>

Copies software that must be on the halt/load pack to the specified family. If this specification is omitted, that software is installed on the current halt/load family. If the INSTALL = <Boolean> option is not set to FALSE, any SL mappings are applied to the current halt/load family rather than to the new halt/load family.

INSTALL INSTALL = <Boolean>

Specifies whether to install the software after copying. TRUE (the default value) indicates it should be installed. FALSE indicates it should not be installed. FALSE is useful for preparing new release families when the software is to be installed later.

INSTALL CDROM <cdrom name suffix>

Specifies that all files are copied from CD-ROM. The <cdrom name suffix> is the 5-digit release ID on the label of the CD-ROM and is prefixed with SYSTEM_ to form the CD-ROM name.

Examples

The following table contains examples of the INSTALL command and an explanation of each example.