HCL Workload Automation, Version 9.4

freedays

Use freedays to specify the name of a non-working days calendar that lists the non-working days for your enterprise. If and how a job stream runs on these particular days is defined in a freedays rule during the run cycle setup. HCL Workload Automation uses this calendar as the base calendar for calculating workdays for the job stream.

The keyword affects only the scheduling of the job streams for which it is specified.

Syntax

freedays Calendar_Name [-sa] [-su]

Arguments

Calendar_Name: The name of the calendar that must be used as the non-working days calendar for the job stream. If Calendar_Name is not in the database, HCL Workload Automation issues a warning message when you save the job stream. If Calendar_Name is not in the database when the command schedulr runs, HCL Workload Automation issues an error message and uses the default calendar holidays in its place. Do not use the names of weekdays for the calendar names.
-sa: Saturdays are workdays.
-su: Sundays are workdays.

Comments

If you specify a non-working days calendar in the job stream definition, then the concept of workdays takes the following value: workdays = everyday excluding saturday and sunday (unless you specified -sa or -su along with freedays) and excluding all the dates of Calendar_Name

If you do not specify freedays in the job stream definition, then: workdays = everyday excluding saturday and sunday and all the dates of the holidays calendar

By default, saturday and sunday are considered as non-working days unless you specify the contrary by adding -sa, -su or both after Calendar_Name.

Examples

Select job stream sked2 to run on 01/01/2005 and on all workdays as long as they are not listed in the non-working days calendar named GERMHOL.

schedule sked2
freedays GERMHOL
on 01/01/2005, workdays

Select job stream sked3 to run two workdays before each date in the PAYCAL calendar. Workdays are every day from Monday to Saturday as long as they are not listed in the non-working days calendar named USAHOL.

schedule sked3
freedays USAHOL -sa
on PAYCAL -2 workdays

Select job stream sked3 on the dates listed in the APDATES calendar. If the selected date is a non-working day, do not run the job stream. In this example, Sundays and all the dates listed in the GERMHOL calendar are to be considered as non-working days. All days from Monday to Saturday, except for the dates listed in GERMHOL, are workdays.

schedule sked3
freedays GERMHOL -sa
on APDATES fdignore

Select job stream testsked3 to run every weekday except 5/15/2005 and 5/23/2006. If 5/23/2006 is a non-working day, do not exclude it. In this example, Saturdays, Sundays, and all the dates listed in GERMHOL are to be considered as non-working days. All days from Monday to Friday, except for the dates listed in GERMHOL, are workdays.

schedule testskd3
freedays GERMHOL
on weekdays
except 5/15/2005 fdignore
except 5/23/2006

Select job stream testsked4 to run every day except two weekdays prior to every date listed in the MONTHEND calendar. If the date to be excluded is a non-working day, do not exclude it, but exclude the nearest following workday. In this example, non-working days are all the dates listed in USAHOL, while workdays are all the days from Monday to Sunday that are not listed in USAHOL.

schedule testskd4
freedays USAHOL -sa -su
on everyday
except MONTHEND -2 weekdays fdnext