CDBM operator transaction

You can use CDBM to issue most of the IMS operator commands that are valid for DBCTL across the DRA interface to DBCTL to display and change the state of selected resources.

CDBM also provides a means of maintaining a command file which stores commands. You can store commands for any reason, most likely because you want to reuse them. These stored commands can include more databases than the operator transaction panel has space for.

When dealing with databases, you can use an asterisk (*) to refer to generic groups; for example DB21* refers to all databases starting with the characters DB21. You can also use a plus (+) sign in place of a single character; for example, DB+2 displays databases DB12, DB22, DB32, and so on.

You can issue DBCTL commands via a menu panel, as shown in Figure 1. This panel is obtained by starting the CDBM transaction.

Figure 1. CDBM CICS-DBCTL operator transaction panel

  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

There is also a help screen, as shown in Figure 2.

Figure 2. CDBM CICS-DBCTL operator transaction help panel

  CDBM                Help: CICS-DBCTL Operator Transaction
 
 
 CDBM           Use the transaction to send an IMS command to a DBCTL system.
 
 Command        Type the command recognition character / followed by an IMS
                command and press enter to display responses.
 
 Responses      Use the PF keys to page IMS responses.
 
 Wildcards      * or + can be used within one database name.
 
 End of volume  For /DBDUMP or /DBRECOVER commands only
                Choose one.
                  1. Do not force end of volume
                  2. Force end of volume
  CICS APPLID
               These are shown for information.
 DBCTL ID
 Enter the group common maintenance screen.
 
 
 Example        /DIS DB DEPT* displays the status of several databases.
 
 
 F3=Exit  F12=Cancel

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

Figure 3. 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

Responses to commands issued from the CDBM screen are returned on a screen like the one in Figure 4, which shows the first of a number of screens resulting from a /DISPLAY DB ALL command.

Figure 4. CDBM CICS-DBCTL IMS responses panel

  CDBM                      CICS-DBCTL IMS Responses                 Screen 1
                                                          Responses 1    to 18
                                                                      More:   +
  DATABASE  TYPE  TOTAL UNUSED  TOTAL UNUSED ACC  CONDITIONS
  ACCOUNDB                                   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

Alternatively, you can issue CDBM and the DBCTL command directly, as follows:

CDBM /xxxxxxxx

where / is the default CRC and xxxxxxxx is an operator command that is valid for use with DBCTL and CDBM.

Note: IMS requires that each command is prefixed with the default CRC. The CRC is present only for syntax checking; it does not determine to which DBCTL the command is sent. You cannot use a CRC value to route a command to a particular DBCTL system through CDBM. It can be sent only to the one currently connected to CICS®. This DBCTL can have its own CRC value which is different from the default one of '/'. However, this does not matter to CDBM, 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.

The /GROUP can also be entered in this way, for example:

CDBM /GROUP  SAMPLE  DIS.

The following IMS operator commands are valid with CDBM:

/CHANGE
/CHECKPOINT (simple form) and /CHECKPOINT STATISTICS
/DBDUMP
/DBRECOVERY
/DELETE
/DEQUEUE
/DISPLAY
/LOCK
/LOG
/PSTOP
/RMCHANGE
/RMDELETE
/RMGENJCL
/RMINIT
/RMLIST
/RMNOTIFY
/START
/STOP
/SWITCH OLDS
/TRACE SET PI
/UNLOCK
/VUNLOAD

The following IMS operator commands are not valid with CDBM and must be issued via the MVS™ console:

/CHECKPOINT FREEZE and /CHECKPOINT PURGE
/MODIFY
/ERESTART
/NRESTART
/SSR