Adapter (DFHDBAT)
Control is passed to the database adapter transformer, DFHDBAT, through the CICS® resource manager interface (RMI). It is the responsibility of the adapter to construct the DRA INIT, DRA TERM, and DRA THREAD parameter lists from the RMI parameter list passed to it. It must also transform the DRA parameter list that was passed back after a DL/I call to the format expected by CICS.
DFHDBAT is defined as a threadsafe program that CICS runs as an OPENAPI TRUE on an L8 open TCB.
- A thread token
- A recovery token
The thread token is generated by the DBCTL call processor, and enables a CICS unit of work to be related to a DBCTL unit of work. It is used by the asynchronous RESUME exit to identify the CICS thread to be resumed after a DL/I call.
The 16-byte recovery token is constructed by concatenating an 8-byte unique CICS subsystem name (the CICS APPLID) with the 8-byte CICS RMI recovery token (also known as the unit of work ID).
A further responsibility of the adapter is to manage CICS tasks when an orderly termination of the CICS-DRA interface has been requested by means of the CICS termination program. In this case, the adapter continues to accept DL/I requests from CICS tasks currently using DBCTL, but does not allow new CICS tasks to use DBCTL. When the adapter detects that the count of current tasks has reached zero, it issues a DRA TERM call to shut down the interface.
Table 1 summarizes the types of invocations of the adapter code from CICS, and how the adapter reacts to the individual invocation.
Table 2 summarizes the types of invocations of the adapter code from the DRA, and how the adapter reacts to each individual invocation.
Table 3 summarizes the cases when the adapter invokes the adapter exits.
| Invocation | Invoker | Adapter action |
|---|---|---|
| Initialize | Connection program | Issues DRA INIT |
| Terminate-Orderly | Disconnection program | Issues DRA TERM after waiting for CICS-DBCTL tasks to quiesce |
| Terminate-Fast | Disconnection program | Issues DRA TERM |
| PSB Schedule | DBCTL call processor | Issues THREAD SCHED |
| DL/I request | DBCTL call processor | Issues THREAD DLI |
| Prepare | CICS sync point manager | Issues THREAD PREP |
| Commit | CICS sync point manager | Issues THREAD COMTERM |
| Abort | CICS sync point manager | Issues THREAD ABTTERM |
| Lost To CICS cold start | CICS sync point manager | Issues COLD request |
| DBCTL should not be in doubt | CICS sync point manager | Issues UNKNOWN request |
| Task is terminating | CICS task manager | Issues TERMTHRD |
| Force Purge Task | Control program | Issues PURGE THREAD |
| Orderly CICS Term | CICS termination | Issues DRA TERM after waiting for CICS-DBCTL tasks to quiesce |
| Immediate CICS Term | CICS termination | Issues DRA TERM |
| CICS is abending | CICS termination | Issues DRA TERM |
| CICS has been canceled | CICS termination | Returns to CICS |
| Invocation from the DRA | Adapter action |
|---|---|
| CICS-DBCTL connection is complete | Invoke the control exit |
| MVS™ SSI has rejected the IDENTIFY request to DBCTL | Invoke the control exit |
| DBCTL has rejected the IDENTIFY request | Invoke the control exit |
| Operator has replied CANCEL to message DFS690A | Invoke the control exit |
| DBCTL has terminated abnormally | Invoke the control exit |
| DRA has terminated abnormally | Invoke the control exit |
| /CHECKPOINT FREEZE has been issued | Invoke the control exit |
| PSB schedule, DL/I, sync point, thread termination, thread purge, or interface termination request is to be suspended | Invoke the suspend exit |
| PSB schedule, DL/I, sync point, thread termination, thread purge, or interface termination request is to be resumed | Invoke the resume exit |
| Circumstances | Adapter action |
|---|---|
| Successful completion of THREAD SCHED request | Invoke the monitoring exit |
| Completion of THREAD COMTERM or THREAD ABTTERM request | Invoke the monitoring exit |
| DRA thread failure | Invoke the status exit |
| Resynchronization request issued from CICS recovery manager | Invoke the token exit |
| CICS orderly or immediate term | Invoke the token exit |
| CICS ABEND | Invoke the token exit |
| Completion of DRA TERM issued as a result of a termination request from disconnection program | Invoke the statistics exit |
| Completion of DRA TERM issued as a result of a CICS orderly termination request | Invoke the statistics exit |