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.

FEPI 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)-'
- 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.
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 ]]