Guardian Procedure Calls Reference Manual

CANCEL Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Condition Code Settings
Considerations
Messages
Related Programming Manual
Summary
The CANCEL procedure is used to cancel the oldest incomplete operation on a file opened nowait.
The canceled operation might or might not have had effects. For disk files, the file position might
or might not be changed. The CANCEL procedure can also be used to cancel operations started
by "L" procedures (for example, SERVERCLASS_SENDL_ or READUPDATEXL).
NOTE: You can cancel a specific request, identified with a tag parameter, using a call to
CANCELREQ.
Syntax for C Programmers
#include <cextdecs(CANCEL)>
_cc_status CANCEL ( short filenum );
• The function value returned by CANCEL, 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 CANCEL ( filenum ); ! i
Parameter
filenum
input
INT:value
is the number of an open file whose oldest incomplete operation you want to cancel.
Condition Code Settings
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).< (CCL)
indicates that the operation was canceled.= (CCE)
does not return from CANCEL.> (CCG)
CANCEL Procedure 111