Exchange/RJE Manual

SETMODE Procedure
Exchange/RJE System Procedure Calls
5–28 104698 Tandem Computers Incorporated
Line Activity None.
Considerations The SETMODE procedure sets parameters that control the operation of the
Exchange/RJE line server. The SETMODE procedure can also be used to determine
the current state of the line server. The particular function to be performed is
determined by the value you specify in function .
The SETMODE procedure always operates as a wait I/O operation, even if you
opened the line server for nowait I/O. If you want to perform a nowait SETMODE
operation, you must use the SETMODENOWAIT procedure. In this case, you must
complete the operation with a call to AWAITIO. The functions and parameters for
SETMODENOWAIT are identical to those described here. For more information on
SETMODENOWAIT, see the Guardian Procedure Calls Reference Manual.
SETMODE Function 41
This function establishes a connection between the line server and the data
communications line, and specifies several operational parameters that apply for the
duration of the connection. Your program must call SETMODE function 41 before the
line server can be used to send or receive data.
SETMODE function 41 is the only way to change the state of the line server from
disconnected to connected. Should the remote system put the line server in a
disconnected state (the remote system sends DLE EOT), you must call SETMODE
function 41 before you can use the line server again. You can use SETMODE function
45 to determine the state of the line server.
The following section describes the use of param1 and param2 with SETMODE
function 41. Note that you use the same settings for an ACU and a user-exit
procedure.
param1 .<5>
specifies whether or not to receive error 301 when transparent text begins and
ends. If you set this parameter to 1, the error 301 protocol for transparent text is
enabled, and it stays enabled until a disconnect occurs. Refer to the subsection
“Receiving Transparent Text” in Section 4 for more information.
If you choose not to use the error 301 protocol for transparent text, you must set
this parameter to 0. In this case, you receive no notification when transparent text
is received.
The default value for this parameter is 0.
param1 .<12:13>
specifies the PRIMARY or SECONDARY status of the local system. The value you
specify here overrides the value specified during system generation. Typically,
the local system is set to PRIMARY. (That is, a 2780 or 3780 terminal is usually set
to PRIMARY and the computer with which the terminal is communicating is
usually set to SECONDARY.)