Skip to end of metadata
Go to start of metadata

Introduction

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 that workflow.

Defining Job Resources

Job Resources can be managed from the Configuration->Inventory view:



Explanation:

  • 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 example above shows the Default Job Resource with Arguments for JVM Jobs that ships with JS7. 



Explanation:

  • 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 the job starts, it is recommended that only the Argument is calculated and that the Argument is then assigned to the Environment Variable using the argument's name.
  • The example above shows the Default Job Resource with Environment Variables for Shell jobs that ships with JS7. 
    • Assigned values include Arguments as described 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 provides a "Job Resources" button, which opens a popup window. This window allows job resources to be selected as shown in the screenshot below:

Explanation:

  • 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 provides a list-box for adding any number of job resources.


Deployment

Job Resources have to be deployed to the Controller operating the workflow, which is referenced by the job resource.

  • 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. These are available for download and can be assigned any workflows and jobs.

For download and explanations see JS7 - Job Environment Variables.




  • No labels