FEPI SET NODE

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.