Runaway, Short, and Stalled Event Triggers

Follow

 

JAMS can trigger an event based on the execution status of a Job. After you create the event based on the status, you can set JAMS to send an email notification if the Job status changes to one of the following:

  • 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 resource.

Adding a Runaway Event

The Runaway event trigger tracks how long a Job has been running. If the Job exceeds the specified time, the Runaway event is triggered.

  1. Open the Job and click the Schedule tab.
  2. Click the + button.
  3. Select Set this Job's status to.
  4. Select runaway

    Add.jpg

  5. Review and set the following options as needed:
    • Runaway Elapsed: Enter the amount of time the Job can execute before it is considered a Runaway Job.
    • Runaway Elapsed Percent: 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.
    • Runaway Action: 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.
    • Notify Event Class: Select which event is triggered, so JAMS will send an email notification or run a notification/recovery Job.
    • Message: Enter any specific details for this event into the body of the 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. (See the Creating an Email Notification section.)

    In the example shown below, the “Low” event is triggered after the Job runs for 2 hours. The Job continues processing.

    Runaway.jpg

  6. Click Finish.
  7. Add an email notification for the Notify Event Class. See the Creating an Email Notification section.

Adding a Short Event

The Short event trigger is the opposite of the Runaway event trigger because it triggers the event if the Job has completed too quickly within the specified time.

  1. Open the Job and click the Schedule tab.
  2. Click the + button.
  3. Select Set this Job's status to.
  4. Select short
  5. Review and set the following options as needed:
    • Short Elapsed: Enter the minimum elapsed time for successful completion of the Job.
    • Short Elapsed Percent: Enter a percentage of elapsed time for successful completion of the Job.
    • Short Severity: Enter the Job completion severity when the event is triggered.

    In the example shown below, the “Low” event is triggered if the Job completes within 10 minutes.

    short.jpg

  6. Click Finish.
  7. Add an email notification for the Notify Event Class. See the Creating an Email Notification section.

Adding a Stalled Event

The Stalled event trigger 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. Open the Job and click the Schedule tab.
  2. Click the + button.
  3. Select Set this Job's status to.
  4. Select stalled
  5. In the Stalled Time field, enter the amount of time the Job can wait before it is considered stalled.

    In the example shown below, the “Low” event is triggered if the Job has been waiting for more than 1 hour.

    Stalled.jpg

  6. Click Finish.
  7. Add an email notification for the Notify Event Class. See the Creating an Email Notification section.

 

Creating an Email Notification

You can set up an email notification that is linked to the “Low” event that was created in the previous sections. 

  1. Click the Schedule tab for the Job.
  2. Click the + button.
  3. Select When an event occurs.
  4. Select send an e-mail.
    Email_notification.png
  5. Review and set the following options as needed:
    • To address: Enter the email address of the person who will receive the notification.
    • Subject: Enter a subject for the email.
    • Message Body: Enter the body for the email message.

    The example below shows how the event is mapped to the event triggered by the Runaway event trigger.

    Email.jpg

  6. Click Finish.
  7. Click Save and Close.
Have more questions? Submit a request

Comments