Guardian Procedure Calls Reference Manual

HALTPOLL Procedurè
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Condition Code Settings
Example
Related Programming Manuals
Summary
The HALTPOLL procedure is normally used to stop continuous polling.
Syntax for C Programmers
#include <cextdecs(HALTPOLL)>
_cc_status HALTPOLL ( short filenum );
• The function value returned by HALTPOLL, which indicates the condition code, can be
interpreted by _status_lt(), _status_eq(), or _status_gt() (defined in the file
tal.h).
Syntax for TAL Programmers
CALL HALTPOLL ( filenum ); ! i
Parameter
filenum
input
INT:value
is the number of an open file that HALTPOLL stops polling.
Condition Code Settings
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).< (CCL)
indicates that the HALTPOLL procedure executed successfully.= (CCE)
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).> (CCG)
Example
In the following example, FNUM is the integer returned from the call to FILE_OPEN_ or OPEN that
opened the particular communication line. HALTPOLL forces the immediate termination of an
outstanding nowait read operation within a point-to-point station, or it stops any polling that is in
progress within a multipoint station:
CALL HALTPOLL ( FNUM );
Related Programming Manuals
For programming information about the HALTPOLL procedure, see the data communication manuals.
690 Guardian Procedure Calls (H-K)