Asynchronous messages are marked with %.
Example 1: Converting an existing VM to a persistent VM
In the example below (SU /390), a VM is subsequently assigned the PERSISTENT attribute by the VM2000 administrator while the guest system is running.
/show-vm-resources
CPU-POOL(P)VM-ID VM-GROUP(G) CPU-Q MAX-U PROC MEM-SIZE MAX-IO 1 M4IVR MONGROUP(G) 1.00 80.00 2(+1) 512 (100) 2 G4IVQ *STDPOOL(P) 26.00 100.00 4(+1) 2048 (100) 3 G4IVP USRGROUP(G) 4.00 100.00 2(+1) 4096 (100) 4 G4IVO USRGROUP(G) 1.00 100.00 1(+1) 512 (100) 5 G4IVJ *STDPOOL(P) 70.00 100.00 2(+1) 512 ( 50)VM-ID STATE VERSION PER ADMIN PRIV ——————————————————— (1) 1 M4IVR RUNNING V21.0B NO YES IO-R,AG,AS
2 G4IVQ RUNNING V21.0B NO NO AG,AS 3 G4IVP RUNNING V20.0B NO NO AS 4 G4IVO RUNNING V21.0B NO NO AG,AS 5 G4IVJ DOWN V20.0B NO NOF R E E VM: 10 LARGEST-DOMAIN(MB): 8176/start-vm ipl-unit=fc17,main-console=cc,vm-id=g4ivj ——————————————————— (2)% VMS2023 CPU 00 OF VIRTUAL MACHINE (5,G4IVJ) STARTED
% VMS2023 CPU 01 OF VIRTUAL MACHINE (5,G4IVJ) STARTED% VMS2023 CPU 02 OF VIRTUAL MACHINE (5,G4IVJ) STARTED% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (5,G4IVJ), CODE 80FFFFFF, CPU 02% VMS2011 CPU 02 OF VIRTUAL MACHINE (5,G4IVJ) STOPPED% VMS2050 GUEST SYSTEM ON VM (5,G4IVJ) READY/show-vm-attributes vm-id=g4ivj,information=*all —————————————————————— (3) CPU-POOL(P)
VM-ID VM-GROUP(G) CPU-Q MAX-U PROC MEM-SIZE MAX-IO 5 G4IVJ *STDPOOL(P) 70.00 100.00 2(+1) 512 (100)VM-ID STATE VERSION PER ADMIN PRIV 5 G4IVJ RUNNING V20.0B NO NO ASVM-ID CPU-POOL GR-CPU-Q CPU-Q/ EFF-Q MAX-U/ EFF-U PROC 5 G4IVJ *STDPOOL 70.00/ 42.16 100.00/100.00 2(+1)VM-ID SCHED ACT-I VIRT CPUS 5 G4IVJ TS NO 00(RUN),01(RUN),02(OFF)VM-ID VM-MONJV 5 G4IVJ NO VM-MONJV ASSIGNEDVM-ID UNITS 5 G4IVJ ASSIGNED BY VM-ADMIN EXCL: CC(VC),CC48,CC49,CC88,CC89,CD48,CD49,CD88, CD89,FC17,FC18,FC19 SHARED: 990FVM-ID LOC-BEGIN MEM-SIZE MIN-MEM-S MAX-MEM-S DEST-MEM-S 5 G4IVJ 00001B10 512 512VM-ID PRIV DETAILS 5 G4IVJ AS/show-vm-definition vm-name=g4ivj,information=*all ———————————————————— (4) CPU-POOL(P)
VM-ID ACT PER HA VM-GROUP(G) PROC MEM-SIZE MAX-IO 5 G4IVJ YES NO NO *STDPOOL(P) 2 512 100 CPU-POOL(P)VM-ID ACT VM-GROUP(G) CPU-Q MAX-U PROC ACT-I 5 G4IVJ YES *STDPOOL(P) 70.00 100.00 2 NOVM-ID ACT MEM-SIZE MIN-MEM-S MAX-MEM-S 5 G4IVJ YES 512 512VM-ID ACT PRIV DETAILS 5 G4IVJ YES ASVM-ID ACT TYPE EFF IPL-U IPL-C MODE SYSNAME 5 G4IVJ YES AUTO NO LAST YES FC17 CC FASTVM-ID ACT UNITS 5 G4IVJ YES ASSIGNED BY VM-ADMIN EXCL: CC(VC),CC48,CC49,CC88,CC89,CD48,CD49, CD88,CD89,FC17(PR),FC18(PD),FC19(PD) ————————— (5) SHARED: 990F
/modify-vm-attributes vm-id=g4ivj,
persistent=*yes(auto-ipl=*yes(ipl-unit=fc17,ipl-console=cn)) —— (6)/add-vm-devices units=(cn,co),vm-identification=g4ivj ————————————————— (7)
VMS4005 DEVICE 'CN' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CO' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)
/show-vm-attributes vm-identification=g4ivj ——————————————————————————— (8) CPU-POOL(P)
VM-ID VM-GROUP(G) CPU-Q MAX-U PROC MEM-SIZE MAX-IO 5 G4IVJ *STDPOOL(P) 70.00 100.00 2(+1) 512 (100)VM-ID STATE VERSION PER ADMIN PRIV 5 G4IVJ RUNNING V20.0B YES NO AS/show-vm-definition vm-name=g4ivj ————————————————————————————————————— (9) CPU-POOL(P)
VM-ID ACT PER HA VM-GROUP(G) PROC MEM-SIZE MAX-IO 5 G4IVJ YES YES NO *STDPOOL(P) 2 512 100/show-vm-definition vm-name=g4ivj,information=*ipl ———————————————————— (10) VM-ID ACT TYPE EFF IPL-U IPL-C MODE SYSNAME 5 G4IVJ YES AUTO YES FC17 CN AUTO LAST YES FC17 CC FAST/show-vm-definition vm-name=g4ivj,information=*units —————————————————— (11)VM-ID ACT UNITS
5 G4IVJ YES ASSIGNED BY VM-ADMIN EXCL: CC(VC),CN,CO,CC48,CC49,CC88,CC89,CD48, CD49,CD88,CD89,FC17(PR),FC18(PD),FC19(PD) SHARED: 990F/shutdown-vm vm-identification=g4ivj,action=*shutdown(quiet-time=0) ——— (12)VMS2054 SHUTDOWN OF GUEST SYSTEM ON VM (5,G4IVJ) INITIATED% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (5,G4IVJ), CODE 80FFFFFF, CPU 00
% VMS2033 'EXC0557 SHUTDOWN PROCESSING COMPLETED ' FROM VM (5,G4IVJ) VIA SVP% VMS2051 GUEST SYSTEM ON VM (5,G4IVJ) DOWN; REASON: SHUTDOWN
% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (5,G4IVJ), CODE 80FFFFFF, CPU 01/delete-vm vm-identification=g4ivj ———————————————————————————————————— (13)VMS4009 DEVICE 'CC' REMOVED FROM VIRTUAL MACHINE (5,G4IVJ)
VMS4009 DEVICE 'CN' REMOVED FROM VIRTUAL MACHINE (5,G4IVJ)VMS4009 DEVICE 'CO' REMOVED FROM VIRTUAL MACHINE (5,G4IVJ)...VMS4619 VIRTUAL MACHINE (5,G4IVJ) REMOVED FROM CPU POOL '*STDPOOL'
VMS4024 VIRTUAL MACHINE (5,G4IVJ) TERMINATED/show-vm-definition vm-name=g4ivj ————————————————————————————————————— (14) CPU-POOL(P)
VM-ID ACT PER HA VM-GROUP(G) PROC MEM-SIZE MAX-IO 5 G4IVJ NO YES NO *STDPOOL(P) 2 512 100/modify-vm-definition vm-name=g4ivj,memory-size=1024,
processor=*extra-and-normal,devices=*remove(units=cc) —————————— (15) /show-vm-definition vm-name=g4ivj,information=*memory ————————————————— (16)VM-ID ACT MEM-SIZE MIN-MEM-S MAX-MEM-S
5 G4IVJ NO 1024 512/show-vm-definition vm-name=g4ivj,information=*cpu
CPU-POOL(P)VM-ID ACT VM-GROUP(G) CPU-Q MAX-U PROC ACT-I 5 G4IVJ NO *STDPOOL(P) 70.00 100.00 4(E) NO/show-vm-definition vm-name=g4ivj,information=*units
VM-ID ACT UNITS 5 G4IVJ NO ASSIGNED BY VM-ADMIN EXCL: CN,CO,CC48,CC49,CC88,CC89,CD48,CD49, CD88,CD89,FC17(PR) ——————————————————————————— (17)
SHARED: 990F/activate-vm-definition vm-name=g4ivj ————————————————————————————————— (18)VMS3050 VIRTUAL MACHINE (5,G4IVJ) CREATED
VMS4615 VIRTUAL MACHINE (5,G4IVJ) ASSIGNED TO CPU POOL '*STDPOOL'VMS4005 DEVICE 'CN' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CO' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CC48' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CC49' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CC88' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CC89' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CD48' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CD49' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CD88' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'CD89' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'FC17' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'FC18' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE 'FC19' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ)VMS4005 DEVICE '990F' ASSIGNED TO VIRTUAL MACHINE (5,G4IVJ) (TYPE=SD)% VMS2023 CPU 00 OF VIRTUAL MACHINE (5,G4IVJ) STARTED% VMS2023 CPU 01 OF VIRTUAL MACHINE (5,G4IVJ) STARTED% VMS2023 CPU 04 OF VIRTUAL MACHINE (5,G4IVJ) STARTED% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (5,G4IVJ), CODE 80FFFFFF, CPU 04
% VMS2011 CPU 04 OF VIRTUAL MACHINE (5,G4IVJ) STOPPED% VMS2050 GUEST SYSTEM ON VM (5,G4IVJ) READY/show-vm-attributes vm-identification=g4ivj ——————————————————————————— (19) CPU-POOL(P)VM-ID VM-GROUP(G) CPU-Q MAX-U PROC MEM-SIZE MAX-IO 5 G4IVJ *STDPOOL(P) 70.00 100.00 4(+1) 1024 (100)VM-ID STATE VERSION PER ADMIN PRIV 5 G4IVJ RUNNING V20.0B YES NO AS/show-vm-definition vm-name=g4ivj,information=*ipl ———————————————————— (20)VM-ID ACT TYPE EFF IPL-U IPL-C MODE SYSNAME
5 G4IVJ YES AUTO YES FC17 CN AUTO LAST YES FC17 CN AUTO
----------------------------------------------------------------------------------------------------------------
(1) | In the initial situation five VMs are initialized, all of which have a non-persistent VM definition. |
(2) | VM5 is switched on and started up on its virtual console. |
(3) | The attributes of the VM2 are output. |
(4) | The attributes of the VM are also reflected in its (non-persistent) VM definition. |
(5) | In this case the disks of the home pubset contain the additional indicators |
(6) | The VM is assigned the PERSISTENT attribute, i.e. its VM definition is labeled as persistent. The guest system on the VM is to be started automatically when the VM definition is activated. However, the startup is not to take place from the virtual console, but from a (new) KVP console with the device pair ( |
(7) | The (new) KVP console is assigned to the VM. This can also take place after the |
(8) | The VM now has the PERSISTENT attribute. |
(9) | The VM definition is now active (VM is initialized) and persistent. |
(10) | The IPL parameters for automatic startup of the guest system on the VM are set. The IPL parameters of the last startup of the guest system (LAST) can also be seen. |
(11) | The KVP console ( |
(12) | The guest system on the VM is terminated. |
(13) | The VM is terminated. |
(14) | The persistent VM definition still exists. However, it is no longer active. |
(15) | The VM definition is modified:The next time it is activated the VM is assigned a larger main memory and the highest possible multiprocessor level. At the same time the virtual console is removed from the VM (which is no longer required). |
(16) | The changes are visible in the information commands. |
(17) | Disks |
(18) | Activating the VM definition causes the VM to be set up again and automatically restarted. |
(19) | The VM runs with the predefined attributes. |
(20) | In the VM definition the parameters of the last IPL have changed. |
----------------------------------------------------------------------------------------------------------------
Example 2: Setting up a persistent VM from a VM definition
In the example below (SU x86), a persistent VM definition is set up and activated.
/create-vm-definition vm-name=persvm, ————————————————————————————————— (1) memory-size=2048,min-memory-size=1024,max-memory-size=8192,
processor=*maximum,cpu-quota=20,admin-privileges=*maximum,
devices=(*pubset-devices(pubset=vm24,usage=*exclusive),
*device-range(from=fc0a,to=fc0c,usage=*shared),x6,x7,y6,y7,z6,z7),
privileges=*parameters(assign-by-guest=*yes),
admin-privileges=*maximum,
auto-ipl=*yes(ipl-unit=9924,ipl-console=z6,mode=*fast,system-name=abgafr04)
VMS2301 DEFINITION OF VM 'PERSVM' CREATED/show-vm-definition vm-name=persvm,information=*all ——————————————————— (2) CPU-POOL(P)
VM-ID ACT PER HA VM-GROUP(G) PROC MEM-SIZE MAX-IO - PERSVM NO YES NO *STDPOOL(P) 8(M) 2048 100 CPU-POOL(P)VM-ID ACT VM-GROUP(G) CPU-Q MAX-U PROC ACT-I - PERSVM NO *STDPOOL(P) 20.00 100.00 8(M) NOVM-ID ACT MEM-SIZE MIN-MEM-S MAX-MEM-S - PERSVM NO 2048 1024 8192VM-ID ACT PRIV DETAILS - PERSVM NO ADM *VM-MAX AG *STDSET ASVM-ID ACT TYPE EFF IPL-U IPL-C MODE SYSNAME - PERSVM NO AUTO YES 9924 Z6 FAST ABGAFR04VM-ID ACT UNITS - PERSVM NO ASSIGNED BY VM-ADMIN EXCL: X6,X7,Y6,Y7,Z6,Z7,9924(PR) SHARED: FC0A,FC0B,FC0C
/activate-vm-definition vm-name=persvm ———————————————————————————————— (3)% VMS6020 VIRTUAL MACHINE (4,PERSVM) CREATED BY SYSTEM ADMINISTRATION
% VMS4005 DEVICE '9924' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4005 DEVICE 'FC0A' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (TYPE=SD) (BY SYSADM)
% VMS4005 DEVICE 'FC0B' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (TYPE=SD) (BY SYSADM)% VMS4005 DEVICE 'FC0C' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (TYPE=SD) (BY SYSADM)
% VMS4005 DEVICE 'Z6' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4005 DEVICE 'Z7' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4005 DEVICE 'X6' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (BY SYSADM) % VMS4005 DEVICE 'X7' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4005 DEVICE 'Y7' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4005 DEVICE 'Y6' ASSIGNED TO VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS2023 CPU 00 OF VIRTUAL MACHINE (4,PERSVM) STARTED% VMS6023 GUEST SYSTEM ON VM (4,PERSVM) STARTED BY SYSTEM ADMINISTRATION% VMS2023 CPU 01 OF VIRTUAL MACHINE (4,PERSVM) STARTED% VMS2023 CPU 02 OF VIRTUAL MACHINE (4,PERSVM) STARTED% VMS2023 CPU 03 OF VIRTUAL MACHINE (4,PERSVM) STARTED% VMS2023 CPU 04 OF VIRTUAL MACHINE (4,PERSVM) STARTED% VMS2023 CPU 05 OF VIRTUAL MACHINE (4,PERSVM) STARTED% VMS2023 CPU 06 OF VIRTUAL MACHINE (4,PERSVM) STARTED% VMS2023 CPU 07 OF VIRTUAL MACHINE (4,PERSVM) STARTED% VMS2050 GUEST SYSTEM ON VM (4,PERSVM) READY/show-vm-attributes vm-identification=persvm,information=*all ————————— (4) CPU-POOL(P)
VM-ID VM-GROUP(G) CPU-Q MAX-U PROC MEM-SIZE MAX-IO 4 PERSVM *STDPOOL(P) 20.00 100.00 8 2048 (100)VM-ID STATE VERSION PER ADMIN PRIV 4 PERSVM RUNNING V21.0B YES NO AG,ASVM-ID CPU-POOL GR-CPU-Q CPU-Q/ EFF-Q MAX-U/ EFF-U PROC 4 PERSVM *STDPOOL 20.00/ 20.00 100.00/100.00 8VM-ID SCHED ACT-I VIRT CPUS 4 PERSVM TS NO 00(RUN),01(RUN),02(RUN),03(RUN), 04(RUN),05(RUN),06(RUN),07(RUN)VM-ID VM-MONJV 4 PERSVM NO VM-MONJV ASSIGNEDVM-ID UNITS 4 PERSVM ASSIGNED BY VM-ADMIN EXCL: X6,X7,Y6,Y7,Z6,Z7,9924 SHARED: FC0A,FC0B,FC0CVM-ID BS2-MEM-S MEM-SIZE MIN-MEM-S MAX-MEM-S DEST-MEM-S 4 PERSVM 1896 2048 1024 8192VM-ID PRIV DETAILS 4 PERSVM ADM *VM-MAX AG *STDSET AS/show-vm-definition vm-name=persvm,information=*ipl ——————————————————— (5) VM-ID ACT TYPE EFF IPL-U IPL-C MODE SYSNAME - PERSVM YES AUTO YES 9924 Z6 FAST ABGAFR04 LAST YES 9924 Z6 FAST ABGAFR04/shutdown-vm vm-identification=persvm,action=*shutdown(quiet-time=0) —— (6)VMS2054 SHUTDOWN OF GUEST SYSTEM ON VM (4,PERSVM) INITIATED
% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (4,PERSVM), CODE 00000000, CPU 07% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (4,PERSVM), CODE 00000000, CPU 05
% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (4,PERSVM), CODE 00000000, CPU 03
% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (4,PERSVM), CODE 00000000, CPU 04% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (4,PERSVM), CODE 00000000, CPU 01
% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (4,PERSVM), CODE 00000000, CPU 00
% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (4,PERSVM), CODE 00000000, CPU 02% VMS2033 'EXC0557 SHUTDOWN PROCESSING COMPLETED' FROM VM (4,PERSVM) VIA SVP% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (4,PERSVM), CODE 00000000, CPU 06% VMS2051 GUEST SYSTEM ON VM (4,PERSVM) DOWN; REASON: SHUTDOWN/delete-vm vm-identification=persvm ——————————————————————————————————— (7)VMS4619 VIRTUAL MACHINE (4,PERSVM) REMOVED FROM CPU POOL '*STDPOOL'
VMS4024 VIRTUAL MACHINE (4,PERSVM) TERMINATED% VMS4009 DEVICE 'Z6' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4009 DEVICE 'Z7' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4009 DEVICE 'X6' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4009 DEVICE 'X7' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4009 DEVICE 'Y6' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4009 DEVICE 'Y7' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4009 DEVICE '9924' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4009 DEVICE 'FC0A' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)
% VMS4009 DEVICE 'FC0B' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)% VMS4009 DEVICE 'FC0C' REMOVED FROM VIRTUAL MACHINE (4,PERSVM) (BY SYSADM)
/delete-vm-definition vm-name=persvm —————————————————————————————————— (8) VMS2302 DEFINITION OF VM 'PERSVM' DELETED
----------------------------------------------------------------------------------------------------------------
(1) | The persistent VM definition is set up. |
(2) | The settings in the persistent VM definition are displayed. |
(3) | The VM definition is activated. The BS2000 guest system is started automatically. On SU x86, this command causes all messages to be output asynchronously. On SU /390 some messages (in particular VMS3050 and VMS4005) are output synchronously when the command is executed, see comment (18) in Example 1. |
(4) | The VM runs with the predefined attributes and resources. |
(5) | After the (automatic) startup of the guest system on the VM, the parameters of the last IPL are also entered in the VM definition. |
(6) | The guest system on VM4 is terminated. |
| (7) | VM4 is terminated. When a persistent VM is terminated, the messages VMS4009 are output asynchronously. Otherwise the messages are output synchronously during command execution, see comment (13) in Example 1. |
(8) | The persistent VM definition is deleted. |
----------------------------------------------------------------------------------------------------------------