This document describes the procedures for setting up and using Adabas Review after the installation has been completed.
If this is the first time you have installed Adabas Review, or you have loaded a new Adabas Review repository file, Adabas Review will automatically initialize:
the user profile system for controlling user access to Adabas Review; and
the Adabas Review data file, which designates a DBID and SVC for the Adabas Review repository, and installs the supplied Adabas Review reports.
The following describes Adabas Review's basic processing steps and any
input you need to provide:
The first time you start SYSREVDB and enter MENU, Adabas Review will detect whether the profiling system has been installed.
If it has been installed and you have user profiles already defined, Adabas Review will use those.
If it has not been installed, Adabas Review will install it automatically. It installs two profiles: one profile named DEFAULT and a profile with the same name as the user ID of the user initializing the system (the user who entered MENU). Both profiles have administrator privileges.
Immediately after Adabas Review addresses the installation and initialization of the user profile system, the following message appears before it starts initializing the Adabas Review data file.
Default user profiles were installed.
Press ENTER to continue.
Once you press ENTER, Adabas Review will automatically evaluate the Adabas Review user exits and RVCALL* programs on your current system.
If any Adabas Review user exits or RVCALL* programs are found in your environment, Adabas Review will recompile them so they work in the current release.
If they do not exist on your system, Adabas Review will install them automatically. While Adabas Review addresses the installation and initialization of the user exits, the following message appears:
Installing Sample User Exits
When user exit initialization is finished, Adabas Review will automatically detect if the repository is empty.
If it is not empty, continue with Step 7 (REGEN ALL).
If it is empty, Adabas Review displays the Initialization Process screen and waits for your input. The remainder of the processing steps involve initializing the Adabas Review data file and installing the supplied Adabas Review reports.
Initialization Process
Review has not yet been initialized.
The following process will initialize the
Review file and create sample reports and
target definitions.
You are about to save information into the
REVIEW repository.
The DBID/FNR of the REVIEW repository is
currently set to: DBID: 221
FNR: 50
If this is correct enter 'YES' to continue,
else press enter to cancel: ___
|
Confirm or cancel the initialization on this screen.
Confirm or cancel the initialization on the Initialization Process screen.
If the database ID (DBID) and file number (FNR) listed on this screen are correct for the Adabas Review repository, enter "YES" in the prompt to confirm the initialization.
To cancel the initialization, press ENTER (without "YES" specified).
If the initialization is confirmed, the Default Target Definition screen appears:
09:46:43 A D A B A S - R E V I E W 2020-02-10
REVIEW-DB (10,252) Main Menu Hub Target: 296
+------------------------------------------------+
+------------------------------------------------+
| Default Target Definition |
| |
| Please enter the appropriate SVC and Version |
| for Adabas DBID 221: |
| |
| Adabas SVC ...... ___ |
| Adabas Version .. ___ |
| |
| |
+------------------------------------------------+
| |
+------------------------------------------------+
Command: install db____________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Fin |
You are prompted to enter the Adabas SVC number and the Adabas version number of the database designated as the Adabas Review repository.
Type in the SVC and Adabas version number in the appropriate fields on the Default Target Definition screen and press ENTER. Based on the information you provide, Adabas Review creates the default target definition and displays a message.
The Initialization Process screen appears as shown in the following example:
09:50:25 ***** R E V I E W ***** 2020-02-10
Initialization Process
REV00104 - NOW CREATING DEFAULT TARGET DEFINITION
REV00054 - NOW CREATING SAMPLE REPORT SUMMARY REPORT BY FILE
REV00054 - NOW CREATING SAMPLE REPORT EXCEPTIONAL RESPONSE CODES
REV00054 - NOW CREATING SAMPLE REPORT LONG RUNNING COMMANDS
REV00054 - NOW CREATING SAMPLE REPORT COMMANDS BY HOUR
REV00054 - NOW CREATING SAMPLE REPORT RATE OF COMMANDS AND IOS BY HOUR
REV00054 - NOW CREATING SAMPLE REPORT RATE OF COMMANDS AND IOS BY DATE
REV00054 - NOW CREATING SAMPLE REPORT NATURAL SUMMARY
REV00054 - NOW CREATING SAMPLE REPORT WHO IS USING NATURAL
REV00054 - NOW CREATING SAMPLE REPORT NATURAL PROGRAM TRACE
REV00054 - NOW CREATING SAMPLE REPORT WHO USES SYSMAIN
REV00054 - NOW CREATING SAMPLE REPORT TRANSACTION COUNT BY JOB
REV00054 - NOW CREATING SAMPLE REPORT TRANSACTION COUNT BY JOB-NATAPPL
REV00054 - NOW CREATING SAMPLE REPORT TRANSACTION COUNT BY JOB-USER
REV00054 - NOW CREATING SAMPLE REPORT TRANSACTION COUNT BY NATURAL
REV00006 - PRESS 'ENTER' TO CONTINUE INITIALIZATION PROCESS
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- |
The reports supplied with Adabas Review are automatically added to the Adabas Review repository. As each report is added, a line is added to the Initialization Process screen. Each time the screen fills, you receive the following prompt:
Press ENTER to continue the initialization process
Press ENTER as requested; continue until all Adabas Review supplied reports are initialized.
When the display program SR/X-00001 does not exist or is not
executable, the installation process in SYSREVDB automatically triggers a
REGEN ALL. Thus the display programs for the system
reports and for all other existing report definitions will be (re-)generated.
For more information on the REGEN ALL procress, see
the description of the REGEN
ALL command in the section Command
Reference.
Two windows will open that display the progress of the
REGEN ALL command:
+--------------------------------------------------+ | Display program source is now being generated | | | | Report Name: SUMMARY REPORT BY FILE | | Program Name: SR-00001 | | | | <<< DO NOT PRESS ANY KEYS >>> | | | +--------------------------------------------------+ |
+--------------------------------------------------+ | Display programs will now be cataloged. | | This may take a while. | | | | For error log enter CATALL/<ENTR> on NEXT prompt | | in library SYSREVDB (or list member 0CATALL). | | <<< DO NOT PRESS ANY KEYS >>> | | | +--------------------------------------------------+ |
After all the reports are initialized and generated, you are returned to the Adabas Review main menu.
Note:
When you install into an existing Adabas Review Version 4.9.
environment, with an existing SYSREVDB and Adabas Review repository, a RECAT ALL will
be performed instead of a REGEN ALL.
To access Adabas Review:
Access Natural as you normally do.
At the NEXT prompt, log on to the library SYSREVDB (type LOGON SYSREVDB).
Notes:
At the NEXT prompt, type MENU and press ENTER to access the Adabas Review main menu :
09:52:31 A D A B A S - R E V I E W 2020-02-10
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 |
To confirm that Adabas Review is correctly installed, the installation is verified each time you enter the Adabas Review online subsystem.
The following errors may be detected under Com-plete:
| ADAPRM IS MISSING FROM THE PARAMETER LIST | |
| Explanation |
The Natural ADAPRM area was not passed in the parameter list for the Adabas call. The value ADAPRM=ON was not set correctly in the parameter module (NATPARM) for the Natural nucleus currently executing. |
| Action |
Use the procedure in the installation documentation to correctly add ADAPRM=ON to the Natural NATPARM parameter module. |
| USER BUFFER EXTENSION NOT LARGE ENOUGH | |
| Explanation |
The user buffer extension is not large enough for Adabas Review to pass data to Adabas. The parameter LRVINFO was not set correctly in the Adabas/Com-plete link routine |
| Action |
Use the procedure in the installation documentation to correctly install the Adabas Review link routine exit in the Adabas/Com-plete link routine. |
| THE ADABAS REVIEW LINK ROUTINE IS NOT CORRECTLY INSTALLED | |
| Explanation |
The Adabas Review link routine exit is not installed in the copy of the link routine currently being executed. |
| Action |
Use the procedure in the installation documentation to correctly install the Adabas Review link routine exit in the link routine. |
| THE ADABAS REVIEW REPOSITORY HAS NOT BEEN INITIALIZED | |
| Explanation |
Adabas Review could not initialize because the repository file has not been initialized. |
| Action |
Use the procedure described in section Starting Adabas Review for the First Time to correctly initialize the repository file. If the problem persists, contact your Software AG technical support representative. |
The following errors may be detected under TSO/Batch:
| USER BUFFER NOT LARGE ENOUGH | |
| Explanation |
The user buffer (UB) extension is not large enough for Adabas Review to pass data to Adabas. The parameter LRVINFO was not set correctly in the Adabas/batch link routine. |
| Action |
Use the procedure in the installation documentation to correctly install the Adabas Review link routine exit in the Adabas/batch link routine. |
| ADAPRM IS MISSING FROM THE PARAMETER LIST | |
| Explanation |
The Natural ADAPRM area was not passed in the parameter list for the Adabas call. The value ADAPRM=ON was not set correctly in the parameter module (NATPARM) for the Natural nucleus currently executing. |
| Action |
Use the procedure in the installation documentation to correctly add ADAPRM=ON to the Natural NATPARM parameter module. |
| THE ADABAS REVIEW LINK ROUTINE IS NOT CORRECTLY INSTALLED | |
| Explanation |
The Adabas Review link routine exit is not installed in the copy of the Adabas/batch link routine currently being executed. |
| Action |
Use the procedure in the installation documentation to correctly install the Adabas Review link routine exit in the Adabas/batch link routine. |
| THE ADABAS REVIEW REPOSITORY HAS NOT BEEN INITIALIZED | |
| Explanation |
Adabas Review could not initialize because the repository file has not been initialized. |
| Action |
Use the procedure described in section Starting Adabas Review for the First Time to correctly initialize the repository file. If the problem persists, contact your Software AG technical support representative. |
The following errors may be detected under CICS:
| USER BUFFER NOT LARGE ENOUGH | |
| Explanation |
The user buffer extension is not large enough for Adabas Review to pass data to Adabas. The parameter LRVINFO was not set correctly in the Adabas/CICS link routine. |
| Action |
Use the procedure in the installation documentation to correctly install the Adabas Review link routine exit in the Adabas/CICS link routine. |
| ADAPRM IS MISSING FROM THE PARAMETER LIST | |
| Explanation |
The Natural ADAPRM area was not passed in the parameter list for the Adabas call. The value ADAPRM=ON was not set correctly in the parameter module (NATPARM) for the Natural nucleus currently executing. |
| Action |
Use the procedure in the installation documentation to correctly add ADAPRM=ON to the Natural NATPARM parameter module. |
| THE ADABAS REVIEW LINK ROUTINE IS NOT CORRECTLY INSTALLED | |
| Explanation |
The Adabas Review link routine exit is not installed in the copy of the Adabas/CICS link routine currently being executed. |
| Action |
Use the procedure in the installation documentation to correctly install the Adabas Review link routine exit in the Adabas/CICS link routine. |
| THE ADABAS REVIEW REPOSITORY HAS NOT BEEN INITIALIZED | |
| Explanation |
Adabas Review could not initialize because the repository file has not been initialized. |
| Action |
Use the procedure described in section Starting Adabas Review for the First Time to correctly initialize the repository file. If the problem persists, contact your Software AG technical support representative. |