SET-EVALUATION-PERIOD Set analysis period and analysis subinterval

The SET-EVALUATION-PERIOD statement defines the analysis period and analysis subinterval of an analysis run. The analysis period (evaluation period) is the period during which the SM2 output file is to be monitored.

The analysis subinterval defines the division within the analysis period over which the individual values for the bar chart output are to be averaged.

Within an SM2R1 run different SET-EVALUATION-PERIOD statements can be issued for different analyses.

Format

SET-EVALUATION-PERIOD

EVALUATION-PERIOD = *DAY(...) / *MONTH(...) / *YEAR(...) / *PERIOD(...)
	*DAY(...)
		|	DAY = *EARLIEST / *CURRENT / <date>
	*MONTH(...)
		|	YEAR = *THIS-YEAR / <integer 0..2059>
		|	,MONTH = *LAST-MONTH / <integer 1..12>
	*YEAR(...)
		|	YEAR = *LAST-YEAR / <integer 0..2059>
	*PERIOD(...)
		|	FROM = *START / *DATE(...)
		|		*DATE(...)
		|			|	DAY = *EARLIEST / *CURRENT / <date>
		|			|	,TIME = *00:00:00 / <time>
		|	,TO = *STOP / *DATE(...)
		|		*DATE(...)
		|			|	DAY = *START-DATE / <date>
		|			|	,TIME = *23:59:59 / <time>
		|	,TIME-STEPS = *STD / <integer 1..1000>(...)
		|		<integer 1..1000>(...)
		|			|	DIMENSION = *MINUTES / *SECONDS / *DAYS / *HOURS / *NO-OF-STEPS

General time specifications

time	Time in the form hh:mm:ss. The seconds need not be specified; analysis then begins and ends at the minutes boundary.
date	The date can be specified in the form yy-mm-dd or yyyy-mm-dd.

Operands

EVALUATION-PERIOD =
Defines the time frame covered by the analysis period and the analysis subinterval.

EVALUATION-PERIOD = *DAY(...)
The analysis period covers the specified day. SM2R1 sets the length of a subinterval to 15 minutes.

DAY =
Defines the day to be analyzed.

DAY = *EARLIEST
The analysis period covers the first day in the SM2 output file.

DAY = *CURRENT
The analysis period covers the current day from 00:00:00 to 23:59:59.

DAY = <date>
The analysis periods covers the date specified as 00:00:00 to 23:59:59.

EVALUATION-PERIOD = *MONTH(...)
The analysis period covers the current month. SM2R1 sets the length of a interval to 8 hours.

YEAR =
Defines the year during which a month is to be analyzed.

YEAR = *THIS-YEAR
A month of the current year is to be analyzed.

YEAR = <integer 0..2059>
A month in the specified year is to be analyzed.

MONTH =
Defines the month of the specified year.

MONTH = *LAST-MONTH
The analysis period is the month before the current month of the year defined.

MONTH = <integer 1..12>
The analysis period is the specified month from 00:00:00 of the first day to 23:59:59 of the last day.

EVALUATION-PERIOD = *YEAR(...)
The analysis period covers the specified year. SM2R1 sets the length of a subinterval to 7 days. In general the week and year boundaries are not identical. The period actually analyzed is therefore somewhat longer than the specified year.

YEAR =
Defines the year in which a month is to be analyzed.

YEAR = *LAST-YEAR
The analysis period is the previous year.

YEAR = <integer 0..2059>
The analysis period is the specified year.

EVALUATION-PERIOD = *PERIOD(...)The analysis period is specified explicitly.

FROM =
Defines the start of the analysis period.

FROM = *START
The analysis period starts at the beginning of the SM2 output file.

FROM = *DATE(...)
Defines the start of the analysis period by specifying the date and time of day.

DAY =
Defines the start date of the analysis period.

DAY = *EARLIEST
The start date is the first day in the SM2 output file.

DAY = *CURRENT
The start date is the current day.

DAY = <date>
The start date is the specified day.

TIME =
Defines the time the analysis period starts.

TIME = *00:00:00
Analysis begins at 00:00:00 of the specified start date.

TIME = <time>
Analysis begins at the specified time on the specified start date.

TO =
Defines the time at which the analysis period ends.

TO = *STOP
The analysis period stops at the end of the SM2 output file.

TO = *DATE(...)
Defines the end of the analysis period by specifying the date and time of day.

DAY =
Defines the end of the analysis period.

DAY = *START-DATE
The end date of the analysis period is the same as the start date.

DAY = <date>
The end date of the analysis period is the specified day.

TIME =
Defines the time at which the analysis period ends.

TIME = *23:59:59
The analysis ends at 23:59:59 on the specified end date.

TIME = <time>
The analysis ends at the specified time on the specified end date.

TIME-STEPS =
Defines the size of the analysis subintervals.

TIME-STEPS = *STD
The entire analysis period is subdivided into 100 subintervals. This corresponds to single-page bar chart output.

TIME-STEPS = <integer 1..1000>(...)
The user can define the extent of an analysis subinterval either directly by specifying a number of time units (e.g. TIME-STEPS=5(DIM=*MINUTES)) or indirectly by specifying a specific number of analysis subintervals, based on which the entire analysis period is to be subdivided. (TIME-STEPS=50(DIM=*NO-OF-STEPS)).

DIMENSION =
Defines the time unit of the analysis subinterval.

DIMENSION = *MINUTES
Time unit in minutes.

DIMENSION = *SECONDS
Time unit in seconds.

DIMENSION = *DAYS
Time unit in days.

DIMENSION = *HOURS
Time unit in hours.

DIMENSION = *NO-OF-STEPS
Denotes the subdivision of the analysis period into the specified number of subintervals.

Example

//SET-EVALUATION-PERIOD EVALUATION-PERIOD=*DAY(*CURRENT)

This statement designates the current day as the analysis period.

If the selected subintervals are too small (TIME-STEPS.. less than the SM2 monitoring cycle), blanks will appear in the chart instead of a bar.

Up to 100 analyzed subintervals can be represented graphically on one printed page. The statistical data of the same 100 subintervals is output in table form on the same page. If the entire analysis period comprises more than 100 subintervals, report output is spread over several pages, but the statistical data refers to the associated chart and not to the whole analysis period.