z/VM: CP Commands and Utilities Reference - z/VM - IBM

DEDICATE
►►
DEDicate
Authorization
Purpose
Operands
USER
Usage Notes
userid
*
CPU
CPU
Privilege Class: A
ALL
cpuaddr
DEDICATE
Use DEDICATE to grant to a virtual processor the sole use of a real processor.
USER userid
USER *
specifies the user whose virtual CPU is to be dedicated to a real processor.
CPU ALL
specifies that a real processor be dedicated to every virtual CPU in the user
configuration, if possible. If CPU is not specified, CPU ALL is the default.
CPU cpuaddr
identifies the address of the virtual machine guest virtual CPU to which a real
processor is to be dedicated.
1. When DEDICATE USER userid CPU ALL is issued and there are more virtual
CPUs defined than there are available real processors, all the real processors
(except the master processor) are dedicated to those virtual CPUs, starting with
the lowest virtual CPU address.
2. If a virtual Vector Facility or Integrated Cryptographic Facility (ICRF) is defined
for a virtual CPU being dedicated, the system attempts to dedicate a real
processor that has an associated real facility. If another nondedicated processor
having no Vector Facility or ICRF associated with it is available, and the master
processor has a Vector Facility or ICRF, this may result in the master processor
being reassigned to that processor.
If a matching real processor cannot be found, the real processor most closely
matching the characteristics of the virtual CPU being dedicated is assigned to
that virtual CPU.
Note: If the last nondedicated Vector Facility or ICRF is being taken by a user
issuing DEDICATE, a message stating that no real Vector or Crypto
Facility is available to service nondedicated users is issued back to that
user.
Any guest that has a virtual Vector Facility or ICRF defined when the last real
Vector Facility or ICRF becomes unavailable subsequently receives a Vector
Facility or ICRF failure if the guest issues any vector or crypto instructions.
Guests that define virtual Vector Facilities or ICRFs after the last real facility has
gone away receive a warning message.
►◄
Chapter 2. CP Commands 111