Skip to content

SAP Notifications


Here, you find possible solutions to the problems that can occur with SAP Notifications/BC-XOM when installing or running PLOSSYS Output Engine.


No SAP Notifications

As of PLOSSYS Output Engine 7.0.0, seal-co-notifier services requires the parameters "&El" and "&Er" transmitted for SAP Spool on Windows or Linux. If the OMS command for Submit has not been appended by these parameters or the SAP configuration and oms_submit.cfg are different in that regard, no SAP notifications can be sent. The ROMS entry in the NATS key-value store for the SAP notifications is wrong in these cases. This can prevent notifications being sent even after the configuration has been fixed.

Hint - fixed versions

As of seal-co-notifier 5.1.2 and PLOSSYS Output Engine 7.4.0, the NATS key-value store handles this misconfiguration correctly and no longer needs the following steps. Apply the following steps only for earlier versions, or if oms_submit.cfg has not been adapted yet.

To fix the problem, follow these steps:

  1. Correct the OMS command in the SAP configuration and oms_submit.cfg. Make sure both entries contain the parameters "&El" and "&Er" and are identical.

  2. Stop all instances of seal-co-notifier service.

  3. Open a PowerShell on Windows or a Terminal on Linux.

  4. Switch to the NATS directory.

    • Windows: cd "C:\Program Files\SEAL Systems\seal-nats"
    • Linux: cd /opt/seal/seal-nats
  5. Clear the buckets in the NATS key-value store used by seal-co-notifier service.

    • Windows:

      ./nats.exe kv del co-notifier-job-counters
      ./nats.exe kv del co-notifier-job-data
      ./nats.exe kv del co-notifier-device-counters
      ./nats.exe kv del co-notifier-printer-sap
      ./nats.exe kv del co-notifier-printer-mappings
      ./nats.exe kv del co-notifier-reply-groups
      
    • Linux:

      ./nats kv del co-notifier-job-counters
      ./nats kv del co-notifier-job-data
      ./nats kv del co-notifier-device-counters
      ./nats kv del co-notifier-printer-sap
      ./nats kv del co-notifier-printer-mappings
      ./nats kv del co-notifier-reply-groups
      
  6. Restart seal-co-notifier service.

Reference - buckets in the NATS key-value store

For more information about the buckets in the NATS key-value store used by seal-co-notifier service, refer to SAP notifications.


Language of Error Messages

For SAP Spool, error messages in seal-job-notifier.log may contain non-English messages. To change it, specify the logon language for the SAP system connection in sapnwrfc.ini:

  1. On the Output Engine server, edit sapnwrfc.ini:

    C:\ProgramData\SEAL Systems\config\sapnwrfc.ini
    
  2. Add the language specification to the file:

    LANG=EN
    

    Literature - logon language

    In the sapnwrfc.ini file, the LANG parameter specifies the logon language for the SAP system connection.

    Specify the language with the two-character ISO code (like EN for English, DE for German) or the one-character SAP-specific code (like E for English, D for German).

    Please note: ISO codes are case-insensitiv. SAP codes are not. For example D logs you on in German. But d logs you on in Serbian, if that language is installed in your system.

  3. Save sapnwrfc.ini.

  4. Restart seal-co-notifier service.


Back to top