Display queue manager information utility (CSQUDSPM)

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


Purpose

We 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, 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, 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

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


    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.0.1) CMDPFX(!QM01) QSGNAME(Unknown)
QMNAME(QM02) STATUS(Running) INSTVER(9.0.1) ERLYVER(9.0.1) CMDPFX(!QM02) QSGNAME(QSG1)
QMNAME(QM03) STATUS(Stopped) INSTVER(9.0.1) ERLYVER(9.0.1) CMDPFX(!QM03) QSGNAME(Unknown)
QMNAME(QM04) STATUS(Running) INSTVER(9.0.1) ERLYVER(9.0.1) CMDPFX(!QM04) QSGNAME()
    3. Input:
      dspmq -o all -su
      Output:
      QMNAME(QM02) STATUS(Running) INSTVER(9.0.1) ERLYVER(9.0.1) CMDPFX(!QM02) QSGNAME(QSG1)
QMNAME(QM03) STATUS(Stopped) INSTVER(9.0.1) ERLYVER(9.0.1) CMDPFX(!QM03) QSGNAME(Unknown)
QMNAME(QM04) STATUS(Running) INSTVER(9.0.1) ERLYVER(9.0.1) CMDPFX(!QM04) QSGNAME()