CDBC - database control menu

Use CDBC to connect CICS® to DBCTL, or to disconnect CICS from DBCTL. CDBC is applicable only to CICS systems using the IMS Database Control (DBCTL) interface.

You can start CDBC from any terminal, from a card reader/line printer (CRLP) or DASD sequential terminal, or from the operating system console.

You can start CDBC on the command line of your display in several ways:

  • Type the identifier CDBC, followed by the required keyword.

    To connect to DBCTL, issue CDBC CONnect [SUFfix(nn)] where nn is a two-digit startup table suffix.

    Note: You can specify a DBCTL system identifier (DBCTLID) to override the one in the DRA startup table, as follows:

    CDBC CONNECT [SUFFIX(nn)] [DBCTLID(yyyy)]

    To disconnect from DBCTL, issue CDBC DISconnect [IMMediate].

  • Type the identifier CDBC, and press the ENTER key. You get the following display. As you can see from this display, you can select a CICS-DBCTL connection, an orderly disconnection, or an immediate disconnection.
    Tip: You can find out the current status of the connection at any time by pressing PF2, which refreshes the display. This display shows you the application identifier of the CICS system, and the identifier of the DBCTL system to which CICS is connected. The DBCTL identifier is available only when the connection has been made. You can also see the suffix of the startup table for this connection.
    Figure 1. CDBC transaction: initial screen
     CDBC                CICS-DBCTL CONNECTION/DISCONNECTION                  93.259
                                                                            13:33:20
    
               Select one of the following:
    
                    1 Connection
                    2 ORDERLY disconnection
                    3 IMMEDIATE disconnection
    
    
               Option Selection     ==>
               Startup Table Suffix ==> 00
               DBCTL ID Override    ==>
    
    
    
       Status of the Interface: DFHDB8290I DBCTL not connected to CICS.
                   CICS APPLID: APPLID
                      DBCTL ID:
          Startup Table Suffix:
    
    
     PF1 = Help   2 = Refresh   3 = End
    Table 1. Available options on the CDBC panel
    Option Description
    Connection Establish a CICS-DBCTL connection. Type 1 in the Option Selection field.

    You can also specify a startup table suffix in the Startup Table Suffix field. If you leave this field blank, you get the existing suffix, if one exists.

    You can also specify a DBCTL system identifier in the DBCTL ID Override field to override the one in the DRA startup table.

    ORDERLY disconnection An orderly disconnection allows all existing CICS-DBCTL tasks to be completed before CICS is disconnected from DBCTL.
    IMMEDIATE disconnection An immediate disconnection allows only current DL/I requests to DBCTL from this CICS system to be completed before CICS is disconnected from DBCTL.