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.

Parent topic: Definitions of the Programmable Command Formats