Send alarm notifications through email or through SystemLink when an error occurs.

Introduced in PAtools Battery Software Suite 2025 Q4

PAtools only sends notifications for errors, not for warnings.

If multiple errors occur, only the error that occurred first triggers a notification. The notification includes error text from the first error only.

Before you begin, configure the required alarms for your test procedure. Refer to Configuring Alarms to Send to SystemLink for more information.
  1. Navigate to PAcfg » Application_Components » Module_Library » PAmodule » softwaremodules » Notification_(Sends_notifications).
  2. Open the notification configuration that is linked to your application.
  3. Open the Notification_General_Config initialization group.
  4. Configure the following initialization values.
    • Module log level
    • Days on which notifications can send
    • Whether a time window is implemented for notifications
    • The start of a time window during which notifications can send (24-hour format)
    • The end of a time window during which notifications can send (24-hour format)
  5. To configure email notifications, open the Notification_Email_Config initialization group and configure the following initialization values.
    • The address of the SMTP server. For encrypted connections, use the server name or IP address, a colon, then the port. For example, enter mymailserver.test.com:465.
    • The name of the user account required to authenticate the SMTP server.
    • The password associated with the user account for the SMTP server.
    • The email address for the notification sender.
    • The email addresses for the notification recipients. Separate recipients using a semicolon.
    • Whether email notifications are enabled or disabled.
    • Optional: Text for the SystemLink subject and message body. The system appends the text you enter during configuration to the content that the system generates.
  6. To configure SystemLink notifications, open the Notification_SystemLink_Config initialization group and configure the following initialization values.
    • The unique strategy ID configured in SystemLink. Use SystemLink Notification Service APIs to configure a notification strategy.
    • Whether SystemLink notifications are enabled or disabled.
    • Optional: Text for the SystemLink subject and message body. The system appends the text you enter during configuration to the content that the system generates.
  7. Optional: Open Notification_Mapping.IN.TAB and update mapping of the trigger parameters.
    Mapping is preconfigured. Only update mapping if required.
  8. Optional: Open Notification_Mapping.OUT.TAB and update mapping of the notification information to modules.
    You can map the following to modules:
    • Status of the initialization
    • Sending notifications
    • Error codes
If you configure SystemLink notifications, implement the configuration in SystemLink using Swagger API tools.

Configuring Notifications in PAcontroller

Configure notifications for a test in PAcontroller after the test is loaded or running.

  1. In PAcontroller, open your test.
  2. Click Open Settings.
  3. In the [Remote] Notification: Ready2send userbox, click the Configuration tab.
  4. For Notification Type, select Email and/or SystemLink.
  5. For Check period, select whether PAcontroller sends notifications during a defined period.
    OptionDescription
    No (always send) PAcontroller sends notifications any time the alarm occurs.
    Yes PAcontroller sends notifications during the configured time. If you select Yes, complete the following steps:
    1. Select the time that the system does not send notifications. Use a 24-hour clock to set the time.
    2. Select the days on which the system can send notifications.
  6. If you enabled email notifications, click the Email Notification tab and configure email notifications.
    1. Enter the Email server (smtp server).
    2. Optional: Enter the User name and Password for the SMTP server user.
    3. Enter the email address for the Sender of the email notification.
    4. Enter the email address for the Recipients of the email notification.
      Separate multiple email addresses using a semicolon (;).
    5. Enter the Subject for the email notification.
    6. Customize the Message in the body of the email notification.
  7. If you enabled SystemLink notifications, click the SystemLink Notification tab and configure SystemLink notifications.
    1. For Strategy Name, enter the ID of the notification strategy stored in SystemLink.

      Use SystemLink Notification Service APIs to configure a notification strategy.

    2. Enter the Subject for the SystemLink notification.
    3. Customize the Message in the body of the SystemLink notification.