Privilegierung: STD-PROCESSING, SUBSYSTEM-MANAGEMENT
Funktionsbeschreibung
Mit der Anweisung SHOW-INSTALLATION-UNITS können Informationen über die im geöffneten SCI eingetragenen Installation-Units (siehe "Installation-Unit (IU) ") ausgegeben werden.
Mögliche Eingaben sind eine Installation-Unit oder eine vorher von IMON generierte formatierte Datei. Im Dialogmodus können Installation-Units mit dem Operanden UNIT-NAME=*BY-DIALOG auch interaktiv ausgewählt werden.
Der nicht privilegierte Benutzer erhält mit dieser Anweisung nur die Pfadnamen, auf die ein DVS-Zugriff möglich ist.
Die Anweisung unterstützt die strukturierte Ausgabe in S-Variablen (siehe „Ausgabe in S-Variablen").
Format
SHOW-INSTALLATION-UNITS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
UNIT-NAME =
Name der Installation-Unit, die ausgegeben werden soll.
UNIT-NAME = *ALL
Sämtliche im SCI eingetragenen Installation-Units werden ausgegeben.
UNIT-NAME = *BY-DIALOG
Die Installation-Units werden in einem Auswahlfenster aufgelistet und können interaktiv ausgewählt werden (vgl. „Auswahl von Installation-Units“ im Menü-Modus auf "Menü Auswahl ").
Nachdem die Installation-Units durch Eingabe eines beliebigen Zeichens vor der jeweiligen Installation-Unit ausgewählt sind und das Fenster mit [DUE] beendet wurde, werden die angeforderten Informationen ausgegeben.
Die interaktive Auswahl steht im Batchmodus nicht zur Verfügung.
UNIT-NAME = *FROM-FORMATTED-FILE(...)
Die Namen der Installation-Units werden der formatierten Datei entnommen.
FILE-NAME = <filename 1..54 without-gen-vers>
Name der formatierten Datei, die die Liste der Installation-Units enthält.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
Name der Installation-Unit, siehe "Installation-Unit (IU) ".
VERSION =
Version der Installation-Unit.
VERSION = *ALL
Sämtliche Versionen der Installation-Unit werden ausgewählt.
VERSION = *HIGHEST-EXISTING
Die höchste Version der Installation-Unit wird ausgewählt.
VERSION = <product-version without-man-corr>
Versionsbezeichnung ohne Freigabe- und Korrekturstand.
CORRECTION-STATE =
Änderungsstand der Installation-Unit.
CORRECTION-STATE = *ALL
Sämtliche Änderungsstände der Installation-Unit werden ausgewählt.
CORRECTION-STATE = *HIGHEST-EXISTING
Der höchste Änderungsstand der Installation-Unit wird ausgewählt.
CORRECTION-STATE = *LOWEST-EXISTING
Der niedrigste Änderungsstand der Installation-Unit wird ausgewählt.
CORRECTION-STATE = list-poss(15): <alphanum-name 3..3>
Der Änderungsstand der Installation-Unit wird explizit angegeben.
Format: <aso>..
INFORMATION = *PARAMETERS(...)
Gibt den Umfang der auszugebenden Information an.
INSTALLATION-ITEMS = *YES / *NO
Gibt an, ob die Installation-Items, die in den Installation-Units enthalten sind,
ausgegeben werden.
REPORT-LEVEL =
Steuert die Ausgabe der Attribute der Installation-Units.
REPORT-LEVEL = *MINIMUM
Nur die Namen der Installation-Units werden ausgegeben.
REPORT-LEVEL = *ALL-ATTRIBUTES
Die Namen und die Attribute der Installation-Units werden ausgegeben.
OUTPUT =
Bestimmt das Ziel der Ausgabe.
OUTPUT = *SYSOUT
Die Information wird auf SYSOUT ausgegeben.
OUTPUT = *SYSLST(...)
Die Information wird nach SYSLST ausgegeben.
SYSLST-NUMBER =
SYSLST-Nummer.
SYSLST-NUMBER = *STD
Die Information wird nach Standard-SYSLST ausgegeben.
SYSLST-NUMBER = <integer 1..99>
Angabe der SYSLST-Nummer.
OUTPUT = *INPUT-FORMATTED-FILE
Die Information wird in die formatierte Datei ausgegeben, die im Operanden
UNIT-NAME=*FROM-FORMATTED-FILE(FILE-NAME=) angegeben ist.
OUTPUT = <filename 1..54 without-gen-vers>(...)
Die Information wird in einer formatierten Datei abgelegt. Die formatierte Datei kann mit der Anweisung SHOW-FORMATTED-FILE ausgegeben werden.
WRITE-MODE =
Gibt an, ob die Datei überschrieben oder aktualisiert wird.
WRITE-MODE = *REPLACE
Die formatierte Datei wird erzeugt. Ist sie bereits vorhanden, wird sie überschrieben.
WRITE-MODE = *EXTEND
Die formatierte Datei wird erzeugt oder mit den neuen Informationen aktualisiert.
OUTPUT = *NONE
Mit Ausnahme von strukturierten Informationen (siehe Operand STRUCTURE-OUTPUT)
erfolgt keine Ausgabe.
STRUCTURE-OUTPUT =
Bestimmt das Ziel für strukturierte Ausgabe-Informationen.
STRUCTURE-OUTPUT = *NONE
Es werden keine strukturierten Ausgabe-Informationen angefordert.
STRUCTURE-OUTPUT = *SYSINF
Nur möglich, wenn das kostenpflichtige Subsystem SDF-P verfügbar ist.
Die strukturierte Ausgabe erfolgt in den S-Variablenstrom SYSINF.
STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Nur möglich, wenn das kostenpflichtige Subsystem SDF-P verfügbar ist.
Die strukturierte Ausgabe erfolgt in die angegebene S-Variable (Listenvariable).
WRITE-MODE = *REPLACE
Die Listenvariable wird erzeugt. Ist sie bereits vorhanden, wird der bisherige Inhalt überschrieben.
WRITE-MODE = *EXTEND
Die Listenvariable wird erzeugt. Ist sie bereits vorhanden, wird die Ausgabe an den bisherigen Inhalt angehängt.
Hinweise
Eingabe
Bei der Angabe UNIT-NAME=*FROM-FORMATTED-FILE wird die Identifikation der auszugebenden Objekte aus den formatierten Dateisätzen entnommen, die einen Identifier enthalten, der dem gewünschten Objekttyp entspricht.
Für die Konsistenz wird geraten, eine SHOW-Anweisung für eine formatierte Datei nur dann anzugeben, wenn sie beim gleichen SCI-Status generiert wurde. Hat sich nämlich seit dem Erstellen der formatierten Datei die Information im SCI geändert, so entspricht die Ausgabe nicht mehr dem aktuellen Informationsstand.
Ausgabe
Besitzt der Benutzer nicht das Privileg SUBSYSTEM-MANAGEMENT, wird der Pfadname der Installation-Items nur ausgegeben, wenn der Benutzer DVS-Zugriff darauf hat (z.B. SHOW-FILE möglich). Andernfalls wird das Zeichen „*“ ausgegeben.
Bei Ausgabe nach SYSOUT oder SYSLST wird die Information lesbar aufbereitet.
Wird die Information in eine formatierte Datei geleitet, ist die Ausgabe komprimiert und für den Benutzer nicht lesbar.
In folgenden Fällen wird die Anweisung ohne Aktion zurückgewiesen und eine Fehlermeldung ausgegeben:
Im Batchmodus wurde der Wert *BY-DIALOG angegeben.
Der angegebene alphanumerische Korrekturstand besteht nicht aus einem Buchstaben, gefolgt von zwei Ziffern.
Es wurde UNIT-NAME=*FROM-FORMATTED-FILE angegeben, aber die entsprechende Datei existiert nicht oder ist nicht zugreifbar.
Es wurde OUTPUT=*INPUT-FORMATTED-FILE angegeben, aber der UNIT-NAME-Parameter ist nicht *FROM-FORMATTED-FILE.
In der Eingabeliste gibt es doppelte Einheiten, d.h. Einheiten mit gleichen Werten oder Schlüsselwörtern für einen der Identifikations-Parameter.
In folgenden Fällen wird die Anweisung mit einer Warnung fortgesetzt:
Ein Objekt, über das informiert werden soll, existiert nicht im SCI.
Wenn bei der Ausgabe eines Installation-Items der Dateiname, der vom Pfad-namen-Manager zurückgegeben wird, sich von dem bei der Registration angegebenen unterscheidet, werden beide Dateinamen ausgegeben.
Ausgabe in S-Variablen
Ausgabe-Information | Name der S-Variablen | T | Inhalt |
Aktivierbarkeit | var(*LIST).IU-ACTIV-LEVEL | B | FALSE/TRUE |
Aktivierungsstufe | var(*LIST).IU-ACTIVABLE | S | <text 1..2> |
Zielversion | var(*LIST).IU-BS2000-OSD | S | 190/200/210 |
Änderungsdatum | var(*LIST).IU-CHANGE-DATE | S | yyyy-mm-dd |
Änderungszeit | var(*LIST).IU-CHANGE-TIME | S | hh:mm:ss |
Erstellungsdatum | var(*LIST).IU-CREA-DATE | S | yyyy-mm-dd |
Erstellungszeit | var(*LIST).IU-CREA-TIME | S | hh:mm:ss |
Funktionszustand | var(*LIST).IU-FU-LEVEL | S | BOTH/TPR/TU |
Item-Name | var(*LIST).IU-II(*LIST).II-NAME | S | <filename 1..30> |
Item-Pfadhname | var(*LIST).IU-II(*LIST).II-PATH | S | <filename 1..54> |
Item-Version | var(*LIST).IU-II(*LIST).II-VERSION | S | <c-string 1..5> |
Anzahl der enthaltenen Items | var(*LIST).IU-II-COUNT | I | <integer 0..2147483647> |
Installationszähler | var(*LIST).IU-INST-COUNTER | I | <integer 0..2147483647> |
Name der Installation-Unit | var(*LIST).IU-NAME | S | <text 1..30> |
Benutzerkennung bei der Erstellung | var(*LIST).IU-USID | S | <name 1..8> |
Version der Installation-Unit | var(*LIST).IU-VERSION | S | <product-version 7..7> |