Inquire Subscription Status (Response)
The response to the Inquire Subscription Status (MQCMD_INQUIRE_SUB_STATUS) command consists of the response header followed by the SubId and SubName structures, and the requested combination of attribute parameter structures (where applicable).
- Always returned
- SubID , SubName
- Returned if requested
- ActiveConnection , Durable , LastPublishDate , LastPublishTime , MCastRelIndicator , NumberMsgs , ResumeDate , ResumeTime , SubType , TopicString
Response Data
- ActiveConnection (MQCFBS)
- The ConnId of the HConn that currently has this subscription open (parameter identifier: MQBACF_CONNECTION_ID).
- Durable (MQCFIN)
- A durable subscription is not deleted when the creating application closes its subscription
handle (parameter identifier: MQIACF_DURABLE_SUBSCRIPTION).
- MQSUB_DURABLE_NO
- The subscription is removed when the application that created it is closed or disconnected from the queue manager.
- MQSUB_DURABLE_YES
- The subscription persists even when the creating application is no longer running or has been disconnected. The subscription is reinstated when the queue manager restarts.
- LastMessageDate (MQCFST)
- The date that a message was last sent to the destination specified by the subscription (parameter identifier: MQCACF_LAST_MSG_DATE).
- LastMessageTime (MQCFST)
- The time when a message was last sent to the destination specified by the subscription (parameter identifier: MQCACF_LAST_MSG_TIME).
- MCastRelIndicator (MQCFIN)
- The multicast reliability indicator (parameter identifier: MQIACF_MCAST_REL_INDICATOR).
- NumberMsgs (MQCFIN)
- The number of messages put to the destination specified by this subscription (parameter identifier: MQIACF_MESSAGE_COUNT).
- ResumeDate (MQCFST)
- The date of the most recent MQSUB API call that connected to the subscription (parameter identifier: MQCA_RESUME_DATE).
- ResumeTime (MQCFST)
- The time of the most recent MQSUB API call that connected to the subscription (parameter identifier: MQCA_RESUME_TIME).
- SubscriptionUser (MQCFST)
- The userid that 'owns' this subscription. This parameter is either the userid associated with
the creator of the subscription, or, if subscription takeover is permitted, the userid which last
took over the subscription. (parameter identifier: MQCACF_SUB_USER_ID).
The maximum length of the string is MQ_USER_ID_LENGTH.
- SubID (MQCFBS)
- The internal, unique key identifying a subscription (parameter identifier: MQBACF_SUB_ID).
- SubName (MQCFST)
- The unique identifier of a subscription (parameter identifier: MQCACF_SUB_NAME).
- SubType (MQCFIN)
- Indicates how the subscription was created (parameter identifier: MQIACF_SUB_TYPE).
- MQSUBTYPE_PROXY
- An internally created subscription used for routing publications through a queue manager.
- MQSUBTYPE_ADMIN
- Created using the DEF SUB MQSC or Create Subscription PCF command. This Subtype also indicates that a subscription has been modified using an administrative command.
- MQSUBTYPE_API
- Created using an MQSUB API call.
- TopicString (MQCFST)
- The resolved topic string (parameter identifier: MQCA_TOPIC_STRING). The maximum length of the string is MQ_TOPIC_STR_LENGTH.
Parent topic: Definitions of the Programmable Command Formats