Sun Grid Engine Information Center
Administering Sun Grid Engine
Index

Configuring Queue Calendars

For information about configuring queues, see Configuring Queues.

About Queue Calendars

Queue calendars define the availability of queues according to the day of the year, the day of the week, or the time of day. You can configure queues to change their status at specified times. You can change the queue status to disabled, enabled, suspended, or resumed (unsuspended).

The Grid Engine system enables you to define a site-specific set of calendars, each of which specifies status changes and the times at which the changes occur. These calendars can be associated with queues. Each queue can attach a single calendar, thereby adopting the availability profile defined in the attached calendar.

The syntax of the calendar format is described in detail in the calendar_conf(5) man page. A few examples are given in the next sections, along with a description of the corresponding administration facilities.

How to Configure Queue Calendars With QMON

1. In the QMON Main Control window, click the Calendar Configuration button.
   The Calendar Configuration dialog box appears. The Calendars list displays the available calendars.
   
   
   
2. In the Calendars list, click the calendar configuration that you want to modify or delete.
   • To delete the selected calendar, click Delete.
   • To modify the selected calendar, click Modify.
   • To add a calendar, click Add.
     In all cases, the Add/Modify Calendar dialog box appears. The following example shows the definition for a queue that is available outside office hours and on weekends. In addition, the Christmas holidays are defined to be handled like weekends.
     
     If you click Modify or Delete, the Calendar Name field displays the name of the selected calendar. If you click Add, you need to add a name in the Calendar Name field.
     The Year and Week fields enable you to define the calendar events, using the syntax described in the calendar_conf(5) man page.
     See the calendar_conf(5) man page for a detailed description of the syntax and for more examples.
     
     
3. To control access to a specific queue based on calendar data, attach the calendar to the queue as follows:
   1. From the main QMON window, click Queue Control.
   2. Select the queue name to which you want to attach the calendar and click the Modify button. The Modify queuename window appears with the General Configuration tab selected.
   3. On the General Configuration tab, use the drop-down list next to the Calendar field to choose the calendar to attach. Attaching a calendar configuration to a queue sets the availability profile defined by the calendar for the queue. See About Configuring Queues for more details about configuring queues.
      

Configuring Queue Calendars From the Command Line

To configure queue calendars from the command line, type the following command with appropriate options:

% qconf <options>

The following options are available:

• qconf -acal calendar-name – The -acal option (add calendar) adds a new calendar configuration named calendar-name to the cluster. An editor with a template configuration appears, enabling you to define the calendar.
• qconf -Acal filename – The -Acal option (add calendar from file) adds a new calendar configuration to the cluster. The added calendar is read from the specified file.
• qconf -dcal calendar-name [,...] – The -dcal option (delete calendar) deletes the specified calendar.
• qconf -mcal calendar-name – The -mcal option (modify calendar) modifies an existing calendar configuration named calendar-name. An editor opens calendar-name, enabling you to make changes to the definition.
• qconf -Mcal filename – The -Mcal option (modify calendar from file) modifies an existing calendar configuration. The calendar to modify is read from the specified file.
• qconf -scal calendar-name – The -scal option (show calendar) displays the configuration for calendar-name.
• qconf -scall – The -scall option (show calendar list) displays a list of all configured calendars.