Adding tasks to the Job Scheduler

To add a task to the Job Scheduler:

  1. Select Maintenance > System Administration > Job Scheduler.
  2. Click Add Schedule.
  3. Specify this information:
    Task Description
    Specify a brief description of the task. The description should be unique because you identify the task by this name. The description must not exceed 250 characters.
    Task Type
    Select one of these options:
    • Java Task: Select a specific task from the drop-down list.

      To run the task as a standalone process and not as a thread, select the Runs in a dedicated process check box.

      Note: This option should only be considered after reading the following paragraph and following the recommendations.

      This option allocates the required RAM for each spawned scheduler process that is specified in the SPAWNED_PROCESS_JVM_PARAMS registry parameter. In addition, all Aggregate Task children tasks are run as dedicated processes. If no value is specified in the registry parameter, the JVM defaults are used. Before spawning the JVM process, the WFM application does not check if there is available RAM.

      Note: It is the responsibility of your system administrator to allocate adequate RAM for your environment and the workloads you are running.

      To specify Java VM parameters for spawned scheduler processes, see "SPAWNED_PROCESS_JVM_PARAMS" in the Registry Parameter Reference Guide.

    • Shell script: Specify the customized task shell script, which contains the sequence of commands executed by the shell. A shell script typically ends in “.bat” or “.cmd” for Window platforms or “.sh” for other platforms.
    Task Affinity
    Select the name of the scheduler to which the task is assigned from the drop-down list.

    By assigning tasks to various schedulers, the system can distribute the running of tasks across different schedulers, which may be running on different machines. The scheduler runs tasks with a default Task Affinity. If you leave the Task Affinity as the default, your task runs on the default scheduler.

  4. In the Scheduled Time section, specify this information:
    Run at
    Specify the time of day the task will run.
    Timezone
    Select the time zone using the lookup, if required. The time zone defaults to the time zone where the application is running.
  5. In the Scheduling Time section, select one of these options:
    • Once: Specifies that the task runs only once. If you select this option, you must run the task manually after the initial running of the task.
    • Daily: Schedules the task to run automatically at intervals every day or every few days. Then select one of these options to specify the intervals when the task will run:
      • Specify the number of days between runs in the Every Days field.
      • Specify the number of seconds between runs in the Interval Seconds field. The application allows for a minimum of 5 seconds between runs (-1 indicates that the field is not used).
    • Weekly: Schedules the task to run automatically on the specified days of the week.
    • Monthly: Schedules the task to run automatically during the specified months. Select one of these options:
      • Day Of: Specify a day of the month to schedule the task to run only on the specified day. For example, if you specify 1, the task will run on the 1st day of each selected month.

        If this value is greater than the total number of days in a month, the task will run on the last day of the month. For example, if a task runs on the 30th of each month, the task will run on the 28th or 29th in February.

      • Of: Select the week of the month, such as Second, and the day of week, such as Thursday, when the task runs from the two drop-down lists.
  6. In the Scheduling Range section, specify this information:
    Start On
    Specify the initial start date of the task run. This field is required.
    End By
    Specify the last date the task is run. Leave the field blank to schedule the task to run indefinitely.
  7. Click Submit.
  8. Click OK.
  9. Click Parameters next to the task you added, and modify the parameter settings as required.
    The Parameters page displays the available parameters for the task type which varies from task to task. See Task types.
  10. Click Submit.
  11. Click OK.