The Notification properties allow users to kill a stalled, runaway, or short Job/Setup process using a Notification Job, or define which users (usernames) should be notified when any Job or Setup within the selected Folder requires notification.

Notification usernames, when inserted into individual Job and Setup definitions, can augment or replace the names specified in the Folder definition. To remove an individual name in the Folder definition use the minus sign "-" as a prefix. To remove all names defined in the Folder definition, enter -*.

 

 

A notification is triggered when a Job or Setup within the Folder. . .

• Completes with a severity level that is worse than its set notification severity.
• Runs too long or too quickly.
• Becomes stalled or . . .
• Misses its execution window.

Email Addresses

For this property enter a list of email addresses separated by commas. These individuals receive an email message indicating the reason for the notification. If it is available, JAMS includes the Job or Setup’s log file, and, if defined, the Recovery instructions as described in the Recovery section.

Notification email addresses defined at the Folder level can be removed on a per Job or Setup basis. Enter: -* to remove all Folder level email addresses, or [email protected] to delete a specific email address from the Folder definition. These formats can be combined with new notification email addresses, e.g., -*, [email protected].

Usernames

Use this property to enter a list of usernames separated by commas. If an enclosed Job or Setup meets the set criteria, a message is then broadcast to these users as long as they are logged in.

Other Names

This property is used to enter a list of operator classes separated by commas. If the enclosed Job or Setup meets the set criteria, a message is sent to these operator classes.

In addition, this property can also be used to enter the Monitor Name for Paladin. This allows for JAMS events to use Paladin’s advanced notification, response team, and escalation options. When a notification event occurs it is then sent to Paladin as defined in this property.

Short Severity

When an enclosed Job or Setup’s “Short” threshold is reached, the completion severity is modified to the severity level selected here. The dropdown choices include:

• No Change
• Success
• Informational
• Warning
• Error
• Fatal
• Not Specified

Stalled Time

For this property enter how much time (hh:mm:ss) can elapse after a Job or Setup’s scheduled time before it is considered “stalled”. Once the Job or Setup reaches its stalled threshold JAMS then performs a notification action.

Runaway Elapsed %

This property determines how long a Job or Setup can run before it is considered a “runaway”. The setting can be specified as a percentage of the Job or Setup’s average elapsed time. Once it reaches its defined runaway percentage threshold JAMS triggers a notification action.

Short Elapsed %

This property determines the minimum elapsed time for a Job or Setup to be considered a “Short”. It is specified as a percentage of the Job or Setup’s average elapsed time. If the minimum percentage threshold is reached, JAMS triggers a notification action.

Notify Job

This is the name of the JAMS Job that is submitted when notification is required.

If the notification Job is parsed then the following predefined parameters become available to the Job.

• JAMS_NOTIFY_JAMS_ENTRY: Enter the JAMS entry number of the Job triggering the notification.
• JAMS_NOTIFY_JOB_NAME: Enter the Job Name of the Job triggering the notification.
• JAMS_NOTIFY_JOB_STATUS: Enter the Status value of the Job triggering the notification.
• JAMS_NOTIFY_LOG_FILENAME: This parameter displays the specification for the Job triggering the notification.
• JAMS_NOTIFY_MAIL_ADR: Enter the list of names to be notified via email when a Job triggers a notification.
• JAMS_NOTIFY_OTHER: This parameter lists the names used by a plug-in within the notification module.
• JAMS_NOTIFY_PID: Name of the process ID of the Job triggering the notification.
• JAMS_NOTIFY_REASON: Enter the reason for the notifications. This parameter can be defined as: COMPLETED, FAILED, SHORT, RUNAWAY, STALLED or MISSED_WINDOW.
• JAMS_NOTIFY_USERS: Include the list of names to receive notification messages for the current Job.
• JAMS_NOTIFY_RON: Enter the JAMS run occurrence number for the job causing the notification.
• JAMS_NOTIFY_STATUS: This parameter includes final status of the Job causing the notification.
• JAMS_NOTIFY_SUBMITTED_BY: Enter the username submitting the job triggering the notification.
• JAMS_NOTIFY_FOLDER_NAME: Use the JAMS Folder Name for the Job triggering the notification.

Reference Relative?

A Relative reference changes the object assignment from the qualified path to its own folder or an assigned folder path. This can be useful when making changes to the definitions folder structure.

When this property is unchecked, use the associated file browser button to navigate to the object using a fully qualified path. If enabled, JAMS uses the current folder structure or an alternative search path if it is defined in the folder’s Search Path property (Properties tab>Source Options).

The Submit Options properties control how, when and where the a Job or Setup is run and how long it is retained by the JAMS system.

Batch Queue

Enter the name of the batch queue where the Job or Setup should be submitted. This entry is used only if the selected Execution Method for the Job or Setup utilizes batch queues.

Retain Options

This property establishes the retention policy for any Job and Setup contained within the Folder. The retention options include:

• Always: Jobs and Setups are always retained until deletion.
• Never: Jobs and Setups are never retained.
• Error: Jobs and Setups are retained only if they complete with a severity level of Warning, Error or Fatal.
• Timed: Jobs and Setups are retained for the specified time as set in the Retain for property, after completion.
• Not Specified: this option defaults to the Retain Options property inherited from the KeepCompleted configuration setting.

Retain for

If the Retain Option is set to Timed, the enclosed Job or Setup is retained for the specified time after completion, using the format: hh:mm. For example, a 2 hours and 30 minutes retention time would be entered as 02:30.

Default Username

Enter a valid username to submit a Job or Setup in the current Folder. This feature can be used to limit an individual’s access capabilities to only Jobs located within the current Folder. For example, you could grant a user the ability to submit Jobs in the payroll folder, but can use file protection to prevent them from accessing any of the payroll files. Subsequently, when the user submits a payroll Job, it executes under a different username than one that includes access to the payroll files.

Scheduling Priority Base

Enter a number to calculate the scheduling priority for Jobs and Setups within the current Folder. This number can range from -1000 to 1000, with the default being 0. When a Job or Setup is submitted by the JAMS Submit sub-system the scheduling priority is calculated by adding all these priority modifiers together.

Home Directory for Jobs

This property defines the device and directory where the Jobs in the current Folder should execute.

This section allows you to view, add or edit a list of resource requirements for Jobs or Setups contained within the Folder.

To add an existing Resource to a Job or Setup, follow the steps below:

1. Choose the Add button.
2. This action opens the Resource Search window. Double-click on an existing Resource from the list to associate it with a Job or Setup contained within the current Folder.

The properties in this section are used to control how the .LOG files are handled.

Keep .LOG Files

When this property is activated, the batch log files are not deleted after the current Job or Setup completes. The checkbox property contains three settings: on, off, and no setting.

Timestamp .LOG files

When activated, the batch log files are time stamped using the extension: .LOG_yyymmdd_hhmmsscc (cc=hundredths of a second). The checkbox property contains three settings: on, off, and no setting.

Directory for .LOG files

This property defines the device and directory where batch log files are placed.

This section defines the Folder's recovery actions when a Job or Setup does not execute successfully.

Recovery Instructions

This property contains the instructions included in the email notification if the Job or Setup triggers a recovery email. In addition, you can create recovery instructions at the Job or Setup level to override the Folder setting.

The Source Options section is used to set values governing where Job source files are located and accessed.

Template Library

The Template Library defines the full filename of the text library containing the JAMS templates used when parsing a Job.

Search Path

The Search Path property provides an alternative method to resolve relative references for the Job source files.

 

This final section allows you to enable or disable any built-in or available custom alerts for Jobs or Setups contained within the Folder.