Mit /SHUTDOWN-VM wird ein Shutdown (ohne Restart) in den ausgewählten Gastsystemen ausgeführt.
Der Shutdown kann für das VM2000-Gesamtsystem (alle Gastsysteme und das Monitorsystem) sowie für alle oder ein einzelnes Gastsystem (mit Ausnahme des Monitorsystems) ausgeführt werden.
Der Shutdown im Gastsystem einer VM kann nicht ausgeführt werden, während die VM migriert wird (VM-Migration).
Hinweise zur Kommandoausführung finden Sie im Abschnitt "Shutdown im Gastsystem und von VM2000".
| Auch der VM2000-Betrieb kann (analog dem koordinierten Shutdown) auf der SU x86 über den SE Manager beendet werden, siehe Abschnitt „Monitorsystem und VM2000 beenden". |
SHUTDOWN-VM | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
VM-IDENTIFICATION =
Identifikation der virtuellen Maschine, für deren Gastsystem der Shutdown ausgeführt werden soll.
VM-IDENTIFICATION = *CURRENT
Es wird die VM-Identifikation genommen, die mit einem zuvor gegebenen /BEGIN-VM-DIALOG zugewiesen wurde.
VM-IDENTIFICATION = *VM2000(...)
Der Shutdown soll für das VM2000-Gesamtsystem (mit allen Gastsystemen) koordiniert ausgeführt werden. Für alle Gastsysteme wird der Shutdown eingeleitet. Das Monitorsystem wird als letztes Gastsystem beendet. Dabei werden auch alle VMs beendet.
Der koordinierte Shutdown für das VM2000-Gesamtsystem kann nicht ausgeführt werden, während eine VM migriert wird (VM-Migration).
WAITING-TIME =
Legt die Zeit fest, die vor der Beendigung des Monitorsystems höchstens darauf gewartet werden soll, dass alle virtuellen Maschinen den Zustand INIT-ONLY oder DOWN haben. Die Wartezeit beginnt mit dem Start der Enter-Jobs bzw. mit dem Einleiten des Shutdown-Processing (MODE=*END) in den Gastsystemen. In dieser Zeit bleibt das Monitorsystem im normalen Betrieb. Es können auch noch VM2000-Kommandos eingegeben werden, siehe "Shutdown im Gastsystem und von VM2000".
Die maximale Wartezeit sollte größer gewählt werden als die größte SHUTCTL-Wartezeit in den Gastsystemen, siehe Systemparameter SHUTCTL im Handbuch „Systembetreuung“ [2]. Die Gastsysteme können damit beendet werden, bevor das Monitorsystem beendet wird.
WAITING-TIME = *UNLIMITED
Das Monitorsystem wartet vor dem eigenen Shutdown unbegrenzt auf die Beendigung der übrigen Gastsysteme.
WAITING-TIME = <integer 1..60> minutes
Maximale Wartezeit in Minuten, die im Monitorsystem vor dem eigenen Shutdown auf die Beendigung der übrigen Gastsysteme (nach dem QUIET-Zustand) gewartet werden soll. Alle Gastsysteme (mit Ausnahme des Monitorsystems) werden nach Ablauf der Wartezeit implizit durch /DELETE-VM CHECK-VM-STATE=*NO unabhängig von ihrem Zustand beendet.
VM-IDENTIFICATION = *VM-GUESTS
Der Shutdown soll für alle Gastsysteme mit Ausnahme des Monitorsystems und Gastsystemen auf VMs, für die eine VM-Migration läuft, ausgeführt werden.
VM-IDENTIFICATION = <integer 1..99> / <name 1..8>
Identifikation der virtuellen Maschine durch VM-Index oder VM-Name.
ACTION =
Legt das Verfahren für die Systembeendigung eines Gastsystems fest.
ACTION = *SHUTDOWN(...)
Die Systembeendigung eines Gastsystems erfolgt durch VM2000 über den Aufruf des Shutdown-Processing (analog dem BS2000-Kommando /SHUTDOWN). Das Operating im Gastsystem wird darüber mit der Meldung NRT1201 informiert.
QUIET-TIME =
Zeit in Minuten, in der das Gastsystem im QUIET-Zustand bleibt, bevor es beendet wird.
| Auf SU /390 werden von VM2000 beim Shutdown noch die VM-Definitionen bearbeitet. Für diese Aktion muss BCAM im Monitorsystem noch aktiv sein. Deshalb sollte beim koordinierten Shutdown von VM2000 (/SHUTDOWN-VM VM-ID=*VM2000...) der Operand QUIET-TIME=0 gewählt werden. |
QUIET-TIME = 0
Die Systembeendigung wird sofort eingeleitet.
QUIET-TIME = <integer 1..60> minutes
Die Systembeendigung wird in zwei Schritten ausgeführt:
1) Das System wird zunächst in den QUIET-Zustand versetzt:
- alle Dialogteilnehmer des Systems werden über die bevorstehende Systembeendigung informiert
- die Auftragsannahme wird beendet
- neue Benutzer werden nicht mehr zugelassen
Das Gastsystem bleibt für die festgelegte QUIET-TIME in diesem Zustand.
Das Operating im Gastsystem wird über die Länge der QUIET-TIME informiert.
2) Nach Ablauf der QUIET-TIME wird die endgültige Systembeendigung eingeleitet.
ACTION = *ENTER-JOB
Die Systembeendigung eines Gastsystems soll durch einen Enter-Job erfolgen. Die Kommandodatei wird im Gastsystem in der Datei $TSOS.SYS.VM.SHUTDOWN erwartet. Die letzte Aktion der kundenspezifischen Vorbereitungen muss das BS2000-Kommando /SHUTDOWN MODE=*NO/*END(RESTART=*NO) sein. Zur Ausführung von /SHUTDOWN wird das Privileg OPERATING benötigt (siehe "Privilegierung der Benutzertask im Monitorsystem").
Kommando-Returncodes
(SC2) | Maincode | Bedeutung |
0 | CMD0001 | Kommando erfolgreich ausgeführt |
Garantierte Meldungen
VMS2054, VMS2055, VMS2056, VMS2057, VMS2058, VMS2070, VMS2100, VMS2104, VMS3041
Beispiel
/shutdown-vm vm-id=*vm2000(waiting-time=*unlimited), action=*shutdown(quiet-time=0) —————————————— (1) VMS2054 SHUTDOWN OF GUEST SYSTEM ON VM (2,SYSTEM2) INITIATEDVMS2054 SHUTDOWN OF GUEST SYSTEM ON VM (3,SYSTEM3) INITIATEDVMS2100 VM2000 SHUTDOWN INITIATED
----------------------------------------------------------------------------------------------------------------
(1) | Der VM2000-Administrator leitet den koordinierten Shutdown von VM2000 ein. Das Monitorsystem würde unbegrenzt auf die Beendigung der Gastsysteme warten. |
----------------------------------------------------------------------------------------------------------------
Siehe auch das ausführliche „Beispiel für einen koordinierten Shutdown von VM2000".