Using CDBM Syntax

About this task

The syntax of the CDBM transaction is:

CDBM /DBCTL operator command

where / is the default command recognition character (CRC) for DBCTL. In this case, the default CRC is the one that must be used.

Note:

IMS requires that each command be prefixed with the default CRC. The CRC is present only for syntax checking reasons; it does not determine the DBCTL to which the command is sent. You cannot use a CRC value to route a command to a particular DBCTL system through CDBM - it can only be sent to the one currently connected to CICS. This DBCTL may have its own CRC value which is different from the default one of /. This does not matter to CDBM however, because the / character is used only for syntax checking, and the command is presented to the connected DBCTL without a CRC, using the AIB interface
To ensure that the CDBM command succeeds, you might need to set the correct AOIS execution parameter. For example, AOIS=S ensures that the command authorization is bypassed; with any other value, the command could fail the command authorization check.

You can enter a DBCTL command, for example:
```
CDBM /DISPLAY  DB  DEPT*
```
or a group command, for example:
```
CDBM /GROUP  SAMPLE  STO
```
in this way.
You can also start the transaction by typing the identifier, CDBM, on the command line of your display, as follows:
```
CDBM
```
Press the ENTER key. You get the panel shown in Figure 1.

Figure 1. CICS-DBCTL operator transaction

 CDBM                  CICS-DBCTL Operator Transaction               98.135
                                                                 13:24:20

 Type IMS command.
             ____________________________________________________________
             ____________________________________________________________
             ____________________________________________________________
             ____________________________________________________________


 For /DBDUMP or /DBRECOVER commands

 Choose one. 1 1. Do not force end of volume
               2. Force end of volume


 Press enter to display responses.


 CICS APPLID DBDCCICS
 DBCTL ID    SYS3


F1=Help  F2=Maintenance  F3=Exit  F5=Refresh  F12=Cancel

On this panel you can enter a DBCTL command, for example:

     /DISPLAY  DB  ALL

or a group command, for example:

     /GROUP  SAMPLE  STA

An example of the use of a /GROUP command from the CICS-DBCTL Operator Transaction screen is shown in Figure 2.

Figure 2. CICS-DBCTL operator transaction panel showing a GROUP command

 CDBM                  CICS-DBCTL Operator Transaction               98.135
                                                                 13:24:20

 Type IMS command.
             /GROUP SAMPLE STA___________________________________________
             ____________________________________________________________
             ____________________________________________________________
             ____________________________________________________________


 For /DBDUMP or /DBRECOVER commands

 Choose one. 1 1. Do not force end of volume
               2. Force end of volume


 Press enter to display responses.


 CICS APPLID DBDCCICS
 DBCTL ID    SYS3


F1=Help  F2=Maintenance  F3=Exit  F5=Refresh  F12=Cancel

Note: The group command SAMPLE STA referred to in this panel can be found in the Using DFHDBFK - The CDBM GROUP command file.

Responses to commands issued using CDBM are returned in a screen like the one shown in Figure 3, which shows the first of a number of screens issued in response to a /DISPLAY DB ALL command.

Figure 3. CICS-DBCTL IMS responses

 CDBM                      CICS-DBCTL IMS Responses             Screen 1
                                                   Responses 1    to 18
                                                               More:   +
 DATABASE  TYPE  TOTAL UNUSED  TOTAL UNUSED ACC  CONDITIONS
 ACCUNTDB                                   UP   STOPPED, NOTOPEN, NOTINIT
 ADMIDX1                                    UP   STOPPED, NOTOPEN, NOTINIT
 ADMOBJ1                                    UP   STOPPED, NOTOPEN, NOTINIT
 ADMOBJ2                                    UP   STOPPED, NOTOPEN, NOTINIT
 ADMOBJ3                                    UP   STOPPED, NOTOPEN, NOTINIT
 ADMSYSDF                                   UP   STOPPED, NOTOPEN, NOTINIT
 BE1CHKPT  DL/I                             UP   NOTOPEN
 BE1PARTA                                   UP   STOPPED, NOTOPEN, NOTINIT
 BE1PARTB                                   UP   STOPPED, NOTOPEN, NOTINIT
 BE1PARTC                                   UP   STOPPED, NOTOPEN, NOTINIT
 BE1PARTS                                   UP   STOPPED, NOTOPEN, NOTINIT
 BE2ORDER  DL/I                             UP   NOTOPEN
 BE2ORDRX  DL/I                             UP   NOTOPEN
 BE2PARTS  DL/I                             UP   NOTOPEN
 BE2PCUST  DL/I                             UP   NOTOPEN
 BE3ORDER  DL/I                             UP   NOTOPEN
 BE3ORDRX  DL/I                             UP   NOTOPEN
                                                                   More...

F1=Help  F3=Exit  F4=Top  F6=Bottom  F7=Bkwd  F8=Fwd  F9=Retrieve  F12=Cancel