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 transactionpanel showinga
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