tibemsAdmin_GetTopics
Function
Purpose
Get the topics that match the given pattern and the given permanence type.
C Declaration
tibems_status tibemsAdmin_GetTopics( tibemsAdmin admin, tibemsCollection* collection, const char* pattern, tibems_int permType);
COBOL Call
CALL "tibemsAdmin_GetTopics" USING BY VALUE admin, BY REFERENCE collection, BY REFERENCE pattern, BY VALUE permType, RETURNING tibems-status END-CALL.
Note:
collection
has usage pointer.
Parameters
Parameter | Description |
---|---|
admin
|
Get information about topics using this administrative connection. |
collection
|
Store the returned topic data in the location specified here, as a collection of tibemsTopicInfo objects. |
pattern
|
The topic name pattern that must be matched.
The pattern may contain the wildcards * and >. A pattern of > or NULL will return all topics. See the TIBCO Enterprise Message Service User Guide for information about working with wildcards in topics. |
permType
|
The permanence type of the topic must match the type given here. Possible permanence types are:
A NULL value matches all topics. |
Status Codes
Status Code | Description |
---|---|
TIBEMS_TIMEOUT
|
The administrative query timed out while waiting for a server response. |
TIBEMS_NOT_FOUND
|
No topics found matching the specified pattern and performance type. |