Cancel Thread

Use this panel to cancel an individual Db2 thread.

 
________________ ZTCANT   VTM     O2       V550.#P SN12 11/04/13 17:55:42   2 
> Help PF1                                                            Back PF3 
                                                                               
>       THREAD INFORMATION:  Enter a selection letter on the top line.         
                                                                               
> A-THREAD DETAIL B-LOCK COUNTS C-LOCK WAITS     D-LOCKS OWNED  E-GLOBAL LOCKS 
> F-CURRENT SQL   G-SQL COUNTS  H-DISTRIBUTED    I-BUFFER POOL  J-GROUP BP     
> K-PACKAGES      L-RES LIMIT   M-PARALLEL TASKS N-UTILITY      O-OBJECTS      
> *-CANCEL THREAD Q-DB2 CONSOLE R-DSN ACTIVITY   S-APPL TRACE   T-ENCLAVE      
> U-LONG NAMES                  W-ACCEL ACTIVITY                               
===============================================================================
>                                CANCEL THREAD                                 
 PLAN                                                                          
+ Thread:  Plan=ADB       Connid=TSO      Corrid=MIS1         Authid=MIS1      
+ Attach:  TSO            Userid=MIS1                         Region asid= 170 
+ Package: ADB2GET                        Collection=ADBL                      
+ Luwid=DEIBMIPS.IPSATN12.CC36D0A6558D=6117                                    
 tcmd                                                                          
+    Press ENTER to CANCEL the thread with Token=006117                        
+    Press PF3 to terminate the CANCEL request.                                
===============================================================================

Highlighting

The following table shows the field that might be highlighted in the panel above to indicate that an exception that is related to this field exceeded its threshold value:

Table 1. Highlighted fields in Cancel Thread panel.
This table shows the field and the exception this field is related to. It also shows the reason for the exception.
Field	Exception	Reason
Plan	Any	Same as other thread detail panels.

Navigation

For additional information about

related topics, select one of the options on the top of the panel.
other topics, use the PF keys.

Fields

Thread identifier: This information identifies the thread to which the information in this panel applies.

Plan: The Db2 plan name of the active thread.
Connid: The Db2 connection identifier of the active thread.
Corrid: The Db2 correlation identifier of the active thread. If the correlation is not set, N/A is displayed.
Authid: The Db2 authorization identifier of the active thread.
Attach: Depending on the type of connection, the appropriate information is displayed.; Attach information is displayed only if the thread is a distributed allied thread (not for distributed database access threads).

Connection Type

Batch

The MVS™ jobname and ASID.

Note: For threads from remote Db2, the MVS job name is N/A.

CICS®

The CICS jobname, task name, task number, terminal ID, and thread type. The thread type is:

Pool: The thread in use is a pool thread.
Entry: The thread in use is a nonprotected entry thread.
Prot: The thread in use is a protected thread. Protected threads are defined in an RCT entry definition using the THRDS operand.

IMS

The IMS region number, transaction name, region name, and terminal ID (LTERM).

RRSAF

The MVS job name and ASID.

Note: For threads from remote Db2, the MVS job name is N/A.

System

The originating Db2 job name and the resource manager that is the source of the thread. An additional line below the Attach line identifies the user thread, if any, being served by the system thread.

TSO

The TSO user ID and region ASID.

Utility

No additional information.

Db2

The Db2 subsystem identifier.

MVS

The MVS system identifier.

ORIGAUTH

The original (primary) Db2 authorization identifier of the thread. This field displays only when the original identifier is different from the Authid.

Package identifier: This information identifies the package to which the information in this panel applies.

Package: The Db2 package name of the active thread. Up to 18 characters of the package name are returned.
Collection: The package collection identifier. This field is displayed only if a package is being used.

Distributed thread identifier: The following fields are displayed if the thread has a distributed relationship with a remote Db2 subsystem.

Type

The distributed thread type.

Distributed Allied: A requesting thread; one that has issued an SQL call to a remote Db2 location.
Database Access: A responding thread; one that is serving a remote Db2 location by responding to an SQL call.

Db2=

The Db2 subsystem ID, indicating the member of the data sharing group of this thread.

Luwid

This value consists of two parts: the logical unit of work ID (luw-id) and a token. The token can be used in place of the luw-id in any Db2 command that accepts luw-id as input. Format:

luw-id=token

The luw-id consists of the network name, the originating VTAM® LUNAME, and a unique identifier (separated by periods). Thus, the Luwid field displays data like in the following example:

USCACO01.O2D22A.A1FE8E04B9D4=8

System

The originating Db2 job name and the resource manager that is the source of the thread. An additional line below the Attach line identifies the user thread, if any, being served by the system thread.

Cancel fields:

CANCEL

The type of cancel command to be performed. You can specify the following values:

TOKEN: The token shown will be used to issue the cancel command:
CANCEL THREAD(token).
LUWID: The luwid shown will be used to issue the cancel command:
CANCEL DDF THREAD(luwid) for all Db2 versions.

Token

The token of the specific thread to be canceled. It is unique for the Db2 subsystem.

Luwid

The logical unit of work identifier of the thread to be canceled. Two or more distributed threads can have the same luwid.