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

QUERY VIRTUAL OSA
►►
Query
Authorization
Purpose
Virtual
Responses
OSA
Privilege Class: G
Use QUERY VIRTUAL OSA to display status of the Open Systems Adapter (OSA)
devices accessible to your virtual machine.
For each OSA device dedicated to your virtual machine configuration, the following
is displayed:
OSA vdev {ON DEV rdev } [SUBCHANNEL = vsub] [(OSA AGENT)]
{ON NIC vdev AS UNIT unit}
For each OSA device that uses the Queued Direct I/O (QDIO) hardware, the
following is displayed:
vdev {QDIO-ELIGIBLE }
{QDIO PENDING ACTIVE}
{QDIO ACTIVE }
{QIOASSIST status }
If the subchannel for the OSA device is in either QDIO PENDING ACTIVE or QDIO
ACTIVE state, the following line is displayed for each input and output data queue
that was established by a program running in a V=V virtual machine only:
vdev type sync priority IOCNT = nnnnnnnn ADP = nnn PROG = nnn UNAVAIL = nnn
vdev BYTES = nnnnnnnnnnnnnnnn
The terms shown in the above Results have the following meanings:
vdev
is the virtual device number of the OSA device.
rdev
is the real device number of the OSA device.
SUBCHANNEL = vsub
identifies the virtual subchannel number.
OSA AGENT
indicates that the device is an OSA Agent.
QUERY VIRTUAL OSA
QDIO-ELIGIBLE
indicates that the device is eligible to use the QDIO Hardware Facility for direct
data transfer.
QDIO PENDING ACTIVE
indicates that a program running in the virtual machine has established QDIO
data queues for transferring data between the program and the specified OSA
device. Although the data queues are created, they must be activated by the
program running in the virtual machine before data transfer can commence.
►◄
Chapter 2. CP Commands 1113