Guardian Procedure Calls Reference Manual

error:= CANCELREQL ( filenum ! i
,[ tag ] ); ! i
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.
filenum
input
INT:value
is the number of an open file, identifying the file whose operation did not complete and is to
be canceled.
tag
input
(for CANCELREQ)INT(32):value
(for CANCELREQL)INT(64):value
is the tag value passed to the procedure that initialized the I/O operation. It identifies the
operation to be canceled.
If tag is omitted or 0, the oldest incomplete request is canceled.
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 CANCELREQ.> (CCG)
Returned Value
(for CANCELREQL)INT
A file-system error code that indicates the outcome of the call:
FEOK0
A successful operation.
Considerations
• If you use the tag parameter, the system cancels the oldest incomplete operation associated
with that tag value. If you do not provide a tag, the system cancels the oldest incomplete
operation for filenum.
• If you omit the tag parameter, CANCELREQ[L] works exactly like CANCEL.
Messages
The server process receives a system message -38 (queued message cancellation) that identifies
the canceled I/O request, if it has requested receipt of such messages.
CANCELREQ[L] Procedures 115