Control program (DFHDBCT)
The control program is invoked in the following circumstances:
- When the control exit is invoked by the adapter on behalf of the DRA
- When a CEMT FORCEPURGE command is issued for a CICS task executing in DBCTL
- When the disconnection program has received a response from the adapter as a result of a CICS-DBCTL interface termination request.
Its function in all cases is to issue messages. It then issues
a WAIT after every invocation. Also, it has some special functions
in three cases:
- When contact has been made with DBCTL and resynchronization of
in-doubts is required. In this case, the control program issues the following command:
This causes CICS to create tasks for each indoubt unit of work. Each task performs resynchronization and then informs the adapter via the CICS syncpoint manager as to whether the task has committed or backed out. The adapter then notifies the DRA on a task basis.EXEC CICS RESYNC ENTRYNAME(adapter) IDLIST(DBCTL’s in-doubts) ...The possible calls to the adapter from the CICS syncpoint manager are as follows:- Prepare to commit
- Commit unconditionally1
- Backout1
- Unit of recovery is lost to CICS cold start2
- DBCTL should not be indoubt about this unit of recovery2.
Notes:1 These items can be issued as a result of a RESYNC request.
2 These items can be issued as a result of a RESYNC request only.
- When /CHECKPOINT FREEZE has been requested.
In this case, the control program invokes the disconnection program requesting an orderly disconnection from DBCTL. Generally, an orderly disconnection from DBCTL allows CICS tasks already using DBCTL to continue until task termination. However, when a /CHECKPOINT FREEZE has been requested, DBCTL prevents any PSB schedules from taking place. Thus, in this case, some tasks might be terminated before end of task is reached with a ‘DBCTL not available’ return code, if they issue a subsequent PSB schedule request.
- When the disconnection program invokes the control program.
In this case, the control program starts the disable program.