Envoy Application Programming Manual

Table Of Contents
Burroughs Point-To-Point Protocol
Envoy Application Programming Manual427159-001
9-4
File-System Procedures
CLOSE
Terminates access to a data communications line.
DEVICEINFO
Returns the device type and configured record length for a line.
FILEINFO
Returns error information and characteristics about an open file.
HALTPOLL
Forces immediate termination of the current outstanding READ operation. If text is
being received when HALTPOLL is called, the READ is allowed to complete
normally, as though HALTPOLL had not been called; if text is not being received,
the READ completes with error 162 (operation timed out).
OPEN
Establishes communications with a line. A line can be opened by only one process
(and its backup) at a time.
READ
Monitors the line and accepts any incoming messages.
A call to READ while the line is in the CONTROL state (an initial READ) causes
Envoy to acknowledge a line bid by the remote station and accept the first message
from the remote.
A call to READ while the line is in the READ state (a continuation READ) causes
Envoy to acknowledge the preceding message with the proper ACK0/ACK1
sequence and accept the current message.
The normal end of transmission by the remote station is indicated by a CCL
condition code returned from a call to READ and by an error 163 (EOT received). A
call to READ while the line is in the WRITE state causes Envoy to transmit an EOT.
The READ then acts as an initial READ.
Table 9-2. CONTROL Operations for Burroughs Point-to-Point
Operation Description
13 Sends EOT (end of transmission). Used to clear the network after an error
occurs.
15 Enables RVI (reverse interrupt)
17 Enables connection by setting the data terminal ready (DTR) signal.
18 Disables connection by clearing DTR.