This section of the documentation provides installation procedures for Adabas Review 4.3.2 in local mode under the z/VM operating system environment.
If you are also installing Review Data Communication or Review Natural Monitor, refer to the installation documentation for that system. Note that with version 4.3.2, the Adabas Review menu system has been completely disconnected from these products. The User Profile system that was formerly common to all of these products is now independent for each. Adabas Review profile data is now encrypted for enhanced security.
This document covers the following topics:
Adabas Review 4.3.2 under z/VM (local mode only) requires
Adabas version 7.4.2 or above; it does not support Adabas version 5 and 6 databases.
Natural version 2.3.4 or above.
Note:
There are specific version requirements for Review 4.3.2 in both
local and hub mode. See section Review 4.3 Version
Compatibility in the Review 4.3.2 Release Notes
for a detailed matrix of these version requirements.
The installation tape is a standard label cartridge that is valid for the z/VM operating system only. Refer to the Report of Tape Creation for the correct volume serial number, density, media type, datasets, and dataset sequence numbers for the SM level being installed.
The following sections describe the contents of the Adabas Review installation tape and provides the space requirements for each dataset.
The Adabas Review installation tape is a 3480 cartridge, standard label tape with volume serial number REV43s, where s is the current system maintenance level. The tape contains the following datasets:
CMSLIB product distribution files
Created using the CMS
TAPE DUMP command.
INPL dataset
RECFORM=VB,RECSIZE=4624,BLKSIZE=4628
LAST.LABEL.CMS
RECFORM=FB,RECSIZE=80,BLKSIZE=80
The
last dataset on the tape.
Software AG recommends that Adabas Review be installed on a separate minidisk that can be accessed by the DBA virtual machine. A 5-cylinder minidisk is required if you are using a 3380 device type.
The programs and buffers required by Adabas Review total approximately 500 kilobytes. You may need to increase the size of your Adabas z/VM machine accordingly.
z/VM files for Adabas Review are as follows:
| File Name | File Type | Used to ... |
|---|---|---|
| REVINPL | EXEC | INPL the Adabas Review programs and DDMs from the INPL dataset to the Natural system files. |
| REVLINK | EXEC | regenerate an ADALNK module with Adabas Review routines. |
| REVDBFIL | LODLIB | load the Adabas Review repository. |
| REVHIST | EXEC | populate the Adabas Review repository with history data. |
| REVAUTO | EXEC | refresh the Adabas Review autostarted report parameter files. |
| REV43 | FILEDEFS | list file definitions to be added to the Adabas startup EXEC. |
| REV43 | LODDATA | input to ADALOD; the Adabas Review repository file in ADAULD format. |
| REV43 | REVAUT1 | contain Adabas Review parameters. |
| REV43 | REVAUT2 | contain Adabas Review parameters. |
| REV43 | RVUEXI | contain Adabas Review parameters. |
| REV43 | RVUFLD | contain user-defined field parameters. |
The following section provides instructions for copying the contents of the installation tape to disk. Examples for accomplishing the transfer are also included.
Note that this installation procedure assumes that Adabas Review is installed on a separate minidisk that can be accessed by the DBA virtual machine.
Log on to the DBA virtual machine and access as READ/WRITE the minidisk that will contain the Adabas Review 4.3.2 installation files.
Attach a tape drive to the DBA virtual machine and mount the Adabas Review installation tape on that tape drive
Keep the tape drive attached after completing this step because it will be needed in step 1 of the section Install Adabas Review under Natural.
Issue the following z/VM commands:
TAPE REW (cuu TAPE FSF n TAPE LOAD * * fm (ccu
where
| cuu | is the virtual device address for the tape drive |
| n | is from the tape creation report |
| fm | is the filemode of the Adabas Review minidisk |
INPL the Adabas Review programs and DDMs from the INPL dataset to your Natural system files.
You may use any of your site-dependent Natural INPL EXEC. A sample EXEC, REVINPL, is provided in the Adabas Review source library.
To INPL the Adabas Review Natural programs and DDMs, invoke the REVINPL EXEC by entering the following:
REVINPL
You will be prompted for the virtual device address of the tape drive, the Adabas DBID, the Natural system file number, and the name of the Natural module to execute. This EXEC will position the tape properly and load the Adabas Review programs and DDMs.
Include the following parameter settings in the Natural version 2.3 profile:
| Parameter | Requirement |
|---|---|
| LS=250 | minimum |
| PS=80 | minimum |
| MADIO=5000 | minimum |
| MAXCL=0 | minimum |
| ESIZE=40 | minimum |
| ADAPRM=ON | required. ADAPRM=ON must be specified in order to use Adabas Review to report on Natural information. |
| NTWORK(7),AM=PC | required for PC downloads. NTWORK is a Natural macro used to define the work file(s) to be used; 'AM' is the access method. For more information, see the Natural documentation. |
Add a Natural NTFILE definition for the physical database ID and file number of the Adabas Review repository as follows:
NTFILE ID=241,DBID=dbid,FNR=fnr
Replace dbid and fnr with the database ID and the file number, respectively, of the Adabas Review repository.
Note:
The Adabas Review repository may not reside on a database with a
database ID (DBID) of 255. If the database ID is 255, Adabas Review cannot be
accessed in local mode.
Reassemble the NATPARM module; run the NATBLDM EXEC to regenerate the NATURAL nucleus.
Note:
Information about the NATBLDM EXEC can be found in the Natural
documentation.
Add a Natural NTFILE definition for the physical database ID and file number of the Adabas Review repository as follows:
NTFILE ID=241,DBID=dbid,FNR=fnr
Replace dbid and fnr with the database ID and the file number, respectively, of the Adabas Review repository.
Note:
The Adabas Review repository may not reside on a database with a
database ID (DBID) of 255. If the database ID is 255, Adabas Review cannot be
accessed in local mode.
Reassemble the NATPARM module; run the NATBLDM EXEC to regenerate the NATURAL nucleus.
Note:
Information about the NATBLDM EXEC can be found in the Natural
documentation.
If Natural Security is installed:
Define the SYSREVDB library for the Adabas Review system.
Note:
If the Adabas Review application SYSREVDB is made private (i.e.,
the parameter PEOPLE=Y is specified), each user of Adabas Review must be linked
to the SYSREVDB application.
Define the following Adabas Review DDMs to Natural Security as public DDMs:
REVIEW-ADABAS-V431-CLOG REVIEW-FNAT REVIEW-ADABAS-V431-SYSTEM
Define the following Adabas Review DDMs to Natural Security as public DDMs:
REVIEW-ADABAS-V431-CLOG REVIEW-FNAT REVIEW-ADABAS-V431-SYSTEM
The Adabas Review repository is a system file used for storing descriptions of interactive reports, target definitions, and for saving historical data accumulated by Adabas Review reports.
Any Adabas file may be used to contain the Adabas Review repository. The corresponding file number should also be reflected in the NATPARMs used to invoke Adabas Review.
Notes:
Edit the file REVDBFIL LODLIB and make any necessary changes to the ADALOD statements. You must change the LOAD FILE=fnr statement to reflect the number of the file that will contain the Adabas Review file.
Note:
The ADALOD EXEC requires that REVDBFIL LODLIB
and REVDBFIL LODDATA have a file mode of "A". If
necessary, copy REVDBFIL LODLIB and REVDBFIL
LODDATA to the A disk of the CMS machine from which ADALOD EXEC will
be run.
On the CMS command line, enter the following command depending on whether ADALOD is run in single-user mode or multiuser mode:
Single-user mode
ADALOD REVDBFIL dbid
Multiuser mode
ADALOD REVDBFIL dbid MULTI
where dbid is the ID of the database that will contain the Adabas Review repository.
Note:
The Adabas Review repository may not reside on a database with a
database ID (DBID) of 255. If the database ID is 255, Adabas Review cannot be
accessed in local or hub mode. However, a database with a DBID of 255 can send
data to a hub.
Examine the output to ensure that the file was loaded.
Examine the output to ensure that the file was loaded.
Modify your existing Adabas ADARUN parameters to include the following:
ADARUN PROGRAM=ADANUC ADARUN REVIEW=LOCAL
Locate the following statement in your Adabas start-up EXEC:
address command 'COPY RDB ' || dbid 'CONTROL A ADANUC DDCARD A (APPEND)'
Insert the following statement immediately after the located statement:
address command 'COPY RAOSLOCL CONTROL * ADANUC DDCARD A (APPEND)'
Add the following file definitions to your Adabas start-up EXEC:
'FILEDEF RVUPRT00 DISK REV43 REVPRT00 A (LRECL 133' 'FILEDEF RVUPRT01 DISK REV43 REVPRT01 A (LRECL 133' 'FILEDEF RVUPRT02 DISK REV43 REVPRT02 A (LRECL 133' 'FILEDEF RVUPRT03 DISK REV43 REVPRT03 A (LRECL 133' 'FILEDEF RVUAUT1 DISK REV43 RVUAUT1 * (LRECL 80' 'FILEDEF RVUAUT2 DISK REV43 RVUAUT2 * (LRECL 80' 'FILEDEF RVUALT DISK REV43 RVUALT A (LRECL 9996 RECFM V' 'FILEDEF RVLOG01 DISK REV43 RVLOG01 A (LRECL 9996 RECFM V' 'FILEDEF RVLOG02 DISK REV43 RVLOG02 A (LRECL 9996 RECFM V' 'FILEDEF RVUEXP DISK REV43 RVUEXP A (LRECL 80' 'FILEDEF RVUEXI DISK REV43 RVUEXI * (LRECL 80' 'FILEDEF RVUFLD DISK REV43 RVUFLD * (LRECL 80' 'FILEDEF RVUPARM DUMMY
These file definitions are located in the file REV43 FILEDEFS and may be copied into the Adabas start-up EXEC directly after the DATADEF statements.
Add the following file definitions to your Adabas start-up EXEC:
'FILEDEF RVUPRT00 DISK REV43 REVPRT00 A (LRECL 133' 'FILEDEF RVUPRT01 DISK REV43 REVPRT01 A (LRECL 133' 'FILEDEF RVUPRT02 DISK REV43 REVPRT02 A (LRECL 133' 'FILEDEF RVUPRT03 DISK REV43 REVPRT03 A (LRECL 133' 'FILEDEF RVUAUT1 DISK REV43 RVUAUT1 * (LRECL 80' 'FILEDEF RVUAUT2 DISK REV43 RVUAUT2 * (LRECL 80' 'FILEDEF RVUALT DISK REV43 RVUALT A (LRECL 9996 RECFM V' 'FILEDEF RVLOG01 DISK REV43 RVLOG01 A (LRECL 9996 RECFM V' 'FILEDEF RVLOG02 DISK REV43 RVLOG02 A (LRECL 9996 RECFM V' 'FILEDEF RVUEXP DISK REV43 RVUEXP A (LRECL 80' 'FILEDEF RVUEXI DISK REV43 RVUEXI * (LRECL 80' 'FILEDEF RVUFLD DISK REV43 RVUFLD * (LRECL 80' 'FILEDEF RVUPARM DUMMY
These file definitions are located in the file REV43 FILEDEFS and may be copied into the Adabas start-up EXEC directly after the DATADEF statements.
Modify the Adabas link routine for z/VM (ADALNK) to specify
LRINFO EQU 256
then assemble ADALNK.
The Adabas z/VM link routine created in step 1 must be combined with the Adabas Review link routine exit.
On the command line, enter the command
REVLINK
You will be prompted for the name of the Adabas TXTLIB.
This EXEC will rename your current ADALNK module and create a new ADALNK module that includes the Adabas Review user exit routines.
Note:
The new ADALNK module must be made available to Natural prior to
startup of Adabas Review.
Refer to section Starting Adabas Review for more information on initializing and verifying the installation of the online portion of Adabas Review.
From within Adabas Native SQL, use the global ADACALL statement with
the LAST parameter to specify that the Adabas call will
use the seventh parameter.
Refer to the Adabas Native SQL documentation.
