Privilegierung: SUBSYSTEM-MANAGEMENT
Funktionsbeschreibung
Mit der Anweisung SHOW-SUPPLY-UNITS werden Informationen über die Liefereinheiten des geöffneten SCI (siehe "Software-Configuration-Inventory (SCI) ") ausgegeben.
Mögliche Eingaben sind die Liefereinheiten einer SOLIS2-Lieferung oder eine vorher von IMON generierte, formatierte Datei. Im Dialogmodus können Liefereinheiten mit dem Operanden SUPPLY-UNITS=*BY-DIALOG auch interaktiv ausgewählt werden.
Die Anweisung unterstützt die strukturierte Ausgabe in S-Variablen (siehe „Ausgabe in S-Variablen").
Format
SHOW-SUPPLY-UNITS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
UNIT-NAME =
Name der Liefereinheit, die ausgegeben werden soll.
UNIT-NAME = *ALL
Sämtliche im SCI eingetragenen Liefereinheiten werden ausgegeben.
UNIT-NAME = *BY-DIALOG
Die Liefereinheiten werden in einem Auswahlfenster aufgelistet und können interaktiv ausgewählt werden (vgl. „Auswahl von Liefereinheiten“ im Menü-Modus auf "Menü Auswahl "). Nachdem die Liefereinheiten durch Eingabe eines beliebigen Zeichens vor der jeweiligen Liefereinheit ausgewählt sind und das Fenster mit [DUE] beendet wurde, werden die angeforderten Informationen ausgegeben.
UNIT-NAME = *FROM-SOLIS2-DELIVERY(...)
Die Liefereinheiten entstammen einer SOLIS2-Lieferung.
PACKAGE-NAME = <alphanum-name 1..12>
Angabe des Pakets (wie in der Fußzeile des Lieferanschreibens angegeben).
USER-CODE = <alphanum-name 1..8>
Angabe des Kundenkennzeichens (wie in der Fußzeile des Lieferanschreibens angegeben).
SUPPLY-UNITS =
Bestimmt die Liefereinheiten, die ausgegeben werden sollen.
SUPPLY-UNITS = *ALL
Alle Liefereinheiten der SOLIS2-Lieferung, die im SCI eingetragen sind, werden ausgegeben.
SUPPLY-UNITS = *BY-DIALOG
Die Liefereinheiten werden in einem Auswahlfenster aufgelistet und können interaktiv ausgewählt werden (vgl. „Auswahl von Liefereinheiten“ im Menü-Modus auf "Menü Auswahl ").
Nachdem die Liefereinheiten durch Eingabe eines beliebigen Zeichens vor der jeweiligen Liefereinheit ausgewählt sind und das Fenster mit [DUE] beendet wurde, werden die angeforderten Informationen ausgegeben.
SUPPLY-UNITS = list-poss(30): <text 1..30 without-sep>(...)
Explizite Angabe der Liefereinheiten, siehe "Liefereinheit (Supply-Unit) ".
VERSION =
Version der Liefereinheit.
VERSION = *HIGHEST-EXISTING
Die höchste Version der Liefereinheit wird ausgewählt.
VERSION = *ALL
Sämtliche Versionen der Liefereinheit werden ausgewählt.
VERSION = <product-version without-man-corr>
Versionsbezeichnung ohne Freigabe- und Korrekturstand.
CORRECTION-STATE =
Änderungsstand der Liefereinheit.
CORRECTION-STATE = *HIGHEST-EXISTING
Der höchste Änderungsstand der Liefereinheit wird ausgewählt.
CORRECTION-STATE = *ALL
Sämtliche Änderungsstände der Liefereinheit werden ausgewählt.
CORRECTION-STATE = *LOWEST-EXISTING
Der niedrigste Änderungsstand der Liefereinheit wird ausgewählt.
CORRECTION-STATE = list-poss(3): <alphanum-name 3..3>
Der angegebene Änderungsstand der Liefereinheit wird ausgewählt.
UNIT-NAME = *FROM-FORMATTED-FILE(...)
Die Namen der Liefereinheiten werden der formatierten Datei entnommen.
FILE-NAME = <filename 1..54 without-gen-vers>
Name der formatierten Datei, die die Liste der Liefereinheiten enthält.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
Name der Liefereinheit (siehe "Liefereinheit (Supply-Unit) ").
VERSION =
Version der Liefereinheit.
VERSION = *ALL
Sämtliche Versionsbezeichnungen der Liefereinheit werden ausgewählt.
VERSION = *HIGHEST-EXISTING
Die höchste Versionsbezeichnung der Liefereinheit wird ausgewählt.
VERSION = <product-version without-man-corr>
Versionsbezeichnung ohne Freigabe- und Korrekturstand.
CORRECTION-STATE =
Änderungsstand der Liefereinheit.
CORRECTION-STATE = *ALL
Sämtliche Änderungsstände der Liefereinheit werden ausgewählt.
CORRECTION-STATE = *HIGHEST-EXISTING
Der höchste Änderungsstand der Liefereinheit wird ausgewählt.
CORRECTION-STATE = *LOWEST-EXISTING
Der niedrigste Änderungsstand der Liefereinheit wird ausgewählt.
CORRECTION-STATE = list-poss(15): <alphanum-name 3..3>
Der angegebene Änderungsstand der Liefereinheit wird ausgewählt.
INFORMATION = *PARAMETERS(...)
Gibt den Umfang der auszugebenden Information an.
INSTALLATION-UNITS = *YES / *NO
Gibt an, ob die Installation-Units, die in den Liefereinheit enthalten sind, ausgegeben werden.
REPORT-LEVEL =
Steuert die Ausgabe der Attribute der Liefereinheiten.
REPORT-LEVEL = *SUMMARY
Die Attribute der Liefereinheiten werden nicht ausgegeben. Von den ausgewählten Liefereinheiten wird jeweils die zeitlich zuletzt installierte Version angezeigt, unabhängig vom Kundenkennzeichen oder Paketnamen.
REPORT-LEVEL = *MINIMUM
Nur die Namen der Liefereinheiten werden ausgegeben. Bei einer Deltalieferung wird nur die gelieferte Installation-Unit angezeigt.
REPORT-LEVEL = *FOR-REFERENCE-FILE
Die Namen der Liefereinheiten und das Erstellungsdatum (CREATION-DATE) werden ausgegeben. Mit dieser Einstellung wird bei der Installation die Referenzdatei unter der Benutzerkennung SERVICE erstellt.
REPORT-LEVEL = *ALL-ATTRIBUTES
Die Namen und Attribute der Liefereinheiten werden für jeden Änderungsstand ausgegeben. Bei einer Deltalieferung wird nur die gelieferte Installation-Unit angezeigt.
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.
SELECT = *BY-ATTRIBUTES(...)
Beschränkt die Auswahl auf Liefereinheiten mit bestimmten Kriterien.
INSTALLATION-STATUS =
Es werden alle Liefereinheiten angezeigt, die sich in dem angegebenen Installationszustand befinden. In einer Liste können mehrere Installationszustände als Auswahlkriterium angegeben werden (Oder-Verknüpfung).
INSTALLATION-STATUS = *ANY
Die Auswahl der Liefereinheiten erfolgt unabhängig vom Installationszustand.
INSTALLATION-STATUS = *INSTALLED
Es werden Liefereinheiten im Zustand „Installed“ angezeigt.
INSTALLATION-STATUS = *BEING-INSTALLED
Es werden Liefereinheiten im Zustand „Being Installed“ angezeigt.
INSTALLATION-STATUS = *PARKED
Es werden Liefereinheiten im Zustand „Parked“ angezeigt.
INSTALLATION-STATUS = *IN-LIBRARY
Es werden Liefereinheiten im Zustand „In Library“ angezeigt.
INSTALLATION-STATUS = *ON-SOLIS2-VOLUME
Es werden Liefereinheiten im Zustand „On Solis2 Volume“ angezeigt.
INSTALLATION-STATUS = *ON-LOCAL-VOLUME
Es werden Liefereinheiten im Zustand „On Local Volume“ angezeigt.
INSTALLATION-STATUS = *BEING-DEINSTALLED
Es werden Liefereinheiten im Zustand „Being Deinstalled“ angezeigt.
INSTALLATION-STATUS = *PARTIALLY-INSTALLED
Es werden Liefereinheiten im Zustand „Partially Installed“ angezeigt.
CUSTOMER-APPROVED =
Es werden Liefereinheiten in Abhängigkeit eines Freigabezeitstempels angezeigt. Ein Freigabezeitstempel wird mit der Anweisung //SET-CUSTOMER-APPROVAL gesetzt um eine installierte Liefereinheit für weitere Installationen im Produktivsystem freizugeben.
CUSTOMER-APPROVED = *ANY
Die Auswahl der Liefereinheiten erfolgt unabhängig von einem Freigabezeitstempel.
CUSTOMER-APPROVED = *YES
Es werden Liefereinheiten angezeigt, die einen Freigabezeitstempel besitzen.
CUSTOMER-APPROVED = *NO
Es werden Liefereinheiten angezeigt, die keinen Freigabezeitstempel besitzen.
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
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.
Die Anweisung mit einer Warnung fortgesetzt, wenn ein Objekt, über das informiert werden soll, nicht im SCI existiert.
In folgenden Fällen wird die Anweisung mit einer Fehlermeldung zurückgewiesen:
Im Batchmodus wurde der Wert *BY-DIALOG angegeben.
Der explizit 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.
Ausgabe in S-Variablen
Ausgabe-Information | Name der S-Variablen | T | Inhalt |
Datum der Kundenfreigabe | var( *LIST).SU-CUST-APPR-DATE | S | yyyy-mm-dd |
Zeit der Kundenfreigabe | var( *LIST).SU-CUST-APPR-TIME | S | hh:mm:ss |
Aktivierbarkeit | var(*LIST).SU-ACTIVABLE | B | FALSE/TRUE |
Änderungsdatum | var(*LIST).SU-CHANGE-DATE | S | yyyy-mm-dd |
Änderungszeit | var(*LIST).SU-CHANGE-TIME | S | hh:mm:ss |
Erstellungsdatum | var(*LIST).SU-CREA-DATE | S | yyyy-mm-dd |
Erstellungszeit | var(*LIST).SU-CREA-TIME | S | hh:mm:ss |
Installationszähler | var(*LIST).SU-INST-COUNTER | I | |
Installationszustand der Liefereinheit | var(*LIST).SU-INST-STATUS | S | Installed Being installed Parked In Library On SOLIS2 Volume On Local Volume Being deinstalled Partially installed |
Name der Installation-Unit | var(*LIST).SU-IU(*LIST).IU-NAME | S | <text 1..30> |
Version der Installation-Unit | var(*LIST).SU-IU(*LIST).IU-VERSION | S | <product-version 7..7> |
Anzahl der enthaltenen Installa- tion-Units | var(*LIST).SU-IU-COUNT | I | <integer 0..2147483647> |
Name der Liefereinheit | var(*LIST).SU-NAME | S | <text 1..30> |
Paket-Name | var(*LIST).SU-PACK-NAME | S | <alphanum-name 1..12> |
Kundenkennzeichen | var(*LIST).SU-USER-CODE | S | <alphanum-name 1..8> |
Benutzerkennung bei der Erstellung | var(*LIST).SU-USID | S | <name 1..8> |
Version der Liefereinheit | var(*LIST).SU-VERSION | S | <product-version 7..7> |