Notes on pubset specification in the VM2000 commands

Certain requirements and constraints must be observed for controlling pubsets in the VM2000 commands:

• ADD-VM-DEVICES

  • If the pubres device is specified or can be found by VM2000 by means of the catalog ID but the other pubres devices cannot be found, only the pubres device is assigned to the VM.

  • If another (found) pubres device cannot be assigned to the VM, e.g. because a pubset device is already assigned exclusively to another VM, the entire command is not executed.

  • Pubset devices may already be assigned to the VM. In this case, an implicit assignment is changed into an explicit assignment by VM2000. The usage mode is adjusted by VM2000; if this is not possible, the entire command is not executed.

  • When the command is executed successfully, the pubres device is assigned the PUBRES-FOR-ASSIGNMENT attribute for this VM. The attribute is removed again in the event of explicit (pubset) release for the VM.

• REMOVE-VM-DEVICES
  • If the pubres device is specified or can be found by VM2000 by means of the catalog ID but the other pubres devices cannot be found, only the pubres device is removed from the VM.
  • The PUBRES-FOR-ASSIGNMENT attribute is removed from the pubres device for this VM.
  • Pubset devices may already have been removed from the VM.
  • When FORCE=*NO(WAIT-FOR-UNASSIGN=*NO) is specified, all pubset devices which are still assigned to the VM must be detached in the guest system; otherwise the entire command is not executed.
  • When FORCE=*NO(WAIT-FOR-UNASSIGN=*YES) is specified, the explicit assignment is converted into an implicit assignment by VM2000. In this case the PUBRES-FOR-ASSIGNMENT attribute is removed from the pubres device for this VM.
  • When the pubset is removed from the monitor VM, the pubset may not/no longer be imported in the monitor system.
• SWITCH-VM-DEVICES

  • If VM2000 cannot find the pubset devices, the command is not executed.

  • All pubset devices must be assigned to the FROM-VM. No pubset device may be assigned to the TO-VM.

  • If a pubset device cannot be removed and reassigned, the entire command is not executed.

  • When FORCE=*NO is specified, all pubset devices in the guest system of the FROM-VM must be detached.

  • If the FROM-VM is the monitor VM, the pubset may not/no longer be imported in the monitor system.

  • When the command is executed successfully, the pubres device is assigned the PUBRES-FOR-ASSIGNMENT attribute for the TO-VM. The attribute no longer applies after the pubres device has been removed for the FROM-VM.

• MODIFY-VM-DEVICE-ATTRIBUTES

  • If VM2000 cannot find the other pubset devices, the command is executed only for the pubres device.

  • When the command is executed successfully, the pubres device is assigned the PUBRES-FOR-ATTRIBUTES attribute. The attribute is removed only if the pubres device is specified explicitly in the device list in /MODIFY-VM-DEVICE-ATTRIBUTES. The attribute is retained when UNITS=*ALL / *PUBSET-DEVICES / *BY-ASSIGNMENT-SET or a device list with wildcards was specified.

• MODIFY-VM-DEVICE-USAGE

  • If VM2000 cannot find the pubset devices, the entire command is not executed.

  • If the usage mode cannot be changed for a pubset, the entire command is not executed, i.e.:

    • When USAGE=*EXCLUSIVE is specified, no pubset device in usage mode SH(I) may be assigned to the VM.

    • When USAGE=*SHARED is specified, no pubset device may be the current IPL device.

  • All pubset devices must be assigned to the VM.

• SHOW-VM-DEVICE-STATUS

  • If the pubres device is specified or can be found by VM2000 by means of the catalog ID but the other pubset devices cannot be found, only information on the pubres device is output.