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

    The Insert a Work Queue Item routine inserts a work item into the
    specified work queue.

    Format

      PPL$INSERT_WORK_ITEM  queue-id ,work-item [,flags] [,priority]

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.

 work-item

    OpenVMS usage user_arg
    type          longword (unsigned)
    access        read only
    mechanism     by value
    A value to be entered into the queue. The work-item argument
    is an unsigned longword containing this value. The content of
    work-item is completely arbitrary. You may want to place single
    longword values into work-item (for example, the number of a
    function or task to be performed). You can also use work-item to
    pass a pointer to a data block. (This data block must reside in
    memory created by PPL$CREATE_SHARED_MEMORY or allocated from a
    shared memory zone created by PPL$CREATE_VM_ZONE.)

 flags

    OpenVMS usage mask_longword
    type          longword (unsigned)
    access        read only
    mechanism     by reference
    Specifies options for inserting a work item into a work queue.
    The optional flags argument is the address of a longword bit mask
    containing the flag. The valid value is as follows:

    PPL$M_ATHEAD  Insert item as the first of those items with the
                  same priority (in other words, at the head of the
                  priority). By default, items are inserted after
                  other items of the same priority.

 priority

    OpenVMS usage longword_signed
    type          longword (signed)
    access        read only
    mechanism     by reference
    Specifies the priority of the item being inserted. The optional
    priority argument is an unsigned longword containing the priority
    value for the item to be inserted. If unspecified, the default
    value is zero. A high numerical value indicates a high priority.