Privilege: SUBSYSTEM-MANAGEMENT
Function description
With the ACTIVATE-UNITS statement, software can be dynamically activated, i.e. without interruption of system running, after the end of installation (which prepares the activation for the next system run). The selection of the software to be activated is performed either at the level of supply units or installation units.
For the stated supply units or installation units, IMON generates an activation procedure, which contains all the commands needed for activation. The procedure is started automatically. As an alternative, the start can be performed manually. The DSSM commands needed for activation are also listed in a report file and should be checked prior to calling the activation procedure.
Format
ACTIVATE-UNITS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
UNIT-NAME =
Selection of supply units or installation units, which are to be activated.
UNIT-NAME = *SUPPLY-UNIT(...)
Selection of supply units which are to be activated.
UNIT-NAME = *ALL
All supply units, which are entered in the SCI, are to be activated.
UNIT-NAME = *BY-DIALOG
The selection of the desired supply units is performed via dialog masks.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
The names of the desired supply units are explicitly stated. Up to 30 supply units can
be stated in the list.
VERSION = *HIGHEST-EXISTING / <product-version without-man-corr>
Specification of the version of the stated supply unit.
VERSION = *HIGHEST-EXISTING
Highest Version of the supply unit.
CORRECTION-STATE = *HIGHEST-EXISTING / <alphanum-name 3..3>
Specification of the correction state of the stated supply units with the stated version.
CORRECTION-STATE = *HIGHEST-EXISTING
Highest correction state of the supply unit.
UNIT-NAME = *INSTALL-UNIT(...)
Selection of the installation units, which are to be activated.
UNIT-NAME = *ALL
All installation units, which are entered in the SCI, are to be activated.
UNIT-NAME = *BY-DIALOG
The selection of the desired installation units is performed via dialog masks.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
The names of the desired installation units is explicitly stated.
VERSION = *HIGHEST-EXISTING / <product-version without-man-corr>
Specification of the version of the stated installation unit.
VERSION = *HIGHEST-EXISTING
Highest Version of the installation unit.
CORRECTION-STATE = *HIGHEST-EXISTING / <alphanum-name 3..3>
Specification of the correction state of the stated installation units with the stated version.
CORRECTION-STATE = *HIGHEST-EXISTING
Highest correction state of the installation unit.
SELECT =
States whether the number of supply units or installation units stated under UNIT-NAME should be further limited.
SELECT = *LAST-INSTALLATION
Only supply units or installation units from the latest installation are processed.
SELECT = *ALL
All displayed supply units or installation units are processed.
SELECT = list-poss(15): *SOLIS2-DELIVERY(...)
All supply units or installation units, which come from a specific SOLIS2 delivery, are processed. Up to 15 different SOLIS2 deliveries can be stated in a list.
PACKAGE-NAME = <alphanum-name 1..12>
States the package (as stated in the footer of the supply information).
USER-CODE = <alphanum-name 1..8>
States the customer ID (as stated in the footer of the supply information).
START =
Specifies whether the activation procedure should be automatically started or started by the user. The procedure name is shown after the generation of the file or at the automatic start.
The activation procedure is started with the job name ACTIVATE.
START = *IMMEDIATELY
The activation procedure is started immediately, automatically.
START = *BY-USER
The dynamic activation is initiated by the manual starting of the activation procedure
(ENTER-PROCEDURE command).
FILE-PREFIX = *STD / <partial-filename 2..20 without-cat-user>
Specifies the file name prefix of the generated activation procedure, which is saved under the current user ID with the name <prefix>.<time-stamp>.DA (on the format of the time stamp <time-stamp> see "The troubleshooting process ").
The default is *STD, i.e. the character string “IMONACU” is used. If the prefix is explicitly stated, the final stop must be entered with it.
OUTPUT =
The output target for the result log.
OUTPUT = *SYSOUT
Output the result log to SYSOUT.
OUTPUT = *SYSLST(...)
Output the result log to SYSLST.
SYSLST-NUMBER =
Number of the SYSLST file.
SYSLST-NUMBER = *STD
Output the information to standard SYSLST.
SYSLST-NUMBER = <integer 1..99>
An explicitly specified SYSLST number.
KEEP-OLD-VERSION = *NO / *YES
Specifies (for subsystems that permit removal) whether old versions of the processed subsystems are retained in the DSSM subsystem catalog or are to be removed. The default is *NO. In other words, the old versions are removed from the subsystem catalog.
Note
The statement is not executed and is rejected with an error message in the following circumstances:
The processed SCI is not a standard SCI, i.e. the location is not :<catid>:$TSOS.SYS.IMON.SCI.
One of the selected supply units or installation units is not registered in the currently open SCI.
One of the selected supply units is in the installation status “Installed”.