# tibemsSession_CreateTemporaryTopic

Function

## Purpose

Create a temporary topic.

## C Declaration

    tibems_status tibemsSession_CreateTemporaryTopic(
        tibemsSession session,
        tibemsTemporaryTopic* tmpTopic );

## COBOL Call

    CALL "tibemsSession_CreateTemporaryTopic"
         USING BY VALUE session,
               BY REFERENCE tmpTopic,
               RETURNING tibems-status
    END-CALL.

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

## Parameters

Parameter | Description
--- | ---
`session` | Create the topic in this session.
`tmpTopic` | The function stores the new temporary topic object in this location.

## Remarks

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

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

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

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

## See Also

`tibemsTemporaryTopic`

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