Progress
Language Reference


Asynchronous Request Object Handle

Interfaces
OS
SpeedScript
All
All
Yes

Maintains the status of an asynchronous request running on a Progress AppServer.

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:

attribute

An attribute of the asynchronous request handle. The attributes are listed in the table that follows:

Attribute
Type
Description
LOGICAL
Indicates if the asynchronous request is cancelled using the CANCEL-REQUESTS( ) method of the associated server handle.
LOGICAL
Indicates if the asynchronous request has been completed and processed.
LOGICAL
Indicates that an ERROR condition was returned from the AppServer as a result of processing the request.
CHARACTER
The name of the internal procedure to be run as the event procedure for this asynchronous request.
HANDLE
The procedure handle of the active procedure context where the event procedure for this asynchronous request is defined.
CHARACTER
An arbitrary name for this asynchronous request. Set, by default, to the unknown value (?).
HANDLE
The next entry in the list of asynchronous request handles for asynchronous remote procedures submitted for execution on the same AppServer.
HANDLE
If the asynchronous request is running an internal procedure in a remote persistent procedure, this attribute returns a handle to the persistent procedure.
HANDLE
The previous entry in the list of asynchronous request handles for asynchronous remote procedures submitted for execution on the same AppServer.
CHARACTER
An arbitrary string of data, that Progress does not check, associated with the asynchronous request handle.
CHARACTER
Returns the name of the remote procedure executed to instantiate this asynchronous request handle.
LOGICAL
Indicates that a QUIT condition was returned from the AppServer as a result of processing the request.
HANDLE
Returns the server handle of the AppServer where this asynchronous request was submitted for execution.
LOGICAL
Indicates that a STOP condition was returned from the AppServer as a result of processing the request.
CHARACTER
The handle type, which is "ASYN-REQUEST" for an asynchronous request handle.

EVENTS

Event Type
Supported
PROCEDURE-COMPLETE

NOTES

SEE ALSO

RUN Statement, Server Object Handle, SELF System Handle, WAIT-FOR Statement


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095