Guardian Procedure Calls Reference Manual

CANCELREQ[L] Procedures
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Returned Value
Considerations
Messages
Related Programming Manual
Summary
The CANCELREQ[L] procedures are used to cancel an incomplete operation, identified by a file
number and tag, on a file opened for nowait I/O. The CANCELREQL procedure is used to cancel
outstanding requests with 64-bit tags, such as:
• No wait I/O operations initiated by "L" procedures (for example, SERVERCLASS_SENDL_ or
READUPDATEXL)
• No wait I/O operations initiated by the FILE_...64_ procedures
The canceled operation might or might not have had effects. For disk files, the file position might
or might not be changed.
The CANCELREQL procedure also cancels I/O initiated by "L" procedures if a tag is not specified.
See Considerations (page 115).
NOTE: The CANCELREQL procedure is supported on systems running H06.18 and later H-series
RVUs and J06.07 and later J-series RVUs.
Syntax for C Programmers
#include <cextdecs(CANCELREQ)>
_cc_status CANCELREQ ( short filenum
,[ _int32_t tag ] );
#include <cextdecs(CANCELREQL)>
short CANCELREQL ( short filenum
,[ long long tag ] );
• 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
CALL CANCELREQ ( filenum ! i
,[ tag ] ); ! i
114 Guardian Procedure Calls (C)