MODIFY-VM-DEFINITION (Modify VM definition)

/MODIFY-VM-DEFINITION is used to modify a VM definition. The VM definition may not belong to a VM which has already been initialized.

The following attributes and resources can be modified in the VM definition:

• VM index

• Main memory size of the VM

• Minimum and maximum main memory size of the VM for main memory reconfiguration

• Multiprocessor level of the VM

• (Member) CPU quota and maximum CPU utilization of the VM

• Adding of the VM to a VM group (SU /390)

• Assignment of the VM to a CPU pool

• Settings for controlling the real CPU (SU /390)

• Maximum I/O utilization of the VM (SU /390)

• Devices of the VM

• The password for administration

• Range of commands for the VM administrator

• Privileges of the VM

  As it is recommended that a VM be created without the privileges IO-PRIORITY and IO-RESET (see "CREATE-VM (Initialize a VM)"), IO-PRIORITY=*NO and IO-RESET=*NO should also be entered for the VM in the VM definition.

• PERSISTENT attribute

• Specifications for automatic startup of the guest system on the VM when activating the VM definition

The VM name cannot be modified.

The attributes of a VM which has already been initialized can be modified using /MODIFY-VM-ATTRIBUTES.

This command is reserved for the VM2000 administrator.

MODIFY-VM-DEFINITION

VM-NAME = <name 1..8>
,VM-INDEX = *UNCHANGED / *ANY / <integer 2..99>
,MEMORY-SIZE = *UNCHANGED / <integer 1..1048576>(DIMENSION = *MEGABYTE / *GIGABYTE)
,MIN-MEMORY-SIZE = *UNCHANGED / *STD /
								<integer 1..1048576>(DIMENSION = *MEGABYTE / *GIGABYTE)
,MAX-MEMORY-SIZE = *UNCHANGED / *STD /
								<integer 1..1048576>(DIMENSION = *MEGABYTE / *GIGABYTE)
,PROCESSOR = *UNCHANGED / *MONO / *BI / *TRIPLE / *QUADRO / *OCTO / *MAXIMUM /
						*EXTRA-AND-NORMAL / <integer 1..32>
,CPU-QUOTA = *UNCHANGED / <fixed 0.01..99.99>(...) / *BY-VM-GROUP(...)
	<fixed 0.01..99.99>(...)
		|	CPU-POOL-NAME = *UNCHANGED-OR-STDPOOL / *STDPOOL / <name 1..8>
	*BY-VM-GROUP(...)
		|	VM-GROUP-NAME = <name 1..8>
		|	,MEMBER-CPU-QUOTA = <fixed 0.01..99.99>
,MAX-CPU-UTILIZATION = *UNCHANGED / <fixed 0.01..100.00>
,VM-ACTIVE-IDLE= *UNCHANGED / *NO / *AT-DEDICATED-CPUS
,MAX-IO-UTILIZATION =*UNCHANGED / <integer 1..100>
,DEVICES = *UNCHANGED / *ADD(...) / *REMOVE(...) / *MODIFY(...)
	*ADD(...)
		|	UNITS = list-poss(28): *PUBSET-DEVICES(...) / *DEVICE-RANGE(...) /
		|								<alphanum-name 1..4 with-wild(20)(...)>
		|		*PUBSET-DEVICES(...)
		|			|	PUBSET = *BY-PUBRES-DEVICE(...) / <cat-id 1..4>
		|			|		*BY-PUBRES-DEVICE(...)
		|			|			|	UNIT = <alphanum-name 2..2> / <x-text 4..4>
		|			|	,USAGE = *EXCLUSIVE / *SHARED
		|		*DEVICE-RANGE(...)
		|			|	FROM = <alphanum-name 2..2> / <x-text 4..4>
		|			|	,TO = <alphanum-name 2..2> / <x-text 4..4>
		|			|	,USAGE = *EXCLUSIVE / *SHARED
		|		<alphanum-name 1..4 with-wild(20)(...)>
		|			|	USAGE = *EXCLUSIVE / *SHARED / *VC

	*REMOVE(...)
		|	UNITS = *ALL / list-poss(28): *PUBSET-DEVICES(...) / *DEVICE-RANGE(...) /
		|									<alphanum-name 1..4 with-wild(20)>
		|		*PUBSET-DEVICES(...)
		|			|	PUBSET = *BY-PUBRES-DEVICE(...) / <cat-id 1..4>
		|			|		*BY-PUBRES-DEVICE(...)
		|			|			|	UNIT = <alphanum-name 2..2> / <x-text 4..4>
		|		*DEVICE-RANGE(...)
		|			|	FROM = <alphanum-name 2..2> / <x-text 4..4>
		|			|	,TO = <alphanum-name 2..2> / <x-text 4..4>
	*MODIFY(...)
		|	UNITS = list-poss(28): *PUBSET-DEVICES(...) / *DEVICE-RANGE(...) /
		|								<alphanum-name 1..4 with-wild(20)(...)>
		|		*PUBSET-DEVICES(...)
		|			|	PUBSET = *BY-PUBRES-DEVICE(...) / <cat-id 1..4>
		|			|		*BY-PUBRES-DEVICE(...)
		|			|			|	UNIT = <alphanum-name 2..2> / <x-text 4..4>
		|			|	,USAGE = *EXCLUSIVE / *SHARED
		|		*DEVICE-RANGE(...)
		|			|	FROM = <alphanum-name 2..2> / <x-text 4..4>
		|			|	,TO = <alphanum-name 2..2> / <x-text 4..4>
		|			|	,USAGE = *EXCLUSIVE / *SHARED
		|		<alphanum-name 1..4 with-wild(20)(...)>
		|			|	USAGE = *EXCLUSIVE / *SHARED
,PASSWORD = *UNCHANGED / *NONE / <c-string 1..8> / <x-string 1..16>
,ADMIN-PRIVILEGES = *UNCHANGED / *STD / *MAXIMUM

,PRIVILEGES = *PARAMETERS(...)
	*PARAMETERS(...)
		|	IO-RESET = *UNCHANGED / *NO / *YES
		|	,IO-PRIORITY = *UNCHANGED / *NO / *YES
		|	,AUTO-SNAP-ASSIGNMENT = *UNCHANGED / *YES / *NO
		|	,ASSIGN-BY-GUEST = *UNCHANGED / *NO / *YES(...)
		|		*YES(...)
		|			|	SET-NAME = *STDSET / *ALL / *EXCEPT(...) / *ADD(...) / *REMOVE(...) /
		|			|					list-poss(8): <name 1..8> / *STDSET
		|			|		*EXCEPT(...)
		|			|			|	SET-NAME = list-poss(8): <name 1..8> / *STDSET
		|			|		*ADD(...)
		|			|			|	SET-NAME = list-poss(8): <name 1..8> / *STDSET
		|			|		*REMOVE(...)
		|			|			|	SET-NAME = list-poss(8): <name 1..8> / *STDSET
,PERSISTENT = *UNCHANGED / *YES(...)
	*YES(...)
		|	,AUTO-IPL= *NO / *YES(...)
		|		*YES(...)
		|			|	IPL-UNIT = *UNCHANGED-OR-NONE / <alphanum-name 2..2> / <x-text 4..4>
		|			|	,IPL-CONSOLE = *UNCHANGED-OR-NONE / <alphanum-name 2..2>
		|			|	,MODE = *UNCHANGED-OR-AUTOMATIC / *AUTOMATIC / *FAST
		|			|	,SYSTEM-NAME = *UNCHANGED-OR-NONE / *NONE / <name 1..8>

If no more detailed explanation is specified, the operand value *UNCHANGED means that the existing setting for the operand value is retained.

VM-NAME = <name 1..8>
Name of the VM definition which is to be modified.

VM-INDEX =
The VM index.

VM-INDEX = *ANY
The VM index is assigned by VM2000 when the VM definition is activated.

VM-INDEX = <integer 2..99>
Specifies the VM index.

In the case of a standard VM name (e.g. VM0002), only the appropriate VM index (in this case 2) may be specified.

If VM-INDEX=*ANY is specified and the VM migrated later on (VM Migration), the VM will receive any free VM index on the target SU. Otherwise, the specified (fixed) VM index must be available on the target SU as well.

MEMORY-SIZE = <integer 1..1048576>(DIMENSION = *MEGABYTE / *GIGABYTE)
Predefined size of main memory for the appropriate VM up to a size of 1 Tbyte
(terabyte; 1 Tbyte = 1024 Gbytes = 1 048 576 Mbytes).

On SU x86, a small amount of a VM’s main memory is required for the firmware component. The main memory of a VM must be at least 1024 Mbytes large. The value must be a multiple of 2 Mbytes.

MIN-MEMORY-SIZE = *STD / <integer 1..1048576>(DIMENSION = *MEGABYTE / *GIGABYTE)
Predefined minimum size of the main memory for the relevant VM when main memory is reconfigured. The default is the size of the main memory for the VM as defined by MEMORY-SIZE.

On SU x86, the main memory of a VM must be at least 1024 Mbytes in size. The value must be a multiple of 2 Mbytes.

MAX-MEMORY-SIZE = *STD / <integer 1..1048576>(DIMENSION = *MEGABYTE / *GIGABYTE)
Predefined maximum size of the main memory for the VM when main memory is reconfigured. The default value is twice the size of the VM’s main memory which is predefined by MEMORY-SIZE. Take note of the information in section "Initializing a VM".

	This operand has no effect for SU /390.
	The value must be a multiple of 2 Mbytes for SU x86.

PROCESSOR =
Envisaged multiprocessor level of the VM (see "Virtual CPUs").

PROCESSOR = *MONO
The VM is to be created with one virtual CPU.

PROCESSOR = *BI
The VM is to be created with two virtual CPUs.

PROCESSOR = *TRIPLE
The VM is to be created with three virtual CPUs.

PROCESSOR = *QUADRO
The VM is to be created with four virtual CPUs.

PROCESSOR = *OCTO
The VM is to be created with eight virtual CPUs.

PROCESSOR = *MAXIMUM
A VM with the maximum possible number of virtual CPUs is to be created. The maximum possible number of virtual CPUs matches the number of real normal CPUs which are available for VM2000 operation, see "Real CPUs".
 On SU /390, the maximum number of virtual CPUs is 16.

PROCESSOR = *EXTRA-AND-NORMAL
A VM is to be configured with as many virtual CPUs as normal CPUs and extra CPUs are available for VM2000 operation.
 On SU /390, up to 16 virtual CPUs are possible.

A VM with this number of CPUs can utilize the maximum CPU capacity, including the CPU capacity of the attached extra CPUs. For a Server Unit without extra CPUs this value is the same as the value of PROCESSOR=*MAXIMUM.

PROCESSOR = <integer 1..32>
A VM is set up with the number of virtual CPUs specified here. A value less than or equal to the value of PROCESSOR=*MAXIMUM is permissible.

CPU-QUOTA =
Envisaged CPU quota of the VM.

CPU-QUOTA = <fixed 0.01..99.99>(...)
CPU quota of a VM which is not (yet) to be assigned to a VM group when the VM definition is activated. Determines the VM’s share of the CPU capacity of the CPU pool in comparison to the VM groups and the other VMs which have not been added to a VM group (see "Planning distribution of the CPU capacity to the VMs").

CPU-POOL-NAME =
Defines the CPU pool to which the VM is to be assigned when the VM definition is activated.
Every VM is always assigned to precisely one CPU pool.
When the VM definition is activated, the CPU pool must possess at least one attached real CPU.

CPU-POOL-NAME = *UNCHANGED-OR-STDPOOL
If the VM was (previously) not to be assigned to a VM group, the existing assignment to a CPU pool is retained. If the VM was previously to be assigned to a VM group, it is no longer assigned to a VM group. It is assigned to the standard CPU pool.

CPU-POOL-NAME = *STDPOOL
The VM is assigned to the standard CPU pool.

CPU-POOL-NAME = <name 1..8>
Name of the CPU pool to which the VM is assigned.

CPU-QUOTA = *BY-VM-GROUP(...)
CPU quota of a VM which is to be assigned to the specified VM group when the VM definition is activated (SU /390). This determines the VM’s CPU share in comparison to the other VMs in the VM group (see "Operating VM groups (SU /390)"). The VM is implicitly assigned to the CPU pool of the VM group.

VM-GROUP-NAME = <name 1..8>
Name of the VM group to which the VM is added.

MEMBER-CPU-QUOTA = <fixed 0.01..99.99>
Member CPU quota of the VM.

MAX-CPU-UTILIZATION = <fixed 0.01..100.00>
Envisaged maximum CPU utilization of the VM (see "Planning distribution of the CPU capacity to the VMs").

If the VM belongs to a VM group, its maximum CPU utilization is also restricted by the “maximum CPU utilization of the VM group” (see "Operating VM groups (SU /390)").

VM-ACTIVE-IDLE =
Determines on SU /390 whether, in the event of fixed CPU assignment (dedicated CPUs), a VM still retains control over a real CPU if the VM’s virtual CPU which runs on this is inactive (interruptible wait state, "Idle"), see "Initializing a VM".

VM-ACTIVE-IDLE = *NO
The VM leaves control over the real CPU if the VM’s virtual CPU which runs on this becomes inactive (interruptible wait state, "Idle").

VM-ACTIVE-IDLE = *AT-DEDICATED-CPUS
The VM retains control over the real CPU even if the VM’s virtual CPU which runs on this is inactive (interruptible wait state, "Idle"). This idle time is then indicated in the VM2000 accounting records, with /SHOW-VM-STATUS (VM-ACTIVE output column) and in the VM2000 report of openSM2 as a time in which the VM actively uses the real CPU.

With fixed CPU assignment, VM-ACTIVE-IDLE=*AT-DEDICATED-CPUS is only effective if the VM’s maximum CPU utilization is not restricted.

MAX-IO-UTILIZATION = <integer 1..100>
Envisaged maximum I/O utilization of the VM (SU /390, see "Use of IORM in VM2000 operation").

DEVICES =
Changes the number of devices which is to be assigned to the VM when the VM definition is activated.

DEVICES = *ADD(...)
Further devices are to be assigned to the VM when the VM definition is activated.

UNITS =
Determines the devices which are to be assigned to the VM when the VM definition is activated.

UNITS = *PUBSET-DEVICES(...)
The devices of a pubset are to be assigned to the VM when the VM definition is activated.

See also "Notes on pubset specification in the VM2000 commands" and "Pubset reconfiguration".

PUBSET =
Determines the pubset. Only the pubset is noted in the VM definition. The devices of the pubset are determined only when the VM definition is activated.

PUBSET = *BY-PUBRES-DEVICE(...)
Determines the devices of the pubset by means of the pubres device.

UNIT = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device name of the pubres device.

PUBSET = <cat-id 1..4>
Catalog ID of the pubset. The pubset must be entered together with its pubres device in the monitor system’s MRS catalog.

USAGE =
Specifies the usage mode which the devices of the VM's pubset are to be assigned when the VM definition is activated.

USAGE = *EXCLUSIVE
The devices are to be assigned exclusively to the VM.

USAGE = *SHARED
The devices are to be assigned to the VM as shareable (usage mode SHARED), see "Usage mode of a device".

UNITS = *DEVICE-RANGE(...)

The VM is to be assigned all devices contained in this name range when the VM definition is activated. All devices currently contained in the name range are entered in the VM definition.

Device names <x-text 4..4> (in *DEVICE-RANGE) are selected from FROM to TO in hexadecimal order. Otherwise, device names <alphanum-name 2..2> are selected in alphabetical order.

If UNITS are specified with *DEVICE-RANGE or with wildcards, alias devices (PAV/DPAV) and CRD devices are ignored.

FROM = <alphanum-name 2..2> / <x-text 4..4>
Defines the start of the name range.

TO = <alphanum-name 2..2> / <x-text 4..4>
Defines the end of the name range. The mnemonic device name must be in the same value range (2- or 4-digit mn) as the FROM device name and must be greater than or equal to the FROM device name in ascending order in the value range.

USAGE = *EXCLUSIVE / *SHARED
Specifies the usage mode which the devices in the name range of the VM are to be assigned when the VM definition is activated. See "operand USAGE for *PUBSET-DEVICES".

UNITS = <alphanum-name 1..4 with-wild(20)>(...)
The VM is to be assigned the specified devices when the VM definition is activated. The devices are entered in the VM definition.

USAGE = *EXCLUSIVE / *SHARED
Specifies the usage mode which the devices of the VM are to be assigned when the VM definition is activated. See "operand USAGE for *PUBSET-DEVICES".

USAGE = *VC
The device is to be assigned exclusively to the VM as a virtual console when the VM definition is activated (SU /390). It must be appropriately generated. Only one device for each VM can be operated as a virtual console.

DEVICES = *REMOVE(...)
Fewer devices are to be assigned to the VM when the VM definition is activated. The devices are removed from the VM definition.

Devices which are not contained in the VM definition are ignored.

UNITS =
Determines the devices which are no longer to be assigned to the VM when the VM definition is activated.

UNITS = *ALL
No device is to be assigned to the VM any more when the VM definition is activated.

UNITS = *PUBSET-DEVICES(...)
The devices of a pubset are no longer to be assigned to the VM when the VM definition is activated.

See also "Notes on pubset specification in the VM2000 commands" and "Pubset reconfiguration".

PUBSET =
Determines the pubset which is to be removed from the VM definition.

PUBSET = *BY-PUBRES-DEVICE(...)
Determines the pubset via the pubres device.

UNIT = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device name of the pubres device.

PUBSET = <cat-id 1..4>
Catalog ID of the pubset. The pubset must be entered together with its pubres device in the monitor system’s MRS catalog.

UNITS = *DEVICE-RANGE(...)
The VM is no longer to be assigned the devices contained in this name range when the VM definition is activated. All devices currently contained in the name range are removed from the VM definition.

Device names <x-text 4..4> (in *DEVICE-RANGE) are selected from FROM to TO in hexadecimal order. Otherwise, device names <alphanum-name 2..2> are selected in alphabetical order.

FROM = <alphanum-name 2..2> / <x-text 4..4>
Defines the start of the name range.

TO = <alphanum-name 2..2> / <x-text 4..4>
Defines the end of the name range. The mnemonic device name must be in the same value range (2- or 4-digit mn) as the FROM device name and must be greater than or equal to the FROM device name in ascending order in the value range.

UNITS = <alphanum-name 1..4 with-wild(20)>
The VM is no longer to be assigned the specified devices when the VM definition is activated. The devices are removed from the VM definition.

DEVICES = *MODIFY(...)
The usage mode of the devices entered in the VM definition is modified.

Devices which are not contained in the VM definition are ignored.

UNITS =
Determines the devices whose usage mode is modified.

UNITS = *PUBSET-DEVICES(...)
The usage mode of the devices of a pubset is modified.

See also "Notes on pubset specification in the VM2000 commands" and "Pubset reconfiguration".

PUBSET =
Determines the pubset.

PUBSET = *BY-PUBRES-DEVICE(...)
Determines the devices of the pubset by means of the pubres device.

UNIT = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device name of the pubres device.

PUBSET = <cat-id 1..4>
Catalog ID of the pubset. The pubset must be entered together with its pubres device in the monitor system’s MRS catalog.

USAGE =
Specifies the usage mode which the devices of the VM's pubset are to be assigned when the VM definition is activated.

USAGE = *EXCLUSIVE
The devices are to be assigned exclusively to the VM.

USAGE = *SHARED
The devices are to be assigned to the VM as shareable (usage mode SHARED), see "Usage mode of a device".

UNITS = *DEVICE-RANGE(...)
The usage mode of all devices contained in this name range is modified.

Device names <x-text 4..4> (in *DEVICE-RANGE) are selected from FROM to TO in hexadecimal order. Otherwise, device names <alphanum-name 2..2> are selected in alphabetical order.

FROM = <alphanum-name 2..2> / <x-text 4..4>
Defines the start of the name range.

TO = <alphanum-name 2..2> / <x-text 4..4>
Defines the end of the name range. The mnemonic device name must be in the same value range (2- or 4-digit mn) as the FROM device name and must be greater than or equal to the FROM device name in ascending order in the value range.

USAGE = *EXCLUSIVE / *SHARED
Specifies the usage mode which the devices in the name range of the VM are to be assigned when the VM definition is activated. See "operand USAGE for *PUBSET-DEVICES".

UNITS = <alphanum-name 1..4 with-wild(20)>(...)
The usage mode of the specified devices is modified.

USAGE = *EXCLUSIVE / *SHARED
Specifies the usage mode which the devices of the VM are to be assigned when the VM definition is activated. See "operand USAGE for *PUBSET-DEVICES".

PASSWORD =
Password controlling access authorization in /BEGIN-VM-DIALOG. The password can be up to 8 bytes long.

PASSWORD = *NONE
No password is necessary.

PASSWORD = <c-string 1..8>
Password in character form.

PASSWORD = <x-string 1..16>
Password in hexadecimal form. The password comprising zeros only (X'00..00') is ignored.

ADMIN-PRIVILEGES =
Defines the envisaged command/function range for the VM administrator (see "Extending and restricting the range of commands/functions").

ADMIN-PRIVILEGES = *STD
Standard command/function range.

ADMIN-PRIVILEGES = *MAXIMUM
Extended command/function range for the VM administrator.

PRIVILEGES = *PARAMETERS(...)
Describes privileges of the VM (see "Initializing a VM").

IO-RESET = *NO / *YES
Specifies on SU /390 whether the channels are reset in the hardware for this VM at /START-VM or when the guest system is restarted or the channels reconfigured.

IO-PRIORITY = *NO / *YES
Specifies on SU /390 whether a waiting virtual CPU of the VM is executed again on a real CPU by the VM2000 hypervisor immediately after the end of pending input/output for this VM.

The total number of virtual CPUs of all the VMs with this privilege may not be greater than the number of the real normal CPUs of the Server Unit.

AUTO-SNAP-ASSIGNMENT = *YES / *NO
Determines whether the guest system on the VM may assign itself snap units for Snapsets implicitly without the VM and devices being assigned the ASSIGN-BY-GUEST privilege or attribute.

ASSIGN-BY-GUEST = *NO / *YES(...)
Specifies whether devices can also be assigned implicitly to this VM by the guest system (*YES).
Alternatively (*NO), the devices must be assigned explicitly to the VM by the VM or VM2000 administrator.

SET-NAME =
Determines the assignment sets from which the guest system may assign devices implicitly to the VM. A VM can be assigned up to 28 assignment sets by means of explicit list specification.

SET-NAME = *STDSET / list-poss (8): <name 1..8> / *STDSET
Explicit specification of the assignment sets.

SET-NAME = *ALL
All existing and future assignment sets.

SET-NAME = *EXCEPT(SET-NAME = list-poss (8): <name 1..8> / *STDSET)
All existing and future assignment sets with the exception of those which are specified with SET-NAME.

SET-NAME = *ADD(SET-NAME = list-poss (8): <name 1..8> / *STDSET)
Extends the existing set of assignment sets for the VM.

SET-NAME = *REMOVE(SET-NAME = list-poss (8): <name 1..8> / *STDSET)
Reduces the existing set of assignment sets for the VM.

PERSISTENT = *YES(...)
Determines that the PERSISTENT attribute is to be assigned to the VM definition.
The VM definition becomes or remains persistent.
For a VM definition which is already persistent, the setting can be modified whether the guest system on the VM is to be started automatically the next time the VM definition is activated (AUTO-IPL operand). When the guest system on the VM which is already persistent is to be started automatically the next time the VM definition is activated, the specifications for the automatic startup of the guest system on the VM can be modified.

AUTO-IPL =
Determines whether the guest system on the VM is to be started automatically the next time the persistent VM definition is activated.

AUTO-IPL = *NO
The guest system on the VM is not started automatically.

Specifications for the IPL-UNIT, IPL-CONSOLE, MODE and SYSTEM-NAME parameters made earlier are retained in the VM definition and can be reactivated using this command and the specification AUTO-IPL=*YES.

AUTO-IPL = *YES(...)
The guest system on the VM is started automatically.
The parameters for the automatic startup must be supplied with values appropriately.

IPL-UNIT = *UNCHANGED-OR-NONE
When a non-persistent VM definition is assigned the VM attribute PERSISTENT, IPL-UNIT=*NONE is entered in the VM definition. In the case of a VM definition which is already persistent (e.g. when switching from AUTO-IPL=*NO to AUTO-IPL=*YES), the existing entry for IPL-UNIT in the VM definition is retained.

IPL-UNIT = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device name of the disk device used for the initial program loading (IPL) of the guest system. The device must be assigned to the VM explicitly and exclusively.

IPL-CONSOLE = *UNCHANGED-OR-NONE
When a non-persistent VM definition is assigned the VM attribute PERSISTENT, IPL-CONSOLE=*NONE is entered in the VM definition. In the case of a VM definition which is already persistent (e.g. when switching from AUTO-IPL=*NO to AUTO-IPL=*YES), the existing entry for IPL-CONSOLE in the VM definition is retained.

IPL-CONSOLE = <alphanum-name 2..2>
Mnemonic device name of the KVP output device.

MODE = *UNCHANGED-OR-AUTOMATIC
When a non-persistent VM definition is assigned the VM attribute PERSISTENT, MODE=*AUTOMATIC is entered in the VM definition. In the case of a VM definition which is already persistent (e.g. when switching from AUTO-IPL=*NO to AUTO-IPL=*YES), the existing entry for MODE in the VM definition is retained.

MODE = *AUTOMATIC / *FAST
Defines the type of system initialization (AUTOMATIC or FAST startup).

SYSTEM-NAME = *UNCHANGED-OR-NONE
When a non-persistent VM definition is assigned the VM attribute PERSISTENT, SYSTEM-NAME=*NONE is entered in the VM definition. In the case of a VM definition which is already persistent (e.g. when switching from AUTO-IPL=*NO to AUTO-IPL=*YES), the existing entry for SYSTEM-NAME in the VM definition is retained.
 The specification is ignored on SU /390.

SYSTEM-NAME = *NONE / <name 1..8>
Specifies the system name.
 The specification is ignored on SU /390.

 

Command return codes

(SC2)   SC1	Main code	Meaning
0 1             0 1             0 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64 64	CMD0001 VMS4035 VMS4180 VMS2300 VMS2307 VMS2310 VMS2313 VMS2332 VMS2315 VMS2317 VMS3002 VMS4006 VMS4012 VMS4015 VMS4016 VMS4060 VMS4093 VMS4190 VMS4195 VMS4211 VMS4253	Command successfully executed No corresponding device found (possibly only alias or CRD devices were specified) Specified set of devices empty VM definition does not exist VM definition could not be modified Generation of the VM definition not confirmed in the expected time Device specified more than once with different usage modes Storage for VM definitions cannot be reached (SU /390) Device already entered in VM definition with different usage mode Memory specifications do not match the values entered in the VM definition Invalid value for operand Device not available Requested memory size too small VM already initialized Device cannot be used as a virtual console Only one virtual console possible per VM Invalid specifications for memory size of a VM Device is an alias device (PAV/DPAV) Device is CRD Maximum number of assignment sets already assigned to the VM Pubres device of the pubset which was specified via the CATID cannot be determined

Example

See section "Examples of working with VM definitions".