FEPI SET CONNECTION

Description

FEPI SET CONNECTION controls the use of FEPI connections. Lists may be used to set more than one connection at a time; all connections in the list are set to the same state. The command completes immediately, although the requested settings may not be achieved until later.

Options

ACQSTATUS(cvda)

specifies the acquire state of the connection; that is, whether a session should be established (‘bound’) or not (‘unbound’). The relevant CVDA values are:

ACQUIRED

The connection is to have a session established (that is, ‘bound’). The state is ACQUIRING until this is completed.

RELEASED

The connection is to have its session ended (that is, ‘unbound’), when usage of the connection by all owned conversations ends. (An unowned conversation on the connection is ended immediately. See the STATE option of FEPI INQUIRE CONNECTION.) 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 name that identifies a connection.

NODELIST(data-area)

specifies a contiguous array of 8-character node names identifying connections.

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 connection; that is, whether the connection can be used for a conversation or not. The relevant CVDA values are:

INSERVICE

Allows usage of the connection in a conversation.

OUTSERVICE

Stops usage of a connection 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.

TARGET(8-character data-value)

Specifies the target name that identifies a connection.

TARGETLIST(data-area)

specifies a contiguous array of 8-character target names identifying a connection or connections.

TARGETNUM(fullword binary data-value)

specifies the number of target names in TARGETLIST, in the 1–256.

USERDATA(64-character data-value)

Specifies optional user data relating to the connections; 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.

116

TARGET name unknown.

117

NODE name unknown.

118

Unknown connection (TARGET and NODE names are known but not connected in any pool).

119

The command failed for one or more items in the list.

130

TARGETNUM value out of range.

131

NODENUM value out of range.