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 supported TP monitor: Com-plete, CICS, and batch.
This document covers the following topics:
To install the Com-plete components of Adabas Review for use with the Adabas 8
Com-plete link routine:
Edit the LCOGBL link globals member found in the ADAvrs.LIBR 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 the Adabas 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 the Adabas 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 VSE environments. The parameter exists in VSE environments, but should be set to "0". |
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 VSE environments. The parameter exists in VSE environments, but should be set to zero "NO". |
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
Use the JCS contained in the sublibrary member LREVLCO.X to set and assemble the LCOGBL module and link this to make the ADALCO phase with the Adabas Review link routine exit.
Note:
The target of the link in this step must be a sublibrary in the
Com-plete LIBDEF PHASE search concatenation.
Restart Adabas and Com-plete and verify that the modules ADATMZ, ADALNKR, and CCSTCK are included in the LIBDEF concatenation for the Com-plete startup job.
Initialize and test Adabas Review.
Refer to section Starting Adabas Review for information about initializing and verifying the installation of the online portion of Adabas Review.
To install the CICS components of Adabas Review for use with the Adabas 8 CICS
link routine:
Modify the member CICSGBL found in the ADAvrs.LIBR library, and set the REVIEW and REVREL LGBLSET keywords:
| Parameter | Description | Syntax |
|---|---|---|
| REVHID | Specifies the preferred Adabas Review hub ID. This
value can be checked during the Adabas 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 the Adabas 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 VSE environments. The parameter exists in VSE environments, but should be set to "0". |
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 VSE environments. The parameter exists in VSE environments, but should be set to zero "NO". |
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
Modify the sample job LREVLCIC.X to set the SVC, DBID, library, and sublibrary information and submit it.
Restart Adabas and CICS.
Initialize and test Adabas Review.
Refer to section Starting Adabas Review for more information about initializing and verifying the installation of the online portion of Adabas Review.
This section provides instructions for installing the batch components of Adabas Review with the Adabas batch link routines.
Important:
If an ADALNK batch link routine has been modified to accommodate
the needs of an Adabas product extension (such as Adabas Review), it should not
be used for the Adabas nucleus or Adabas utility jobs.
To install the batch components of Adabas Review for the Adabas 8 batch link
routine:
Edit member LNKGBLS.A in the Adabas distribution sublibrary. Provide values for the LOGID, SVC, GBLNAME, and other keywords to suit your installation requirements. Be sure to set the REVIEW and REVREL LGBLSET keywords:
| Parameter | Description | Syntax |
|---|---|---|
| REVHID | Specifies the preferred Adabas Review hub ID. This
value can be checked during the Adabas 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 the Adabas 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 VSE environments. The parameter exists in VSE environments, but should be set to "0". |
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 VSE environments. The parameter exists in VSE environments, but should be set to zero "NO". |
RVCLNT={YES|NO} |
REVIEW=YES REVREL=46 OPSYS=VSE
Note:
If you elect to use the reentrant link routine, edit member
LNKRGBL.A in the Adabas distribution sublibrary.
Edit the ALNKLNK8.X member found in the Adabas 8 sublibrary. This member will assemble and catalog the LNKGBLS.A module and link it and any desired exits with the LNKVSE8.OBJ module to create the ADALNK.PHASE member for Adabas 8. The ALNKLNK8.X member includes sample link-edit control cards to support UES by including the LNKUES.OBJ. module with the ASC2EBC and EBC2ASC translation tables. Modify the link-edit control cards to include any additional Software AG exit or user exit, as specified in the updated LNKGBLS.A member.
Note:
If you elect to use the reentrant link routine, edit member
ALNKLNR8.X in the Adabas distribution sublibrary.
Provide the ADALNK.PHASE member in the LIBDEF search chain for the job step that will require Adabas database access or Software AG services.
Note:
If you elect to use the reentrant link routine, provide the
ADALNKR.PHASE member in the LIBDEF search chain for the job step that will
required Adabas database access or Software AG services.
Restart Adabas and verify that the modules ADATMZ, ADALNK, ADALNKR, and CCSTCK are included in the LIBDEF concatenation for the batch startup job.
Initialize and test Adabas Review.
Refer to section Starting Adabas Review for more information about initializing and verifying the installation of the online portion of Adabas Review.
