Privileges: SUBSYSTEM-MANAGEMENT
Function
Private software and software components already installed in the system can be entered as installation units in the open SCI with the ADD-INSTALLATION-UNITS statement.
The source of input for this function is either an IDF file (Installation Definition File, see "Installation Definition File (IDF file) ") that contains the information on the installation units and the corresponding installation items of the private software or a SYSSII file (structure and installation file, see "Structure and Installation Information file (SYSSII file) ").
If the installation units are registered from a SYSSII file, the entry you make in the SCI can be restricted to a certain target system version (TARGET-SYSTEM-VERSION operand).
This means that you only enter installation items that are specific to the specified target system version.
Format
ADD-INSTALLATION-UNITS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
FROM-FILE =
Name of the input file. The input file is either an IDF file or a SYSSII file.
FROM-FILE = *SYSDTA
This entry can only be made in the procedures generated by IMON.
The IDF file (in internal format; see "Installation definition file (IDF file, internal format) ") is read by SYSDTA in an import procedure generated using GENERATE-IDF.
FROM-FILE = <filename 1..54 without-gen-vers>
Name of the IDF file.
FROM-FILE = *SII(...)
Register the software using the specifications of the associated SYSSII file.
FILE-NAME = <filename 1..54 without-gen-vers>
Name of the SYSSII file.
INSTALLATION-NAME = *PARAMETERS(...)
The path name of the installation items.
PUBSET =
Pubset on which all the installation items are to be installed.
PUBSET = *DEFAULT
Install the installation items under the default catalog ID of the corresponding user ID on the home pubset of the active system.
PUBSET = <cat-id 1..4>
Use the specified catalog ID.
USER-ID = *STD / <alphanum-name 1..8>
User ID under which the installation items are to be installed.
Default: *STD, i.e. use the default user ID from the SYSSII file.
INSTALLATION-PATH =
File names of the installation items.
INSTALLATION-PATH = *STD
Register the installation items using the file name from the SYSSII file. No file name is registered for dummy installation items (except for SYSREP).
INSTALLATION-PATH = *BY-DIALOG
The installation items are offered for selection in dialog masks (e.g. select according to PROCESSOR-TYPE). You can modify their file names.
TARGET-SYSTEM-VERS = *CURRENT / *ANY / 19.0 / 20.0 / 21.0
Specifies whether only the installation items related to the specified target system version are to be registered.
Default: *CURRENT, i.e. only items relevant for the current version of the system are registered. With *ANY, all installation items are registered.
OUTPUT =
The output target for the log.
OUTPUT = *SYSOUT
Output the log to SYSOUT.
OUTPUT = *SYSLST(...)
Output the log to SYSLST.
SYSLST-NUMBER = *STD / <integer 1..99>
Output the information to the system file SYSLST or to a SYSLST file from the set SYSLST01 through SYSLST99.
Default: *STD, i.e. Output the information to the system file SYSLST.
Notes
The statement is rejected in the following cases and an error message is displayed:
The SCI cannot be accessed for write operations.
The IDF file cannot be accessed.
The SYSSII file cannot be accessed.
An error was detected in the IDF file.
An error was detected in the SYSSII file.
An installation unit that has to be added already exists in the SCI.
In the following case, the statement is canceled when the first defective installation unit is detected and an error message is displayed:
An IDF file generated using the GENERATE-IDF statement is read by SYSDTA and an installation unit that has to be added already exists in the SCI.
Each file with a path named in the IDF is checked. The ADD-INSTALLATION-UNITS statement sets the placement status. If the item is found, the attributes are taken from the system.
The log is output once the statement has executed. The log is a list of installation items added, plus their associated installation items or the error messages, as applicable.
- Installation items with a logical name are registered in the IMON-GPN-SCI.
Various target system version-dependent installation items of an installation unit have the same logical name, so that with the default value, TARGET-SYSTEM-VERS=*ANY, the last allocation by IMON for the logical name becomes effective. IMON processes the installation items of an installation unit in alphabetical order.
The items to be registered are selected automatically on the basis of the specified target system and the item’s TARGET ID.
The items are assigned as follows:
- In target system versions V19.0 and higher, items with TARGET= A, S, and K are processed.