FEPI ADD POOL
Add targets or nodes to an existing pool.
Description
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.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,
remain
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
- INVREQ
- RESP2 values:
- 110
- SERVSTATUS value not valid.
- 111
- ACQSTATUS value not valid.
- 115
- POOL name unknown.
- 116
- TARGET name unknown.
- 117
- NODE name unknown.
- 119
- The command failed for one or more items in the list.
- 130
- TARGETNUM value is out of range.
- 131
- NODENUM value is out of range.
- 173
- NODE name already exists in the specified pool.
- 174
- TARGET name already exists in the specified pool.
- 175
- Connection already exists.