Previous Topic

Next Topic

Book Contents

Book Index

Statistics Calendar

Name of the Control-M periodic calendar within which statistics relating to the job are collected.

NOTE: This parameter is relevant only for jobs running in Control‑M for z/OS .

Additional information

Description

Usage

Optional

Format

A valid period calendar name consisting of from 1 through 8 alphanumeric characters.

Case Sensitive

Yes

Invalid Characters

  • Blanks
  • Non-English characters

Variable Name

None

Alternate names

  • Control‑M/EM Utilities: STAT_CAL
  • Control-M Report: Stat Calendar
  • Control-M/Server Utilities: (none)
  • Control‑M for z/OS: STAT CAL
  • Control-M/EM API: statistic_cal

As part of the post‑processing for each job, Control‑M for z/OS determines the elapsed run time of the job. All accumulated information regarding job execution, including the elapsed run time, is written to the IOA Log file.

Periodically, a statistics utility may be used to scan and analyze the IOA Log file. This utility gathers information about the start time of each job, its elapsed run time, CPU utilization time, and so on. The utility places this information in the Statistics file, where averages of these values can be maintained for each job.

If the Statistics Calendar parameter is not used to specify a periodic calendar, the statistics relating to a job are based on all run times of the job.

The Statistics Calendar parameter identifies the periodic calendar that is used to gather average runtime statistics for the job. The information displayed in the Statistics Period field identifies the specific days within that calendar that are used as the basis of the runtime statistics.

By using the Statistics Calendar parameter together with the information displayed in the Statistics Period field, you can obtain more precise statistical information about the running of the job, as shown in the following example:

EXAMPLE: Assume that a job runs daily, weekly, and monthly, and that the Statistics Calendar parameter identifies a periodic calendar that contains a number of months each specified in a manner similar to the following:

-----S--------------S-------------S-------------S-------------S-------------S---

1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +

09 D D W D D D D D W D D D D D W D D D D D W D D D D M

In this example, the job runs daily in Period D, weekly in Period W, and monthly in Period M.

If the job runs on the 3rd of the month, its statistics are collected for Period W. If it runs on the 6th of the month, its statistics are collected for Period D, and so on.

Parent Topic

Scheduling Parameters