Display queue manager information utility (CSQUDSPM)

Purpose

You use the CSQUDSPM utility to list all IBM® MQ subsystems on the LPAR, regardless of what version of IBM MQ they are associated with. You do this by searching for IBM MQ subsystems in the z/OS® SSCT (Subsystem Communications Table).

Sample JCL, CSQ4DSPM, is provided for this purpose. The JCL is in the SCSQPROC data set.

Packaging

The CSQUDSPM load module is provided in the SCSQAUTH data set with an alias called DSPMQ.

If you need to run CSQUDSPM from USS, you can follow this procedure:

1. Create an empty file in USS with the name csqudspm or dspmq. For example, issue the following command:

   touch dspmq

2. Set the file permissions so that it is executable:

   chmod 755 dspmq

3. Enable the sticky bit:

   chmod +t dspmq

4. Set the APF authorized attribute:

   extattr +a dspmq

   To be authorized to issue the extattr command with the +a option, you must have at least read access to the BPX.FILEATTR.APF resource in the FACILITY class profile.
5. Ensure that the SCSQAUTH library is in the STEPLIB environment variable, and that all libraries in the STEPLIB concatenation are APF authorized. For example, to set the STEPLIB concatenation to contain the SCSQANLE and SCSQAUTH libraries, issue the following command:

   export STEPLIB=thqual.SCSQANLE:thqual.SCSQAUTH

You can now execute the file you created to run CSQUDSPM from USS.

Required parameters

Optional parameters

-a

Displays information about running queue managers only.

-m QMgrName

The queue manager for which to display details. If you do not specify a name, all queue managers on the LPAR are displayed.

-s

The operational status of the queue managers is displayed. This parameter is the default status setting.

The parameter -o status is equivalent to -s.

-o all

All details about the queue manager, or queue managers, are displayed.

-o status

The operational status of the queue managers is displayed.

-su

Suppress information about queue managers whose version is unknown.

An unknown version displays an INSTVER V.R.M of 0.0.0.

Command output

Output name	Details
QMNAME	The name of the queue manager consisting of up to four characters. If the queue manager name is less than four characters the string is not padded. This parameter is always output. Examples: QMNAME(MQ21), QMNAME(MQ1)
STATUS	The status of the queue manager. Either Running or Stopped. This parameter is always output. Examples: STATUS(Running), STATUS(Stopped)
INSTVER	The version that the queue manager was last started up with, in the format V.R.M. Note: In the case of a queue manager that has not been started since the last IPL of the LPAR, the version of that queue manager cannot be obtained. In that situation, the INSTVER attribute displays a V.R.M of 0.0.0. Examples: INSTVER(8.0.0), INSTVER(9.0.1)
ERLYVER	The version of early code associated with the queue manager. This should be the same for all queue managers in the LPAR in the format V.R.M. Examples: ERLYVER(9.0.1)
CMDPFX	The command prefix for the queue manager subsystem. This can be from one to eight characters long, and is not padded. Examples: CMDPFX(!MQ21), CMDPFX(MQ90ATST)
QSGNAME	The name of the queue sharing group, that the queue manager is a member of, consisting of up to four characters. If the queue manager name is less than four characters the string is not padded. This parameter is always output. If the queue manager is not a member of a queue sharing group then QSGNAME() is displayed. QSGNAME information can only be obtained when the queue manager is running, that is, STATUS(Running). If the queue manager is stopped QSGNAME(Unknown) is displayed. Example: QSGNAME(QSG1)