Version 4.5.1
 —  Installation and Operations for z/OS  —

Installation: Phase 1

Adabas Review can be installed in local mode in the Adabas address space, or as a hub (server) in its own address space with an interface (client) located in the address space of the Adabas being monitored. The procedures are the same except as noted.

Adabas Review is installed in two phases. This document describes Phase 1, which comprises all the steps that are independent of any particular TP monitor environment, as follows:

To complete Phase 1 of the installation, read the sections in Phase 1 that apply to the type of installation you have chosen and follow the steps described in those sections in order they are described in this document.

Phase 2, which comprises the steps that are specific to the TP monitor being used, is described in Installation: Phase 2


Copy the Tape Contents to Disk

If you are using SMA, refer to the System Maintenance Aid documentation, included in the current edition of the Natural documentation CD.

If you are not using SMA, use the following steps to download all product data sets from tape to disc.

Copy data set COPY.JOB from tape to disk

The data set COPY.JOB (Label 2) contains the JCL to unload all other existing data sets from tape to disk. To unload COPY.JOB, use the following sample JCL:

//SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X
//* ---------------------------------
//COPY     EXEC PGM=IEBGENER
//SYSUT1   DD DSN=COPY.JOB,
//    DISP=(OLD,PASS),
//    UNIT=(CASS,,DEFER),
//    VOL=(,RETAIN,SER=tape-volume),
//    LABEL=(2,SL)
//SYSUT2   DD DSN=hlq.COPY.JOB,
//    DISP=(NEW,CATLG,DELETE),
//    UNIT=3390,VOL=SER=volume,
//    SPACE=(TRK,(1,1),RLSE),
//    DCB=*.SYSUT1
//SYSPRINT DD SYSOUT=*
//SYSIN    DD DUMMY
// 

where:

hlq = valid high level qualifier
tape-volume = the tape volume name (e.g., T12345)volume = the desired target volume on disk.

Modify COPY.J

Modify the COPY.JOB to conform with your local naming conventions. Set the disk space parameters before submitting this job, as follows:

Submit COPY.JOB

Submit COPY.JOB to unload all other existing data sets from the tape to your disk.

Top of page

Install Adabas Review under Natural

This section applies to both local and hub mode installations. It includes the following steps:

Step 1. INPL Adabas Review

Note:
There is no longer a SYSREV or SYSREVUP library. The entire application is now contained in the SYSREVDB library.

INPL the Adabas Review programs and DDMs from the INPL data set to your Natural system files.

You may use any of your site-dependent Natural INPL JCL. Sample job REVINPL is provided in the Adabas Review jobs library.

Step 2. Create a Natural profile using the SYSPARM facility

  1. Include the following parameter settings in the Natural 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.
    NTPRINT(1) Review uses Natural printer 1 to generate report display programs in the Natural source area. For more information see the Natural documentation.
  2. Add a Natural NTFILE definition for the physical database ID and file number of the Adabas Review repository file as follows:

    NTFILE 241,dbid,fnr
    

    Replace dbid and fnr with the database ID and 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 or hub mode. However, a database with a DBID of 255 can send data to a hub.

  3. Reassemble and link the NATPARM module to your Natural nucleus.

Step 3. Define Adabas Review to Natural Security

If Natural Security is installed:

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

  2. Define Adabas Review DDMs to Natural Security as public DDMs:

    REVIEW-ADABAS-V45-CLOG
    REVIEW-FNAT
    REVIEW-ADABAS-v45-SYSTEM
    

Top of page

Install the Adabas Review Repository

This section applies to both local and hub mode installations.

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.

Hub mode only: The Adabas Review repository can be created on any database accessible to Natural. It does not need to be on a database that is monitored by the Adabas Review hub.

Notes:

  1. 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.
  2. To convert an Adabas Review version 4.3 or 4.4 repository to a version 4.5 repository, run the EXPAND3 job from the JOBS library.

This step includes the following substeps:

Step 1. Modify the JCL for loading the Adabas Review repository

Before submitting the job REVLOAD provided in the Adabas Review jobs library, change:

Step 2. Load the Adabas Review repository file

Load the Adabas Review repository file using the job REVLOAD modified in step 1.

Step 3. Convert the repository file

If you used the same repository file for a version of Adabas Review older than this release, use the EXPAND3 job in the JOBS library to convert the repository.

Step 4. Convert your history data

If you used the same repository file for a version of Adabas Review older than this release, Adabas Review 4.5 requires that you convert your history data prior to running any new reports in 4.5. For complete information on doing this, read Migration from Previous Versions.

Top of page

Install Adabas Review under Adabas

This section includes the following steps:

Step 1. Modify the Adabas initialization parameters

Read ADARUN Parameters for information about the relevant ADARUN parameters. Then modify the Adabas ADARUN parameters to include the following:

Step 2. Modify the Adabas Startup JCL

Perform one of the sets of steps below, depending on whether you are installing Adabas Review in local mode or in hub mode:

Local Mode

Before you modify the Adabas startup JCL, you may need to increase the REGION parameter for the Adabas nucleus job step to accommodate Adabas Review. An increase of one megabyte is normal.

This section covers the following topics:

RVUALT Considerations
RVUAUT1 and RVUAUT2 Considerations

Note:
In a future release of Adabas Review, RVUAUT2 will no longer be supported. RVUAUT1 only will be used for autostarted reports.

Start of instruction setTo modify the Adabas startup JCL for local mode:

  1. Add the following DD statements to the Adabas startup JCL, replacing the vrs with the current version, revision, and system maintenance level number for Adabas Review:

    //RVUEXI   DD DISP=SHR,DSN=REVvrs.SRCE(RVUEXI)
    //RVUEXP   DD SYSOUT=X,LRECL=80
    //RVUALT   DD DISP=SHR,DSN=REVvrs.ALTHIST
    //RVUAUT1  DD DISP=SHR,DSN=REVvrs.SRCE(AUT1PARM)
    //RVUAUT2  DD DISP=SHR,DSN=REVvrs.SRCE(AUT2PARM)
    //RVUCARD  DD DISP=SHR,DSN=REVvrs.SRCE(RVUCARD)
    //RVUFLD   DD DISP=SHR,DSN=REVvrs.SRCE(USRPARM)
    //RVUPARM  DD DUMMY
    //RVUPRT00 DD SYSOUT=X,LRECL=133
    //RVUPRT01 DD SYSOUT=X,LRECL=133
    //RVUPRT02 DD SYSOUT=X,LRECL=133
    
    //RVUPRT03 DD SYSOUT=X,LRECL=133
  2. Add the Adabas Review load library to the Adabas STEPLIB concatenation.

    Note:
    To retain APF authorization for Adabas, you must authorize the Adabas Review load library as well when it is added to the Adabas STEPLIB concatenation.

Hub Mode: Client Interface Installation for a Database

Start of instruction setTo install the Adabas Review client interface, repeat the following instructions for each database to be monitored. Note that each database to be monitored must use the same SVC as the Adabas Review hub.

  1. Apply the required ZAPs.

  2. Ensure that an unmodified ADALNK is available to Adabas in the Adabas load library or in a library concatenated before the Adabas load library.

    ADALNK is loaded by Adabas to send information to the Adabas Review hub. Link routine exits such as RDBLXMVS or UEXB are not useful for the process of sending data to the hub and create unnecessary overhead when included in the ADALNK.

    Put ADALNKs that include exits into another library.

  3. Modify the Adarun parameters of the database.

  4. If the Adabas Adarun parameter LOGCLEX=Y is specified to write the Review specific Command Log Extension (CLEX) to the command log, the Adabas Review library must be available in the client address space. If Review modules are not available, the warining message ARVU20 is issued.

  5. Restart Adabas.

Top of page

Install the Adabas Review Hub

To install the Adabas Review Hub, complete the steps described in this section:

Step 1. Create a RVUALT data set

Use the sample JCL member MAKEALT. Do not use IEFBR14 to allocate RVUALT.

This alternate history file is used to contain history information if Adabas Review is unable to access the Adabas Review repository. You may use the same data set you used for Adabas Review 4.1 or 4.2. Refer to Operations for RVUALT guidelines.

Step 2. Modify the sample JCL member HUBJCL

Step 3. Start the HUBJCL job

Note:
The STEPLIB needs to be APF-authorized.

Top of page

Optional Installation Procedures

The following optional installation procedures may be completed as part of Phase 1 of the Adabas Review installation:

Implement Support for Adabas Native SQL

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.

Implement Support for Reporting from Batch Natural

This (optional) step applies both to local and hub mode installations.

Start of instruction setTo report on Natural activity from a batch Natural job:

Top of page