FEPI SET NODE
Control the use of FEPI nodes.
FEPI SET NODE >>-FEPI SET-----------------------------------------------------> >--+-NODE--(--data-value--)-------------------------------+-----> '-NODELIST--(--data-area--)--NODENUM--(--data-value--)-' >--+-----------------------+--+------------------------+--------> +-ACQSTATUS--(--cvda--)-+ +-SERVSTATUS--(--cvda--)-+ +-ACQUIRED--------------+ +-INSERVICE--------------+ '-RELEASED--------------' '-OUTSERVICE-------------' >--+----------------------------+------------------------------>< '-USERDATA--(--data-value--)-'
Description
FEPI SET NODE controls the use of FEPI nodes. Lists may be used to set more than one node at a time; all nodes in the list are set to the same state. The function completes immediately, although the requested settings may not be achieved until later.
Options
- ACQSTATUS(cvda)
- specifies
the acquire state of the node; that is, whether its z/OS® Communications Server ACB should be opened
or closed. The relevant CVDA values are:
- ACQUIRED
- The z/OS Communications Server ACB for the node is to be opened and ‘set logon start' is to be done. The state is ACQUIRING until this is completed.
- RELEASED
- The z/OS Communications Server ACB for the node is to be closed when usage of the node by any conversation ends. The state is RELEASING until this is completed.
If this option is not coded, the acquire state is not changed.
- NODE(8-character data-value)
- specifies the node to be set.
- NODELIST(data-area)
- specifies a contiguous array of 8-character node names to be set.
- NODENUM(fullword binary data-value)
- specifies the number of node names in NODELIST, in the range 1–256.
- SERVSTATUS(cvda)
- specifies the service state of the node; that is, whether the
node can be used for a conversation or not. The relevant CVDA values
are:
- INSERVICE
- Allows usage of the node in a conversation.
- OUTSERVICE
- Stops usage of a node for any new conversation, although existing conversations are unaffected. The service state is GOINGOUT until these conversations end.
If this option is not coded, the service state is not changed.
- USERDATA(64-character data-value)
- Specifies optional user data relating to the nodes; it is not used by FEPI. It replaces any previous user data that was set.
Conditions
- INVREQ
- RESP2 values:
- 110
- SERVSTATUS value not valid.
- 111
- ACQSTATUS value not valid.
- 117
- NODE name unknown.
- 119
- The command failed for one or more items in the list.
- 131
- NODENUM value is out of range.
- 174
- The z/OS Communications Server OPEN ACB failed.
