SAP Note
1918557 - IDoc_AAE: Additional persistency tables cleanup
Component: BC-XI-CON-IDO (Basis Components > NetWeaver Process Integration (PI) > Connectivity > Idoc
Adapter J2EE), Version: 1, Released On: 04.10.2013
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
Reason and Prerequisites
Program error.
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
SAP_XIAF
7.30
7.30
SAP_XIAF
7.31
7.31
SAP_XIAF
7.40
7.40
Support Package Patches
Software Component Version
Patch Level
Patch Level
XI ADAPTER FRAMEWORK 7.40
SP004
000003
XI ADAPTER FRAMEWORK 7.40
SP003
000016
XI ADAPTER FRAMEWORK 7.31
SP005
000051
XI ADAPTER FRAMEWORK 7.30
SP005
000070
XI ADAPTER FRAMEWORK 7.40
SP005
000001
XI ADAPTER FRAMEWORK 7.31
SP009
000007
XI ADAPTER FRAMEWORK 7.30
SP009
000050
XI ADAPTER FRAMEWORK 7.40
SP002
000019
XI ADAPTER FRAMEWORK 7.31
SP008
000018
XI ADAPTER FRAMEWORK 7.30
SP008
000042
XI ADAPTER FRAMEWORK 7.30
SP012
000000
XI ADAPTER FRAMEWORK 7.31
SP007
000026
XI ADAPTER FRAMEWORK 7.30
SP007
000059
XI ADAPTER FRAMEWORK 7.31
SP006
000032
XI ADAPTER FRAMEWORK 7.40
SP006
000000
XI ADAPTER FRAMEWORK 7.30
SP011
000001
XI ADAPTER FRAMEWORK 7.31
SP011
000000
XI ADAPTER FRAMEWORK 7.31
SP010
000001
XI ADAPTER FRAMEWORK 7.30
SP010
000016



















This document is referenced by
SAP
Note/KBA
Component Title
2624188
IdocDBTableCleanupPeriodicAdvanced: a new improved job for IDoc_AAE data deletion with
optimized option for SAP ASE DB
1945721
BC-XI
Central Note for Process Integration NW730 SP12
1929966
BC-XI-CON
Collective note : SAP NETWEAVER 7.31 SP11 - Process Orchestration (PI)