Privilegierung: STD-PROCESSING, SUBSYSTEM-MANAGEMENT
Funktionsbeschreibung
Mit der Anweisung SHOW-INSTALLATION-ITEMS können Informationen über die im geöffneten SCI eingetragenen Installation-Items (siehe "Installation-Item (II) ") ausgegeben werden.
Der nichtprivilegierte 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-ITEMS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
ITEM-NAME =
Auswahl des Installation-Items.
ITEM-NAME = *BY-INSTALLATION-PATH(...)
Das Item ist bereits installiert und wird durch seinen Pfadnamen bestimmt.
PATH-NAME = <filename 1..54 without-gen-vers>
Pfadname des Installation-Items.
ITEM-NAME = *FROM-FORMATTED-FILE(...)
Die Installation-Items werden der formatierten Datei entnommen.
FILE-NAME = <filename 1..54 without-gen-vers>
Dateiname der formatierten Datei.
ITEM-NAME = list-poss(30): <filename 1..30 without-cat-user-gen-vers>(...)
Name des Installation-Items.
VERSION =
Version des Installation-Items.
VERSION = *ALL
Sämtliche Versionen des Installation-Items werden ausgewählt.
VERSION = *HIGHEST-EXISTING
Die höchste Version des Installation-Items wird ausgewählt.
VERSION = <c-string 1..5>
Explizite Angabe der Version des Installation-Items.
UNIT-NAME =
Name der Installation-Units, in denen das Installation-Item gesucht wird.
UNIT-NAME = *ALL
Das Installation-Item wird in allen eingetragenen Installation-Units gesucht.
UNIT-NAME = list-poss(5): <text 1..30 without-sep>(...)
Angabe der Installation-Unit, in der das Installation-Item gesucht wird (siehe "Installation-Unit (IU) ").
VERSION =
Version der Installation-Unit.
VERSION = *ALL
In sämtlichen Versionen der Installation-Unit wird gesucht.
VERSION = *HIGHEST-EXISTING
In der höchsten Version der Installation-Unit wird gesucht.
VERSION = <product-version without-man-corr>
Versionsbezeichnung ohne Freigabe- und Korrekturstand.
CORRECTION-STATE =
Änderungsstand der angegebenen Installation-Unit.
CORRECTION-STATE = *ALL
In sämtlichen Änderungsständen der Installation-Unit wird gesucht.
CORRECTION-STATE = *HIGHEST-EXISTING
Im höchsten Änderungsstand der Installation-Unit wird gesucht.
CORRECTION-STATE = *LOWEST-EXISTING
Im niedrigsten Änderungsstand der Installation-Unit wird gesucht.
CORRECTION-STATE = list-poss(3): <alphanum-name 3..3>
Explizite Angabe des Änderungsstandes der Installation-Unit. Format: <aso>.
INFORMATION = *PARAMETERS(...)
Gibt den Umfang der auszugebenden Information an.
REPORT-LEVEL =
Steuert die Ausgabe der Attribute der Installation-Items.
REPORT-LEVEL = *MINIMUM
Nur die Namen der Installation-Items werden ausgegeben.
REPORT-LEVEL = *ALL-ATTRIBUTES
Die Namen und Attribute der Installation-Items 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 ITEM-NAME=*FROM-FORMATTED-FILE(FILE-NAME=) angegeben ist.
OUTPUT = *NONE
Mit Ausnahme von strukturierten Informationen (siehe Operand STRUCTURE-OUTPUT) erfolgt keine Ausgabe.
OUTPUT = <filename 1..54 without-gen-vers>(...)
Die Information wird in die formatierte Datei ausgegeben. Die gesammelten Informationen einer formatierten Datei können 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.
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 ITEM-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 Ausführung der 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 Pfadnamen-Manager zurückgegeben wird, sich von dem bei der Registration angegebenen unterscheidet, werden beide Dateinamen ausgegeben.
In folgenden Fällen wird die Anweisung ohne Aktion zurückgewiesen und eine Fehlermeldung ausgegeben:
Der explizit angegebene alphanumerische Korrekturstand besteht nicht aus einem Buchstaben, gefolgt von zwei Ziffern.
Es wurde ITEM-NAME=*FROM-FORMATTED-FILE angegeben, aber die entsprechende Datei existiert nicht oder ist nicht zugreifbar.
Es wurde OUTPUT=*INPUT-FORMATTED-FILE angegeben, aber der ITEM-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.
Ausgabe in S-Variablen
Ausgabe-Information | Name der S-Variablen | T | Inhalt |
aktuelle Zugriffsart des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-ACCESS | S | Read/Write |
aktuelle Zugriffskontrollliste des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-ACL | S | Yes/No |
aktuelle Sicherungshäufigkeit des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-BACK-CLASS | S | <c-string 1..1> |
aktuelle Basic-ACL des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-BASIC-ACL | S | <c-string 1..9> |
aktuelle Block-Kontroll-Information des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-BLK-CONTR | S | None / No / Pamkey / Data / Data-2K / Data-4K |
aktuelles Änderungsdatum des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-CHANGE-DATE | S | yyyy-mm-dd |
aktuelle Änderungszeit des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-CHANGE-TIME | S | hh:mm:ss |
aktuelles Erstellungsdatum des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-CREA-DATE | S | yyyy-mm-dd |
aktuelle Erstellungzeit des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-CREA-TIME | S | hh:mm:ss |
aktuelles Migrations-Attribut des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-MIGRATE | S | Allowed / Special / Inhibit |
aktuelle Mehrbenutzbarkeit des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-USER-ACC | S | All / Special / Owner-Only |
Zugriffsart des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-ACCESS | S | Read/Write |
Zugriffskontrollliste des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST).INIT-ACL | S | Yes/No |
Sicherungshäufigkeit des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-BACK-CLASS | S | <c-string 1..1> |
Basic-ACL des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST) .INIT-BASIC-ACL | S | <c-string 1..9> |
Block-Kontroll-Information des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-BLK-CONTR | S | None / No / Pamkey / Data / Data-2K / Data-4K |
Änderungsdatum des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-CHANGE-DATE | S | yyyy-mm-dd |
Änderungszeit des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-CHANGE-TIME | S | hh:mm:ss |
Erstellungsdatum des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-CREA-DATE | S | yyyy-mm-dd |
Erstellungzeit des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-CREA-TIME | S | hh:mm:ss |
Migrations-Attribut des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-MIGRATE | S | Allowed / Special / Inhibit |
Mehrbenutzbarkeit des Behälters bei der Installation | var(*LIST).II-CONTAINER(*LIST). INIT-USER-ACC | S | All / Special / Owner-Only |
aktuelle Zugriffsart | var(*LIST).II-CURR-ACCESS | S | Read/Write |
aktuelle Zugriffskontrollliste | var(*LIST).II-CURR-ACL | S | Yes/No |
aktuelle Sicherungshäufigkeit | var(*LIST).II-CURR-BACK-CLASS | S | <c-string 1..1> |
aktuelle Basic-ACL | var(*LIST).II-CURR-BASIC-ACL | S | <c-string 1..9> |
aktuelle Block-Kontroll-Information | var(*LIST).II-CURR-BLK-CONTR | S | None / No / Pamkey / Data / Data-2K / Data-4K |
aktuelles Änderungsdatum | var(*LIST).II-CURR-CHANGE-DATE | S | yyyy-mm-dd |
aktuelle Änderungszeit | var(*LIST).II-CURR-CHANGE-TIME | S | hh:mm:ss |
aktuelles Erstellungsdatum | var(*LIST).II-CURR-CREA-DATE | S | yyyy-mm-dd |
aktuelle Erstellungzeit | var(*LIST).II-CURR-CREA-TIME | S | hh:mm:ss |
aktuelle Migrations-Attribut | var(*LIST).II-CURR-MIGRATE | S | Allowed / Special / Inhibit |
aktuelle Mehrbenutzbarkeit | var(*LIST).II-CURR-USER-ACC | S | All / Special / Owner-Only |
Zugriffsart bei der Installation | var(*LIST).II-INIT-ACCESS | S | Read/Write |
Zugriffskontrollliste bei der Installation | var(*LIST).II-INIT-ACL | S | Yes/No |
Sicherungshäufigkeit bei der Installation | var(*LIST).II-INIT-BACK-CLASS | S | <c-string 1..1> |
Basic-ACL bei der Installation | var(*LIST).II-INIT-BASIC-ACL | S | <c-string 1..9> |
Block-Kontroll-Information bei der Installation | var(*LIST).II-INIT-BLK-CONTR | S | None / No / Pamkey / Data / Data-2K / Data-4K |
Änderungsdatum bei der Installation | var(*LIST).II-INIT-CHANGE-DATE | S | yyyy-mm-dd |
Änderungszeit bei der Installation | var(*LIST).II-INIT-CHANGE-TIME | S | hh:mm:ss |
Erstellungsdatum bei der Installation | var(*LIST).II-INIT-CREA-DATE | S | yyyy-mm-dd |
Erstellungzeit bei der Installation | var(*LIST).II-INIT-CREA-TIME | S | hh:mm:ss |
Migrations-Attribut bei der Installation | var(*LIST).II-INIT-MIGRATE | S | Allowed / Special / Inhibit |
Mehrbenutzbarkeit bei der Installation | var(*LIST).II-INIT-USER-ACC | S | All / Special / Owner-Only |
Änderungsdatum | var(*LIST).II-CHANGE-DATE | S | yyyy-mm-dd |
Änderungszeit | var(*LIST).II-CHANGE-TIME | S | hh:mm:ss |
Aktueller Pfadname des Behälters | var(*LIST).II-CONTAINER(*LIST). CURRENT-PATH | S | <filename 1..54> |
Existenz des Behälters unter dem aktuelle Pfadnamen | var(*LIST).II-CONTAINER(*LIST). CURRENT-PATH-PLACED | B | FALSE / TRUE |
Behältername bei Installation | var(*LIST).II-CONTAINER(*LIST).INIT-PATH | S | <filename 1..54> |
Existenz des Behälters unter dem Installationspfad | var(*LIST).II-CONTAINER(*LIST) .INIT-PATH-PLACED | B | FALSE / TRUE |
Erstellungsdatum | var(*LIST).II-CREA-DATE | S | yyyy-mm-dd |
Erstellungszeit | var(*LIST).II-CREA-TIME | S | hh:mm:ss |
Aktueller Pfadname | var(*LIST).II-CURR-PATH | S | <filename 1..54> |
Existenz des Installation-Items unter dem aktuellen Pfadnamen | var(*LIST).II-CURR-PATH-PLACED | B | FALSE / TRUE |
Funktionszustand | var(*LIST).II-FU-LEVEL | S | BOTH / TPR / TU |
Erstinstallationspfad | var(*LIST).II-INIT-PATH | S | <filename 1..54> |
Existenz des Installation-Items unter dem Erstinstallationspfad | var(*LIST).II-INIT-PATH-PLACED | B | FALSE / TRUE |
Name der Installation-Unit | var(*LIST).II-IU-NAME | S | <text 1..30> |
Version der Installation-Unit | var(*LIST).II-IU-VERSION | S | <product-version 7..7> |
Logischer Name | var(*LIST).II-LOGICAL-ID | S | <filename 1..30> |
Name des Installation-Items | var(*LIST).II-NAME | S | <filename 1..30> |
Hardware-Abhängigkeit | var(*LIST).II-TARGET | S | A/S/R/P/U |
Item-Typ | var(*LIST).II-TYPE | S | <c-string 1..3> |
Benutzerkennung | var(*LIST).II-USID | S | <name 1..8> |
Version des Installation-Items | var(*LIST).II-VERSION | S | <c-string 1..5> |