# tibemsQueue_GetQueueName

Function

## Purpose

Get the name of a queue object.

## C Declaration

    tibems_status tibemsQueue_GetQueueName(
        tibemsQueue queue,
        char* name,
        tibems_int name_len );

## COBOL Call

    CALL "tibemsQueue_GetQueueName"
         USING BY VALUE queue,
               BY REFERENCE name,
               BY VALUE name-len
               RETURNING tibems-status
    END-CALL.

Note: `queue` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`queue` | Get the name of this queue.
`name` | The function copies the name to this location.
`name_len` | Length of the name buffer.

## Remarks

A null character terminates the copied name string.

Your program must allocate the name buffer, and pass its length to the function. If the length of the queue name is greater than the size of the buffer provided, the entire queue name may not be copied. The buffer size is determined by the `TIBEMS_DESTINATION_MA`X constant. Constants such as `TIBEMS_DESTINATION_MAX` are located in the `tibems/types.h` header file.

Copyright © Cloud Software Group, Inc. All rights reserved.