Monitoring and CICS threads and recovering CICS-Db2 indoubt units of recovery

No operator intervention is required for connecting applications because CICS® handles the threads dynamically. However, You can monitor threads by using CICS attachment facility commands or Db2 commands.

About this task

Begin general-use programming interface information. Any authorized CICS user can monitor the threads and change the connection parameters as needed. Operators can use the following CICS attachment facility commands to monitor the threads:

Procedure

Authorized CICS user can monitor the threads and change the connection parameters as needed.
- Operators can use the following CICS attachment facility commands to monitor the threads:
- ```
DSNC DISPLAY PLAN plan-name destination
DSNC DISPLAY TRANSACTION transaction-id destination
```
  These commands display the threads that the resource or transaction is using. The following information is provided for each created thread:
  - Authorization ID for the plan that is associated with the transaction (8 characters).
  - PLAN/TRAN name (8 characters).
  - A or I (one character).
    If A is displayed, the thread is within a unit of work. If I is displayed, the thread is waiting for a unit of work, and the authorization ID is blank.
- The following CICS attachment facility command is used to monitor CICS:
```
DSNC DISPLAY STATISTICS destination
```

To display a list of postponed units of recovery, issue a DISPLAY THREAD command.

-DISPLAY THREAD (connection-name) TYPE (POSTPONED)

The result is similar to the following output:

DSNV431I -POSTPONED ABORT THREADS - 480
COORDINATOR               STATUS      RESET URID           AUTHID
CICS41                    P-ABORT           00019B8ADE9E   ADMF001
V449-HAS NID= CICS41.AACC9B739F125184 AND ID=GT00LE39
DISPLAY POSTPONED ABORT REPORT COMPLETE
DSN9022I -STR DSNVDT '-DISPLAY THREAD' NORMAL COMPLETION

To display a list of indoubt units of recovery, you can issue a DISPLAY THREAD command.

-DISPLAY THREAD (connection-name) TYPE (INDOUBT)

The result is similar to the following output:

DSNV407I -STR INDOUBT THREADS - 480
COORDINATOR               STATUS      RESET URID           AUTHID
CICS41                    INDOUBT         00019B8ADE9E   ADMF001
 V449-HAS NID= CICS41.AACC9B739F125184 AND ID=GT00LE39
DISPLAY INDOUBT REPORT COMPLETE
DSN9022I -STR DSNVDT '-DISPLAY THREAD' NORMAL COMPLETION

To recover an indoubt unit of recovery, issue the following commands.
```
-RECOVER INDOUBT (connection-name) ACTION (COMMIT) ID (correlation-id)
-RECOVER INDOUBT (connection-name) ACTION (ABORT) ID (correlation-id)
```
The default value for connection-name is the connection name from which you entered the command. The correlation-id is the correlation ID of the thread to be recovered. You can determine the correlation ID by issuing the command DISPLAY THREAD. Your choice for the ACTION parameter indicates whether to commit or roll back the associated unit of recovery.

One of the following messages might be issued after you use the RECOVER command:
```
DSNV414I - THREAD correlation-id COMMIT SCHEDULED
DSNV415I - THREAD correlation-id ABORT SCHEDULED
```