Try OpenEdge Now
skip to main content
Web Services
Creating ABL Clients to Consume OpenEdge SOAP Web Services : Invoking OpenEdge SOAP Web Service Operations from ABL : Managing asynchronous requests : Asynchronous request object handle
 
Asynchronous request object handle
OpenEdge maintains an asynchronous request object for each asynchronous request, which maintains the status of the request, including whether and how it has completed (successfully or unsuccessfully). The handle to this asynchronous request object is available to the mainline program and to the event procedure for an asynchronous Web service request in the same way as for an asynchronous AppServer request. The Web service server object handle maintains its own chain of pending asynchronous request object handles (FIRST-ASYNC-REQUEST and LAST-ASYNC-REQUEST attributes), and the PROCEDURE-NAME attribute on each asynchronous request object handle returns the name of its Web service operation as it returns the name of the remote procedure executed for an asynchronous AppServer request.
The following table shows attributes on the asynchronous object handle that have special meaning for Web services.

Attributes on asynchronous request object handle

Attribute
Meaning for Web service requests
ERROR
Returns TRUE within the context of the event procedure when:
*You invoke the RETURN ERROR statement within the context of an associated SOAP response header callback procedure.
*A SOAP fault is returned for the asynchronous Web service request.
NEXT-SIBLING and PREV-SIBLING
Maintains a chain of asynchronous request object handles for all pending asynchronous requests invoked in the same Web service
PERSISTENT-PROCEDURE
Returns a handle to the procedure object bound to the Web service port type
PROCEDURE-NAME
Returns the name of the Web service operation invoked asynchronously
QUIT
Always returns FALSE for an asynchronous Web service request
SERVER
Returns a handle to the server object for the Web service where the asynchronous request is executed