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