Displaying IMS attachment facility threads

You use the DISPLAY THREAD command to display IMS attachment facility threads.

About this task

Begin general-use programming interface information.DISPLAY THREAD output for Db2 connections to IMS differs depending on whether Db2 is connected to a DL/I batch program, a control region, a message-driven program, or a non-message-driven program. The following table summarizes these differences.

Table 1. Differences in DISPLAY THREAD information for IMS connections
Connection Name AUTHID2 ID1,2 Plan1,2
DL/I batch DDITV02 statement JOBUSER= Job Name DDITV02 statement
Control region IMSID N/A N/A N/A
Message driven IMSID Signon ID or ltermid PST+ PSB RTT or program
Non-message driven IMSID AXBUSER or PSBNAME PST+ PSB RTT or program
Notes:
  1. After the application connects to Db2 but before sign-on processing completes, this field is blank.
  2. After sign-on processing completes but before a plan is allocated, this field is blank.

The following command displays information about IMS threads, including those accessing data at remote locations: 

-DISPLAY THREAD(imsid)
Figure 1. DISPLAY THREAD output showing IMS connections
   DSNV401I -STR DISPLAY THREAD REPORT FOLLOWS -
   DSNV402I -STR ACTIVE THREADS -
   NAME     ST A   REQ ID           AUTHID   PLAN     ASID TOKEN
 1 SYS3     T  *     3 0002BMP255   ADMF001  PROGHR1  0019    99
              SYS3     T  *     4 0001BMP255   ADMF001  PROGHR2  0018    97
 2 SYS3     N        5              SYSADM            0065     0
   DISPLAY ACTIVE REPORT COMPLETE
   DSN9022I -STR DSNVDT '-DISPLAY THREAD' NORMAL COMPLETION
Key
Description 
1
This is a message-driven BMP.
2
This thread has completed sign-on processing, but a Db2 plan has not been allocated.
End general-use programming interface information.