| Table of Contents |
|---|
Introduction
Introduction
The SOS web site offers On using the Try Out option form , sos-berlin.com user gets an invitation link on their registered email id for using to request an immediate product demo. When requesting the demo you will receive a welcome e-mail that includes an invitation link and access data for the JobScheduler demo.
After clicking on the Try-Out: Login JOC Cockpit link in the welcome e-mail, you will be presented with the JobScheduler Operations Center ( JOC) Login. Use the Account account and Password password that you have received with the Welcome Email to login into the JobScheduler demo environmentwelcome e-mail.
After Login login you will be presented the first initial view, which is referred to as the "the DASHBOARD, for explanations see Dashboard View". The Dashboard gives a bird's eye view of the JobScheduler's operational status.
To Run the Job Chain from the JOC-run job chains from JOC Cockpit, you need to switch the tab to Job Chains view.Click on JOB CHAINS tab, JOC will switch the view to display the Job chains. To to the JOB CHAINS view. To expand the list of folders and to see the available job chains, in the left tree navigation, Click panel navigate the tree and click on the arrow, refer KB article to know more about JOC Cockpit - arrows and folders, for detailed explanations refer to Navigation and Usability.
After expanding, the top folder will show the subfolderssub-folders, each contains including one or more Job job chains.
All the examples in the demo environment follow the same pattern. Each job chain demonstrates an important JobScheduler feature, and most of the job chain has chains use a minimum of two Orders to simulate successful and failed processing.
Shell Script Job
The example 01_JobChainShellJob demonstrate the JobScheduler's capability to execute shell jobs.
- To start the example, first we need you should to list all the job chains in the folder. To list, the job chains under the subfolder, Therefore click on the sub-folder, e.g., 01_JobChainShellJob. The list of Job chain job chains will appear at in the right -side panel.
- 01_JobChainShellJob: the job chain contains includes some simple order jobs with a shell script as executable. The Job chain contains job chain can be started by two permanent order orders to run start the job chain with “success” and “error” processing statusexecution results. [SCREEN SHOTS]
- Click on down arrow to expand the detail of Job Chain.
The job chain 01_JobChainShellJobs includes 5 job nodes with 2 orders to demonstrate successful and failed executionThe JobChain“01_JobChainShellJobs” has 5 Jobs with 2 orders (order_for_success, order_for_error).
The order “startstart_order_success” will success will simulate a successful processing and execution, the order “startstart_order_error" with trigger processing with will raise an error during execution.
To run any of the any orderorders
- Click click on the action menu of the order. A , a drop-down menu will appear .like this:
- click on the Click on Start Order now option to run the order immediately. The order will start, you can see the order passing from one job node to then next.
- Click click on the action menu of the order. A , a drop-down menu will appear .like this:
To check the status of the order
- Click click on Job the job chain name "01_JobChainShellJobs.", the Order History panel will open at the bottom section of the page.
- the New Order History panel will open to show the order history.shows the execution history of past and current job chain runs..
- The Order History panel shows the last few executions of a job chain, you can use the HISTORY view for a full report. The Order History offers to To see the Order Log file or you can also view the log of the running order.past and running orders:
- Click on “startthe most recent entry of the start_order_success” success order to open logs from order history tab.access the log of the order's last run.
- A The log window will open , and the complete Order order log will be shown.displayed. The order log contains log output from all jobs executed by the order.
- You can download the User can also download log file by click clicking the Download button from the upper right corner of the log window.
- Click on “startthe most recent entry of the start_order_success” success order to open logs from order history tab.access the log of the order's last run.
Execute Database Statements
The JobschedulerManagedDatabase is a JITL job, it can be used to execute an SQL statement statements or SQL scripts on varied RDBMS database systemsa number of database products. The JobSchedulerManagedDatabase job abstract abstracts the complexity of executing SQL statements/scripts on any RDMBS systemdatabase systems. The JITL job uses the Java hibernate interface to connect to the database and to execute the SQL statements.
In this example, we you are executing a simple SQL statement on the JobScheduler Database to get the JobScheduler Host and URL. The JobSchedulerManagedDatabase job has the capability to convert results of SQL statement into statements to order parameters which can be read by successive jobs in the job chain. This example demonstrates the feature where results from an SQL statement will be become available to the next job step steps as order parameters, e.g. JobScheduler Host and URL values
To run order manually.the job chain
- click on the job chain name 02_DatabaseStatement to Click on Job chain “01_DatabaseStatement” and expand the job chain details, a single order 02_execute_database_statement should be displayed:
- click on the job chain name 02_DatabaseStatement to Click on Job chain “01_DatabaseStatement” and expand the job chain details, a single order 02_execute_database_statement should be displayed:
To run order manually.the order.
- click on the action menu of the order. A drop-down menu will appear.
- click on Start Order now option to run the order immediately.
Click on Job chain “01_DatabaseStatement” and expand the job chain details - To check the status of the order
- Click on Job the job chain name "02_DatabaseStatements ",
- New the Order History panel will open to show the order history.You can the past and current executions of the job chain.
- From the log output, you will see that the database SQL statement was executed on for the database and the results are were transferred to the next job as order parameters.
File Watching
Split & Sync Using Job Stream
The JobScheduler feature Job Streams is used to implement dependencies with jobs. It provides backward dependencies using conditions. The jobs support In Conditions and Out Conditions. The In Conditions are evaluated before the job execution, whereas the Out Conditions are evaluated after the job execution.
In this example, you are executing a nested split and join processing use case using Job Streams. The jobs have dependencies implemented by the In Conditions and Out Conditions. A job will starts only if it's In Conditions expression evaluates to true. The job's Out Condition creates the events for the job in the system which is used as In Conditions for other jobs to continue the job execution.
- To run the Job Streams
- Switch to the Job Streams tab.
- Select the folder 03_JobStreams from the left tree structure. The collapsed view of the Job Stream will be displayed.
The following expressions are used as In Conditions and Out Conditions for the jobs.
S.No. Job Name Condition Expression Command / Event List 1.
job1
In Condition
-
-
Out Condition
rc:0
username_job1
2.
job2
In Condition
username_job1
startjob: now
Out Condition
rc:0
username_job2
3.
job3
In Condition
username_job1
startjob: now
Out Condition
rc:0
username_job3
4.
job4
In Condition
username_job3
startjob: now
Out Condition
rc:0
username_job4
5.
job5
In Condition
username_job3
startjob: now
Out Condition
rc:0
username_job5
6.
job6
In Condition
username_job4 and username_job5
startjob: now
Out Condition
rc:0
username_job6
7.
job7
In Condition
username_job2
startjob: now
Out Condition
rc:0
username_job7
8.
job8
In Condition
username_job6 and username_job7
startjob: now
Out Condition
-
-
Click on Expand details to display the Job Stream with it's In Condition and Out Conditions.
- Select the Start Task Now from the action menu of job1.
- The Job Streams starts its execution and the further jobs will be executed depending on the result of their In Conditions.
- Switch to the Job Streams tab.
File Watching
JobScheduler comes with the built-in File Watching feature that allows automating business processes based on the arrival JobScheduler has inbuilt File Watching feature which enables automating business process based in arrive of files. The file watching job chain starts automatically as soon as a a file matching with regular expression arrives in a specific folder. Once the job chain is triggered by the file, the complete file path will be available on to the job as an environment variable which can be passed to the application executed by subsequent for referenceor script called by the job.
- To see the working make the 04_filewacher FileWatcher job chain we start you need to create some files which will trigger the job chain. To this purpose, first, expand the folder and list all the job chains.
- Stat Start the order "start" manually in the job chain 04_FileWatcher/04_generate_files start in the job chain 04_GenerateTestFiles
- This will generate five files in the incoming folder that will trigger the job chain 04_FileWatcher
- To check the status of the file watcher order
- click on the job chain name 04_LoadDWH,
- the Order History panel will open to show past and running executions of the job chain..
Agentless Scheduling
JobScheduler has feature-rich Agent Scheduling capability using capabilities using the JobScheduler Universal Agent. Along with JobScheduler universal agentthe Agent, JobScheduler also supports the agentless scheduling over SSH.This example demonstrates the simple example the agentless scheduling over SSH.
This example demonstrates the simple example of executing a shell command on a remote server over SSH. The JITL job JobSchedulerSSHJob uses a built-in interface to execute tasks over SSH. Read more about job parameterization from the before-mentioned link. Find the following example for the JobScheduler SSH Job:
Run the Job
- Start the order start_order which will start the 05_execute_remote_command job.
- The job 05_execute_remote_command will connect with the remote host and will execute a simple shell command “env | sort”, the results of the command will be stored with the log file.
- To open the log file.
- click on the job chain name 05_SSHRemoteExecution, the Order History panel will open like this:
- click on the order start_order to open the log window.
- click on the job chain name 05_SSHRemoteExecution, the Order History panel will open like this:
Multiple Orders and Order Parameters
This example demonstrates the JobScheduler feature of multiple orders assigned to a single job chain and order parameters. JobScheduler job chains can be reused by assigning multiple orders using different parameter sets. This will reduce the number of identical job configurations that you run for similar tasks. The job chain 06_CRM_ERP_Backup_Process includes a single job that accepts parameters. A number of orders are configured to run the job chain.
The JobScheduler feature can be used in a classic database backup process, a common use case for example to backup two databases, e.g. ERP and CRM databases, with a frequency of daily, weekly and monthly backups. A job chain can be configured to reuse the database backup job by applying parameters from individual orders. When the order will start then the parameters from order will be available to the job as environment variables.
In the job chain CRM_ERP_Backup_Process multiple orders are used with different parameter sets. The orders are intended for daily, weekly and monthly execution.
- DailyBackup orders: are running daily according to the order's run-time.
- WeeklyBackup orders: run weekly, e.g. outside of business hours on Saturday or Sunday, according to the order's run-time.
- MonthlyBackup orders: will execute on the last day of month.
To run the job chain.
- click on job chain 06_CRM_ERP_Backup_Process and expand the job chain details like this:
To run the job chain
- click on the action menu of any order, e.g. DailyBackupERP, a drop-down menu will open.
- click on Start Order now to start the order.
To check the status of the order
- click on job chain name CRM_ERP_Backup,
- the Order History panel will open to display the execution history for past and current job chain runs.
You can review the log of the running order like this:
- Click on the DailyBackupERP order to open the log from the Order History tab.
- The log window will open and the order log will be displayed.
Managing Calendars for Run-time
JobScheduler Calendars is the method to specify on what days order has to execute. Calendars can be of two types Working Day Calendar and Non-Working Day Calendar. A Working Day Calendar specifies business dates for which job execution is targeted, where Non-Working Days Calendar includes days for which job should not be executed. The handling of days in a Calendar is simplified using Frequencies. Frequencies can be of two types inclusive and exclusive. The inclusive includes the date on which the job is to be triggered and exclusive includes the dates on which job should not be triggered.
A working day calendar is created with the validity of 5 years. The frequencies assigned to the calendar are:
- Included Frequencies: The calendar includes frequency from Monday to Friday.
- Excluded Frequencies - The days which are excluded from the calendar are the national holiday of USA.
The job chain 07_CalendarManagement is a basic job chain with three jobs. It has an order 07_Calendar_Management_Order. To assign the calendar to the Order and to add the Restrictions on it follow the below steps.
- Switch to the Job Chains tab and select folder 07_Calendar_Management from the tree structure.
- From the action menu of the order 07_Calendar_Management select Set Run-time.
- A modal window for Set Run-time opens.
- Click on Assign Working Day Calendar.
- Select the calendar from the tree and click Apply.
- On Clicking apply the select calendar is applied to the order and is shown in the List of Frequencies / Calendars.
- To add the Run-time for the job add the period for the job.
- Select the Repeat Interval, Start Time. The default values for the Repeat Interval is Single Start which means that the job or order will be executed only once. The other options are:
- Repeat End-Start - Once a job or order is executed it will repeat itself with an interval of Repeat Time according to end time of previous execution of job or order.
- Absolute Repeat Start-Start - The job execution will repeat itself with an interval of Repeat Time with respect to the start time of the job or order.
For example we want add a period as Single Start and morning 08:00:00 am.
Click Save to add the Period.
- To add a frequency to this calendar use the Restrictions.
- A window open to Add Frequencies.
- The Add Frequencies provides an option of Frequency Types. This includes various options like Weekdays, Specific Weekdays, Specific Days, etc. For example, we want to add an frequency to run this order on third Friday of the Month, then we use Frequency Type as "Specific Weekdays" and Number of Day as "Third" and then we select Weekday as "Friday". The Valid From and Valid To if left empty then it takes the date up to which the calendar is valid.
- Then click Add Frequency, then close. After this click Submit. You can see the Next Start Time will be added to the order.
