tibemsTopic_Create


Function

Purpose

Create a topic object.

C Declaration

tibems_status tibemsTopic_Create( 
    tibemsTopic* topic, 
    const char* topicName ); 

COBOL Call

CALL "tibemsTopic_Create" 
     USING BY REFERENCE topic, 
           BY REFERENCE topicName, 
           RETURNING tibems-status 
END-CALL. 

topic has usage pointer.

Remarks

This constructor creates only local objects (within the program). It does not attempt to lookup the corresponding server object until the program creates a tibemsMsgConsumer or a tibemsMsgProducer that uses the topic. That automatic lookup can result in either of two outcomes:

Parameter
Description
topic
The function stores the topic object in this location.
topicName
Create a topic with this name.
The lookup name of each topic must be unique among all topics.

See Also

tibemsLookupContext


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