SWITCH-VM-DEVICES (Geräte einer VM entziehen und einer anderen VM zuordnen)

Mit /SWITCH-VM-DEVICES werden (explizit oder implizit zugeordnete) Geräte einer VM explizit entzogen und einer anderen VM explizit zugeordnet. Einzelne Geräte werden über ihre mnemotechnischen Gerätenamen angesprochen. Die Geräte eines Pubset werden über die Katalogkennung des Pubset oder den mnemotechnischen Gerätenamen des Pubres-Gerätes bestimmt.

Wurde mit /ADD-VM-DEVICES eine Geräteeigenschaft festgelegt (Operand TYPE), bleibt sie bei /SWITCH-VM-DEVICES erhalten. Für implizit zugeordnete Geräte bleibt die Benutzungsart (EXCLUSIVE/SHARED) erhalten.

Der Monitor-VM können der Home-Pubset und weitere, importierte Pubsets, Paging-Platten und die letzte Konsole nicht entzogen werden.

Die entzogenen und zugeordneten Geräte werden in den VM-Definitionen der VMs gestrichen bzw. vermerkt.

Die zu entziehenden Geräte sollten im zugehörigen Gastsystem zuvor mit /DETACH-DEVICE weggeschaltet werden.

Die Geräte müssen danach im Gastsystem, dem sie zugeordnet werden, zugeschaltet werden, damit sie in diesem angesprochen werden können.

Alias-Geräte (PAV/DPAV) und CRD-Geräte können nicht explizit entzogen oder zugeordnet werden.

Dieses Kommando ist nur dem VM2000-Administrator erlaubt.

 

SWITCH-VM-DEVICES

UNITS = *ALL(...) / *PUBSET-DEVICES(...) /
				list-poss(28): *DEVICE-RANGE(...) / <alphanum-name 1..4 with-wild(20)>
	*ALL(...)
		|	CHECK-VM-STATE = *YES / *NO
	*PUBSET-DEVICES(...)
		|	PUBSET = *BY-PUBRES-DEVICE(...) / <cat-id 1..4>
		|		*BY-PUBRES-DEVICE(...)
		|			|	UNIT = <alphanum-name 2..2> / <x-text 4..4>
	*DEVICE-RANGE(...)
		|	FROM = <alphanum-name 2..2> / <x-text 4..4>
		|	,TO = <alphanum-name 2..2> / <x-text 4..4>
,FROM-VM = <integer 1..99> / <name 1..8>
,TO-VM = <integer 1..99> / <name 1..8>
,FORCE = *NO / *YES

UNITS =
Legt die Geräte fest, die der FROM-VM entzogen und der TO-VM zugeordnet werden sollen.

UNITS = *ALL(...)
Alle der FROM-VM zugeordneten Geräte sollen entzogen und neu zugeordnet werden. Falls ein Gerät nicht entzogen werden kann, wird das Kommando für dieses Gerät nicht ausgeführt. Alias- und CRD-Geräte werden nur entzogen (implizit).

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

CHECK-VM-STATE = *YES
Das Kommando wird nur ausgeführt, wenn sich die FROM-VM im Zustand DOWN oder im Zustand INIT-ONLY befindet.

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

UNITS = *PUBSET-DEVICES(...)
Alle Geräte eines Pubset sollen entzogen und neu zugeordnet werden.

Siehe auch „Hinweise zur Pubset-Angabe in den VM2000-Kommandos" und „Pubset-Rekonfiguration".

PUBSET = *BY-PUBRES-DEVICE(...)
Bestimmt die Geräte des Pubset über das Pubres-Gerät.

UNIT = <alphanum-name 2..2> / <x-text 4..4>
Mnemotechnische Gerätebezeichnung des Pubres-Geräts.

PUBSET = <cat-id 1..4>
Katalogkennung des Pubset.
Der Pubset muss mit seinem Pubres-Gerät im MRS-Katalog des Monitorsystems eingetragen sein.

UNITS = *DEVICE-RANGE(...)
Alle in diesem Namensbereich liegenden Geräte sollen entzogen und neu zugeordnet werden.

Gerätenamen <x-text 4..4> (bei *DEVICE-RANGE) werden von FROM nach TO gemäß hexadezimaler Sortierung ausgewählt. Sonst werden Gerätenamen <alphanum-name 2..2> gemäß alphabetischer Sortierung ausgewählt.

Bei UNITS-Angabe mit *DEVICE-RANGE oder Wildcards werden Geräte, die der FROM-VM nicht zugeordnet sind, ignoriert.

Auf SU /390 werden zusätzlich Alias-Geräte (PAV/DPAV) und CRD-Geräte ignoriert.

FROM = <alphanum-name 2..2> / <x-text 4..4>
Bestimmt den Anfang des Namensbereichs.

TO = <alphanum-name 2..2> / <x-text 4..4>
Bestimmt das Ende des Namensbereichs. Der mnemotechnische Gerätename muss im gleichen Wertebereich (2- oder 4-stellige mn) wie der FROM-Gerätename liegen und in der aufsteigenden Sortierreihenfolge des Wertebereichs größer oder gleich dem FROM-Gerätenamen sein.

UNITS = <alphanum-name 1..4 with-wild(20)>
Legt die Geräte fest, die entzogen und neu zugeordnet werden sollen.

FROM-VM = <integer 1..99> / <name 1..8>
Identifikation der VM, der die Geräte entzogen werden sollen, durch VM-Index oder VM-Name.

TO-VM = <integer 1..99> / <name 1..8>
Identifikation der VM, der die Geräte zugeordnet werden sollen, durch VM-Index oder VM-Name.

FORCE =
Legt die Randbedingungen fest, unter denen Geräte der FROM-VM entzogen werden.

FORCE = *NO
Das Gerät wird der FROM-VM entzogen, wenn sich die FROM-VM im Zustand DOWN bzw. INIT-ONLY befindet oder wenn das Gerät im Gastsystem weggeschaltet ist. Es wird aber nicht entzogen, wenn eine Ein-/Ausgabe für das Gerät aussteht, wenn sich die FROM-VM im Wartezustand (nach /HOLD-VM) befindet oder wenn sich das Gastsystem in der Startup-Phase befindet.
Die Gerätekonfiguration einer VM kann nicht mit FORCE=*NO verändert werden, während sie migriert wird (VM-Migration).

FORCE = *YES
VM2000 versucht das Gerät der FROM-VM zu entziehen, auch wenn es noch in Benutzung ist. Ist dies nicht möglich, wird die Meldung VMS4003 oder VMS4031 ausgegeben. Der Operand sollte nur in Ausnahmefällen angewendet werden.

   Auf SU /390 ist das Privileg IO-RESET der FROM-VM zu beachten (siehe "Initialisieren einer VM").

Kommando-Returncodes

(SC2)   SC1	Maincode	Bedeutung
0 1             0 1             0 2             0 2             0 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 128 128	CMD0001 VMS4035 VMS4180 VMS2306 VMS4229 VMS3002 VMS3040 VMS4000 VMS4006 VMS4007 VMS4021 VMS4022 VMS4026 VMS4030 VMS4031 VMS4064 VMS4069 VMS4081 VMS4085 VMS4086 VMS4143 VMS4144 VMS4190 VMS4195 VMS4223 VMS9005 VMS3042 VMS4003	Kommando erfolgreich ausgeführt Kein entsprechendes Gerät gefunden Vorgegebene Gerätemenge ist leer VM-Definition konnte nicht aktualisiert werden (SU /390) Nicht alle Geräte des Pubset konnten bearbeitet werden Ungültiger Operandenwert (z.B. *DEVICE-RANGE) oder FROM-VM=TO-VM Zustand der VM verhindert Kommandoausführung VM noch nicht initialisiert Gerät ist nicht verfügbar Gerät ist der virtuellen Maschine nicht zugeordnet Gerät ist letzte Konsole oder Hauptkonsole des Monitorsystems. Keine Rekonfiguration möglich Gerät ist als Public-Platte im Monitorsystem in Benutzung. Keine Rekonfiguration möglich VM besitzt bereits eine virtuelle Konsole Der Monitor-VM darf keine virtuelle Konsole zugeordnet werden Gerät kann nicht angesprochen werden (INOP) Kein Kanalpfad verfügbar Gerät ist bereits der TO-VM zugeordnet Gerät nur entzogen. Umschalten nicht vollständig ausgeführt Gerät im Gastsystem nicht weggeschaltet (FORCE=*NO) Gerätezustand im Gastsystem nicht bekannt (FORCE=*NO) Gastsystem ist in der Startup-Phase (FORCE=*NO) VM ist im Wartezustand (FORCE=*NO) Gerät ist Alias-Gerät (PAV/DPAV) Gerät ist CRD-Gerät Kommando (Operand *PUBSET-DEVICES) nicht ausgeführt Kommando konnte nicht oder nur teilweise bearbeitet werden VM wird migriert Gerät ist aktiv

Garantierte Meldungen

VMS4003, VMS4008, VMS4021, VMS4022, VMS4026, VMS4030, VMS4031, VMS4064, VMS4069, VMS4081, VMS4085, VMS4086

Nur bei Angabe von *PUBSET-DEVICES:  VMS4223, VMS4228, VMS4229

Nur bei UNITS-Angabe ohne *DEVICE-RANGE und ohne Angabe von Wildcards: VMS4006, VMS4007, VMS4190, VMS4195

Beispiel

/switch-vm-devices from-vm=system2,to-vm=system3,
                   units=*pubset-devices(pubset=4ivi) —————————————————  (1) 
VMS4008 DEVICE 'FC1E' SWITCHED FROM VIRTUAL MACHINE (2,SYSTEM2) TO VIRTUAL
        MACHINE (3,SYSTEM3)
VMS4008 DEVICE 'FC1F' SWITCHED FROM VIRTUAL MACHINE (2,SYSTEM2) TO VIRTUAL
        MACHINE (3,SYSTEM3)
VMS4228 PUBSET '4IVI' WITH PUBRES DEVICE 'FC1E' SWITCHED FROM VM
        (2,SYSTEM2) TO VM (3,SYSTEM3) —————————————————————————————————  (2)

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

(1)	Der VM2000-Administrator entzieht der VM2 die Pubset-Geräte des Pubset 4IVI und ordnet sie der VM3 zu.
(2)	VM2000 meldet die alte und die neue Zuordnung.