[z/OS]

Display queue manager information utility (CSQUDSPM)

CSQUDSPM displays information about queue managers and provides the equivalent function to dspmq on Multiplatforms.

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.

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 z/OS® UNIX System Services (z/OS UNIX), you can follow this procedure:

  1. Create an empty file in z/OS UNIX 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 z/OS UNIX.

Syntax

[MQ 9.3.0 Jul 2022]From IBM MQ for z/OS 9.2.4, all the parameters for this utility are case insensitive. For example:
dspmq -o status
is the same as
dspmq -O STATUS
Read syntax diagramSkip visual syntax diagram dspmq  -m QMgrName -s  -o all  -o status -su -a

Required parameters

None

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, in the format V.R.M. This is usually the same for all queue managers in the LPAR, as a single set of early code modules is loaded into the Link Pack Area (LPA) and should be used by all queue managers.

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)
RELTYPE The release type. The queue manager is running against a CD release if the value is CDR or against an LTS release if the value is LTSR.

In the case of a queue manager that has not been started since the last IPL of the LPAR, the release type of that queue manager cannot be obtained. In that situation, the RELTYPE attribute displays Unknown.

Examples

  1. Input:
    dspmq
    Output:
    
QMNAME(QM01) STATUS(Stopped)
QMNAME(QM02) STATUS(Running)
QMNAME(QM03) STATUS(Stopped)
QMNAME(QM04) STATUS(Running)
  2. Input:
    dspmq -o all
    Output:
    
QMNAME(QM01) STATUS(Stopped) INSTVER(0.0.0) ERLYVER(9.2.0) CMDPFX(!QM01) QSGNAME(Unknown) RELTYPE(Unknown)
QMNAME(QM02) STATUS(Running) INSTVER(9.2.0) ERLYVER(9.2.0) CMDPFX(!QM02) QSGNAME(QSG1) RELTYPE(LTSR)
QMNAME(QM03) STATUS(Stopped) INSTVER(9.2.0) ERLYVER(9.2.0) CMDPFX(!QM03) QSGNAME(Unknown) RELTYPE(CDR)
QMNAME(QM04) STATUS(Running) INSTVER(9.1.0) ERLYVER(9.2.0) CMDPFX(!QM04) QSGNAME() RELTYPE(LTSR)
  3. Input:
    dspmq -o all -su
    Output:
    
QMNAME(QM02) STATUS(Running) INSTVER(9.2.0) ERLYVER(9.2.0) CMDPFX(!QM02) QSGNAME(QSG1) RELTYPE(LTSR)
QMNAME(QM03) STATUS(Stopped) INSTVER(9.2.0) ERLYVER(9.2.0) CMDPFX(!QM03) QSGNAME(Unknown) RELTYPE(CDR)
QMNAME(QM04) STATUS(Running) INSTVER(9.1.0) ERLYVER(9.2.0) CMDPFX(!QM04) QSGNAME() RELTYPE(LTSR)