FEPI ALLOCATE POOL

Function

FEPI ALLOCATE POOL establishes a new FEPI conversation with a target application, acquiring a session from the named pool to use for the conversation. The conversation has the properties, particularly the mode (SLU2 or SLU P) and data format (data stream or formatted), specified for the pool that is used: some of the properties can be queried using FEPI EXTRACT CONV.

The command completes immediately if, in the named POOL, a suitable session has been established and is not in use. Otherwise the request waits for a session to become available. A time limit can be set for this wait.

Syntax

Read syntax diagramSkip visual syntax diagramFEPI ALLOCATE POOL
 
>>-FEPI ALLOCATE--POOL(data-value)--CONVID(data-area)----------->
 
>--+--------------------+--+---------------------+-------------->
   '-TARGET(data-value)-'  '-TIMEOUT(data-value)-'
 
>--+---------------------+--+----------------------+------------>
   '-SEQNUMIN(data-area)-'  '-SEQNUMOUT(data-area)-'
 
>--+-------------------+---------------------------------------><
   '-SESSNSTATUS(cvda)-'
 

Options

CONVID(8-character data-area)
returns a unique identifier for the new conversation; this is the ID that must be quoted on all subsequent commands for the conversation.
POOL(8-character data-value)
specifies the name of the pool containing the target for the conversation.
SEQNUMIN(fullword binary data-area)
in SLU P mode, returns the current sequence number for inbound data. (SEQNUMIN has no significance in SLU2 mode.)
SEQNUMOUT(fullword binary data-area)
in SLU P mode, returns the current sequence number for outbound data. (SEQNUMOUT has no significance in SLU2 mode.)
SESSNSTATUS(cvda)
returns a value that indicates whether the session being used for the conversation was newly-bound or not. The relevant CVDA values are:
  • NEWSESSION
  • OLDSESSION
TARGET(8-character data-value)
specifies the name of the target. TARGET can be omitted if there is only one target in the pool or if all targets are suitable for the desired conversation.
TIMEOUT(fullword binary data-value)
specifies the maximum time in seconds that the command is to wait for a suitable session to become available. If TIMEOUT is not specified or the specified time is zero, the command is not timed out.

Conditions

If an INVREQ condition is returned, it can have the following RESP2 values:

RESP2
Meaning
30
Pool name unknown.
31
Pool name out of service.
32
Target name unknown..
33
Target name out of service..
34
Target name required but not specified.
36
No suitable session available and in service.
213
Command timed out.
241
TIMEOUT value negative or not valid.
[[ Contents Previous Page | Next Page Index ]]