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).
HP Integrity NonStop Server | UNIX and Linux® | Windows |
---|---|---|
X | X |
- Always returned
SubID
,SubName
- Returned if requested
ActiveConnection
,Durable
,LastPublishDate
,LastPublishTime
,MCastRelIndicator
,NumberMsgs
,ResumeDate
,ResumeTime
,SubType
,TopicString
Response Data
ActiveConnection
(MQCFBS)- The
ConnId
of theHConn
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:
MQIA_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 SubscriptionPCF 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.