CDBC transaction for connect and disconnect
Typing CDBC on a 3270-type terminal displays a menu for connecting CICS® to, and disconnecting it from, DBCTL.
Figure 1 shows an example of the menu.
To connect to DBCTL, enter option number 1 after:
Option Selection ==>
Figure 1. CDBC transaction menu screen
CDBC CICS-DBCTL CONNECTION/DISCONNECTION 93.259
13:39:20
Select one of the following:
1 Connection
2 ORDERLY disconnection
3 IMMEDIATE disconnection
Option Selection ==> 2
Startup Table Suffix ==> 00
DBCTL ID Override ==>
DFHDB8209D DBCTL orderly disconnection requested. Press PF5 to confirm.
Status of the Interface: DFHDB8293I DBCTL connected and ready.
CICS APPLID: IYAHZCD2
DBCTL ID: SYS2
Startup Table Suffix: 00
PF1 = Help 2 = Refresh 3 = End
If you want to specify a DRA startup table suffix, you can enter
it after:
Startup Table Suffix ==>
If you do not
specify a suffix, CICS uses the one that was used when it was last connected
to DBCTL. If this is the first time you have connected CICS to DBCTL, and you do not specify a
suffix, CICS uses
the default suffix, which is 00.If you want to specify a DBCTL identifier, you can enter it after:
DBCTL ID Override ==>
If you do not specify a DBCTL
identifier, the DRA uses the DBCTL identifier specified on the DBCTLID parameter
in the DRA startup table.When you have pressed ENTER, you should get the message:
DFHDB8209 I DBCTL orderly disconnection requested. Press PF5 to confirm.
as
shown on the example screen in Figure 1.The CDBC menu screen displays the following additional information:
- Status of the CICS-DBCTL interface; in this case, DBCTL is connected and ready
- The APPLID of the CICS system; in this case, DBDCCICS
- The identifier of the DBCTL system; in this case, SYS2
- The DRA startup parameter table suffix for this connection; in this case, 00.
The DBCTL identifier and the DRA startup parameter table suffix are only displayed when CICS has been connected to DBCTL. You can refresh any of the information on the CDBC menu screen by pressing PF2.
You can obtain a help screen for the CDBC menu by pressing PF1. As you can see in Figure 2, the CDBC help screen reminds you which number to specify for which option, what the options mean, and summarizes the CICS-DBCTL interface information displayed on the CDBC menu screen.
Figure 2. CDBC transaction menu help screen
HELP : CICS-DBCTL CONNECTION/DISCONNECTION
To CONNECT to DBCTL, select option 1. You can also specify a startup
table suffix, or accept the existing suffix. The id of the DBCTL system is
obtained from the startup table, but can be optionally overridden.
To DISCONNECT from DBCTL, select option 2 or option 3.
Select option 2 for ORDERLY disconnection: this allows all CICS-DBCTL
transactions from this CICS to complete before disconnecting from DBCTL.
Select option 3 for IMMEDIATE disconnection: this allows all CICS-DBCTL
requests from this CICS to complete before disconnecting from DBCTL.
------------------------------------------------------------------------------
Displayed information (press PF2 to refresh the information):
STATUS OF THE INTERFACE The current status of the connection to DBCTL.
CICS APPLID The application identifier for this CICS system.
Displayed when available:
DBCTL ID Identifier of the DBCTL system with which this
CICS system is communicating.
STARTUP TABLE SUFFIX Suffix used when CICS was connected to DBCTL.
PRESS ENTER TO RETURN TO SELECTION SCREEN