Remove inactive subsystem from dynamic catalog
Component: | DSSM |
Functional area: | Subsystem management |
Domain: | SYSTEM-MANAGEMENT |
Privileges: | SUBSYSTEM-MANAGEMENT |
Function
This command allows system administrators to remove an inactive subsystem from the current dynamic subsystem catalog while the system is running. As the subsystem is only virtually removed, issuing this command does not change the number of subsystems and CALL entries that can subsequently be added to the current subsystem catalog using the ADD-SUBSYSTEM command.
The command is rejected if
the designated subsystem is active
another subsystem has cross-references to or dependency relations with the designated subsystem.
Format
REMOVE-SUBSYSTEM |
SUBSYSTEM-NAME = <structured-name 1..8> ,VERSION = <product-version mandatory-man-corr> / <product-version without-man-corr> |
Operands
SUBSYSTEM-NAME = <structured-name 1..8>
Name of the subsystem that is to be removed.
VERSION = <product-version mandatory-man-corr> / <product-version without-man-corr>
Identifies the version number.
If a version number is specified, the format specified here must be identical to the format used when the subsystem was defined (release and correction status mandatory or not allowed; cf. SDF metasyntax).
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without errors | |
32 | ESM0646 | Command processing terminated abnormally; error occurred during initialization routine updating or calculation of the default version. | |
64 | ESM0642 | Command not executed |
Notes
Once a subsystem has been removed, its cross-references to and dependency relations with any other subsystem cease to exist.
If the latest version of a nonprivileged subsystem is removed, any dependency relations operating on the subsystem are obsolete.
Once at least one subsystem has been removed with REMOVE-SUBSYSTEM, it is no longer possible to dynamically extend the current subsystem catalog using the ADD-SUBSYSTEM command with TYPE=*EXTENDED-ACTIVE-CONFIGURATION. However, dynamic extension is possible with ADD-SUBSYSTEM and TYPE=*NEW-SUBSYSTEMS.
Example
Removing Version 17.0 of the EDT subsystem:
/remove-subsystem subsystem-name=edt,version='17.0'