This example, which consists of several parts, illustrates the different types of device assignment and release and how the usage mode changs when VM2000 and a guest system are used together.
Guest system operations are marked with “***
”. Asynchronous messages are marked with %
.
Explicit device assignment
/create-vm memory-size=512,vm-name=system2,cpu-quota=30 ——————————————— (1)
VMS3050 VIRTUAL MACHINE (2,SYSTEM2) CREATED
VMS4615 VIRTUAL MACHINE (2,SYSTEM2) ASSIGNED TO CPU POOL '*STDPOOL'/add-vm-devices (ch,ci,fc1a,fc1b),vm-id=system2 ——————————————————————— (2)
VMS4005 DEVICE 'CH' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2)
VMS4005 DEVICE 'CI' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2)VMS4005 DEVICE 'FC1A' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2)
VMS4005 DEVICE 'FC1B' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2)
/start-vm ipl-unit=fc1a,vm-id=system2 ————————————————————————————————— (3)
***
*** System initialization of the guest system on VM2***
% VMS2050 GUEST SYSTEM ON VM (2,SYSTEM2) READY ——————————————————————— (4)
--------------------------------------------------------------------------------------------------------------
(1) | The VM2000 administrator creates a VM. |
(2) | The VM2000 administrator explicitly assigns the KVP device pair and the devices of the home pubset to VM2. These devices are required by VM2 for startup and thus cannot be assigned implicitly. |
(3) | VM2 is started. |
(4) | The guest system on the VM2 has reached |
--------------------------------------------------------------------------------------------------------------
Implicit device assignment
/create-vm-assignment-set set-name=sys2impl ——————————————————————————— (5)
VMS4201 ASSIGNMENT SET 'SYS2IMPL' CREATED
/modify-vm-attributes vm-id=system2,
privileges=*par(assign-by-guest=*yes(set-name=sys2impl)) ——— (6)/show-vm-device-status units=(CC42,CC43,990f,FC1C,FC1D) ——————————————— (7)
UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BYCC42 HNC
CC43 HNC
990F D3435 SH(D) 1 MONITOR VM-ADMIN ——————————— (8)
FC1C D3435
FC1D D3435
/modify-vm-device-attributes units=(CC42,CC43,990f,fc1c,fc1d),
assign-by-guest=*yes(set-name=sys2impl) —— (9)/show-vm-device-status select=*par(assign-by-guest=*yes(set-name=sys2impl))
UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BY———————— (10) CC42 HNC SYS2IMPL
CC43 HNC SYS2IMPL
990F D3435 SYS2IMPL SH(D) 1 MONITOR VM-ADMIN
FC1C D3435 SYS2IMPL
FC1D D3435 SYS2IMPL
/show-vm-assignment-set set-name=sys2impl ————————————————————————————— (11)
ASSIGNMENT-SET #DEVICES VM-ID
SYS2IMPL 5 2 SYSTEM2***
*** Guest system operation on VM2:
*** /attach-device unit=(CC42,CC43,990f,fc1c,fc1d) ———————————————————— (12)
*** NKR0042 'DEVICE =CC42': ATTACH ACCEPTED
*** NKR0042 'DEVICE =CC43': ATTACH ACCEPTED
*** NKR0042 'DEVICE =990F': ATTACH ACCEPTED
*** NKR0042 'DEVICE =FC1C': ATTACH ACCEPTED
*** NKR0042 'DEVICE =FC1D': ATTACH ACCEPTED
*** NKR0040 'DEVICE =CC42' ATTACHED
*** NKR0040 'DEVICE =CC43' ATTACHED
*** NKR0040 'DEVICE =FC1C' ATTACHED
*** NKR0040 'DEVICE =990F' ATTACHED
*** NKR0040 'DEVICE =FC1D' ATTACHED
*** NKVD010 DISK '4IVL.0' MOUNTED ON DEVICE 'FC1C' ———————————————————— (13)
*** NKVD010 DISK 'WO990F' MOUNTED ON DEVICE '990F'
*** NKVD010 DISK '4IVL.1' MOUNTED ON DEVICE 'FC1D'*** NBR0740 COMMAND COMPLETED 'ATTACH-DEVICE';
*** (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
***% VMS4005 DEVICE '990F' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2)
(BY GUEST) ————————————————————————————————————————————————— (14)
% VMS4005 DEVICE 'CC42' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2) (BY GUEST)% VMS4005 DEVICE 'CC43' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2) (BY GUEST)
% VMS4005 DEVICE 'FC1C' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2) (BY GUEST)
% VMS4005 DEVICE 'FC1D' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2) (BY GUEST)
/show-vm-device-status units=*std,information=*all,
select=*par(assign-by-guest=*yes(set-name=sys2impl)) —— (15)
UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BYCC42 HNC SYS2IMPL EXCL 2 SYSTEM2 GUEST ————————————— (16)
CC43 HNC SYS2IMPL EXCL 2 SYSTEM2 GUEST
990F D3435 SYS2IMPL SH(I) ( 2) MIXED—————————————— (17)
1 MONITOR VM-ADMIN
2 SYSTEM2 GUEST
FC1C D3435 SYS2IMPL SH(D) 2 SYSTEM2 GUEST ————————————— (18)
FC1D D3435 SYS2IMPL SH(D) 2 SYSTEM2 GUEST
/show-vm-attributes information=*all,vm-id=system2 ———————————————————— (19)
VM-ID VM-GROUP(G) CPU-Q MAX-U PROC MEM-SIZE MAX-IO 2 SYSTEM2 *STDPOOL(P) 30.00 100.00 1(+1) 512 (100)
VM-ID STATE VERSION PER ADMIN PRIV
2 SYSTEM2 RUNNING V20.0B NO NO AG,AS
VM-ID CPU-POOL GR-CPU-Q CPU-Q/ EFF-Q MAX-U/ EFF-U PROC
2 SYSTEM2 *STDPOOL 30.00/ 25.00 100.00/ 25.00 1(+1)
VM-ID SCHED ACT-I VIRT CPUS
2 SYSTEM2 DC NO 00(RUN),01(SLEEP)
VM-ID VM-MONJV
2 SYSTEM2 NO VM-MONJV ASSIGNED
VM-ID UNITS ———————————————————————————————————————————————————— (20)
2 SYSTEM2 ASSIGNED BY VM-ADMIN
EXCL: CH,CI,FC1A,FC1B ASSIGNED BY GUEST
EXCL: CC42,CC43
SHARED: 990F,FC1C,FC1D
...
VM-ID PRIV DETAILS
2 SYSTEM2 AG SYS2IMPL ————————————————————————————————————————— (21)
AS
*** Guest system operation on VM2:
*** /import-pubset pubset=4ivl,use=*exclusive ————————————————————————— (22)
*** DMS035B IMPORT PUBSET TASK WITH TSN 'XAAS' FOR PUBSET WITH PUBSET ID
*** '4IVL' HAS BEEN CREATED AND STARTED
*** SRM5017 USER GROUP MANAGEMENT ON PUBSET '4IVL'INITIALIZED WITH '1'
*** USER GROUP(S)
*** PRO6000 GUARDS CATALOG ':4IVL:$TSOS.SYSCAT.GUARDS' OPENED*** DMS03E0: SCA (SPEEDCAT) VERSION V19.0A00 RUNNING FOR CATALOG-ID 4IVL
*** DMS03E1: SCA RUNNING FOR CATALOG-ID 4IVL.
*** STATUS OF CATALOG: 00 002664 FILE ENTRIES AND
*** 00000002 JOB VARIABLES IN 00000288 CATALOG BLOCKS
*** DMS038F IMPORT PUBSET PROCESSING COMPLETED .*** PUBSET WITH PUBSET ID '4IVL' IN 'LOCAL-IMPORTED' STATE
*** NBR0740 COMMAND COMPLETED 'IMPORT-PUBSET';
*** (RESULT: SC2=000, SC1=000, MC=DMS038F); DATE: <date>
*** /show-device-configuration unit=(fc1c,fc1d),information=*vm2000 ——— (23)*** MNEM UN-CLASS UN-TYPE CONF-STATE VM-ASSIGN VM-USAGE ——————— (24)
*** FC1C DVC D3435 ATTACHED BY-GUEST EXCL ——————————— (25) *** FC1D DVC D3435 ATTACHED BY-GUEST EXCL
*** NBR0740 COMMAND COMPLETED 'SHOW-DEVICE-CONFIGURATION'; (RESULT:
*** SC2=000, SC1=000, MC=CMD0001); DATE: <date>
--------------------------------------------------------------------------------------------------------------
(5) | The assignment set |
(6) | The VM2000 administrator assigns VM2 the |
(7) | The VM2000 administrator wants to make some devices available to VM2 and uses the VM2000 administrator command to obtain information about the state of the devices first. |
(8) | All the relevant devices are free. |
(9) | Implicit device assignment is to be permitted for the devices. Therefore, the VM2000 administrator assigns the |
(10) | Now, all the devices concerned have the |
(11) | The information output for the assignment set shows the related summary. |
(12) | The guest system operator uses the BS2000 command |
(13) | Disks are detected in the guest system on the attached devices. |
(14) | The VM and VM2000 administrators are notified about the implicit device assignment to VM2 by asynchronous messages. |
(15) | The VM2000 administrator obtains detailed information on the state of the devices. If |
(16) | Devices which are not disk devices or CRD devices are assigned to the usage mode |
(17) | Disk device |
(18) | In the case of implicit device assignment, the disk devices are assigned in the usage mode |
(19) | This command provides a VM administrator with information on his or her VM. |
(20) | The type of device assignment ( |
(21) | The |
(22) | In the guest system, pubset |
(23) | The guest system operator obtains information on the VM2000 status of the implicitly assigned disk devices of his or her guest system. |
(24) | The output columns |
(25) | For the disk devices |
--------------------------------------------------------------------------------------------------------------
Changing the usage mode
/show-vm-device-status units=*std,information=*all,
select=*par(state=*assigned(vm-id=system2)) ———— (26)UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BY
CH SKP2 EXCL 2 SYSTEM2 VM-ADMINCI SKP2 EXCL 2 SYSTEM2 VM-ADMIN
CC42 HNC SYS2IMPL EXCL 2 SYSTEM2 GUEST
CC43 HNC SYS2IMPL EXCL 2 SYSTEM2 GUEST
990F D3435 SYS2IMPL SH(I) ( 2) MIXED
1 MONITOR VM-ADMIN
2 SYSTEM2 GUEST
FC1A D3435 EXCL 2 SYSTEM2 VM-ADMIN
FC1B D3435 EXCL 2 SYSTEM2 VM-ADMIN
FC1C D3435 SYS2IMPL EXCL 2 SYSTEM2 GUEST ————————————— (27)
FC1D D3435 SYS2IMPL EXCL 2 SYSTEM2 GUEST
/modify-vm-device-usage units=(fc1c,fc1d),vm-id=system2,usage=*shared — (28)/show-vm-device-status units=(fc1c,fc1d)
UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BYFC1C D3435 SYS2IMPL SH(D) 2 SYSTEM2 GUEST ———————————— (29)
FC1D D3435 SYS2IMPL SH(D) 2 SYSTEM2 GUEST
--------------------------------------------------------------------------------------------------------------
(26) | The VM2000 administrator obtains detailed information on the state of the devices assigned to VM2. |
(27) | For the disk devices, the exclusive importing of the pubset has changed the usage mode from |
(28) | Nevertheless, the VM2000 administrator wants to set the usage mode |
(29) | In spite of the exclusive use of the pubset, |
--------------------------------------------------------------------------------------------------------------
Implicit device release
***
*** Guest system operation on VM2:
*** /export-pubset pubset=4ivl ———————————————————————————————————————— (30)
*** DMS035D EXPORT-PUBSET TASK WITH TSN 'XAAV' FOR PUBSET WITH PUBSET ID
*** '4IVL' HAS BEEN CREATED AND STARTED
*** PRO6005 GUARDS CATALOG ':4IVL:$TSOS.SYSCAT.GUARDS' CLOSED
*** DMS03E2 NORMAL TERMINATION OF SCA (CATALOG ID '4IVL')
*** DMS037F EXPORT-PUBSET PROCESSING COMPLETED FOR PUBSET '4IVL'
*** NBR0740 COMMAND COMPLETED 'EXPORT-PUBSET';
*** (RESULT: SC2=000, SC1=000, MC=DMS037F); DATE: <date>
*** /detach-device unit=(fc1c,fc1d) ——————————————————————————————————— (31)*** NKR0092 'DEVICE =FC1C': /DETACH-DEVICE PENDING ACCEPTED
*** NKR0092 'DEVICE =FC1D': /DETACH-DEVICE PENDING ACCEPTED*** NKR0045 *** 'DEVICE =FC1C' DETACHED ***
*** NKR0045 *** 'DEVICE =FC1D' DETACHED ***
*** NBR0740 COMMAND COMPLETED 'DETACH-DEVICE';
*** (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
***% VMS4009 DEVICE 'FC1C' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
(BY GUEST) ————————————————————————————————————————————————— (32)
% VMS4009 DEVICE 'FC1D' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2) (BY GUEST)
/show-vm-device-status units=(fc1c,fc1d),information=*all
UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BYFC1C D3435 SYS2IMPL ———————————————————————————————————————— (33)
FC1D D3435 SYS2IMPL
--------------------------------------------------------------------------------------------------------------
(30) | Pubset |
(31) | The pubset device(s) are detached in the guest system and consequently removed from the VM. |
(32) | VM and VM2000 administrators are informed of the implicit device release by asynchronous messages. |
(33) | The devices have their original status again. |
--------------------------------------------------------------------------------------------------------------
Converting from explicit to implicit device assignment
/add-vm-devices units=(fc1c,fc1d),vm-id=system2 ——————————————————————— (34)
VMS4005 DEVICE 'FC1C' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2)
VMS4005 DEVICE 'FC1D' ASSIGNED TO VIRTUAL MACHINE (2,SYSTEM2)/show-vm-device-status units=(fc1c,fc1d),information=*std
UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BY ——————— (35)FC1C D3435 SYS2IMPL EXCL 2 SYSTEM2 VM-ADMIN
FC1D D3435 SYS2IMPL EXCL 2 SYSTEM2 VM-ADMIN***
*** Guest system operation on VM2:*** /attach-device unit=(fc1c,fc1d) ——————————————————————————————————— (36)
*** NKR0042 'DEVICE =FC1C': ATTACH ACCEPTED
*** NKR0042 'DEVICE =FC1D': ATTACH ACCEPTED*** NKR0040 'DEVICE =FC1C' ATTACHED
*** NKR0040 'DEVICE =FC1D' ATTACHED
*** NKVD010 DISK '4IVL.0' MOUNTED ON DEVICE 'FC1C'
*** NKVD010 DISK '4IVL.1' MOUNTED ON DEVICE 'FC1D'
*** NBR0740 COMMAND COMPLETED 'ATTACH-DEVICE';
*** (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
***/remove-vm-devices units=(fc1c,fc1d),vm-id=system2 ———————————————————— (37)
VMS4085 DEVICE 'FC1C' STILL ATTACHED IN GUEST SYSTEM. DEVICE NOT REMOVED
VMS4085 DEVICE 'FC1D' STILL ATTACHED IN GUEST SYSTEM. DEVICE NOT REMOVED/remove-vm-devices units=(fc1c,fc1d),vm-id=system2,
force=*no(wait-for-unassign=*yes) —————————————————— (38)VMS4087 DEVICE 'FC1C' REMAINS ASSIGNED TO VM (2,SYSTEM2) UNTIL DETACH IN
IN GUEST SYSTEM HAS BEEN DONEVMS4087 DEVICE 'FC1D' REMAINS ASSIGNED TO VM (2,SYSTEM2) UNTIL DETACH IN
IN GUEST SYSTEM HAS BEEN DONE
/show-vm-device-status units=(fc1c,fc1d),information=*std
UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BY ——————— (39)FC1C D3435 SYS2IMPL SH(D) 2 SYSTEM2 GUEST
FC1D D3435 SYS2IMPL SH(D) 2 SYSTEM2 GUEST***
*** Guest system operation on VM2:*** /detach-device unit=(fc1c,fc1d) ——————————————————————————————————— (40)
*** % NKR0092 'DEVICE =FC1C': /DETACH-DEVICE PENDING ACCEPTED
*** % NKR0092 'DEVICE =FC1D': /DETACH-DEVICE PENDING ACCEPTED*** % NKR0045 *** 'DEVICE =FC1C' DETACHED ***
*** % NKR0045 *** 'DEVICE =FC1D' DETACHED ***
*** NBR0740 COMMAND COMPLETED 'DETACH-DEVICE';
*** (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
***% VMS4009 DEVICE 'FC1C' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
(BY GUEST) ————————————————————————————————————————————————— (41)
% VMS4009 DEVICE 'FC1D' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2) (BY GUEST)
/show-vm-device-status units=(fc1c,fc1d),information=*std
UNIT DEV-TYPE PAV S ASSIGN-SET USAGE VM-ID/(#VM) ASSIGNED-BY ——————— (42)FC1C D3435 SYS2IMPL
FC1D D3435 SYS2IMPL
--------------------------------------------------------------------------------------------------------------
(34) | The VM2000 administrator assigns the pubset devices explicitly and exclusively to VM2. |
(35) | The output of |
(36) | The devices are attached in the guest system. |
(37) | The VM2000 administrator cannot remove the devices because they are still attached in the guest system. |
(38) | By means of the |
(39) | The output of |
(40) | The devices are detached in the guest system and consequently released implicitly. |
(41) | VM and VM2000 administrators are informed of the implicit device release by asynchronous messages. |
(42) | The devices are free once again. |
--------------------------------------------------------------------------------------------------------------
Implicit device release at shutdown
/shutdown-vm vm-id=system2,action=*shutdown(quiet-time=0) ————————————— (43)
VMS2054 SHUTDOWN OF GUEST SYSTEM ON VM (2,SYSTEM2) INITIATED
% 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% VMS2037 NON-INTERRUPTIBLE WAIT STATE FOR VIRTUAL MACHINE (2,SYSTEM2),
CODE 80FFFFFF, CPU 00
% VMS4009 DEVICE 'CC42' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2) ————— (44)
% VMS4009 DEVICE 'CC43' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
% VMS4009 DEVICE '990F' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)/show-vm-attributes vm-id=system2,information=*all
CPU-POOL(P)VM-ID VM-GROUP(G) CPU-Q MAX-U PROC MEM-SIZE MAX-IO
2 SYSTEM2 *STDPOOL(P) 30.00 100.00 1(+1) 512 (100)
VM-ID STATE VERSION PER ADMIN PRIV
2 SYSTEM2 DOWN V20.0B NO NO AG,AS —————————————————— (45)
VM-ID CPU-POOL GR-CPU-Q CPU-Q/ EFF-Q MAX-U/ EFF-U PROC
2 SYSTEM2 *STDPOOL 30.00/ 25.00 100.00/ 25.00 1(+1)VM-ID SCHED ACT-I VIRT CPUS
2 SYSTEM2 - NO 00(IDLE),01(IDLE)
VM-ID VM-MONJV
2 SYSTEM2 NO VM-MONJV ASSIGNED
VM-ID UNITS
2 SYSTEM2 ASSIGNED BY VM-ADMIN
EXCL: CH,CI,FC1A,FC1B —————————————————————————————————— (46)
...
--------------------------------------------------------------------------------------------------------------
(43) | The VM2000 administrator initiates the shutdown in the guest system. |
(44) | The implicitly assigned devices of VM2 are released (asynchronous messages to the VM and VM2000 administrators). |
(45) | The concluding information command shows that the guest system on VM2 is no longer active. |
(46) | Only the explicitly assigned devices are still with VM2. |
--------------------------------------------------------------------------------------------------------------
Explicit device release upon termination of the VM
/delete-vm vm-id=system2 —————————————————————————————————————————————— (47)
VMS4009 DEVICE 'CH' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
VMS4009 DEVICE 'CI' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)VMS4009 DEVICE 'FC1A' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
VMS4009 DEVICE 'FC1B' REMOVED FROM VIRTUAL MACHINE (2,SYSTEM2)
VMS4619 VIRTUAL MACHINE (2,SYSTEM2) REMOVED FROM CPU POOL '*STDPOOL'
VMS4024 VIRTUAL MACHINE (2,SYSTEM2) TERMINATED
/show-vm-assignment-set set-name=sys2impl ————————————————————————————— (48)
ASSIGNMENT-SET #DEVICES VM-ID
SYS2IMPL 5 NONE/modify-vm-device-attributes units=*by-assignment-set(set-name=sys2impl),
assign-by-guest=*no —————————————————————— (49) /show-vm-assignment-set set-name=sys2impl ————————————————————————————— (50)
ASSIGNMENT-SET #DEVICES VM-ID
SYS2IMPL 0 NONE/delete-assignment-set set-name=sys2impl —————————————————————————————— (51)
VMS4205 ASSIGNMENT SET 'SYS2IMPL' DELETED
/show-vm-assignment-set ——————————————————————————————————————————————— (52)ASSIGNMENT-SET #DEVICES VM-ID
*STDSET 0 NONE
--------------------------------------------------------------------------------------------------------------
(47) | VM2 is terminated. The explicitly assigned devices are removed. |
(48) | Assignment set |
(49) | Implicit device assignment is no longer to be permitted for the devices in assignment set |
(50) | Assignment set |
(51) | Assignment set |
(52) | Only the assignment set |