CANCEL-REQUESTS( ) method

For a state-reset, state-aware, or stateless AppServer, this method raises a STOP condition in the context of the currently running asynchronous request and purges the send queue of any asynchronous requests that have not been executed on the specified AppServer.

For a state-free AppServer, this method raises a STOP condition for all currently running asynchronous requests, and purges the send queue of any asynchronous requests that have not been executed on the specified AppServer.

For Web services, this method terminates the connection to all currently running asynchronous requests and purges the send queue of all asynchronous requests that have not been executed on the specified Web service.

Return type: LOGICAL

Applies to: Server object handle

Syntax

CANCEL-REQUESTS( )

After executing this method, at the next input-blocking state (or on executing the PROCESS EVENTS statement) event procedures execute for the following asynchronous requests:

• All requests that were complete when this method executed but whose event procedures have not been run.
• All currently running requests that were stopped in response to this method
• All requests that were purged from the send queue, and never run

This method returns FALSE when the server handle is not in the connected state. (See the CONNECTED( ) method). Otherwise, this method returns TRUE.

See also

CANCEL-REQUESTS-AFTER( ) method