Inquire Namelist (Response)

The response to the Inquire Namelist (MQCMD_INQUIRE_NAMELIST) command consists of the response header followed by the NamelistName structure and the requested combination of attribute parameter structures.

If a generic namelist name was specified, one such message is generated for each namelist found.

    Always returned:
    NamelistName , QSGDisposition

    Returned if requested:
    AlterationDate , AlterationTime , NameCount , NamelistDesc , NamelistType , Names


Response data

    AlterationDate (MQCFST)
    Alteration date (parameter identifier: MQCA_ALTERATION_DATE).

    The date when the information was last altered, in the form yyyy-mm-dd.

    AlterationTime (MQCFST)
    Alteration time (parameter identifier: MQCA_ALTERATION_TIME).

    The time when the information was last altered, in the form hh.mm.ss.

    NameCount (MQCFIN)
    Number of names in the namelist (parameter identifier: MQIA_NAME_COUNT).

    The number of names contained in the namelist.

    NamelistDesc (MQCFST)
    Description of namelist definition (parameter identifier: MQCA_NAMELIST_DESC).

    The maximum length of the string is MQ_NAMELIST_DESC_LENGTH.

    NamelistName (MQCFST)
    The name of the namelist definition (parameter identifier: MQCA_NAMELIST_NAME).

    The maximum length of the string is MQ_NAMELIST_NAME_LENGTH.

    NamelistType (MQCFIN)
    Type of names in the namelist (parameter identifier: MQIA_NAMELIST_TYPE). This parameter applies to z/OS only. Specifies the type of names in the namelist. The value can be any of the following values:

      MQNT_NONE
      The names are of no particular type.

      MQNT_Q
      A namelist that holds a list of queue names.

      MQNT_CLUSTER
      A namelist that is associated with clustering, containing a list of the cluster names.

      MQNT_AUTH_INFO
      The namelist is associated with TLS, and contains a list of authentication information object names.

    Names (MQCFSL)
    A list of the names contained in the namelist (parameter identifier: MQCA_NAMES).

    The number of names in the list is given by the Count field in the MQCFSL structure. The length of each name is given by the StringLength field in that structure. The maximum length of a name is MQ_OBJECT_NAME_LENGTH.

    QSGDisposition (MQCFIN)
    QSG disposition (parameter identifier: MQIA_QSG_DISP). Specifies the disposition of the object (that is, where it is defined and how it behaves). This parameter applies only to z/OS. The value can be any of the following values:

      MQQSGD_COPY
      The object is defined as MQQSGD_COPY.

      MQQSGD_GROUP
      The object is defined as MQQSGD_GROUP.

      MQQSGD_Q_MGR
      The object is defined as MQQSGD_Q_MGR.

Parent topic: Definitions of the Programmable Command Formats