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

CPHX
Messages
Response 2:
If your user ID has class A privileges, you can use the CPHX command to cancel
any of the previously mentioned CP commands issued by other virtual machines.
For example, someone may have requested that a service machine attach a set of
real devices:
sm rscs cp attach 0100-01ff to *
Ready;
An ATTACH command may take a long time because of hardware problems on a
controller. If you notice that an ATTACH command is taking an unusually long time,
you can choose to cancel the remainder of the ATTACH command. If you do, you
see something like this:
cphx rscs
Your request to halt RSCS’s ATTACH command has been initiated.
Ready;
HCPHXC6792I User RSCS’s ATTACH command halted.
The message that informs you of the successful cancelation of the ATTACH
command arrives some time after the CPHX command execution completes. The
ATTACH command processing only recognizes the CPHX request when it begins to
attach a new device.
The RSCS virtual machine’s console would reflect the following activity as a result
of the CPHX command execution:
09:01:52
.
Location YORKTOWN(MAINT) executing: CP ATTACH 0100-01FF TO *
.
HCPHXC6793I User MAINT has halted your ATTACH command.
HCPATR6790I ATTACH processing halted. The next device
that would have been processed is 0108.
The example above assumes that you are user ID MAINT. The last message
indicates the ATTACH processing had completed processing devices 0100 to 0107
and was canceled before it tried to attach device 0108.
CP notifies the operator ID of the cancelation by issuing a message like this one to
the operator’s console:
HCPHXC6791I User MAINT has halted the ATTACH command processed
by user RSCS.
HCP003E Invalid option - command contains
extra option(s) starting with operand
HCP020E Userid missing or invalid
HCP045E userid not logged on
HCP644E Unknown/unauthorized CP command:
command
HCP6790I The variations of this message are as
follows:
86 z/VM: CP Commands and Utilities Reference
v {ATTACH|VARY} processing halted.
The next device that would have been
processed is rdev.
v {LOCATE|LOCATEVM} processing
halted. The next location that would
have been processed is address.
HCP6791I User userid has halted the command
command executed by user userid.
HCP6792I User userid’s command command
halted.