Explicit pubset assignment and removal

After a VM has been initialized, this VM can easily be assigned the devices of a pubset (pubset for short) using /ADD-VM-DEVICES or /SWITCH-VM-DEVICES with the *PUBSET-DEVICES(...) operand.

Explicit pubset assignment

Pubsets can be assigned explicitly to the VMs and thus to the guest systems

• by the VM2000 administrator, who assigns the required pubset devices to the VMs by specifying the catalog ID or the pubres device in the *PUBSET-DEVICES(...) operand in /ADD-VM-DEVICES or /SWITCH-VM-DEVICES.

• by the VM administrator with ADMIN-PRIVILEGES=*MAX, who assigns the required pubset devices to his or her VM by specifying the catalog ID or the pubres device in the *PUBSET-DEVICES(...) operand in /ADD-VM-DEVICES.

Pubsets for a VM can be entered in its VM definition with /CREATE- or /MODIFY-VM-DEFINITION. The pubset is represented in the (inactive) VM definition only by the pubres device (suffix (PR) in /SHOW-VM-DEFINITION). Only when the VM definition is activated are the other pubset devices also determined and entered in the VM definition (suffix (PD) in /SHOW-VM-DEFINITION). When the VM is terminated, the pubset devices (except for the pubres device) are removed from the VM definition. Detailed information can be found in the section "Working with VM definitions".

If explicit pubset assignment has taken place for a VM, the pubres device of the pubset assumes the PUBRES-FOR-ASSIGNMENT attribute in VM2000 device management. The attribute therefore always refers to the VM concerned. The attribute is removed again when the pubset or pubres device is explicitly released.

A pubres device (and possibly its DRV mirror disk) with the PUBRES-FOR-ASSIGNMENT attribute is marked by the suffix (P) in the ASSIGNED-BY column of the information output of /SHOW-VM-DEVICE-STATUS: VM-ADMIN(P).

When the VM is assigned a pubset by the VM2000 administrator, the VM administrator receives an information message for every assigned pubset device and a termination message for the entire pubset.

After pubsets are explicitly assigned to the VM, the pubset devices have to be attached in the guest system and the pubset has to be imported. This is done using /ATTACH-DEVICE UNIT=*PUBSET-DEVICES(...) and /IMPORT-PUBSET in the guest system or bay starting up the guest system. The pubset cannot be used in the guest system until it has been imported.

Explicit removal of pubsets

/REMOVE-VM-DEVICES or /SWITCH-VM-DEVICES explicitly removes a pubset which is no longer required from the VM. Before being removed, the pubset should be exported in the guest system using /EXPORT-PUBSET; the pubset devices should be detached using /DETACH-DEVICE. Implicitly and explicitly assigned pubsets can be removed. The pubset devices removed from a VM are then no longer available in the associated guest system.

The removal of devices that are still attached in the guest system is controlled by the FORCE operand. The WAIT-FOR-UNASSIGN operand can be used to convert explicit device assignment into implicit device assignment. The pubset devices then remain with the VM until they are detached in the guest system.

When the VM2000 administrator removes a device from the VM, the VM administrator receives an information message about every released pubset device and a termination message for the entire pubset.