DELETE-VM (VM beenden)

Mit /DELETE-VM werden eine oder mehrere VMs beendet. Die Gerätezuordnung, die Zuordnung zu einem CPU-Pool, die Zuordnung zu einer VM-Gruppe und die Initialisierung der VM werden damit aufgehoben. Die VM-Definition einer nicht-persistenten VM wird gelöscht. Die VM-Definition einer persistenten VM bleibt erhalten.
Das Kommando kann nicht auf die Monitor-VM angewendet werden.

Auf SU x86 wird die Hauptspeicherfreigabe asynchron ausgeführt und kann mehrere Sekunden dauern. Der freigegebene Speicher steht erst dann für andere oder neue VMs zur Verfügung.

Bei /DELETE-VM werden implizit alle ADMIN-Dialoge mit der VM und alle VC-Dialoge mit dem Gastsystem auf der VM beendet. Die Ausgabe von periodischen Messwerten (/SHOW-VM-STATUS PERIOD=<integer>) für die VM wird ebenfalls beendet.

Mit /DELETE-VM ...,CHECK-VM-STATE=*NO wird ein laufendes Gastsystem sofort beendet. Deshalb können Dateien des Gastsystems, das auf der VM abläuft, in einem inkonsistenten Zustand sein. Um dies auszuschließen, sollte vor dem Beenden der VM im Gastsystem ein Shutdown durchgeführt werden.

Konnte /DELETE-VM nicht ausgeführt werden, verbleibt die VM im Zustand IN HOLD. Eine Fortsetzung des Gastsystemlaufes mit /RESUME-VM ist normalerweise nicht möglich, da der VM schon wichtige Ressourcen entzogen sein können.

    

DELETE-VM

VM-IDENTIFICATION = *CURRENT / *ALL / <integer 1..99> / <name 1..8>

,CHECK-VM-STATE = *YES / *NO

VM-IDENTIFICATION =
Identifikation der virtuellen Maschine.

VM-IDENTIFICATION = *CURRENT
Es wird die VM-Identifikation genommen, die mit einem zuvor gegebenen /BEGIN-VM-DIALOG zugewiesen wurde.

VM-IDENTIFICATION = *ALL
Es sollen alle VMs beendet werden.
Dieser Operandenwert ist nur dem VM2000-Administrator erlaubt.

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>
Identifikation der virtuellen Maschine durch VM-Index oder VM-Name.

CHECK-VM-STATE =
Bestimmt, abhängig vom derzeitigen Zustand der VM, ob das Kommando ausgeführt wird.

CHECK-VM-STATE = *YES
Das Kommando wird nur ausgeführt, wenn sich die VM im Zustand DOWN oder im Zustand INIT-ONLY befindet. Eine VM kann nicht mit CHECK-VM-STATE=*YES beendet werden, während sie migriert wird (VM-Migration).

CHECK-VM-STATE = *NO
Das Kommando wird unabhängig vom Zustand der VM ausgeführt.

Kommando-Returncodes

(SC2)   SC1	Maincode	Bedeutung
0 1             0 2             0 2             0 64 64 64 64 128	CMD0001 CMD0001 VMS2306 VMS2308 VMS3040 VMS4000 VMS4002 VMS9005 VMS3042	Kommando erfolgreich ausgeführt Keine Aktion erforderlich VM-Definition konnte nicht aktualisiert werden (SU /390, persistente VM) VM-Definition konnte nicht gelöscht werden (SU /390, nicht-persistente VM) Zustand der VM verhindert Kommandoausführung VM noch nicht initialisiert VM konnte nicht beendet werden Kommando nicht oder nur teilweise bearbeitet VM wird migriert

Garantierte Meldungen

VMS3041, VMS4002, VMS4024, VMS4429, VMS4619
und die garantierten Meldungen bei /REMOVE-VM-DEVICES.

Beispiel

/delete-vm vm-id=system2,check-vm-state=*no ———————————————————————————— (1)
VMS4009 DEVICE 'CG' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
VMS4009 DEVICE 'CH' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
VMS4009 DEVICE '505A' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
VMS4009 DEVICE '505F' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
VMS4009 DEVICE '5060' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
VMS4619 VIRTUAL MACHINE (2,SYSTEM2) REMOVED FROM CPU POOL '*STDPOOL'
VMS4024 VIRTUAL MACHINE (2,SYSTEM2) TERMINATED—————————————————————————  (2)

-----------------------------------------------------------------------------------------------------------------

(1)	Die VM mit dem Namen SYSTEM2 wird vom VM2000-Administrator ohne Rücksicht auf den Systemzustand beendet.
(2)	VM2000 meldet das Beenden der VM2.