Inquire Group (Response) on z/OS®
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.
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_520
- Level 520 of system control commands.
- MQCMDL_LEVEL_530
- Level 530 of system control commands.
- MQCMDL_LEVEL_531
- Level 531 of system control commands.
- MQCMDL_LEVEL_600
- Level 600 of system control commands.
- MQCMDL_LEVEL_700
- Level 700 of system control commands.
- MQCMDL_LEVEL_701
- Level 701 of system control commands.
- MQCMDL_LEVEL_750
- Level 750 of system control commands.
- MQCMDL_LEVEL_800
- Level 800 of system control commands.
- MQCMDL_LEVEL_801
- Level 801 of system control commands. Attention: MQCMDL_LEVEL_801 applies only to UNIX, when you install IBM MQ Version 8.0.0, Fix Pack 2.
- MQCMDL_LEVEL_802
- Level 802 of system control commands.
- MQCMDL_LEVEL_900
- Level 900 of system control commands.
- MQCMDL_LEVEL_901
- Level 901 of system control commands.
- MQCMDL_LEVEL_902
- Level 902 of system control commands.
- MQCMDL_LEVEL_903
- Level 903 of system control commands.
- MQCMDL_LEVEL_904
- Level 904 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_Q_MGR_CPF_LENGTH.
- QMgrCPF (MQCFST)
- The command prefix of the queue manager (parameter identifier: MQCA_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.