Privileges: SUBSYSTEM-MANAGEMENT
Function
The REMOVE-INSTALLATION-UNITS statement enables you to remove management information about installation units from the open SCI.
Once installation units have been removed from the SCI, they can no longer be accessed by IMON-GPN. Files or elements associated with the elements removed by this statement are not deleted.
Format
REMOVE-INSTALLATION-UNITS | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
Operands
UNIT-NAME =
The installation units to be selected.
UNIT-NAME = *BY-DIALOG
The installation units are listed in a selection window and can be selected in an interactive dialog (see the section "Interactive selection of installation units"). Interactive selection is not available in batch mode.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
Name of the installation unit, see "Installation unit (IU) ".
VERSION =
Version of the installation unit.
VERSION = *HIGHEST-EXISTING
Use the highest version of the installation unit.
VERSION = *LOWEST-EXISTING
Use the lowest version of the installation unit.
VERSION = *ALL
Use all versions of the installation unit.
VERSION = <product-version 3..7 without-man>
Version designation without the release and correction state.
CORRECTION-STATE =
Correction state of the installation unit.
CORRECTION-STATE = *HIGHEST-EXISTING
Use the highest correction state of the installation unit.
CORRECTION-STATE = *LOWEST-EXISTING
Use the lowest correction state of the installation unit.
CORRECTION-STATE = *ALL
Use all correction states of the installation unit
CORRECTION-STATE = list-poss(15): <alphanum-name 3..3>
Explicit specification of the correction state. Format: <aso>.
Notes
The statement is rejected and an error message is displayed in the following cases:
No write access is permitted for the SCI.
The value *BY-DIALOG was specified in batch mode.
The SCI does not contain any of the specified installation units.
The input list contains duplicate supply units, i.e. units with the same values or key
words for one of the identification parameters.
The selected installation unit is deleted.
If the installation unit is found in the “Lost+Found” group, it is deleted even if the version and correction state specifications do not match. If you are using the corresponding key words, it is a good idea to check this first by issuing a SHOW statement with the same criteria.
Interactive selection of installation units
If you enter the operand value UNIT-NAME=*BY-DIALOG in the REMOVE-INSTALLATION-UNITS statement, a selection window appears. Further selections can then be made interactively and in dialog boxes. You can select the installation units interactively by entering any character in front of the desired installation unit.
IMON: SCI: :I29A:$TSOS.SYS.IMON.SCI
------------------------------------------------------------------------------
Units 1 through 13 of 168
Installation units selection More: +
Unit name Version Corr state
ACS 21.0 A00
AID 03.5 A00
AIDSYS 21.0 A00
AIDSYSA 21.0 A00
ANITA 21.0 A00
APACHE 02.4 A00
ARCHIVE 12.0 C00
ASE 21.0 A00
ASSEMBH 01.4 A10
ASSEMBH-GEN 01.4 A10
ASSTRAN 05.4 A00
ASTI 21.0 A00
ATS 05.3 A20
------------------------------------------------------------------------------
Command ==>
F1=Help F3=Exit F5=Previous F6=Next F7=Backward F8=Forward F10=Menu ...
Figure 58: Interactive selection of installation units
Notes
Interactive selection is only part of the *BY-DIALOG operand value. It is different from the similar looking screen which is displayed when you select the Open option in the File menu in menu mode.
Installation units that could not be assigned (no SYSSII file) are indicated by a hash character (#).
Once you have selected the supply units, press [DUE] to exit the selection and the window. You are then returned to the SDF interface of IMON, where you can enter additional IMON statements.
Interactive selection is not available in batch mode.