Topic Definitions attributes
The Topic Definitions attributes provide detailed information about all topics.
- Topic Name with "Scan for string within a string", specifying the beginning characters (with no wildcard). For example, Scan for string within a string == USER, will return all topics with topic name starting with USER.
- Topic Name with "Return a subset of the string", specifying starting position 1, with beginning characters.
Alter Date & Time The data and time that this topic is last modified. The valid format is a 16 character timestamp.
Cluster The name of the cluster to which this topic belongs. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Cluster Date & Time The date and time that the cluster topic definition becomes available.
Cluster QMgr The name of the queue manager that is hosting the cluster topic. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
- Direct = 0 (When performing publish and subscribe operations, each queue manager can connect directly to any other queue manager in the cluster.)
- TopicHost =1 (Queue managers in the cluster connect only to these topic host queue managers, and not directly to each other. )
- None = 2
- Active = 0 (The topic is correctly configured and being adhered to by this queue manager.)
- Pending = 1 (The topic has been created but the full repository has not yet propagated it to the cluster. )
- Invalid = 2 (The topic definition conflicts with an earlier definition in the cluster and is therefore not currently active.)
- Error = 3 (An error has occurred with respect to the topic.)
Durable Sub Whether durable subscriptions are permitted. Possible values are as follows:
- 0 = as parent
- 1 = yes
- 2 = no
- -1 = not applicable
Durable Sub Model The name of the model queue that is used to create dynamic queues for durable subscriptions. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Host Name Name of the system on which the queue manager is running. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Max Rows The maximum number of rows that are returned by the agent as the result of a query.
Msg Persistence Whether messages are persistent. Possible values are as follows:
- n/a = -2
- AsParent = -1
- No = 0
- Yes = 1
- AsQOrTopicDef = 2
Msg Priority The message priority. Possible values are 2 - 9, representing the priority of the message, or one of the following values:
- n/a = -4
- AsPublished = -3
- AsParent = -2
- AsQOrTopicDef = -1
Msg Put Resp Type Put response type of messages that are published on the topic. Possible values are as follows:
- 0 = as parent
- 1 = synchronous
- 2 = asynchronous
- -1 = not applicable
Nonpersistent Msg Delivery The delivery method that is used to publish nonpersistent messages on this topic. Possible values are as follows:
- 0 = as parent
- 1 = all
- 2 = all durable
- 3 = all available
- -1 = not applicable
Non-Durable Sub Model The name of the model queue that is used to create dynamic queues for non-durable subscriptions. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Origin Node Name of the node on which the data for the queue manager originates.
On z/OS systems, this name takes the form qmgr:smfid:MQESA, where qmgr is the name of the queue manager and smfid is the z/OS system or SMF ID.
Persistent Msg Delivery The delivery method that is used to publish persistent messages on this topic. Possible values are as follows:
- 0 = as parent
- 1 = all
- 2 = all durable
- 3 = all available
- -1 = not applicable
Proxy Sub Forces the propagation of a proxy subscription for this topic string, even if no local or proxy subscriptions exist. Possible values are as follows:
- n/a = -1
- AsParent = 0
- Force = 1
- FirstUse = 2
Pub Enabled Whether publication is enabled. Possible values are as follows:
- n/a = -1
- AsParent = 0
- No = 1
- Yes = 2
Pub Scope String identifying the scope of the publication. Possible values are as follows:
- n/a = -1
- All = 0
- AsParent = 1
- Cluster = 2
- Hierarchy = 3
- QMgr = 4
- Force_All = 5
- Force_QMgr = 6
QMgr ID The unique name of the queue manager that hosts the topic. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
QMgr Name Name of the queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
QSG Disp Specifies how commands are executed when the queue manager is a member of a queue-sharing group. This attribute is for QSG environment on z/OS systems only. Possible values are as follows:
- n/a = -2
- All = -1
- QMgr = 0
- Copy = 1
- Shared = 2
- Group = 3
- Private = 4
- Live = 6
Status Status for search. Possible values are as follows:
- OK = 0 (The search result is displayed.)
- No_Results_Found = -1
Sub Enabled Whether subscriptions are enabled. Possible values are as follows:
- n/a = -1
- AsParent = 0
- No = 1
- Yes = 2
Sub Scope String that identifies the scope of the subscription. Possible values are as follows:
- n/a = -1
- All = 0
- AsParent = 1
- Cluster = 2
- Hierarchy = 3
- QMgr = 4
- Force_All = 5
- Force_QMgr = 6
Topic Description A text description of the topic. The valid format is a string of up to 256 UTF-8 characters.
Topic Name Name of the topic. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Topic String The topic string, which comprises the tree node names that make up the topic. For example, /news/ibm/hursley/. The valid format is an alphanumeric string of up to 256 case-sensitive characters.
Topic Type The topic enumeration type. This attribute has the following possible values:
- n/a = -1
- Local = 0
- Cluster = 1
- All = 2
- n/a = -1
- AsParent = 0
- No = 1
- Yes = 2
Wildcard How wildcard subscriptions are handled for this topic. Possible values are as follows:
- n/a = -1
- Block = 1
- PassThru = 2