Installing and generating DBCTL

Install DBCTL, verify the installation, and connect CICS® to DBCTL.

Before you begin

Before installing and generating DBCTL you must have CICS Transaction Server for z/OS®, Version 5 Release 2 and IMS installed. Check the program directory for any PTFs or APARs that need installing. Develop your own procedures for installing DBCTL, depending on the DBCTL facilities you want to use. For more information about IMS installation and system definition, see theIMS: Installation, the IMS: System definition, and the IMS: System definition.

About this task

Follow these steps to install DBCTL, verify the installation, and connect CICS to DBCTL.

Procedure

  1. Prepare a PDIR that does not specify PSBs.
    For more information, see PSB directories (PDIRs).
  2. Update system procedure libraries; for example, SYS1.PROCLIB, with the startup procedures for DBCTL, DLISAS, DBRC, and the IRLM if you are using it.
    These startup procedures can be found in the IMS.PROCLIB library.
  3. Use the CICS supplied DBCTL-installation verification procedure, DFHIVPDB, to check that: DBCTL has been fully installed, CICS has integrated with MVS™, and that all required online data sets have been allocated and initialized.
    For more information, see Verifying the CICS-DBCTL interface.
  4. You must use ACB generation to create members of the IMS.ACBLIB. Failure to carry out this step can cause user errors.
  5. If you plan to use dynamic allocation, create DFSMDA members.
    For more information, see IMS dynamic allocation macro (DFSMDA).
  6. Start DBCTL; DBCTL then issues a start command for DLISAS and DBRC.
  7. Verify that DBCTL recognizes the PSBs and DBDs you defined in the DBCTL generation, you can check this using the DBCTL operator command /DISPLAY.
    For more information, see Finding out current status of DBCTL activities.
  8. Check that your log archiving setup works before doing any more testing. If your log archiving is not set up it is possible for the logs to fill and stall your system.
    For more information about setting your log archive setting, see Log control with DBRC.
  9. Assemble a database resource adapter (DRA) to connect CICS to DBCTL.
    For more information, see Defining the IMS DRA startup parameter table.
  10. Start CICS and test the connection to DBCTL, using the CDBC transaction.
    For more information, see CDBC transaction for connect and disconnect.
  11. Generate an initialization PLT, so that CICS can connect to DBCTL automatically at startup time.
    For more information, see Connecting DBCTL to CICS automatically.
  12. Test the applications that you defined to DBCTL.
  13. Set up and test recovery and restart of CICS and DBCTL, and database recovery.
    For more information, see Recovery and restart operations for DBCTL.