JobScheduler - Tutorial 4 - Running and Editing a JITL Job

Introduction

This tutorial will show how to take two of the JobScheduler's JITL (JobScheduler Template Library) Jobs and configure them for your environment.

The JITL Jobs are intended to be easy to configure and help users get started with the most common job scheduling tasks.

Using JITL jobs

The JITL jobs are installed in the live/sos folder. They are grouped together in a number of sub-folders and can be most easily seen in the JOC Jobs tab as shown in the screen-shot below:

Please note:

• The exact list of jobs that you will see will depend on the packages that you selected during installation of your JobScheduler:
  • dailyschedule - is always installed
  • events - only installed if the "Configure JobScheduler as event handler" option was selected during installation
  • housekeeping - only installed if the Housekeeping Jobs package was selected 
  • jitl - always installed
  • notification - always installed
  • update - installed by the Update Service package
• Some of the jobs come with orders as can be seen from the green-colored text in the above screen-shot:
  • Some of these orders are active - a Next Start time is listed
  • Other orders - such as CheckHistory - have the state pending - i.e they will only run when required.
• Comparing the list of jobs shown above with the full list of JITL jobs will quickly show that many jobs are missing from the above list.
  This is because the remaining JITL jobs are available by way of a wizard that is integrated in JOE and that will be described in a later tutorial.

About This Tutorial

Probably the most important two JITL jobs are:

• the scheduler_rotate_log job that rotates and compresses the JobScheuler's log files and
• the scheduler_cleanup_files job that removes temporary files e.g. for output to stdout or stderr.

Both these jobs are part of the JobScheduler's Housekeeping Package and their configuration and scheduling is the subject of this tutorial.
Note that we recommend that you configure these jobs to run on any computer which you may use to run JobScheduler regularly and to schedule them to run automatically to prevent an accumulation of temporary files or over-large log files from slowing down JobScheduler and possibly its host computer.

Configuring the scheduler_rotate_log Job in JOE

1. Follow the procedures described in these tutorials to start JOE and open the .\live\sos\housekeeping folder, which contains the scheduler_rotate_log job.
2. Open the Jobs element in the Scheduler Elements pane by clicking on the triangle to the left of the element and repeat the procedure to open the scheduler_rotate_log element.
3. Select the Parameter element, which will open the Parameter form at the Parameter tab as shown in the screen-shot below:
   
4. Click on the Wizard button at the right as shown in the screen-shot above.
   This will open the wizard mentioned in the introduction to this tutorial at Step 3, which provides a form listing all the parameters that can be set for this job.
   This form is shown in the next screen-shot.
   
5. The file_age parameter, which is highlighted in the above screen-shot, is the only one that it could make sense to modify from its default value - as long as the default paths have been used when installing your JobScheduler. If you have custom installation paths you may also need to modify the file_path_parameter.