FEPI SET NODE

Function

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.

Syntax

Read syntax diagramSkip visual syntax diagramFEPI SET NODE
 
>>-FEPI SET--+-NODE(data-value)-------------------------+------->
             '-NODELIST(data-area)--NODENUM(data-value)-'
 
>--+-----------------+--+------------------+-------------------->
   +-ACQSTATUS(cvda)-+  +-SERVSTATUS(cvda)-+
   +-ACQUIRED--------+  +-INSERVICE--------+
   '-RELEASED--------'  '-OUTSERVICE-------'
 
>--+----------------------+------------------------------------><
   '-USERDATA(data-value)-'
 

Options

ACQSTATUS(cvda)
specifies the acquire state of the node; that is, whether its VTAM® ACB should be opened or closed. The relevant CVDA values are:
ACQUIRED
The VTAM 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 VTAM 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

Condition RESP2 Meaning
INVREQ 110 SERVSTATUS value not valid.
INVREQ 111 ACQSTATUS value not valid.
INVREQ 117 NODE name unknown.
INVREQ 119 The command failed for one or more items in the list.
INVREQ 131 NODENUM value is out of range.
INVREQ 174 The VTAM OPEN ACB failed.
[[ Contents Previous Page | Next Page Index ]]