Topic Definitions attributes

The Topic Definitions attributes provide detailed information about all topics.

To prevent a situation from returning large amounts of topic data, the data returned for situation requests will depend on situation conditions. If certain conditions are not specified, only system defined topics will be returned. For your situations against this attribute group to return non-system definitions, add one of the following conditions:
  • 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.

Cluster Route The routing behavior to use for topics in the named cluster. Possible values are as follows:
  • 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
Cluster State The current state of this topic in the cluster. Possible values are as follows:
  • 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
Remember: If this attribute is set to as parent, whether durable subscriptions are permitted depends on the setting of the first parent administrative node found in the topic tree that relates to this topic.

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.

Remember: If the topic string exceeds 256 characters in length, it is truncated.

Topic Type The topic enumeration type. This attribute has the following possible values:

  • n/a = -1
  • Local = 0
  • Cluster = 1
  • All = 2
Use DLQ Indicates whether the dead-letter queue is used when publication messages cannot be delivered to their correct subscriber queue. Possible values are as follows:
  • 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