This document provides installation preparation information for Adabas Review under z/OS operating system environments.
Prerequisites for Adabas Review are described in Software AG Product Support and Requirements.
For information about using Software AG's System Maintenance Aid (SMA) for the installation process, refer to the System Maintenance Aid Manual.
This document covers the following topics:
This section describes the contents of the Adabas Review installation tape and the space requirements for each data set. Sample JCL to accomplish the transfer is also included.
Refer to the Software AG Product Delivery Report for the volume serial number, density, media type, data set names, and data set sequence numbers for the SP level being installed.
Copy the data sets from the supplied installation medium to your disk before you perform the individual installation procedure for each component to be installed.
The way you copy the data sets depends on the installation method and the medium used:
If you use System Maintenance Aid (SMA), refer to the copy job instructions provided in the System Maintenance Aid documentation.
If you are not using SMA and want to copy the data sets from CD-ROM, refer to the README.TXT file on the CD-ROM.
If you are not using SMA and want to copy the data sets from tape, follow the instructions in this section.
This section explains how to copy all data sets from tape to disk.
Modify the following sample job according to your requirements:
//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-volser), // LABEL=(2,SL) //SYSUT2 DD DSN=hilev.COPY.JOB, // DISP=(NEW,CATLG,DELETE), // UNIT=3390,VOL=SER=disk-volser, // SPACE=(TRK,(1,1),RLSE), // DCB=*.SYSUT1 //SYSPRINT DD SYSOUT=* //SYSIN DD DUMMY //
where:
tape-volser is the VOLSER
of the tape, for example: T12345,
hilev is a valid high-level
qualifier, and
disk-volser is the VOLSER
of the disk.
Execute the job to copy the data set COPY.JOB to your
disk.
Modify hilev.COPY.JOB according
to your requirements:
Set EXPDT to a valid expiration date, for example,
99365.
Set HILEV to a valid high-level qualifier, for example,
USERLIB.
Set LOCATION to a storage location, for example,
STORCLAS=ABC or UNIT=3390,VOL=SER=USR123.
Execute hilev.COPY.JOB to copy
single, multiple, or all data sets to your disk.
The Adabas Review installation tape contains the following data sets:
| Data Set | Created Using... | DCB= | Description |
|---|---|---|---|
| REVvrs.INPL | IEBGENER | (RECFM=VB,LRECL=4624,BLKSIZE=4628) | Adabas Review Natural objects. |
| REVvrs.SYSF | IEBGENER | (RECFM=VB,LRECL=9996,BLKSIZE=1000) | Adabas Review repository file. |
| REVvrs.SRCE | IEBCOPY | (RECFM=FB,LRECL=80,BLKSIZE=23440) | Adabas Review source modules and more installation jobs. |
| REVvrs.JOBS | IEBCOPY | (RECFM=FB,LRECL=80,BLKSIZE=23440) | Adabas Review installation jobs. |
| REVvrs.LOAD | IEBCOPY | (RECFM=U,BLKSIZE=6447) | Adabas Review load library. |
| REVvrs.ZAPS | IEBCOPY | (RECFM=FB,LRECL=80,BLKSIZE=3120) | Zaps required for Adabas Review on this platform. |
The REGION parameter for the Adabas nucleus job step may need to be increased to accommodate Adabas Review. An increase of 1 megabyte is normal.
The space requirements for each data set on the installation tape are given in the following table:
| Data Set Type | Directory Blocks | Cylinders (3390) |
|---|---|---|
| INPL | --- | 8 |
| SYSF | --- | 1 |
| SOURCE | 10 | 1 |
| JOBS | 10 | 1 |
| LOAD | 10 | 1 |
In addition, the alternate history file for Adabas Review and the CICS-dependent load library for CICS installations require additional space as follows:
| Data Set Type | Directory Blocks | Cylinders (3390) |
|---|---|---|
| Alternate history file | --- | 2 |
| CICS-dependent load library | 5 | 1 |
Source library members for Adabas Review are as follows:
| Member | Description |
|---|---|
| CLEXRUBX | Part of LORECR macro used in REVUXDET |
| FILETAB | Part of LORECR macro used in REVUXDET |
| LORECR | Macro of LORECR used in REVUXDET |
| REVCOST | Sample Adabas Review parameters used to produce an Adabas cost accounting report |
| REVUEX1 | Sample user exit 1 (User field exit) program |
| REVUEX5 | Sample user exit 5 program |
| REVUXDET | Sample detail report user exit for writing SMF records |
| REVUXLOG | Sample Assembler source code for an Adabas Review command logging user exit |
| REVUXSUM | Sample summary report user exit |
| RVUAUT1 | Sample startup parameters for Adabas Review |
| RVUAUT2 | Sample startup parameters for Adabas Review |
| RVUCARD | Sample parameters for running a batch job |
| RVUEXI | Sample operating environment control parameters for Adabas Review |
| RVUPARM | Internal use only |
| RVUFLD | Sample parameters for user-defined fields |
| SUMRECD | DSECT for the summary record layout data portion |
| SUMRECH | DSECT for the summary record layout header portion |
| SUMRECS | DSECT for the summary record layout schema portion |
| UEX5PARM | Macro used in REVUEX5 |
| ZAPOPT | Contains optional zaps for installing Adabas Review |
Jobs library members for Adabas Review are as follows:
| Member | Description |
|---|---|
| AREVUEX1 | Sample job for assembling the REVUEX1 (User field exit) |
| BATCHRPT | Sample job to create batch reports with online administration tool SYSREVDB. |
| EXPAND3 | Sample job to upgrade an Adabas Review version 4.4 (or 4.3 ) repository to an Adabas Review version 4.5 SP1 repository. |
| EXPAND4 | Sample job to upgrade an Adabas Review version 4.5 SP1 repository to an Adabas Review version 4.5 SP2 repository. |
| EXPAND5 | Sample JCS to upgrade an Adabas Review version 4.5 SP2 repository to an Adabas Review version 4.6 SP1 repository. |
| HISTCOMP | Sample job to compress history data from a batch Natural execution. |
| HISTDEL | Sample job to delete history data from a batch Natural execution. |
| HISTVIEW | Sample job to view history data from a batch Natural execution. |
| HUBJCL | Sample job to start the Adabas Review hub (not used in local mode). |
| LREVLCIC | For CICS installations; sample job used to link the Adabas Review link routine exit with the CICS Adabas command-level link routine; used when reporting in CICS. |
| LREVLCO | For Com-plete installations; sample job used to link the Adabas Review link routine exit with the Com-plete Adabas link routine; used when reporting in Com-plete. |
| LREVLNI | For IMS installations; sample job used to link the Adabas Review link routine exit with the IMS Adabas link routine; used when reporting in IMS. |
| LREVLNK/ LREVLKNR | For TSO installations; sample jobs used to link the Adabas Review link routine exit with the TSO/batch Adabas link routine (reentrant link routine) ; used when reporting in TSO or batch jobs. |
| LREVUEX1 | Sample job for binding the ADALNK REVEXIT modules (RDBLXsys) together with the user exit REVUEX1 (User field exit). |
| MAKEALT | Sample JCL to create the RVUALT data set. |
| REVCLCOP | Sample JCL to copy and set end-of-file for a sequential command log created by Adabas Review. |
| REVIEWB | Sample JCL to process a sequential command log by the batch component of Adabas Review. |
| REVINPL | Sample job used to INPL the Adabas Review programs and DDMs from the INPL data set to the Natural system files. |
| REVLOAD | Sample job used to load the Adabas Review repository file. |
Adabas Review is installed in two phases:
Phase 1: Install non-TP-specific components. All steps in this phase are identical regardless of the TP monitor in use:
Install Adabas Review under Natural;
Install the Adabas Review repository;
Install Adabas Review under Adabas;
Install the Adabas Review hub (hub mode only);
Optional installation procedures.
Phase 2: Install TP-specific components. Separate procedures are used to install Adabas Review under each of the supported TP monitors: Com-plete; CICS; TSO or TSS; and IMS/DC.
Phase one procedures are described in Installation: Phase 1; phase two procedures in Installation: Phase 2.
Before you install the product, be sure you have read the Release Notes, paying special attention to the supported platform list, the description of Software AG product support, enhancements, restrictions, and any migration considerations pertinent for this release of Adabas Review.
