Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-7
CANCELREQ Procedure
CANCELREQ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Messages
Related Programming Manual
Summary
The CANCELREQ procedure is used to cancel an incomplete operation, identified by a
file number and tag, on a file opened for nowait I/O. The canceled operation might or
might not have had effects. For disk files, the file position might or might not be
changed.
Syntax for C Programmers
•
CEXTDECS (through the included file TNSINTH) defines 32-bit values as the
typedef __int32_t which for TNS and TNS/R compiles is defined as long and for
TNS/E compiles is defined as
int.
•
The function value returned by CANCELREQ, 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
Parameters
filenum input
INT:value
is the number of an open file, identifying the file whose operation did not complete
and is to be canceled.
#include <cextdecs(CANCELREQ)>
_cc_status CANCELREQ ( short filenum
,[ __int32_t tag ] );
CALL CANCELREQ ( filenum ! i
,[ tag ] ); ! i