INQUIRE MQINI
Inquire on the name of the default initiation queue to be used for the connection between CICS® and WebSphere® MQ.
Description
The INQUIRE MQINI command inquires on the name of the default initiation queue used for the connection between CICS and WebSphere MQ.
The MQINI resource represents the default initiation queue. MQINI is an implicit resource that exists when you install an MQCONN resource definition in the CICS region with the INITQNAME attribute specified. (Only one MQCONN resource definition can be installed at a time.) The name of the MQINI resource is DFHMQINI. You must specify this resource name on the command.
If you want to change the MQINI resource definition, you must reinstall the MQCONN resource definition with an appropriate MQINI attribute.
The resource signature
You can use this command to retrieve the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are BUNDLE, CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.
Options
- CHANGEAGENT(cvda)
- Returns a CVDA value that identifies the agent that made the last
change to the resource definition. The possible values are as follows:
- AUTOINSTALL
- The resource was autoinstalled as a result of specifying an initiation queue name on a CKQC START command, and the previously installed MQCONN definition did not specify a value for INITQNAME.
- DYNAMIC
- The resource was defined as a result of an MQCONN resource definition with INITQNAME specified.
- CHANGEAGREL(data-area)
- Returns a 4-digit number of the CICS release that was running when the resource definition was last changed.
- CHANGETIME(data-area)
- Returns an ABSTIME value that represents the time stamp when the resource definition was last changed. For more information about the format of the ABSTIME value, see FORMATTIME.
- CHANGEUSRID(data-area)
- Returns the 8-character user ID that ran the change agent.
- DEFINESOURCE(data-area)
- Returns the 8-character source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT value. For more information, see Summary of the resource signature field values.
- DEFINETIME(data-area)
- Returns an ABSTIME value that represents the time stamp when the resource definition was created.
- INITQNAME(data-area)
- Returns the 1- to 48-character name of the default initiation queue that is represented by the MQINI resource.
- INSTALLAGENT(cvda)
- Returns a CVDA value that identifies the agent that installed
the resource. The possible values are as follows:
- AUTOINSTALL
- The resource was autoinstalled as a result of specifying an initiation queue name on a CKQC START command, and the previously installed MQCONN definition did not specify a value for INITQNAME.
- DYNAMIC
- The resource was installed as a result of the installation of an MQCONN with INITQNAME specified.
- INSTALLTIME(data-area)
- Returns an ABSTIME value that represents the time stamp when the resource was installed.
- INSTALLUSRID(data-area)
- Returns the 8-character user ID that installed the resource.
Conditions
- NOTFND
- RESP2 values:
- 1
- The MQCONN resource definition that implies the MQINI resource cannot be found.
- NOTAUTH
- RESP2 values:
- 100
- Command authorization failure.