REDUCE-VM-MEMORY (Hauptspeicher einer VM verkleinern)

Mit /REDUCE-VM-MEMORY wird der Hauptspeicher einer VM auch bei laufendem Gastsystem verkleinert. Die Hauptspeicher-Rekonfiguration kann mit einer Monitor-Jobvariablen überwacht werden.

Nach der Hauptspeicher-Verkleinerung wird die neue Hauptspeichergröße in der VM-Definition vermerkt.

Der Hauptspeicher einer VM kann nicht verkleinert werden, während sie migriert wird (VM-Migration).

Hauptspeicher-Rekonfiguration ist möglich für VMs im Zustand INIT-ONLY oder DOWN. Für aktive Gastsysteme (VM-Zustand RUNNING) ist eine Hauptspeicher-Rekonfiguration erst nach SYSTEM READY des Gastsystems möglich. Für VMs im Zustand IN HOLD (WAIT) ist eine Hauptspeicher-Rekonfiguration nicht möglich.

Da die dynamische Hauptspeicher-Rekonfiguration Maßnahmen sowohl im (aktiven) Gastsystem als auch in VM2000 erfordert, benötigt ihre Ausführung etwas Zeit. Die eigentliche Hauptspeicher-Rekonfiguration findet asynchron nach der Kommandoannahme statt. In dieser Phase wird ein weiteres Kommando /EXTEND-VM-MEMORY oder /REDUCE-VM-MEMORY für die gleiche VM abgewiesen. Während der Hauptspeicher-Rekonfiguration können die Kommandos /MOVE-VM (SU /390) und /START-VM ausgeführt werden. Als Hauptspeichergröße der betreffenden VM wird in diesem Fall die alte Hauptspeichergröße verwendet. Das Gleiche gilt bei einem Restart des Gastsystems.

Der Abbruch einer Hauptspeicher-Rekonfiguration durch /START-VM, /RESET-VM oder /DELETE-VM sollte auf SU x86 vermieden werden. Grund: die Rekonfiguration wird nur in BS2000 abgebrochen, aber in der Firmware und im Trägersystem trotzdem fortgesetzt. Ein BS2000-IPL bei /START-VM wird ggf. solange verzögert bis die Rekonfiguration im Trägersystem beendet ist.

Dieses Kommando ist nur dem VM2000-Administrator erlaubt.

REDUCE-VM-MEMORY

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

,NEW-MEMORY-SIZE = *MINIMUM / <integer 1..1048576>(DIMENSION = *MEGABYTE / *GIGABYTE)

,MONJV= *NONE / <filename 1..54 without-gen-vers>

,JV-PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647>

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>
Identifikation der virtuellen Maschine durch VM-Index oder VM-Name.
Auch der Hauptspeicher der Monitor-VM kann verkleinert werden.

NEW-MEMORY-SIZE = *MINIMUM / <integer 1..1048576>(DIMENSION = *MEGABYTE / *GIGABYTE)
Neue Größe des Hauptspeichers der betreffenden VM (nach Verkleinerung) bis zu einer Größe von 1 TByte (Terabyte; 1 TByte = 1024 GByte = 1 048 576 MByte).

	Auf SU /390 darf die neue Größe des Hauptspeichers die MIN-MEMORY-SIZE der betreffenden VM unterschreiten, wenn sich die VM im Zustand INIT-ONLY oder DOWN befindet. Der Wert MIN-MEMORY-SIZE der VM erhält in diesem Fall den Wert von NEW-MEMORY-SIZE.
	Auf SU x86 darf die neue Größe des Hauptspeichers die MIN-MEMORY-SIZE der betreffenden VM nicht unterschreiten. Der Wert muss ein Vielfaches von 2 MByte sein.

Bei Angabe von *MINIMUM wird die Hauptspeichergröße der VM bis zur kleinstmöglichen Hauptspeichergröße
(MIN-MEMORY-SIZE) verkleinert.

MONJV =
Bestimmt eine Monitor-Jobvariable zur Überwachung der Hauptspeicher-Rekonfiguration (siehe "Hauptspeicher rekonfigurieren").

MONJV = *NONE
Es wird keine Monitor-Jobvariable bestimmt.

MONJV = <filename 1..54 without-gen-vers>
Die angegebene MONJV wird von VM2000 versorgt; der Kommando-Sender muss deshalb für die angegebene MONJV schreibberechtigt sein.
Wenn im Dateinamen keine Katalog- oder keine Benutzerkennung angegeben ist, vervollständigt VM2000 den Dateinamen in Abhängigkeit von der Ablaufumgebung des Kommando-Senders.
Wenn ein Dateiname angegeben wird, für den noch keine Jobvariable existiert, so legt VM2000 die MONJV als gemeinsam benutzbar und ohne Kennwort an.

JV-PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer ...>
Kennwort der MONJV zur Prüfung der Zugriffsberechtigung.
Das Eingabefeld wird im geführten Dialog automatisch dunkel-gesteuert. Der eingegebene Wert wird nicht protokolliert.

Dieser Operand wird nur ausgewertet, wenn bei MONJV eine bereits angelegte Monitor-Jobvariable angegeben wurde.

 

Kommando-Returncodes

(SC2)   SC1	Maincode	Bedeutung
0 1             0 64 64 64 64 64 64 64 128 128	CMD0001 CMD0001 VMS2070 VMS4000 VMS4011 VMS4071 VMS4091 VMS4093 VMS4340 VMS3042 VMS4092	Kommando erfolgreich ausgeführt Keine Aktion erforderlich VM im Zustand IN HOLD (WAIT) VM noch nicht initialisiert Gewünschte Speichergröße oder -lage nicht verfügbar Falsche Angabe von Speichergröße oder -lage Auf der VM läuft ein Gastsystem, für das die Hauptspeicher- Rekonfiguration nicht möglich ist Ungültige Angaben zur Speichergröße Auf die Jobvariable konnte nicht zugegriffen werden VM wird migriert Speicher-Rekonfiguration ist noch aktiv

Garantierte Meldungen

VMS2306 (SU /390)

Beispiel

/reduce-vm-memory vm-id=2,new-memory-size=*minimum —————————————————————  (1)
/show-vm-resources information=*memory —————————————————————————————————  (2)
VM-ID        LOC-BEGIN  MEM-SIZE  MIN-MEM-S  MAX-MEM-S  DEST-MEM-S
HYPERVISOR   00000000         16
 1 MONITOR   00000010        512        512
 2 SYSTEM2   00000210        768        512                    512
NONE         00000510      14576
LARGEST FREE DOMAIN:       14576
/show-vm-resources information=*memory
VMS4094 MEMORY-RECONFIGURATION FOR VIRTUAL MACHINE (2,SYSTEM2) HAS BEEN
        SUCCESSFULLY PROCESSED. CURRENT MEMORY SIZES: 512 / 512 ———————  (3)
VM-ID        LOC-BEGIN  MEM-SIZE  MIN-MEM-S  MAX-MEM-S  DEST-MEM-S
HYPERVISOR   00000000         16
 1 MONITOR   00000010        512        512
 2 SYSTEM2   00000210        512        512 ———————————————————————————  (4)
NONE         00000410      14832
LARGEST FREE DOMAIN:       14832

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

(1)	Der Hauptspeicher der VM SYSTEM2 soll auf seinen Minimalwert verkleinert werden.
(2)	Der VM2000-Administrator informiert sich über die Verteilung des Hauptspeichers von VM2000. Die VM2 besitzt noch eine Speichergröße von 768 MByte und eine minimale Speichergröße von 512 MByte. Die geplante neue Speichergröße von 512 MByte wird während der Bearbeitung des Auftrages ebenfalls angezeigt.
(3)	Der Abschluss des asynchron ablaufenden Rekonfigurationsauftrages wird dem VM2000-Administrator als freilaufende (garantierte) Meldung im Benutzer-Ereignisstrom oder, wie im Beispiel, bei der nächsten Eingabe angezeigt (die Hauptspeicher-Rekonfiguration benötigt etwas Zeit).
(4)	Der Hauptspeicher der VM2 ist nun (wieder) 512 MByte groß. Dadurch vergrößert sich der verbleibende freie Hauptspeicher.