DISPLAY THREAD (display thread information) on z/OS

Using MQSC commands

For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.

Usage notes

Threads shown as in doubt on one invocation of this command will probably be resolved for subsequent invocations.

This command is retained for compatibility with earlier release of IBM® MQ. It has been superseded by the DISPLAY CONN command which is preferable to use.

Parameter descriptions for DISPLAY THREAD

(connection-name)

List of one or more connection-name s (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 for all RRSBATCH-type connections, or the batch job name

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

(*)

Displays threads associated with all connections to IBM MQ.

CMDSCOPE

This parameter specifies how the command runs when the queue manager is a member of a queue sharing group.

' '

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

qmgr-name

The command runs 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 runs 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 IBM 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 IBM 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 IBM 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 IBM 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 Recovering units of recovery on another queue manager in the queue sharing group. Also, see messages CSQV401I through CSQV406I, and CSQV432I, in Agent services messages (CSQV...).