PERIOD

The PERIOD statement associates reports with one or more specific date-time periods. This association is made by simply identifying the name of the CYCLE statement that, in turn, specifies one or more date-time ranges.

PERIOD CYCLE=cyclename
[,RPTS={COMBINED|SEPARATE}]

Optionally, if multiple date-time periods are involved, the PERIOD statement allows you to specify whether reports are to be separated by date-time range or combined into a single report.

The PERIOD statement is the third statement of the DATETIME, CYCLE, PERIOD statement group that specifies the data that Analyzer accepts (DATETIME), how it is organized into date-time ranges (CYCLE), and how it is subsequently grouped and reported (PERIOD).

The PERIOD statement can appear in the general control statement set, in the report control statement set, or in both sets. Within the general control statement set, PERIOD specifies a reporting period cycle name for all reports. Within the report control statement set, PERIOD specifies a reporting period cycle name for that particular report, which overrides any PERIOD statement defined in the general control statement set (but only for the one report).

When using the PERIOD statement, both the DATETIME and CYCLE control statements must be defined. The order of these statements must be

  1. DATETIME
  2. CYCLE
  3. PERIOD

If you do not enter the commands in this sequence, a control statement error results.

Parameters

The parameters for the PERIOD control statement are as follows:

CYCLE=

specifies the unique cycle name identifier defined in a preceding CYCLE control statement

This parameter is required and must specify the name of a CYCLE statement appearing in the general control statement set.

For a list of permitted values for CYCLE, see the table that shows the permitted values for the cycle name parameter in CYCLE.

RPTS=

specifies whether data for all date-ranges the CYCLE statement is to be reported separately by date-range or combined into one report

  • COMBINED—data for all date-time ranges specified by the CYCLE statement is combined into a single report

  • SEPARATE—data is reported separately for each date-time range specified in the CYCLE statement

    When a CYCLE statement specifies multiple date-time ranges and RPTS=SEPARATE is specified, multiple reports are produced, each containing data for each date-time range.

    For example, if the DATETIME range defines 1 months’ worth of data (and there is input data available for this period), a CYCLE range defined as DAILY produces one report for each whole or fractional day that falls within the DATETIME range.

    If RPTS=COMBINED is specified, one report is produced that combines the data from all date-time ranges.

Examples

The following examples illustrate the use of the PERIOD control statement.

PERIOD  CYCLE=WEEKLY,RPTS=SEPARATE

When defined in the general control statement set, this example produces separate reports for each weekly period.

IOQ
PERIOD  CYCLE=DAILY

When defined directly after a report control statement in the report control statement set, this example produces an I/O Queuing Activity report for each day’s data. This PERIOD statement has no effect on other report control statements defined in the report control statement set.

Related topic

General-control-statements


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*