Subscription Definitions attributes

The Subscription Definitions attributes provide information of all subscriptions.

To prevent a situation from returning large amounts of subscription data, the data returned for situation requests will depend on situation conditions. If certain conditions are not specified, only system defined subscriptions will be returned. For your situations against this attribute group to return non-system definitions, add one or more of the following conditions:
  • Sub ID = full value string (no wildcards)
  • Sub Type = <type> (any type other than ALL, which includes User, API, Admin, Proxy)
  • Topic String = full value string (no wildcards)
  • Destination = full value string (no wildcards)
  • Sub 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 subscriptions with subscription name starting with USER.
  • Sub Name with "Return a subset of the string", specifying starting position 1, with beginning characters.

Accounting Token The accounting token that is provided by the subscriber and inserted into messages sent to this subscription in the Accounting Token field of the MQMD.

Alter Date & Time Date and time that the subscriber is last modified.

Appl ID Identity data that is provided by the subscriber and inserted into messages sent to this subscription in the ApplIdentityData field of the MQMD.

Create Date & Time Date and time that the subscriber is created.

Destination The name of the destination that is used by the subscription.

Destination Correlation ID The correlation ID of the destination queue that is used by the subscription.

Destination Event The destination event type. Valid values are as follows:

  • 2053 queue full
  • 2224 queue depth high
  • -1 = not applicable

The destination event type is -1 in the following situations:

  • The destination event is not found in current events.
  • Performance event monitoring on the queue manager is disabled.
  • Queue monitoring events (by definition) for the subscription queue is disabled.
  • No set events are collected.
  • The destination queue manager is not the queue manager currently selected in the navigator tree.
  • The destination queue is of one of the following types:
    • QCLUSTER
    • QREMOTE
    • QALIAS

Destination QMgr The name of the destination queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.

Durable Whether the subscription is durable. Valid values are as follows:

  • 1 = yes
  • 2 = no
  • -1 = not applicable

Expire (Secs) The length of time in seconds until the subscription expires. If the subscription does not expire, this value is -1.

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. The default value is 2000 rows.

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.

Property Type The method of message delivery. Valid values are as follows:

  • None = 0
  • Compat = 1
  • RFH2 = 2
  • MsgProp = 3

Pub Priority The message priority. Valid values are 1 - 9, representing the priority of the message, or:

  • -1 = as queue definition
  • -3 = as published

QMgr Name Name of the queue manager. Valid format is an alphanumeric string of up to 48 case-sensitive characters.

Request Only Whether the subscriber requests updates. Valid values are as follows:

  • 1 = yes
  • 2 = no
  • -1 = not applicable

Status The status for search. Valid values are as follows:

  • 0 = ok
  • -1 = no results found

Sub ID Unique Subscription Identifier. Valid format is an alphanumeric string of up to 48 case-sensitive characters. The hover help only displays the first character of the Sub ID when you move the cursor over this column.

Sub Level The level within the subscription interception hierarchy at which this subscription is made. Possible values are integers 1 - 9.

Sub Name The name of the application subscription. The valid format is a string of up to 256 UTF-8 characters.

Sub Scope The scope of the subscription. Valid values are as follows:

  • 1 = queue manager
  • 2 = all
  • -1 = not applicable

Sub Type The type of the subscription. Valid values are as follows:

  • User = -2
  • All = -1
  • API = 1
  • Admin = 2
  • Proxy = 3

Sub User The user ID of the user that currently owns this subscription.

System Managed Destination The system managed destination. Valid values are as follows:

  • 1 = managed
  • 2 = provided

Topic Name The name of the topic to which the subscription pertains.

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. if the topic string exceeds 256 characters in length, it is truncated.

Variable User Whether other users can connect to the subscription. Valid values are as follows:

  • 1 = fixed
  • 2 = any
  • -1 = not applicable

Wildcard Char The wildcard schema used in the topic string. Possible values are as follows:

  • 1 = character
  • 2 = topic
  • -1 = not applicable