JobScheduler Tutorials

Introduction

Getting started with JobScheduler:

This first tutorial shows how to run a simple JobScheduler Order Job that executes a shell script which writes "Hello World" in its log file.

JobScheduler Order Jobs can only be run in Job Chains and require an Order (a type of instruction or token) before they can run.

Whilst this approach may at first appear involved it brings a number of advantages over our legacy "Stand-Alone Jobs". The concept behind Order Jobs is explained in more detail in our Concepts for jobs, job chains and orders article.

Requirements

Before starting the tutorials it is assumed that:

• You have a JobScheduler installed ... version?
• You have started the JobScheduler with the script ... or as a service ...
• You have downloaded and unpacked the tutorial files and copied them to your live folder:
  • %SCHEDULER_HOME%\config\live
  • If JobScheduler was installed using the default paths %SCHEDULER_HOME% on a Windows system would be:
    • C:\ProgramData\sos-berlin.com\jobscheduler\myJobSchedulerID\config\live

Objective

This example shows the steps required to run the "Hello World" Order Job and verify that it has run correctly. The job itself and its job chain and order are available to the JobScheduler once you have copied the respective objects to the JobScheduler's live folder as described above.

1 - Examine the JobScheduler Objects in the JobScheduler Object Editor, JOE

1. Start JOE:
   
   1. Windows Start Menu
   2. Command line script
      
2. Open the Tutorial live folder in JOE:
   1. Use the File > Open Live Folder menu (or Ctrl + D), navigate to the live\tutorials-getting-started folder and click OK
      

In the left-hand Scheduler Elements pane:

1. Open the relevant objects by clicking on the triangles to the left of the object names.
   The most important configuration information for each object (at least for this example) is shown in the following screen shots:
   1. Job
      
   2. Job Chain
      
   3. Order
      

2 - Run the Job using the JobScheduler Operations Center, JOC

1. Start JOC:
   1. Browser Window
   2. Windows Start Menu
   3. Script
2. Click the Update (every 5s) checkbox at the top center of JOE
   This will .....
3. Per default the Jobs tab should be open and show the tutorials-getting-started folder.
   Clicking on this folder will show the hello_world_job and clicking on this job will open the Job and Task History panes as shown in the screenshot below:
4. The most tab to run the job is the Order Tab.
   1. Select this tab and open tutorials-getting-started folder and hello_world_job_chain,hello_world_order in a similar way as described for the job tab above.
      This will open the Job Chain pane in the right hand half of JOC 
   2. Now select the Show order history checkbox in the right hand Job Chain pane, which will open a second, right hand Order History pane
   3. Now right-click on the hello_world_job_chain,hello_world_order - next start never link opened in a) above to open the Order context menu as shown in the following screenshot and select the Start order now option.
      The order (and therefore the job) will be processed almost immediately and a hello_world_order added in the Order History pane at the bottom right of JOC as shown in the screenshot.