![[8.5.5.6 or later]](../images/ng_v8556.gif)
Job XML substitution in the JSL editor
You can use job XML substitution in the Job Specification Language (JSL) editor to specify an expression for almost any attribute in your Java™ batch job. At run time, the expression resolves to a particular value.
Your Java batch job is defined in an XML file. You can display this file and work with it in the JSL editor. You can add various elements to your job, including step, decision, flow, listener, property, and split elements. To these elements you can add various attributes. The attributes that you can add vary from element to element. For various attributes, you can use job XML substitution.
Elements for job XML substitution
- Job operator
- Specifies where the value for the expression of an attribute comes from at run time. The valid values are Job Parameters, System Properties, Job Properties, or Partition Plan.
- Target
- Specifies the name of the property that is used to resolve the expression.
- Default value
- Specifies a default value to use if at run time the expression is not resolved, for instance, if the property is not found.
Attributes that have job XML substitution for specific elements
Elements | Attributes |
---|---|
Property |
|
Flow |
|
Next |
|
End |
|
Fail |
|
Stop |
|
Step |
|
Chunk |
|
The Job XML Substitution dialog
- Operator
- Target
- Default
- Value
- The values for the Job Parameters job operator are obtained from existing
runtime configurations. Important: To provide a list of valid values for the Job Parameters value, you must have a launch configuration for the associated job.
- The values for the System Properties job operator are obtained from existing
runtime configurations. Important: To provide a list of valid values for the System Properties job operator, you must have the following setup:
- You must have a launch configuration for the associated job.
- You must have a target Liberty server that is started.
- If the target Liberty server is a local server, the target Liberty server must have a local connector.
- The Partition Plan job operator has no values.
The Value field is pre-populated with the current value of a particular attribute. You can edit the value or you can insert a substitution expression by clicking Insert into value.