Once the database has been identified, tlmenu displays a main menu
entitled Administration Options, similar to that shown below.
Transaction Logging Menu System Fri Jan 12 10:25:12 2007 Database name : drtestslv Host name : gate10 State : Transaction Handling/Logging enabled Administration Options ====================== 1. Routine Maintenance 2. Configuration and Setup 3. Database Recovery 4. Miscellaneous 5. Disaster Recovery Configuration and Maintenance S. Show Logging Status (from any menu) Enter option (1-5,S) :
Selection of each main menu option displays a sub-menu with another set of options. The sub-menu displayed varies according to the option selected and whether Shadow Database or FailSafe is being supported.
Note: Option 5 (Disaster Recovery Configuration and Maintenance) is only available if you have purchased the optional Disaster Recovery feature.
When you enter a number to select a sub-menu option, a procedure is started consisting of a sequence of message prompts which guide you through the actions required to complete the option. Various prompts are displayed, requiring you to enter data, execute an action or simply confirm that you wish to continue with the procedure. Each prompt message gives you the opportunity to abort the procedure, or leave tlmenu completely if you realise that you have made a mistake.
This section contains step-by-step descriptions of the actions required to execute each procedure. It details many, although not all, of the prompts that you will see.
Some prompts, which just ask for confirmation to continue, are not specified. e.g. the message prompt right at the beginning of each procedure.
Replies to prompts which are common throughout the procedures have the following general effects:
y (yes) Selects the option and causes
tlmenu to execute
the current action, or confirms that you wish to continue with the procedure.
Caution
If you
enter y
you may be starting an action that is irreversible. Ensure that you
understand the proposed action and that you wish to continue with it before
selecting this option.
n (no) Causes
tlmenu to abort the current procedure and
return to the sub-menu or skip to another prompt.
q (quit) Causes
tlmenu to abort the procedure and exit to
the system command shell, UNIX or Windows as appropriate.
Hit Return to continue
Causes tlmenu to continue with the execution of the procedure when
you press RETURN. Its purpose is usually
to allow the results of a previous operation to be reviewed before continuing.
You can automate the execution of tlmenu completely by directing standard input from a file containing a list of all responses required by the tlmenu prompts. Example 3 shows how this can be done.
The following section shows two simple examples of the tlmenu syntax and one more complicated example where standard input is redirected from a file to automate a tlmenu procedure.
To administer the default database, you need only enter:
tlmenu
at the host command prompt.
To administer the database 'dbase2' located in your current directory, enter:
tlmenu dbase2
To automate the secondary save procedure completely, you can redirect input from a file. For example, sec_fs, in your current directory. Enter:
tlmenu <sec_fs
sec_fs contains the following list of responses to carry out a secondary save:
Note: These responses assume that the secondary backup method is FILE-SAVE.
Caution
This example of redirection from an input file is dependent on a specific set of menu options and prompts being supplied by tlmenu. Note, however, that when upgrading to a new version of Reality, tlmenu may contain enhancements which affect the menu structures and prompt sequences. It may therefore be necessary to modify the list of responses in the input file in order to make it compatible with the new tlmenu.
1 |
(Select Option 1 Routine Maintenance) |
7 |
(Select Option 7 to Save secondary) |
y |
(Enter 'yes' to continue) |
1 |
(Enter '1' to switch today's clean log) |
y |
(Enter 'yes' to confirm clog switch) |
y |
(Enter 'yes' to pause updates) |
y |
(Enter 'yes' to archive clean log) |
y |
(Enter ‘yes’ to run archive on secondary) |
1 |
(Enter tape no. for clean log archive) |
n |
(Enter ‘no’ so as not to suppress VERIFY-SAVE) |
n |
(Enter ‘no’ to specify a single-reel save) |
| (Accept default tape record length for save) | |
2 |
(Enter tape no. for save) |
6250 |
(Enter tape density) |
F/S 17/8/99 |
(Enter tape label) |
09:00 |
(Enter time to start save on the secondary database) |
y |
(Enter 'yes' to continue with archive) |
y |
(Enter 'yes' to delete clogs) |
y |
(Enter 'yes' to resume secondary updates before VERIFY-SAVE) |
y |
(Enter 'yes' to start save) |
| (RETURN to return to the Routine Maintenance Menu) | |
| (RETURN to return to the main menu) | |
| (RETURN to exit tlmenu) |