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

Messages
If you enter a QUERY SWCH, QUERY SWCH ACTIVE, or QUERY SWCH ATTACH
command, and there is a dynamic switching device dedicated to a user, you see
something like this:
q switches
SWCH 0CD5 ATTACHED TO EMILY 0012
Ready;
This means that the switching device at the real device number 0CD5 is attached to
EMILY’s virtual machine as the virtual device number 0012. ATTACHED may be
replaced by BOX/ATTC, which indicates that the dedicated switching device is not
available, usually because of a hardware condition.
Response 2:
If you enter a QUERY SWCH FREE command, and there is a free switching device
attached to the system, you see something like this:
q swch free
SWCH 0387 FREE , SWCH 03A1 FREE , SWCH 03A2 FREE , SWCH 03A3 FREE
SWCH 03A4 FREE , SWCH 03A5 FREE , SWCH 03A9 FREE , SWCH 03AA FREE
Ready;
This response shows the real device number for each free switching device.
If you enter a QUERY SWCH OFFLINE or QUERY SWCH BOXED command, the
response is in the same format as the response for QUERY SWCH FREE.
Response 3:
If you enter a QUERY SWCH ALL command, CP displays what it would display if
you had entered QUERY SWCH ACTIVE, QUERY SWCH FREE, and QUERY
SWCH OFFLINE commands.
Response 4:
HCP003E Invalid option - option
If CP cannot find a switching device of the type you specified, you see a message
in this format:
q switches boxed
A BOXED SWCH was not found.
Ready;
HCP020E Userid missing or invalid
In this response, BOXED may be replaced with active, attached, free, or offline,
depending on what you specified on the command.
HCP263E Too many operands were supplied for
this command.
QUERY SWITCHES
Chapter 2. CP Commands 1015