Previous Topic: Asynchronous BehaviorNext Topic: Async Action Statements


ASYNC_REQUEST Work Set

In addition to the asynchronous action statements, each CA Gen model contains a Work Set to support asynchronous behavior. This work set type, named ASYNC_REQUEST, allows each outstanding request to contain a unique request identifier, and is used to communicate aspects of a given asynchronous request between the requesting application component and the supporting runtime components. Each unique outstanding request within an application must be represented by a unique instance of a view of the ASYNC_REQUEST work set.

Each instance of an ASYNC_REQUEST work set view contains the following attributes:

Attribute

Size

Type

Description

ID

(8)

numeric data

The ID attribute is a unique identifier associated with a given request. The ID field is set by the runtime when the asynchronous request is accepted for processing.

REASON_CODE

(8)

text data

Reserved for future use.

LABEL

(128)

mixed text data

The LABEL attribute is a character string that is set by the application program. It provides the program with a way to identify the given request.

ERROR_MESSAGE

(2048)

mixed text data

 

The ERROR_MESSAGE attribute only has value if the associated request completed with an error. The ERROR_MESSAGE value contains a text description of the failure. This attribute contains the same text data as is displayed in the event of a server error or communications error.