5.3.2 Overview of the execution agent performance report output function

The execution agent performance report output function can output a CSV-format file that collectively contains the job execution status information recorded in multiple execution agent performance log files. An execution agent performance report can provide the hourly aggregation results of the execution agent operating status, including the number of started jobs and the number of queued jobs. You can use this report to check whether the execution agents are carrying out the respected amount of work. The information output in CSV format can be visualized as graphs by using spreadsheet software such as Excel. These graphs will be helpful when you aggregate and analyze the output information for understanding the operating status of the execution agents.

The following figure shows the procedure from outputting an execution agent performance report to aggregating or analyzing the output information.

Figure 5‒3: Overview of the procedure from outputting an execution agent performance report to aggregating or analyzing the output information

The following table shows the types of information output to an execution agent performance report.

Table 5‒3: Types of information output to an execution agent performance report

Type of output information	Description
Job execution status	Number of executed jobs
Event job execution status	Number of executed event jobs
Queuing job execution status	Number of queued jobs#

To output execution agent performance reports, you must enable the execution agent performance report output function. When you enable the function, it starts outputting execution agent performance log files (in binary format). Operation status log data output to execution agent performance log files is retained in the files for seven days by default. The retention period of status log data can be changed by using the AJSAGTREPORTSTOREDAYPERIOD environment setting parameter. The maximum retention period that can be set is 21 days.

When you run the ajsagtreport command at the manager host, the contents of the execution agent performance log file are output to a CSV file. The ajsagtreport command can be used to set the target execution agent, the period for which output data is to be aggregated, and the aggregation interval. The ajsagtreport command provides options that allow you to specify such settings when running the command. For example, periodically outputting the operating status to CSV files provides an understanding of the current operating status, and allows for comparison with a past operating status.

The following figure depicts how you can use execution agent performance reports that are periodically output for comparison.

Figure 5‒4: Overview of periodically outputting execution agent performance reports for comparison

For details about the procedure for setting up the execution agent performance report output function, see the following:

• 6.6.1 Settings for the performance report output function in the JP1/Automatic Job Management System 3 Configuration Guide (in Windows) or 15.7.1 Settings for the performance report output function in the JP1/Automatic Job Management System 3 Configuration Guide (in UNIX)

• 6.6.2 Settings for the execution agent performance report output function in the JP1/Automatic Job Management System 3 Configuration Guide (in Windows) or 15.7.2 Settings for the execution agent performance report output function in the JP1/Automatic Job Management System 3 Configuration Guide (in UNIX)

For details about estimating the size of execution agent performance log files, see 3.4.9 Estimating the size of execution agent performance log files in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

For details about the ajsagtreport command, see ajsagtreport in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

To Page Top