search cancel

How to receive Email Notifications?

book

Article ID: 230149

calendar_today

Updated On:

Products

CA Automic Applications Manager (AM)

Issue/Introduction

Getting text as in the following how to set notification emails for recipients?

 

F FINISHED <Date> <Time>
-----------------------------------------
The job Job_Report with <run_id> 28314.00 finished on <Date>
-----------------------------------------
Email: [email protected]
Attachments: C:\APPWORX\out\o28314.00
=========================================

Environment

Release : 9.3

Component : APPLICATIONS MANAGER

Resolution

Defining Notifications

Use Notifications to create output files based on task statuses and send those output files to email addresses or any Output Device defined in Applications Manager. To use Notifications, you:
  1. Define a list of one or more Notification details.
  2. Assign the Notification to Applications, Program Types, Jobs, and Process Flow components.
Notification objects are defined and then assigned to Process Flow components, Jobs, Applications, and Program Types. A sample Notification definition is shown below. If a task has Notifications defined for it in multiple objects, all Notifications are performed.
 

Prerequisite: Specifying Email Settings

In order to send Notification emails, you must specify email settings for the Applications Manager Automation Engine/Local Agent.

Creating Notifications
To add Notifications using the Applications Manager client:

  1. From the Notifications Selector window, click New Applications Manager opens the Notifications window.
  2. Enter a name and description for the object.
  3. After creating the Notifications object, add Notification details.

Adding Notification Details
To add Notification details to a Notifications object:

  1. From the Notifications window, click the New button. Applications Manager opens the Notification Details window.
  2. Complete the fields in the Notification Details window using the information below.
  3. To save the settings and add the Notification detail, click OK Applications Manager adds the Notification detail to the Details table on the Notifications window. Notification details are evaluated in the order they are listed. If you wish to reorder them, use the arrow buttons to the right of the list.

Assigning Notifications
After you have defined a Notification object, you can assign it to Process Flow components, Jobs, Applications, and Program Types. If you assign the object to an Application, the Notification will apply to any Job assigned to that Application. The same holds true if you assign the object to a Program Type. Being able to assign Notification objects to Applications and Program Types makes it easy to set up Notifications for a whole class of Jobs.

Notification Field Description

  • Frequency
    Applications Managerevaluates Notifications for a task at least every 59 seconds. However, you select how often the action for each Notification detail should be taken:
    • First Time: Applications Manager only initiates the specified action the first time the Notification detail is true.
    • Every Time: Applications Manager initiates the specified action every time the Notification detail is true.
  • Status Trigger
    Specifies the status that will trigger the Notification:
    • Finished: The task goes to a FINISHED status.
    • Deleted: The task is deleted from the Backlog.
    • Aborted: Any failure status, such as ABORTED or TIMED OUT.
    • Failed to Start: Any status that prohibited the task from running, such as LAUNCH_ERROR, DIED, or DB_ERROR.
    • Hold: The task is put into a HOLD status.
    • Running: The task goes into a RUNNING status.
    • Completed: The task completes without regard to status.
    • Queued: The task goes to QUEUED status.
    • Requested: The task is requested or run with awrun
    • Restart Finished: A task was restarted and has finished with a decimal value run ID rather than an integer.
    • Condition: Indicates that this Notification is one that is meant to be used in a SEND NOTIFICATION condition action.
  • Message Text
    Specifies the message sent to the email recipients and Applications Manager Output Devises you select. The message text is also written to an output file named notif_<run_id>_<series> that you can view on the Output Files tab of the Task Details window from the Backlog and History.
    • Template: Uses a Message Template object to specify the text.
    • Custom Text: Text to be used for this Notification only.
      Either method allows the use of Substitution Variables and Replacement Values for variable text.
  • Subject
    Text was written as the subject when sent as an email. Allows the use of Substitution Variables and Replacement Values. The default subject, {status} {run_id} use Replacement Values to alert the recipient(s) of the status and run the ID of the task.
  • Email Recipients
    List of one or more email addresses to receive email Notification. Separate multiple email addresses with a space or semicolon. To select from emails assigned to Users, click the Select button. Applications Manager opens a window where you can select the email addresses.
    In order to send Notification emails, you must specify email settings for the Applications Manager Automation Engine/Local Agent.
  • Email Attachments (radio buttons)
    Specifies the output files to attach to the emails specified above and the Output Device specified below (if allowed in its definition):
    • System Output:: Attaches only the system output file.
    • Other Output: Attaches all registered output files, except the system output file.
    • All Output: Attaches all registered output files including the system output file.
    • Pattern: Attaches files of a particular name. For wildcard pattern matching, use the %character or .*.
      For example, enter  report% to specify all output file names beginning with report. To attach two files, create two Notification details.
  •  Normal
    When selected, file contents are attached to the email.
  • In Body
    When selected, file contents are included in the email body rather than as attachments.
  • Zip
    When selected, files are attached in a zip file.
  • pdf
    When selected, files are converted to a PDF file and attached.
  • System Output As
    Renames the attached system output file to whatever name you select. To use the file name for the system file, use the{file_name} Replacement Value. For example, {file_name}.txt.
  • Other Output As
    Renames the attached output file(s) to whatever name you select. To number multiple other output files, use the special Subvar {#} For example, assume you want to rename output for a program to finance{run_id}, and the task creates two or more output files. You might enter finance{run_id}{#} in this field.
    To use the file name for the other file(s), use the {file_name} Replacement Value. For example, {file_name}.txt
  • Output Device (On Output Device tab)
    Specifies the Output Device or set of devices where the output will be sent (for example: EMAIL, ACCOUNTING LASER, ATLANTA LASER). Printing to Output Devices for Notifications will be done on the Automation Engine machine rather than on Remote Agents.
  • Output Option (On Output Device tab)
    Used for specifying dynamic output options for the selected Output Device. This field will be active if this value or list of values is defined by the Output Interface assigned to the Output Device.