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.

For to run CSQUDSPM from USS, we 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, we 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

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


Syntax

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 we 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)

Parent topic: Use the IBM MQ utilities on z/OS


Related reference