Privileges: SUBSYSTEM-MANAGEMENT
Function
The last installation performed of a supply unit is undone with the UNDO-SUPPLY-UNITS statement. The supply unit is removed from the system with the Undo function (deinstalled). In addition, the original state before installation of the supply unit is restored based on the Undo files saved during installation. The following actions are performed when the Undo function is called:
Installed files are deleted if necessary.
“New” syntax files, message files and subsystems are deactivated.
The SCI is cleaned.
“Old” syntax files, message files and subsystems are reactivated.
Changed or deleted files are reconstructed.
A requirement for this is that all changed or deleted files were saved during installation and the metadata of the installation was recorded in Undo files (see the INSTALL-UNITS statement, UNDO-PREPARATION operand). Only a SCI with the standard name $TSOS.SYS.IMON.SCI on the home pubset or an imported pubset is open. The Undo
function is rejected for another SCI.
The test mode can be set using the operand EXECUTION=*NO . In this case only the preliminary analysis used to monitor the successful execution of the Undo function is performed.
Format
UNDO-SUPPLY-UNITS | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
Operands
UNIT-NAME =
Selection of the supply units for which the Undo function is to be executed.
UNIT-NAME = *BY-DIALOG
The selection criteria and the corresponding supply units are selected interactively (see "Interactive selection of supply units" (INSTALL-UNITS Install and register software )).
UNIT-NAME = list-poss(30): <text 1..30 without-sep>
Name of the supply unit, see "Supply unit ".
DSSM-CATALOG = *DEFAULT / <filename 1..54 without-gen-vers>
Name of the static DSSM catalog to be reconstructed. The catalog ID is specified by the open SCI.
EXECUTION =
Specifies if the actual Undo actions are to be executed after performing the preliminary analysis. During the preliminary analysis a check is performed to see if the most important requirements to perform the deinstallation are fulfilled: :
Subsystem to be deleted must be stopped.
Files whose activation is to be undone and that are not reconstructed while the UNDO actions are executing must be accessible.
EXECUTION = *YES
The actual Undo actions are executed after a successful preliminary analysis. If the preliminary analysis determines that a requirement is not fulfilled, then an error is logged and error handling is initiated:
In the procedure or batch mode the processing mode is changed to EXECUTION=*NO, i.e. the preliminary analysis is continued and all errors detected are recorded. The actual Undo actions are not executed anymore, however.
In the interactive dialog processing is interrupted with a message requiring a response. Depending on the response of the user, processing is simply continued (the error is ignored) processing is continued with EXECUTION=*NO or the current step of the check is repeated.
When an error is ignored IMON assumes during processing after ignoring the error that no error was detected during this step of the check. Repeating this step of the check only makes sense when the cause of the error was eliminated in the meantime.
EXECUTION = *NO
The call is made in the test mode, i.e. only the preliminary analysis for executing the Undo function is performed and any errors detected during analysis are recorded.
OUTPUT = *SYSOUT
Error messages are output to SYSOUT.
OUTPUT = *SYSLST(...)
Error messages are output to SYSLST.
SYSLST-NUMBER =
SYSLST number.
SYSLST-NUMBER = *STD
Error messages are output to the standard SYSLST.
SYSLST-NUMBER = <integer 1..99>
Specification of the SYSLST number.
Notes
In the following cases the statement is rejected without taking any action and an error message is output:
No SCI with the standard name $TSOS.SYS.IMON.SCI is open.
There is no Undo file for one of the selected supply units. The Undo files are expected under the following name:
:<catid of the open sci>:$SYSSAG.IMON.UNDO.<name of the supply unit>
One of the following situations arises while interactively selecting the supply unit (UNIT-NAME=*BY-DIALOG):
More than one version was selected for a given supply unit .
The version of a supply unit found in the Undo file does not match the selected
version.
The value *BY-DIALOG was specified in the batch mode.
In the following cases execution of the statement is continued with a warning:
The supply unit found in the Undo file is not registered in the SCI.
The supply unit found in the Undo file is registered in the SCI, but is not in the “Installed” state.