Privilege: SUBSYSTEM-MANAGEMENT
Function Description
With the statement REMOVE-PACKAGES management information about software deliveries, which are no longer needed, can be deleted from the open SCI. Supply units, which are part of a delivery, which is to be deleted, are deleted along with it, if they are in the installation status “Being installed”, “In Library”, “On SOLIS2 Volume” or “On Local Volume”.
Format
REMOVE-PACKAGES | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
Operands
PACKAGE-NAME =
Selects the software delivery to be deleted by the package name (as stated in the footer of the supply information). The statement can be limited to a specific customer ID with the operand USER-CODE.
PACKAGE-NAME = *BY-DIALOG
The deliveries are listed in the display window and can be selected interactively (see section "Interactive selection of deliveries"). Interactive selection is not available in batch mode.
PACKAGE-NAME = list-poss(30): <alphanum-name 1..12>
Package name of the software delivery, see "Delivery ". Up to 30 package names can be
stated in a list.
USER-CODE =
Selection of the software deliveries to be displayed by customer ID (as stated in the footer of the supply information).
USER-CODE = *ALL
Output for all customer IDs.
USER-CODE = <alphanum-name 1..8>
Output only for software deliveries with the stated customer ID.
WORK-FILE-DELETION = *YES / *NO
Specifies whether all work files, which are related to a software delivery which is to be deleted, should be deleted. The work files are only deleted after error-free processing.
Work files, which are related to a software delivery, which is to be deleted, are deleted with the following command:
/DELETE-FILE <work-file-location>.<package-name>,
IGNORE-PROTECTION=(*ACCESS,*EXPIRATION-DATE)
The work file ID (if applicable with prefix) is removed from the product movement file, which is registered in the SCI for the delivery. In the interactive dialog, the DELETE-FILE command is carried out in a control dialog with the user.
OUTPUT =
Specifies the aim of the output.
OUTPUT = *SYSLST(...)
Data output from SYSLST.
SYSLST-NUMBER =
SYSLST number.
SYSLST-NUMBER = *STD
Data output from default SYSLST.
SYSLST-NUMBER = <integer 1..99>
Output of SYSLST number.
Notes
In the following cases the statement is rejected without taking any action and an error
message is output:
The SCI cannot be accessed with write privileges.
The value *BY-DIALOG was specified in the batch mode.
The SCI does not contain the specified supply units.
There are double deliveries entries in the input list, i.e. deliveries with the same package name for one of the identification parameters.
The selection criteria are applied to the specified deliveries. When using the corresponding keywords, it is recommended to issue a SHOW statement with the same criteria beforehand as a check.
Interactive selection of deliveries
When the operand UNIT-NAME=*BY-DIALOG is entered in the statement REMOVE-PACKAGES, a window appears. The further selection is interactive and controled by masks.
The deliveries are interactively selected and the sign selected is entered in front of the desired deliveries.
------------------------------------------------------------------------------
Package 1 through 3 of 3
Package selection More:
Package name User code
x <package-name-1> SOL2p
<package-name-2> SOL2p
<package-name-3> SOL2P
*** End of Package selection ***
------------------------------------------------------------------------------
Command ==>
F1=Help F3=Exit F5=Previous F6=Next F7=Backward F8=Forward F10=Menu ...
Figure 59: Interactive selection of deliveries
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.
Once you have selected the deliveries, 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.