Coordinated shutdown of VM2000

The coordinated shutdown of VM2000 initially executes shutdown in all BS2000 guest systems. System shutdown can be initiated there by means of an enter job or by calling shutdown processing (similar to the BS2000 command /SHUTDOWN). The monitor system waits for system termination in the BS2000 guest systems . When all the BS2000 guest systems have been shut down or the wait time set has elapsed, the monitor system shuts itself down. All VMs are also terminated. A detailed description of coordinated shutdown is contained in the section "Shutdown in the guest system and of VM2000".

In the case of coordinated shutdown, the following actions are performed by VM2000 when the monitor system is shut down:

• /DELETE-VM for all VMs which are still initialized, irrespective of the current system state (CHECK-VM-STATE=*NO)

• Accounting for the monitor VM

• Detaching of the attached extra CPUs

	On SU /390, all persistent VM definitions are updated by VM2000. The non-persistent VM definitions are deleted. These also include the VM definition of the monitor VM. For this action BCAM must still be active in the monitor system. Consequently, when the combined shutdown of VM2000 takes place, the ACTION=*SHUTDOWN(QUIET-TIME=0) operand should be selected.
	VM definitions are administered by X2000 on SU x86. No action by VM2000 when shutdown takes place.

Example of coordinated shutdown of VM2000

/show-vm-resources information=*std ———————————————————————————————————  (1)
             CPU-POOL(P)
VM-ID        VM-GROUP(G)  CPU-Q   MAX-U  PROC   MEM-SIZE  MAX-IO
 1 MONITOR   *STDPOOL(P)  30.00  100.00  2(+1)       512  (100)
 2 SYSTEM2   *STDPOOL(P)  30.00  100.00  2(+1)       512  (100)
 3 SYSTEM3   *STDPOOL(P)  30.00  100.00  2(+1)       512  (100)
VM-ID        STATE           VERSION PER ADMIN PRIV
 1 MONITOR   RUNNING         V21.0B  NO  YES   AS
 2 SYSTEM2   RUNNING         V20.0B  NO  NO    AS
 3 SYSTEM3   RUNNING         V20.0B  NO  NO    AS
F R E E      VM: 12          LARGEST-DOMAIN(MB):   14320

/shutdown-vm vm-id=*vm2000(waiting-time=*unlimited),
                           action=*shutdown(quiet-time=0) —————————————  (2)
VMS2054 SHUTDOWN OF GUEST SYSTEM ON VM (2,SYSTEM2) INITIATED
VMS2054 SHUTDOWN OF GUEST SYSTEM ON VM (3,SYSTEM3) INITIATED
VMS2100 VM2000 SHUTDOWN INITIATED
***
*** Guest system operating of SYSTEM2 and SYSTEM3:
*** ...
*** NRT1201 SHUTDOWN REQUESTED BY 'VM2000' ————————————————————————————  (3)
*** ...
*** EXC0557 SHUTDOWN PROCESSING COMPLETED
***
%  VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (3,SYSTEM3),
           CODE 80FFFFFF, CPU 01
%  VMS2033 'EXC0557 SHUTDOWN PROCESSING COMPLETED' FROM VM (3,SYSTEM3)
           VIA SVP
%  VMS2051 GUEST SYSTEM ON VM (3,SYSTEM3) DOWN; REASON: SHUTDOWN
%  VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (3,SYSTEM3),
           CODE 80FFFFFF, CPU 00
%  VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (2,SYSTEM2),
           CODE 80FFFFFF, CPU 01
%  VMS2033 'EXC0557 SHUTDOWN PROCESSING COMPLETED' FROM VM (2,SYSTEM2)
           VIA SVP
%  VMS2051 GUEST SYSTEM ON VM (2,SYSTEM2) DOWN; REASON: SHUTDOWN ——————  (4)
%  VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (2,SYSTEM2),
           CODE 80FFFFFF, CPU 00
***
*** Guest system operating in the monitor system:
*** ...
*** NRT1201 SHUTDOWN REQUESTED BY 'VM2000’ ————————————————————————————  (5)
*** ...
*** EXC0557 SHUTDOWN PROCESSING COMPLETED
*** VMS0000 MONITOR SYSTEM TERMINATED. VM2000 TERMINATION
***
NRTT201 TASK TERMINATION DUE TO /SHUTDOWN  COMMAND ————————————————————  (6)
EXC0419 /LOGOFF AT 1137 ON <date> FOR TSN '0GLI'

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

(1)	The command shows the initial situation for this example: In addition to the monitor system, two further VMs with a BS2000 guest system execute. The monitor VM is operated via the ADMIN dialog displayed.
(2)	The VM2000 administrator initiates the coordinated shutdown of VM2000. The monitor system would wait for an unlimited time for the guest systems to shut down.
(3)	The shutdown (MODE=*END) is initiated in the guest system. The message NRT1201 is output by the shutdown processing in the guest system.
(4)	Guest systems SYSTEM2 and SYSTEM3 have been shut down. The VM2000 administrator is informed of this. Asynchronous messages are marked with %.
(5)	After all guest systems have been terminated, the shutdown is initiated in the monitor system (MODE=*END). The message NRT1201 is output by the shutdown processing in the monitor system.
(6)	When the monitor system is shut down, the ADMIN dialog is also terminated.