VMS Help  —  RTL Routines, LIB$  LIB$INSQTIQ
    (Alpha and I64 only.) The Insert Entry at Tail of Queue routine
    inserts a queue entry at the tail of the specified self-relative
    quadword interlocked queue. LIB$INSQTIQ makes the INSQTIQ
    instruction available as a callable routine.

    Format

      LIB$INSQTIQ  entry ,header [,retry-count]

1  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2  –  Arguments

 entry

    OpenVMS usage:unspecified
    type:         unspecified
    access:       modify
    mechanism:    by reference, array reference

    Entry to be inserted at the tail of the queue by LIB$INSQTIQ. The
    entry argument contains the address of this signed octaword-
    aligned array that must be at least 16 bytes long. Bytes
    following the first 16 bytes can be used for any purpose by the
    calling program.

 header

    OpenVMS usage:octaword_signed
    type:         octaword integer (signed)
    access:       modify
    mechanism:    by reference

    Queue header specifying the queue into which the queue entry is
    to be inserted. The header argument contains the address of this
    signed aligned octaword integer. The header argument must be
    initialized to zero before first use of the queue; zero means an
    empty queue.

 retry-count

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    The number of times the insertion is to be retried in case
    of secondary-interlock failure of the queue instruction in a
    processor-shared memory application. The retry-count argument is
    the address of a longword that contains the retry count value.
    The default value is 10.
Close Help