tibrvQueue_GetName()

Function

Declaration

tibrv_status tibrvQueue_GetName(
    tibrvQueue        eventQueue,
    const char**      queueName);

Purpose

Extract the name of a queue.

Remarks

Queue names assist programmers and administrators in troubleshooting queues. When Rendezvous software delivers an advisory message pertaining to a queue, it includes the queue’s name; administrators can use queue names to identify specific queues within a program.

The default name of every queue is tibrvQueue. We strongly recommend that you relabel each queue with a distinct and informative name, for use in debugging.

Parameter	Description
eventQueue	Extract the name of this queue.
queueName	The program supplies a location, and the function places in that location a string pointer to the queue name. The program must not modify the string.

See Also

tibrvQueue_Create()

tibrvQueue_SetName()