Monitoring TSO and CAF connections

To display information about connections that use the TSO attachment facility and the call attachment facility (CAF), issue the DISPLAY THREAD command.

About this task

Begin general-use programming interface information.The following table summarizes how the output for the DISPLAY THREAD command differs for a TSO online application, a TSO batch application, a QMF session, and a call attachment facility application.

Table 1. Differences in DISPLAY THREAD information for different environments
Connection Name AUTHID Corr-ID1 Plan1
DSN (TSO Online) TSO Logon ID Logon ID RUN .. Plan(x)
DSN (TSO Batch) BATCH Job USER= Job Name RUN .. Plan(x)
QMF DB2CALL Logon ID Logon ID 'QMFvr0'
CAF DB2CALL Logon ID Logon ID OPEN parm
Notes:
  1. After the application connects to Db2 but before a plan is allocated, this field is blank.

The name of the connection can have one of the following values:

Name
Connection to
TSO
Program that runs in TSO foreground
BATCH
Program that runs in TSO background
DB2CALL
Program that uses the call attachment facility and that runs in the same address space as a program that uses the TSO attachment facility

The correlation ID, corr-id, is either the foreground authorization ID or the background job name.

The following command displays information about TSO and CAF threads, including those threads that process requests to or from remote locations: 

-DISPLAY THREAD(BATCH,TSO,DB2CALL)
Figure 1. DISPLAY THREAD output that shows TSO and CAF connections
   DSNV401I = DISPLAY THREAD REPORT FOLLOWS -
   DSNV402I = ACTIVE THREADS -
   NAME     ST A   REQ ID           AUTHID   PLAN     ASID TOKEN
 1 BATCH    T  *  2997 TEP2         SYSADM   DSNTEP41 0019 18818
 2 BATCH    RA *  1246 BINETEP2     SYSADM   DSNTEP44 0022 20556
   V445-DB2NET.LUND1.AB0C8FB44C4D=20556 ACCESSING DATA FOR SAN_JOSE
 3 TSO      T       12 SYSADM       SYSADM   DSNESPRR 0028  5570
 4 DB2CALL  T  * 18472 CAFCOB2      SYSADM   CAFCOB2  001A 24979
 5 BATCH    T  *     1 PUPPY        SYSADM   DSNTEP51 0025 20499
 6          PT *   641 PUPPY        SYSADM   DSNTEP51 002D 20500
 7          PT *   592 PUPPY        SYSADM   DSNTEP51 002D 20501
   DISPLAY ACTIVE REPORT COMPLETE
   DSN9022I = DSNVDT '-DIS THREAD' NORMAL COMPLETION
Key
Description
1
This is a TSO batch application.
2
This is a TSO batch application running at a remote location and accessing tables at this location.
3
This is a TSO online application.
4
This is a call attachment facility application.
5
This is an originating thread for a TSO batch application.
6
This is a parallel thread for the originating TSO batch application thread.
7
This is a parallel thread for the originating TSO batch application thread.

End general-use programming interface information.