Privileges: SUBSYSTEM-MANAGEMENT
Function
The SHOW-SUPPLY-UNITS statement enables you to show information about the supply units in the open SCI (see "Software Configuration Inventory (SCI) ").
Possible entries are the supply units of an SOLIS2 delivery or a formatted file generated earlier by IMON. Supply units can also be selected interactively with the SUPPLY-UNITS=*BY-DIALOG operand in the dialog mode.
The statement supports structured output in S variables (see"Output in S variables" "SHOW-SUPPLY-UNITS Show supply units ").
Format
SHOW-SUPPLY-UNITS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
UNIT-NAME =
Name of the supply unit to be shown.
UNIT-NAME = *ALL
Show all supply units registered in the SCI.
UNIT-NAME = *BY-DIALOG
The supply units are listed in a selection window and can be selected interactively in a dialog (see also “Selection of supply units” in the menu mode on "View menu "). The information requested is output after the supply units have been selected by entering any character in front of the corresponding supply units and the window has been closed with [DUE].
UNIT-NAME = *FROM-SOLIS2-DELIVERY(...)
The supply units are from a SOLIS2 delivery.
PACKAGE-NAME = <alphanum-name 1..12>
Package name (as stated in the footer of the delivery contents).
USER-CODE = <alphanum-name 1..8>
User code (as stated in the footer of the delivery contents).
SUPPLY-UNITS =
The supply units to be shown.
SUPPLY-UNITS = *ALL
Show all the supply units of a SOLIS2 delivery registered in the SCI.
SUPPLY-UNITS = *BY-DIALOG
The supply units are listed in a selection window and can be selected interactively in a dialog (see also “Selection of supply units” in the menu mode on "View menu "). The information requested is output after the supply units have been selected by entering any character in front of the corresponding supply units and the window has been closed with [DUE].
SUPPLY-UNITS = list-poss(30): <text 1..30 without-sep>(...)
Explicit specification of the supply units, see "Supply unit ".
VERSION =
Version of the supply unit.
VERSION = *HIGHEST-EXISTING
Select the highest version of the supply unit.
VERSION = *ALL
Select all versions of the supply unit.
VERSION = <product-version without-man-corr>
Version designation without release and correction states.
CORRECTION-STATE =
Correction state of the supply unit.
CORRECTION-STATE = *HIGHEST-EXISTING
Select the highest correction state of the supply unit.
CORRECTION-STATE = *ALL
Select all correction states of the supply unit.
CORRECTION-STATE = *LOWEST-EXISTING
Select the lowest correction state of the supply unit.
CORRECTION-STATE = list-poss(3): <alphanum-name 3..3>
Explicit specification of the correction state of the supply unit.
UNIT-NAME = *FROM-FORMATTED-FILE(...)
The names of the supply units will be taken from a formatted file.
FILE-NAME = <filename 1..54 without-gen-vers>
Name of the formatted file containing the list of supply units.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
Name of the supply unit, see "Supply unit ".
VERSION =
Version of the supply unit.
VERSION = *ALL
Select all version designations of the supply unit.
VERSION = *HIGHEST-EXISTING
Select the highest version designation of the supply unit.
VERSION = <product-version without-man-corr>
Version designation without release and correction states.
CORRECTION-STATE =
Correction state of the supply unit.
CORRECTION-STATE = *ALL
Select all correction states of the supply unit.
CORRECTION-STATE = *HIGHEST-EXISTING
Select the highest correction state of the supply unit.
CORRECTION-STATE = *LOWEST-EXISTING
Select the lowest correction state of the supply unit.
CORRECTION-STATE = list-poss(15): <alphanum-name 3..3>
Select the specified correction state of the supply unit.
INFORMATION = *PARAMETERS(...)
The scope of information to be shown.
INSTALLATION-UNITS = *YES / *NO
Show/do not show the installation units in the supply unit.
REPORT-LEVEL =
The reporting level of the supply unit attributes.
REPORT-LEVEL = *SUMMARY
The attributes of the supply units are not output.
The last version of the selected supply unit is displayed regardless of the customer ID or package name.
REPORT-LEVEL = *MINIMUM
Show the names of the supply units only. If the delivery is a delta delivery, show only the supplied installation unit.
REPORT-LEVEL = *FOR-REFERENCE-FILE
The names of the supply units and the creation date (CREATION-DATE) are displayed.
With this setting, the installation of the reference file is carried out under the user ID SERVICE.
REPORT-LEVEL = *ALL-ATTRIBUTES
Show the names and attributes of the supply units for each correction state. If the delivery is a delta delivery, show only the supplied installation unit.
OUTPUT =
The target for output.
OUTPUT = *SYSOUT
Output the information to SYSOUT.
OUTPUT = *SYSLST(...)
Output the information to SYSLST.
SYSLST-NUMBER =
SYSLST number.
SYSLST-NUMBER = *STD
Output the information to standard SYSLST.
SYSLST-NUMBER = <integer 1..99>
Specifies the SYSLST number.
OUTPUT = *INPUT-FORMATTED-FILE
Output the information to the formatted file specified in the operand UNIT-NAME=*FROM-FORMATTED FILE(FILE-NAME).
OUTPUT = <filename 1..54 without-gen-vers>(...)
Output the information to a formatted file. Use the SHOW-FORMATTED-FILE statement to view the contents of the formatted file.
WRITE-MODE =
Write or extend the file.
WRITE-MODE = *REPLACE
Generate the formatted file or overwrite an existing file.
WRITE-MODE = *EXTEND
Generate the formatted file or extend an existing file.
OUTPUT = *NONE
No output is generated except structured output when requested.
STRUCTURE-OUTPUT =
Target of structured output when requested.
STRUCTURE-OUTPUT = *NONE
No structured output is requested.
STRUCTURE-OUTPUT = *SYSINF
Specification is only possible if the chargeable subsystem SDF-P is available.
The SYSINF stream is to be used for structured output.
STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Specification is only possible if the chargeable subsystem SDF-P is available.
Name of the S-variable (of the “list” type) to be used for the structured output.
WRITE-MODE = *REPLACE
The S-variable is created or overwritten if already existing.
WRITE-MODE = *EXTEND
S-variable is completed with the new information.
SELECT = *BY-ATTRIBUTES(...)
Restricts the selection to supply units with certain criteria.
INSTALLATION-STATUS =
All supply units that are in the specified installation state are displayed. Several installation states can be specified in a list as selection criterion (logically ORed).
INSTALLATION-STATUS = *ANY
The supply units are selected regardless of their installation state.
INSTALLATION-STATUS = *INSTALLED
Supply units in the “Installed” state are displayed.
INSTALLATION-STATUS = *BEING-INSTALLED
Supply units in the “Being Installed” state are displayed.
INSTALLATION-STATUS = *PARKED
Supply units in the “Parked” state are displayed.
INSTALLATION-STATUS = *IN-LIBRARY
Supply units in the “In Library” state are displayed.
INSTALLATION-STATUS = *ON-SOLIS2-VOLUME
Supply units in the “On SOLIS2 Volume” state are displayed.
INSTALLATION-STATUS = *ON-LOCAL-VOLUME
Supply units in the “On Local Volume” state are displayed.
INSTALLATION-STATUS = *BEING-DEINSTALLED
Supply units in the “Being Deinstalled” state are displayed.
INSTALLATION-STATUS = *PARTIALLY-INSTALLED
Supply units in the “Partially Installed” state are displayed.
CUSTOMER-APPROVED =
Display of supply units depends on an approval timestamp. An approval timestamp is set with the //SET-CUSTOMER-APPROVAL statement to release an installed supply unit for further installations in the production system.
CUSTOMER-APPROVED = *ANY
Display of supply units is independent of a timestamp.
CUSTOMER-APPROVED = *YES
Supply units with an approval timestamp are displayed.
CUSTOMER-APPROVED = *NO
Supply units without an approval timestamp are displayed.
Notes
Input
If UNIT-NAME=*FROM-FORMATTED-FILE is specified, the ID of the objects to be shown is taken from the formatted file records that contain an identifier for the desired object type.
For the sake of consistency, we recommend that you only specify a SHOW statement for a formatted file if it was generated with the same SCI status. However, if the information in the SCI has changed since the formatted file was created, the information that is output is not longer current.
Output
If the output is directed to SYSOUT or SYSLST, the information is edited so as to be legible.
If the information is directed to a formatted file, the output is compressed and is not legible for the user.
Execution of the statement is continued with a warning when an object for which information is to be supplied does not exist in the SCI.
In the following cases, the statement is rejected and an error message is displayed :
The value *BY-DIALOG was specified in batch mode.
The explicitly specified alphanumeric correction state is not a letter followed by two numbers.
UNIT-NAME=*FROM-FORMATTED-FILE was specified, but the corresponding file does not exist or cannot be accessed.
OUTPUT=*INPUT-FORMATTED-FILE was specified, but the UNIT-NAME parameter is not *FROM-FORMATTED-FILE.
There are duplicate units in the input list, i.e. units with the same values or key words for one of the identification parameters.
Output in S variables
Output information | Name of the S variable | T | Contents |
date of customer approval | var( *LIST).SU-CUST-APPR-DATE | S | yyyy-mm-dd |
time of customer approval | var( *LIST).SU-CUST-APPR-TIME | S | hh:mm:ss |
activable status | var(*LIST).SU-ACTIVABLE | B | FALSE/TRUE |
change date | var(*LIST).SU-CHANGE-DATE | S | yyyy-mm-dd |
change time | var(*LIST).SU-CHANGE-TIME | S | hh:mm:ss |
creation date | var(*LIST).SU-CREA-DATE | S | yyyy-mm-dd |
creation time | var(*LIST).SU-CREA-TIME | S | hh:mm:ss |
installation counter | var(*LIST).SU-INST-COUNTER | I | |
installation status | var(*LIST).SU-INST-STATUS | S | Installed Being installed Parked In Library On SOLIS2 Volume On Local Volume Being deinstalled Partially installed |
name of the installation unit | var(*LIST).SU-IU(*LIST).IU-NAME | S | <text 1..30> |
version of the installation unit | var(*LIST).SU-IU(*LIST).IU-VERSION | S | <product-version 7..7> |
number of contained installation units | var(*LIST).SU-IU-COUNT | I | <integer 0..2147483647> |
name of the supply unit | var(*LIST).SU-NAME | S | <text 1..30> |
name of the package | var(*LIST).SU-PACK-NAME | S | <alphanum-name 1..12> |
user code | var(*LIST).SU-USER-CODE | S | <alphanum-name 1..8> |
user ID | var(*LIST).SU-USID | S | <name 1..8> |
version of the supply unit | var(*LIST).SU-VERSION | S | <product-version 7..7> |