SHOW-IOCF

Informationen über IOCF ausgeben

Komponente:	IOCFCOPY
Funktionsbereich:	System steuern und optimieren
Anwendungsbereich:	SYSTEM-MANAGEMENT
Privilegierung:	TSOS                                                                                                          OPERATING
Berechtigungsschlüssel:	@

Funktionsbeschreibung

Mit dem Kommando kann sich die Systembetreuung über das aktive IOCF (der laufenden Session) und über alle IOCFs, die auf dem Serviceprozessor vorhandenen sind, informieren. Die Informationsausgabe kann nach SYSOUT oder SYSLST erfolgen.

Dieses Kommando kann auch an einer Konsole eingegeben werden. Die Ausgabe erfolgt dann stets asynchron und geblockt auf der Konsole.

Format

SHOW-IOCF                                                                                                                                                

 LEVEL-NAME = *ALL / *ACTIVE / <integer 0..9>

,OUTPUT = *SYSOUT / *SYSLST

Operandenbeschreibung

LEVEL = *ALL
Informationen über das aktive IOCF und über alle vorhandenen IOCFs (mit Levelnummer) werden ausgegeben.

LEVEL = *ACTIVE
Informationen über das aktuelle IOCF werden ausgegeben.

Kann auf das Level nicht zugegriffen werden, weil nur eine Buskonfiguration eingestellt ist, wird *** BUS CONFIGURATION WITHOUT IOCF *** ausgegeben.

LEVEL = <integer 0..9>
Levelnummer des IOCF, über das Informationen ausgegeben werden sollen. Der Wertebereich umfasst alle vorhandenen Level.
Die maximale Anzahl der Levels ist hardware-abhängig.

• Ist die Levelnummer nicht vorhanden, wird das Kommando abgewiesen.

• Ist das Level leer (z.B. bei neuen Anlagen) oder können die Daten nicht ausgewertet werden, wird *** INVALID DATA OR EMPTY LEVEL *** ausgegeben.

• Kann auf das Level nicht zugegriffen werden, wird *** INFORMATION NOT AVAILABLE *** ausgegeben.

OUTPUT = *SYSOUT
Die Informationen werden nach SYSOUT ausgegeben.

OUTPUT = *SYSLST
Die Informationen werden nach SYSLST ausgegeben. Bei Eingabe an einer Konsole wird diese Angabe in OUTPUT=*SYSOUT geändert (Kommando-Returncode IOF0127).

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Kommando ohne Fehler ausgeführt
2	0	IOF0114	Angegebenes IOCF ist leer
2	0	IOF0127	Parameter OUTPUT auf SYSOUT verändert, da SYSLST auf Konsole nicht möglich
	1	CMD2201	Parameterfehler: Mindestens ein Wert aus dem Kommandoaufruf ist fehlerhaft (z.B. Datei nicht vorhanden, falsches Format oder falscher Inhalt der Datei, Levelnummer existiert nicht, ...). Die genaue Fehlerursache ist in einer vorangehenden Meldung enthalten.
	32	CMD0221	Systemfehler: Eine aufgerufene Systemschnittstelle meldet Fehler. Die genaue Fehlerursache ist in einer vorangehenden Meldung enthalten.
	64	CMD0216	Erforderliche Berechtigung fehlt

Format der Ausgabe

LEVEL xxx:  hh:mm yy.ddd zzzzz BLOCKS
<comment>

wobei

xxx	Levelnummer 1 bis 9 oder ACT (aktives IOCF)
hh:mm	Generierungszeit
yy.ddd	Generierungsjahr und Generierungstag (julianisches Datum)
zzzzz	Anzahl der Blöcke zu je 256 Byte im IOCF
<comment>	64 Byte langer Kommentar, unverändert aus dem IOCF entnommen. Enthält u.a. den 8 Byte langen Namen des IOCF.

Beispiel

Information über das aktive IOCF

/show-iocf level=*active

%LEVEL ACT:   21:20  14.278   189 BLOCKS 
%        S1900006 / TESTSYSTEM             / 05.10.2014