Job Status

JAMS can trigger an event based on the execution status of a Job. The following options are available:

  • Runaway: The Job ran longer than expected.
  • Short: The Job ran too quickly.
  • Stalled: The Job is waiting on a prerequisite, such as a Dependency or a Resource.

That event can then be used to send an email notification or execute another Job. See Events and Notifications for more information.

Adding a Runaway Event

The Runaway event tracks how long a Job has been running. If the Job exceeds the specified time, the Runaway event is triggered, raising the specified event class flag. In the Monitor view, the Tag column will display “Runaway” if the Job runs longer than expected.

  1. Click Definitions from the Shortcuts menu.
  2. Right-click a Job or Folder and select Properties.
  3. Click the Schedule tab.
  4. Click +.
  5. Select Set this Job's status to | runaway.
  6. In the Runaway Elapsed field, enter the amount of time the Job can execute before it is considered a Runaway Job.
  7. In the Runaway Elapsed Percent field, enter a percentage of elapsed time before the Job is considered a Runaway Job. This value is based on the previous run history for the Job in JAMS.
  8. In the Runaway Action field, select the action to occur when the Job becomes a Runaway Job. You can cancel the Job with a variety of statuses or select NoAction to keep the Job running.
  9. In the Notify Event Class field, select which event flag is raised, so JAMS will send an email notification or run a notification Job.
  10. In the Message field, enter any specific details for this event to be passed to the body of an email. Use this field if the information you enter differs from what is specified within the body on the Send an Email option applied to this event, or to fine-tune your notifications.
  11. Click Finish. The Event is listed under the Set this Job's status to section on the Schedule tab.
  12. Add an email or Notification Job Event for the Notify Event Class. See Events and Notifications for more information.
  13. Click Save and Close.

Runaway Event Properties

Status Description
Enabled Select or clear the checkbox to enable or disable this event.
Runaway Description
Force to Abort This property determines if the entry should be forced to abort with the severity specified in the Runaway Action field. When the checkbox is selected, the behavior is the same as when you cancel a Job from the Monitor view with the Force job to abort option. If you select No Action for the Runaway Action, this option has no effect.
Runaway Elapsed This property sets, in Delta Time, how long the Job can run before it is considered a runaway Job. This is the total amount of time the Job has been executing.
Runaway Elapsed Percent This property sets how long the Job can run before it is considered a runaway Job, set as a percentage of the Job's average elapsed time.
Runaway Action This property determines the action to be taken on the Job if it becomes a runaway Job.
Notify Description
Notify Event Class Select the event class flag that this event will raise when it occurs.
Level This property can be used by event handlers to classify events.
Message This property specifies a message that will be passed to event handlers when this event is generated.

Adding a Short Event

The Short event is used if the Job has completed too quickly within the specified time. This is useful to identify a Job that may not have properly run, even if it completed and reported Success to JAMS.

  1. Click Definitions from the Shortcuts menu.
  2. Right-click a Job or Folder and select Properties.
  3. Click the Schedule tab.
  4. Click +.
  5. Select Set this Job's status to | short.
  6. In the Short Elapsed field, enter the minimum elapsed time for successful completion of the Job.
  7. In the Short Elapsed Percent field, enter a percentage of elapsed time for successful completion of the Job.
  8. In the Short Severity field, enter the Job completion severity to be set when the event is triggered.
  9. In the Notify Event Class field, select which event flag is raised, so JAMS will send an email notification or run a notification Job.
  10. In the Message field, enter any specific details for this event to be passed to the body of an email. Use this field if the information you enter differs from what is specified within the body on the Send an Email option applied to this event, or to fine-tune your notifications.
  11. Click Finish. The Event is listed under the Set this Job's status to section on the Schedule tab.
  12. Add an email or Notification Job Event for the Notify Event Class. See Events and Notifications for more information.
  13. Click Save and Close.

Short Event Properties

Status Description
Enabled Select or clear the checkbox to enable or disable this event.
Short Description
Short Elapsed This property sets the minimum elapsed time for successful completion of the Job. If the Job completes successfully without exceeding the short time, configured notifications and completion severity changes will execute.
Short Elapsed Percent This property sets the minimum elapsed time for a successful completion of the Job, set as a percentage of the Job's average elapsed time. If the Job completes successfully without exceeding the short elapsed percent, configured notifications and completion severity changes will execute.
Short Severity This property sets the completion severity if the Job meets Short Job criteria.
Notify Description
Notify Event Class Select the event class flag that this event will raise when it occurs.
Level This property can be used by event handlers to classify events.
Message This property specifies a message that will be passed to event handlers when this event is generated.

Adding a Stalled Event

The Stalled event tracks the amount of time a Job has been waiting for a prerequisite like a Dependency or Resource. This enables alerts to be sent if the Job has been waiting for longer than the specified time.

  1. Click Definitions from the Shortcuts menu.
  2. Right-click a Job or Folder and select Properties.
  3. Click the Schedule tab.
  4. Click + .
  5. Select Set this Job's status to | stalled.
  6. In the Stalled Time field, enter the amount of time the Job can wait before it is considered stalled.
  7. In the Notify Event Class field, select which event flag is raised, so JAMS will send an email notification or run a notification Job.
  8. In the Message field, enter any specific details for this event to be passed to the body of an email. Use this field if the information you enter differs from what is specified within the body on the Send an Email option applied to this event, or to fine-tune your notifications.
  9. Click Finish. The Event is listed under the Set this Job's status to section on the Schedule tab.
  10. Add an email notification for the Notify Event Class. See Events and Notifications for more information.
  11. Click Save and Close.

Stalled Event Properties

Status Description
Enabled Select or clear the checkbox to enable or disable this event.
Stalled Description
Stalled Time The maximum elapsed time for a Job to be waiting on prerequisites before it is considered ‘Stalled’. An entry that exceeds the stalled time in a waiting for prerequisites state is considered stalled and will cause any configured notifications to be sent.
Notify Description
Notify Event Class Select the event class flag that this event will raise when it occurs.
Level This property can be used by event handlers to classify events.
Message This property specifies a message that will be passed to event handlers when this event is generated.