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