tibrvcmTransport_GetUnassignedMessageCount()

Function

Declaration

tibrv_status tibrvcmTransport_GetUnassignedMessageCount(
    tibrvcmTransport    cmTransport,
    tibrv_u32*          msgCount);

Purpose

Extract the number of unassigned task messages from a distributed queue transport.

Remarks

An unassigned task message is a message received by the scheduler, but not yet assigned to any worker in the distributed queue.

This call produces a valid count only within a scheduler process. Within a worker process, this call always produces zero.

Parameter	Description
cmTransport	Extract the number of unassigned task messages from this distributed queue transport.
msgCount	The program supplies a location, and the function stores the unassigned task count in that location.