tibemsSession_CreateTemporaryQueue

Function

Purpose

Create a temporary queue.

C Declaration

tibems_status tibemsSession_CreateTemporaryQueue(
    tibemsSession session,
    tibemsTemporaryQueue* tmpQueue );

COBOL Call

CALL "tibemsSession_CreateTemporaryQueue"
     USING BY VALUE session,
           BY REFERENCE tmpQueue,
           RETURNING tibems-status
END-CALL.

Note: session and tmpQueue have usage pointer.

Parameters

Parameter	Description
`session`	Create the queue in this session.
`tmpQueue`	The function stores the new temporary queue object in this location.

Remarks

A temporary queue lasts no longer than the connection. That is, when the connection is closed or broken, the server deletes temporary queues associated with the connection.

If the named queue already exists at the server, then this function returns that queue. (That queue can be either static or dynamic.)

If the named queue does not yet exist at the server, and the server allows dynamic queue, then this function creates a dynamic queue.