Page History

...

• This article describes how the substitution of parameter values works in JobScheduler. It also describes how to use parameters in shell scriptscripts, API Jobs and pre- and postprocessing scripts.
• JobScheduler ships with a Monitor that performs substitution for Node Parameters:
  • The "classic" current implementation makes use of the following monitor configuration monitor:

    • <monitor name="configuration_monitor">
    <script java_class="com.sos.schedulerjitl.managedjobchainnodeparameter.configurationmonitor.ConfigurationOrderMonitorJobchainNodeSubstituteMonitor" language="java"/>
</monitor>

    • The implementation remains became available throughout with release 1.11 and will be discontinued with release 1.12.:

    • Jira
      server SOS JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 6dc67751-9d67-34cd-985b-194a8cdc9602 key JITL-

      411

      276

    • Display feature availability

      EndingWithRelease1.12

      StartingFromRelease 1.

      6

      11

  • The optimized "classic" implementation makes use of the following configuration monitor configuration:

    • <monitor name="configuration_monitor">
    <script java_class="com.sos.jitlscheduler.jobchainnodeparametermanaged.monitorconfiguration.JobchainNodeSubstituteMonitorConfigurationOrderMonitor" language="java"/>
</monitor>

    • The implementation becomes available remains available throughout release 1.11 and will be discontinued with release 1.12.11:

      • Jira
        server SOS JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 6dc67751-9d67-34cd-985b-194a8cdc9602 key JITL-

      276

      • 411

      • Display feature availability
        EndingWithRelease 1.12 StartingFromRelease 1.

      11

      • 6

Substitution of parameter values by the JobScheduler

...

• ${test} has been substituted to an empty value as this environment variable has not prevously previously been set.
• To access the value of the parameter in a shell script, the parameter name has to be prefixed. The default value of the prefix is:
  • SCHEDULER_PARAM_
  • This prefix can be set by the scheduler.variable_name_prefix parameter which is configured in the $scheduler_data/config/scheduler.xml file. JobScheduler has to be restarted after the value of the prefix has been changed.

...

An additional substitution mechanism for jobs running in a job chain is provided by the com.sos.schedulerjitl.managedjobchainnodeparameter.configurationmonitor.ConfigurationOrderMonitorJobchainNodeSubstituteMonitor preprocessing Java class that is added as a Monitor to jobs.

...

• Performance of parameter subsitution substitution is an issue:
  • 10 node parameter: 4s
  • 20 node parameter: 6s

...

The following patterns are recognized as parameters to be substituted:

• %param%
• \${param}

Where param can be

• a task parameter
• an order parameter
• a node parameter
• a JobScheduler parameter
• some special parameter (see below list)

Note: Substitution applies exclusively to the current job run. This means that the values of the parameters will be unchanged after the execution of the job. If you have an order parameter param_x whose value is value is \${param_y} and there are two steps in the job chain, the value of param_x after the execution of the first node will still be value is is \${param_y}

Handling of substitution up to release 1.10

...

Product Knowledge Base

• ConfigurationMonitor
• Substitution with Agents

Change Management References - Agent Usage

...