ASYNC-REQUEST-COUNT attribute

The number of active asynchronous requests for the specified procedure or AppServer.

Data type: INTEGER

Access: Read-only

Applies to: Procedure object handle, Server object handle

For a procedure handle, this attribute is only meaningful if PROXY and PERSISTENT are set to TRUE. In all other cases, this attribute returns zero (0).

The AVM sets this attribute to one (1) on the following handles:

• A proxy procedure handle created for an initial asynchronous request
• The server handle of the AppServer where the asynchronous remote procedure is instantiated using the PERSISTENT option of the RUN statement.

The AVM increments this attribute:

• On any proxy procedure handle where an internal procedure defined in the specified remote persistent procedure context is executed asynchronously
• On any server handle where an internal or external procedure is executed asynchronously on the specified AppServer

The AVM decrements this attribute as part of processing the PROCEDURE-COMPLETE event for one of the associated asynchronous requests. The attribute is decremented before any associated event procedure is executed in the context of a PROCESS EVENTS, WAIT-FOR, or other input-blocking statement.