Envoy Application Programming Manual
Table Of Contents
- What’s New in This Manual
- About This Manual
- 1 Application Programming With Envoy
- 7 ADM-2 Multipoint Supervisor Protocol
- 8 TINET Multipoint Supervisor Protocol
- 9 Burroughs Point-To-Point Protocol
- 10 Asynchronous Line Supervisor Protocol
- A ASCII Character Set
- B ASCII to EBCDIC Code Conversion
- C File-System Procedures
- D Statistics Messages
- E S-Series Changes to Envoy
- NonStop™ Himalaya S-Series Server Architecture
- G-Series Migration Considerations
- CBSENSEON and CFSENSEON Modifiers
- LEOTRESYN and NOLEOTRESYN Modifiers
- Treatment of Characters After the Termination Character
- Number of SYN Characters
- DTR Drop
- Reporting of Parity Error
- Half-Duplex Support for Asynchronous Lines
- Controller Replacement
- SYSGEN and COUP
- Unit Numbers
- FDX Line Changes
- No Support for Auto-Call Unit
- Glossary
- Index
TINET Multipoint Supervisor Protocol
Envoy Application Programming Manual—427159-001
8-6
File-System Procedures
DEFINELIST
Passes the poll and select address list to Envoy. The format of the address list is
described under Address-List Format on page 8-7. You must call DEFINELIST after
opening the line but before the first call to READ or WRITE. You may subsequently
redefine the poll and select addresses at any time by again calling the DEFINELIST
procedure.
DEVICEINFO
Returns the device type and configured record length for a line.
FILEINFO
Returns error information and characteristics about an open file.
HALTPOLL
Stops the polling function. You use HALTPOLL to stop continuous polling initiated
by a nowait READ call. Following the HALTPOLL call, you must issue an
AWAITIO call to complete the outstanding READ call. The READ completes with
either an error 176 (poll sequence ended with no responder) or an error 0 (operation
successful).
After the application process stops the polling function, it can then select a tributary
and send a message to it. When you subsequently call the READ procedure to
resume polling, the polling function continues from the point in the list where it was
interrupted.
OPEN
Establishes communications with a line. A line can be opened by only one process
(and its backup) at a time.
READ
Solicits data from a remote terminal. A call to READ causes Envoy to initiate the
polling of the terminals specified in the poll list of the application process. When a
terminal responds to the poll by sending a message, the polling function stops,
Envoy returns the terminal’s message to the application process, and the READ
completes. Envoy returns an entry number value in the message control word
(MCW) to the line butter of the application process to indicate which terminal
responded.
15 Sends CAN. A cancel (CAN) code is sent to the transmitting terminal in
response to an error 173 (maximum allowable NAKs received) on a READ.
The receipt of the CAN by the terminal causes the terminal to retain the data
just entered. The terminal sends the data the next time it is polled.
Table 8-3. CONTROL Operations for TINET (page 2 of 2)
Operation Description