STOP

Read syntax diagramSkip visual syntax diagram STOP CPUcpuaddrcpuaddrcpuaddr1-cpuaddr2ALL

Authorization

Privilege Class: G

Purpose

Use STOP to do the following:
  • Soft-stop your virtual processors
  • Hard-stop selected virtual processors.

Operands

CPU cpuaddr
CPU cpuaddr1-cpuaddr2
CPU ALL
specifies the processor or processors you want to place in hard stop. You can specify a single processor address, a list of processor addresses delimited by blanks, a nonwrapping pair of addresses separated by a hyphen (-) with no blanks, or ALL. If you omit this operand, all of your virtual processors are placed into soft stop.

Usage Notes

  1. If you enter the STOP command without operands, all of your virtual processors are placed into soft stop.
  2. This command is useful with a TRACE command to suspend execution when a certain condition is reached.
  3. Execution of the virtual processor or processors is suspended until a BEGIN, SYSTEM RESTART, ATTN, IPL, EXTERNAL, or REQUEST command is entered.
  4. The STOP command causes suspension of virtual machine execution, regardless of the SET RUN setting.

Messages

  • HCP002E Invalid operand - operand
  • HCP026E Operand missing or invalid
  • HCP1454E CPU nn does not exist.
  • HCP6026E The command command for CPU nn is invalid because the CPU is in check-stop state.