AGW QUERY

Purpose

Use the AGW QUERY command to display information about various settings and conditions of AVS.

Operands

GATEWAY

displays the status of the gateways.

ALL

displays information for all gateways at this AVS virtual machine; ALL is the default.

gateway

displays information for the specified gateway.

CNOS

displays the status of session limits and contention polarity.

ALL

displays information about all remote LUs being accessed through all gateways; ALL is the default.

remotelu

is the name of a specific remote LU.

AT gateway

is a specific gateway through which the remotelu is accessed.

AT ALL

displays information about all gateways through which the remotelu is accessed; AT ALL is the default.

ALL AT gateway

displays information about all remote LUs being accessed through the specified gateway.

CONV

displays the status of conversations in the gateways.

ALL

displays information about all active conversations; ALL is the default. Because this operand can generate a lot of output, you may want to issue the AGW QUERY CNOS first to determine how many conversations are active.

GATEWAY gateway

displays information about the active conversations through the specified gateway.

REMOTELU remotelu

displays information about the active conversations to the specified remote LU.

USERID userid

displays information about active conversations with the specified user ID or specified access user ID.

ETRACE

displays the current setting of external tracing.

ITRACE

displays the current setting of internal tracing.

ALL

displays all of the current information about the gateways, CNOS settings, conversations, trace settings, and user ID mappings.

USERID

displays mapping information about local user IDs.

ALL

displays information about all remotelu, remuser, and locuser mappings; ALL is the default.

locuser

displays mapping information about this local user ID.

remotelu remuser

displays the mapping for this remotelu-remuser pair.

remotelu *

displays all the mapping information that about this remote LU.

What Happens When You Enter this Command

AGW QUERY command responses vary depending on the operands you specify.

AGW QUERY GATEWAY: If you enter AGW QUERY GATEWAY, AVS displays the status of all gateways. You can get the following response for each gateway:

GATEWAY = gateway  type      status                  CONV COUNT = n
                  [ USERID = userid ]
                  [ MANAGER = cmrname ]

gateway

Gateway LU name

type

PRIVATE or GLOBAL

status

ACTIVE, ACTIVATE IN PROGRESS, or DEACTIVATE IN PROGRESS

n

Decimal number of active conversations through the specified gateway.

For private gateways, AGW QUERY also displays the USERID or MANAGER settings. If the USERID setting is displayed, the value of userid is the user ID defined in this gateway's AGW ACTIVATE GATEWAY command. If the MANAGER setting is displayed, the cmrname value identifies the Conversation Manager Routine (CMR) that is defined in this gateway's AGW ACTIVATE GATEWAY command.

AGW QUERY CNOS: If you enter AGW QUERY CNOS, AVS displays the status of the session limits and contention polarity. You can get the following response for each CNOS command entered:

GATEWAY = gateway   REMOTELU = remotelu   MODE = modename
                             status             CONV COUNT = n
CURRENT VALUES:       seslimit    conwin   conlose   [ DRAIN = setting ]
CNOS COMMAND VALUES:  seslimit    conwin   conlose   [ DRAIN = setting ]

gateway

Gateway LU name

remotelu

The remote LU name

modename

Mode name for this conversation

status

ACTIVE, QUIESCED, or CNOS IN PROGRESS

n

Decimal number of active conversations using the specified gateway.

seslimit

Maximum number of sessions allowed

conwin

Contention winner values

conlose

Contention loser values

setting

YES or NO; If the DRAIN setting is not displayed, the CNOS command was issued at the remote LU.

AGW QUERY CONV: If you enter AGW QUERY CONV, AVS displays the status of conversations in a gateway. You receive the following information for each conversation:

GATEWAY = gateway, REMOTELU = remotelu, RESOURCE = tpn
USERID   = userid, ACCESS USERID = accuser, CONVERSATION = convid
              VTAM STATE = n, VM STATE = n

gateway

Gateway LU name

remotelu

The remote LU name

tpn

Name of the transaction program (the communications partner)

userid

The user ID from the allocate or connect request; this value is not present for inbound conversations.

accuser

The access user ID specified on the allocate or connect request.

convid

The VTAM® conversation ID (specified in hexadecimal).

n

One of the following hexadecimal numbers, which indicate the status of the VTAM or VM side of the path:

Value

Meaning

X'01'

No state

X'02'

Connection pending

X'03'

Connection in progress

X'04'

Send state

X'05'

Receive state

X'06'

Confirm state

X'07'

Sever state

X'08'

Allocate pending

X'09'

Confirm send state

X'0A'

Confirm deallocation state

X'0B'

Queued allocate state

X'0C'

Reserved

X'0D'

Prepare received

X'0E'

Solicited request for communications received

X'0F'

Unsolicited request for communications received

X'10'

Committed received

X'11'

Backout received

X'12'

Backout required

X'13'

Sever abend required

X'14'

CRR recovery server queued allocate

If you enter the AGW QUIESCE command and it has not completed, enter AGW QUERY CONV command to determine which conversations are still active. You can then enter AGW DEACTIVE CONV (see Purpose) to deactivate any remaining active conversations.

AGW QUERY ETRACE: If you enter AGW QUERY ETRACE, AVS displays the external trace option setting in one of the following responses:

ETRACE ON
ETRACE OFF

AGW QUERY ITRACE: If you enter AGW QUERY ITRACE, AVS displays one of the following responses to indicate the internal trace option setting:

ITRACE OFF
ITRACE ON ALL
ITRACE ON GATEWAY:  gateway

AGW QUERY USERID: If you enter AGW QUERY USERID, AVS displays the contents of the AVS user ID table that contains the remote LU-remote user ID mappings. When the user ID is known, the remote LU, remote user ID and local user ID mappings are displayed in the following format:

REMOTELU = remotelu REMOTE USERID = remuser
LOCAL USERID = locuser

remotelu

The remote LU name

remuser

The remote user ID

locuser

The local user ID

ALL ALREADY VERIFIED USERIDS FROM REMOTE LU remotelu ARE ACCEPTED