Accounting in VM2000

VM2000 supplies two types of accounting records:

• Accounting record for devices.
  This record contains job accounting data on devices assigned to a VM.

• Accounting record for a VM.
  This record contains VM-specific job accounting data.

Device accounting records are written at the following times:

• When implicitly or explicitly assigned devices are removed from a VM or implicitly assigned devices are released by the guest system.

  Devices are removed from a VM by VM2000 by:

  • /REMOVE-VM-DEVICES or /SWITCH-VM-DEVICES (implicitly or explicitly assigned devices selectively)

  • /DELETE-VM (all devices)

  • /SHUTDOWN, abnormal system termination or restart in the guest system, /SHUTDOWN-VM, /START-VM or /RESET-VM (implicitly assigned devices, see "Assignment sets, implicit device assignment and release")

  • /SHUTDOWN in the monitor system (/DELETE-VM for all VMs)

  • A restart in the monitor system (implicitly assigned devices are released before SYSTEM READY, see "Assignment sets, implicit device assignment and release")

  • VM Migration (on the source SU)

  The guest system on a VM releases implicitly assigned devices by means of:

  • /DETACH-DEVICE in the guest system

• When /MODIFY-VM-ATTRIBUTES is specified and the same name is given for the VM as before and devices are assigned to the VM

An accounting record for a VM is written at the following times:

• The VM's main memory is reconfigured with /EXTEND-VM-MEMORY or /REDUCE-VM-MEMORY

• A VM is terminated with /DELETE-VM

• The same VM name is assigned to the VM as before using /MODIFY-VM-ATTRIBUTES

• The monitor system is terminated with /SHUTDOWN-VM VM-ID=*VM2000 or /SHUTDOWN

• VM Migration (on the source SU)

Interruption-free switching between to and from daylight savings time is supported by appropriate information in the accounting records.

If the user of the VM changes (without the VM being terminated and newly initialized), an accounting record can be created via the VM name with /MODIFY-VM-ATTRIBUTES. The new name must be the same as the old one.

The accounting records are written by the BS2000 accounting system in the monitor system (see the “Introduction to System Administration” [2]). Therefore, the accounting system in the monitor system should be always active.

Other guest systems do not write VM2000 accounting records.

Structure of the accounting records

The accounting records are divided up into four sections:

• Record description section

• ID section

• Basic information

• Variable information

These record sections contain the field number, displacement, length and format of the data field.

The field number indicates the current sequence number within the record section.

The displacement is the distance of the data field from the start of the record section.

The length is the length of the data field in bytes.

The format is the format of the data field:

A	alphanumeric (including “$”, “#” and “@”)
B	binary number
C	printable characters
F	BS2000 file name
Z	decimal number, unpacked (0...9)
-	undefined