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

    (Alpha only.) The Insert Entry at Head of Queue routine inserts a
    queue entry at the head of the specified self-relative quadword
    interlocked queue. LIB$INSQHIQ makes the INSQHIQ instruction
    available as a callable routine.

    Format

      LIB$INSQHIQ  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 by LIB$INSQHIQ. 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 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 an unsigned longword that contains the retry count
    value. A value of 1 causes no retries. The default value is 10.