SAP Event Management on SAP S/4HANA

Operations Guide
PUBLIC

Document version: 1.0 26 May 2021

SAP Event Management on SAP S/4HANA

TABLE OF CONTENTS
1 GETTING STARTED ......................................................................................................................... 3
1.1 About This Guide ............................................................................................................................... 3
1.2 ABAP Platform ................................................................................................................................... 3
2 SYSTEM LANDSCAPE ..................................................................................................................... 4
3 MONITORING.................................................................................................................................... 5
3.1 Alert Monitoring with CCMS ............................................................................................................. 5
3.2 Detailed Monitoring and Tools for Problem Analysis .................................................................... 6
3.2.1 Analysis Tools.................................................................................................................................... 6
3.2.2 Trace and Log Files ........................................................................................................................... 7
3.2.3 Overview of Regularly-Used Jobs, Transactions and Monitoring Tasks .................................... 8
3.2.4 Data-Archiving Monitors ................................................................................................................... 8
3.2.5 Fast-Growing Tables ......................................................................................................................... 9
4 MANAGEMENT OF EVENT MANAGEMENT TECHNOLOGY ...................................................... 10
4.1 Backup, Restore and Recovery ...................................................................................................... 10
4.2 Scheduled Periodic Tasks .............................................................................................................. 11
4.3 Data Archiving.................................................................................................................................. 11
4.4 Load Balancing ................................................................................................................................ 12
5 HIGH AVAILABILITY ...................................................................................................................... 13
6 SOFTWARE LOGISTICS AND CHANGE MANAGEMENT ........................................................... 14
6.1 Change and Transport Management (CTS) ................................................................................... 14
6.2 Support Packages and Patch Implementation ............................................................................. 14
7 TROUBLESHOOTING .................................................................................................................... 15
8 SERVICES FOR SAP EVENT MANAGEMENT ON SAP S/4HANA ............................................. 16

2
SAP Event Management on SAP S/4HANA

1 GETTING STARTED

Recommendation
This guide does not replace the daily operations handbook that we recommend customers create for their
specific production operations.

1.1 About This Guide

Designing, implementing, and running your SAP applications at peak performance 24 hours a day has never
been more vital for your business success than now.
This guide provides a starting point for managing SAP Event Management on SAP S/4HANA and maintaining
and running it optimally. It contains specific information for various tasks and lists the tools that you can use to
implement it.

Recommendation
Before you start the implementation, make sure you have the latest version of this document. You can find
the latest version at the following location: https://help.sap.com/ems4.

1.2 ABAP Platform

Each version of SAP S/4HANA is built upon a corresponding version of ABAP platform. For example, SAP
S/4HANA 2020 SP02 is built upon ABAP platform 2020 SP02.

SAP Event Management on SAP S/4HANA uses functions of the underlying ABAP platform that are described
in the document Administrating the ABAP Platform. To access it, go to https://help.sap.com/s4hana_op_2020,
enter Administrating the ABAP Platform into the search bar, press Enter, and open the search result with that
title.

Important Note
Throughout this document links point to the latest version of the SAP S/4HANA 2020 documentation:
https://help.sap.com/s4hana_op_2020.
If you are running SAP Event Management on S/4HANA on a different version of SAP S/4HANA, on the
Help page choose the version you are using in the Versions drop-down box.

3
SAP Event Management on SAP S/4HANA

2 SYSTEM LANDSCAPE
SAP Event Management on SAP S/4HANA supports 2 deployment options:
1. Stand-alone (On-premise and private cloud)
2. An add-on on SAP S/4HANA (On-premise and private cloud)

For a stand-alone deployment you install SAP Event Management for SAP S/4HANA on a dedicated server.
The download includes the software component version SCEMSRV 930 and one of the required product
versions of S/4 Foundation. The minimum supported version of S/4 Foundation is 1809. But we recommend
to use the latest available release of S/4 Foundation that is supported by SAP Event Management for SAP
S/4HANA. In a typical system landscape SAP Event Management for SAP S/4HANA can connected to one or
several instances of SAP ECC and SAP S/4HANA. If SAP Transportation Management on SAP S/4HANA
shall be connected, you must use release 1809 or higher.

SAP S/4HANA

SAP TM 1809+ ...

SAP BW 753+ ...

SAP EM on SAP S/4HANA

SCEMSRV 930

SAP S4FND 1809+

SAP ECC 6.0+ / TM / other BS applications

SAP PI_BASIS 731+ ...

The alternative deployment option is to have SAP Event Management on SAP S/4HANA On-Premise or in the
Private cloud. In that case, SAP S/4HANA release 1809 or higher is required.

SAP EM on SAP S/4HANA

SAP S/4HANA 1809+

SAP TM 1809+

...
SAP S4FND 1809+

For more information about installing SAP Event Management for SAP S/4HANA 1.0, refer to the installation
note, SAP Note 3051311.

4
SAP Event Management on SAP S/4HANA

3 MONITORING
SAP provides you with an infrastructure to help your technical support consultants and system administrators
effectively monitor your system landscape.

For more information about monitoring topics, go to https://help.sap.com/s4hana_op_2020, enter Solution

Monitoring into the search bar, press Enter, and open the search result with that title.

For more information about monitoring with SAP Solution Manager, go to

https://help.sap.com/s4hana_op_2020, enter Connecting a Technical System to SAP Solution Manager into
the search bar, press Enter, and open the search result with that title.

3.1 Alert Monitoring with CCMS

The SAP Event Management on SAP S/4HANA monitor is an Event Management-specific collection of
functions, which displays all the Event Management messages on an overview screen, for example. You may
include the SAP Event Management on SAP S/4HANA monitor in the central monitoring by Computing Center
Management system (CCMS) that is part of the ABAP platform monitoring tools.

Note
We recommend that you connect SAP Event Management on SAP S/4HANA to the Computing Center
Management System (CCMS) only if you have appropriate knowledge of Computing Center Management.

To do so, you must fulfill the following prerequisites:

• You have executed reports /SAPTRX/SLG1_LINK and /SAPTRX/SCHEDULE_EM_JOBS_NODE
once before calling the SAP Event Management on SAP S/4HANA monitor. This is to ensure that the
functions for evaluating the application log and scheduling background jobs relevant to Supply Chain
Event Management (SCEM) appear in the choice of functions for the SAP Event Management on
SAP S/4HANA monitor.

Note
If you restart the system, you must run these two reports again.

You have scheduled the respective background jobs for each client in which you want to set the monitoring
functions specific to SAP Event Management on SAP S/4HANA in the CCMS. The system displays the
background jobs in the dialog structure of the SAP Event Management on SAP S/4HANA monitor.

Background Job Description

/SAPTRX/COLLECT_LOCKED_EH Number of locked event handlers in the desired client
/SAPTRX/COLLECT_LOCKED_EHSETS Number of locked event handler sets in the desired client
/SAPTRX/COLLECT_UNPROC_EVMSG Number of unprocessed event messages in the desired client

Note
If you restart the system, you must run these two reports again.

For more information, see SAP Library for SAP Event Management on SAP S/4HANA on SAP Help Portal at
https://help.sap.com/ems4. In SAP Library, choose SAP Event Management on SAP S/4HANA Infrastructure
-> Monitoring and Evaluation Processes -> Connection to the Computing Center Management System.
For more information about CCMS, the Alert Monitor, and monitoring of data archiving, go to
https://help.sap.com/s4hana_op_2020, enter Monitoring in the CCMS into the search bar, press Enter, and open
the search result with that title.

For more information about how to enable the auto-alert function of CCMS, see SAP Note 617547.

5
SAP Event Management on SAP S/4HANA

3.2 Detailed Monitoring and Tools for Problem Analysis

3.2.1 Analysis Tools

Specifically for analyzing SAP Event Management on SAP S/4HANA the following monitors are available:

Monitor Detailed Description Menu Path

/SAPTRX/EH_LIST The event handler list provides details about an event handler. The On the SAP Easy Access screen, choose Event
status of events, event and error messages, and status details are all Management ->Monitoring and Lists-> Event Handler
contained in the event handler list. List.

/SAPTRX/EVM_STATUS The event message processing status list shows system-generated On the SAP Easy Access screen, choose Event
messages and points out if objects are processed correctly in SAP Management ->Monitoring and Lists -> Event
Event Management on SAP S/4HANA. The list reflects only data errors, Message Processing Status List.
not business process issues.

/SAPTRX/EE_MON The expected event monitor is a report that the system starts as a On the SAP Easy Access screen, choose Event
background process. It checks if expected events that should be Management -> Administration -> Processing Control
reported within a specific period of time have become overdue. If the -> Expected Event Monitor.
monitor discovers an overdue event, SAP Event Management on SAP
S/4HANA reacts according to the defined rules, for example, by
sending an e-mail in response to the overdue events.
SAP delivers activities for the expected event monitor, for example,
comparing two fields or activating an event handler set.

/SAPTRX/LOCKED_PROC This report triggers the subsequent processing of event messages that On the SAP Easy Access screen, choose Event
arrive for an event handler at a time when SAP Event Management on Management -> Administration -> Processing Control
SAP S/4HANA is locking it. -> Process Message for Locked Event Handler.

/SAPTRX/LOCKED_PSET This report reassigns an event handler to an event handler set that On the SAP Easy Access screen, choose Event
SAP Event Management on SAP S/4HANA is locking. Management -> Administration -> Processing Control
-> Process Locked Event Handler Sets.

/SAPTRX/EMJOBS This report resends application object data for event handlers. On the SAP Easy Access screen, choose Event
When you update event handler data by sending application objects Management -> Administration -> Processing Control
to SAP Event Management on SAP S/4HANA, it can be the case that -> Schedule Background Jobs for Event Management.
the event handler is locked by other processing activities (for example,
momentary processing of an event message).
To ensure that the event handler is updated with the data when the
locks are released, the system temporarily stores the data in a
database table (buffer).
This background job checks at regular intervals if the database table
contains data. When the table contains data, it tries to process it. If
necessary, it updates the event handler that was previously locked
with this data.

6
SAP Event Management on SAP S/4HANA

3.2.2 Trace and Log Files

Trace and log files are essential for analyzing problems. SAP Event Management on SAP S/4HANA uses the
standard ABAP Platform tools for tracing and logging.

Trace files and log files are essential for analyzing problems.

An application log is available for both the application systems using the Event Management API and SAP
Event Management on SAP S/4HANA.

The application log documents messages, exceptions, and errors on both the application side and the SAP
Event Management on SAP S/4HANA side. This provides information about communication operations and
problems that occur when event handlers are created, event messages are processed, or information is
queried.

You can analyze the logs or the corresponding messages according to different thematic areas and gain more
detailed information on the messages.
The application log in the application system provides you with an overview of all the activities relevant to an
application object as well as the appropriate event messages. You can reduce the memory space for the
application log by deactivating it per business object.

The SAP Event Management on SAP S/4HANA application log provides you with an overview of all activities
for an event handler, and for its corresponding event messages, that are issued during event handler
processing.
If you have appropriate authorizations, you can define the following when creating an event handler:
• The objects that are logged:
o Event handler creation
o Event message processing
o Updating data from an external source

• The level of detail the system should use when creating logs from high-level processes only, to individual
processes.

You can call the application log from both the event handler overview and the event handler detail overview.
• For the application log in the SAP system, call transaction /SAPTRX/ASAPLOG.
• For the SAP Event Management on SAP S/4HANA application log, on the SAP Easy Access screen, choose Event
Management -> Administration -> Logging -> Application Log: Display Logs (SLG1).

Use the following log object and subobjects for SAP Event Management on SAP S/4HANA in SLG1:
Log Object Log Subobject Description
SAPTRX APPSYS Application system
CONSCHECK Customizing consistency check
EVTMSG Event message processing
SUBSCRIPT Logs for EPCIS subscriptions
TRKOBJ Event handler creation/update/deletion

To deactivate the application log in the application system, in Customizing for the SAP Basis Plug-In, choose
Integration with Other SAP Components -> Event Management Interface -> Define Application Interface ->
Define Used Business Process Types, Application Object Types, and Event Types.

For more information about application logs in the ABAP platform, go to https://help.sap.com/s4hana_op_2020,
enter Application Log (BC-SRV-BAL) into the search bar, press Enter, and open the search result with that
title.

7
SAP Event Management on SAP S/4HANA

3.2.3 Overview of Regularly-Used Jobs, Transactions and Monitoring Tasks

Monitoring Object Monitoring Monitor Frequency Monitoring Activity Responsible Escalation

Transaction/Tool or Error Handling Procedure
Procedure
Set up of /SAPTRX/SLG1_LIN Once, before Schedule Program scheduling Contact application
monitoring K working with SAP background job for management support
Event Management each client to be
on SAP S/4HANA monitored in the
(not with CCMS) for CCMS
the first time
Set up of /SAPTRX/ Once, before Schedule Program scheduling Contact application
monitoring SCHEDULE_EM working with SAP background job for management support
_JOBS_NODE Event Management each client to be
on SAP S/4HANA monitored in the
(not with CCMS) for CCMS
the first time
Display application /SAPTRX/ASAPLOG Daily Display the Program scheduling Contact application
log in SAP Event application log in management support
Management on SAP Event
SAP S/4HANA Management on
SAP S/4HANA
Evaluation of Transaction SLG1 Daily Evaluate the Program scheduling Contact application
application log application log in management support
SAP Event
Management on
SAP S/4HANA
Status of events /SAPTRX/EH_LIST n.a. Display Application Contact application
and error messages functionality management support
shown
List to see if objects /SAPTRY/EVM_STA n.a. Display Program scheduling Contact application
are processed TUS functionality management support
correctly. The list
reflects data errors
only, not business
process issues.
Inbound and Transaction SMQ1 / Daily Status of the Program scheduling Contact software
outbound queue SMQ2 inbound and management monitoring team
monitoring outbound queues

3.2.4 Data-Archiving Monitors

For the latest documentation about archiving and deleting objects in SAP Event Management on SAP
S/4HANA, see SAP Library for SAP Event Management on SAP S/4HANA on SAP Help Portal at
https://help.sap.com/ems4. In SAP Library, choose Administration -> Archiving and Deleting.

If you no longer need event handlers, event messages, or event handler sets, you can either archive and
delete them, or delete them without previously archiving them. When you delete event handlers, event
messages, or event handler sets, SAP Event Management on SAP S/4HANA also deletes any existing
change documents.

8
SAP Event Management on SAP S/4HANA

3.2.5 Fast-Growing Tables

The fastest growing tables depend on the number of parameters, rules, and expected events you have.
For event handlers, pay special attention to all tables beginning with prefix /SAPTRX/EH_*, for example:
• /SAPTRX/EH_INFO
• /SAPTRX/EH_EXPEV
• /SAPTRX/EH_EVMSG

If you use customer-specific extension tables, pay special attention to these tables.
For event messages it also depends on how the customer uses SAP Event Management on SAP S/4HANA.
If you use file attachments, pay special attention to all tables beginning with prefix /SAPTRX/EVM_*, for
example:
• /SAPTRX/EVM_AFB
• /SAPTRX/EVM_AFC
On the application system side, pay special attention to the table /SAPTRX/AOTREF.

9
SAP Event Management on SAP S/4HANA

4 MANAGEMENT OF EVENT MANAGEMENT TECHNOLOGY

SAP provides you with an infrastructure to help your technical support consultants and system administrators
effectively manage all SAP components and complete all tasks related to technical administration and
operation.
For more information about operational topics, go to https://help.sap.com/s4hana_op_2020, enter
Administrating the ABAP Platform into the search bar, press Enter, and open the search result with that title.

4.1 Backup, Restore and Recovery

You need to back up your system landscape regularly to ensure that you can restore and recover it in case of
failure.
To use an appropriate back up and restore method is one of the most important tasks of the system and
database administrator. However, there is no general recommendation for such a method, since it depends
on several factors, such as:
• Disaster recovery concept
• Maximum permissible downtime during restore
• Amount of data loss that can be tolerated
• Available budget
For more information about backup and recovery, see:
• Go to https://help.sap.com/s4hana_op_2020, enter Administrating the ABAP Platform into the search
bar, press Enter, open the search result with that title, and navigate to Administration Concepts and
Tools -> Solution Life Cycle Management -> Backup and Recovery.
• SAP HANA Technical Operations Manual at the SAP Help Portal under
https://help.sap.com/hana_platform -> Solution Administration.

10
SAP Event Management on SAP S/4HANA

4.2 Scheduled Periodic Tasks

To operate SAP Event Management for SAP S/4HANA you should schedule the following background jobs:

Standard Housekeeping Jobs

Program Name/Task Recommended Frequency Detailed Description
Report /SAPTRX/EE_MONITOR Every 2–5 minutes Expected Events Monitor is a scheduled background job that continuously identifies
expected events that are overdue. If an event has exceeded the expected date, the
system

Updates the event status to Overdue .

Creates an expected event monitor procedure, for example, alert notification is
executed.

To schedule the background job, use transaction /SAPTRX/EMJOBS, or on the SAP Easy
Access screen for SAP Event Management on SAP S/4HANA, choose Event
Management Administration Processing Control Schedule Background Jobs for Event
Management .
For more information, see SAP Library for SAP Event Management on SAP S/4HANA on
SAP Help Portal at https://help.sap.com/ems4. In SAP Library, choose SAP Event
Management Infrastructure Event Expected Event Monitor.

Report 6 times a day Processor of locked event handlers is a scheduled regular job in transaction
/SAPTRX/PROCESS_LOCKED_EHS /saptrx/emjobs

For more information, see SAP Note 656990.

Report 6 times a day Processor of locked event handler sets is a scheduled regular job in transaction
/SAPTRX/PROCESS_LOCKED_SET (optional, only when /saptrx/emjobs
S working with EH sets)
For more information, see SAP Note 656990.

Report 6 times a day Resend Application Object Data for Event Handlers is a scheduled regular job in
/SAPTRX/R_REPORT_AI_LOGS transaction /saptrx/emjobs

For more information, see SAP Note 656990.

Report 6 times a day A scheduled regular job in transaction /saptrx/emjobs

/SAPTRX/COLLECT_LOCKED_EH
For more information, see SAP Note 656990.

Report 6 times a day Number of locked event handler sets in the desired client is a scheduled regular job in
/SAPTRX/COLLECT_LOCKED_EHS (optional, only when transaction /saptrx/emjobs
ETS working with EH sets)
For more information, see SAP Note 656990.

4.3 Data Archiving

We recommend archiving data from SAP Event Management on SAP S/4HANA as soon as they no longer
needed.
We strongly recommend establishing and implement an archiving strategy prior to go live with your
installation. This is especially important in use cases where SAP Event Management on SAP S/4HANA is
used to manage a high volume of data and / or a high throughput of data.
For more information, see the SAP Library for SAP Event Management on SAP S/4HANA on SAP Help Portal
at https://help.sap.com/ems4. In SAP Library, choose SAP Event Management on SAP S/4HANA
Infrastructure -> Administration -> Archiving in SAP Event Management.
Archiving in Event Management on SAP S/4HANA re-uses the common archiving tools of the ABAP platform.
For more information about archiving functions in the ABAP platform go to
https://help.sap.com/s4hana_op_2020, enter Administrating the ABAP Platform into the search bar, press
Enter, open the search result with that title, and navigate to -> Administration Concepts and Tools -> Solution
Life Cycle Management.

11
SAP Event Management on SAP S/4HANA

4.4 Load Balancing

SAP Event Management on SAP S/4HANA uses the standard ABAP Platform functions for load balancing.
For more information about this topic, go to https://help.sap.com/s4hana_op_2020, enter Administrating the
ABAP Platform into the search bar, press Enter, and open the search result with that title.

12
SAP Event Management on SAP S/4HANA

5 HIGH AVAILABILITY
SAP Event Management on SAP S/4HANA uses the standard ABAP Platform functions for high availability
and business continuity.

For more information about these topics, see:

• Go to https://help.sap.com/s4hana_op_2020, enter Administrating the ABAP Platform into the search
bar, press Enter, and open the search result with that title.
• SAP HANA Technical Operations Manual at the SAP Help Portal under
https://help.sap.com/hana_platform at System Administration.

13
SAP Event Management on SAP S/4HANA

6 SOFTWARE LOGISTICS AND CHANGE MANAGEMENT

The tools and processes in Software Logistics help you to manage the system landscape in all life cycle
phases. Besides initial implementation of an application, the tools also support on-going system optimization
and adaptation to evolving demands, as well as implementing additional functions.
Note
Some software logistics tools are delivered and regularly updated with the Software Logistics Toolset.
For more information about these tools, see the documentation on the SAP Help Portal under
https://help.sap.com/sltoolset.

Software Change Management standardizes and automates the distribution of software in system
landscapes.
For more information, go to https://help.sap.com/s4hana_op_2020, enter Administrating the ABAP Platform into
the search bar, press Enter, open the search result with that title, and navigate to Administration Concepts
and Tools -> Solution Life Cycle Management -> Software Logistics.

6.1 Change and Transport Management (CTS)

SAP Event Management on SAP S/4HANA uses the ABAP Platform tool Change and Transport System
(CTS) to organize development projects in ABAP Workbench and customizing, and to then transport the
changes between the SAP systems in your system landscape.

For more information about the CTS tool, go to https://help.sap.com/s4hana_op_2020, enter Administrating the
ABAP Platform into the search bar, press Enter, and open the search result with that title.

6.2 Support Packages and Patch Implementation

We recommend that you regularly update your SAP Event Management for SAPS/HANA system to the latest
support package level. To check for available support packages go to the Product Availability Matrix in SAP
Support Portal:
Open support.sap.com/pam, press the button Product availability matrix, search for SAP Event Management
on SAP S/4HANA, and choose your product version.

14
SAP Event Management on SAP S/4HANA

7 TROUBLESHOOTING
SAP Event Management on SAP S/4HANA has no solution-specific troubleshooting tools. You may use the
troubleshooting tools of the ABAP platform.

For more information about troubleshooting of the ABAP Platform, go to https://help.sap.com/s4hana_op_2020,

enter Administrating the ABAP Platform into the search bar, press Enter, open the search result with that
title, and navigate to Administration Concepts and Tools -> Solution Life Cycle Management.

15
SAP Event Management on SAP S/4HANA

8 SERVICES FOR SAP EVENT MANAGEMENT ON SAP S/4HANA

You can use the functions of SAP Solution Manager to create support messages in case of issues. If you
want to forward the message to SAP, please add the application component of the application where you
observe the issue to your message.

For more information about using the Solution Manager, see the SAP Help Portal under
https://help.sap.com/solutionmanager/ Use -> Application Help -> SAP Engagement and Service Delivery.

If you want an SAP support consultant to work directly in your system to make a more precise issue
diagnosis, you need to set up a remote service connection.

For more information about setting up remote service connections to SAP, see:
• SAP Support Portal under support.sap.com/access-support
• Go to https://help.sap.com/s4hana_op_2020, enter Setting Up Service Connections for SAP Remote
Support into the search bar, press Enter, and open the search result with that title.

16
SAP Event Management on SAP S/4HANA

17
SAP Event Management on SAP S/4HANA

18
19
SAP Event Management on SAP S/4HANA

20
www.sap.com/contactsap

© 2021 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company.

The information contained herein may be changed without prior notice. Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors.
National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable
for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements
accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop or release any functionality
mentioned therein. This document, or any related presentation, and SAP SE’s or its affiliated companies’ strategy and possible future developments, products, and/or platform directions and functionality are
all subject to change and may be changed by SAP SE or its affiliated companies at any time for any reason without notice. The information in this document is not a commitment, promise, or legal obligation
to deliver any material, code, or functionality. All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are
cautioned not to place undue reliance on these forward-looking statements, and they should not be relied upon in making purchasing decisions.

SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other
countries. All other product and service names mentioned are the trademarks of their respective companies. See http://www.sap.com/corporate-en/legal/copyright/index.epx for additional trademark
information and notices.