QUERY OSA

Authorization

Privilege Class: B

Purpose

Use QUERY OSA to display the status of real Open Systems Adapter devices.

Operands

ACTive

indicates active Open Systems Adapter devices. An active device is one that is in use by a user or the system and is specified as neither FREE nor OFFLINE nor SYSTEM.

ALL

indicates all Open Systems Adapter devices attached to the system. The status is displayed in the order of ACTIVE, SYSTEM, FREE, OFFLINE, and AGENT. You receive the same response as you would receive if you entered all of the following commands:

query osa active
query osa system
query osa free
query osa offline
query osa agent

ATTach userid

indicates the OSA devices that are dedicated to a user on the system. If you specify userid, only OSA devices attached to that user's virtual machine are indicated. If you do not specify userid, you receive the status of all OSA devices dedicated to any user on the system. Attached devices are always active.

BOXed

indicates the OSA devices that are unavailable (usually because of a hardware condition). A boxed device can also be active, free, or offline.

FREe

indicates all free OSA devices. A free OSA device is one that is not currently in use by a user or the system and is specified as neither ACTIVE nor OFFLINE.

OFFline

indicates all offline OSA devices. An offline OSA device is one that is specified as neither ACTIVE nor FREE.

AGEnt

indicates all Open Systems Adapter Agent devices. OSA Agent devices are used to control the OSA configuration.

SYStem

indicates all OSA devices reserved for system use. An OSA device that is reserved for system use is associated with an OSA adapter that is in use on a shared port group.

TYpe

indicates the type of OSA devices to be displayed. For each device, the display includes the type of device, the channel-path identifier (CHPID), and the type of channel path.

ALL: indicates that all types of OSA devices are to be displayed. This is the default value.
HIPersockets: indicates that HiperSockets devices are to be displayed. HiperSockets devices are used for communication between logical partitions and/or virtual machines, and are associated with internal-queued-direct-communication (IQD) channel paths. The displayed devices will include device types of HIPER as well as HIPER-BRDG. HIPER-BRDG indicates the EXTERNAL_BRIDGED channel parameter was configured for the channel path.
OSA: indicates that OSA devices are to be displayed. OSA devices are used for communication through a network, and are associated with Open Systems Adapter (OSA) channel paths, OSA-Express (OSE) channel paths, or OSA Direct Express (OSD) channel paths.

OSH: indicates that OSH devices are to be displayed. OSH devices are used for communication through a network using the enhanced QDIO (EQDIO) protocol and are associated with Open Systems Adapter Hybrid (OSH) channel paths.
OSN: indicates that OSN devices are to be displayed. OSA NCP (OSN) devices are used by the Communication Controller for Linux (CCL) when running the Network Control Program (NCP) in a logical partition or virtual machine. OSN devices are associated with OSN channel paths and communicate with one or more emulated 3745 device types on the same OSN channel path.

Usage Notes

A VIRTUAL version of this command, QUERY VIRTUAL OSA, also exists to facilitate a per-userid version of this data request. In some cases the VIRTUAL keyword is optional, so the output of this command may supersede QUERY VIRTUAL output. For more information, see QUERY VIRTUAL OSA.

Responses

If the system is using an OSA device that is in an intervention-required state and you enter QUERY OSA, you see a response like this:

OSA 0300 has intervention required.

0300 is the real device number of the OSA device that needs the operator's intervention.

Note: This response will be preceded by one of the following.

Response 1:

If you enter QUERY OSA, QUERY OSA ACTIVE, or QUERY OSA ATTACHED and there is an OSA device attached to the system, you see something like this: Start of change

q osa active
OSA 0480 ATTACHED TO PVM      0480 DEVTYPE HIPER       CHPID 80 IQD
OSA 0481 ATTACHED TO PVM      0481 DEVTYPE HIPER       CHPID 80 IQD
OSA 0482 ATTACHED TO PVM      0482 DEVTYPE HIPER       CHPID 80 IQD
OSA 0888 ATTACHED TO RSCS     0888 DEVTYPE OSA         CHPID A0 OSD
OSA 0889 ATTACHED TO RSCS     0889 DEVTYPE OSA         CHPID A0 OSD
OSA 088A ATTACHED TO RSCS     088A DEVTYPE OSA         CHPID A0 OSD
OSA 1700 ATTACHED TO VTAM     0500 DEVTYPE OSN         CHPID E0 OSN
OSA 1750 ATTACHED TO SYSTEM   1750 DEVTYPE OSH         CHPID F0 OSH TRACESIZE 8
OSA 1910 ATTACHED TO SYSTEM   1910 DEVTYPE OSH         CHPID F2 OSH 
OSA 1911 ATTACHED TO TCPIP    0100 DEVTYPE OSH         CHPID F2 OSH TRACESIZE 8
Ready;

The first number is the real device number of the OSA device. The ATTACHED operand might also read BOX/ATTC, which means that although the device is attached and dedicated to a user, it is unavailable. PVM, RSCS, TCPIP, and VTAM® are user IDs to which the OSA devices are dedicated. The next number is the virtual device number used by a virtual machine to refer to the specified OSA device. Following the virtual device number is the type of the device, the channel path identifier (CHPID) associated with the device, and the channel-path type. Start of change

Only Network-Express (EQDIO) devices display the TRACESIZE setting, which indicates the size (pages) that are allocated for an internal trace table that tracks EQDIO trace events. End of change

Response 2:

If you enter a QUERY OSA FREE command and there is a free OSA device attached to the system, you see something like this:

q osa free
OSA 0487 FREE    , OSA 04A1 FREE    , OSA 04A2 FREE    , OSA 04A3 FREE
OSA 04A4 FREE    , OSA 04A5 FREE    , OSA 04A9 FREE    , OSA 04AA FREE
OSA 04AB FREE    , OSA 04BC FREE    , OSA 04BD FREE    , OSA 04BE FREE
OSA 04BF FREE
Ready;

This response shows the real device number for each free OSA device.

The response for a QUERY OSA OFFLINE or QUERY OSA BOXED command is in the same format as the response for a QUERY OSA FREE command.

Response 3:

When you enter a QUERY OSA AGENT command and there is an OSA AGENT attached to the system, you see something like this:

q osa agent
OSA 0280 is an OSA Agent

Response 4:

When you enter a QUERY OSA ALL command, CP displays the same responses as it would display if you had entered the QUERY OSA ACTIVE, QUERY OSA SYSTEM, QUERY OSA FREE, QUERY OSA OFFLINE, and QUERY OSA AGENT commands.

Response 5:

If you enter QUERY OSA TYPE ALL, you will see something like this:

q osa type all
OSA 0480 ATTACHED TO TCPIP    0100 DEVTYPE HIPER       CHPID 80 IQD
OSA 0481 BOX/ATTC TO TCPIP    0101 DEVTYPE HIPER       CHPID 80 IQD
OSA 0482 ATTACHED TO TCPIP    0102 DEVTYPE HIPER       CHPID 80 IQD
OSA 7240 SYSTEM
OSA 7241 SYSTEM
OSA 7242 SYSTEM
OSA 0484 FREE                      DEVTYPE OSA         CHPID C0 OSE
OSA 0485 FREE                      DEVTYPE OSA         CHPID C0 OSE
OSA 0486 FREE                      DEVTYPE OSA         CHPID D0 OSA
OSA 0487 FREE                      DEVTYPE OSA         CHPID D0 OSA
OSA 04A1 OFFLINE                   DEVTYPE OSA         CHPID D1 OSD
OSA 04A2 OFFLINE                   DEVTYPE OSA         CHPID D1 OSD
OSA 04A3 OFFLINE                   DEVTYPE OSA         CHPID D1 OSD
OSA 04A4 OFFLINE                   DEVTYPE OSA         CHPID D1 OSD
OSA 04A5 OFFLINE                   DEVTYPE OSA         CHPID D1 OSD
OSA 04A9 OFFLINE                   DEVTYPE OSA         CHPID D1 OSD
OSA 04AA OFFLINE                   DEVTYPE OSA         CHPID D1 OSD
OSA 04AB BOXED                     DEVTYPE OSA         CHPID D1 OSD
OSA 04BC FREE                      DEVTYPE OSA         CHPID D1 OSD
OSA 04BD FREE                      DEVTYPE OSA         CHPID D1 OSD
OSA 048E FREE                      DEVTYPE OSA         CHPID D1 OSD
OSA 04BF FREE                      DEVTYPE OSA         CHPID D1 OSD
OSA 0700 FREE                      DEVTYPE OSN         CHPID E0 OSN
OSA 0701 FREE                      DEVTYPE OSN         CHPID E0 OSN
OSA 1750 ATTACHED TO SYSTEM   1750 DEVTYPE OSH         CHPID F0 OSH TRACESIZE 8
OSA 1818 OFFLINE                   DEVTYPE INMN        CHPID F1 OSM
OSA 1819 OFFLINE                   DEVTYPE INMN        CHPID F1 OSM
OSA 181A OFFLINE                   DEVTYPE INMN        CHPID F1 OSM
OSA 1910 ATTACHED TO SYSTEM   1910 DEVTYPE OSH         CHPID F2 OSH
OSA 1911 ATTACHED TO TCPIP    0100 DEVTYPE OSH         CHPID F2 OSH TRACESIZE 8
OSA 3F00 OFFLINE                   DEVTYPE IEDN        CHPID F6 OSX
OSA 3F01 OFFLINE                   DEVTYPE IEDN        CHPID F6 OSX
OSA 3F02 OFFLINE                   DEVTYPE IEDN        CHPID F6 OSX
Ready;

This response shows the real device number of the OSA device with its current status, followed by the device type, the associated channel-path identifier, and the channel-path type. The following device status may be returned:

ATTACHED TO userID vdev     Attached and dedicated to the specified
                            userID as virtual device vdev

BOX/ATTC TO userID vdev     Attached and dedicated to the specified
                            userID as virtual device vdev, but is not
                            available

BOXED                       Device is not available

OFFLINE                     Device is OFFLINE

FREE                        Device is ONLINE and available to use

SYSTEM                      Device is reserved for system use

Response 6:

If you enter QUERY OSA TYPE HIP, you will see something like this:

q osa type hip
OSA 0480 ATTACHED TO PVM       0480 DEVTYPE HIPER       CHPID 80 IQD
OSA 0481 ATTACHED TO PVM       0481 DEVTYPE HIPER       CHPID 80 IQD
OSA FD00 ATTACHED TO DTCVSW1   FD00 DEVTYPE HIPER-BRDG  CHPID FD IQD
OSA FD01 ATTACHED TO DTCVSW1   FD01 DEVTYPE HIPER-BRDG  CHPID FD IQD
OSA FD02 ATTACHED TO DTCVSW1   FD02 DEVTYPE HIPER-BRDG  CHPID FD IQD
Ready;

This response shows the real device number of each HiperSockets device with its status, followed by the device type, the associated channel-path identifier, and the channel-path type. A device type of HIPER-BRDG indicates the EXTERNAL_BRIDGED channel parameter was configured for the channel path.

Start of change Response 7: End of change

If you enter QUERY OSA TYPE OSH, you will see something like this:

q osa type osh
OSA 4136 ATTACHED TO STEVO     4136 DEVTYPE OSH         CHPID 16 OSH
OSA 4137 ATTACHED TO STEVO     4137 DEVTYPE OSH         CHPID 16 OSH
OSA AF00 ATTACHED TO JSLO      AF00 DEVTYPE OSH-LINKAG  CHPID AF OSH
OSA AF01 ATTACHED TO JSLO      AF01 DEVTYPE OSH-LINKAG  CHPID AF OSH
OSA AF02 ATTACHED TO JSLO      AF02 DEVTYPE OSH-LINKAG  CHPID AF OSH
Ready;

Start of change This response shows the real device number of each OSH device with its status, followed by the device type, the associated channel-path identifier, and the channel-path type. A device type of OSH-LINKAG indicates that the OSH CHPID was defined to use link aggregation. End of change

Start of change Response 8: End of change

If you specify the type parameter and CP cannot find an OSA device of the type you specify, you see a message like this:

q osa type osn
An OSA was not found for the specified type.
Ready;

Start of change Response 9: End of change

If CP cannot find an OSA device for the query you specify, you see a message like this:

q osa boxed
A BOXED OSA was not found.
Ready;

In this response, BOXED may be replaced with active, attached, offline, system, or free, depending on what you specified on the command. The BOXED OSA would be replaced by

OSA
AGENT

in this response if agent was specified on the command.

Messages

HCP003E Invalid option - option
HCP006E Invalid device type - rdev
HCP007E Invalid userid - userid
HCP263E Too many operands were supplied for this command.