Beschreibungsstand: Funktionsbereich: Anwendungsbereich: Privilegierung: | NSM V21.0A Pubset- und MRSCAT-Verwaltung MULTI-CATALOG-AND-PUBSET-MGMT TSOS |
Berechtigungsschlüssel: | @ |
Funktionsbeschreibung
Das Kommando SHOW-NSM-CONFIGURATION informiert in einem XCS-Verbund über den Zustand des Subsystems NSM und der Partner des Verbunds. Die Informationsausgabe erfolgt aus der Sicht des lokalen Systems.
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable.
Format
SHOW-NSM-CONFIGURATION | ||||||||||||||||||||||||
|
Operandenbeschreibung
INFORMATION = *SUMMARY / *ALL / *HOSTS(...)
Legt die gewünschte Information fest.
INFORMATION = *SUMMARY
Voreinstellung: Eine Übersicht über die lokalen Einstellungen des NSM und den Zustand des Verbindungssystems wird ausgegeben.
INFORMATION = *ALL
Es wird die gesamte Information über das Subsystem NSM im aktuellen XCS-Verbund des eigenen Rechners ausgegeben. Die Ausgabe umfasst folgende Informationen:
die lokalen NSM-Konfigurationsparameter
die Verbindungs- und Verbunddaten aller Rechner im aktuellen XCS-Verbund.
INFORMATION = *HOSTS(...)
Die Verbindungs- und Verbunddaten für die mit SELECT festgelegten Rechner wird ausgegeben.
SELECT = *ALL / <hostname>
Bestimmt für welche Rechner Informationen ausgegeben werden.
SELECT = *ALL
Es wird über alle Rechner informiert, mit denen eine NSM-Verbundbeziehung besteht.
SELECT = <alphanum-name 1..8>
Es werden Informationen über den angegebenen Rechner ausgegeben.
OUTPUT = *SYSOUT / SYSLST(...)
Legt fest, wohin die Information ausgegeben wird.
OUTPUT = *SYSOUT
Voreinstellung: Die Ausgabe erfolgt in die Systemdatei SYSOUT.
OUTPUT = SYSLST(...)
Die Ausgabe erfolgt in die Systemdatei SYSLST.
SYSLST-NUMBER = *STD / <integer 1..99>
Legt fest, ob die Ausgabe in die Systemdatei SYSLST oder in eine SYSLST-Datei aus der Menge SYSLST01 bis SYSLST99 erfolgen soll.
SYSLST-NUMBER = *STD
Voreinstellung: Die Ausgabe erfolgt in die Systemdatei SYSLST.
SYSLST-NUMBER = <integer 1..99>
Die Ausgabe erfolgt in eine SYSLST-Datei aus der Menge SYSLST01 bis SYSLST99.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
---|---|---|---|
0 | CMD0001 | Kommando ohne Fehler ausgeführt | |
0 | NLX1020 | Keine Information für aktuelle Auswahl | |
3 | CMD2203 | Falsche Syntaxdatei | |
32 | CMD0221 | Systemfehler (interner Fehler) | |
32 | CMD2009 | Fehler bei Ausgabe in strukturierte S-Variable | |
32 | NLX1019 | Fehler bei Bearbeitung des Kommandos | |
64 | CMD0216 | Erforderliches Privileg fehlt | |
130 | NLX1019 | Fehler bei Bearbeitung des Kommandos; Wiederholung später möglich |
Ausgabeformat
Der Inhalt der Ausgabe hängt von der getroffenen Auswahl ab:
Ausgabe mit INFORMATION=*SUMMARY
/SHOW-NSM-CONFIGURATION INFORMATION=*SUMMARY SHOW-NSM-CONFIGURATION DATE: yyyy-mm-dd, TIME: hh:mm:ss ----------------------------------------------------------------------------- SUMMARY OWN HOST NAME = D017ZE30 XCS NAME = XCS NSM VERSION = V21.0A COMM = *BY-MSCF COMM-STATE = *MSCF-ACTIVE COMM-TYPE = *TOKEN-RING MINIMUM TOKEN-DELAY TIME = 15 MAXIMUM TOKEN-DELAY TIME = 100 ----------------------------------------------------------------------------- SHOW-NSM-CONFIGURATION END OF DISPLAY
Ausgabe mit INFORMATION=*HOSTS(*ALL)
/SHOW-NSM-CONFIGURATION INFORMATION=*HOSTS(*ALL) SHOW-NSM-CONFIGURATION DATE: yyyy-mm-dd, TIME: hh:mm:ss ----------------------------------------------------------------------------- HOSTS NUM OF HOSTS = 2 HOST NAME COMM STATE SYS VERSION NSM VERSION ----------------------------------------------------------------------------- D016ZE01 MSCF ACTIVE V21.0A V21.0A D016ZE02 LOCAL HOST V21.0A V21.0A ----------------------------------------------------------------------------- SHOW-NSM-CONFIGURATION END OF DISPLAY
Erläuterung zur Ausgabe
Nachfolgend sind in alphabetischer Reihenfolge die Ausgabefelder mit ihren möglichen Werten beschrieben. Zu beachten ist, dass bei allen Ausgabefeldern zusätzlich das Schlüsselwort UNDEFINED möglich ist (UNDEFINED: Es liegt keine Information vor), das in der Tabelle aber nicht gesondert aufgeführt wird.
Ausgabefeld | Schlüsselwort / Bedeutung |
| Status der Rechner im Hinblick auf die Verbindung:
|
| Kommunikationsmethode: *TOKEN-RING |
| Kommunikationsweg:
|
| Host-Name des Partners (wie auch vom Kommando SHOW-MSCF-CONFIGURATION ausgegeben) |
| Festgelegte Zeit (1..32767 ms), die ein Token im Leerlauf für einen Umlauf mindestens braucht. |
| Festgelegte Zeit (0..32767 ms), die ein Token im Normalbetrieb für einen Umlauf mindestens braucht. |
| NSM-Version, die auf dem Rechner oder dem Partner abläuft. |
| Anzahl der Rechner (1..16), über die informiert wird |
| Name des eigenen (lokalen) Rechners |
| BS2000-Version, die auf dem (Partner-) Rechner abläuft. |
| Name des XCS-Verbunds:
|
Ausgabe in S-Variable
Mit dem Operanden INFORMATION des Kommandos wird festgelegt, welche S-Variablen angelegt werden. Folgende Angaben sind für INFORMATION möglich:
Schreibweise im Kommando | gekürzte Schreibweise in Tabelle |
INFORMATION = *SUMMARY | 1 |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
Anzahl der Rechner, über die informiert wird | var(*LIST).ALL.HOSTS.NUM-OF-HOSTS | I | <integer 1 .. 16> | 3 |
Name des lokalen Rechners oder des Partners | var(*LIST).ALL.HOSTS.HOST(*LIST).HOST-NAME | S | <c-string 1 .. 8> | 3 |
Status der Rechner im Hinblick auf die Verbindung | var(*LIST).ALL.HOSTS.HOST(*LIST).COMM-STATE | S | *NONE | 3 |
BS2000-Version, die auf dem lokalen Rechner oder dem Partner abläuft | var(*LIST).ALL.HOSTS.HOST(*LIST).SYS-VERSION | S | <c-string 1 .. 6> | 3 |
NSM-Version, die auf dem lokalen Rechner oder dem Partner abläuft | var(*LIST).ALL.HOSTS.HOST(*LIST).NSM-VERSION | S | <c-string 1 .. 6> | 3 |
Kommunikationsweg | var(*LIST).ALL.SUMMARY.COMM | S | *BY-MSCF | 3 |
Kommunikationsmethode | var(*LIST).ALL.SUMMARY.COMM-TYPE | S | *TOKEN-RING | 3 |
Status der Rechner im Hinblick auf die Verbindung | var(*LIST).ALL.SUMMARY.COMM-STATE | S | *NONE | 3 |
NSM-Version auf dem lokalen Rechner | var(*LIST).ALL.SUMMARY.NSM-VERSION | S |
| 3 |
Festgelegte Zeit, die ein Token im Leerlauf für einen Umlauf mindestens braucht. | var(*LIST).ALL.SUMMARY.MAX-DELAY-TIME | I | <integer 1 .. 32767> | 3 |
Festgelegte Zeit, die ein Token im Normalbetrieb für einen Umlauf mindestens braucht. | var(*LIST).ALL.SUMMARY.MIN-DELAY-TIME | I | <integer 0 .. 32767> | 3 |
Name des lokalen Rechners | var(*LIST).ALL.SUMMARY.HOST-NAME | S | <c-string 1 .. 8> | 3 |
Name des XCS-Verbunds | var(*LIST).ALL.SUMMARY.XCS-NAME | S | <c-string 1 .. 8> | 3 |
Anzahl der Rechner, über die informiert wird | var(*LIST).HOSTS.NUM-OF_HOSTS | I | <integer 1 .. 16> | 2 |
Name des lokalen Rechners oder des Partners | var(*LIST).HOSTS.HOST(*LIST).HOST-NAME | S | <c-string 1 .. 8> | 2 |
Status der Rechner im Hinblick auf die Verbindung | var(*LIST).HOSTS.HOST(*LIST).COMM-STATE | S | *NONE | 2 |
BS2000-Version, die auf dem lokalen Rechner oder dem Partner abläuft | var(*LIST).HOSTS.HOST(*LIST).SYS-VERSION | S | <c-string 1 .. 6> | 2 |
NSM-Version, die auf dem lokalen Rechner oder dem Partner abläuft | var(*LIST).HOSTS.HOST(*LIST).NSM-VERSION | S | <c-string 1 .. 6> | 2 |
Kommunikationsweg | var(*LIST).SUMMARY.COMM | S | *BY-MSCF | 1 |
Kommunikationsmethode | var(*LIST).SUMMARY.COMM-TYPE | S | *TOKEN-RING | 1 |
Status der Rechner im Hinblick auf die Verbindung | var(*LIST).SUMMARY.COMM-STATE | S | *NONE | 1 |
Name des lokalen Rechners | var(*LIST).SUMMARY.HOST-NAME | S | <c-string 1 .. 8> | 1 |
Festgelegte Zeit, die ein Token im Leerlauf für einen Umlauf mindestens braucht. | var(*LIST).SUMMARY.MAX-DELAY-TIME | I | integer 1 .. 32767> | 1 |
Festgelegte Zeit, die ein Token im Normalbetrieb für einen Umlauf mindestens braucht. | var(*LIST).SUMMARY.MIN-DELAY-TIME | I | <integer 0 .. 32767> | 1 |
NSM-Version auf dem lokalen Rechner | var(*LIST).SUMMARY.NSM-VERSION | S |
| 1 |
Name des XCS-Verbunds | var(*LIST).SUMMARY.XCS-NAME | S | <c-string 1 .. 8> | 1 |
Beispiele
|