# 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`

Copyright © Cloud Software Group, Inc. All rights reserved.