Version 4.6
 —  Concepts and Facilities  —

About Adabas Review Client Reporting

Client reporting allows you to collect client data you can use to determine where command processing time is spent. Client reporting is currently provided for Adabas Review hubs only in z/OS environments using the TSO , CICS and IMS monitors; it is not currently supported in batch or Com-plete. Client reporting is intended as a diagnostic tool and can be activated and deactivated as needed.

Data for client reports is normally collected in the client address space from the client as well as the Adabas data server. Note that data for client reports can be collected when Adabas Review is running either local or hub mode, but can only be transferred to and reported from a hub.

Caution:
The process required to collect client data increases the overhead of your system. We therefore recommend that you activate client reporting only for as long as it takes to diagnose a problem. We do not recommend that client reporting be activated all the time.

This document covers the following topics:


Installation and Activation of Client Reporting

Client reporting is currently supported for Adabas Review hubs in z/OS environments. For complete information on how to install client reporting, read Installation Phase 2, in the Adabas Review z/OS Installation Guide. Installation of client reporting support involves performing the following tasks at some point in the Adabas Review installation:

Status messages are provided during installation indicating whether or not client reporting is supported by the system. After installation, if client reporting is supported by the CICS system, client reporting state messages are produced indicating when client reporting is activated or deactivated.

Once client reporting is installed, it is not automatically activated. Instead, you must manually activate it using SYSREVDB. Activate and deactivate client reporting data collection as needed by your installation. To verify if client reporting is turned on correctly please review any LNKRVX* messages appearing on the console log. For more information, read Managing Client Reporting. Because of the CICS system overhead that can occur while client reporting statistics are collected, we do not recommend that you leave it activated for very long.

Top of page

Client Reporting Data Collection Process

The following diagram depicts the client reporting data collection process when client reporting has been activated.

graphics/review_client_process.png

When the Adabas call is processed after client reporting has been activated, the Adabas SVC captures the timing data necessary to produce the data stored in the client reporting fields. Then REVEXIT2 collects and sends that data, via Trans-port, to the preferred Adabas Review hub for the call. The client reporting data is included with a subset of a command log record.

Caution:
This process has some impact on the performance of CICS. We therefore recommend that you run client reporting for controlled periods of time as a diagnostic tool only.

Data collection occurs for each Adabas where a globals table has been prepared to support it.

Top of page

Data Collected for Client Reporting

Data for client reports is normally collected in the client address space from the client as well as the Adabas data server. Note that data for client reports can be collected when Adabas Review is running either local or hub mode, but can only be transferred to and reported from a hub.

When client reporting is activated, three data fields, specific to client reporting, are collected and included with a subset of the command log record:

Note:
For more information on how duration fields are calculated in Adabas Review, read Adabas Review Duration Field Derivations.

These specific client reporting fields become available for client reporting reports only when client reporting is activated. For complete information about the specific client reporting fields, read Client Reporting Fields (CMON).

In addition, a subset of the other field data collected by Adabas Review from the Adabas server is also available for client reporting reports. This includes the data for the Adabas Review fields ADADURA, CQDURA, DBID, JOBNAME, NUCID, ROUTTIME, SEQUENCE, and TOTDURA. If you do not want to collect this data, the appropriate ADARUN parameter of the Adabas server has to be set as described in Adabas Nucleus (PROGRAM=ADANUC) ADARUN REVIEW Parameter Setting Considerations for Data Collection Under Client Reporting.

For a complete list of fields available for client reporting reports, read Fields Available for Client Reporting.

Top of page

Reporting on Client Reporting Data

Use the Edit Client Report screen in SYSREVDB to create a client report definition. For more information, read Maintaining Standard Database and Client Reporting Reports.

In addition, you can use the CLASS parameter of the batch REPORT statement to specify whether the batch report to be generated is a client reporting report. Valid values are "STANDARD" (the report is a standard report) and "CLIENT" (the report is a client reporting report). The default is "STANDARD". The CLASS parameter can be specified on both detailed and summary reports. For more information about the CLASS parameter, read REPORT Statement.

Top of page

Adabas Nucleus (PROGRAM=ADANUC) ADARUN REVIEW Parameter Setting Considerations for Data Collection Under Client Reporting

Data for client reports is normally collected in the client address space from the client as well as the Adabas data server. Note that data for client reports can be collected when Adabas Review is running either local or hub mode, but can only be transferred to and reported from a hub.

Once client reporting is activated (turned on), data is collected for the three specific client reporting data fields: CDURA, CRCVDURA, and CWRKDURA. Data for these fields is collected regardless of the ADARUN REVIEW parameter setting of the databases which are called from within this client program. However, some reporting fields (see the list below) in client reporting reports are affected by the setting of the ADARUN REVIEW parameter:

For more information about the ADARUN REVIEW parameter, read REVIEW Parameter: Adabas Review Control.

Top of page