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

CDBM–database control interface
||
|
CDBM CICS/DBCTL COMMAND GROUP MAINTENANCE |
_ ACTION A add B browse D delete R read U update |
____________ GROUP __________ IMS COMMAND |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> < |
> <
|
F1=Help F3=Exit F12=Cancel
||
| Figure 10. CICS-DBCTL Group Maintenance panel
| Input fields
| The input fields are:
| Action
| Group
| IMS Command
| IMS Command parameters
| (between the > < marks).
| Group, IMS Command and IMS Command parameters are
| described in the section “Record layout in the CDBM
| GROUP command file” on page 16
| The Action field will accept one of the following:
| A Add
| Add a new record to the DFHDBFK file. If the key
| already exists, the Add fails.
| Note: To Add a record that is very similar to an existing
| record, but which has a different key, you may
| find it helpful to Read the existing record, modify
| the displayed fields, and then Add this new
| record.
| B Browse
| Displays the contents of the command file, record by
| record. Specify any key (or none) to indicate where you
| want the browse to start. Each time you press ENTER,
| Browse moves on to the next record. At the end of the
| file you will be prompted to wrap around to the start of
| the file. You can accept this or not as you prefer.
| Incomplete keys, and unknown keys are also acceptable
| as start points. If no key is provided, the browse starts at
| the first record in the file.
| If you have used Browse to locate a specific record for
| deletion or for update, remember to use Read before
| either Delete or Update.
| D Delete
| Delete a record from the DFHDBFK file. A Delete must
| be immediately preceded by a Read to lock the required
| record.
| R Read
| Read displays a specific record. Unlike Browse it does
| not operate on partial, or absent keys, and does not
| present the next record when you press ENTER.
| Read is required before those actions (Delete and
| Update) which change an existing record. It locks that
| record against the possibility of being changed by
| another operator. This action also serves to help you
| confirm that the correct record has been selected.
| A lock is released by exiting the CDBM maintenance
| panel, or by your next CDBM Maintenance action
| (whether that is the Update or Delete you had
| contemplated, or something different entirely).
| U Update
| Update a record in the DFHDBFK file. An Update must
| be immediately preceded by a Read to lock the required
| record.
| You cannot update the key fields (GROUP and IMS
| COMMAND).
| Note: Use Add to create a new key.
| Note: In the descriptions above, Key refers to the 22
| characters at the beginning of each record in the
| DFHDBFK file (namely the GROUP and IMS
| COMMAND).
The CICS-DBCTL interface
For detailed information about the CICS-DBCTL interface
and guidance on using the CDBM transaction with databases
controlled using DBCTL, see the
CICS IMS Database Control
Guide.
The HELP panels
| If you press the help key (PF1) from the CICS-DBCTL
| Operator Transaction panel, you get the panel shown in
Figure 11 on page 18.
Chapter 5. Database control interface CDBM 17