Inquire Pub/Sub Status

The Inquire Pub/Sub Status (MQCMD_INQUIRE_PUBSUB_STATUS) command inquires about the status of publish/subscribe connections.

Optional parameters

CommandScope (MQCFST)

Command scope (parameter identifier: MQCACF_COMMAND_SCOPE).

This parameter applies to z/OS only.

Specifies how the command is executed when the queue manager is a member of a queue sharing group. We can specify one of the following:

blank (or omit the parameter altogether)

The command is executed on the queue manager on which it was entered.

a queue manager name

The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, we must be using a queue sharing group environment, and the command server must be enabled.

an asterisk (*)

The command is executed on the local queue manager and is also passed to every active queue manager in the queue sharing group.

The maximum length is MQ_QSG_NAME_LENGTH.

We cannot use CommandScope as a parameter to filter on.

PubSubStatusAttrs (MQCFIL)

Publish/subscribe status attributes (parameter identifier: MQIACF_PUBSUB_STATUS_ATTRS). The attribute list might specify the following value on its own - default value if the parameter is not specified:

MQIACF_ALL

All attributes.

or a combination of the following:

MQIA_SUB_COUNT

The total number of subscriptions against the local tree.

MQIA_TOPIC_NODE_COUNT

The total number of topic nodes in the local tree.

MQIACF_PUBSUB_STATUS

Hierarchy status.

MQIACF_PS_STATUS_TYPE

Hierarchy type.

Type (MQCFIN)

Type (parameter identifier: MQIACF_PS_STATUS_TYPE). The type can specify one of the following:

MQPSST_ALL

Return status of both parent and child connections. MQPSST_ALL is the default value if the parameter is not specified.

MQPSST_LOCAL

Return local status information.

MQPSST_PARENT

Return status of the parent connection.

MQPSST_CHILD

Return status of the child connections.

Parent topic: Definitions of the Programmable Command Formats