FEPI INQUIRE POOL

Inquire on a FEPI pool.

FEPI INQUIRE POOL

Notes:

Description

FEPI INQUIRE POOL returns information about a FEPI pool of connections.

The following commands allow you to browse all FEPI POOL definitions.

FEPI INQUIRE POOL START
FEPI INQUIRE POOL(8-character data-area) NEXT
[The options are as for FEPI INQUIRE POOL]
FEPI INQUIRE POOL END

Options

BEGINSESSION(4-character data-area)

returns the name of the transaction performing begin-session processing, or blanks if no transaction was specified.

CONTENTION(cvda)

returns a value that specifies what happens when a FEPI SEND command is issued and there is inbound data with ‘begin bracket’. The relevant CVDA values are:

LOSE: FEPI SEND command fails; a FEPI RECEIVE must be issued to get the inbound data.
WIN: FEPI SEND command succeeds; inbound data is rejected with a negative response.

DEVICE(cvda)

returns a value that identifies the mode of conversation and the type of device. Defined values are:

T3278M2: SLU2 mode, 3278 Model 2
T3278M3: SLU2 mode, 3278 Model 3
T3278M4: SLU2 mode, 3278 Model 4
T3278M5: SLU2 mode, 3278 Model 5
T3279M2: SLU2 mode, 3279 Model 2B
T3279M3: SLU2 mode, 3279 Model 3B
T3279M4: SLU2 mode, 3279 Model 4B
T3279M5: SLU2 mode, 3279 Model 5B
TPS55M2: SLU2 mode, PS/55, 24 lines
TPS55M3: SLU2 mode, PS/55, 32 lines
TPS55M4: SLU2 mode, PS/55, 43 lines
LUP: SLU P mode, all cases.

ENDSESSION(4-character data-area)

returns the name of the transaction performing end-session processing, or blanks if no transaction was specified.

EXCEPTIONQ(4-character data-area)

returns the name of the TD queue to which exceptional events are notified, or blanks if no queue was specified.

FJOURNALNAME(8-character data-area)

returns the 1- to 8-character name of the journal where data is to be logged.

FJOURNALNUM(fullword binary data-area)

returns the number of the journal where data is to be logged.

FORMAT(cvda)

returns a value that identifies the data format. The relevant CVDA values are:

FORMATTED: Formatted operation
DATASTREAM: Data stream operation
NOTAPPLIC: Option is not applicable for the specified pool.

INITIALDATA(cvda)

returns a value indicating whether initial inbound data is expected when a session is started. The relevant CVDA values are:

NOTINBOUND: No inbound data expected
INBOUND: Inbound data expected.

INSTLSTATUS(cvda)

returns the installation state of the pool. The relevant CVDA values are:

INSTALLED: The pool has been defined by INSTALL and is available for use.
NOTINSTALLED: The pool is being discarded, but is still in use.

MAXFLENGTH(fullword binary data-area)

returns the maximum length of data that can be returned on any FEPI RECEIVE, CONVERSE, or EXTRACT FIELD command for a conversation, or that can be sent by any FEPI SEND or CONVERSE command for a conversation.

MSGJRNL(cvda)

returns a value indicating whether journaling is performed for inbound and outbound data. The relevant CVDA values are:

NOMSGJRNL: No journaling is to be performed.
INPUT: Inbound data is journaled.
OUTPUT: Outbound data is journaled.
INOUT: Inbound and outbound data are journaled.

POOL(8-character data-value/8-character data-area)

is the name of the pool.

PROPERTYSET(8-character data-area)

returns the name of the set of properties with which the pool was installed.

SERVSTATUS(cvda)

returns the service state of the pool. The relevant CVDA values are:

INSERVICE: The pool is in service and can be used in a conversation.
OUTSERVICE: The pool is out of service and cannot be used for any conversation.
GOINGOUT: A state of OUTSERVICE has been requested but the pool is still being used by some conversation.

STSN(4-character data-area)

returns the name of the transaction handling STSN data, or blanks if no transaction was specified.

UNSOLDATA(4-character data-area)

returns the name of the transaction handling unsolicited data (data received outside a conversation), or blanks if no transaction was specified.

UNSOLDATACK(cvda)

if there is no unsolicited data processing, this indicates what acknowledgment FEPI gives to a BID. The relevant CVDA values are:

NEGATIVE: Negative response X'0813', BID not accepted
POSITIVE: Positive response, BID accepted and subsequent data is accepted and discarded
NOTAPPLIC: Option is not applicable for the specified pool.

USERDATA(64-character data-area)

returns the user data for the pool. 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 a connection in the pool.

Conditions

ILLOGIC

RESP2 value:

1: For START: browse of this resource type is already in progress. For NEXT or END: START was not issued.

END

RESP2 value:

2: For NEXT: all resource definitions have been retrieved.

INVREQ

RESP2 value:

115: POOL name unknown.