CPHX

Read syntax diagramSkip visual syntax diagram CPHX 1userid*
Notes:
  • 1 If CPHX is executed with the AT command, the userid operand is required.

Authorization

Privilege Class: A

Purpose

Use CPHX to stop the execution of the following CP commands:
  • ATTACH commands for devices
  • DELETE EDEVICE command for devices
  • FLASHCOPY commands for devices
  • LOCATE commands searching storage
  • LOCATEVM commands
  • VARY ONLINE and VARY OFFLINE commands for devices
  • VMDUMP command and DIAG94
  • VMRELOCATE command with the SYNCHRONOUS option.

Operands

userid
*
is the user ID of the virtual machine whose command is to be canceled. An asterisk (*) tells CP to use the issuer's user ID. You must have class A privilege to specify a user ID other than your own.

Usage Notes

  1. To cancel a command running in your own virtual machine, you must prefix the CPHX command with the string #CP followed by 1 blank, for example, #CP CPHX. The pound sign (#) represents the logical-line-end symbol in effect for your virtual machine. If you have redefined the logical-line-end symbol, you must substitute your symbol for the pound sign (#).
  2. The ATTACH, DELETE EDEVICE, and VARY command processors check to see if a CPHX command has been issued before they process another device number specified on the ATTACH, DELETE EDEVICE, or VARY command.
  3. The LOCATE and LOCATEVM command processors check to see if a CPHX command has been issued before they search another page of storage for data specified on the LOCATE or LOCATEVM commands.
  4. The FLASHCOPY command processors check to see if a CPHX command has been issued before issuing additional I/O for device numbers that were specified on the FLASHCOPY command.
  5. For the VMRELOCATE command with the SYNCHronous option, CPHX does the same thing as the VMRELOCATE CANCEL operand. This is only applicable when the SYNCHRONOUS option was used to start the command. As with CANCEL, CPHX can only be used to stop the command up until the time that the request is sent from the source system to start the virtual machine on the destination system.

Responses

Response 1:

If you use CPHX to stop a LOCATEVM command that is taking too long, you see something like this: 
locatevm 0-end count all data C179022DF
The data is located at 00001270.
#cp cphx
HCPLMN6790I LOCATEVM processing halted.  The next location
that would have been processed is 0001CF00.
Ready;
If you have a large virtual machine, the LOCATEVM command in the above example could take quite a long time.

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 cancellation by issuing a message like this one to the operator's console: 
HCPHXC6791I User MAINT has halted the ATTACH command processed
by user RSCS.

Messages

  • 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 {ATTACH|DELETE EDEVICE|FLASHCOPY|VARY} processing halted. The next device that would have been processed is {rdev|vdev|edev}.
  • HCP6790I {LOCATE|LOCATEVM} processing halted. The next location that would have been processed is address.
  • HCP6790I {VMDUMP|DIAG94} processing halted.
  • HCP6791I User userid has halted the command command executed by user userid.
  • HCP6792I User userid's command command halted.
  • HCP6793I User userid has halted your command command.
  • HCP6898E User userid is not executing a command that can be halted.
  • HCP6899E A halt request for user userid has already been made by user userid.