tibrvQueue_SetName()

Function

Declaration

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

Purpose

Set 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

Set the name of this queue.

queueName

Replace the name of the queue with this new name.

It is illegal to supply NULL as the new queue name.

See Also

tibrvQueue_GetName()