CICS-DBCTL interface control components in CICS address space
The components of the CICS®-DBCTL interface in the CICS address space are: the CICS-DL/I router (DFHDLI), the CICS database adapter transformer (DFHDBAT), and the database resource adapter (DRA).
CICS-DL/I router (DFHDLI)
The CICS-DL/I router, DFHDLI, forms the interface between your application programs and the DL/I call processor. DFHDLI accepts requests for remote or DBCTL database processing. If the request is for DBCTL, DFHDLI passes the request to the CICS-DL/I DBCTL processor, DFHDLIDP. The request then goes to the task-related user exit interface and the CICS database adapter transformer, DFHDBAT. The task-related user exit interface is also referred to as the resource manager interface (RMI). For more information about the task-related user exit interface, see Task-related user exit programs.
CICS database adapter transformer (DFHDBAT)
- Tells the DRA that it must initialize the interface to DBCTL in response to a request from the connection program (DFHDBCON).
- Tells the DRA when it must issue PSB schedule requests, DL/I requests, and sync point requests in response to a request from the CICS-DBCTL processor (DFHDLIDP).
- Tells the DRA that it must terminate the interface to DBCTL in response to a request from the disconnection program (DFHDBDSC). If an orderly disconnection has been requested, DFHDBAT ensures that all current CICS tasks that use DBCTL complete before telling the DRA to terminate the interface. If an immediate disconnection has been requested, DFHDBAT ensures that only the current CICS-DL/I requests that use DBCTL can complete before telling the DRA to terminate the interface.
CICS master terminal operators can use the CICS-supplied transaction CDBC to connect to and disconnect from DBCTL. They can also automate connection to DBCTL, as described in Connecting to DBCTL:overview.
DFHDBAT is defined as a threadsafe program.
Database resource adapter (DRA)
- Requests connection to, and disconnection from, DBCTL.
- Tells CICS when a shutdown of DBCTL has been requested, or if DBCTL has failed.
- Manages threads. A CICS application thread provides a two-way link between an application and DBCTL. When a CICS transaction issues a DL/I request to DBCTL, the thread represents that CICS transaction in DBCTL. It identifies the existence of the transaction, traces its progress, sets aside the resources it needs to be processed, and delimits its accessibility to other resources.
- Establishes contact with the DBCTL address space and loads the DRA startup parameter table. The DRA startup parameter table provides the parameters needed to define the interface to a DBCTL subsystem. (See Defining the IMS DRA startup parameter table, for a list of DRA startup table parameters.)