FEPI INSTALL POOL

Function

FEPI INSTALL POOL defines a new pool of connections to FEPI. Any targets and nodes specified in the command are added to it, thereby creating new connections in the pool. You may specify an initial service state for the pool, and initial service and acquire states for any new connections. A pool cannot be used for a conversation until it has been put in service. The command completes when the pool has been created and any resources added; it does not wait for the requested states to be achieved.

Syntax

Read syntax diagramSkip visual syntax diagramFEPI INSTALL POOL
 
>>-FEPI INSTALL--POOL(data-value)--PROPERTYSET(data-value)------>
 
   .-ACQUIRED--------.
>--+-----------------+------------------------------------------>
   +-ACQSTATUS(cvda)-+
   '-RELEASED--------'
 
>--+------------------------------------------+----------------->
   '-NODELIST(data-area)--NODENUM(data-value)-'
 
   .-INSERVICE--------.
>--+------------------+----------------------------------------->
   +-SERVSTATUS(cvda)-+
   '-OUTSERVICE-------'
 
>--+----------------------------------------------+------------><
   '-TARGETLIST(data-area)--TARGETNUM(data-value)-'
 

Options

ACQSTATUS(cvda)
specifies the initial acquire state of the connections being created. All the new connections have the same state. The relevant CVDA values are:
ACQUIRED
The connections are to have sessions established (that is, ‘bound’).
RELEASED
The connections are not to have sessions established (that is, left ‘unbound’).
NODELIST(data-area)
specifies a contiguous array of 8-character node names. They must already be defined by FEPI INSTALL NODELIST.
NODENUM(fullword binary data-value)
specifies the number of names in NODELIST, in the range 0-256.
POOL(8-character data-value)
specifies the name of the pool to be defined. The name must not contain null characters (X'00'), leading blanks, or embedded blanks.
PROPERTYSET(8-character data-value)
specifies the name of the set of properties for the pool, which must have been installed already.
SERVSTATUS(cvda)
specifies the initial service state of the pool being defined and of the connections being created. All the new connections have the same state. The relevant CVDA values are:
INSERVICE
The pool and any connections are in service and can be used in a conversation.
OUTSERVICE
The pool and any connections are out of service and cannot be used for any conversation.
TARGETLIST(data-area)
specifies a contiguous array of 8-character target names. They must already be defined by FEPI INSTALL TARGETLIST.
TARGETNUM(fullword binary data-value)
specifies the number of names in TARGETLIST, in the range 0-256.

Conditions

Condition RESP2 Meaning
INVREQ 110 SERVSTATUS value not valid.
INVREQ 111 ACQSTATUS value not valid.
INVREQ 116 TARGET name unknown.
INVREQ 117 NODE name unknown.
INVREQ 119 The command failed for one or more items in the list.
INVREQ 130 TARGETNUM value out of range.
INVREQ 131 NODENUM value out of range.
INVREQ 162 POOL name not valid.
INVREQ 171 PROPERTYSET name unknown.
INVREQ 172 POOL name already exists.
INVREQ 175 The connection already exists.
[[ Contents Previous Page | Next Page Index ]]