FEPI SET CONNECTION

Function

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.

Syntax

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

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--STATE.) 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

Condition RESP2 Meaning
INVREQ 110 SERVSTATUS value not valid.
INVREQ 111 ACQSTATUS value not valid.
INVREQ 116 TARGET name unknown.
INVREQ 117 NODE name unknown.
INVREQ 118 Unknown connection (TARGET and NODE names are known but not connected in any pool).
INVREQ 119 The command failed for one or more items in the list.
INVREQ 130 TARGETNUM value out of range.
INVREQ 131 NODENUM value out of range.
[[ Contents Previous Page | Next Page Index ]]