Version 4.5.1
 —  Concepts and Facilities  —

Getting Started

This document tells you how to log on to Adabas Review, use the online help system, use function codes, PF keys and commands, and how to end your Adabas Review session. It is organized in the following topics:


Accessing Adabas Review

Adabas Review is a standard Natural application that resides in the Natural library SYSREVDB.

Start of instruction setTo access Adabas Review:

  1. Access Natural as you do normally.

  2. At the NEXT prompt, enter LOGON SYSREVDB.

  3. At the prompt, enter MENU.

Your Adabas Review administrator can tell you if an alternative logon procedure has been defined.

When you log on to Adabas Review, the Main Menu screen is displayed.

This section covers the following topics:

Main Menu

20:35:09                  A D A B A S  -  R E V I E W                2009-04-30
                                   Main Menu                         LOCL=00222
                                                                               
                  Code               Description                               
                  ----     ---------------------------------                   
                   AA           Available Adabas Nuclei                        
                   AO           Adabas Online System                           
                   EB           Edit Buffer Pool Report                        
                   EL           Edit Pulse Report                              
                   ER           Edit Report Definition                         
                   ET           Edit Target Definition                         
                   EX           Edit Cluster Services Report                   
                   LH           List History Reports                           
                   LR           List Report Definitions                        
                   LS           List Started Reports                           
                   LT           List Target Definitions                        
                   UP           User Profiles                                  
                  ----     ---------------------------------                   
                                                                               
                                                                               
                                                                               
Command: ______________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Fin                                                   Fin    

Notes:

  1. For an explanation of the commands in the Code column in the screen above, read Commands.
  2. LOCL= and HUB= are found in the top right corner of every screen.
    In the screen pictured above, LOCL=00222 means that database 222 is being administered, running in local mode. HUB=201 means that a hub is administered.
    If the message REV00362 - REVIEW IS NOT INSTALLED IN DATABASE 210 in conjunction with display of HUB=210 (in the right top corner) is displayed, then the database 210 is not a HUB and also does not run with Adabas Review in local mode. Changing to a database or HUB is done using the DBID or HUBcommands.

General Use PF Keys

The following PF keys are available on many of the Adabas Review screens:

PF Command Description
1 Help Access the help system.
3 Exit Return to the previous screen.
7 - Scroll backward through a list display.
8 + Scroll forward through a list display.
12 Menu Return to the Adabas Review Main Menu.

Other Adabas Review commands and PF keys are local to a particular function or screen. These commands are usually shown on the relevant screen and have PF keys assigned to them.

Commands used in the list functions are not displayed on the screen. These commands may be displayed by using the online help system.

Top of page

Using Function Codes

Adabas Review is menu-driven. A series of function codes and commands are used to navigate through its functions. Functions may contain several "layers" of screens.

Entering function codes singly accesses one layer at a time; entering a string of function codes enables you to bypass intervening screens and go directly to the screen you want.

For example, you can list the reports that have been started (LS) for Adabas Review by entering the following on the command line of the Adabas Review main menu:

LS

The LS code accesses the Started Reports screen.

Top of page

Using Adabas Review Commands

Commands are used to perform specific tasks within a function.

Start of instruction setTo issue an Adabas Review command:

  1. type the command on the command line and press ENTER

    Or:
    press the PF key corresponding to the command, if one has been defined.

A command may be included in a string, provided the command is the last element.

Some commands are standard throughout Adabas Review, and may be issued from any screen. These include the following:

Command PF Description
COLOR OFF Returns to non-color display.
COLOR ON Displays color attributes, if applicable.
EXIT 3 Terminates the function and returns you to the menu screen that precedes it.
FIN or QUIT 12 Terminates the Adabas Review session. Assigned to PF12 on the Adabas Review Main Menu.
HELP or ? 1 Displays the help screens for a particular screen or field. ? is used to display help for a specific field.
LOGO Displays the Adabas Review logo screen.
MENU 12 Terminates the function, and returns you to the Adabas Review Main Menu.
MSG Displays detailed explanations of Adabas Review messages. May be issued with or without a message number. If no message number is included, Adabas Review displays the explanation for the last message received, unless you have changed the Adabas Review screen or performed a different Adabas Review function since the message was displayed. In this case, specifying the MSG command without a message number produces an error.

Other Adabas Review commands are local to a particular system or function. These commands are usually listed on the relevant screen and have PF keys assigned to them.

Line commands used in the list functions are not displayed on the screen. These commands may be displayed by using the online help system.

Top of page

Using the Online Help System

Online help is available for Adabas Review functions at any time during the Adabas Review session. You may view general help screens describing functions and commands or, if available, help windows for a specific data entry field:

Start of instruction setTo access the general help screens:

  1. Press PF1

    Or:
    Enter the HELP command on the command line.

Start of instruction setTo access specific help windows:

  1. Enter a question mark ( ? ) on the data entry field.

    If specific help is not available, the general help for the screen is displayed.

The following PF keys are available within the online help system:

PF Command Description
3 Exit Exits from the display.
7 - Scrolls one page backwards.
8 + Scrolls one page forward.
9 -- Scrolls to the top of the text.
10 ++ Scrolls to the bottom of the text.
12 Menu Returns to the Adabas Review Main Menu.

Top of page

Accessing Adabas Review Repositories

The Adabas Review repository is an Adabas file used for storing report definitions, historical data, and target definitions for Adabas Review.

Depending on the configuration at your site, more than one Adabas Review repository may be associated with your system. For example, if your site has Adabas Review installed on more than one database, there may be an Adabas Review repository for each database.

Using the SETFILE Command

The Review command SETFILE (or SET) and SETALL (or SETA) may be used to access different Adabas Review repositories and the reports stored on them.

The SETALL command differs from the SETFILE command in that it allows you to also change the current DBID/HUBID where Adabas Review is communicating. Changing this value has the same effect as entering DBID=nnnnn or HUB=nnnnn into the command line.

Start of instruction setTo access different Adabas Review repositories:

  1. Enter the command SETFILE or SET on the command line of any Adabas Review screen and press ENTER.

  2. Provide the DBID and FNR for the Adabas Review repository you wish to access and press ENTER.

    You are now able to access reports stored on a different Adabas Review repository. The setting remains until you either change it again or log off Adabas Review.

Top of page

Accessing Technical System Information

The TECH command provides access to information about the Adabas Review system. It invokes the Technical Information function, which displays Adabas Review environmental and maintenance information. This function is useful for determining

You can access the Technical Information function from

Start of instruction setTo access technical system information:

  1. Type TECH on the command line of one of the appropriate screens and press ENTER.

The TECH command Database System Environment screen is the first to appear:

+----------------------------------------------------------------------------+
! 10:07:43               REVIEW Technical Information            2009-06-01  !
!                        DATABASE System Environment                         ! 
!                                                                            ! 
!         Current REVIEW Target.......... 15690                              ! 
!         REVIEW Nucleus version ........ 4.5.0                              ! 
!                                                                            ! 
!         Link routine exit version ..... 4.5                                ! 
!         Link routine exit status ...... Installed correctly                ! 
!                                                                            ! 
!         Repository status ............. FILE AVAILABLE                     ! 
!         Repository dbid ............... 15650                              ! 
!         Repository fnr ................ 50                                 ! 
!                                                                            ! 
!         NATURAL nucleus version ....... 4.2                                ! 
!         REVIEW NATURAL code version ... 4.5.1                              ! 
!                                                                            ! 
!         TP monitor type ............... TSO                                ! 
!                                                                            ! 
!                                                                            ! 
!                                                                            ! 
!                                                                            ! 
! Press PF2 for REVIEW fix list, ENTER to exit                               ! 
+----------------------------------------------------------------------------+

From this screen, you can

The Database System Environment screen displays information about the following environment variables:

Field Description
Current Review target Database ID in local mode or the hub ID in hub mode.
Review nucleus version Version of Adabas Review, either local or for the given Adabas Review hub.
Link routine exit version Version of the Adabas Review link routine exit for the TP monitor currently being used.
Link routine exit status Status of the Adabas Review link routine exit for the TP monitor currently being used.
Repository status Status of the Adabas Review repository identified by the repository DBID.
Repository DBID Database of the Adabas Review repository. The default corresponds to NTFILE 241 in the Natural NATPARM parameter module. This database cannot be in the hub address space.
Repository FNR File number of the Adabas Review repository.
Natural nucleus version Version of Natural currently installed at the user's site.
Review Natural code version Version of the Natural code of the Adabas Review software.
TP monitor type Type of TP system currently being used.

Start of instruction setTo obtain information about maintenance (ZAPs):

  1. Press PF2 from the Database System Environment screen.

    The TECH command Review Technical Information screen appears displaying the first set of maintenance (ZAP) information:

    +----------------------------------------------------------------------------+
    ! 12:53:16               REVIEW Technical Information            2003-07-07  ! 
    !    Released/test zaps applied to REVIEW nucleus code for database 204      ! 
    !                                                                            ! 
    ! 2001                                                                       ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    !                                                                            ! 
    ! Press PF2 to see optional zaps, ENTER to exit                              ! 
    +----------------------------------------------------------------------------+

    From this screen, you can

Maintenance information screens display, by number, all of the ZAPs that have been applied to the current version of Adabas Review.

The ZAP numbers are displayed in rows, from left to right in the order they were applied. If the maintenance screen displays released/test ZAPs, the test ZAPs are highlighted. Other maintenance screens display optional ZAPs.

The types of maintenance screens available vary with the operating environment in which Adabas Review resides. Any or all of the following maintenance information screens may be displayed:

Note:
For z/VSE systems, the first and the second screen display all zaps that are applied to the Adabas Review nucleus and the Adabas Review link routine exit.

Top of page

Ending a Session

An Adabas Review session may be ended in any one of the following ways:

Start of instruction setTo end the current function and return to the menu from which the function was called:

  1. Press PF3; or enter the EXIT command on the command line and press ENTER .

Start of instruction setTo end the function you are using and return to the Adabas Review Main Menu:

  1. Press PF12; or enter the MENU command on the command line and press ENTER.

Start of instruction setTo end your Adabas Review session from the Adabas Review Main Menu:

  1. Press PF3 (Exit); or enter the QUIT command on the command line and press ENTER.

    Or:
    Press PF12 (Fin); or enter the FIN command on the command line and press ENTER.

Start of instruction setTo end your Adabas Review session without returning to the Main Menu:

  1. Enter the FIN command on the command line and press ENTER

    Or:
    Enter the QUIT command on the command line and press ENTER.

Top of page