For a state-reset, state-aware, or stateless application server, 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 application server.

For a state-free application server, 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 application server.

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 or methods execute for the following asynchronous requests:

  • All requests that were complete when this method executed but whose event procedures or methods 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