Privilegierung: SUBSYSTEM-MANAGEMENT
Funktionsbeschreibung
Mit der Anweisung SHOW-PACKAGES werden Informationen über Software-Lieferungen, die im geöffneten SCI (siehe "Software-Configuration-Inventory (SCI) ") registriert sind, ausgegeben. Im Dialogmodus können Lieferungen mit dem Operanden PACKAGE-NAME=*BY-DIALOG auch interaktiv ausgewählt werden.
Die Anweisung unterstützt die strukturierte Ausgabe in S-Variablen (siehe „Ausgabe in S-Variablen").
Format
SHOW-PACKAGES | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
PACKAGE-NAME =
Auswahl der anzuzeigenden Software-Lieferungen über den Paketnamen (wie in der Fußzeile des Lieferanschreibens angegeben). Die Ausgabe kann im Operanden USER-CODE auf ein bestimmtes Kundenkennzeichen beschränkt werden. Name der Lieferung siehe auch "Lieferung ".
PACKAGE-NAME = *ALL
Es werden alle im SCI registrierten Software-Lieferungen ausgewählt.
PACKAGE-NAME = *BY-DIALOG
Die Software-Lieferungen werden in einem Auswahlfenster aufgelistet und können interaktiv ausgewählt werden (vgl. „Auswahl von Lieferungen“ im Menü-Modus auf "Menü Auswahl ").
Nachdem die Lieferungen durch Eingabe eines beliebigen Zeichens vor dem jeweiligen Paketnamen ausgewählt sind und das Fenster mit [DUE] beendet wurde, werden die angeforderten Informationen ausgegeben.
Die Ausgabe muss dabei für alle Kundenkennzeichen erfolgen (USER-CODE=*ALL).
PACKAGE-NAME = list-poss(30): <alphanum-name 1..12>
Es werden nur Software-Lieferungen mit dem angegebenen Paketnamen ausgewählt.
Name der Installation-Unit, siehe "Installation-Unit (IU) ".
USER-CODE =
Auswahl der anzuzeigenden Software-Lieferungen über das Kundenkennzeichen (wie in der Fußzeile des Lieferanschreibens angegeben).
USER-CODE = *ALL
Die Ausgabe erfolgt für alle Kundenkennzeichen.
USER-CODE = <alphanum-name 1..8>
Die Ausgabe erfolgt nur für Software-Lieferungen mit dem angegebenen Kundenkennzeichen.
INFORMATION = *PARAMETERS(...)
Gibt den Umfang der auszugebenden Information an.
SUPPLY-UNITS = *YES / *NO
Gibt an, ob die Liefereinheiten, die in den angebenen Lieferungen enthalten sind, mit ausgegeben werden.
REPORT-LEVEL =
Steuert die Ausgabe der Attribute der Liefereinheiten.
REPORT-LEVEL = *MINIMUM
Es werden nur die Namen der Liefereinheiten ausgegeben.
REPORT-LEVEL = *ALL-ATTRIBUTES
Es werden die Namen und Attribute der Liefereinheiten 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 = *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.
SELECT = *BY-ATTRIBUTES(...)
Beschränkt die Auswahl auf Lieferungen mit bestimmten Kriterien.
CREATION-DATE = *ANY / *INTERVAL(...)
Es werden alle Lieferungen in Abhängigkeit vom Erstellungsdatum (Zeitpunkt, an dem die Lieferung erstmalig im SCI eingetragen wurde) angezeigt.
CREATION-DATE = *ANY
Die Auswahl der Lieferungen erfolgt unabhängig vom Erstellungsdatum.
CREATION-DATE = *INTERVAL(...)
Es werden alle Lieferungen angezeigt, die innerhalb des angegebenen Zeitraums erstmalig im SCI eingetragen wurden.
Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen.
Eine sinnvolle Informationsausgabe mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird. Ohne Angabe einer Unter- und/oder Obergrenze (entspricht dem Default *ANY) wird der Auswahlbereich nach unten und/oder oben nicht beschränkt.
FROM = *ANY / <date with-compl>
Es werden alle Lieferungen angezeigt, die nach dem angegebenen Datum erstmalig im SCI eingetragen wurden (CREATION-DATE >= angegebenes Datum).
TO = *ANY / <date with-compl>
Es werden alle Lieferungen angezeigt, die vor dem angegebenen Datum erstmalig im SCI eingetragen wurden (CREATION-DATE <= angegebenes Datum).
CHANGE-DATE = *ANY / *INTERVAL(...)
Es werden alle Lieferungen in Abhängigkeit vom Änderungsdatum (Zeitpunkt, an dem für die Lieferung die letzte Änderung im SCI erfolgte) angezeigt.
CHANGE-DATE = *ANY
Die Auswahl der Lieferungen erfolgt unabhängig vom Änderungsdatum.
CHANGE-DATE = *INTERVAL(...)
Es werden alle Lieferungen angezeigt, für die innerhalb des angegebenen Zeitraums letztmalig im SCI geändert wurden.
Bereichsangaben gelten jeweils einschließlich der Bereichsgrenzen.
Eine sinnvolle Informationsausgabe mit Bereichsgrenzen ist nur möglich, wenn die Untergrenze <= der Obergrenze gewählt wird. Ohne Angabe einer Unter- und/oder
Obergrenze (entspricht dem Default *ANY) wird der Auswahlbereich nach unten und/oder oben nicht beschränkt.
FROM = *ANY / <date with-compl>
Es werden alle Lieferungen angezeigt, die nach dem angegebenen Datum letztmalig im SCI geändert wurden (CHANGE-DATE >= angegebenes Datum).
TO = *ANY / <date with-compl>
Es werden alle Lieferungen angezeigt, die vor dem angegebenen Datum letztmalig im SCI geändert wurden (CHANGE-DATE <= angegebenes Datum).
CONTAINED-SU-STATUS = *ANY / *ALL-INSTALLED / *PARTIALLY-INSTALLED / *NOTHING-INSTALLED
Es werden alle Lieferungen in Abhängigkeit vom Installationszustand der zugehörigen Liefereinheiten angezeigt.
CONTAINED-SU-STATUS = *ANY
Die Auswahl der Lieferungen erfolgt unabhängig vom Installationszustand der zugehörigen Liefereinheiten.
CONTAINED-SU-STATUS = *ALL-INSTALLED
Es werden alle Lieferungen angezeigt, bei denen alle zugehörigen Liefereinheiten installiert (Zustand „Installed“) sind.
CONTAINED-SU-STATUS = *PARTIALLY-INSTALLED
Es werden alle Lieferungen angezeigt, bei denen nur ein Teil der zugehörigen Liefereinheiten installiert (Zustand „Installed“) ist.
CONTAINED-SU-STATUS = *NOTHING-INSTALLED
Es werden alle Lieferungen angezeigt, bei denen noch keine der zugehörigen Liefereinheiten installiert (Zustand „Installed“) ist.
Hinweise
In folgenden Fällen wird die Anweisung ohne Aktion zurückgewiesen und eine Fehlermeldung ausgegeben:
Die Auswahl soll interaktiv erfolgen (PACKAGE-NAME=*BY-DIALOG) und im Operanden USER-CODE wurde ein Operandenwert ungleich *ALL angegeben.
Im Batchmodus wurde PACKAGE-NAME=*BY-DIALOG angegeben.
Im Operanden PACKAGE-NAME wurden in einer Liste Paketnamen mehrfach angegeben.
Existiert für einen der angegebenen Paketnamen und Kundenkennzeichen keine entsprechende Lieferung, wird eine Warnung ausgegeben und die Anweisung fortgesetzt.
In der Ausgabe für einen angegebenen Paketnamen/Kundenkennzeichen werden Liefereinheiten, die bereits über ein anderes Paket/Kundenkennzeichen installiert sind, mit einem Stern hinter dem Installationszustand gekennzeichnet.
Ausgabe in S-Variablen
Ausgabe-Information | Name der S-Variablen | T | Inhalt |
Änderungsdatum | var(*LIST).PACK-CHANGE-DATE | S | yyyy-mm-dd |
Änderungszeit | var(*LIST).PACK-CHANGE-TIME | S | hh:mm:ss |
Erstellungsdatum | var(*LIST).PACK-CREA-DATE | S | yyyy-mm-dd |
Erstellungszeit | var(*LIST).PACK-CREA-TIME | S | hh:mm:ss |
Gerätetyp des Liefermediums (bei MEDIUM=A) | var(*LIST).PACK-DEL-DEV-TYPE | S | <device> |
Lieferbibliothek (bei MEDIUM=L) | var(*LIST).PACK-DEL-LIB | S | <filename 1..54> |
VSN des Liefermediums (bei MEDIUM=A) | var(*LIST).PACK-DEL-VSN | S | <vsn> |
Dokumentations-Bibliothek | var(*LIST).PACK-DOC-LIB | S | <filename 1..54> |
Typ des Liefermediums L=Lieferbibliothek A=Datenträger | var(*LIST).PACK-MEDIUM | S | L / A |
Paket-Name | var(*LIST).PACK-NAME | S | <alphanum-name 1..12> |
Installationszustand der SU | var(*LIST).PACK-SU(*LIST).SU-INST-STATUS | S | Installed Being installed Parked In Library On SOLIS2 Volume On Local Volume Being deinstalled Partially installed |
Name der Liefereinheit | var(*LIST).PACK-SU(*LIST).SU-NAME | S | <text 1..30> |
Version der Liefereinheit | var(*LIST).PACK-SU(*LIST).SU-VERSION | S | <product-version 7..7> |
Anzahl der enthaltenen SUs | var(*LIST).PACK-SU-COUNT | I | <integer 0..2147483647> |
Kundenkennzeichen | var(*LIST).PACK-USER-CODE | S | <alphanum-name 1..8> |
Benutzerkennung bei der Erstellung | var(*LIST).PACK-USID | S | <name 1..8> |
Arbeitsdateikennung | var(*LIST).PACK-WORK-FILE-LOC | S | <filename 1..22> |