Inquire Group (Response)
The response to the Inquire Group (MQCMD_INQUIRE_QSG) command consists of the response header followed by the QMgrName
structure and a number of other parameter structures. One such message is generated for each queue manager in the queue-sharing group.
HP Integrity NonStop Server | IBM® i | UNIX and Linux® | Windows | z/OS® |
---|---|---|---|---|
If there are any obsolete Db2® messages, and that information is requested, one message, identified by a value of MQCMDI_DB2_OBSOLETE_MSGS in the CommandInformation
parameter, is returned for each such message.
- Always returned for the queue manager:
CommandLevel
,DB2ConnectStatus
,DB2Name
,QmgrCPF
,QMgrName
,QmgrNumber
,QMgrStatus
,QSGName
- Always returned for obsolete Db2 messages:
CommandInformation
,CFMsgIdentifier
Response data relating to the queue manager
CommandLevel
(MQCFIN)- Command level supported by the queue manager (parameter identifier: MQIA_COMMAND_LEVEL).
The value can be any of the following values:
- MQCMDL_LEVEL_700
- Level 700 of system control commands.
- MQCMDL_LEVEL_701
- Level 701 of system control commands.
- MQCMDL_LEVEL_710
- Level 710 of system control commands.
- MQCMDL_LEVEL_800
- Level 800 of system control commands.
DB2ConnectStatus
(MQCFIN)- The current status of the connection to Db2 (parameter identifier: MQIACF_DB2_CONN_STATUS).
The current status of the queue manager. The value can be any of the following values:
- MQQSGS_ACTIVE
- The queue manager is running and is connected to Db2.
- MQQSGS_INACTIVE
- The queue manager is not running and is not connected to Db2.
- MQQSGS_FAILED
- The queue manager is running but not connected because Db2 has terminated abnormally.
- MQQSGS_PENDING
- The queue manager is running but not connected because Db2 has terminated normally.
- MQQSGS_UNKNOWN
- The status cannot be determined.
DB2Name
(MQCFST)- The name of the Db2 subsystem or group to which
the queue manager is to connect (parameter identifier: MQCACF_DB2_NAME).
The maximum length is MQ_DB2_NAME_LENGTH.
QMgrCPF
(MQCFST)- The command prefix of the queue manager (parameter identifier: MQCACF_Q_MGR_CPF).
The maximum length is MQ_Q_MGR_CPF_LENGTH.
QMgrName
(MQCFST)- Name of the queue manager (parameter identifier: MQCA_Q_MGR_NAME).
The maximum length is MQ_Q_MGR_NAME_LENGTH.
QmgrNumber
(MQCFIN)- The number, generated internally, of the queue manager in the group.(parameter identifier: MQIACF_Q_MGR_NUMBER).
QMgrStatus
(MQCFIN)- Recovery (parameter identifier: MQIACF_Q_MGR_STATUS).
The current status of the queue manager. The value can be any of the following values:
- MQQSGS_ACTIVE
- The queue manager is running.
- MQQSGS_INACTIVE
- The queue manager is not running, having terminated normally.
- MQQSGS_FAILED
- The queue manager is not running, having terminated abnormally.
- MQQSGS_CREATED
- The queue manager has been defined to the group, but has not yet been started.
- MQQSGS_UNKNOWN
- The status cannot be determined.
QSGName
(MQCFST)- The name of the queue sharing group (parameter identifier: MQCA_QSG_NAME).
The maximum length is MQ_QSG_NAME_LENGTH.
Response data relating to obsolete Db2 messages
CFMsgIdentifier
(MQCFBS)- CF list entry identifier (parameter identifier: MQBACF_CF_LEID).
The maximum length is MQ_CF_LEID_LENGTH.
CommandInformation
(MQCFIN)- Command information (parameter identifier: MQIACF_COMMAND_INFO). This indicates whether queue managers in the group contain obsolete messages. The value is MQCMDI_DB2_OBSOLETE_MSGS.