# tibemsQueue_Create

Function

## Purpose

Create a queue object.

## C Declaration

    tibems_status tibemsQueue_Create(
        tibemsQueue* queue,
        const char* queueName );

## COBOL Call

    CALL "tibemsQueue_Create"
         USING BY REFERENCE queue,
               BY REFERENCE queueName,
               RETURNING tibems-status
    END-CALL.

Note: `queue` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`queue` | Store the queue object in this location.
`queueName` | Create a local queue instance with this name.

## Remarks

This call creates only local objects (within the program). It does not attempt to bind the local queue object to the corresponding server object until the program creates a `tibemsMsgConsumer` or a `tibemsMsgProducer` that uses the queue.

The bind can fail for the following reasons:

- Authorization is enabled for the queue and the user does not have the appropriate permissions.
- The queue does not exist and the server cannot dynamically create the queue.

## See Also

`tibemsLookupContext`

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