IBM CICS Transaction Server for OS/390 SC33-1686-02 - Manual (Page 33)

CDBM–database control interface
Chapter 5. CDBM—database control interface
Use the CDBM transaction to issue DBCTL operator
commands from a CICS terminal. CDBM is applicable only to
CICS systems using the IMS/ESA Database Control
(DBCTL) interface.
| CDBM also provides a means of maintaining a command file
| which stores commands. You may store commands for any
| reason, but repeated re-use is likely to be a frequent
| purpose. These stored commands may include more
| databases than the operator transaction panel has space for.
To use CDBM you must:
1. Have a DBCTL system running IMS/ESA 5.1 or later
| 2. DBCTL must have the AOIS parameter set to a value
| other than N. If values A, C or R are used, appropriate
| security controls must be used to allow the CICS-DBCTL
| interface to operate.
3. Generate and add to the DBCTL system, a PSB named
DFHDBMP.
Syntax
The syntax of the CDBM transaction is:
CDBM /DBCTL operator command
where / is the default command recognition character
(CRC) for DBCTL. Note that, 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.
| 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 7.
CDBM CICS-DBCTL Operator Transaction 98.135
13:24:2
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
Figure 7. CICS-DBCTL operator transaction
| 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 8.
CDBM CICS-DBCTL Operator Transaction 98.135
13:24:2
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
Figure 8. CICS-DBCTL operator transaction panel showing a
GROUP command
| Note: The group command SAMPLE STA referred to in this
| panel can be found in the “DFHDBFK - The CDBM
| GROUP command file” on page 16.
| Responses to commands issued using CDBM are returned in
a screen like the one shown in Figure 9 on page 16, which
shows the first of a number of screens issued in response to
a /DISPLAY DB ALL command.
 Copyright IBM Corp. 1982, 1999 15