This section of the documentation provides installation preparation information for Adabas Review under z/VSE operating system environments.
For information about using Software AG's System Maintenance Aid (SMA) for the installation process, refer to the System Maintenance Aid Documentation.
If you are using SMA to install Adabas Review under CICS and 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 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:
There are specific version requirements for Review in both local and hub mode. See section Review Version Compatibility in the Review Release Notes for a detailed matrix of these version requirements.
Adabas Review version 4.4 supports Natural version 4.1.4 and above.
Adabas Review version 4.4 supports the following TP monitors:
This section describes the contents of the Adabas Review installation tape and the space requirements for each data set. Sample JCS to accomplish the transfer is also included.
Refer to the "Report of Tape Creation" for the volume serial number, density, media type, data set names, and data set sequence numbers for the SM level being installed.
The installation tape contains the following data sets:
| Data Set | Created Using | Contents |
|---|---|---|
| REVvrs.INPL | NATUNLD | Adabas Review Natural objects |
| REVvrs.SYSF | ADAULD | Adabas Review repository file |
| REVvrs.VSEZAPS | -- | Adabas Review ZAP data set |
| REVvrs.VSELIBR | LIBR BACKUP | The Adabas Review sublibrary; contains relocatable objects, phases, source, and example installation jobs |
The available GETVIS in the Adabas partition may need to be increased to accommodate Adabas Review. An increase of 500K is normal.
The space requirements for each of the data sets on the installation tape is shown below:
| Data Set Name | Cylinders (3380) |
|---|---|
| INPL | 15 |
| SYSF | 1 track |
| VSEZAPS | 1 |
| VSELIBR | 10 |
Additionally, the alternate history file, which is created when installing Adabas Review under Adabas, requires additional space as follows:
| Data Set Type | Cylinders (3380) |
|---|---|
| Alternate history file | 2 |
The Adabas Review sublibrary members are listed below. A sublibrary name extension (a period followed by a single letter) indicates the function of each sublibrary.
.A is used for Assembler code, examples, etc.;
.X indicates job control statements or job streams.
Sublibrary members for Adabas Review are as follows:
| Member | Description |
|---|---|
| ARCHIVE.X | Sample JCS to define Adabas Review to MSHP. |
| ASMLCC.X | For CICS installations; sample JCS to link the Adabas Review link routine exit with the CICS/Adabas command-level link routine; used when reporting on Natural usage in CICS. |
| ASMLCO.X | For Com-plete installations; sample JCS to assemble and link the Adabas Review link routine exit with the Com-plete/Adabas link routine; used when reporting on Natural usage in Com-plete. |
| ASMLNK.X | For batch installations; sample JCS to assemble and link the Adabas Review link routine exit with the batch Adabas link routine; used when reporting on Natural usage in batch jobs. |
| DBFILES.X | Create Review data sets. |
| EXPAND1.X | Sample JCS to upgrade a version 4.1 repository to version 4.2. |
| EXPAND2.X | Sample JCS to upgrade a version 4.2 repository to version 4.3. |
| HISTCOMP.X | Sample JCS to compress history data from a batch Natural execution. |
| HISTDEL.X | Sample JCS to delete history data from a batch Natural execution. |
| HISTFIX.X | Sample job to run the correct history dates. |
| HISTVIEW.X | Sample JCS to view history data from a batch Natural execution. |
| HUBJCS.X | Sample JCS to start the Adabas Review hub server. |
| LINKREV.X | Sample job to relink Review after applying maintenance. |
| LNKLUBS.X | Sample JCS to assemble and link RAOSLUBS system file number assign module. |
| LOCJCS.X | Sample JCS to run Adabas Review Local Nucleus. |
| LOGUEXIT.A | Sample Assembler source code for an Adabas Review command logging user exit. |
| LREVCIC.X | For CICS installations, sample JCS to assemble the CICSGBLS module and link it with the necessary Adabas LNK and Review exit objects. |
| LREVLCO.X | For Com-plete installations, sample JCS to assemble the LCOGBL module and link it with the necessary Adabas LNK and Review exit objects. |
| LREVLNK.X | For batch installations, sample JCS to assemble the LNKGBLS module and link it with the necessary Adabas LNK and Review exit objects. |
| RAOSLUBS.A | Sample Assembler code to change the default logical units used by Adabas Review. |
| REVFDT.A | FDT control cards for the Adabas Review repository. |
| REVIEWB.X | Sample JCS to process a sequential command log by the batch component of Adabas Review. |
| REVINPL.X | Sample JCS to INPL the Adabas Review programs and DDMs from the INPL data set to the Natural system files. |
| REVLOAD.X | Sample JCS to load the Adabas Review repository file into an Adabas environment. |
| REVPROC.X | Sample job to catalog the Review standard label procedure. |
| ZAPOPT.Z | Review optional zaps. |
Adabas Review is installed in two phases:
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.
Install TP-specific components. Separate procedures are used to install Adabas Review under each of the supported TP monitors: Com-plete and CICS.
Phase one procedures are described in section Installation (Phase 1); phase two procedures in section Installation (Phase 2).
