Page History
...
- The incoming file can hold pairs of names and values similar to the temporary file available from the
JS7_RETURN_VALUES
environment variable for return values of shell jobs:<name>=<value>
.- pairs of names/values are separated from each other by EOL which can be CR, CRLF or LF.
- The
<value>
can include any Unicode characters.
- For the handling of incoming files the following applies:
- If the incoming file holds pairs of names and values for variables then they are added to the order as return values from the JITL FileOrderVariablesJob template.
- If the incoming file is empty then no return values are created and no error occurs.
- If the incoming file includes content that does not match name/value pairs then an error is raised.
The JITL job does not use any arguments to specify its processing mode. Instead, users can add any arguments to this job that are expected to match the name of a name/value pair in the incoming file:
- Arguments Job arguments that are not assigned a value are considered optional for the incoming file. Respective return values are created only if the incoming file provides the variable. This includes that the incoming file specifies an empty value for the variable.
- Arguments Job arguments that are assigned a value are considered optional.
- If the incoming file does not provide the variable then a return value with the JITL Job's default value is created.
- If the incoming file provides a variable - optionally with an empty value - then a return value with the value from the incoming file is created.
- For pairs of names/values for which no arguments are specified the JITL Job will raise an error.
- Example of an incoming file:
var1=value1
var2=value2
var3=
- The variables
var1
andvar2
will be created with their respective values. Forvar3
an empty value will be returned from the JITL Job.
- The variables
Display feature availability | ||
---|---|---|
|
Usage
When defining the job either:
...
Name | Required | Default Value | Purpose | Example |
---|---|---|---|---|
js7_source_file | no | Specifies the path to the incoming file:
Desired state of the JS7 component:
| /tmp/file/some_file.csv | |
| yes | Specifies the identifier of a Standalone Controller or Controller Cluster controller_host argument is used anda variable that is expected from the incoming file:
Any number of variables can be specified like this if the JOC Cockpit is connected to more than one Controller. | var1 |
Further Resources
- JS7 - JITL Common ParametersVariables
Overview
Content Tools