CICS-DB2 task-related user exit (TRUE) DFHD2EX1
Control is passed to the TRUE through the CICS® RMI. The TRUE manages the relationship between a CICS task (represented by an LOT control block), and a CICS-DB2 thread (represented by a CSB control block). DFHD2EX1 uses parameters set in the DB2CONN and DB2ENTRY definitions to manage use of the CICS DB2® threads, each thread running under a thread TCB.
- When connected to DB2 for OS/390 Version 5 or earlier, the thread TCB is a subtask managed by the CICS DB2 attachment facility. The subtask that is running program DFHD2EX3 issues requests to DB2 on behalf of a CICS task. A wait/post protocol is executed between the CICS task that is running in the CICS-DB2 TRUE, and the subtask in program DFHD2EX3.
- When connected to DB2 for z/OS® Version 6, 7, or 8, the thread TCB is a CICS open TCB (L8 mode). Program DFHD2D2 is called under the open TCB, and issues the requests to DB2. In this case, both DFHD2EX1 and DFHD2D2 run under the L8 TCB.
- When connected to DB2 for z/OS Version 9 or later with APAR PM57744 applied, the thread TCB is any eligible key 8 CICS open TCB: L8, T8, or X8, and DFHD2EX1 and DFHD2D2 both run under this TCB.
The CICS-DB2 TRUE DFHD2EX1 gets invoked by the RMI for the following
events:
- EXEC SQL commands and DB2 IFI commands from application programs
- syncpoint
- end of task
- INQUIRE EXITPROGRAM commands for the DB2 TRUE with the CONNECTST or QUALIFIER keywords (RMI SPI calls)
- EDF when using EDF for EXEC SQL commands
- CICS shutdown
- Switch application environment