sge_calendar_conf man page

calendar_conf — Sun Grid Engine calendar configuration file format

Description

calendar_conf reflects the format of the Sun Grid Engine calendar configuration. The definition of calendars is used to specify "on duty" and "off  duty" time periods for Sun Grid Engine queues on a time of day, day of week  or day of year basis. Various calendars can be implemented and the  appropriate calendar definition for a certain class of jobs can be attached to a queue.

calendar_conf entries can be added, modified and displayed with the -Acal,  -acal, -Mcal, -mcal, -scal and -scall options to qconf(1) or with the calendar configuration dialog of the graphical user interface qmon(1).

Note, Sun Grid Engine allows backslashes (\) be used to escape newline (\newline) characters. The backslash and the newline are replaced with a space (" ") character before any interpretation.

Format

calendar_name

The name of the calendar to be used when attaching it to queues or when  administering the calendar definition. See calendar_name in sge_types(1) for a precise definition of valid calendar names.  

year

The queue status definition on a day of the year basis. This field generally will specify on which days of a year (and optionally at which times on those days) a queue, to which the calendar is attached, will change to a certain state. The syntax of the year field is defined as follows:

year:=
	{ NONE
    | year_day_range_list=daytime_range_list[=state]
    | year_day_range_list=[daytime_range_list=]state
    | state}

Where

  • NONE means, no definition is made on the year basis
  • if a definition is made on the year basis, at least one of year_day_range_list, daytime_range_list and state  always have to be present,
  • all day long is assumed if daytime_range_list is omitted,
  • switching the queue to "off" (i.e. disabling it) is assumed if state is omitted,
  • the queue is assumed to be enabled for days neither referenced implicitly (by omitting the  year_day_range_list) nor explicitly

and the syntactical components are defined as follows:

	year_day_range_list := 	{yearday-yearday|yearday},...
	daytime_range_list := 	hour[:minute][:second]-
	 	hour[:minute][:second],...
	state := 	{on|off|suspended}
	year_day := 	month_day.month.year
	month_day := 	{1|2|...|31}
	month := 	{jan|feb|...|dec|1|2|...|12}
	year := 	{1970|1971|...|2037}

week

The queue status definition on a day of the week basis. This field generally will specify on which days of a week (and optionally at which times on those days) a queue, to which the calendar is attached, will change to a certain state. The syntax of the week field is defined as follows:

week:=
	{ NONE 
    | week_day_range_list[=daytime_range_list][=state]
    | [week_day_range_list=]daytime_range_list[=state]
    | [week_day_range_list=][daytime_range_list=]state} ...

Where

  • NONE means, no definition is made on the week basis
  • if a definition is made on the week basis, at least one of week_day_range_list, daytime_range_list and state  always have to be present,
  • every day in the week is assumed if week_day_range_list is omitted,
  • syntax and semantics of daytime_range_list and state are identical to the  definition given for the year field above,
  • the queue is assumed to be enabled for days neither referenced implicitly  (by omitting the week_day_range_list) nor explicitly

and where week_day_range_list is defined as

	week_day_range_list := 	{weekday-weekday|weekday},...
	week_day := 	{mon|tue|wed|thu|fri|sat|sun}

with week_day ranges the week_day identifiers must be different.

Semantics

Successive entries to the year and week fields (separated by blanks) are combined in compliance with the following rule:

Hence an entry of the form

	week 	12-18 tue=13-17=on

means that queues referencing the corresponding calendar are disabled the  entire week from 12.00-18.00 with the exception of Tuesday between 13.00-17.00 where the  queues are available.

Examples

(The following examples are contained in the directory $SGE_ROOT/util/resources/calendars).

See Also

sge_intro(1), sge__types(1), qconf(1), queue_conf(5).

Info

$Date: 2007/09/27 14:02:27 $ SGE 6.2u5 Sun Grid Engine File Formats