Copyright © TIBCO Software Inc. All Rights Reserved

> 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.

> | queue has usage pointer.

> Parameters

> Parameter | Description
> queue | The function stores 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 on page 322

Copyright © TIBCO Software Inc. All Rights Reserved