Envoy Application Programming Manual

File-System Procedures
Envoy Application Programming Manual—427159-001
C-21
HALTPOLL
zzzz (bits 12 to 15)
specify whether the line is configured for wait or nowait I/O:
0000 = wait I/O
0001 = nowait I/O
Condition Codes
Examples
CALL FILEINFO (fnum,error);
where fnum is the name of the one-word integer variable specified in the OPEN call
that opened the particular communications line. This call obtains the error code for the
most recently completed I/O operation on the specified line.
CALL FILEINFO (fnum ,, fname , ldev^num
, dev^type ,,,,,,,, open^flags);
where fnum is the name of the one-word integer variable specified in the OPEN call
that opened the particular communications line. This call obtains the configured file
name, logical device number, device type, and open flags for the specified line.
CALL FILEINFO (-1,error);
This call obtains the error code for the most recent line-open failure.
HALTPOLL
A call to the HALTPOLL procedure does either of the following:
In a multipoint (bisynchronous or asynchronous) supervisor station, HALTPOLL stops
continuous polling.
In a BISYNC point-to-point station, HALTPOLL forces the immediate termination of an
outstanding nowait READ operation. If text is being received when HALTPOLL is
called, the READ operation is allowed to complete normally. Otherwise, the READ
operation completes with a condition code of CCL and file-system error code 162
(operation timed out).
The form of the HALTPOLL procedure is:
< (CCL) Indicates that an error occurred (call FILEINFO).
= (CCE) Indicates that the FILEINFO procedure was executed successfully.
CALL HALTPOLL ( filenum ); !i