VMS Help
RTL Routines, LIB$, LIB$REMQTIQ
*Conan The Librarian
|
(Alpha and I64 only.) The Remove Entry from Tail of Queue routine
removes an entry from the tail of the specified self-relative
quadword interlocked queue. LIB$REMQTIQ makes the REMQTIQ
instruction available as a callable routine.
Format
LIB$REMQTIQ header ,remque-address [,retry-count]
OpenVMS usage:cond_value
type: longword (unsigned)
access: write only
mechanism: by value
header
OpenVMS usage:octaword_signed
type: octaword integer (signed)
access: modify
mechanism: by reference
Queue header specifying the queue from which the entry is to be
deleted. 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.
remque-address
OpenVMS usage:address
type: quadword (unsigned)
access: write only
mechanism: by reference
Address of the removed entry. The remque-address argument is the
address of a quadword that contains this address. If the queue
was empty, remque-address is set to the address of the header.
retry-count
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: read only
mechanism: by reference
The number of times the operation 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 is this retry count value. A value
of 1 causes no retries. The default value is 10.