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.
This document covers the following topics:
For information regarding Software AG product compatibility with IBM platforms and any IBM requirements for Software AG products, please review the Product Compatibility for IBM Platforms web page.
Other prerequisites for Adabas Review are described in Software AG Product Support and Requirements.
This version of Adabas Review 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 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 the data sets .LIBJ,
.LIBR and .LICS from tape to disk. All other data
sets can be installed directly from the tape.
Modify the following sample job according to your requirements:
* $$ JOB JNM=LIBRCAT,CLASS=0, + * $$ DISP=D,LDEST=(*,UID),SYSID=1 * $$ LST CLASS=A,DISP=D // JOB LIBRCAT * ***************************************** * STORE COPYTAPE.JOB IN LIBRARY * ***************************************** // ASSGN SYS004,nnn // MTC REW,SYS004 // MTC FSF,SYS004,4 ASSGN SYSIPT,SYS004 // TLBL IJSYSIN,'COPYTAPE.JOB' // EXEC LIBR,PARM='MSHP; ACC S=lib.sublib' /* // MTC REW,SYS004 ASSGN SYSIPT,FEC /* /& * $$ EOJ
where:
nnn is the tape address,
and
lib.sublib is the library
and sublibrary in which the data set COPYTAPE.JOB is to be
stored.
Execute the job to copy the data set COPYTAPE.JOB to
disk.
COPYTAPE.JOB contains the JCL required to copy the data
sets .LIBJ, .LIBR and .LICS from tape to
disk.
Modify COPYTAPE.JOB according to your requirements and set
the disk space parameters as appropriate.
Execute COPYTAPE.JOB to copy the data sets
.LIBJ, .LIBR and .LICS to your disk.
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.VSELIBR | LIBR BACKUP | The Adabas Review sublibrary; contains relocatable objects, phases, source, and example installation jobs |
The space requirements for each of the data sets on the installation tape is shown below:
| Data Set Name | Cylinders (3390) |
|---|---|
| INPL | 8 |
| SYSF | 1 |
| VSELIBR | 4 |
Additionally, the alternate history file, which is created when installing Adabas Review under Adabas, requires additional space as follows:
| Data Set Type | Cylinders (3390) |
|---|---|
| Alternate history file | 2 |
The Adabas Review sublibrary members are listed below. The members are listed by type, where
"A" indicates source (for example, Assembler user exit samples, macros, etc.)
"X" indicates job control statements or job streams.
Members of type A are:
| Member | Description |
|---|---|
| RAOSLUBS | Sample Assembler code to change the default logical units used by Adabas Review. |
| 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. |
| REVUXLOG | Sample Assembler source code for an Adabas Review command logging user exit. |
| REVUXSUM | Sample summary report user exit. |
| 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 | Adabas user exit 5 macro used for the Adabas Review hub in REVUEX5. |
| ZAPOPT | Adabas Review optional zaps. |
 |
Warning: Sample user exits and programs and are not supported under any maintenance contract agreement. |
Members of type X are:
| Member | Description |
|---|---|
| ARCHIVE | Sample JCS to define Adabas Review to MSHP. |
| AREVUEX1 | Sample job for assembling the REVUEX1 (User field exit) for batch. |
| ASMUEX1C | Sample job for assembling and linking the REVUEX1 for CICS environment (User field exit). |
| ASMUXLOG | Sample job for assembling and linking the REVUXLOG. |
| BATCHRPT | Sample job to create batch reports. |
| DBFILES | Create Adabas Review data sets. |
| EXPANDxx | Sample jobs to upgrade an Adabas Review version repository. For the details please refer to Migration from Previous Versions in the Release Notes. |
| HISTCOMP | Sample JCS to compress history data from a batch Natural execution. |
| HISTDEL | Sample JCS to delete history data from a batch Natural execution. |
| HISTVIEW | Sample JCS to view history data from a batch Natural execution. |
| HUBJCS | Sample JCS to start the Adabas Review hub server. |
| LINKREV | Sample job to relink Adabas Review after applying maintenance. |
| LNKLUBS | Sample JCS to assemble and link RAOSLUBS system file number assign module. |
| LOCJCS | Sample JCS to run Adabas Review local nucleus. |
| LREVLCIC | For CICS installations, sample JCS to assemble the CICSGBLS module and link it with the necessary Adabas LNK and Adabas Review exit objects. |
| LREVLCO | For Com-plete installations, sample JCS to assemble the LCOGBL module and link it with the necessary Adabas LNK and Adabas Review exit objects. |
| LREVLNK | For batch installations, sample JCS to assemble the LNKGBLS module and link it with the necessary Adabas LNK and Adabas Review exit objects. |
| LREVLNKR | For batch installations, sample JCS to assemble the LNKGBLS module and link it with the necessary reentrant Adabas LNK and Adabas Review exit objects. |
| LREVUEX1 | Sample job for binding the ADALNK REVEXIT modules (RDBLXsys) together with the user exit REVUEX1 (User field exit). |
| REVCLCOP | Sample JCS to copy and set end-of-file for a sequential command log created by Adabas Review. |
| REVIEWB | Sample JCS to process a sequential command log by the batch component of Adabas Review. |
| REVINPL | Sample JCS to INPL the Adabas Review programs and DDMs from the INPL data set to the Natural system files. |
| REVLOAD | Sample JCS to load the Adabas Review repository file into an Adabas environment. |
| REVPROC | Sample job to catalog the Adabas Review standard label procedure. |
|
Warning: Sample user exits and programs and are not supported under any maintenance contract agreement. |
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).