FEPI INQUIRE CONNECTION
Inquire on a FEPI connection.
Description
FEPI INQUIRE CONNECTION returns information about a FEPI connection. A connection is identified by specifying its target and node.
The following commands allow you to browse all FEPI connections.
FEPI INQUIRE CONNECTION START
FEPI INQUIRE CONNECTION NEXTNODE|NEXTTARGET
NODE(8-character data-area)
TARGET(8-character data-area)
[The options are as for FEPI INQUIRE CONNECTION]
FEPI INQUIRE CONNECTION END
Conditions: INVREQ,
NOTAUTH
The next connection for which information is returned
depends on whether NEXTNODE or NEXTTARGET is specified. If NEXTNODE
is specified, the information returned is for the following:
- The next node connected to the current target
- If there are no more nodes connected to the current target, the first node connected to the next target.
- The next target connected to the current node
- If there are no more targets connected to the current node, the first target connected to the next node.
Options
- ACQNUM(fullword binary data-area)
- Returns the number of times that the connection has been acquired.
- ACQSTATUS(cvda)
- Returns the acquire state; that is, whether a session on the connection
is bound or not. The relevant CVDA values are as follows:
- ACQUIRED
- The session is bound.
- ACQUIRING
- A state of
ACQUIRED
has been requested but binding a session has not yet been completed. - RELEASED
- No session is bound.
- RELEASING
- A state of
RELEASED
has been requested but unbinding the session has not yet been completed.
- CONVNUM(fullword binary data-area)
- Returns the number of conversations that have used the connection.
- INSTLSTATUS(cvda)
- Returns the installation state of the connection. The relevant
CVDA values are as follows:
- INSTALLED
- The connection is in a pool defined by INSTALL and is available for use.
- NOTINSTALLED
- The connection is in a pool, or involves a node or target that is being discarded but is still in use.
- LASTACQCODE(fullword binary data-area)
- Returns the result of the last acquire request for the connection; that is, the sense code from the last z/OS Communications Server VTAM® REQSESS, zero indicating success. Note: CLSDST(PASS) X'32020000' can be returned in this field. This is the unbind flow received by CICS® during CLSDST(PASS) processing.
For details of z/OS Communications Server sense codes, see z/OS Communications Server: IP and SNA Codes.
- NODE(8-character data-value/8-character data-area)
- The node that identifies the connection.
- POOL(8-character data-area)
- Returns the name of the pool that defines the connection.
- SERVSTATUS(cvda)
- Returns the service state of the connection. The relevant CVDA
values are as follows:
- INSERVICE
- The connection is in service and can be used in a conversation.
- OUTSERVICE
- The connection is out of service and cannot be used for any new
conversation, but a conversation using the connection is unaffected.
The service state is
GOINGOUT
until any such conversation ends. - GOINGOUT
- A state of
OUTSERVICE
has been requested but the connection is still being used by some conversation.
- STATE(cvda)
- Returns the state of the conversation using the connection. The
relevant CVDA values are as follows:
- NOCONV
- No conversation is active on the connection.
- PENDSTSN
- An STSN-handling task has been scheduled.
- STSN
- An STSN-handling task owns the conversation.
- PENDBEGIN
- A begin-session handling task has been scheduled.
- BEGINSESSION
- A begin-session handling task owns the conversation.
- APPLICATION
- A normal application task owns the conversation.
- PENDDATA
- FEPI is waiting for inbound data, following a FEPI START command.
- PENDSTART
- Inbound data having arrived, a task specified by FEPI START has been scheduled.
- PENDFREE
- An end-session handling task has been scheduled, following a FEPI FREE command.
- FREE
- An end-session handling task owns the conversation, following a FEPI FREE command.
- PENDRELEASE
- An end-session handling task has been scheduled, following an unbind request.
- RELEASE
- An end-session handling task owns the conversation, following an unbind request.
- PENDUNSOL
- An unsolicited-data handling task has been scheduled.
- UNSOLDATA
- An unsolicited-data handling task owns the conversation.
- PENDPASS
- The conversation is unowned, following a FEPI FREE PASS command.
- TARGET(8-character data-value/8-character data-area)
- The target that identifies the connection.
- USERDATA(64-character data-area)
- Returns the user data for the connection. If no user data has been set, nulls are returned.
- WAITCONVNUM(fullword binary data-area)
- Returns the number of conversations that are waiting to start using the connection. If a conversation could use any one of several connections, it is counted as waiting on each one.
Conditions
- ILLOGIC
- RESP2 values:
- 1
- For START: browse of this resource type is already in progress. For NEXT or INQUIRE: END was not issued.
- END
- RESP2 values:
- 2
- For NEXT: all resource definitions have been retrieved.
- INVREQ
- RESP2 values:
- 116
- TARGET name unknown.
- 117
- NODE name unknown.
- 118
- Connection unknown (TARGET and NODE names known, but not in a common pool).