Privileges: STD-PROCESSING, SUBSYSTEM-MANAGEMENT
Function
The SHOW-INSTALLATION-UNITS statement enables you to show information about the installation units in the open SCI (see "Installation unit (IU) ").
Possible inputs are an installation unit or a formatted file generated earlier by IMON. In the dialog mode installation units can also be selected interactively with the operand UNIT-NAME=*BY-DIALOG .
If you are a nonprivileged user, this statement only shows the path names for which DMS access is possible.
The statement supports structured output in S variables (see "Output in S variables" "SHOW-INSTALLATION-UNITS Show installation units ").
Format
SHOW-INSTALLATION-UNITS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
UNIT-NAME =
Name of the installation unit to be shown.
UNIT-NAME = *ALL
Show all installation 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 installation units” in the menu mode on "View menu "). The information requested is output after the installation units have been selected by entering any character in front of the corresponding installation units and the window has been closed with [DUE]. Interactive selection is not available in the batch mode.
UNIT-NAME = *FROM-FORMATTED-FILE(...)
Take the names of the installation units from the formatted file.
FILE-NAME = <filename 1..54 without-gen-vers>
Name of the formatted file containing the list of the installation units.
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 = *ALL
Select all versions of the installation unit.
VERSION = *HIGHEST-EXISTING
Select the highest version of the installation unit.
VERSION = <product-version without-man-corr>
Version designation without release and correction states.
CORRECTION-STATE =
Correction state of the installation unit.
CORRECTION-STATE = *ALL
Select all correction states of the installation unit.
CORRECTION-STATE = *HIGHEST-EXISTING
Select the highest correction state of the installation unit.
CORRECTION-STATE = *LOWEST-EXISTING
Select the lowest correction state of the installation unit.
CORRECTION-STATE = list-poss(15): <alphanum-name 3..3>
The correction state of the installation unit is specified explicitly.
Format: <aso>
INFORMATION = *PARAMETERS(...)
The scope of information to be shown.
INSTALLATION-ITEMS = *YES / *NO
Show/do not show the installation items in the installation units.
REPORT-LEVEL =
The reporting level for the installation unit attributes.
REPORT-LEVEL = *MINIMUM
Show the names of the installation units only.
REPORT-LEVEL = *ALL-ATTRIBUTES
Show the names and attributes of the installation units.
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.
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 user does not have the SUBSYSTEM-MANAGEMENT privilege, the path name of the installation items is only output when the user has DMS access to it (e.g. SHOW-FILE possible). Otherwise, an asterisk (*) is 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.
The statement is rejected and an error message is displayed in the following cases:
The value *BY-DIALOG was specified in batch mode.
The 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.
In the following cases, a warning is issued and execution of the statement resumes:
An object, for which information is to be supplied, does not exist in the SCI.
If, when displaying an installation item, the file name returned by the path name manager is not the same as that specified during registration, both file names are displayed.
Output in S variables
Output information | Name of the S variable | T | Contents |
activable level | var(*LIST).IU-ACTIV-LEVEL | B | FALSE/TRUE |
activable status | var(*LIST).IU-ACTIVABLE | S | <text 1..2> |
target version | var(*LIST).IU-BS2000-OSD | S | 190/200/210 |
change date | var(*LIST).IU-CHANGE-DATE | S | yyyy-mm-dd |
change time | var(*LIST).IU-CHANGE-TIME | S | hh:mm:ss |
creation date | var(*LIST).IU-CREA-DATE | S | yyyy-mm-dd |
creation time | var(*LIST).IU-CREA-TIME | S | hh:mm:ss |
function level | var(*LIST).IU-FU-LEVEL | S | BOTH/TPR/TU |
name of the installation item | var(*LIST).IU-II(*LIST).II-NAME | S | <filename 1..30> |
path name of the item | var(*LIST).IU-II(*LIST).II-PATH | S | <filename 1..54> |
version of the installation item | var(*LIST).IU-II(*LIST).II-VERSION | S | <c-string 1..5> |
number of contained items | var(*LIST).IU-II-COUNT | I | <integer 0..2147483647> |
installation counter | var(*LIST).IU-INST-COUNTER | I | <integer 0..2147483647> |
name of the installation unit | var(*LIST).IU-NAME | S | <text 1..30> |
user ID | var(*LIST).IU-USID | S | <name 1..8> |
version of the installation unit | var(*LIST).IU-VERSION | S | <product-version 7..7> |