FEPI ALLOCATE POOL
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
FEPI 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 intended 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.
