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.