Job Resources are a means to make
- shared Environment Variables available to Shell Jobs and
- shared Arguments available to JVM Jobs.
In fact a job resource is a set of name/value pairs that can be assigned any job or workflow.
- This allows common sets of arguments and environment variables to be used for a number of workflows and jobs.
- When assigned to a workflow then arguments and environment variables from a job resource are available to any Shell Jobs and JVM Jobs in a workflow.
Defining Job Resources
Job Resources can be managed from the Configuration->Inventory view:
- A Job Resource includes any number of name/value pairs that are propagated as Arguments/Environment Variables to JVM Jobs and to Shell Jobs.
- A Job Resources offers two subtabs for Arguments and for Environment Variables.
- Arguments and Environment Variables can be assigned constant values and expressions, for details see
- The above example shows the Default Job Resource with Arguments for JVM Jobs that ships with JS7.
- Assigned values include built-in variables and functions, that are explained with the JS7 - Expressions for Variables article.
- Environment Variables for Job Resources can be assigned constant values, expressions and Arguments of the same Job Resource (see above).
- This allows to offer the same Arguments and Environment Variables to both JVM Jobs and Shell Jobs.
- If both Arguments and Environment Variables use calculated values as e.g. the number of milliseconds since January 1st 1970 until job start it is recommended to calculate the Argument only and to assign the Argument to the Environment Variable from the argument's name.
- The above example shows the Default Job Resource with Environment for Shell jobs that ships with JS7.
- Assigned values include Arguments as explained above.
Assignment to Workflows and Jobs
Assignment to Workflows
A workflow can be assigned any number of job resources. The right upper corner of the job properties panel offers the "Job Resources" button to display the following popup window that allows to select job resources:
- Environment variables from job resources are available to all Shell Jobs in a workflow.
- No mapping at job level is required, environment variables are directly available for job scripts.
- The sequence of assignment is relevant as environment variables with the same name are not overwritten in the order from the first to the last assignment.
Assignment to Jobs
The job properties panel offers a list-box to add any number of job resources.
Job Resources have to be deployed to the respective Controller for which the workflow referencing the job resource is operated.
- Job Resourced are digitally signed for deployment
- Job Resources are not maintained in versions. This translates to the fact that deployment of a modified Job Resource will make this resource immediately available for existing workflows.
- Job Resources cannot be removed as long as a reference is available from a deployed workflow.
Default Job Resource
A number of Arguments and Environment Variables can be provided from default Job Resources that are available for download and that can be assigned any workflows and jobs.
For download and explanations see JS7 - Job Environment Variables.