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

Usage Notes
Responses
BOXed
indicates the display devices that are unavailable (usually because of a
hardware condition). A boxed display may also be active, free, or offline.
FREe
indicates all free display devices. A free display is one that is not currently in
use by a user or the system and is not specified as ACTIVE or OFFLINE.
OFFline
indicates all offline display devices. An offline display is one specified as neither
ACTIVE nor FREE.
1. Within a single VSM that supports network qualified names, multiple responses
can occur with the same luname when Extended is not specified and one or
more VSMs support network qualified names.
If the system is using a graphic display device that is in an intervention-required
state and you enter QUERY GRAF, you receive a response like this:
A GRAF 0BDA intervention required.
0BDA is the real device number.
Note: This response will be preceded by one of the following.
Response 1:
If you enter a QUERY GRAF, QUERY GRAF ACTIVE, or QUERY GRAF
ATTACHED command and a real graphic display is dedicated to a virtual machine,
you see something like this:
q graf attach
GRAF 0BCD ATTACHED TO OLIVER 0010
Ready;
This message means the graphic display device at the real device number 0BCD is
attached to OLIVER’s virtual machine as the virtual device 0010. ATTACHED may
be replaced with BOX/ATTC, which means that although the device is dedicated to
a user, it is unavailable (usually because of a hardware condition).
Response 2:
If you enter QUERY GRAF or QUERY GRAF ACTIVE and a graphic display device
has a user logged on or dialed through it, you see something like this:
q graf
GRAF 08E0 LOGON AS SVCDIR 0009
VTAM CONTROLS THE FOLLOWING LU’S
GRAF WGU9E316 LOGON AS DONNA 0009
GRAF TN6PV192 LOGON AS CORAK 0009
Ready;
QUERY GRAF
This response tells you the user SVCDIR is logged on through the graphic display
device at 08E0. The number 0009 is SVCDIR’s virtual console device number. The
second line of the response tells you the terminals that follow are SNA/CCS
terminals, and the VTAM user controls them. VTAM is a VTAM service machine
(VSM) recognized by z/VM CP. Any logical units controlled by this VTAM service
machine that are logged onto, or dialed into, the system are described in the
Chapter 2. CP Commands 809