Application programming for DBCTL

Application programming considerations in a DBCTL environment include: facilities available to application programmers with DBCTL, and abends and return codes that might be issued with DBCTL.

Programming information on DL/I requests is in Application programming for EXEC DLI in IMS product documentation and DL/I calls reference in IMS product documentation.

In most cases, existing DL/I application programs do not need any changes to access databases controlled by DBCTL. However, consider the following:
  • Your application programs must deal with a number of abend and response codes that might be issued with DBCTL. See Summary of DBCTL abends and return codes.
  • Enhanced scheduling with DBCTL enables a PSB to be scheduled even if some of the full function databases or DEDB areas it requires are not available. See Enhanced scheduling.
  • You can use the DL/I LOG request instead of the EXEC CICS® WRITE JOURNALNAME command so that all DBCTL logging information is on the IMS log instead of the CICS system log. (See LOG command and call.
CICS provides the following sample programs in the SDFHSAMP library to show you how to use the CALL DL/I and EXEC DLI interfaces:
Table 1. Sample programs for DL/I
Language CALL DL/I EXEC DLI PSBs used
Assembler DFH$DLAC DFH$DLAE DFHSAM04, DFHSAM05
COBOL DFH0DLCC DFH0DLCE DFHSAM24, DFHSAM25
PL/I DFH$DLPC DFH$DLPE DFHSAM14, DFHSAM15

Other product information

The information given about IMS commands is intended to help you understand the facilities available to your CICS system when you use DBCTL. The information is not part of the CICS Programming Interface and Associated Guidance Information.