Doc_AAE Additional persistency tables cleanup
Doc_AAE Additional persistency tables cleanup
Symptom
You are using the IDoc_AAE adapter and you have enabled the additional persistency. You may
experience one or several of the following issues:
There is a very high load on the XI_IDOC* tables after executions of the Messaging
System delete or archive background jobs.
Some of the record of the XI_IDOC* tables are not deleted although the corresponding XI
Messages do not exist anymore. You can see the leftover entries in the IDoc Message
Monitor.
IDoc_AAE tables are not cleared when XI messages are archived.
You want to configure the IdocDBTableCleanup job on regular basis.
Other Terms
Java IDoc Adapter, IDoc_AAE Adapter, Persistence, IdocDBTableCleanup,
IdocDBTableCleanupPeriodic, HandleMSEvent
Solution
An enhanced handling of the deletion mechanism and options for the IDoc_AAE database tables
is introduced:
1. By default the IDoc_AAE adapter handles XI Messages delete and archive events that
are sent by the Messaging System background delete or archive jobs are executed. The
handling of these events and the deletion of the IDoc_AAE database tables is improved by
reducing the number and complexity of the database queries.
2. An option to disable the handling of the Messaging System delete and archive events
is introduced. You can do that via the property HandleMSEvent of the JavaIdocAdapter
resource adapter. It is very important configure one of the available Java Jobs to
regularly delete old entries from the Java IDoc database tables if you disable the
handling of the Messaging System delete and archive events
3. A new Java Job Definition IdocDBTableCleanupPeriodic is introduced for regular
deletion of the Java IDoc database tables. In order to configure the job you should
navigate to PI SAP NetWeaver Administrator -> Operations -> Jobs -> Java Scheduler ->
Tasks. Then press the Add button and select IdocDBTableCleanupPeriodic, enter retention
period (in milliseconds) and whether a consistency check should be executed against the
Messaging System tables. Define the time and period for the job execution and save the
configuration. It is recommended that you keep the consistency check enabled. Otherwise
all entries in the IDoc_AAE tables older than the retention period will be deleted even
if corresponding XI Messages still exist.
To apply the above corrections and improvements you should first apply the patch matching
your support package version as listed in the patch table below.
Software Components
Software Component From To
2624188 IdocDBTableCleanupPeriodicAdvanced: a new improved job for IDoc_AAE data deletion with
optimized option for SAP ASE DB
1929966 BC-XI-CON Collective note : SAP NETWEAVER 7.31 SP11 - Process Orchestration (PI)