AX2540

Managing Scheduler jobs and tasks

Using the Axiom Scheduler dialog, administrators can create and edit Scheduler jobs. To access this dialog:

  • On the Axiom tab, in the Administration group, click Manage > Scheduler.

    NOTE: In systems with installed products, this feature may be located on the Admin tab. In the System Management group, click Scheduler.

This section discusses how to create, edit, and delete jobs and tasks, not how to manage the Scheduler queue once jobs have been placed on the schedule. If you need to stop or reschedule a scheduled job, see Managing scheduled jobs.

Scheduler jobs are saved as XML files and are stored in the Axiom Decision Support file system at \Axiom\Scheduler Jobs Library.

Creating a Scheduler job

You can create a new Scheduler job to perform one or more tasks.

To create a new job:

  1. In the Scheduler dialog, on the Job tab, click New.

    A new tab appears in the navigation pane, labeled New Job. The left-hand side of the job lists sections for which you can define various job settings. When you click a section name, the settings for that section display in the right-hand side of the job.

  2. In the General section, define general job settings as desired.

    For detailed information on the available settings for a job, see Job properties.

  3. In the Scheduling Rules section, specify scheduling details for the job.

    You can schedule the job for future execution, for one time or on a recurring basis.

    NOTE: If you are always going to run the job manually, and do not need to schedule it for future execution, then you do not need to define scheduling rules.

    For more information, see Defining scheduling rules for a job.

  4. In the Notification section, specify email notification options for the job.

    You can send email notifications every time the job completes, or only when the job experiences errors. By default, the job is configured to notify on completion.

    For more information, see Setting up email notification for jobs.

  5. In the Tasks section, add one or more tasks to the job.

    1. On the Job tab of the ribbon, in the Tasks group, click Add. This brings up a list of available tasks. Select the task that you want to add.

      The task is added to the Tasks section, and the settings for the task display in the right-hand side of the job.

    2. Complete the settings for the task as desired.

      The Task Control section of the task contains standard task settings, and the Task Details section contains settings unique to the task type. For more information, see Task Control properties.

      If a required setting is not completed, the setting is highlighted in red and error text appears in the bottom of the dialog. Make sure to complete all required settings for the task before saving.

    Repeat this process until you have added all desired tasks to the job. Tasks are processed in the order listed. If you need to change task order, select a task and then click Move Up or Move Down.

  6. In the Job tab of the ribbon, click Save.

  7. At the bottom of the Save As dialog, in the File name box, type a name for the job, and then click OK.

    The job is saved as an XML file in the Scheduler Jobs Library.

If the job was saved with an active scheduling rule, Axiom Decision Support determines the next scheduled date of execution and schedules the job. You can view the job in the Scheduled Jobs list (on the Service tab of the ribbon, click Scheduled Jobs).

Advanced job settings

This procedure covers the basic steps of creating a job. Jobs also support the following advanced options:

  • Event handlers: You can create event handlers for the purposes of running the job using the RunEvent function. This allows users to trigger job execution from within an Axiom file.
  • Job variables: You can create job variables and then use those variables within certain job settings. You can then dynamically pass in values for those variables when using the RunEvent function to execute the job.

For more information, see Creating event handlers for a job, Using job variables, and Using RunEvent to execute a Scheduler job.

Editing a job

You can edit a job at any time to change job settings, add or remove tasks, change scheduling rules, or change notification options.

This section describes the general process of opening a job for editing. For more details on the impacts of editing scheduling rules, see Defining scheduling rules for a job.

To edit a job:

  1. In the Scheduler dialog, in the Job tab, click Open.

    The Axiom Explorer dialog opens, showing the Scheduler Jobs Library only.

  2. Select the job and then click Open.

    The job opens in the Scheduler dialog. Make sure the job is the active tab in the navigation pane (the most recently opened tab is the active tab by default).

  3. Edit the job and task properties as desired.

    For detailed information on the available settings for a job, see Job properties. For detailed information on task settings, see Task Control properties.

  4. In the Job tab of the ribbon, click Save.

Deleting a job

Deleting a job removes any scheduled executions of the job from the scheduled jobs list.

To delete a job:

  1. In the Scheduler dialog, in the Job tab, click Open.

    The Axiom Explorer dialog opens, showing the Scheduler Jobs Library only.

  2. Navigate to the job that you want to delete, then right-click the job and select Delete.

You can also delete Scheduler jobs from Axiom Explorer or the Explorer task pane.