JobScheduler - Tutorial 1 - Getting Started

Introduction

Getting started with the 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.

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 in the JobScheduler Tutorials Requirements article.

The order will be started and monitored using the JOC web browser interface, the JobScheduler's Operating Center. A good starting point for finding out more about JOC is our JOC - JobScheduler Operations Center article.

Run the "Hello World" Job using the JobScheduler Operations Center, JOC

1. Start JOC: To Be Completed
   
   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 as can be seen in the screenshot below.
   
   Clicking on tutorials-getting-started folder will show the hello_world_job and clicking on this job will open the Job and Task History panes as shown in the next screenshot:
   
4. The most useful tab for running the job is the Orders 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 as shown below:
      
   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. Click on the Order menu button to the right of the Job Chain pane 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 listing added in the Order History pane at the bottom right of JOC.
5. In the Order History pane shown in the screenshot above the order was run twice before the screenshot was made and therefore the order is listed twice.
   Now click on your hello_world_order listing in the Order History pane, which will open a new browser window containing the log information for the order you have run.
   As can be seen in the screenshot, "Hello World" was successfully entered into the order log and the order successfully ended (set_state success in the third last line).
   

Note that the JOC interface is extremely flexible which can have the disadvantage that new users sometimes lose track of how to obtain the information they require.
However reloading the page - for example, using F5 - reinitializes the interface to the state shown in the first screenshot.