tibemsAdmin_GetTopic

Function

Purpose

Get the topic for the given topic name.

C Declaration

tibems_status tibemsAdmin_GetTopic(
    tibemsAdmin admin,
    tibemsTopicInfo* topicInfo,
    const char* topicName);

COBOL Call

CALL "tibemsAdmin_GetTopic"
 USING BY VALUE admin,
       BY REFERENCE topicInfo,
       BY REFERENCE name,
       RETURNING tibems-status
END-CALL.

Parameters

Parameter Description
admin Get information about a topic using this administrative connection.
topicInfo Stores information about the topic in this location.
topicName The name of the topic for which information will be retrieved.

Remarks

This function gets a tibemsTopicInfo object for the specified topic name. If the topicName does not exist, the function returns TIBEMS_NOT_FOUND.

Status Codes

Status Code Description
TIBEMS_TIMEOUT The administrative query timed out while waiting for a server response.
TIBEMS_NOT_FOUND No topic found matching the specified topicName.

See Also

tibemsTopicInfo