CEMT INQUIRE FECONNECTION

Display information about FEPI connections.

Description

The INQUIRE FECONNECTION command displays information about the state of FEPI connections. A connection is identified by specifying the target and node. The results are given in order of target within the node. You can use family selection for TARGET and NODE, but you cannot use list selection.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:

Type CEMT INQUIRE FECONNECTION (or suitable abbreviations for the keywords). The resulting display lists the current status.
Type CEMT INQUIRE FECONNECTION (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i fec p(pool5) acq , the resulting display shows the details of all FEPI connections in the pool named pool5 on which sessions are bound.

You can tab to the highlighted fields and overtype them with new values.

CEMT INQUIRE FECONNECTION

ALl: The default. Information about all connections is given, unless you specify a selection.
NODe(nodename): The 8-character name of a node. Information is restricted to connections of which this node forms part.
Target(targetname): The 8-character name of a target. Information is restricted to connections of which this target forms part.

Sample screen

Figure 1. CEMT INQUIRE FECONNECTION screen


					CEMT IN FEC
					STATUS: RESULTS - OVERTYPE TO MODIFY
					Node(NODE1 )
					Targ(TARGETA ) Pool(POOL5 ) Inst
					Inse Rele
					Stat(NOCONV ) Wait(00000) Lacq(X'08570002')
					Node(NODE1 )
					Targ(TARGETB ) Pool(POOL5 ) Inst
					Inse Rele
					Stat(NOCONV ) Wait(00000) Lacq(X'08570002')
					Node(NODE1 )
					Targ(TARGET3 ) Pool(POOL3 ) Inst
					Inse Rele
					Stat(NOCONV ) Wait(00000) Lacq(X'08570002')

Displayed fields

Node( value )

Displays the 8-character name of a node that identifies a connection.

Target( value )

Displays the 8-character name of a target that identifies a connection.

Pool( poolname )

Displays the 8-character name of a pool of connections.

Installed|Notinstalled

Displays a value that identifies the installation state of the connection. The values are as follows:

Installed: The connection is in a pool that has been 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.

Inservice|Outservice

Displays a value that identifies the service state of the connection. The values are as follows:

Inservice: The connection is in service and can be used in a conversation. If OUTSERVICE state has been requested but has not yet completed, a GOING OUT message is shown.
Outservice: The connection is out of service and cannot be used for any conversation.

Acquired|Released

Displays a value that identifies whether a session on the connection is bound. The values are as follows:

Acquired: A session is bound on the connection. If RELEASED state has been requested but has not yet completed, a BEING RELEASED message is shown. If this message persists, you might need to use z/OS® Communications Server commands to recover the connection.
Released: Sessions involving the connection have been unbound. If ACQUIRED state has been requested but has not yet completed, a BEING ACQUIRED message is shown. If this message persists, you might need to use z/OS Communications Server commands to recover the connection.

State( value )

Displays a 12-character value that identifies the state of the conversation using the connection. The values are as follows:

APPLICATION: A normal application task owns the conversation.
BEGINSESSION: A begin-session handling task owns the conversation.
FREE: An end-session handling task owns the conversation, following a FEPI FREE command.
NOCONV: No conversation is active on the connection.
PENDBEGIN: A begin-session handling task has been scheduled.
PENDDATA: FEPI is waiting for inbound data, following a FEPI START command.
PENDFREE: An end-session handling task has been scheduled, following a FEPI FREE command.
PENDPASS: The conversation is unowned, following a FEPI FREE PASS command.
PENDRELEASE: An end-session handling task has been scheduled, following an unbind request.
PENDSTART: Inbound data having arrived, a task specified by FEPI START has been scheduled.
PENDSTSN: An STSN-handling task has been scheduled.
PENDUNSOL: An unsolicited-data handling task has been scheduled
RELEASE: An end-session handling task owns the conversation, following an unbind request.
STSN: An STSN-handling task owns the conversation.
UNSOLDATA: An unsolicited-data handling task owns the conversation.

The pending states indicate the conversation is unowned, pending the event or task indicated. If a pending state persists, it is likely that the application has failed in some way; you should consider resetting the connection by issuing a CEMT SET FECONNECTION RELEASED command.

Waitconvnum( value )

Displays a value that identifies the number of conversations that are waiting to start using a connection. If a conversation could use any one of several connections, it is counted as waiting on each one.

Lacqcode( value )

Displays a hexadecimal value that indicates the result of the last acquire request for the node; that is, the sense code from the last z/OS Communications Server REQSESS. A value of zero indicates success. For information about z/OS Communications Server sense codes, see z/OS Communications Server: SNA Messages or z/OS Communications Server: IP and SNA Codes.