CALENDAR commands

In SCHEDULE number of calendars can be defined. Some can be setup to be used system wide. Others just to be used by jobs inside a particular directory. The main purpose of a calendar definition is to assist in determining when to automatically reschedule a job.

For example you have a job that is to run every 3 days. Along with this interval you define a calendar which describes which days are allowed. This job may not be allowed to run on weekends. These two bits of information are used to control this automatic rescheduling process.

Calendar data is managed and maintained using the following commands.

Command	Alternate	Description
copy/calendar	cpcal	copy a calendar definition
create/calendar	mkcal	create a new calendar definition
delete/calendar	rmcal	delete a calendar definition
directory/calendar	lscal	list known calendar definitions
modify/calendar	chcal	modify a calendar definition
rename/calendar	mvcal	rename a calendar definition
type/calendar	morecal	type out the days in the calendar

When a calendar is mentioned in a job definition it is found by the following method:

Examine the local subdirectory (i.e. \topdir\subdir\) that the job is in (if the job is contained in a subdirectory) for the calendar. If found use this entry.
Examine the top directory (i.e. \topdir\) for the calendar. If found use this entry.
Examine the system wide default (i.e. \DEFAULT\) for the calendar. If found use this entry.

Once a calendar has been found the flag settings are examined to see if one of the HOLIDAY flags is set. If so, a HOLIDAY calendar is located using the same three steps listed above. Once the holiday calendar has been found it is merged into the selected calendar to form the final calendar that will be used for rescheduling.

In This Chapter