GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-16
^CANCELREQ
Except for the following considerations, the syntax, condition code settings, and
considerations regarding this procedure are the same as the counterpart in the Guardian
Procedure Calls Reference Manual.
Considerations
•
^READUPDATE and ^CANCEL are the only two operations that a
LINE^HANDLER can issue against the in-queue file.
•
For information about using ^CANCEL to cancel a ^READUPDATE on a pseudo-
$RECEIVE file, see the considerations under “^READUPDATE“ in this section.
^CANCELREQ
This procedure cancels an incomplete operation, identified by a file number and tag, on
a file opened for nowait I/O. When the procedure successfully cancels an operation, the
associated IOCB is deallocated unless the procedure’s third parameter is used.
Except for the following consideration, the syntax, condition code settings, and
considerations regarding this procedure are the same as the counterpart in the Guardian
Procedure Calls Reference Manual.
Consideration
This procedure differs from its counterpart by having a third parameter (iocb-
address) that is used to return the address of the IOCB for the canceled operation.The
procedure is defined as follows:
CALL ^CANCELREQ ( filenum , [ tag ] , [ iocb-address ] ,
[Cancel^Tag ]);
where iocb-address and cancel^tag are INT(32). In case you call
WAIT^EVENT, time out, and want to cancel an outstanding I/O for
a file, this parameter can be used to examine the IOCB.
^CANCELTIMEOUT
This procedure cancels an elapsed-time timer previously initiated by a call to the
^SIGNALTIMEOUT or ^SIGNALINTERRUPT procedure. The IOCB allocated as a
result of the call to ^SIGNALTIMEOUT or ^SIGNALINTERRUPT is deallocated.
Except for the following consideration, the syntax, condition code settings, and
considerations regarding this procedure are the same as the counterpart in the Guardian
Procedure Calls Reference Manual.
Caution. If iocb-address is used, USCODE is responsible for deallocating the IOCB.