# tibemsSession_DeleteTemporaryQueue

Function

## Purpose

Delete a temporary queue.

## C Declaration

    tibems_status tibemsSession_DeleteTemporaryQueue(
        tibemsSession session,
        tibemsTemporaryQueue tmpQueue );

## COBOL Call

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

Note: `session` and `tmpQueue` have usage pointer.

## Parameters

Parameter | Description
--- | ---
`session` | Delete a temporary queue from this session.
`tmpQueue` | Delete this temporary queue.

## Remarks

When a client deletes a temporary queue, the server deletes any unconsumed messages in the queue.

If the client still has listeners or receivers for the queue, then this delete call returns `TIBEMS_ILLEGAL_STATE`.

## See Also

`tibemsTemporaryQueue`

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