This document provides installation preparation information for Adabas Review 4.3.2 or above under OS/390 or z/OS and FACOM OS IV/MSP-EX operating system environments. All references in this document to OS/390 are valid for z/OS and MSP as well, unless otherwise noted.
If you are also installing Review Data Communication or Review Natural Monitor, refer to the installation manual for that system. Note that 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.
For information about using Software AG's System Maintenance Aid (SMA) for the installation process, refer to the System Maintenance Aid Manual.
If you are using SMA to install Adabas Review 4.3.2 or above under CICS, and you want to use the Adabas command-level link routine, set the CMD-LEVEL-LINK parameter in group OPTION to Y. This will ensure that the desired command-level link is assembled and linked with the correct Adabas Review TP interface module. Refer to the SMA P060 README job member for more detailed information about this and other SMA installation steps.
This document covers the following topics:
Adabas Review 4.3.2 or above has the following installation requirements in OS/390, z/OS, z/OS.e, and OS IV/MSP-EX environments. See the current version of the Adabas Review Release Notes for information about supported versions and release levels.
There are specific version requirements for Review 4.3.2 in both local and hub mode. See Review 4.3 Version Compatibility in the Review 4.3.2 Release Notes for a detailed matrix of these version requirements.
Adabas Review version 4.3.2 supports Natural version 3.1 and above.
Adabas Review version 4.3.2 supports the following TP monitors at the indicated levels:
Com-plete 6.1 or above
CICS 3.2 or above
IMS/DC
TSO; TSS
Notes:
This section describes the contents of the Adabas Review installation tape, the space requirements for each data set, and instructions for copying the contents of the installation tape to disk. Sample JCL to accomplish the transfer is also included.
Refer to the Report of Tape Creation for the correct volume serial number, density, media type, data sets, and data set sequence numbers for the SM level being installed.
The Adabas Review version 4.3.2 installation tape contains the following data sets:
| Data Set | Created Using... | DCB= |
|---|---|---|
| REV43s.INPL | IEBGENER | (RECFM=VB,LRECL=4624,BLKSIZE=4628) |
| REV43s.SYSF | IEBGENER | (RECFM=VB,LRECL=9996,BLKSIZE=1000) |
| REV43s.SRCE | IEBCOPY | (RECFM=FB,LRECL=80,BLKSIZE=3120) |
| REV43s.JOBS | IEBCOPY | (RECFM=FB,LRECL=80,BLKSIZE=3120) |
| REV43s.LOAD | IEBCOPY | (RECFM=U,BLKSIZE=6447) |
| REV43s.Z000 | IEBGENER | (RECFM=FB,LRECL=80,BLKSIZE=3120) |
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 | --- | 14 |
| SYSF | --- | 1 TRK |
| SOURCE | 10 | 1 |
| JOBS | 10 | 1 |
| LOAD | 10 | 1 |
| Z000 | --- | 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 |
|---|---|
| AUT1PARM | Sample startup parameters for Adabas Review |
| AUT2PARM | Sample startup parameters for Adabas Review |
| CLEXPRT1 | Macro used in the report user exit RPTEXIT |
| DTLEXIT | Sample detail report user exit for writing SMF records |
| LOGUEXIT | Sample Assembler source code for an Adabas Review command logging user exit |
| REVCOST | Sample Adabas Review parameters used to produce an Adabas cost accounting report |
| REVFDT | FDT control cards for the Adabas Review repository |
| RVUCARD | Sample parameters for running a batch job |
| RVUEX1 | Sample operating environment control parameters for Adabas Review |
| RVUPARM | Internal use only |
| SAMPUEX5 | Sample user exit 5 program |
| SUMEXIT | Sample summary report user exit |
| UEX5PARM | Adabas user exit 5 macro used for the Adabas Review hub |
| USRPARM | Sample parameters for user-defined fields |
| ZAPOPT | Contains optional zaps for installing Review 4.3 |
Jobs library members for Adabas Review are as follows:
| Member | Description |
|---|---|
| BATCHRPT | Sample job to create batch reports |
| EXPAND1 | Sample job to upgrade a version 4.1 repository to a version 4.2 repository |
| EXPAND2 | Sample job to upgrade a version 4.2 repository to a version 4.3 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) |
| LINKLCC | 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 on Natural usage in CICS |
| LINKLCO | 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 on Natural usage in Com-plete |
| LINKLNK | For TSO installations; sample job used to link the Adabas Review link routine exit with the TSO/batch Adabas link routine; used when reporting on Natural usage in TSO or batch jobs |
| 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.
