Skip Headers
Oracle® Coherence Developer's Guide
Release 3.5

Part Number E14509-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

24 How to Modify Report Batch

Configuring a report batch is one of the steps in creating a custom report. You typically configure it after creating report configuration files. This configuration file determines what reports the reporter executes, how often the reports get executed, and where the reports are saved. If a single report can be used with different parameters, these parameters are also configured in the report batch. For more information on report configuration files, see Chapter 23, "How to Create a Custom Report".

Report Batch Deployment Descriptor

Use the report batch deployment descriptor to specify the various options for creating custom reports.

Document Location

The name and location of the descriptor defaults to report-group.xml. The default descriptor (packaged in coherence.jar) will be used unless a custom file is found in the application's classpath.

Document Root

The root element of the POF user type descriptor is report-group. This is where you may begin specifying the format of the custom report.

System Properties

Table 24-1 describes the system properties that can be used to control report batch from the command line.

Table 24-1 System Properties for Controlling Report Batch

Property Default Description

tangosol.coherence.management.report.configuration

reports/report-group.xml

The XML file containing the Reporter configuration settings, such as the list of reports, the report frequency, and so on.

tangosol.coherence.management.report.autostart

false

Flag to automatically start the reporter when the node is started.

tangosol.coherence.management.report.distributed

false

Determines if the reporter is running in a central model (false) or on every node in the cluster (true).


Document Format

The report batch descriptor should begin with the following DOCTYPE declaration:

<!DOCTYPE report-group SYSTEM "report-group.dtd">

Example 24-1 illustrates the nesting of elements in a report batch document.

Example 24-1 Format of a Report Batch Configuration File (report-group.xml)

<report group>
  <frequency/>
  <output-directory/>
  <report-list>
    <location/>
  <report-config>
    <init-params>
      <init-param>
      </init-param>
  <report-config/>
<report-group>

Report Batch Element Index

Table 24-2 describes the relationship between the report batch elements.


frequency

Used in: report-group

Description

Required. A string containing the number of seconds, minutes between each execution of the report batch. 10s will run the report ever 10 seconds. 5m will run the report every 5 minutes. Selecting an appropriate frequency is critical. If the frequency is too short, the reporter can generate a large amount of data and consume significant disk space. If the frequency is too long, the information will not be useful. It is recommended that a process for purging and archiving historical information is in place before configuring the reporter.


location

Used in: report-list

Description

Required. The path to the report configuration file. For more information on this file, see Chapter 23, "How to Create a Custom Report".


init-param

Used in: init-params

Description

The init-param element contains an initialization parameter for a report. The parameter consists of either a parameter name or type, and its value.


init-params

Used in: report-config

Description

Optional. The init-params element contains a list of initialization parameters.


output-directory

Used in: report-group

Description

Optional. The directory path to prepend to the output file names from the report configuration files. The username which the node is executing must have read write access to this path.


param-name

Used in: init-param

Description

The param-name element specifies the name of the initialization parameter.


param-type

Used in: init-param

Description

The param-type element specifies the Java type of the initialization parameter. Supported types are:


param-value

Used in: init-param

Description

The param-value element specifies a value of the initialization parameter. The value is in a format specific to the type of the parameter.


report-config

Used in: report-group

Description

The report-config contains the configuration file name and the initialization parameters for the report.


report-group

Used in: root element

Description

Describes the report list, the frequency, the report parameters, and the output directory for the batch.


report-list

Used in: report-group

Description

Required. The list of reports to include in the batch. This element contains the <report-config> subelement.