Privileges: SUBSYSTEM-MANAGEMENT
Function
This statement allows to check the completeness, the correctness and the up-to-dateness of installed installation- or supply-unit(s) on the system.
This functionality validates the completeness of an installed unit:
if all the files contained in this unit are still present on the system
if all the files are still consistent
if all the files were not modified since their last installation
It validates also the up-to-dateness of the installed unit,i.e. if some items contained in the unit were successfully activated (if the activation was requested during the installation process):
the activation of message files and syntax files
the update of DSSM catalog and RMS depot
the validity of the REP file.
The motivation of the installation check functionality is to detect the problems encountered during installation or after installation:
installation step(s) ignored by the user during installation process
files partially or completely destroyed after a device or system crash
erroneous manipulations of the user in the installation job procedure.
Format
CHECK-UNITS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
UNIT-NAME =
Specifies the level at which the check is to be performed.
UNIT-NAME = *SUPPLY-UNIT(...)
The check is done at supply unit level.
UNIT-NAME = *ALL
All supply units, registered in the SCI and with “Installed” installation status are to be
checked.
UNIT-NAME = *BY-DIALOG
All supply units, registered in the SCI and with “Installed” installation status are proposed for interactive selection.
UNIT-NAME = *LAST-INSTALLED
All supply units from the last installation process are to be checked.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
Explicitly specified name of the desired supply units. Up to 30 supply units can be specified in a list.
VERSION = *HIGHEST-EXISTING / *ALL / <product-version without-man-corr>
Specification of the version of the stated supply unit.
VERSION = *HIGHEST-EXISTING
The highest version must be processed.
VERSION = *ALL
All versions of the selected supply units are to be checked.
CORRECTION-STATE = *HIGHEST-EXISTING / *ALL / <alphanum-name 3..3>
Specification of the correction state of the stated supply units with the stated
version.
CORRECTION-STATE = *HIGHEST-EXISTING
The highest correction state must be processed.
CORRECTION-STATE = *ALL
All correction states must be processed.
UNIT-NAME = *INSTALL-UNIT(...)
The check is done at installation unit level.
UNIT-NAME = *ALL
All installation units, registered in the SCI and with “Installed” installation status are to be checked.
UNIT-NAME = *BY-DIALOG
All installation units, registered in the SCI and with “Installed” installation status are proposed for interactive selection.
UNIT-NAME = *LAST-INSTALLED
All installation units from the last installation process are to be checked.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
Explicitly specified name of the desired installation units. Up to 30 installation units can be specified in a list.
VERSION = *HIGHEST-EXISTING / *ALL / <product-version without-man-corr>
Specification of the version of the stated installation unit.
VERSION = *HIGHEST-EXISTING
The highest version must be processed.
VERSION = *ALL
All versions of the selected installation units are to be checked.
CORRECTION-STATE = *HIGHEST-EXISTING / *ALL / <alphanum-name 3..3>
Specification of the correction state of the stated installation units with the stated version.
CORRECTION-STATE = *HIGHEST-EXISTING
The highest correction state must be processed.
CORRECTION-STATE = *ALL
All correction states must be processed.
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.
Note
The statement is rejected and an error message is displayed in following cases:
The opened SCI does not correspond to a standard one of the current system (name differs from <home-catid>$TSOS.SYS.IMON.SCI).
The specified installation unit or supply units do not exist in the currently opened SCI.
The specified supply units have an installation status different from “INSTALLED”.
The work userid SYSSAG does not exist or some necessary work files for SSCM processing are no more present there.
Example
//START-IMON //CHECK-UNITS UNIT-NAME=*INSTALLATION-UNIT(UNIT-NAME=(FDDRL,SORT,PERCON)) ****** IU 'FDDRL' '17.0A00' File ':MP14:$TSOS.SPMLNK.FDDRL.170' does not exist File ':MP14:$TSOS.SKMLNK.FDDRL.170' does not exist File ':MP14:$TSOS.SYSFGM.FDDRL.170.D' does not exist File ':MP14:$TSOS.SYSFGM.FDDRL.170.E' does not exist Info : File ':MP14:$TSOS.SYSMES.FDDRL.170' not merged during installation Info : File ':MP14:$TSOS.SYSSDF.FDDRL.170' not merged during installation Info : File ':MP14:$TSOS.SYSSSC.FDDRL.170' not merged during installation Info : File ':MP14:$TSOS.SYSRMS.FDDRL.170' not merged during installation ****** IU 'SORT' '07.9C00' ****** IU 'PERCON' '02.9A10' Warning : Initial creation attributes '20100322 144227' differ from current creation attributes '20100322 145709' for file ':P1:$TSOS.SYSSDF.PERCON.029' Warning : File ":P1:$TSOS.SYSSDF.PERCON.029" modified since its last installation Warning : Initial creation attributes '20100322 144228' differ from current creation attributes '20100322 145710' for file ':P1:$TSOS.SYSLNK.PERCON.029' Warning : File ":P1:$TSOS.SYSLNK.PERCON.029" modified since its last installation //END