VM2000-Kommandos
8.2 Kommando-Returncodes
VM2000 liefert Informationen über die Analyse der Kommandoeingabe und die Komman-
doausführung in einem Kommando-Returncode. Dieser Kommando-Returncode ist ver-
gleichbar mit dem Returncode auf Programmebene und ermöglicht es, auf bestimmte Feh-
lersituationen gezielt zu reagieren.
Der Kommando-Returncode besteht aus drei Teilen:
dem Maincode, der einem Meldungsschlüssel entspricht, über den mit dem Kommando
●
/HELP-MSG-INFORMATION
dem Subcode1, der die aufgetretene Fehlersituation in eine Fehlerklasse einordnet,
●
aus der abgeleitet werden kann, wie schwerwiegend ein Fehler ist.
dem Subcode2, der Zusatzinformationen (Wert ungleich Null) enthalten kann.
●
Kommando-Returncodes, die ein VM2000-Kommando bei der Ausführung zurückgeben
kann, sind Bestandteil der jeweiligen Kommandobeschreibung und werden im Anschluss
daran tabellarisch unter Angabe von Subcode2, Subcode1, Maincode und Bedeutungstext
aufgelistet. VM2000 kennt folgende allgemeine Returncodes:
(SC2)
i
Kommando-Returncodes in einer Benutzertask
Bei Eingabe von VM2000-Kommandos über eine privilegierte Benutzertask wird der Kom-
mando-Returncode in standardisierte S-Variablen abgelegt und kann mit den Builtin-Funk-
tionen
MAINCODE
Handbuch „Kommandos" [12].
U5183-J-Z125-12
SC1
Maincode
0
CMD0001
1
CMD0202
32
CMD0221
64
CMD0216
65
CMD2241
128
CMD2280
128
VMS4504
128
VMS4513
130
VMS6000
130
VMS6001
64
VMS9001
64
VMS9004
VM2000-Informationskommandos lösen auch bei SC1 ungleich Null und Einstel-
lung
ERROR-MECHANISM=*SPIN-OFF-COMPATIBLE
den Spin-Off-Mechanismus nicht aus.
,
und
SUBCODE1
detaillierte Informationen abgefragt werden können.
Bedeutung
Kommando erfolgreich ausgeführt
Syntax- oder Semantikfehler
Interner Systemfehler
Erforderliches Privileg nicht vorhanden
Subsystem nicht geladen
Subsystem nicht verfügbar
Speicherengpass im Monitor
Speicherengpass im VM2000-Hypervisor
VM2000-Agent nicht verfügbar
Administrationskomponente des Trägersystems nicht verfügbar
Funktion nicht verfügbar für Eingabemedium oder Gastsystem
Funktionalität auf aktuellem HSI oder mit aktueller Parametrisie-
rung nicht unterstützt
von SDF-P-BASYS ausgewertet werden, siehe
SUBCODE2
Kommando-Returncodes
(
SET-/MODIFY-PROCEDURE-OPTIONS
)
423