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