RESOLVE INDOUBT

Use RESOLVE INDOUBT to resolve threads left in doubt because WebSphere MQ or a transaction manager could not resolve them automatically.

Note:
This command does not apply to units of recovery associated with batch or TSO applications, unless you are using the RRS adapter.

Synonym: RES IND 

RESOLVE INDOUBT
 
>>-RESOLVE INDOUBT(connection-name)--ACTION(-+-COMMIT--+-)------>
                                             '-BACKOUT-'
 
                              .-CMDSCOPE(' ')------------.
>--NID(-+-*--------------+-)--+--------------------------+------>
        | .-,----------. |    |                     (1)  |
        | V            | |    '-CMDSCOPE(qmgr-name)------'
        '---network-id-+-'
 
>--+--------------+--------------------------------------------><
   '-QMNAME(qmgr)-'

Notes:

  1. 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)
1 through 8 character connection name.

  • For a CICS connection it is the CICS applid.

  • For an IMS adaptor connection, it is the IMS control region job name.

  • For an IMS bridge connection, it is the WebSphere MQ queue manager name.

  • For an RRS connection, it is RRSBATCH.

ACTION
Specifies whether to commit or back out the in-doubt threads:

COMMIT
Commits the threads

BACKOUT
Backs out the threads

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.

NID
Network identifier. Specifies the thread or threads to be resolved.

(network-id)
This is as returned by the DISPLAY THREAD command, and is of the form net-node.net-urid, where:

  • net-node identifies the originator of the thread, except RRSBATCH where it is omitted.

  • net-urid is the hexadecimal number assigned to the unit of recovery by the originating system for the specific thread to be resolved.

When net-node is present there must be a period (.) between it and net-urid.

(*)
Resolves all threads associated with the connection.

QMNAME
Specifies that if the designated queue manager is INACTIVE, WebSphere MQ should search information held in the coupling facility about units of work, performed by the indicated queue manager, that match the connection name and network identifier.

Matching units of work are either committed or backed out according to the ACTION specified.

Only the shared portion of the unit of work are resolved by this command.

As the queue manager is necessarily inactive, local messages are unaffected and remain locked until the queue manager restarts, or after restarting, connects with the transaction manager.

Examples: 



RESOLVE INDOUBT(CICSA) ACTION(COMMIT) NID(CICSA.ABCDEF0123456789)
RESOLVE INDOUBT(CICSA) ACTION(BACKOUT) NID(*)

 

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.