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. 

session and tmpTopic have usage pointer.

Parameter
Description
session
Create the queue 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


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com