Configuration via the VM2000 configuration file (SU /390)

On SU /390, the attributes and resources for the monitor VM are defined in the VM2000 configuration file.

This file is a SAM file, whose name is specified in the VM2000 parameters (default: SYSPAR.VM2000-MON.<ver>).

In the configuration file, comment lines (/REMARK) are also permitted. Continuation lines are not permitted. A line should not exceed 159 characters in length.

The configuration file may contain the following VM2000 commands:

• /CREATE-VM (see command description on "CREATE-VM (Initialize a VM)")

  This command defines the following attributes and resources for the monitor VM:

  • Main memory size of the monitor VM in Mbytes
    The DIMENSION operand cannot be specified (MEMORY-SIZE = <integer 1..1048576>).
    Main memory size is at least 512 Mbytes (default value).

  • Minimum main memory size of the monitor VM
    MIN-MEMORY-SIZE = *STD (default value) is recommended. Minimum: 512 Mbytes. The DIMENSION operand cannot be specified.

  • Maximum main memory size of the monitor VM (MAX-MEMORY-SIZE)
    This operand is of no significance.

  • VM name (VM-NAME)
    Max. 8 characters, default value: VM0001.

  • CPU quota of the monitor VM (CPU-QUOTA)
    Integer from 1 to 99, default value: 14.
    The CPU-QUOTA=*BY-VM-GROUP(...) operand cannot be specified as no VM group is created in the startup phase of the monitor system. The monitor VM can be added to a VM group later using /ADD-VM-TO-VM-GROUP.

  • Maximum CPU utilization of the monitor VM (MAX-CPU-UTILIZATION)
    Integer from 1 to 100, default value: 100.

  • Maximum I/O utilization of the monitor VM (MAX-IO-UTILIZATION)
    Integer from 1 to 100, default value: 100.

  • Assigning the monitor VM to a CPU pool (CPU-POOL)
    This operand cannot be specified.
    The monitor VM is initially always assigned to the standard CPU pool. It can be assigned to a different CPU pool later using /ASSIGN-VM-TO-CPU-POOL.

  • Administration password (PASSWORD)
    Max. 8 bytes, default value: *NONE (no password).

  • Multiprocessor level (PROCESSOR = *MONO / *BI / *TRIPLE / *QUADRO / *OCTO / *MAXIMUM / *EXTRA-AND-NORMAL / <integer 1..16>)
    Default value: *MAXIMUM, i.e. the monitor VM is created with the maximum possible number of virtual CPUs. The maximum number of virtual CPUs corresponds to the number of real normal CPUs in the Server Unit, but may not be greater than 16 virtual CPUs.

    If there is no productive operation in the monitor system but only administration, the multiprocessor level *MONO (with virtual spare CPU) or *BI (failsafe operation) should be selected to avoid performance losses in the VM2000 system.

    If VM Migration is to be used, the multiprocessor grade *BI is recommended and expected for a performant process.

  • Location of monitor the VM in main memory (LOCATION)
    This operand is of no significance.
    The location of the monitor VM in main memory is determined by VM2000.

  • VM index (VM-INDEX)
    This operand is of no significance.
    “1” is always assumed to be the VM index of the monitor VM.

  • Command/function range for the VM2000 administrator (ADMIN-PRIVILEGES=*STD/*MIN)
    Default value: *STD (full range).

  • Privileges of the monitor VM
    (IO-RESET=*NO/*YES, IO-PRIORITY=*NO/*YES, AUTO-SNAP-ASSIGNMENT=*YES/*NO, ASSIGN-BY-GUEST=*NO/*YES without specification of PRIVILEGES=*PARAMETERS(...))
    For the meaning, see "Initializing a VM".
    Assignment sets (ASSIGN-BY-GUEST=*YES) cannot be specified.

  • Specification whether, in the case of fixed CPU assignment (dedicated CPUs), the monitor VM still retains control over a real CPU if its virtual CPU becomes inactive (interruptible wait state)
    (VM-ACTIVE-IDLE=*NO/*AT-DEDICATED-CPUS)
    Default value: *NO (the virtual CPU is removed).

  • MONJV to monitor the VM (MONJV)
    The operand cannot be specified for the monitor VM.

  • PERSISTENT attribute for persistent creation of the VM
    Only PERSISTENT=*NO may be specified for the monitor VM.

• /ADD-VM-DEVICES
UNITS=list-poss(28):<alphanum-name 2..2>/<x-text 4..4>
(see command description in section "ADD-VM-DEVICES (Allocate devices to a VM)")

  This command is used (however many times is necessary) to assign VM devices to the monitor VM. Wildcards, device ranges or pubsets cannot be specified here. The KVP console device pair and the devices of the home pubset are automatically assigned explicitly to the monitor VM at startup of the monitor system.

Commands in the configuration file which do not refer to the monitor VM are ignored.

If /CREATE-VM is issued more than once, the operand values of the most recent correct command are used to initialize the monitor VM. If /ADD-VM-DEVICES is specified for a device more than once, the TYPE operand of the last correctly entered command is used for the device.

   

Example of a configuration file

/CREATE-VM MEM-S=512,MIN-MEM-S=512,VM-N=MONITOR,CPU-Q=20,PROC=BI,PASS=   (1) 
/REMARK HOME PUBSET (SPECIFICATION OPTIONAL) ——————————————————————————  (2) 
/ADD-VM-DEVICES VM-ID=1,UNITS=(9900,9901,9902) ————————————————————————  (3) 
/REMARK REDUNDANT MAIN CONSOLES 
/ADD-VM-DEVICES VM-ID=1,UNITS=(C2,C3,C4,C5) 
/REMARK EMULATED LAN DEVICES OF REDUNDANT MANAGEMENT UNITS
/ADD-VM-DEVICES VM-ID=1,UNITS=(CC80,CC81,CD80,CD81) 
/REMARK REDUNDANT HNC DEVICES
/ADD-VM-DEVICES VM-ID=1,UNITS=(CC40,CC41,CD40,CD41) 
/REMARK SHARED DISK 
/ADD-VM-DEVICES VM-ID=1,UNITS=990F,TYPE=*SD ———————————————————————————  (4) 

(1)	Set up monitor VM.
(2)	Comment line.
(3)	Certain devices are assigned exclusively to the monitor VM.
(4)	A device is assigned to be shared between the monitor VM and other VMs.

   

Initializing the monitor system without the configuration file is only possible if the entire paging area has been created on the home pubset of the monitor system.

The following cases must be distinguished:

• Dialog startup
  In this case, it is possible to enter the commands listed above for the monitor VM. If this is not done, the default values apply to the monitor VM, and the KVP console and the devices of the home pubset are assigned to the monitor VM explicitly at startup.

• Fast and automatic startup
  In this case, the default values for /CREATE-VM apply (see above), and the KVP console and the devices of the home pubset are assigned to the monitor VM explicitly at startup.