tlmenu Menus and Procedures

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 2016
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
       6. Clean Log Export Configuration and Maintenance		
       S. Show Logging Status (from any menu)

       Enter option (1-6,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 available only if you have purchased the optional Disaster Recovery feature.

tlmenu is sensitive to enhancement keys. In the above mentioned Administration Options, the Clean Log Export Configuration and Maintenance option is at position 6 as a Disaster Recovery Configuration and Maintenance option is also present.

Replies to prompts

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.

Using an input file to automate procedures

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 below shows how this can be done.

Examples

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.

Example 1

To administer the default database, you need only enter:

tlmenu

at the host command prompt.

Example 2

To administer the database 'dbase2' located in your current directory, enter:

tlmenu dbase2

Example 3

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)