Product Knowledge Base

Space shortcuts

Page tree

Diagram

Elements

JobChain
References Notes

Specifies the job chains for which notifications are being sent to a system monitor.

The element can be repeatedly used to specifiy a number of job chains.

Default behaviour for repeatedly failed job chain steps: when an error reoccurrs in the same job node for which a notification has already been sent then this order state is considered being previously notified and no new notification will be sent.

See child element NotifyRepeatedError

Attributes:

  • name - accepts a regular expression to specify a number of job chains that match the given pattern, e.g. job chains that are located in the same root folder.
  • notifications - specifies the number of transfers the same notification to a System Monitor.
  • scheduler_id - restricts notifications to the JobScheduler instance with the given identification. By default notifications will be sent for all JobScheduler instances that log into the same database.
  • return_code_from - restricts notifications for jobs for a particular return code range.
  • return_code_to - restricts notifications for jobs for a particular return code range.
  • step_from - restricts notifications for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.
  • step_to - restricts notifications for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.
  • excluded_steps - specifies the steps which will be excluded from notifications. Multiple entries are separated by semicolon.

Child elements:

  • NotifyRepeatedError - send notifications for all errors that occur, do not suppress errors for repeatedly failed executions.
name
Job chain name including possible folder names. Java regular expression can be used.
notifications
Specifies the number of transfers the same notification to a System Monitor. By default one notification only will be sent.
scheduler_id
Notifications are restricted to the JobScheduler instance with the given identification. By default notifications will be sent for all JobScheduler instances that would log into the same database. Java regular expression can be used.
return_code_from
Restricts notifications for job chains for a particular return code range.
return_code_to
Restricts notifications for job chains for a particular return code range.
step_from
Restricts notifications for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.
step_to
Restricts notifications for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.
excluded_steps
Specifies the steps which will be excluded from the analyzing (separated by semicolon).
Element Type Required Description
Attribute: name string
Optional Job chain name including possible folder names. Java regular expression can be used.
Attribute: notifications positiveInteger
  • Fixed: 1
Optional Specifies the number of transfers the same notification to a System Monitor. By default one notification only will be sent.
Attribute: scheduler_id string
Optional Notifications are restricted to the JobScheduler instance with the given identification. By default notifications will be sent for all JobScheduler instances that would log into the same database. Java regular expression can be used.
Attribute: return_code_from integer
Optional Restricts notifications for job chains for a particular return code range.
Attribute: return_code_to integer
Optional Restricts notifications for job chains for a particular return code range.
Attribute: step_from string
Optional Restricts notifications for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.
Attribute: step_to string
Optional Restricts notifications for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.
Attribute: excluded_steps string
Optional Specifies the steps which will be excluded from the analyzing (separated by semicolon).
NotifyRepeatedError
  • Occurrence: 0..1
Optional
References Notes

Send notifications for all errors that occur, do not suppress errors for repeatedly failed executions.

NotifyByIntervention
  • Occurrence: 0..1
Optional
References Notes

Send notifications for errors that occur due to repeated failed executions if the restart was caused by manual intervention.
NotifyByPeriod
  • Occurrence: 0..1
Optional
References Notes

Send notifications for errors that occur due to repeatedly failed executions if a configurable period of time is exceeded.

Attributes:

  • period - the period between notifications is calculated from the time of the last failed execution for which a notification has been sent and the time of the current failed execution.
    Possible values:
    • <n> - duration in seconds, e.g.: 60
    • <n>m - duration in minutes, e.g.: 30m
    • <n>h - duration in hours, e.g.: 24h
    • <n>d - duration in days, e.g.: 30d
    • <n>w - duration in weeks, e.g.: 4w

    Combined values (with blank as separator):

    • e.g.: 2h 30m 30s
period

Possible values:

  • <n> - duration in seconds, e.g.: 60
  • <n>m - duration in minutes, e.g.: 30m
  • <n>h - duration in hours, e.g.: 24h
  • <n>d - duration in days, e.g.: 30d
  • <n>w - duration in weeks, e.g.: 4w

Combined values (with blank as separator):

  • e.g.: 2h 30m 30s