...
Unpack the configuration in the JobScheduler's live
folder. See our series of Tutorials for JobScheduler for information getting JobScheduler installed and running.
...
- inspected - and edited if required - using in the JOE - JobScheduler Object Editor (JOE)
- run using the JOC - JobScheduler Operating Operations Center (JOC).
Example
Use
...
Case
Consider two job chains where the return code for a job in one of the chains is used to control further workflow as follows:
...
- The orderParameter value of 0 is shown in Line 56 of the listing.
- Line 66 shows that Job3 is exiting with return code 0.
- The end of processing of the node for Job3 is noted in line 70.
- Line 71 shows that the state is set for starting Job 4 Job4 - there is no mention of the generation of the order that will start JobChainB.
...
The next code block shows part of the log file for Order 1 Order1. This shows the log information for Job3 and the start of Job6. The following points are relevant:
...
- 1) Give the return code, e.g
. return_code = 0
signals success, in the ReturnCodes field- Syntax:
- Individual return codes are separated by spaces (e.g. 1 2).
- Return code ranges are inclusive and written 1..5 6..9
- Return codes can only be specified once
- Behavior:
- Note that non-zero return codes can be used but will be seen as an errors in the originating job chain.
- Should no
<on_return_code>
element match the current return code then JobScheduler will apply thejob_chain_node@next_state
(return code 0) orjob_chain_node@error_state
(other return codes) attribute.
- Syntax:
- 2), 3) Select the target job chain e.g. JobChain1 from the drop down list
- only job chains present in the same folder will be available in the Job Chain dropdown list
- Other job chains can be:
- navigated to using the Browse button.
- specified specified using the syntax:
/myFolder/myJobChain.
- 4) Click on Add Order button to assign the Order to the
JobChain1
- 5) Click on Apply (at the foot of the form)to make the changes in the job chain configuration
- Save the job chain configuration.
...
- The Knowledge Base Articles on return / exit code handling:
- JobScheduler Reference Documentation:
<job_chain_node> XML Element
<add_order> (Node Order plugin) XML Element
- <params> (Node Order plugin) XML Element
- <param> (Node Order plugin) XML Element
...