NAME

scheduler.conf - Blocks determine the jobs run and schedule when they are run


SYNOPSIS

/opt/pmx/etc/scheduler.conf


DESCRIPTION

Scheduled jobs in PureMessage are run by the Scheduler service. The list of jobs handled by the Scheduler is displayed in the Scheduled Jobs section of the Local Services tab in the PureMessage Manager. If you want additional jobs to be run by the Scheduler, create event sections in this configuration file. For example:

    <event queue>
        desc = 'Run the PureMessage Queue'
        enabled = 1
        action = /opt/pmx/bin/pmx-queue
        type = exec
        #run every five minutes
        <when>
            s = 1
            m = */5
        </when>
    </event>

The <when> block determines how often an event is run by the Scheduler. If the <when> block does not contain a value or if it is missing, the time defaults to once a minute. For events that run less often, specify times and dates. For example, to schedule an event to run at 2:40 a.m. on the 15th and 30th day of each month and every Sunday morning, enter:

    <when>
       s = 1
       m = 40
       h = 2
       md = 15
       md = 30
       wd = 7
    </when>

Note: You must include the s = 1 or it will run every second at that time (for 60 seconds, from 2:40 to 2:41).

Logging and Notifications

The scheduler_log file records scheduled job activity. By default, only scheduled job failures are logged. If you want PureMessage to log all results, scheduler.conf must contain the line debug=1.

You can also configure PureMessage to automatically send failure notifications to the administrator's email account. Notifications are sent if scheduler.conf includes the line notify=1. The line should appear outside of an <event> block. If this line is not included, or if notify=0, notifications are not sent.


COPYRIGHT

Copyright (C) 2000-2008 Sophos Group. All rights reserved. Sophos and PureMessage are trademarks of Sophos Plc and Sophos Group.