Other Information About the Allocate Queue

The Query_Allocate_Queue service also returns information that a server can use to determine whether it is processing the requests on an allocate queue quickly enough to meet the installation's throughput goals. Among the information returned is the number of allocate requests that currently reside on the allocate queue (in the allocate_queue_size parameter).

The Query_Allocate_Queue service also returns the following information:

Amount of time (in seconds) that the oldest allocate request has been in the allocate queue
Time when the last call to the Receive_Allocate service was made by the server
Time when the Receive_Allocate service last returned control to the server.

A server can examine these parameters to determine whether it is meeting the installation's throughput goals, or if the allocate queue is growing at a rate that requires more resources (such as additional servers) to process. If desired, your server can take actions to increase its throughput. For example, if the server does multi-tasking, it might add subtasks to process allocate requests at a faster rate.

A server can use the Query_Allocate_Queue service with the Get_Event service to determine the status of the allocate queue for load balancing or diagnostic purposes. The Get_Event service is described in Receiving Notification of Events.