The second phase installs the components that are specific to the particular TP monitor in use at your site. Separate procedures are used to install Adabas Review under each of the supported TP monitors:
Com-plete
CICS
TSO or TSS (batch)
IMS/DC
This document covers the following topics:
To install the Com-plete components of Adabas Review, follow the steps in the appropriate section below.
For the Adabas Version 8 Com-plete link routine:
Edit the LCOGBL link globals member found in the ADAvrs.MVSSRCE library, setting the REVIEW and REVREL LGBLSET keywords:
| Parameter | Description | Syntax |
|---|---|---|
| REVHID | Specifies the preferred Adabas Review hub ID. This
value can be checked during Adabas CICS TP monitoring installation or during
the monitor activate process.
If REVHID is set to zero (0), the preferred Adabas Review hub ID is dynamic. When the hub ID is dynamic, it cannot be checked during Adabas CICS TP monitoring installation and the call to turn on client reporting must supply the correct Adabas Review hub ID to use. If REVHID is specified, REVIEW=YES must also be specified. If REVHID is specified and REVIEW=NO is also specified, the assembly of the globals table will abort with condition code 16 and the following message is given: REVHID requires REVIEW=YES This parameter is not valid in:
|
REVHID=hubid |
| REVIEW | Indicates whether or not Software AG’s Adabas Review performance monitor is installed and active. |
REVIEW={NO | YES} |
| REVREL | Specifies the level of Adabas Review support to be
generated in the link globals table module. This is necessary because Review
4.6 and later releases have changed the Review pre-call exit name from
"REVEXITB" to "REVEXIT1".
Valid values are "45" or
"46" (without the quotes). If other values are given
the assembly of the globals table will fail with condition code 16 and MNOTE
messages from the assembler.
When REVREL=45 is specified, it indicates that support for Adabas Review release 4.5 and earlier should be used. The Adabas Review REVEXITB exit name is used and an associated external reference statement is generated when the globals table is assembled. When REVREL=45 is specified, the RVCLNT keyword must be set to NO. If RVCLNT=YES and REVREL=45 are both specified, the assembly of the globals table will fail with condition code 16 and MNOTE messages from the assembler. When REVREL=46 is specified it indicates that support for Adabas Review release 4.6 and later should be used. The Adabas Review REVEXIT1 exit name is used and an associated external reference statement is generated when the globals table is assembled. Note: |
REVREL={45 | 46} |
| RVCLNT | Indicates whether the Adabas Review client reporting
exit should be active. The default is NO.
If RVCLNT=YES is specified, REVIEW=YES must also be specified. If RVCLNT=YES is specified and REVIEW=NO is also specified, the assembly of the globals table will abort with condition code 16 and the following message is given: RVCLNT=YES requires REVIEW=YES This parameter is not valid in:
|
RVCLNT={YES|NO} |
For example, the following keywords indicate that Adabas Review support should be installed and, specifically, support for Adabas Review 4.6 and later.
REVIEW=YES REVREL=46
Assemble and link the modified LCOGBL member into a load library and make it available for the next step.
Re-link the Adabas Version 8 Com-plete link routine using sample job LREVLCO in the Review JOBS data set, replacing the LCOGBL module with the one prepared in steps 1 and 2 and including the RDBLXCOM Review module for Com-plete.
Restart Adabas and Com-plete, and verify that an Adabas or WAL load library with the modules ADATMZ, ADALNKR, and CCSTCK is specified for the Com-plete startup job.
Initialize and test Adabas Review.
See Starting Adabas Review for information about initializing and verifying the installation of the online portion of Adabas Review.
This section provides instructions for installing the CICS components of Adabas Review with the Adabas 8 CICS link routine.
The ACITMZ module is required to execute the target discovery process in a CICS environment. This module is invoked from Natural Review code to assist in the location of Adabas Review hubs.
To install the CICS components of Adabas Review for use with the
Adabas Version 8 CICS link routine:
Modify the member CICSGBL found in the ACIvrs.MVSSRCE library, and set the following keywords:
| Parameter | Description | Syntax |
|---|---|---|
| REVHID | Specifies the preferred Adabas Review hub ID. This
value can be checked during Adabas CICS TP monitoring installation or during
the monitor activate process.
If REVHID is set to zero (0), the preferred Adabas Review hub ID is dynamic. When the hub ID is dynamic, it cannot be checked during Adabas CICS TP monitoring installation and the call to turn on client reporting must supply the correct Adabas Review hub ID to use. If REVHID is specified, REVIEW=YES must also be specified. If REVHID is specified and REVIEW=NO is also specified, the assembly of the globals table will abort with condition code 16 and the following message is given: REVHID requires REVIEW=YES This parameter is not valid in:
|
REVHID=hubid |
| REVIEW | Indicates whether or not Software AG’s Adabas Review performance monitor is installed and active. |
REVIEW={NO | YES} |
| REVREL | Specifies the level of Adabas Review support to be
generated in the link globals table module. This is necessary because Review
4.6 and later releases have changed the Review pre-call exit name from
"REVEXITB" to "REVEXIT1".
Valid values are "45" or
"46" (without the quotes). If other values are given
the assembly of the globals table will fail with condition code 16 and MNOTE
messages from the assembler.
When REVREL=45 is specified, it indicates that support for Adabas Review release 4.5 and earlier should be used. The Adabas Review REVEXITB exit name is used and an associated external reference statement is generated when the globals table is assembled. When REVREL=45 is specified, the RVCLNT keyword must be set to NO. If RVCLNT=YES and REVREL=45 are both specified, the assembly of the globals table will fail with condition code 16 and MNOTE messages from the assembler. When REVREL=46 is specified it indicates that support for Adabas Review release 4.6 and later should be used. The Adabas Review REVEXIT1 exit name is used and an associated external reference statement is generated when the globals table is assembled. Note: |
REVREL={45 | 46} |
| RVCLNT | Indicates whether the Adabas Review client reporting
exit should be active. The default is NO.
If RVCLNT=YES is specified, REVIEW=YES must also be specified. If RVCLNT=YES is specified and REVIEW=NO is also specified, the assembly of the globals table will abort with condition code 16 and the following message is given: RVCLNT=YES requires REVIEW=YES This parameter is not valid in:
|
RVCLNT={YES|NO} |
For example, the following keywords indicate that Adabas Review support should be installed and, specifically, support for Adabas Review 4.6 and later.
REVIEW=YES REVREL=46 LUSAVE=72
Assemble and link-edit the CICSGBL member. Be sure to include the Adabas Review exits in the link-edit with CICSGBL. In addition, be sure to include CICS module DFHEAI. A sample job, LREVLCIC, is provided in the Review JOBS data set to assist you.
Note:
The RDBLXCIC module contains the REVEXIT2 program necessary to
support Adabas Review client reporting. Consequently, when the globals table is
relinked, the necessary program is present to support Adabas Review client
reporting.
The REVEXIT exits include REVEXIT1 (formerly REVEXITB) and REVEXIT2. REVEXIT should be linked with ADALNK during installation, with the appropriate Adabas link globals table parameters (LGBLSET). The link globals table parameters specified via LGBLSET identify which REVEXIT entry points (REVEXIT1 or REVEXIT2) are called. If LGBLSET parameter REVIEW=YES is set, then REVEXIT is called by ADALNK before the Adabas call as entry point REVEXIT1; if LGBLSET parameters RVCLNT and REVHID are also specified, REVEXIT is also called after the Adabas call as entry point REVEXIT2.
The modules used to perform the linkage between REVEXIT and ADALNK are provided with your Adabas Review installation with names in the format RDBLXsys, where sys is a three-character code representing the link environment (for example, MVS for z/OS environments, VSE for z/VSE, COM for Com-plete environments, IMS for IMS environments, and BS2 for BS2000 environments). For more information about performing this linkage, read the appropriate Adabas Review installation documentation.
Note:
A return code 4 from the link-edit of the globals table is acceptable
because it indicates that the Review exit (REVEXITB or REVEXIT1) has not been
resolved by this step. The next link-edit step in the sample jobs should
resolve this and finish with return code zero.
Install ACITMZ.
To install ACITMZ, complete the following steps:
Copy the ACITMZ load module from the distribution library to a library in the CICS DFHRPL concatenation.
Using the DFHCSDUP utility or the CICS CEDA transaction, install the program definition for ACITMZ. A sample job, DEFCTMZ is provided in the ACIvrs.MVSJOBS data set to assist you.
Follow the instructions in the Installing the Version 8 CICS Link Routines in the Adabas Installation Manual if this is the first time the CICS link routines are being installed in this CICS system.
Restart Adabas and CICS.
Initialize and test Adabas and Review.
Read Starting Adabas Review for information about initializing and verifying the installation of the online portion of Adabas Review.
This section provides instructions for installing the TSO components of Adabas Review with the Adabas 8 TSO/batch link routine.
To install the TSO components of Adabas Review for the Adabas 8
TSO/batch link routine:
Edit the LNKGBLS globals member found in the ADAvrs.MVSSRCE library, setting the following LGBLSET keywords:
| Parameter | Description | Syntax |
|---|---|---|
| REVHID | Specifies the preferred Adabas Review hub ID. This
value can be checked during Adabas CICS TP monitoring installation or during
the monitor activate process.
If REVHID is set to zero (0), the preferred Adabas Review hub ID is dynamic. When the hub ID is dynamic, it cannot be checked during Adabas CICS TP monitoring installation and the call to turn on client reporting must supply the correct Adabas Review hub ID to use. If REVHID is specified, REVIEW=YES must also be specified. If REVHID is specified and REVIEW=NO is also specified, the assembly of the globals table will abort with condition code 16 and the following message is given: REVHID requires REVIEW=YES This parameter is not valid in:
|
REVHID=hubid |
| REVIEW | Indicates whether or not Software AG’s Adabas Review performance monitor is installed and active. |
REVIEW={NO | YES} |
| REVREL | Specifies the level of Adabas Review support to be
generated in the link globals table module. This is necessary because Review
4.6 and later releases have changed the Review pre-call exit name from
"REVEXITB" to "REVEXIT1".
Valid values are "45" or
"46" (without the quotes). If other values are given
the assembly of the globals table will fail with condition code 16 and MNOTE
messages from the assembler.
When REVREL=45 is specified, it indicates that support for Adabas Review release 4.5 and earlier should be used. The Adabas Review REVEXITB exit name is used and an associated external reference statement is generated when the globals table is assembled. When REVREL=45 is specified, the RVCLNT keyword must be set to NO. If RVCLNT=YES and REVREL=45 are both specified, the assembly of the globals table will fail with condition code 16 and MNOTE messages from the assembler. When REVREL=46 is specified it indicates that support for Adabas Review release 4.6 and later should be used. The Adabas Review REVEXIT1 exit name is used and an associated external reference statement is generated when the globals table is assembled. Note: |
REVREL={45 | 46} |
| RVCLNT | Indicates whether the Adabas Review client reporting
exit should be active. The default is NO.
If RVCLNT=YES is specified, REVIEW=YES must also be specified. If RVCLNT=YES is specified and REVIEW=NO is also specified, the assembly of the globals table will abort with condition code 16 and the following message is given: RVCLNT=YES requires REVIEW=YES This parameter is not valid in:
|
RVCLNT={YES|NO} |
For example, the following keywords indicate that Adabas Review support should be installed and, specifically, support for Adabas Review 4.6 and later.
REVIEW=YES REVREL=46
Assemble and link-edit the modified LNKGBLS member into a load library and make it available for the next step.
Note:
Note: The RDBLXMVS module contains the REVEXIT2 program necessary
to support Adabas Review client reporting. Consequently, when the globals table
is relinked, the necessary program is present to support Adabas Review client
reporting.
Relink the Adabas Version 8 TSO/batch link routine using sample job LREVLNK in the Review JOBS data set, replacing the LNKGBLS module with the one prepared in steps 1 and 2 and including the RDBLXMVS Review module for TSO.
Note:
If you elect to use the link routine ADALNKR, link the batch
Review routine RDBLXMVS to ADALNKR using sample job LREVLNKR in the Review JOBS
data set. The RDBLXMVS module contains the REVEXIT2 program necessary to
support Adabas Review client reporting. Consequently, when the globals table is
relinked, the necessary program is present to support Adabas Review client
reporting.
The REVEXIT exits include REVEXIT1 (formerly REVEXITB) and REVEXIT2. REVEXIT should be linked with ADALNK during installation, with the appropriate Adabas link globals table parameters (LGBLSET). The link globals table parameters specified via LGBLSET identify which REVEXIT entry points (REVEXIT1 or REVEXIT2) are called. If LGBLSET parameter REVIEW=YES is set, then REVEXIT is called by ADALNK before the Adabas call as entry point REVEXIT1; if LGBLSET parameters RVCLNT and REVHID are also specified, REVEXIT is also called after the Adabas call as entry point REVEXIT2.
The modules used to perform the linkage between REVEXIT and ADALNK are provided with your Adabas Review installation with names in the format RDBLXsys, where sys is a three-character code representing the link environment (for example, MVS for z/OS environments, VSE for z/VSE, COM for Com-plete environments, IMS for IMS environments, and BS2 for BS2000 environments). For more information about performing this linkage, read the appropriate Adabas Review installation documentation.
Note:
A return code 4 from the link-edit of the globals table is acceptable
because it indicates that the Review exit (REVEXITB or REVEXIT1) has not been
resolved by this step. The next link-edit step in the sample jobs should
resolve this and finish with return code zero.
Restart Adabas and TSO, and verify that an Adabas or WAL load library with the modules ADATMZ, ADALNKR, and CCSTCK is specified for the batch/TSO startup job.
Initialize and test Adabas Review.
Read Starting Adabas Review for information about initializing and verifying the installation of the online portion of Adabas Review.
This section provides instructions for installing the IMS/DC components of Adabas Review for the Adabas 8 IMS/DC link routine.
To install the IMS/DC components of Adabas Review for the Adabas 8
IMS/DC link routine:
Modify the LNIGBL member found in AIIvrs.MVSSRCE, setting the following LGBLSET keywords:
| Parameter | Description | Syntax |
|---|---|---|
| REVHID | Specifies the preferred Adabas Review hub ID. This
value can be checked during Adabas CICS TP monitoring installation or during
the monitor activate process.
If REVHID is set to zero (0), the preferred Adabas Review hub ID is dynamic. When the hub ID is dynamic, it cannot be checked during Adabas CICS TP monitoring installation and the call to turn on client reporting must supply the correct Adabas Review hub ID to use. If REVHID is specified, REVIEW=YES must also be specified. If REVHID is specified and REVIEW=NO is also specified, the assembly of the globals table will abort with condition code 16 and the following message is given: REVHID requires REVIEW=YES This parameter is not valid in:
|
REVHID=hubid |
| REVIEW | Indicates whether or not Software AG’s Adabas Review performance monitor is installed and active. |
REVIEW={NO | YES} |
| REVREL | Specifies the level of Adabas Review support to be
generated in the link globals table module. This is necessary because Review
4.6 and later releases have changed the Review pre-call exit name from
"REVEXITB" to "REVEXIT1".
Valid values are "45" or
"46" (without the quotes). If other values are given
the assembly of the globals table will fail with condition code 16 and MNOTE
messages from the assembler.
When REVREL=45 is specified, it indicates that support for Adabas Review release 4.5 and earlier should be used. The Adabas Review REVEXITB exit name is used and an associated external reference statement is generated when the globals table is assembled. When REVREL=45 is specified, the RVCLNT keyword must be set to NO. If RVCLNT=YES and REVREL=45 are both specified, the assembly of the globals table will fail with condition code 16 and MNOTE messages from the assembler. When REVREL=46 is specified it indicates that support for Adabas Review release 4.6 and later should be used. The Adabas Review REVEXIT1 exit name is used and an associated external reference statement is generated when the globals table is assembled. Note: |
REVREL={45 | 46} |
| RVCLNT | Indicates whether the Adabas Review client reporting
exit should be active. The default is NO.
If RVCLNT=YES is specified, REVIEW=YES must also be specified. If RVCLNT=YES is specified and REVIEW=NO is also specified, the assembly of the globals table will abort with condition code 16 and the following message is given: RVCLNT=YES requires REVIEW=YES This parameter is not valid in:
|
RVCLNT={YES|NO} |
For example, the following keywords indicate that Adabas Review support should be installed and, specifically, support for Adabas Review 4.6 and later.
REVIEW=YES REVREL=46
Assemble and link-edit the modified LNIGBL member into a load library and make it available for the next step.
Modify and link the Natural IMS/DC interface using sample job LREVLNI in the Review JOBS data set. Include the following in the link of the Natural IMS interface modules:
ADALNI and ADALNK
Note:
Do not link any Adabas Review link routine exits to ADALNI and
ADALNK prior to this step. Also, do not code REVIEW=YES in the LNKGBLS table
linked with ADALNK for the Natural IMS module.
RDBLXIMS, the Adabas Review IMS/DC link routine exit.
The REVEXIT exits include REVEXIT1 (formerly REVEXITB) and REVEXIT2. REVEXIT should be linked with ADALNK during installation, with the appropriate Adabas link globals table parameters (LGBLSET). The link globals table parameters specified via LGBLSET identify which REVEXIT entry points (REVEXIT1 or REVEXIT2) are called. If LGBLSET parameter REVIEW=YES is set, then REVEXIT is called by ADALNK before the Adabas call as entry point REVEXIT1; if LGBLSET parameters RVCLNT and REVHID are also specified, REVEXIT is also called after the Adabas call as entry point REVEXIT2.
The modules used to perform the linkage between REVEXIT and ADALNK are provided with your Adabas Review installation with names in the format RDBLXsys, where sys is a three-character code representing the link environment (for example, MVS for z/OS environments, VSE for z/VSE, COM for Com-plete environments, IMS for IMS environments, and BS2 for BS2000 environments). For more information about performing this linkage, read the appropriate Adabas Review installation documentation.
Note:
A return code 4 from the link-edit of the globals table is acceptable
because it indicates that the Review exit (REVEXITB or REVEXIT1) has not been
resolved by this step. The next link-edit step in the sample jobs should
resolve this and finish with return code zero.
Read Starting Adabas Review for information about initializing and verifying the installation of the online portion of Adabas Review.
