calendar_conf

CALENDAR_CONF(5)   Grid Engine Enterprise Edition File Formats  CALENDAR_CONF(5)



NAME
       calendar_conf - Grid Engine Enterprise Edition calendar configuration
       file format

DESCRIPTION
       calendar_conf reflects the format of the Grid Engine Enterprise Edition
       calendar configuration. The definition of calendars is used to specify
       "on duty" and "off duty" time periods for Grid Engine Enterprise Edition
       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).  The format of the calendar configuration entries is defined as
       follows:

FORMAT
   calendar_name
       The name of the calendar to be used when attaching it to queues or when
       administering the calendar definition.

   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:=
           {year_day_range_list[=daytime_range_list][=state]
           |[year_day_range_list=]daytime_range_list[=state]
           |[year_day_range_list=][daytime_range_list=]state} ...

       Where

       ·  at least one of year_day_range_list, daytime_range_list and state
          always have to be present,

       ·  every day in the year is assumed if year_day_range_list is omitted,

       ·  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:=
           {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

       ·  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}

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

       ·  "off"-areas are overridden by overlapping "on"- and "suspended"-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 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).

       ·  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


       ·  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


       ·  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


       ·  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=suspend
            ed


SEE ALSO
       sge_intro(1), qconf(1), queue_conf(5).

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



GEEE 5.3                  $Date: 2001/07/20 08:19:15 $          CALENDAR_CONF(5)