Skip to main content

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 Jobs from the main menu.
  2. Click a Folder.
  3. Click .
  4. Select Properties.
  5. Click Schedules.
  6. Expand Set this Job's status to.
  7. Click ADD.
  8. Select runaway.
  9. In the Name field, enter a name for the event.
  10. In the Runaway Elapsed field, enter the amount of time the Job can execute before it is considered a Runaway Job.
  11. 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.
  12. 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.
  13. In the Notify Event Class field, select which event flag is raised, so JAMS will send an email notification or run a notification Job.
  14. 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.
  15. Click Save. The Event is listed under the Set this Job's status to section on the Schedule tab.

Runaway Event Properties​

StatusDescription
EnabledSelect or clear the checkbox to enable or disable this event.
StalledDescription
Stalled TimeThe 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.
NotifyDescription
Notify Event ClassSelect the event class flag that this event will raise when it occurs.
LevelThis property can be used by event handlers to classify events.
MessageThis 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 Jobs from the main menu.
  2. Click a Folder.
  3. Click .
  4. Select Properties.
  5. Click Schedules.
  6. Expand Set this Job's status to.
  7. Click ADD.
  8. Select short.
  9. In the Short Elapsed field, enter the minimum elapsed time for successful completion of the Job.
  10. In the Short Elapsed Percent field, enter a percentage of elapsed time for successful completion of the Job.
  11. In the Short Severity field, select the Job completion severity to be set when the event is triggered.
  12. In the Notify Event Class field, select which event flag is raised, so JAMS will send an email notification or run a Notification Job.
  13. 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.
  14. Add an email or Notification Job Event for the Notify Event Class. See Events and Notifications for more information.
  15. Click Save.

Short Event Properties​

StatusDescription
EnabledSelect or clear the checkbox to enable or disable this event.
ShortDescription
Short ElapsedThis 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 PercentThis 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 SeverityThis property sets the completion severity if the Job meets Short Job criteria.
NotifyDescription
Notify Event ClassSelect the event class flag that this event will raise when it occurs.
LevelThis property can be used by event handlers to classify events.
MessageThis 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 Jobs from the main menu.
  2. Click a Folder.
  3. Click .
  4. Select Properties.
  5. Click Schedules.
  6. Expand Set this Job's status to.
  7. Click ADD.
  8. Select stalled.
  9. In the Stalled Time field, enter the amount of time the Job can wait before it is considered stalled.
  10. In the Notify Event Class field, select which event flag is raised, so JAMS will send an email notification or run a notification Job.
  11. 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.
  12. Add an email Notification for the Notify Event Class. See Events and Notifications for more information.
  13. Add an email or Notification Job Event for the Notify Event Class. See Events and Notifications for more information.
  14. Click Save.

Stalled Event Properties​

StatusDescription
EnabledSelect or clear the checkbox to enable or disable this event.
StalledDescription
Stalled TimeThe 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.
NotifyDescription
Notify Event ClassSelect the event class flag that this event will raise when it occurs.
LevelThis property can be used by event handlers to classify events.
MessageThis property specifies a message that will be passed to event handlers when this event is generated.