Script (MQSC) Command Reference: DISPLAY THREAD

DISPLAY THREAD

Use DISPLAY THREAD to display information about active and in-doubt threads. Threads shown as in doubt on one invocation of this command will probably be resolved for subsequent invocations.
Synonym: DIS THD
DISPLAY THREAD
 
>>-DISPLAY THREAD(-+-*-------------------+-)-------------------->
                   | .-,---------------. |
                   | V                 | |
                   '---connection-name-+-'
 
   .-CMDSCOPE(' ')------------.
>--+--------------------------+--+------------------+----------->
   |                     (1)  |  '---QMNAME(qmgr)---'
   +-CMDSCOPE(qmgr-name)------+
   |             (1)          |
   '-CMDSCOPE(*)--------------'
 
   .-TYPE(ACTIVE)--------.
>--+---------------------+-------------------------------------><
   '-TYPE(-+-INDOUBT-+-)-'
           +-REGIONS-+
           '-*-------'
 
 
Notes:

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

Parameter descriptions

(connection-name)

List of one or more connection-names (of 1 through 8 characters each).

For batch connections, this name is the batch job name
For CICS connections, this name is the CICS applid
For IMS connections, this name is the IMS job name
For TSO connections, this name is the TSO user ID
For RRS connections, this is RRSBATCH

Threads are selected from the address spaces associated with these connections only.

(*)

Displays threads associated with all connections to WebSphere MQ.

CMDSCOPE

This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.
CMDSCOPE cannot be used for commands issued from the first initialization input data set CSQINP1.

' '

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.

TYPE

The type of thread to display. This parameter is optional.

ACTIVE

Display only active threads.
An active thread is one for which a unit of recovery has started but not completed. Resources are held in WebSphere MQ on its behalf.
This is the default if TYPE is omitted.

INDOUBT

Display only in-doubt threads.
An in-doubt thread is one that is in the second phase of the two-phase commit operation. Resources are held in WebSphere MQ on its behalf. External intervention is needed to resolve the status of in-doubt threads. You might only have to start the recovery coordinator (CICS, IMS, or RRS), or you might need to do more. They might have been in doubt at the last restart, or they might have become in doubt since the last restart.

REGIONS

Display a summary of active threads for each active connection.

Note:

Threads used internally by WebSphere MQ are excluded.

*

Display both active and in-doubt threads, but not regions.
If, during command processing, an active thread becomes in doubt, it might appear twice: once as active and once as in doubt.

QMNAME

Specifies that WebSphere MQ should check whether the designated queue manager is INACTIVE, and if so, report any shared units of work that were in progress on the designated and inactive queue manager.
This option is valid only for TYPE(INDOUBT).

For more information about the DISPLAY THREAD command and in-doubt recovery, see the WebSphere MQ for z/OS System Administration Guide. Also, see messages CSQV401I through CSQV406I, and CSQV432I, in the WebSphere MQ for z/OS Messages and Codes manual.

Note:

This command is issued internally by WebSphere MQ when taking a checkpoint, and when the queue manager is starting and stopping, so that a list of threads that are in doubt at the time is written to the z/OS console log.

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.