DISPLAY QMGR

Use DISPLAY QMGR to display the queue manager parameters for this queue manager.

Synonym: DIS QMGR 

DISPLAY QMGR.
 
                          .-CMDSCOPE(' ')------------. (5)
>>-DISPLAY QMGR--+-----+--+--------------------------+---------->
                 '-ALL-'  |                     (6)  |
                          +-CMDSCOPE(qmgr-name)------+
                          |             (6)          |
                          '-CMDSCOPE(*)--------------'
 
>--+---------------------+-------------------------------------><
   '-| requested attrs |-'
 
Requested attrs
 
|--+-----------------------+------------------------------------|
   | .-,-----------------. |
   | V           (1)     | |
   '---+-ALTDATE-------+-+-'
       |         (1)   |
       +-ALTTIME-------+
       +-AUTHOREV------+
       +-CCSID---------+
       |      (2)      |
       +-CHAD----------+
       |        (2)    |
       +-CHADEV--------+
       |          (1)  |
       +-CHADEXIT------+
       |          (1)  |
       +-CLWLEXIT------+
       |          (1)  |
       +-CLWLDATA------+
       |         (1)   |
       +-CLWLLEN-------+
       +-CMDLEVEL------+
       +-COMMANDQ------+
       |          (5)  |
       +-CONFIGEV------+
       |          (5)  |
       +-CPILEVEL------+
       +-DEADQ---------+
       +-DEFXMITQ------+
       +-DESCR---------+
       |       (2)     |
       +-DISTL---------+
       |          (5)  |
       +-EXPRYINT------+
       |     (5)       |
       +-IGQ-----------+
       |        (5)    |
       +-IGQAUT--------+
       |         (5)   |
       +-IGQUSER-------+
       +-INHIBTEV------+
       +-LOCALEV-------+
       +-MAXHANDS------+
       +-MAXMSGL-------+
       +-MAXPRTY-------+
       +-MAXUMSGS------+
       +-PERFMEV-------+
       +-PLATFORM------+
       |      (1)      |
       +-QMID----------+
       +-QMNAME--------+
       |         (5)   |
       +-QSGNAME-------+
       +-REMOTEEV------+
       |       (1)     |
       +-REPOS---------+
       |         (1)   |
       +-REPOSNL-------+
       |          (3)  |
       +-SSLCRLNL------+
       |         (4)   |
       +-SSLCRYP-------+
       |         (3)   |
       +-SSLKEYR-------+
       |          (5)  |
       +-SSLTASKS------+
       +-STRSTPEV------+
       +-SYNCPT--------+
       '-TRIGINT-------'

Notes:

  1. Valid only on AIX, Compaq OpenVMS, HP-UX, Linux, OS/2 Warp, OS/400, Solaris, Windows, and z/OS.

  2. Valid only on AIX, Compaq OpenVMS, HP-UX, Linux, OS/2 Warp, OS/400, Solaris, and Windows.

  3. Valid only on AIX, HP-UX, Linux, OS/400, Solaris, Windows, and z/OS.

  4. Valid only on AIX, HP-UX, Linux, and Solaris.

  5. Valid only on z/OS.

  6. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

 

Parameter descriptions

ALL
Specify this to display all the parameters. If this parameter is specified, any parameters that are requested specifically have no effect; all parameters are still displayed.

On AIX, Compaq OpenVMS, HP-UX, Linux, OS/2 Warp, OS/400, Solaris, and Windows, this is the default if you do not request any specific parameters.

CMDSCOPE
This parameter applies to z/OS only and specifies how the command is executed when the queue manager is a member of a queue-sharing group.

CMDSCOPE must be blank, or the local queue manager, if QSGDISP is set to GROUP or SHARED.

' '
The command is executed on the queue manager on which it was entered. This is the default value.

qmgr-name
The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.

You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.

*
The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group. The effect of this is the same as entering the command on every queue manager in the queue-sharing group.

 

Requested parameters

Specify one or more parameters that define the data to be displayed. The parameters can be specified in any order, but do not specify the same parameter more than once.

Note:
If no parameters are specified (and the ALL parameter is not specified or defaulted), the queue manager name is returned.

You can request the following information for the queue manager:

ALTDATE
The date on which the definition was last altered, in the form yyyy-mm-dd.

ALTTIME
The time at which the definition was last altered, in the form hh.mm.ss.

AUTHOREV
Whether authorization events are generated.

CCSID
Coded character set identifier. This applies to all character string fields defined by the application programming interface (API), including the names of objects, and the creation date and time of each queue. It does not apply to application data carried as the text of messages.

CHAD
Whether auto-definition of receiver and server-connection channels is enabled.

CHADEV
Whether auto-definition events are enabled.

CHADEXIT
The name of the channel auto-definition exit.

CLWLEXIT
The name of the cluster workload exit.

CLWLDATA
The data passed to the cluster workload exit.

CLWLLEN
The maximum number of bytes of message data that is passed to the cluster workload exit.

CMDLEVEL
Command level. This indicates the function level of the queue manager.

COMMANDQ
The name of the system-command input queue. Suitably authorized applications can put commands on this queue.

CONFIGEV
Whether configuration events are generated.

CPILEVEL
Reserved, this value has no significance.

DEADQ
The name of the queue to which messages are sent if they cannot be routed to their correct destination (the dead-letter queue or undelivered-message queue). The default is blanks.

For example, messages are put on this queue when:

  • A message arrives at a queue manager, destined for a queue that is not yet defined on that queue manager

  • A message arrives at a queue manager, but the queue for which it is destined cannot receive it because, possibly:

    • The queue is full
    • The queue is inhibited for puts
    • The sending node does not have authority to put the message on the queue

  • An exception message needs to be generated, but the queue named is not known to that queue manager

Messages that have passed their expiry time are not transferred to this queue when they are discarded.

If the dead-letter queue is not defined, or full, or unusable for some other reason, a message that would have been transferred to it by a message channel agent is retained instead on the transmission queue.

If a dead-letter queue or undelivered-message queue is not specified, all blanks are returned for this parameter.

DEFXMITQ
Default transmission queue name. This is the transmission queue on which messages, destined for a remote queue manager, are put if there is no other suitable transmission queue defined.

DESCR
Description.

DISTL
Whether distribution lists are supported by the queue manager.

EXPRYINT
On z/OS only, the approximate interval between scans for expired messages.

IGQ
On z/OS only, whether intra-group queuing is to be used.

IGQAUT
On z/OS only, displays the type of authority checking used by the intra-group queuing agent.

IGQUSER
On z/OS only, displays the user ID used by the intra-group queuing agent.

INHIBTEV
Whether inhibit events are generated.

LOCALEV
Whether local error events are generated.

MAXHANDS
The maximum number of open handles that any one task can have at any one time.

Note:
On MQSeries for Compaq NonStop Kernel, this parameter is ignored.

MAXMSGL
The maximum message length that can be handled by the queue manager. Individual queues or channels might have a smaller maximum than this.

MAXPRTY
The maximum priority. This is 9.

MAXUMSGS
Maximum number of uncommitted messages within one syncpoint.

Note:
On MQSeries for Compaq NonStop Kernel, this parameter is ignored.

PERFMEV
Whether performance-related events are generated.

PLATFORM
The architecture of the platform on which the queue manager is running. This is MVS (for z/OS platforms), OPENVMS, NSK, OS2, OS400, UNIX, or WINDOWSNT.

QMID
The internally generated unique name of the queue manager.

QMNAME
The name of the local queue manager. See Rules for naming WebSphere MQ objects.

QSGNAME
The name of the queue-sharing group to which the queue manager belongs, or blank if the queue manager is not a member of a queue-sharing group. You can use queue-sharing groups only on WebSphere MQ for z/OS.

REMOTEEV
Whether remote error events are generated.

REPOS
The name of a cluster for which this queue manager is to provide a repository manager service.

REPOSNL
The name of a list of clusters for which this queue manager is to provide a repository manager service.

SSLCRLNL(nlname)
Indicates the namelist of AUTHINFO objects being used for the queue manager for CRL checking.

SSLCRYP(string)
Indicates the name of the parameter string being used to configure the cryptographic hardware present on the system. Note that the PKCS #11 password appears as xxxxxx.

SSLKEYR(string)
Indicates the name of the SSL key repository.

SSLTASKS(integer)
On z/OS only, indicates the number of server subtasks to use for processing SSL calls.

STRSTPEV
Whether start and stop events are generated.

SYNCPT
Whether syncpoint support is available with the queue manager. On Compaq OpenVMS, Linux, OS/2 Warp, OS/400, UNIX systems, Windows, and z/OS, it is always available.

TRIGINT
The trigger interval.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.