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.

Part of the DRA parameter list requires two tokens to be generated by CICS:
  • 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.

Table 1. CICS-adapter request summary
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
Table 2. DRA-adapter request summary
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
Table 3. Adapter exit summary
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


dfhs3c00237.html | Timestamp icon Last updated: Monday, 5 June 2017