FEPI INSTALL POOL
Define a new pool of connections.
Description
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.
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,
the remain
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
- INVREQ
- RESP2 values:
- 11
- FEPI not installed or not active.
- 110
- SERVSTATUS value not valid.
- 111
- ACQSTATUS value not valid.
- 116
- TARGET name unknown.
- 117
- NODE name unknown.
- 119
- The command failed for one or more items in the list.
- 130
- TARGETNUM value out of range.
- 131
- NODENUM value out of range.
- 162
- POOL name not valid.
- 171
- PROPERTYSET name unknown.
- 172
- POOL name already exists.
- 175
- The connection already exists.