Getting Started

This document tells you how to log on to Adabas Review online (SYSREVDB), 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 Online

• Using Function Codes

• Using Adabas Review Commands

• Using the Online Help System

• Accessing Adabas Online System (AOS) from SYSREVDB

• Accessing Adabas Review Repositories

• Accessing Technical System Information

• Ending a Session

Accessing Adabas Review Online

Adabas Review can be accessed online via a standard Natural application that resides in the Natural library SYSREVDB.

To access Adabas Review online via SYSREVDB:

1. Access Natural as you do normally.

2. At the NEXT prompt, enter LOGON SYSREVDB.

3. At the prompt, enter MENU.

   If you are running in hub mode and if the default hub ID is specified as "AUTO", the value is determined from the SVC of the current Natural session. If there is a single hub running under the current SVC, that hub ID is used. If more than one hub ID is active, the following pop-up dialog appears. (If no hub is running, the value is determined as if "LFILE" were specified.)

   NEXT menu LIB=SYSREVDB Logon accepted to library SYSREVDB. Available Review Hubs on SVC 237 Please choose a Review Hub --------------------------------------------- _ 00041 _____ _____ _____ _ 00558 _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7-- Exit

   Type any character next to the hub you want to use and press Enter.

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

• General Use PF Keys

Main Menu

14:31:25                  A D A B A S  -  R E V I E W                2020-02-07
REVIEW-DB (10,252)                 Main Menu                  Hub Target: 296  
                                                                              
                  Code               Description                              
                  ----     ---------------------------------                  
                   AA           Available ADABAS Nuclei                       
                   AH           Available Review Hubs                         
                   AO           ADABAS Online System                          
                   ER           Edit Report Definition                        
                   ES           Edit Specialty Reports                        
                   ET           Edit Target Definition                        
                   LC           List Scheduled Reports                        
                   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        Exit                                                  Fin

Notes:

1. For an explanation of the commands in the Code column in the screen above, read Commands.
2. In the top right corner of most screens, Target: nnnnn will appear. This denotes the database or Hub where Adabas Review is running.
3. The Target may be changed to another target that is running Adabas Review by entering the DBID or HUBID directly into this field. You may also use the command line directives DBID=nnnnn or HUB=nnnnn to accomplish the same results.

General Use PF Keys

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

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.

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.

Using Adabas Review Commands

Commands are used to perform specific tasks within a function.

To 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:

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.

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:

To access the general help screens:

1. Press PF1

   Or:
   Enter the HELP command on the command line.

To 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:

Accessing Adabas Online System (AOS) from SYSREVDB

Adabas Online System (AOS) is a selectable unit of Adabas that enables database administrators to monitor and change aspects of an Adabas database interactively. Refer to the Adabas DBA Tasks Manual and the Adabas Online System documentation for more information.

If Adabas Online System is installed on your system and you have access privileges to it, you can access it from Adabas Review.

To access Adabas Online System from Adabas Review:

• Enter the code AO on the command line.

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.

To 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.

Accessing Technical System Information

The TECH command provides access to information about the Adabas Review system. It invokes the Database System Environment screen, which displays Adabas Review environmental and maintenance information. This function is useful for determining:

• the environment in which Adabas Review is executing; and

• the maintenance (zaps) applied to the current version of Adabas Review.

You can access the Database System Environment screen from:

• the Main Menu

• the List Report Definitions (LR) screen

• the List Started Reports (LS) screen

• the List Scheduled Reports (LC) screen

This section describes the information you can obtain:

• Reviewing Technical System Information

• Reviewing Zap Information

• Reviewing Natural Object Zap Information

Reviewing Technical System Information

To 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:

14:33:51                  A D A B A S  -  R E V I E W                2020-02-07
REVIEW-DB (10,252)        DATABASE System Environment         Hub Target: 296  
                                                                               
                                                                             
 Review Target                                TP Monitor                     
 DBID/HUBID ................ 296              Monitor .............. COMPLETE
 SVC ....................... 249              Vers .................. 6.8_SP1
 Vers .................. 4.9_SP1                                             
 zIIP ................... Active              REVEXIT1                       
 Review Repository                            Vers .................. 4.8_SP2
 DBID .................... 20000              Status .... Installed Correctly
 File ...................... 149              State .................. Active
 Status ......... File Available                                              
                                              REVEXIT2                       
 Natural                                      Vers .................. 4.8_SP2
 Natural Vers .......... 8.2_SP7              Status .... Installed Correctly
 SYSREVDB Vers ......... 4.9_SP1              State .............. Not Active
 ADATMZ Vers ........... 8.3_SP4              Client .................... Off
 
                                                                           
Press PF2 for REVIEW fix list, ENTER to exit                                 
Command: ______________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help  Fixes Exit  NatFx Confi                                     Menu

From this screen, you can:

• Press PF1 to invoke help from any screen.

• Press PF2 to obtain information about updates (zaps) to Adabas Review nucleus code. The Review Fixes Information screen appears. For more information about these screens, read Reviewing Zap Information.

• Press PF4 to obtain information about updates (zaps) to Adabas Review database Natural objects. For more information, read Reviewing Natural Object Zap Information.

• Press PF5 to obtain information about the parameters specified in the CONFIGDB text file. For more information, read about CONFIGDB in the Command Reference.

• Press ENTER to exit the Database System Environment screen.

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

Reviewing Zap Information

To obtain information about updates (zaps) that have been applied:

1. Press PF2 from the Database System Environment screen.

   The Review Fixes Information screen appears displaying maintenance (zap) information for the nucleus first:

   +--------------------------------------------------------------------------------+ ! 11:11:17 Review Fixes Information 2016-04-27 ! ! Zaps applied to the Review nucleus for target 204 ! ! ! ! 1001 1002 1003 1004 **** 1006 1007 1008 1009 1010 1011 **** 1013 **** 1015 ! ! 1016 **** 1018 1019 1020 **** **** 1023 1024 1025 ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! Press PF2 to see optional zaps, ENTER to exit ! +--------------------------------------------------------------------------------+

   From this screen, you can:

   • Press PF1 to invoke help from any screen.

   • Press PF2 to continue to cycle through the maintenance information screens, providing information on nucleus zaps, optional (special) nucleus zaps, REVEXIT1 zaps and optional (special) zaps, and zaps (updates) to Adabas Review Natural objects.

   • Press ENTER to exit the Review Fixes Information screen.

Maintenance information screens display, by number, all of the zaps that have been applied to the current version of Adabas Review. When you press PF2, the maintenance screens cycle in the following sequence:

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:

• zaps (released/test, and optional) applied to Adabas Review nucleus for the database or hub;

• zaps (released/test, and optional) applied to Adabas Review link routine exit;

• INPLs (released/test) applied to the Adabas Review Natural code; and

• dependent and independent zaps applied to the Adabas link routine (ADALNK).

Reviewing Natural Object Zap Information

To obtain information about updates (zaps) to Adabas Review database Natural objects:

1. Press PF4 from the Database System Environment screen.

   The Review Fixes Information - Updates to Review Natural objects screen appears displaying the first set of maintenance (zap) information. From this screen, you can:

   • Press PF1 to invoke HELP from any Technical Information function screen.

   • Press ENTER to exit the Review Technical Information screen.

Ending a Session

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

To 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 .

To 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.

To 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.

To 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.