Destination : tibemsTopic

tibemsTopic
Type
Purpose
Topics deliver each message to multiple consumers.
 
Related Types
tibemsDestination on page 144
tibemsTemporaryTopic on page 155
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.
Parameters
 
Remarks
This constructor creates only local objects (within the program). It does not attempt to bind the local topic object to the corresponding server object until the program creates a tibemsMsgConsumer or a tibemsMsgProducer that uses the topic.
The bind can fail for the following reasons:
See Also
tibemsLookupContext on page 322
tibemsTopic_Destroy
Function
Purpose
Destroy a topic object.
C Declaration
tibems_status tibemsTopic_Destroy(
    tibemsTopic topic );
COBOL Call
CALL "tibemsTopic_Destroy"
USING BY VALUE topic,
RETURNING tibems-status
END-CALL.
 
topic has usage pointer.
Parameters
 
tibemsTopic_GetTopicName
Function
Purpose
Get the name of a topic object.
C Declaration
tibems_status tibemsTopic_GetTopicName(
    tibemsTopic topic,
    char* name,
    tibems_int name_len );
COBOL Call
CALL "tibemsTopic_GetTopicName"
USING BY VALUE topic,
BY REFERENCE name,
BY VALUE name-len,
RETURNING tibems-status
END-CALL.
 
topic has usage pointer.
Parameters
 
Length of the name buffer.
Remarks
A null character terminates the copied name string.
Your program must allocate the name buffer, and pass its length to the function. If the length of the topic name is greater than the size of the buffer provided, the entire topic name may not be copied. The buffer size is determined by the TIBEMS_DESTINATION_MAX constant. Constants such as TIBEMS_DESTINATION_MAX are located in the tibems/types.h header file.