Chapter 19. Writing A Cics-Dbctl Interface Status Program - IBM SC34-6814-04 Customization Manual

Chapter 19. Writing a CICS–DBCTL interface status program
Considerations common to all user-replaceable programs
Note that the comments contained in Chapter 5, "General notes about
user-replaceable programs," on page 435 apply to this chapter.
The CICS–DBCTL interface status program DFHDBUEX is a user-replaceable
program forming part of the support for the CICS–DBCTL interface. It is designed to
invoke user-supplied code whenever CICS successfully connects to or disconnects
from DBCTL. It runs in a CICS application environment and is driven at specific
points to allow you to enable and disable your CICS-DL/I transactions when the
CICS–DBCTL interface initializes or terminates.
DFHDBUEX is invoked in the following case for the ENABLE command:
v CICS has connected to DBCTL successfully. This occurs after a connection
DFHDBUEX is invoked in the following cases for the DISABLE command:
v A request has been issued to disconnect from DBCTL. The CICS–DBCTL menu
v The control transaction (CDBO) has been notified of one of the following events:
Input to DFHDBUEX is by means of a communication area addressed by
DFHEICAP. The layout of the communication area is shown in Figure 66.
DBUSHEAD DS OCL4
DBUREQT DS CL1
DBUCOMP DS CL2
DBURESV DS CL1
DBUREAS DS CL1
DBUSUFF DS CL2
DBUDBCTL DS CL4
Figure 66. The DFHDBUEX communication area
The parameter list contains the following information:
DBUREQT
7. The interface that enables DBCTL databases to be accessed from CICS.
© Copyright IBM Corp. 1977, 2011
request has been issued from CICS to DBCTL. The control exit (DFHDBCTX) is
invoked by the database resource adapter (DRA) for
control exit posts the control transaction (CDBO). The control program
(DFHDBCT) then invokes DFHDBUEX.
program (DFHDBME) starts the disconnection transaction (CDBT) to disconnect
from DBCTL. The disconnection program (DFHDBDSC) invokes DFHDBUEX
before issuing the interface termination request to the adapter.
– A checkpoint freeze request to DBCTL
– DRA abnormal termination
– DBCTL abnormal termination.
In each of these cases, the control program (DFHDBCT) invokes DFHDBUEX.
Standard Header
Function Code
Component Code
Reserved
Reason for disconnection
DRA startup table suffix
DBCTL identifier
Request Type. The function code has one of the following values:
DBUCONN (X'01')
Connected
7
'initialization complete'. The
Always "DB"
659