Envoy Application Programming Manual

TINET Multipoint Supervisor Protocol
Envoy Application Programming Manual—427159-001
8-7
Address-List Format
SETMODE
Alters the line characteristics shown in Table 8-4.
WRITE
Transmits data to a terminal. A WRITE call causes Envoy to select the terminal
indicated by the entry number value in the message control word (MCW) from the
application’s write buffer, then transmit the message portion of the buffer to the
terminal.
Address-List Format
The address list tells Envoy the poll and select addresses of all terminals in the network
that may be polled or selected. You pass the list to Envoy, after opening the line, by
issuing a call to the DEFINELIST procedure.
This subsection includes:
•
Station Address
•
Poll List
•
Select List
Each entry in the address list is referred to by an ordinal entry number; the first is
designated entry number 0. Envoy uses the entry number, following a READ
completion, to tell the application process which terminal responded to the poll. The
application process uses the entry number, in conjunction with a WRITE call, to tell
Envoy which terminal is to be selected. The application process and Envoy pass the
entry number back and forth by way of the entry number field of the message control
word (MCW) of the application’s read or write buffer (for more information, see
Message Formats
on page 8-18).
Table 8-4. SETMODE Operations for TINET
Operation Parameter Description
15 1 Sets timeout duration in 10-millisecond units
2 Sets number of times to retry
16 1 Sets line type
2 Sets polling interval in 10-millisecond units
17 1 Sets intermediate block size in words
18 1 Sets statistics threshold
Note. For a complete list of SETMODE procedures supported by the Envoy protocols, see the
SETMODE procedure description in Ta ble C-5
on page C-27, which also lists the analogous
modifier for these procedures.