VMS Help RTL Routines, PPL$, PPL$READ_WORK_QUEUE  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Read a Work Queue routine returns information about a work
    queue.

    Format

      PPL$READ_WORK_QUEUE  queue-id [,queue-value]

1 - Arguments

 queue-id

    OpenVMS usage identifier
    type          longword (unsigned)
    access        read only
    mechanism     by reference
    The queue identifier. The queue-id argument is the address of an
    unsigned longword containing the identifier.

 queue-value

    OpenVMS usage longword_signed
    type          longword (signed)
    access        write only
    mechanism     by reference
    Receives information about the specified work queue. If positive,
    queue-value contains the number of items currently in the work
    queue; if negative, it contains the number of processes currently
    blocked (waiting for an item to be placed in the queue). If the
    value returned is zero, there are no work items in the queue and
    no blocked processes. The optional queue-value argument is the
    address of a signed longword that receives the number of work
    items or blocked processes.