Important: The information in this document is obsolete and should not be used for new development.
Canceling an ATP Function
You can cancel all pending ATP function calls made on a specific socket by closing the socket. However, ATP provides functions that allow you to cancel individual function calls or all function calls of a particular kind. If you want to close a socket for which there are still pending requests that you don't want executed, you should first explicitly cancel those requests by using the ATP function provided for this purpose, instead of simply closing the socket.You can use the following functions to cancel specific requests:
- To cancel a
PGetRequest
function, use thePKillGetReq
function, which is described on page 6-41. You identify the request to be canceled by specifying
the pointer to the parameter block that you passed to thePGetRequest
function
when you called it.- To cancel all pending
PGetRequest
functions on a certain socket, use theATPKillAllGetReq
function described on page 6-42; you specify the socket number, whose pending get requests you want to cancel, as the value of theatpSocket
parameter.- To cancel a
PSendReques
t or aPNSendRequest
function, use thePKillSendReq
function described beginning on page 6-38. You identify the request to be canceled
by specifying the pointer to the parameter block that you passed to the function
when you issued it. To cancel aPSendRequest
function, use thePRelTCB
function described beginning on page 6-40. You identify the request to be canceled by specifying the request transaction ID as thetransID
parameter and the destination socket of the request as theaddrBlock
parameter.- To cancel an exactly-once
PSendResponse
function, use thePRelRspCB
function, described beginning on page 6-43. You identify the request to be canceled by specifying the transaction ID of the associated request as thetransID
parameter and thePSendResponse
destination socket number as theatpSocket
parameter.