DESCRIPTION
       calendar_conf  reflects  the  format  of the Univa Grid Engine calendar
       configuration. The definition of calendars is used to specify "on duty"
       and  "off  duty" time periods for Univa Grid Engine queues on a time of
       day, day of week or day of year basis. Various calendars can be  imple-
       mented  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,  Univa  Grid Engine allows backslashes (\) be used to escape new-
       line (\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 gen-
       erally 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

       o  NONE means, no definition is made on the year basis

       o  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,

       o  all day long is assumed if daytime_range_list is omitted,

       o  switching the queue to "off" (i.e. disabling it) is assumed if state
          is omitted,

       o  the queue is assumed to  be  enabled  for  days  neither  referenced
          implicitly (by omitting the year_day_range_list) nor explicitly

       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

       o  NONE means, no definition is made on the week basis

       o  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,

       o  every day in the week is assumed if week_day_range_list is omitted,

       o  syntax  and  semantics of daytime_range_list and state are identical
          to the definition given for the year field above,

       o  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:

       o  "off"-areas  are  overridden  by   overlapping   "on"-   and   "sus-
          pended"-areas and "suspended"-areas are overridden by "on"-areas.

       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.


       o  Area  overriding  occurs  only  within  a year/week basis. If a year
          entry exists for a day then only the year  calendar  is  taken  into
          account  and  no area overriding is done with a possibly conflicting

       o  Night, weekend and public holiday calendar:

          On public holidays "night" queues are explicitly enabled. On working
          days queues are disabled between 6.00 and 20.00. Saturday and Sunday
          are implicitly handled as enabled times:

            calendar_name  night
            year           1.1.1999,6.1.1999,28.3.1999,30.3.1999-
            31.3.1999,18.5.1999-19.5.1999,3.10.1999,25.12.1999,26
            .12.1999=on
            week           mon-fri=6-20


       o  Day calendar:

          On  public  holidays "day"-queues are disabled. On working days such
          queues are closed during the night between 20.00 and 6.00, i.e.  the
          queues  are  also  closed  on Monday from 0.00 to 6.00 and on Friday
          from 20.00 to 24.00. On Saturday and Sunday the queues are disabled.

            calendar_name  day
            year           1.1.1999,6.1.1999,28.3.1999,30.3.1999-
            31.3.1999,18.5.1999-19.5.1999,3.10.1999,25.12.1999,26
            .12.1999
            week           mon-fri=20-6 sat-sun


       o  Night, weekend and public holiday calendar with suspension:

          Essentially  the  same  scenario as the first example but queues are
          suspended instead of switching them "off".

            calendar_name  night_s
            year           1.1.1999,6.1.1999,28.3.1999,30.3.1999-
            31.3.1999,18.5.1999-19.5.1999,3.10.1999,25.12.1999,26
            .12.1999=on
            week           mon-fri=6-20=suspended


       o  Day calendar with suspension:

          Essentially the same scenario as the second example but  queues  are
          suspended instead of switching them "off".

            calendar_name  day_s
            year           1.1.1999,6.1.1999,28.3.1999,30.3.1999-
            31.3.1999,18.5.1999-19.5.1999,3.10.1999,25.12.1999,26
            .12.1999=suspended
            week           mon-fri=20-6=suspended sat-sun=suspended


       See sge_intro(1) for a full statement of rights and permissions.



UGE 8.0.0                $Date: 2007/09/27 14:02:27 $         CALENDAR_CONF(5)

Man(1) output converted with man2html