Home

 

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.

Most parameters are relevant only for queues of a particular type or types. Parameters that are not relevant for a particular type of queue cause no output, nor is an error raised.

Table 1 shows the parameters that are relevant for each type of queue. There is a brief description of each parameter after the table, but for more information, see the DEFINE command for each queue type.

Parameters that can be returned by the DISPLAY QUEUE command
  Local queue Model queue Alias queue Remote queue Cluster queue
ACCTQ X X      
ALTDATE X X X X X
ALTTIME X X X X X
BOQNAME X X      
BOTHRESH X X      
CFSTRUCT X X      
CLUSDATE         X
CLUSNL X   X X  
CLUSQMGR         X
CLUSQT         X
CLUSTER X   X X X
CLUSTIME         X
CLWLPRTY X   X X X
CLWLRANK X   X X X
CLWLUSEQ X        
CRDATE X X      
CRTIME X X      
CURDEPTH X        
DEFBIND X   X X X
DEFPRTY X X X X X
DEFPSIST X X X X X
DEFSOPT X X      
DEFTYPE X X      
DESCR X X X X X
DISTL X X      
GET X X X    
HARDENBO X X      
INDXTYPE X X      
INITQ X X      
IPPROCS X        
MAXDEPTH X X      
MAXMSGL X X      
MONQ X X      
MSGDLVSQ X X      
NPMCLASS X X      
OPPROCS X        
PROCESS X X      
PSID X        
PUT X X X X X
QDEPTHHI X X      
QDEPTHLO X X      
QDPHIEV X X      
QDPLOEV X X      
QDPMAXEV X X      
QMID         X
QSGDISP X X X X X
QSVCIEV X X      
QSVCINT X X      
QTYPE X X X X X
RETINTVL X X      
RNAME       X  
RQMNAME       X  
SCOPE X   X X  
SHARE X X      
STATQ X X      
STGCLASS X X      
TARGQ     X    
TPIPE X        
TRIGDATA X X      
TRIGDPTH X X      
TRIGGER X X      
TRIGMPRI X X      
TRIGTYPE X X      
USAGE X X      
XMITQ       X  

ACCTQ

Whether accounting (on z/OS, thread-level and queue-level accounting) data collection is to be enabled for the queue.

ALTDATE

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

ALTTIME

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

BOQNAME

Backout requeue name.

BOTHRESH

Backout threshold.

CLUSDATE

The date on which the definition became available to the local queue manager, in the form yyyy-mm-dd.

CLUSNL

The namelist that defies the cluster that the queue is in.

CLUSQMGR

The name of the queue manager that hosts the queue.

CLUSQT

Cluster queue type. This can be:

QALIAS

The cluster queue represents an alias queue.

QLOCAL

The cluster queue represents a local queue.

QMGR

The cluster queue represents a queue manager alias.

QREMOTE

The cluster queue represents a remote queue.

CLUSTER

The name of the cluster that the queue is in.

CLUSTIME

The time at which the definition became available to the local queue manager, in the form hh.mm.ss.

CLWLPRTY

The priority of the queue for the purposes of cluster workload distribution.

CLWLRANK

The rank of the queue for the purposes of cluster workload distribution.

CLWLUSEQ

Whether puts are allowed to other queue definitions apart from local ones.

CRDATE

The date on which the queue was defined (in the form yyyy-mm-dd).

CRTIME

The time at which the queue was defined (in the form hh.mm.ss).

CURDEPTH

Current depth of queue.

On z/OS, CURDEPTH is returned as zero for queues defined with a disposition of GROUP. It is also returned as zero for queues defined with a disposition of SHARED if the CF structure that they use is unavailable or has failed.

DEFBIND

Default message binding.

DEFPRTY

Default priority of the messages put on the queue.

DEFPSIST

Whether the default persistence of messages put on this queue is set to NO or YES. NO means that messages are lost across a restart of the queue manager.

DEFSOPT

Default share option on a queue opened for input.

DEFTYPE

Queue definition type. This can be:

  • PREDEFINED (Predefined)

    The queue was created with a DEFINE command, either by an operator or by a suitably authorized application sending a command message to the service queue.

  • PERMDYN (Permanent dynamic)

    Either the queue was created by an application issuing MQOPEN with the name of a model queue specified in the object descriptor (MQOD), or (if this is a model queue) this determines the type of dynamic queue that can be created from it.

    On z/OS the queue was created with QSGDISP(QMGR).

  • TEMPDYN (Temporary dynamic)

    Either the queue was created by an application issuing MQOPEN with the name of a model queue specified in the object descriptor (MQOD), or (if this is a model queue) this determines the type of dynamic queue that can be created from it.

    On z/OS the queue was created with QSGDISP(QMGR).

  • SHAREDYN

    A permanent dynamic queue was created when an application issued an MQOPEN API call with the name of this model queue specified in the object descriptor (MQOD).

    On z/OS, in a queue-sharing group environment, the queue was created with QSGDISP(SHARED).

DESCR

Descriptive comment.

DISTL

Whether distribution lists are supported by the partner queue manager. (Supported only on AIX, HP OpenVMS, HP-UX, Linux, i5/OS, Solaris, and Windows.)

GET

Whether the queue is enabled for gets.

HARDENBO

Whether to harden the get back out count.

On MQSeries for Compaq NonStop Kernel, this parameter is ignored. The backout count of a message is always hardened for persistent messages, and never hardened for non-persistent messages.

INDXTYPE

Index type (supported only on z/OS).

INITQ

Initiation queue name.

IPPROCS

Number of handles indicating that the queue is open for input.

On z/OS, IPPROCS is returned as zero for queues defined with a disposition of GROUP. With a disposition of SHARED, only the handles for the queue manager sending back the information are returned, not the information for the whole group.

MAXDEPTH

Maximum depth of queue.

MAXMSGL

Maximum message length.

MONQ

Online monitoring data collection.

MSGDLVSQ

Message delivery sequence.

NPMCLASS

Level of reliability assigned to non-persistent messages that are put to the queue.

OPPROCS

Number of handles indicating that the queue is open for output.

On z/OS, OPPROCS is returned as zero for queues defined with a disposition of GROUP. With a disposition of SHARED, only the handles for the queue manager sending back the information are returned, not the information for the whole group.

PROCESS

Process name.

PUT

Whether the queue is enabled for puts.

QDEPTHHI

Queue Depth High event generation threshold.

QDEPTHLO

Queue Depth Low event generation threshold.

QDPHIEV

Whether Queue Depth High events are generated.

We cannot use QDPHIEV as a filter keyword.

QDPLOEV

Whether Queue Depth Low events are generated.

We cannot use QDPLOEV as a filter keyword.

QDPMAXEV

Whether Queue Full events are generated.

We cannot use QDPMAXEV as a filter keyword.

QMID

The internally generated unique name of the queue manager that hosts the queue.

QSVCIEV

Whether service interval events are generated.

We cannot use QSVCIEV as a filter keyword.

QSVCINT

Service interval event generation threshold.

QTYPE

Queue type.

On AIX, HP OpenVMS, HP-UX, Linux, i5/OS, Solaris, Windows, and z/OS, the queue type is always displayed.

On AIX, HP OpenVMS, HP-UX, Linux, i5/OS, Solaris, and Windows, TYPE(type) can be used as a synonym for this parameter.

RETINTVL

Retention interval.

RNAME

Name of the local queue, as known by the remote queue manager.

RQMNAME

Remote queue manager name.

SCOPE

Scope of queue definition (not supported on z/OS).

SHARE

Whether the queue can be shared.

STATQ

Whether statistics data information is to be collected.

STGCLASS

Storage class.

TARGQ

Local name of aliased queue.

TPIPE

The TPIPE names used for communication with OTMA via the WebSphere MQ IMS™ bridge if the bridge is active. This parameter is supported only on z/OS.

TRIGDATA

Trigger data.

TRIGDPTH

Trigger depth.

TRIGGER

Whether triggers are active.

TRIGMPRI

Threshold message priority for triggers.

TRIGTYPE

Trigger type.

USAGE

Whether or not the queue is a transmission queue.

XMITQ

Transmission queue name.
For more details of these parameters, see DEFINE queues.

 

Parent topic:

Parameter descriptions


sc12320_


 

Home