Version 4.5.1
 —  Using Adabas Review  —

Maintaining Display Programs

When a report is saved, Adabas Review automatically generates a Natural program that is used to display the data collected by the report. When you issue the VW command for a history report or a report that has been started, the generated display program is executed and the data is displayed on your terminal screen.

This part of the documentation discusses the commands that enable you to process the Natural display program corresponding to a report definition. It covers the following topics:


Generating a Display Program

One way to create new reports is to use the Copy Report Definition (CR) command from the List Report Definitions (LR) function. The CR command is issued from the Report Definitions screen. The command allows you to copy a report definition either to another Adabas Review repository, or to the current Adabas Review repository under a new name.

After the report definition is copied, the Display Program Name on the screen will display the message "Need RG". This indicates that the display program must be generated before the new report may be displayed.

Start of instruction setTo generate a display program:

  1. Enter RG on the selection line preceding the new report name; or

    Or:
    Edit the report using the Edit Report (ER) function; then save it.

    Adabas Review automatically generates a new display program reflecting the changes. See the section Regenerating a Display Program (RG) for other reasons to use the RG command.

Top of page

Editing the Display Program

You may edit a display program from any of the report list function screens (LR, LS, and LH). The EP command invokes the Natural program editor, enabling you to make changes to the display program in the same way that you would edit any other Natural program.

Using the EP command, you can customize the appearance of your report displays. Note, that a change to the display program only affects the way the collected data is presented on the screen; it does not change the data collected by the report.

If, for example, you add a display field that does not correspond to the field information collected by the report, no information will be collected for that field and it will appear blank when the display program is executed.

However, if you use the ER function to make changes to a report definition and save the changes, Adabas Review automatically generates a new display program reflecting the changes.

Start of instruction setTo edit the display program:

  1. Enter the EP command on the selection line preceding the specified report name.

    The Natural editor is invoked and the display program is ready to be edited.

  2. Issue either the SAVE or STOW commands to save changes, as you would when editing any other Natural program.

  3. Issue the QUIT command to return to Adabas Review.

Top of page

Regenerating a Display Program

If you wish to restore an edited display program to its original format, you may issue the RG command from the Report Definitions screen (LR function). Adabas Review then regenerates the display program.

Start of instruction setTo regenerate a display program:

  1. Enter the RG command on the selection line preceding the report name.

    A message is displayed when the regeneration is completed.

Top of page

Regenerating All Display Programs

You can regenerate the display programs for all reports by entering REGEN ALL into the command line from the LR screen. A window will open that displays the name of each report as it is regenerated (see below). Do not press any keys during this process, as it will interrupt the process.

+-----------------------------------------------------------+
|              Display program is now being generated       |
|                                                           |
|         Report Name:  FILE USAGE                          |
|          Program Name: SR-00031                           |
|                                                           |
|         <<<  DO NOT PRESS ANY KEYS  >>>                   |
|                                                           |
+-----------------------------------------------------------+

Top of page

Changing to a Different Display Program

If desired, you may use a display program that is different from the one that was generated for the report by Adabas Review.

You may change the display program from the Report Definitions screen (LR function).

Start of instruction setTo change display programs:

  1. Enter the command CP on the selection line preceding the report name.

    The cursor moves to the display program name.

  2. Type the name of the new display program over the existing name and press ENTER.

    A message appears, indicating that the display program has been changed.

Top of page