tibemsTopic_GetTopicName

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.

Note: topic has usage pointer.

Parameters

Parameter	Description
`topic`	Get the name of this topic.
`name`	The function copies the name to this location.
`name_len`	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.

Contents