DETACH CPU

Read syntax diagramSkip visual syntax diagram DETach CPU ALLcpuaddrcpuaddr1-cpuaddr2

Authorization

Privilege Class: G

Purpose

Use DETACH CPU to remove processors from your virtual machine configuration.

Operands

ALL
specifies all virtual processors currently defined.
cpuaddr
is the processor address of the processor that you want to detach from your virtual machine configuration.
cpuaddr cpuaddr
is a list of addresses and/or ranges delimited by spaces.
cpuaddr1-cpuaddr2
specifies a nonwrapping pair of addresses separated by a hyphen (-) and not separated by any blanks.

Usage Notes

  1. You can detach any virtual processor from your virtual machine configuration except the base processor. You cannot detach the base processor from your virtual machine system.
  2. Whenever you detach a virtual processor, your virtual machine is reset as if a CP SYSTEM CLEAR command had been processed. The effects of this system-reset-clear function are described in detail in the description for the SYSTEM CLEAR command. The system-reset-clear function sets all of your virtual machine's storage to binary zeros. Therefore, you must repeat your IPL procedure to proceed.
  3. SET IMSG OFF suppresses informational messages for this command.
  4. For more information, see Usage Notes.

Responses

CPU nn DETACHED
indicates that the command has been successfully processed.
This response is followed by:
STORAGE CLEARED - SYSTEM RESET
indicating that all of your virtual machine's storage has been cleared to binary zeros, and your processors and I/O configuration have been reset.
nn
identifies the number of the CPU currently defined.