AX2551

Configuring Scheduler system jobs

Scheduler includes several built-in system jobs that should be configured as part of your system setup activities. These jobs are created automatically by the system Scheduler service when it is started. These jobs control email notifications for Scheduler and other system processes, and perform periodic database cleanup.

NOTE: Only administrators can edit these system jobs.

To configure the Scheduler system jobs:

  1. In the Scheduler dialog, on the Service tab, click Scheduled Jobs.

    You should see the following scheduled jobs where the name starts with System:

    • System.SMTPMessageDelivery
    • System.ProcessNotification
    • System.SystemDataPurge
    • System.IndexMaintenance
  2. Double-click a job to open it for editing.

    • In the Tasks section, select the task name to access the task settings, and then edit the Task Details as necessary. See the following section for more details on the specific task settings.

    • In the Notifications section, configure the email notifications for the job as desired. By default, the jobs are configured to send notifications on error, however, you must specify a valid email address to receive these notifications (such as the email address of a system administrator).

  3. Save the modified job. The changes will apply the next time the job is processed.

The changes will apply the next time the job is executed.

NOTE: You can also access these jobs in Axiom Explorer, in \Axiom\Axiom System\Scheduler Working Folder.

If one of these jobs is removed from the schedule or deleted, you can restore it by right-clicking any system job or event handler and selecting Create system jobs and event handlers. Any unscheduled or deleted system jobs will be restored.

System job overview

The following table provides a brief description of the purpose of each job and its task settings.

Job Information

SMTPMessageDelivery

  • Description: This job enables email notifications for Scheduler jobs and other system processes, such as process management notifications. Email notifications are stored in the database until the SMTP Message Delivery task picks them up and sends them.

  • Configuration: This task is not operational until you specify the name of a valid SMTP server in your environment. Once you have completed the SMTP server settings, make sure to disable Test Mode so that email notifications will be sent. For more details on the task settings, see Scheduler task: SMTP Message Delivery.

  • Schedule: By default, the job is set to execute continuously (once per minute). We recommend leaving it at this frequency to ensure timely delivery of notifications, however, you can set the job to any desired frequency.

ProcessNotification

  • Description: This job enables reminder notifications for process management. These are notifications to remind users of upcoming due dates and overdue tasks.

  • Configuration: This task does not have any editable settings.

  • Schedule: By default, this job is set to execute once per hour. You should not change the frequency of this job.

SystemDataPurge

  • Description: This job purges old data from the system, such as old Scheduler job results, old email notifications, old temp table data, and old audit data. This task should be run regularly to help keep old and unnecessary data from impacting system performance.

  • Configuration: This task is configured to delete items that are older than a specified number of days (by default, 15 days). You can change the default settings for this task if desired. For more details on the task settings, see Scheduler task: Purge System Data.

  • Schedule: By default, this job is set to run every ten minutes from midnight to 4:00 AM. The task is operational as soon as it is created by the Scheduler service, using the default settings.

IndexMaintenance

  • Description: This job maintains the indexes on your Axiom databases (system database and audit database). It reports the current index fragmentation and then reorganizes or rebuilds the indexes as needed, depending on the current level of fragmentation. It also updates table statistics.

  • Configuration: Any changes made to the SQL statements in this system job should only be made with the guidance of Kaufman Hall Software Support and/or your SQL database administrator.

  • Schedule: By default, this task is set to run once per day, at 5:15 AM. The task is operational as soon as it is created by the Scheduler service, using the default settings.

Email notifications for system jobs

By default, most system jobs are configured to send notifications on error, however, you must edit the job to specify a valid email address for the notifications (such as the email address of a system administrator). In the Notifications section for the job, edit the email notification settings as desired. The default setting of {CurrentUser.EmailAddress} cannot be used because the job is run by the system and therefore does not resolve to a user email address.

NOTE: It is recommended to leave the SMTPMessageDelivery job at the default notification behavior of None. If this job experiences an issue attempting to send email, it likely will be unable to send you an email notification about this error.

For more information on notification settings, see Job properties.

See also: