SET-EXCEPTION-PERIOD Exclude periods

The SET-EXCEPTION-PERIOD statement offers the user a convenient option for excluding either fixed periods or certain recurring periods such as weekdays or weekends. The statement thus especially supports long-term analysis with SM2R1.

The statement takes effect during execution of the PRINT-QUEUE-TRANSITION, PRINT-REPORTS, PRINT-SUMMARY and START-AUTOMATIC-ANALYSIS statements.

Format

SET-EXCEPTION-PERIOD                                                                                                                             

EXCEPTION = *NONE / list-poss(3): *PERIOD(...)
	*PERIOD(...)
		|	FROM = *DATE (...)
		|		*DATE(...)
		|			|	DAY = <date with-compl>
		|			|	,TIME = *00:00:00 / <time>
		|	,TO = *DATE (...)
		|		*DATE(...)
		|			|	DAY = *START-DATE / <date with-compl>
		|			|	,TIME = *23:59:59 / <time>
,REPEAT-EXCEPTION = *NONE / *PERIOD(...)
	*PERIOD(...)
		|	FROM = *DEFINED (...)
		|		*DEFINED(...)
		|			|	DAY-OF-THE-WEEK = *MONDAY / *TUESDAY / *WEDNESDAY / *THURSDAY / *FRIDAY /
		|			|		*SATURDAY / *SUNDAY
		|			|	,TIME = *00:00:00 / <time>
		|	,TO = *DEFINED (...)
		|		*DEFINED(...)
		|			|	DAY-OF-THE-WEEK = *SAME-DAY / *MONDAY / *TUESDAY / *WEDNESDAY /
		|			|		*THURSDAY / *FRIDAY / *SATURDAY / *SUNDAY
		|			|	,TIME = *23:59:59 / <time>

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 data can be specified in the form yy-mm-dd or in the form yyyy-mm-dd.

Operands

EXCEPTION =
The specified period is excluded from analysis.

EXCEPTION = *NONE
No period is specified.

EXCEPTION = list-poss(3): *PERIOD(...)
The exclusion period comprises the period explicitly specified.

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

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

TIME =
Specifies the start time of the exclusion period.

TIME = *00:00:00
Exclusion starts at 00:00:00 on the defined start date.

TIME = <time>
Exclusion starts at the specified time on the specified start date.

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

DAY =
Specifies the end date of the exclusion period.

DAY = *START-DATE
The end date of the exclusion period is equal to the start date.

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

TIME =
Defines the end time of the exclusion period.

TIME = 23:59:59
Exclusion ends at 23:59:59 of the defined end date.

TIME = <time>
Exclusion ends at the specified time on the define end date.

REPEAT-EXCEPTION =
The specified period is periodically excluded from analysis.

REPEAT-EXCEPTION = *NONE
No period is specified.

REPEAT-EXCEPTION = *PERIOD(...)
The exclusion period comprises the period explicitly specified.

FROM = *DEFINED(...)
Defines the start of the exclusion period by specifying a day of the week and a time.

DAY-OF-THE-WEEK = *MONDAY / ... / *SUNDAY
The start day of the exclusion period is the specified day of the week.

TIME =
Defines the start time of the exclusion period.

TIME = *00:00:00
Exclusion begins at 00:00:00 of the specified day of the week.

TIME = <time>
Exclusion begins at the specified time of the specified day of the week.

TO = *DEFINED(...)
Defines the end of the exclusion period for the specified day of the week and time.

DAY-OF-THE-WEEK =
Defines the end of the exclusion period.

DAY-OF-THE-WEEK = *SAME-DAY
The end date of the exclusion period is the same day it began.

DAY-OF-THE-WEEK = *MONDAY / ... / *SUNDAY
The end date of the exclusion period is the specified day of the week.

TIME =
Defines the end time of the exclusion period.

TIME = *23:59:59
Exclusion ends at 23:59:59 of the specified day of the week.

TIME = <time>
Exclusion ends at the specified time of the specified day of the week.

Example

//SET-EXCEPTION-PERIOD REPEAT-EXCEPTION=*PERIOD(FROM=*DEFINED(*FRIDAY,16:00:00),TO=*DEFINED(*MONDAY,08:00:00))

This statement excludes weekends from long-term analysis.