Installationspfad ausgeben
Komponente: | IMON-GPN |
Funktionsbereich: | System steuern und optimieren |
Anwendungsbereich: | SYSTEM-MANAGEMENT |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Mit dem Kommando SHOW-INSTALLATION-PATH kann sich der Benutzer die Zuordnung zwischen logischem Namen und Pfadnamen eines Installation-Items oder die Pfadnamen aller Installation-Items einer Installation-Unit ausgeben lassen.
Die Ausgabe kann nach SYSOUT (Default-Wert) oder nach SYSLST erfolgen.
Ein Installation-Item, das in einer Installation-Unit enthalten ist, wird eindeutig bestimmt durch seinen logischen Namen. Die Installation-Unit wird eindeutig bestimmt durch ihren Namen und ihre Versionsbezeichnung.
In einem Aufruf können alle in einer bestimmten Installation-Unit enthaltenen Installation-Items ausgewählt werden.
Wird eine Teilversion angegeben und existieren mehrere Versionen der Installation-Unit, werden Informationen für jede dieser Versionen ausgegeben. Ausgegeben werden der Name und die Version der Installation-Unit und für jedes ausgewählte Installation-Item der logische Name, der Pfadname und die dazugehörigen Attribute.
Das Zeichen „*“ ersetzt den Pfadnamen, wenn dieser nicht für den Benutzer ausgegeben werden kann (d.h. wenn er kein Zugriffsrecht besitzt).
Der nicht-privilgierte Anwender erhält nur Informationen über Installation-Items der Benutzerebene TU (task unprivileged).
Das Kommando ist Bestandteil von IMON-GPN. Das Software-Produkt IMON wird in dem Handbuch „IMON“ [19] vollständig beschrieben.
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Privilegierte Funktionen
Der privilegierte Benutzer erhält Informationen über alle Installation-Items. Für jede Installation-Unit wird zusätzlich der Sperrstatus angezeigt (im Ausgabefeld LOCKED).
Format
SHOW-INSTALLATION-PATH | ||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
INSTALLATION-UNIT =
Name der Installation-Unit, die die Installation-Items enthält.
INSTALLATION-UNIT = *ALL(...)
Sämtliche Installation-Units werden ausgewählt.
VERSION =
Version der Installation-Units.
VERSION = *ALL
Sämtliche Versionsbezeichnungen der Installation-Units werden verwendet.
VERSION = <product-version>
Explizite Angabe der Version der Installation-Units im Format mm.n[a[so]].
INSTALLATION-UNIT = <text 1..30 without-sep>(...)
Explizite Angabe der Installation-Unit.
VERSION =
Version der Installation-Unit.
VERSION = *ALL
Sämtliche Versionsbezeichnungen der Installation-Unit werden verwendet.
VERSION = <product-version>
Explizite Angabe der Version der Installation-Unit im Format mm.n[a[so]].
LOGICAL-IDENTIFIER =
Gibt an, ob zusätzlich zu Informationen über die ausgewählte Installation-Unit auch Informationen über zugehörige Installation-Items (mit logischen Namen) ausgegeben werden sollen. Diese Informationen können für einen bestimmten, für eine Menge von Namen (spezifiziert über eine Musterzeichenfolge) oder für alle logischen Namen angefordert werden.
LOGICAL-IDENTIFIER = *ALL
Es werden zusätzlich Informationen über alle logischen Namen und zugeordnete Installation-Items der ausgewählten Installation-Unit ausgegeben.
LOGICAL-IDENTIFIER = <filename 1..30 without-cat-user-gen-vers with-wild>
Es werden zusätzlich Informationen über den angegebenen logischen Namen und das zugeordnete Installation-Item ausgegeben.
Als logischer Name kann auch eine Musterzeichenfolge angegeben werden, in der das Zeichen * (Stern) als Platzhalter für eine beliebige Zeichenfolge verwendet wird. Die zusätzlichen Informationen werden dann für alle logischen Namen ausgegeben, die dieser Musterzeichenfolge entsprechen.
LOGICAL-IDENTIFIER = *NONE
Es werden nur Informationen über die ausgewählte Installation-Unit ausgegeben.
SCI-NAME =
Bestimmt das SCI (System Configuration Inventory), aus dem die Information ausgegeben wird.
SCI-NAME = *STD
Die Information wird aus dem Standard-SCI (siehe MODIFY-IMON-SCI) ausgegeben.
SCI-NAME = <filename 1..54 without-cat-user-gen-vers>
Name eines Fremd-SCI (Katalogkennung ungleich Home-Pubset bzw. kein Standardname).
OUTPUT =
Bestimmt das Ziel der Ausgabe.
OUTPUT = *SYSOUT
Die Information wird nach SYSOUT ausgegeben.
OUTPUT = *SYSLST(...)
Die Information wird nach SYSLST ausgegeben.
SYSLST-NUMBER =
Nummer von SYSLST.
SYSLST-NUMBER = *STD
Die Information wird nach Standard-SYSLST ausgegeben.
SYSLST-NUMBER = <integer 1..99>
Explizite Angabe der Nummer von SYSLST.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kommando erfolgreich ausgeführt | |
32 | IMO9101 | Kommando abnormal beendet. Interner Fehler in IMON-GPN | |
64 | IMO9100 | Kommando nicht ausgeführt. Installation-Unit, Version oder logischer Name nicht gefunden. |
Ausgabe in S-Variable
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
|---|---|---|---|---|
Funktionszustand, in dem die Installation-Unit abläuft | var(*LIST).IU-FU-LEVEL | S | *BOTH | |
Name der Installation-Unit | var(*LIST).IU-NAME | S | <c-string 1..30> | |
Version der Installation-Unit | var(*LIST).IU-VERSION | S | ’’ | |
Sperrstatus der Installation-Unit (nur für privilegierte Benutzer) | var(*LIST).IU-LOCKED | S | *YES | |
Dummy-Installation-Item liegt vor | var(*LIST).IU-II-LIST(*LIST).II-DUMMY | B | FALSE | |
Pfadname wurde voll- oder teilqualifiziert ausgegeben | var(*LIST).IU-II-LIST(*LIST).II-FILETYPE | S | *FULL | |
Funktionszustand, in dem das Installation-Item abläuft | var(*LIST).IU-II-LIST(*LIST).II-FU-LEVEL | S | *BOTH | |
Logischer Name des Installation-Items | var(*LIST).IU-II-LIST(*LIST).II-LOGICAL-ID | S | <filename 1..30> | |
Der zu einem logischen Namen gehörende Pfadname muss während der Installation vorhanden sein | var(*LIST).IU-II-LIST(*LIST).II-MANDATORY | B | FALSE | |
Pfadname des Installation-Items | var(*LIST).IU-II-LIST(*LIST).II-PATH-NAME | S | <filename 1..54> | |
Hardware-Ausprägung des Installation-Items | var(*LIST).IU-II-LIST(*LIST).II-TARGET | S | <text 1..1> | |
Der zum logischen Namen gehörende Dateiname darf nach der Installation geändert werden | var(*LIST).IU-II-LIST(*LIST).II-UPDATE | B | FALSE |
Beispiel
Information über die Syntaxdatei des Produkts LMS ausgeben
/show-inst-path inst-unit=lms,logic-id=syssdf
INSTALLATION UNIT: LMS VERSION : 03.4B00
FU-LEVEL: TU
LOGICAL-ID: SYSSDF TARGET: A (ANY)
PATH-NAME: :1OSH:$TSOS.SYSSDF.LMS.034
MANDATORY: YES UPDATE: NO DUMMY: NO FILENAME: FULL FU-LEVEL: TU
% IMO9001 Command successfully processed
Information über alle Installations-Units ausgeben
/show-inst-path inst-unit=*all,logic-id=*none
INSTALLATION UNIT: ACS VERSION : 20.0A00
FU-LEVEL: TU
INSTALLATION UNIT: AID VERSION : 03.4B23
FU-LEVEL: BOTH
.
.
.
INSTALLATION UNIT: WEBTRANS-OSD VERSION : 07.5B00
FU-LEVEL: TU
INSTALLATION UNIT: WEBTRANS-UTM VERSION : 07.5B00
FU-LEVEL: TU
INSTALLATION UNIT: XCS-TIME VERSION : 20.0A00
FU-LEVEL: TPR
INSTALLATION UNIT: XHCS-SYS VERSION : 02.2A02
FU-LEVEL: BOTH
% IMO9012 Insufficient privilege to show more information
% IMO9001 Command successfully processed