FEPI ADD POOL

Function

FEPI ADD POOL adds targets or nodes, or both, to an existing pool, thereby creating new connections in the pool. The targets or nodes must not be in the pool already. You can specify initial service and acquire states for these new connections. The command completes when the resources have been added to the pool but without waiting for the requested states to be achieved.

Syntax

Read syntax diagramSkip visual syntax diagramFEPI ADD POOL
 
                               .-ACQUIRED--------.
>>-FEPI ADD--POOL(data-value)--+-----------------+-------------->
                               +-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, be ‘bound’).
RELEASED
The connections are not to have sessions established (that is, be left ‘unbound’).
NODELIST(data-area)
specifies a contiguous array of 8-character node names to be added to the pool. They must already be defined by FEPI INSTALL NODELIST, but can have any service state.
NODENUM(fullword binary data-value)
specifies the number of names in the NODELIST, in the range 0-256.
POOL(8-character data-value)
specifies the name of the pool to which the targets or nodes, or both, are being added.
SERVSTATUS(cvda)
specifies the initial service state of the connections being created. All the new connections have the same state. The relevant CVDA values are:
INSERVICE
The connections are to be in service, and so can be used in a conversation.
OUTSERVICE
The connections are to be out of service and cannot be used for any conversation.
TARGETLIST(data-area)
specifies a contiguous array of 8-character target names to be added to the pool. They must already be defined by FEPI INSTALL TARGETLIST, but can be in any service state.
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 115 POOL name unknown.
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 is out of range.
INVREQ 131 NODENUM value is out of range.
INVREQ 173 NODE name already exists in the specified pool.
INVREQ 174 TARGET name already exists in the specified pool.
INVREQ 175 Connection already exists.
[[ Contents Previous Page | Next Page Index ]]