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.

Dynamic destinations are provider-specific, so programs that use them might not be portable to other providers.

See Also

tibemsTemporaryQueue