# 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`

Copyright © Cloud Software Group, Inc. All rights reserved.