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
ADM-2 Multipoint Supervisor Protocol
Envoy Application Programming Manual—427159-001
7-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 7-8. 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 of a line.
FILEINFO
Returns error information and characteristics about an open communications line.
HALTPOLL
Stops the polling function. You use HALTPOLL to stop continuous polling initiated
by a nowait READ call. Following the HALTPOLL call, you must then 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 (successful
operation).
After stopping the polling function, the application process can then select a
terminal 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 while the line is in the control
state (an initial READ) causes Envoy to initiate polling of the terminals specified in
the currently defined poll list. When a terminal responds to the poll by sending a
message, polling halts, Envoy returns the terminal’s message to the application
process, and the READ completes. Envoy returns an entry number value in the
Table 7-3. CONTROL Operations for ADM-2
Operation Parameter Description
13 1
.<0> 0: Sends EOT (used to clear the network after an error
occurs)
1: Performs specific poll on device indicated by station
index value.
.<8:15> = n Specifies station index value of station to be polled.