Asynchronous request object handle

Maintains the status of an asynchronous request running on an AppServer or Web service.

Syntax

async-request-handle [ : attribute ]
async-request-handle
A handle variable that references an asynchronous request object. This object is instantiated when you execute an asynchronous remote procedure using the RUN statement specified with the ASYNCHRONOUS option. You can get the handle value by doing one of the following:
  • Use the ASYNCHRONOUS SET option on the same RUN statement that instantiates the asynchronous request.
  • Reference the LAST-ASYNC-REQUEST attribute on the server handle for the AppServer where the request is running. To ensure that you are referencing a specific request, you must reference the attribute after the associated RUN statement executes and before you instantiate another asynchronous request on the same AppServer connection.
  • You can also locate the asynchronous request handle by walking the chain between the FIRST-ASYNC-REQUEST and LAST-ASYNC-REQUEST attributes of the associated server handle. Search on the PROCEDURE-NAME attribute of each request handle to identify the specific request.
attribute
An attribute of the asynchronous request handle.

Attributes

Events

PROCEDURE-COMPLETE

Notes

See also

RUN statement, Server object handle, SELF system handle, WAIT-FOR statement (ABL only)