A job property file contains arguments that control the execution of jobs when you use the job executor or the Administration Utility to run a job. Use a job property file if you want to reuse arguments by specifying a single argument at the command line (-f) rather than specifying each argument individually at the command line.
To create a property file, create a text file with one argument on each line.
d %
h spectrum.mydomain.com
i 30
j validateAddressJob1
u user
p password
s 8888
t 9999
w true
The job property file can contain these arguments:
Required | Argument | Description |
---|---|---|
No | ? | Prints usage information. |
No | d delimiter | Sets instance/status delimiter. This appears in synchronous output only. |
No | e | Use a secure HTTPS connection for communication with the Spectrum Technology Platform server. |
No | h hostname | Specifies the name or IP address of the Spectrum Technology Platform server. |
No | i pollinterval | Specifies how often to check for completed jobs, in seconds. This applies only in synchronous mode. |
Yes | j jobname | A comma-separated list of jobs to run. Job names are case-sensitive. Jobs are started in the order listed. |
No | n emaillist | Specifies a comma-separated list of additional email addresses for configured job notifications. |
Yes | p password | The password of the user. |
No | r |
Returns a delimited list with this information about the job written to standard output:
The information is delimited using the delimiter specified in the -d argument. For example:
|
No | s port | The socket (port) on which the Spectrum Technology Platform server is running. The default is 8080. |
No | t timeout | Sets the timeout (in seconds) for synchronous mode. The default is 3600. The maximum is 2147483. This is a global, aggregate timeout and represents the maximum time to wait for all spawned jobs to complete. |
Yes | u username | The login name of the user. |
No | v | Return verbose output. |
No | w | Specifies to wait for jobs to complete in a synchronous mode. |
Using Both Command Line Arguments and a Property File
A combination of both command-line entry and property file entry is also valid. For example:
java -jar jobexecutor.jar -f /dcg/job.properties -j job1
In this case command line arguments take precedence over arguments specified in the properties file. In the above example, the job job1 would take precedence over a job specified in the properties file.