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.