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 Record layout in the CDBM GROUP command file

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 ending CDBM, 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).

Reminder:: Use Add to create a new key.

Note: In these descriptions, Key refers to the 22 characters at the beginning of each record in the DFHDBFK file (namely the GROUP and IMS COMMAND).

If you press the help key (PF1) from the CICS®-DBCTL Maintenance panel, you get the panel shown in Figure 1.

Figure 1. CICS-DBCTL Maintenance help panel

   CDBM                Help: CICS-DBCTL Operator Transaction
 
 
  Maintenance    Store commands for issuing from the CDBM screen.
 
  GROUP          Enter the group you want to store a command in.
 
  IMS COMMAND    Enter a valid IMS command to execute with the supplied data
 
  ACTION         A - Add a command to the command file.
                 B - Browse the contents of the command file.
                 D - Delete a command, only after it has been read.
                 R - Read a command from the file.
                 U - Update a command, only after it has been read.
 
                 Issue commands from the main screen in the format
                 /GROUP group command.
 
  Example        /GROUP SAMPLE DIS shows information for the databases in
 
 
 F3=Exit  F12=Cancel