4/6/25, 11:39 PM

Data Archiving (CA-ARC)

Generated on: 2025-04-06 23:39:31 GMT+0000

SAP ERP | 6.0 EHP8 Latest

Public

Original content: https://help.sap.com/docs/SAP_ERP/c6ef916aeac74db0a6bec2142bc00248?locale=en-

US&state=PRODUCTION&version=6.18.latest

Warning

This document has been generated from SAP Help Portal and is an incomplete version of the official SAP product documentation.
The information included in custom documentation may not reflect the arrangement of topics in SAP Help Portal, and may be
missing important aspects and/or correlations to other topics. For this reason, it is not for production use.

For more information, please visit https://help.sap.com/docs/disclaimer.

This is custom documentation. For more information, please visit SAP Help Portal. 1
 4/6/25, 11:39 PM

Logistics Execution (LE)

The following table shows which archiving objects are available:

Objects in Logistics Execution Archiving Object

Warehouse Management Documents RL_*

Deliveries RV_LIKP

Shipment Documents SD_VTTK

Shipment Cost Documents SD_VFKK

Direct Store Delivery

Objects Archiving Object

DSD: Archiving Object for Settlement Documents /DSD/SL

DSD: Archiving Object for Visit List /DSD/VC

Data Archiving with Archive Development Kit (ADK)

Context
Data Archiving removes mass data, which the system no longer needs, from the database, but which must still be available for
reporting. For the most part, SAP's data archiving concept is based on the archiving objects of the Archive Development Kit
(ADK).

Archiving Objects

Archiving objects describe the structure and context of the data to be archived. Predefined archiving objects are available for the
applications for which data is to be archived. In data archiving, the system writes the data to archive files according to the relevant
archiving objects and stores these.

 Example
Financial Accounting documents are archived using the archiving object FI_DOCUMNT. This archiving object includes the
document header, company code-specific postings, change documents, and related texts.

Steps for Data Archiving

Data archiving takes place in individual steps to ensure that only successfully archived data can be deleted. These are the three
main steps:

Writing the data to be archived to a new archive file

Storing the archive files in an external store (optional)

Deleting the archived data from the database starting from the archived files you have created

This is custom documentation. For more information, please visit SAP Help Portal. 2
 4/6/25, 11:39 PM
The following illustration describes the data archiving procedure.

Data Archiving in the SAP System

Procedure
1. Familiarize yourself with the specifics of ADK-based data archiving.

More information:

Properties and Features of Data Archiving

Archiving Object

Archive Administration

2. Make the settings required for Customizing for data archiving.

More information: Customizing for Data Archiving

3. Execute the data archiving.

More information: Executing Data Archiving

4. Use the options for viewing and analyzing archive files.

More information:

Archive Information System

Archive File Browser

Table Analysis

Next Steps
This is custom documentation. For more information, please visit SAP Help Portal. 3
 4/6/25, 11:39 PM
Data Archiving in SAP NetWeaver AS (available archiving objects)

Properties and Features of Data Archiving

Use
Properties of Data Archiving

As data archiving is integrated into the application, you have to be familiar with the semantics of the application data. Data
archiving displays the following properties over and above saving table contents:

Hardware independence

As the encryption of the numeric fields, for example, the integer is dependent on the hardware, information has to be added
to the archived data about the hardware used.

Release independent

As the data structure can depend on the SAP release, information about the record layouts and field definitions is also
archived.

Dependencies between data

Dependencies between data objects can be checked and taken into account for archiving.

Company and business structure

Due to the possible dependence of archived data on the organizational structure of the company, the relevant information
is also archived.

Data Archiving Features

Data security

As a result of the separation between writing the data to the archive file and deleting the data from the database, the
archiving transaction can be restarted if you encounter transfer errors. You can only delete the data once it has been
successfully archived. You can achieve maximum security by optionally storing the archive files in an external storage
system before deleting the archived data. You can define the storage time in archiving object-specific Customizing.

Connection to an external store

You can use the following options for storing archive files:

Tertiary storage media, such as WORMs This can be done manually or automatically using the SAP Content
Management Infrastructure (which also contains the ArchiveLink/CMS interface).

Hierarchical storage management systems (HSM systems) in the file system. The HSM system manages the archive
files automatically. For storage of the archive files, the HSM system can also use tertiary storage media.

Data compression

During archiving, data is automatically compressed by up to a factor of 5. However, if the data to be archived is stored in
cluster tables, no additional compression takes place.

Archiving without database backup

As the data is either in the database or an archive file, you can archive data without database backup during normal system
operation. However, SAP recommends that you backup archive files before storing them.

This is custom documentation. For more information, please visit SAP Help Portal. 4
 4/6/25, 11:39 PM
Access to Archived Data

As the archived data has only been removed from the database and not from the application, it is available at any time.
Archive Administration enables the following types of access:

(Read) access to a single data object, such as an accounting document

Analysis of an archive file (sequential read)

Reloading to the database (if supported for the archiving object)

Automatic conversion of old archive files

When archived data is read, the system automatically makes the conversions required by hardware and software changes.

The Archive Development Kit (ADK) can make allowances for changes to database structures after the data was archived
and for changes to hardware-dependent storage formats. The conversion does not affect the archived data. The following
items are changed during automatic conversion:

Database table schema (new and deleted columns)

Data type of a column

Column length

Code page (ASCII, EBCDIC)

Number format (such as the integer on various hardware platforms)

If database structures in an application have undergone more changes than the ADK can handle (for example, if fields have
been moved from one table to another or if one table has been divided into several separate tables), then a program is
provided by the relevant SAP Business Suite solution for the permanent conversion of existing archive files.

Memory space gain

As gaining an increase in memory space improves the performance of the application programs, you require information
about the memory requirement of the data to be archived in the database and also the memory requirement of the
archived files created.

1. Call up the ABAP Dictionary ( Tools ABAP Workbench Development Dictionary ).

2. Enter the name of each individual table, and choose Display.

Archiving Object

Use
The archiving object contains specifications for the archiving of your application data. It describes which database objects need to
be bundled in order to obtain a completed business object that can be interpreted at the time of archiving, regardless of the
technical conditions (such as release or hardware status).

An archiving object has a name of up to ten characters in length. You need this name to be able to execute the assigned archiving
activities in Archive Administration (transaction SARA). The function for calling data archiving is often integrated in the application
menu and the object name is set as the default.

Predefined Archiving Activities

The archiving activity options (programs and steps to be executed) are defined in the archiving object. You create and define
archiving objects with transaction AOBJ.

This is custom documentation. For more information, please visit SAP Help Portal. 5
 4/6/25, 11:39 PM

More Information

Sample Data Description Using an FI Document

Data Object

Sample Data Description Using an FI Document

Use
To ensure that archived FI documents remain available for evaluation, you need to store the technical and business environments
together in the archive file. The respective data description ensures this.

The archiving object for FI documents FI_DOCUMNT, includes the following data, which is stored in different database tables:

Document header

Document segment accounting

Document segment control data

Document segment posting procedures

Document segment CPD data

Document segment change data

Change documents

SAPscript texts

Data Object

Use

A data object is the application-specific instance of an archiving object. While the archiving object describes only the logical
connectivity of the data, the corresponding data object contains all of the application data from the database that is needed for
the complete and consistent archiving of a business object.

A business object can contain the following types of data:

Master data objects, such as material masters, customer masters, bills of material

Transaction data objects, such as financial accounting documents, billing documents, and deliveries.

Structure of a Data Object

A data object consists of the following:

Header containing general information for identifying the data object

Items that contain application data

Archiving

This is custom documentation. For more information, please visit SAP Help Portal. 6
 4/6/25, 11:39 PM
The Archive Development Kit (ADK) ensures that data objects are written sequentially to an archive file. All data objects in the
archive file are set up according to the specifications in the archiving object.

More Information

Archiving object

Archive Administration

Use

The most important actions relating to data archiving take place in Archive Administration. Archive Administration offers only
those actions that have been defined for the archiving object.

You can access Archive Administration as follows:

Transaction code SARA

Menu path Tools Administration Administration Data Archiving

Application Menu

Executing the Archiving Actions

You can schedule the following actions, for example, as a background job in Archive Administration:

Preprocessing

Creating archive files

Deleting data from the database

Storing archive files

Postprocessing

Reading archive files

Filling or emptying the index for archive files

More information: Executing Data Archiving

Administration

You can display and evaluate administration information in the overview of all archiving sessions for an archiving object.

More information:

Archive Administration: Overview of Archiving Sessions

Calling Archiving Session Administration

Other Functions

You can choose the following menu options direct from the application bar or, depending on the action chosen, using Goto or
Environment:

This is custom documentation. For more information, please visit SAP Help Portal. 7
 4/6/25, 11:39 PM
Network Graphik

Reload

Customizing

Job Overview: Offers an overview of current archiving jobs and the functions available for processing them.

Logs

Administration

Stored Files: Enables you to search for stored archive files according to various selection criteria.

DB Tables

Information System

Statistics

Interrupting and Continuing

Check/Delete: Cross-archiving-object check and delete function - available using Environment.

Archive Development Kit

Definition

The Archive Development Kit (ADK) is a tool for developing archiving solutions. It also prepares the runtime environment for
archiving. From a technical viewpoint, it is an intermediate layer between the application program and the archive that provides all
the functions required for archiving data.

Use

The ADK functions are required for archiving and for subsequent access to archived data. The ADK automatically performs the
hardware-dependent adjustments (such as codepage and number format) and structural changes that are required when archive
files are created. When the archive files are accessed later, the ADK temporarily converts data that was archived using earlier
releases of the respective SAP Business Suite application (in the case of SAP R/3, this applies to releases back to and including
2.1).

Integration

The following graphic illustrates the ADK's role in the archiving concept.

This is custom documentation. For more information, please visit SAP Help Portal. 8
 4/6/25, 11:39 PM

See also:

Archive Development Kit (Extended Function Library Applications)

Content Management Service (CMS)

Authorization Check

Definition

Authorization object S_ARCHIVE checks the authorization to carry out various archiving object programs. The Archive
Development Kit (ADK) performs the check when an archive file is opened for one of the following actions:

Write

Delete

Read

Reload

Use

The following authorizations can be given per archiving object and solution (such as SAP Financials or SAP Human Capital
Management):

Everything is permitted

Write, read, and reload archives; execute delete programs; change mode in archive management (notes)

Change mode in archive management

This is custom documentation. For more information, please visit SAP Help Portal. 9
 4/6/25, 11:39 PM
Maintain notes

Read and analyze archives and display mode in archive management

Furthermore, you need the S_DATASET authorization to read and write data. There may also be additional access authorization
checks for specific application components.

See also:

Authorization Checks in Archiving Programs

Tables and Archiving Objects

Use

You use transaction DB15 to determine all the archiving objects that archive the data records from a specific table, or to display all
of the tables for a specific archiving object. You can also call various statistics for the utilized database storage space.

Integration

This function is integrated in data archiving so that you have the option of calling it up from archive administration (transaction
SARA) with DB tables.

Features

Archiving Objects

This pushbutton takes you to the part of the screen in which you can determine archiving objects. When you enter a table in the
Objects for Table field and select Display Tables, you can display the archiving objects for this table.

Tables archived

This pushbutton takes you to the part of the screen in which you can determine tables. When you enter an archiving object in the
Tables for Object field and select Display Objects, you can display the tables for this archiving object.

 Note
When you display archiving objects, those with the following properties are not included:

Read, but do not delete

Archive using a view or a structure

Archive using an archiving class for which no table information is maintained (transaction ACLA)

By default, the system displays only tables whose data records are deleted during archiving. By selecting All Tables, you can,
however, display all tables that are linked to the archiving object (with the exception of those mentioned above).

More information: Displaying Archiving Objects and Tables.

Space (Statistics)

This is custom documentation. For more information, please visit SAP Help Portal. 10
 4/6/25, 11:39 PM
This transaction provides information from SAP tables that are filled by statistics determination runs. This also provides further
information, such as the time and number of the last archiving session and various details on the client used.

Displaying Archiving Objects and Tables

Use

You use an archiving object to archive exactly those tables that are defined in this archiving object in transaction AOBJ. If you do
not know which table a specific archiving object archives, or which archiving objects archive the contents of a specific table, you
can use this procedure to find out.

Various export, filter and search functions are also available.

Procedure
Choose Administration CCMS DB Administration Data Archiving (transaction DB15). . Alternatively, you can call Archive
Administration (transaction SARA) and select DB tables.

The Tables and Archiving Objects screen appears.

Tables

1. To display a table for a specific archiving object, enter the name of the object in the Table for Object field and choose Enter.

 Note
By default, the system displays only tables whose data records are deleted during archiving. To display all tables that the
archiving object processes, choose All Tables.

2. To display all the archiving objects for one of the listed tables, select the table and then choose Display Objects.

The corresponding archiving objects are listed in the top part of the screen.

Archiving Objects

1. Choose Archiving Objects.

2. To display an archiving object for a specific table, enter the table name in the Object for Table field and choose Enter to
confirm.

 Note
In addition to the transparent tables, you can also enter pool or cluster tables here. DB15 determines the transparent
tables for the pool and cluster tables.

3. To display all the tables for one of the listed archiving objects, select the archiving object and then choose Display Tables.

The corresponding tables are listed in the bottom part of the screen.

 Caution
DB15 does not display any archiving objects with the following properties:

Read data, but do not delete

This is custom documentation. For more information, please visit SAP Help Portal. 11
 4/6/25, 11:39 PM
Use views or structures to archive data indirectly

Network Graphik

Use
You can use the network graphic to show any existing dependencies between archiving objects. It shows business process flows
and contexts that can influence the archiving sequence. In particular, at the start of an archiving object, you can use the network
graphic to obtain a good overview of related documents.

 Caution
Like a map, the network graphic is only for orientation purposes. It is not intended to show all the available document types and
dependencies that exist in the system. This means that the network graphic cannot be used as a programming model for
business processes.

Features
In an archiving session, you must take into account any dependencies between archiving objects that require a specific archiving
sequence. In general, you cannot archive data for an archiving object that has preceding objects until these preceding objects have
been archived.

You can use the network graphic to determine whether the archiving object that you want to use has preceding objects. If so, the
preceding objects should be implemented before the current archiving object. The nodes in the network graphic represent the
archiving objects. A node displays the following information:

Achiving object name

Application name

Short description

Date of last archiving displayed in the following colors:

Green: Archiving and deletion successful

Yellow: Successfully archived, but not yet deleted,, or Archiving still running or Delete in progress or Delete
canceled

Red: Not yet archived or Archiving canceled

The network graphic is a standard tool for creating and displaying network plans and hierarchies.

Activities

You can use the network graphic to call Archive Management (transaction SARA) at the same time as the required object name:

1. Double-click the archiving object for which you want to perform an action (such as write or delete).

You access Archive Administration. The system copies the name of the archiving object automatically.

2. You can now select the action that you want to carry out and schedule the relevant background job.

This is custom documentation. For more information, please visit SAP Help Portal. 12
 4/6/25, 11:39 PM

More Information

Calling the Network Graphic

Archive Administration

Calling the Network Graphic

Prerequisites
You are on the Archive Administration: Initial Entry screen of the transaction SARA.

Procedure

1. If you want to display the network graphic for all archiving objects, leave the archiving object name field empty.

If you want to display all the predecessors of a particular object, enter the name of the archiving object in the Object Name
field.

2. Choose Goto Network Graphic .

The network graphic is displayed for the specified archiving object or all registered archiving objects.

 Note
If you have called the network graphic for all archiving objects, you can increase the display area by enlarging the
rectangle in the bottom right-hand corner of the screen. Use the mouse to change the rectangle.

Access to Archived Data

Use
Data that has been archived using SAP Data Archiving has been removed from the database, but not from the application
component. The data is still available for read access and analysis. In some cases, archived data can even be reloaded into the
database.

Prerequisites

A prerequisite of read access and reload access, is that the file can be found in the file system. You can check this in Archive
Administration.

Features

 Note
The uses of archived data described here are technically possible, but are not currently implemented in all application
components. For more information, refer to the application-specific sections of the documentation on Data Archiving in the
SAP Library.

This is custom documentation. For more information, please visit SAP Help Portal. 13
 4/6/25, 11:39 PM
They following types of access are possible:

(Read) access to a single data object, such as an accounting document

Direct access or single document access requires an index that can be filled either during archiving or at a later point. A
complex search of the documents stored in the archive files, in which all orders of an article in a particular batch are
required for a product recall action, is not possible.

The Archive Information System (AS) supports direct access using archive information structures, which are a type of index
that can be generated automatically either whilst the archive files are being written, or at a later point.

Analysis of an archive file (Sequential Read)

It is possible to run an analysis for one or several archiving sessions. The results of the analyzed data objects are displayed
in a list. Furthermore, some archiving objects offer the option of a combined analysis. With this option, you can link current
data and archived data in the database.

Reloading to the Database

Archived data does not usually need to be reloaded because it remains accessible to the applications. There is also a large
amount of data that cannot be reloaded or for which reloading is problematic. For this reason, reload programs do not exist
for all archiving objects.

Archive Administration: Overview of Archiving Sessions

Use
On this screen, you can display and edit administration information about archiving sessions.

Features
Within a status area, archiving sessions are, by default, organized in groups of 20. The sessions are ordered according to the
following statuses:

Archiving Sessions with Errors: The write process terminated before the first archive file was created.

Incomplete Archiving Sessions: The write process has not been completed, the deletion program did not run for all archive
files, or a write process was terminated.

Completed Archiving Sessions: Both the write process and the delete phase were completed successfully.

Archiving Sessions to be Reloaded: The content of the archiving session is to be reloaded into the database.

Archiving Sessions Created during Reload: The archiving session contains data that could not be reloaded into the
database during the reload. The archiving session is not accessible again until the reload program has been run
successfully.

Replaced Archiving Sessions: The archiving session was reloaded or converted.

Invalid Archiving Sessions: The archiving session has been marked as invalid.

Archiving Sessions Flagged for Archiving: The administration data for the archiving session can be archived and deleted
using archiving object BC_ARCHIVE.

Interrupted: The archiving session was interrupted. This was done either manually by the user or because the interruption
parameters were reached (for example, the maximum runtime or a total number of data).

This is custom documentation. For more information, please visit SAP Help Portal. 14
 4/6/25, 11:39 PM
You can call up detailed information about sessions and files on the following screens:

Archiving Session Detail

Archive File Detail

The Goto menu offers access to the following:

Customizing

Job Overview Offers an overview of all archiving jobs and the functions available for their administration. For more
information on the job overview, refer to Managing Jobs in the Job Overview.

Logs

Stored Files: Enables you to search for stored archive files according to various selection criteria.

Retrieved Files: Allows you to search for archive files that were retrieved into the file system, for a comprehensive analysis,
for example. These archive files are no longer needed and can be deleted after they have been used. See Deleting Retrieved
Archive Files.

DB Tables

Information System

Statistics

Interrupting and Continuing

See also:

Calling Archiving Session Administration

Calling Archiving Session Administration

Procedure
1. Call Archive Administration (transaction SARA).

2. In the Object Name field, enter the name of the archiving object.

3. On the initial screen, choose Administration.

4. On the overview of archiving sessions, call the required function.

View the details of an archiving session or an archive file.

Store the archive file or retrieve the stored file, if there is a connection to the storage system.

More information:

Storing Archive Files

Retrieving Stored Archive Files

5. If necessary, use the tool bar to call the following functions:

Overview of the current spool request for the archiving sessions

Function for storing or retrieving archive files

Customizing settings

This is custom documentation. For more information, please visit SAP Help Portal. 15
 4/6/25, 11:39 PM
Overview of all archiving jobs and the functions available for their processing

DB Tables

Information System

Statistics

6. To go to additional functions, choose Goto.

Displaying Archiving Session Details

Prerequisites

You are on the Archive Administration: Initial Entry screen of the transaction SARA. The name of the archiving object is entered in
the Object Name field.

Procedure

1. Choose Administration.

This takes you to the Archive Administration: Overview of Archiving Sessions screen.

2. Position the cursor on the list of archiving sessions with the relevant status and expand the list.

3. Position the cursor on the required archiving session.

4. Choose Detail Screen.

The Archiving Sessions Details dialog box appears.

Next Steps

Displaying Archive File Details

Archiving Session Details

Use

You can display detailed information for each archiving session.

Features
General Information

System ID for the system used for the archiving session

Archiving session number

Date, time, and user for the session

Number of the spool assigned to the session

This is custom documentation. For more information, please visit SAP Help Portal. 16
 4/6/25, 11:39 PM
Current Jobs for the Session

This area only appears if there are still active read or write jobs for the current session. To go to the job overview, choose Display
Job. Here you can release, cancel, or delete individual jobs.

For the current job, the following job activities can be indicated:

Active: The job has status "ready", "scheduled", or "active".

Terminated: The job was terminated.

Changeable Settings

You can create a note and a long text for the session or mark it for archiving or as invalid. You should mark a session as invalid if,
for example. you discover after archiving that the data selection was incorrect. Invalid sessions are no longer offered for archive
selection.

Mark Several Archiving Sessions for Archiving or as Invalid

You can use the report RSARCH_FLAG_SESSIONS to mark several archiving sessions

For archiving

As invalid

When selecting the archiving sessions, you can also differentiate between sessions whose archive files are in a storage system, and
sessions for which no accessible archive files exist.

You can use this report, for example, to mark all the archiving sessions created prior to a specified date for archiving or as invalid.
This can be useful, for example, as an initial run when archiving archive administration data using the archiving object
BC_ARCHIVE.

See also:

Displaying Archiving Session Details

Displaying Archive File Details

Prerequisites
You are on the Archive Administration: Initial Entry screen of the transaction SARA. The name of the archiving object is entered in
the Object Name field.

Procedure

1. Choose Administration.

This takes you to the Archive Administration: Overview of Archiving Sessions screen.

2. Position the cursor on the required archiving session.

3. Expand the archiving session

This is custom documentation. For more information, please visit SAP Help Portal. 17
 4/6/25, 11:39 PM
4. Position the cursor on the required archive file.

5. Choose Detail Screen.

The Archive File Details dialog box appears.

Next Steps

Displaying Archiving Session Details

Archive File Details

Use

You can display an archive file status dialog box for all archiving sessions except for incomplete sessions where no archive files
have been created.

Features

General Information

Archive file name

Date and time or archiving

Number of data objects

Size of archiving file in MB

Status of the archive file

Information for storing the file in a storage system

Index status

Archiving Status

An archive file can have the following statuses:

Write Complete: The archive files have been written, but the data objects in the database have not been (completely)
deleted.

Delete complete: Previously archived data objects have been deleted from the database.

Reloaded: Data objects in the archive file have been reloaded into the database.

Converted: The contents of the archive files have been written to a new archive file with conversion programs delivered by
SAP.

This is custom documentation. For more information, please visit SAP Help Portal. 18
 4/6/25, 11:39 PM
Saved: The content of the archive file is a backup copy of the data in the database.

Storage Status

An archive file can have the following storage statuses:

Not stored: The archive file is still in the file system.

Storage in Progress: The request to store the archive file in a storage system is running.

Stored: The archive file has been successfully stored in a storage system.

Storage Error: The archive file was not successfully stored.

Retrieval in Progress: The request to reload the archive file in the file system has been issued.

Retrieval error:: The file could not be reloaded into the file system.

Storage Incomplete: The archive file could not be completely stored in a storage system.

Index

An index for an archive file can have the following statuses:

Index Built: The index for this archive file was successfully built.

Index Deleted: The index for this archive file was deleted.

No Index Exists: No index exists for the archive file.

Accessibility Status

An archive file can have the following accessibility statuses:

Accessible: The archive file can be accessed in Archive Administration.

Not Accessible: The archive file cannot be accessed in Archive Administration.

Changeable Settings

The dialog box can also contain the following changeable information:

This is custom documentation. For more information, please visit SAP Help Portal. 19
 4/6/25, 11:39 PM
Note written by the user

File name of the archive file

Platform-independent path specified during archiving in archiving object-specific Customizing

The physical file name

Activities
Displaying Archive File Details

Deleting Retrieved Archive Files

Use
This function enables you to delete copies of archive files retrieved to the file system that are stored in an external storage system.
This is usually the case if you no longer need the copies and want to access the stored files directly.

Features
Overview of the Retrieved Archive Files

The program RSARCH_LIST_RETRIEVED provides you with the retrieved archive files. You can restrict the selection to archiving
objects, archiving sessions, archiving files and Content Repositories. The list contains the following information about the retrieved
archived files:

Archive file name

Related logical file path

Creation date

Content Repository name

Document ID in the storage system

Status of the stored file in the storage system

Storage date and time

Deleting Archive Files

To delete retrieved copies of stored archive files, select the relevant entries and the list and choose Delete Retrieved Files. The
program deletes the archive file on operating system level and automatically adjusts the administration entries in archive
administration. After this, you can again access archive files directly in the storage system.

You can delete retrieved archive files only if the original archive files have the status ONLINE in the storage system, and the access
check of the stored archive file is performed successfully. The system checks whether the header information in the archive files
corresponds with the administration data in archive administration. If it does not, you cannot perform the deletion.

For files that do not have the status ONLINE in the storage system, you can double-click on the Status field or use the Errors
Occurred pushbutton to display additional information about the cause. If this information is not available, no message is
displayed.

This is custom documentation. For more information, please visit SAP Help Portal. 20
 4/6/25, 11:39 PM

Activities

You can call up the program RSARCH_LIST_RETRIEVED either from ABAP program execution (transaction SA38) or from archive
administration. To do so, choose Goto Retrieved Files .

Interrupting and Continuing Archiving Sessions

Use
In order that Data Archiving can be seamlessly integrated into the production system, you can interrupt an active archiving session
that is still in the write phase and continue it at a later time. This enables you to react, during archiving, to specific time constraints
or hard-disk space shortages. You can continue and complete interrupted archiving sessions when you have more time or more
storage space.

Integration

This function is a part of the Archive Administration (transaction SARA) and requires the support of the write program.

Prerequisites
If you want to interrupt an archiving session, the following prerequisites must be fulfilled:

The archiving object must be registered in transaction AOBJ as interruptible, so that the Archive Development Kit (ADK)
is able to inform the write program of the interruption request.

The write program is able to process the interruption request.

The archiving session must be run in production mode (not test mode) and be in process.

The settings in transaction AOBJ allow the delete phase to start before the write phase has finished.

If you want to continue the interrupted archiving session, the following prerequisites must be fulfilled:

The session was interrupted using this interruption concept. Archiving sessions that were interrupted for other reasons or
that were terminated by Archive Administration cannot be continued.

The delete phase must be completed for the data that was archived up to the point of interruption (status Completed).

Features
The write phase of an interruptible archiving session can be interrupted either implicitly (based on the values that are specified in
Cross-Archiving Object Customizing or explicitly (manually by an Application Programming Interface (API) Remote Administration
Function.

Activities

1. Explicitly Interrupting an Archiving Session

2. Implicitly Interrupting an Archiving Session

3. Continuing an Interrupted Archiving Session

This is custom documentation. For more information, please visit SAP Help Portal. 21
 4/6/25, 11:39 PM

Implicitly Interrupting an Archiving Session

Prerequisites
The archiving object supports interruption.

In Cross-Archiving Object Customizing, you have specified the runtime in hours or the storage space in MB, or both.

Context

When scheduling an archiving session, you realize that the time slot available or the amount of storage space is not sufficient.
However, you want to start the archiving session, interrupt it, and continue it later.

Procedure

1. Start the archiving session as usual.

2. For each data object that function module ARCHIVE_SAVE_OBJECT writes, the ADK determines whether it is necessary to
interrupt the archiving session.

ADK calculates the following:

a. The time that has elapsed since the write job was released.

b. The storage space, by adding the size of already closed archive files to the size of the archive file that is currently being
written.

3. As soon as one of these values is reached, the ADK triggers the interruption by raising the exception
TERMINATED_REQUESTED.

 Note
The write program must be able to process the exception and call function module ARCHIVE_CLOSE_FILE.

4. The ADK sets status of the archiving session to Incomplete as usual, but also marks it as Interrupted.

Results
The archiving session was interrupted and can be continued later. To continue an interrupted archiving session, see Continuing an
Interrupted Archiving Session.

Explicitly Interrupting an Archiving Session

Prerequisites

The archiving object supports the interruption of an archiving session.

The archiving session to be interrupted is in the write phase.

You are on the Archive Administration: Initial Entry screen of the transaction SARA. The name of the archiving object is
entered in the Object Name field.

This is custom documentation. For more information, please visit SAP Help Portal. 22
 4/6/25, 11:39 PM
Alternatively, you can interrupt an archiving session from archive administration.

Context

You want to interrupt an active archiving session manually and continue it later.

Procedure

1. Choose Goto Interrupt .

2. Select the archiving session(s) to be interrupted. You have the following options:

All interruptible archiving sessions for all interruptible archiving objects

All interruptible archiving sessions for the specified archiving object

Specific archiving sessions that you can select in Archive Selection

 Note
The selection of the archiving sessions is always cross-client if the archiving objects used are cross-client.

3. After you have selected the relevant archiving session, confirm your interruption request by choosing Execute.

Results
The archiving session is interrupted before the system starts writing the next data object. In archive administration, the session is
marked as Interrupted.

Continuing an Interrupted Archiving Session

Prerequisites

The delete jobs have been run for the archive files in the archiving sessions that were interrupted (the archiving session has
the status Completed).

You are on the Archive Administration: Initial Entry screen of the transaction SARA. The name of the archiving object is
entered in the Object Name field.

Alternatively, you can continue an archiving session from administration.

Context
You can use this function to continue archiving sessions that you interrupted earlier.

Procedure

1. Choose Goto Continue .

This is custom documentation. For more information, please visit SAP Help Portal. 23
 4/6/25, 11:39 PM
2. Select the archiving session(s) to be continued.

You have the following options:

All interrupted archiving sessions for all interruptible archiving objects

All interrupted archiving sessions for the specified archiving object

Specific archiving sessions that you can select in Archive Selection

 Note
The selection of the archiving sessions is always cross-client if the archiving objects used are cross-client.

3. Once you have entered the Start Time and Spool Parameters, schedule the continuation job by choosing Execute.

Results

The archiving session is continued at the specified time - that is, the data objects that still have to be archived (in accordance with
your selection criteria) are written to archive files.

Database Actions Before and After Archiving

Use

When archiving application data, the way in which the database data is organized plays a central role. Therefore, you should only
use database actions can be used to optimize organization of data in the database before and after archiving.

Process

1. Database Actions Before Archiving

2. Database Actions After Archivng or Deletion

Database Actions Before Archiving

Use

Archiving application data helps to prevent storage and performance bottlenecks. Since relocating data can, in some
circumstances, in itself, impair performance - this is the case if you need to access archived data - you need to consider carefully
what data to archive.

To determine whether or not you should archive data, consider the following questions:

For memory problems: Can more memory be assigned to the table (MAXEXTENT, Tablespace)?

If the answer is yes, and if you will need to access the archived data and you have no performance problems, you should
consider enlarging the table. You can find the exact description in the SAP NetWeaver AS Documentation SAP Database
Guide: Oracle (BRSPACE for Oracle) or ABAP Dictionary, section Tablespaces und Extents database-independent
parameterization, MaxDB).

How likely is it that you will need to access the archived data again and how often?

This is custom documentation. For more information, please visit SAP Help Portal. 24
 4/6/25, 11:39 PM
If you need to access the archived data often and there are no performance problems, assign more memory to the tables in
question (see above).

For performance problems: Are you using an optimal index for the access?

In some circumstances, a suitable index may be available but not being used. This depends on the database optimizer.

You can check which index is actually used to access data by Performing an SQL Trace. For more information on indexes,
refer to the SAP NetWeaver AS documentation ABAP Dictionary and search for appropriate sections using "index" as your
search term.

Does the application perform a full table scan on the tables that contain the data to be archived?

If the answer is yes and the table is fragmented, it may help to reorganize the table before archiving so that new records
and any records that remain in the database are physically contiguous.

 Caution
Note that reorganization takes a long time and may need to be repeated after archiving.

Throughput during a reorganization:

- With export/import: approximately. 60-100 MByte/hour

- With unload/load: approximately. 250-300 MByte/hour

Database Actions After Archiving or Deletion

Use

Oracle: Reorganization of the Index

If data has been archived or simply deleted and the associated tables were accessed via an index, the index should be reorganized.
Deleting table entries leaves holes in the table which are still indexed. Reorganization can shorten the access paths, reducing
response times.

For databases with a cost-based optimizer (CBO): Refresh the database statistics

If your database uses a cost-based optimizer, you must choose Update Statistics to recalculate the access paths.

Oracle: Reorganization of Tablespaces and Dbspaces

Whether you should reorganize the tablespace depends on the reason for archiving.

Do you expect a lot of new data for the archived tables?

If so, you should not reorganize.

On the other hand, if, for performance reasons, you have archived data that is no longer needed in the system and the table
is otherwise rarely changed, you should reorganize.

Do you want to make space for other tables?

If so, you should reorganize the tablespaces and dbspaces of both the tables and the indices.

This procedure is described in the SAP NetWeaver AS documentation SAP Database Guide: Oracle (BRSPACE for Oracle
databases) and the ABAP Dictionary, section Tablespaces and Extents (database-independent parameterization, MaxDB).

This is custom documentation. For more information, please visit SAP Help Portal. 25
 4/6/25, 11:39 PM

Performing an SQL Trace

Procedure

1. Open a new window and choose System Utilities Performance Trace .

The Trace Requests screen appears.

2. Choose Trace On to activate the trace.

3. Perform a typical database access in the first window (for example, an application transaction or the transaction SE16).

4. Choose Trace Off to deactivate the trace. Examine the SQL statement with List Trace.

5. Position the cursor on one of the PREPARE, OPEN, or REOPEN statements, and choose Explain SQL.

The system displays detailed information. The index used is specified in the line beginning with Index.

Archive Selection

Use

When executing certain archiving actions, it is necessary to select individual archive files or entire archive sessions and make them
available for the relevant action. You do this using Archive Selection, which you access from the initial screen of the relevant
action.

Archive selection is relevant for the following actions:

Delete

Read

Build Index

Reload

Postprocessing

Prerequisites
Depending on the action, there are various criteria that define whether archiving sessions and archive files are displayed in the
archive selection

Criterion 1:

Archive File Status

Action Criterion

Delete Archive file has the status Archived or Stored (if the sequence "Store before deletion" has been
selected in Customizing)

Read Archive file has the status Archived or Deleted or Saved.

This is custom documentation. For more information, please visit SAP Help Portal. 26
 4/6/25, 11:39 PM

Action Criterion

Build Index Archive file has the status Deleted and the file is in the file system

Reload Archive file is in file system and the session has the corresponding status (see criterion 5)

Postprocessing All archive files have status Deleted

Criterion 2:

The archive file must contain at least one data object. If you have performed an archiving session and maintained the variants so
that no data objects were archived, the archive file is automatically deleted and no longer offered for selection.

Criterion 3:

If a file is not accessible in the file system, the file is not offered for selection. A file is only offered for read if all the files in a session
are accessible.

While checking the accessibility of a file, the system performs a read access for each file. This check process can take a long time if
a large number of files are involved. To optimize this process the access check can be activated or deactivated according to archive
files in the file system and archive files in an optical archive in archiving object-specific Customizing.

Criterion 4:

In the case of client-dependent archiving objects, the system only offers you sessions for the current client.

Criterion 5:

An archiving session can only be reloaded if it has the status Complete or Archiving session is reloaded.

Features

You can select complete archive sessions or specific archive files from the archive selection window, which you can access by
choosing Archive Selection, from the initial screen of the archiving action.

Activities

Selecting Archive Files

Selecting Archive Files

Prerequisites

You have selected one of the following actions and are in the screen from which the relevant action is started:

Delete

Read

Build Index

Reload

Postprocessing

This is custom documentation. For more information, please visit SAP Help Portal. 27
 4/6/25, 11:39 PM
At least one of the archive selection criteria is valid for this action.

More information: Archive Selection

Procedure

1. Choose Archive Selection.

The archive selection screen appears for the selected action.

2. To select all files belonging to an archiving session, select the appropriate checkbox.

As a confirmation, the small rectangle to the right of the checkbox is filled.

3. To select individual files belonging to an archiving session, expand the required node and select the relevant checkbox.

As a confirmation, the small rectangle to the right of the checkbox is only half-filled.

 Note
You can select all sessions or cancel the selection by choosing Select All or Deselect All.

 Note
The reload program can only ever process complete archiving sessions. For this reason, you cannot select individual files
for reloading.

4. Confirm the file selection by choosing Continue.

You return to the initial screen.

Results

You have selected the archive file(s) for processing. If you have also entered the start date and spool parameters, you can schedule
the required archiving action.

Next Steps

Entering Spool Parameters

Entering Start Date

Statistics

Use
When writing, deleting, reading, or reloading, the system automatically generates statistical data on each archiving run (such as
the storage space that has been freed in the database by deletions, or the number of deleted data objects), and stores it
persistently in the database.

Data archiving administrators can analyze these key figures so that they can better plan future archiving projects and provide the
necessary resources. Statistics also provide pertinent information on the role of data archiving in reducing the volume of data in

This is custom documentation. For more information, please visit SAP Help Portal. 28
 4/6/25, 11:39 PM
the database.

Features

Statistics are collected by the Archive Development Kit (ADK). This occurs during the write, delete, and reload processes. In other
archiving contexts, for example execution of preprocessing, postprocessing, or conversion programs, no statistical data is
collected.

You can call the analysis transaction either directly from the initial Archive Administration screen (transaction SARA), or from the
Management screen in Archive Administration, using the Statistics pushbutton. Alternatively, you can use the
SAR_DA_STAT_ANALYSIS transaction.

As well as being displayed directly in the analysis transaction, the statistical information flows into the standard log of the write,
delete, read, and reload program. You can analyze it there as well. As a prerequisite, the relevant application must call the standard
log. In the programs mentioned, the standard log is output in the write program only, in both test mode and productive mode. In
other programs, it is only output in productive mode. In other archiving contexts, such preprocessing, postprocessing, or
conversion programs, no standard log is issued.

Selection

Statistical information is displayed on the basis of the selection data entered here. This includes:

The client in which the archiving session was executed

The name of the archiving object

The date on which the archiving session data was created

The status of the archiving session

Archiving Session Status

When selecting the archiving sessions for reporting, you can choose between archiving sessions with the following statuses:

Incomplete

Complete

Replaced

To select a status, enter the corresponding code. You can mark one indicator, or a combination of several.

The status used here is the same as the archiving session status in the management part of Archive Administration. You can find
more information under Archiving Session Details.

Displaying Statistical Information

To display statistical information, choose the Display Statistics pushbutton.

 Note
Via Choose Layout, you can change various statistics display settings, such as column width, column order, or column
selection. You can also save this changed display as a user-specific layout variant. For a display that is easier to use, for
example, you can hide columns that do not interest you.

In the full display (that is, if a user-layout has not been defined), the following information is displayed:

This is custom documentation. For more information, please visit SAP Help Portal. 29
 4/6/25, 11:39 PM

Column Explanation

Session number Number of archiving session

Object Name of archiving object

Client Client in which the archiving session was executed

Date Date on which the archiving session was executed

Status Status of the archiving session (incomplete, complete, replaced)

Disk space Space on the (hard) disk occupied by the archiving session

Header data Proportion of header data in the archiving session that classifies and describes the
actual data

Total DB storage space (write) Virtual storage space in MB that an incomplete archiving session occupies in the
database

DB table storage space (write) Occupied table storage space in the database in MB

DB index storage space (write) Occupied index storage space in the database in MB

DB cluster storage space (write) Occupied cluster storage space in the database in MB

DB structure storage space (write) Occupied structure storage space in the database in MB

Total DB storage space (delete) Virtual storage space in MB that was deleted from the database by a completed
archiving session

DB table storage space (delete) Deleted table storage space in the database in MB

DB index storage space (delete) Deleted index storage space in the database in MB

DB cluster storage space (delete) Deleted cluster storage space in the database in MB

DB structure storage space (delete) Deleted structure storage space in the database in MB

Total DB storage space (reload) Virtual storage space in MB that was reloaded into the database by a replaced archiving
session

DB table storage space (reload) Reloaded table storage space in the database in MB

DB index storage space (reload) Reloaded index storage space in the database in MB

DB cluster storage space (reload) Reloaded cluster storage space in the database in MB

DB structure storage space (reload) Reloaded structure storage space in the database in MB

Written data objects Number of data objects that were written for an incomplete archiving session

Deleted data objects Number of data objects that were deleted from the database for a complete archiving
session

Reloaded data objects Number of data objects that were reloaded into the database for a replaced archiving
session

Number of delete jobs Number of executed delete jobs for an archiving session

Length of write job Length in hours of the write job for an archiving session

Length of delete job Average length in hours of the delete job for an archiving run

This is custom documentation. For more information, please visit SAP Help Portal. 30
 4/6/25, 11:39 PM

Length of reload job Length in hours of the reload job for an archiving session

 Caution
When calculating storage space in the database, the system uses the length of the respective object types in the ABAP
dictionary. The value determined in this way can therefore only be an indication of the actual storage space in the database.

Archiving Statistics Information

Statistics information is saved persistently in the database table ADMI_STATS. You can archive it together with archive
management data using the archiving object BC_ARCHIVE.

Activities

Creating Statistics

More Information

Archiving Archive Administration Data (BC-CCM-ADK)

Creating Statistics

Prerequisites

You are on the Archive Administration: Initial Entry screen of the transaction SARA. The name of the archiving object is entered in
the Object Name field.

 Note
Alternatively, you can call the statistics function from the archive management in Archive Administration, or in transaction
SAR_DA_STAT_ANALYSIS. If you use this transaction, you must enter client and archiving object manually.

Context
You can display statistical information that was automatically generated by the archiving programs (write, delete, read, reload).
Statistical information provides useful data on the individual archiving sessions for the database administrator.

Procedure

1. Choose Statistics.

The Display Statistics for Data Archiving screen appears.

2. In the Selection area, enter the date on which the archiving session was carried out.

The client and archiving object are prefilled. However, you can change these values.

3. In the Archiving Status area, select the required status for the archiving sessions for which you want to call statistics.

You can select one or more checkboxes.

This is custom documentation. For more information, please visit SAP Help Portal. 31
 4/6/25, 11:39 PM
4. Choose Display Statistics.

Results

The statistics are displayed in line with the entries made in the selection and status parameters.

More information: Statistics

Logs

Use

This function provides a central access to the logs generated during data archiving. You can call this function from within Archive
Administration by choosing Logs or Goto Logs as well as from Archive Administration.

Features

The following logs are written when an archiving program, such as a preprocessing, write, or delete program, is executed, and can
be displayed in this function:

Job Overview

Information on the background jobs of the archiving program

Job Log

Log of the different steps of an individual background job

Spool List

List generated by the archiving program and stored in the spool

Application Log

Log of all processed objects (summarized and detailed)

Job overview, job log, and spool list are generated only by programs that are executed in the background. The application log can
be generated for programs that run in the background and in dialog mode.

 Note
Whether or not the log of the processed objects is to be updated in the application log, meaning that an application log is
generated, can be set in the variant maintenance of the corresponding program in the entry field Log Output. See Variant
Maintenance for Archiving Jobs.

 Note
Note that not all archiving objects offer the updating of an object log (entry field Detailed Log in variant maintenance).

Log Display

In the log function, the left area of the screen shows the available logs, organized by archiving object, action (for example,
preprocessing, write, delete, and so on) date and time. The newest log is highlighted. If cross-archiving-object logs were created,
you can view them at the end of the log tree under the entry Cross-Archiving-Object (see below).

This is custom documentation. For more information, please visit SAP Help Portal. 32
 4/6/25, 11:39 PM
Under Process Control, you can see whether the process was started in the test or the productive mode. If the process control
could not be determined, the field remains empty.

In the Archiving Session column, you can see the number of the archiving session that was generated by the corresponding
program (for write programs) or processed (for example by delete programs). If the session number could not be determined (for
example, in preprocessing programs), the field remains empty. In case of reload programs, the Original Session column contains
the number of the reloaded session.

Due to technical reasons, the job overview, the job log, and the spool lists can only be displayed as fullscreen.

The Application Log is displayed directly on the right-hand side of the screen. It is used to inform the user about the results of
processing the business objects he or she has selected. For example, in the write program the user learns which business objects
have been archived and which could not be archived and why.

You use the two tab pages to choose between a summarized and a detailed application log (if available). f detailed information is
available for an object, you can display it by using the magnifying glass icon in the Detail column. Click on the question mark icon
in the Long Text column to view the message long text. If no application log was created, the relevant message text is displayed.
Possible reasons for this are, for example, that the relevant archiving program does not support this function or the user wanted
the log output in the list (spool) and not in the application log.

Cross-Archiving-Object Logs

Cross-archiving-object logs are created during the execution of the cross-archiving-object check and delete function. In the log
display, these logs appear at the end of the log tree under Cross-Archiving-Object. The logs are sorted by action, date and time of
the action, and archiving object. For example, if you want to display the logs of all archiving objects for which the system
performed a cross-archiving-object check, expand the Preprocessing node in the tree structure under the above-named heading
and double-click the node with the desired date. In the right-hand area of the log display, the application log of the cross-archiving-
object check session you have chosen appears. In the summarized view, the log contains a consolidated list of all summarized log
messages of the archiving objects included in the check (these are listed as subnodes in the log tree). Due to performance
reasons, the detailed messages of the different archiving objects are not included in the detail view.

It is not possible to display information on the next lower level, that is, on archiving object level. When you choose a node
(document symbol) below the archiving object, the messages for this particular archiving object are shown in the form of a
summary and as detailed information.

Activities

You can limit the display of the logs to one specific archiving object by entering the object in the initial screen of Archive
Administration. If you want to access the logs of all archiving objects, you must leave this field empty.

To display the log for a specific log entry, select the entry in the log entries list and with a right mouse click choose the
corresponding log, for example, the job log or the application log.

To access only cross-archiving-object logs, first choose Check/Delete in Archive Administration and then Logs.

You can delete selected application logs from the system by choosing Environment Delete Application Logs . This
function corresponds to the central delete function of logs using Transaction SLG2, the only exception being that the object
ARCHIVING is already entered per default.

See also:

Variant Maintenance for Archiving Jobs

Standard Log

This is custom documentation. For more information, please visit SAP Help Portal. 33
 4/6/25, 11:39 PM

Standard Log

Definition

The executing program creates a log during reading, writing, deleting, or reloading. This is either a standard log or an application-
specific log that is described in archiving object-specific documentation.

Structure
Depending on the archiving action you have performed, the standard log can contain information about the archiving session or
the archiving file, as well as information about the processed business objects.

Archiving Session Archive File-Specific Log

Number of archiving sessions

Number of processed data objects

Size of archiving session in MB

Amount of header data in %

Table space in MB occupied for

Tables

Indexes

Number of processed table entries

This information is written exclusively in the list (spool).

Business Object-Specific Log

It is used to inform the user about the results of processing the business objects he or she has selected. For example, in the write
program the user learns which business objects have been archived and which could not be archived and why.

First the summarized version of the is displayed. If the user wants the detailed version, he or she can request it on the selection
screen of the relevant archiving program (see Variant Maintenance for Archiving Jobs). If detailed information for an object is
available, you can display the required object by double-clicking it. If detailed information for a message is available, you can
display it by double-clicking the message.

If no application log was created, the relevant text is displayed. Possible reasons for this are, for example, the relevant archiving
program does not support this function or the user wanted the log output in the application log and not in the list (spool).

You can call up the standard log with the Archive Administration: Overview of Archiving Sessions view with Spool List. If the user
has defined in variant maintenance that the business object-specific information is to be output in the application log, you can
display this information in archive administration with Logs.

Cross-Archiving-Object Check and Delete

Use

This is custom documentation. For more information, please visit SAP Help Portal. 34
 4/6/25, 11:39 PM
This function is used to schedule the cross-archiving object check or delete programs. These programs enable you to execute an
archivability check or to delete application data from the database for several archiving objects at once.

Using these programs allows for a more pronounced separation between the moment of the archivability check and the actual
write phase. It also allows you to merely mark data that has been archived for deletion from the database, instead of executing a
delete session immediately. The data is later deleted with the cross-archiving-object delete program (see below).

By de-coupling the archiving phases, you can better control the archiving process and integrate it in the running system. Time-
consuming program runs such as the archivability check or the physical deletion of data can be separated from the write phase,
and be executed when the system is not busy. This concept is therefore particularly suitable for archiving large volumes of data.

Prerequisites

The cross-archiving-object check and delete functions can be used for all archiving objects that support these functions. To check
if this is the case for a specific archiving object, see the archiving documentation for that application, available in the SAP Library.

Before you schedule either of these two programs you must activate the archiving objects to be considered in the Customizing for
Cross-Archiving-Object Programs view.

More information: Check and Delete

Features

Check

Here you schedule the cross-archiving-object check program, with which you want to execute an archivability check for several
archiving objects at once. During the check the program marks all business objects that fulfill the archivability criteria and are
therefore ready to be removed from the database, with a specific status.

Different applications use different statuses to mark data for archiving. The statuses used can therefore change from one archiving
object to another. SAP Customer Relationship Management, for example, uses the status Archivable and has the technical ID
I1100. A business object, such as a CRM sales order, is considered to be archivable if it fulfills the following criteria:

It is closed, meaning that it has the status Completed. This means that it is no longer changed in the application.

It has reached its set residence time. The residence time should be chosen in such a way that it only covers data that is very
seldomly accessed for reading.

In addition to these general criteria, there may be additional, object-specific criteria for determining the archivability of business
objects. These are described in the corresponding documentation available for the archiving object in question.

The business objects marked for archiving can then be archived in a second step using an archiving-object-specific write program.
The deletion of the archived data then takes place via an archiving-object-specific delete program, or a cross-archiving-object
delete program, if supported by the archiving object (see below).

Deletion

Here you schedule the cross-archiving object delete program. The program selects the business objects that were already archived
and those only marked for deletion, and deletes them from the database. If this function is not supported by the archiving object,
the Delete pushbutton is not offered.

The status used by the delete program for the selection of the data is application specific and can therefore differ from one
archiving object to another. In SAP Customer Relationship Management, for example, the Deletable status has the technical ID

This is custom documentation. For more information, please visit SAP Help Portal. 35
 4/6/25, 11:39 PM
I1102 and the Archived status the ID I1101. More information on whether a specific archiving object uses this status and what it is
called is available in the corresponding documentation in the SAP Library.

Displaying the Log

The Logs function is used to display the application logs generated during the cross-archiving-object check and delete functions.
For more information, see Logs.

Activities
You make the cross-archiving-object check and delete program settings in Archive Administration in Cross-Archiving-Object
Customizing Check and Delete .

You schedule the cross-archiving-object check and delete program in Archive Administration. To do so you must enter a variant,
where you can make the following settings:

In the Server Groups field, enter the group of application servers on which the processes are to run. If no server group is
available, you can create one using Computing Center Management System (CCMS).

In the Number of Parallel Processes field, enter the number of processes that are to be started in parallel.

Under Process Control, you determine whether the process is to run in the test or production mode. In test mode the check
or deletion process is only simulated and no actual changes occur on the database. The test or production mode settings
you make in this variant override the settings in the Customizing variant. See Check and Delete and Variant Maintenance
for Archiving Jobs.

 Note
Both programs support parallel processing, meaning that it is possible to divide their processes among several jobs and
application servers. This is generally positive in terms of performance, but also generates a greater system load, as
several tasks are being executed concurrently. Parallel processing cannot be used if no server group is specified.

Cross-Archiving Object Check Program

Use
The cross-archiving-object check program is used for the following purposes:

1. Selection of the data objects to be checked

2. Running the check

3. Setting the check status

The Check Process

First the data objects to be checked are selected using a special function module. The purpose of the preselection function module
is to select the business objects based on the specifications entered in the Customizing variant. The function module takes the
residence time and the resubmission date into account.

Through the preselection it is possible to exclude irrelevant data objects from the actual check. The result is a list of relevant
objects that are transferred to the check program.

This is custom documentation. For more information, please visit SAP Help Portal. 36
 4/6/25, 11:39 PM
The check program then calls the check function module of the application to check the preselected data objects and if applicable,
set their status to Archivable. The list generated by the preselection module is grouped into packages for parallel processing.

To prevent an object from being checked again and again, for every checked object the program enters the date of the last
archivability check in a field in the corresponding header table. This date and the resubmission date, which can be specified in
Customizing, are then used during the next program run to calculate whether the object can be checked again. Objects with the
Archivable status are not checked again.

For SAP Customer Relationship Management archiving objects, the check function module initiates the sending of BDocs
(Business Documents), after the check status has been set. BDocs contain change information about the archived business
objects that are to be considered by the connected mobile systems.

The advantage of the background check is that it facilitates a more automated and therefore faster archiving of business objects.
This type of check, however, also means a higher use of resources. Generally, SAP development decides whether the archivability
check is executed via a cross-archiving-object check program or through an archiving-object-specific preprocessing program. In
some cases you can choose freely.

Activities

The Customizing settings of the cross-archiving-object check program are made in Cross-Archiving-Object Customizing in the
Check and Delete function. The scheduling of the program takes place in Archive Administration with the Check/Delete function.

Customizing for ADK Data Archiving

Use
In Customizing for data archiving, you to set parameters that affect the data archiving process.

Prerequisites

You have Customizing authorization.

Data types are entered.

Organizational data is entered.

Areas

Archiving Customizing can be divided into the following areas:

Cross-Archiving-Object Customizing

Archiving-Object-Specific Customizing

Basis Customizing

Application-Specific Customizing

Some applications provide the option of specifying archivability criteria for application data, to be used during data
archiving. Examples would be the residence time for sales documents or the account type life and document type life for
accounting documents. If it is possible to enter archivability criteria, this function appears in the Customizing of the
application in question and in Archiving Customizing of the corresponding archiving object.

 Note

This is custom documentation. For more information, please visit SAP Help Portal. 37
 4/6/25, 11:39 PM
For more information on archiving-object-specific and application-specific Customizing, see the application-specific
sections of the archiving documentation available in the SAP Library.

Cross-Archiving-Object Customizing (ADK Archiving)

Use

The settings that you make here apply on a cross-application and cross-archiving object basis for all archiving objects.

The cross-archiving object Customizing includes the following functions:

Technical Settings

Check and Delete

Technical Settings

Use

With this function you can make the following settings to control the data archiving process. These settings apply to all archiving
objects.

Data Archiving Monitor

Using this indicator, you can either switch the data archiving monitor (transaction SAR_SHOW_MONITOR ) on or off.

If you set this indicator before the data is archived, the archiving-relevant information about the write and delete jobs is updated.
You can analyze this information using the Data Archiving Monitor. In addition, Alerts (error messages) are triggered if there are
errors.

The Data Archiving Monitor also provides the following information:

Overview of all archiving objects that were executed

Detailed information about individual archiving sessions

Progress report on processed archive files

Help with the analysis of open alerts

The Data Archiving Monitor is part of the CCMS monitor group (transaction RZ20 ), and is available under SAP CCMS Monitor
Templates Database Data Archiving .

For more information, see Data Archiving Monitor.

Check Access for Archive Selection

With this function you can check whether an archive file is available for access in archive administration, when you select archives
for reading, deletion, analysis or reloading. The check can be performed separately for stored archive files and archive files that are
still in the file system.

If you select For Files in File System, the access check covers all archive files in the file system.

This is custom documentation. For more information, please visit SAP Help Portal. 38
 4/6/25, 11:39 PM
If you select For Stored Files, the access check covers all archive files that are in a storage system.

Archive files for which the access check was negative are shown as "not accessible" in the selection screen.

 Note
The access check for stored files requires accesses to the storage system. This means that the check can be very time-
consuming and should only be used after careful consideration.

Verify Archive Files

With this function you can specify that archive files receive additional verification information, which is to be analyzed at a
predetermined point in time. The saving of this additional information does not affect the size of the archive files. The verification
information is necessary for later analysis during deletion, reading or reloading.

The information is used to verify the state of the archive files before the file is accessed. Corrupt files are recognized and reported
at once, and as a result the data is not deleted from the database.

When archive files are written the system automatically saves the verification information. With the Delete, Read or Reload
indicator, you can determine when this verification information is to be analyzed. You can set more than one indicator.

Implicit Interruption of the Write Phase

If supported by the archiving object, you can interrupt the write phase and resume it later. You can specify the time of interruption
using the following criteria:

Max. Duration Hours

Here you specify how much time (in hours) has to pass since the write job was started, before the write session of all
archiving objects that support interruption is stopped.

Max. MB per Session

Here you specify the amount of data (in MB) that has to be reached for the write phase of all archiving objects to be
interrupted automatically.

Both interruption criteria are independent of each other: The criterion that is first fulfilled automatically triggers the
interruption; the other criterion does not have to be fulfilled.

 Note
You can see whether an archiving object supports the interruption function or not in transaction AOBJ, if the
Interruption Possible indicator has been set.

Server Group for Background Processing

Here you can specify on which application server or servers the archiving jobs (write, delete, read, and so on) are to run in the
background, irrespective of the archiving object. If no server group exists yet, you can create it using transaction SM61 .

The system distributes the archiving jobs across the application servers of the server group.

Preprocessing, postprocessing and write jobs that were scheduled via Archive Administration (transaction SARA ) have the
following characteristics:

These jobs are scheduled with a higher priority (job class A).

This is custom documentation. For more information, please visit SAP Help Portal. 39
 4/6/25, 11:39 PM
If the specified server group contains an application server that runs on the database server, then the jobs are scheduled
there.

 Note
The higher prioritization of the write jobs and the fact that the jobs are scheduled on the database server, decreases the
network load during data selection and when the archive files are written to a file system that belongs to the database
server.

 Note
Constraints on the side of the application server may increase the runtime of the entire archiving process, especially if
fewer background work processes are active as delete programs.

Choose only those servers for a server group on which background work processes are active during archiving.

If you have created a server group and entered it in cross-archiving-object Customizing, then other activities such as reloading,
reading of archive files, and index build/delete functions, are performed on that server group.

More Information

Basis Customizing

Archiving Object-Specific Customizing

Implicit Interruption of an Archiving Session

Setting Up Check and Delete Programs

Use

You can set up the cross-archiving object check and delete program according to your requirements. For example, individual
parameters for the selection of the business objects to be checked for a specific archiving object, or you can activate specific
archiving objects for the cross-archiving-object check or delete.

The check is based on the archivability of business objects. You can execute the check for multiple archiving objects in parallel. The
deletion of business objects is also possible for multiple archiving objects.

Prerequisites
The cross-archiving-object check and delete functions can be used for all archiving objects that support these functions.
Therefore, only this objects are offered In Customizing.

Procedure
You make the settings for the relevant parameters in the detail view for an archiving object. To go there, double-click the line with
the required object, for example, BC_ARCHIVE (Archive Administration data).

You can set the following parameters:

General Settings

Check active

This is custom documentation. For more information, please visit SAP Help Portal. 40
 4/6/25, 11:39 PM
If you select this checkbox, the archiving object is taken into account by the next session of the cross-archiving-
object check program, This covers all archiving objects for which you have selected the checkbox. The program
periodically reads a control table to see which archiving objects are still active. Only those parameter values that
were initially (at the time the program is started) read from this table by the check framework program are
processed. In the standard system, this checkbox is deselected.

 Note
Framework programs control the cross-object check and delete programs. They are responsible for starting the
corresponding check or delete function module in the application. This module then does the actual work.

 Note
Changing the Customizing settings during the runtime of the check program: Activating an archiving object does
not affect the running program. An archiving object that was deactivated during the runtime of the program is
removed from the program run, if it has not been processed at that point in time. If you want to stop the program
prematurely, you must deactivate all active archiving objects.

Delete active

 Note
This indicator is offered only for an archiving object if the object supports this function. If this is the case, you can
use the object-specific delete program.

If you select this checkbox, the archiving object is taken into account by the next session of the cross-archiving-
object delete program, This program runs in the background periodically and covers all archiving objects for
which you have selected the checkbox. The program deletes all business objects with the Archived or Deletable
status (however not Archivable). In the standard system, this checkbox is deselected.

Settings for the Check Program

Number of Calls for Preselection Module

Determines total number of times the preselection function module is called. As soon as this value is reached, the
archiving object is removed from the program session. The default value is 10,000 calls.

 Note
The check program works with two archiving-object-specific function modules: The preselection function
module and the check function module.

Package Size of the Preselection Module

Here you define the number of business objects that are selected in the database and passed to the check function
module of the application per call of the preselection function module. The default value is 50,000 objects.

Package Size of the Check Module

The framework program divides the business objects transferred during the preselection process into subpackages,
which are then processed in parallel. The package size is the number of objects that are processed per call of the
check function module. The default value is 500 objects.

Resubmission Interval in Days

Here you define after how many days a business object, which was not archivable during a previous check, can be
checked again. By setting the corresponding value, for example 10 days, you can prevent already checked business
objects from being checked again, as this would unnecessarily prolong the check process. The default value is 10
days.

This is custom documentation. For more information, please visit SAP Help Portal. 41
 4/6/25, 11:39 PM
In the Active Variant field, you can set the variant to be used by the check program. It defines which data is to be processed
by the check program.

Settings for the deletion program

 Note
These settings are only offered for an archiving object, if the object supports this function.

Number of Calls for Preselection Module

Determines total number of times the preselection function module of the delete program is to be called. As soon as
this value is reached, the archiving object is removed from the program session.

The preselection module of the delete program selects all the business objects with the deletable status, groups
them and passes them to the cross-archiving-object delete program.

Package Size of the Preselection Module

Here you define the number of business objects that are selected in the database and passed to the delete function
module of the application per call of the preselection function module.

Package Size of the Delete Module

Here you define the size of the subpackages that are to be processed by the delete program in parallel.

More information:

Cross-Archiving Object Check and Delete

Cross-Archiving Object Check Program

Archiving-Object-Specific Customizing (ADK Archiving)

Use

These settings are valid only for the relevant archiving object. You can set the following parameters:

Technical Settings

Logical file name

Size of an archive file

Settings for the deletion program

File storage to storage system

Check and Delete

This function enables you to navigate to Customizing for cross-archiving-object checking and deleting. Unlike when you
access from cross-archiving-object Customizing, you can only make settings for Customizing of the current archiving
object.

Archive Routing

You use this to define the rules and conditions for the definition of the Content Repositories that are used to store archive
files.

This is custom documentation. For more information, please visit SAP Help Portal. 42
 4/6/25, 11:39 PM

Technical Settings

Use
You use this function to make the following settings to control data archiving. These settings are valid only for the relevant
archiving object.

Logical file name

Size of an archive file

Settings for the deletion program

File storage to storage system

Logical File Name

Use
This is where you enter the logical file name that is used for the archiving object when you store the archive files in the file system.
During runtime, this logical name is converted to a platform-specific physical file name under which the archive files are stored in
the file system.

Features
For information on how to define a logical file name, see Defining Logical Path and File Names. This also provides information on
the interplay between the logical and physical file and path names and the settings that you need to make.

 Note
Provided you have not defined a logical file name that differs from the standard, you do not need to make any further settings.

Size of an Archive File

Use
This parameter specifies the maximum size that an archive file can reach when running a write program.

Features
You have the option of specifying the

Maximum size in MB

Maximum number of data objects

. The value that is reached first triggers the creation of a new archive file. If you leave both fields blank, only one archive file is
created.

This is custom documentation. For more information, please visit SAP Help Portal. 43
 4/6/25, 11:39 PM
Many archiving objects have a maximum files size of 100 MB by default. The maximum number of data objects is set to 0 by
default. For these archiving objects, the maximum size of the archiving file determines the file size.

Note that the maximum size of an archiving file is limited by the operating system and also by the external storage system if one is
connected.

 Note
Since the action Start Deletion Program is triggered automatically for each archive file, you can carry out delete and write jobs
in parallel if relatively small archive files are created. This parallel activity can have a positive effect on the runtime of an
archiving session, as the database is used more efficiently. If a file is too small, the number of processes rises and the system is
negatively affected.

 Note
The size should usually be between 20 and 100 MB. The size must not exceed 2 GB, or no index can be constructed, thereby
preventing single document access.

Settings for the Delete Program

Use
You define the control parameters for running the delete program here.

Features
You can set up a Test Mode Variant by modifying the parameters accordingly. A test mode variant does not delete data
from the database.

You can set up a Production Run Variant by modifying the parameters accordingly. A production run variant deletes the
archived data from the database.

 Caution
Delete program variants are client-specific. You must therefore make the variant settings in all the clients for which you
want to carry out archiving sessions.

When archiving for the first time using a selected archiving object, the relevant test mode and production mode variants
for the delete program must be fully maintained. Check whether both variants exist. Note especially, that if a production
mode variant is not available, data is not deleted form the database when the delete program is run.

During a delete job, you specify when the delete program is to be run in the background:

If you select the Not Scheduled, the delete program is not run automatically but can be run at any time following archiving.

 Note
Delete jobs can also be scheduled without using Archive Administration (transaction SARA). You so so using an external
job scheduler or the program RSARCHD. For more information, see Scheduling Delete Jobs Outside of Archive
Administration.

If you have selected the Start Automatically button, the delete program is run automatically immediately after an
archive file is generated. See also the note under Archive File Size here. If it was specified in Customizing that the file
storage is to take place before the delete phase, the delete program is not started until the file has been stored.
This is custom documentation. For more information, please visit SAP Help Portal. 44
 4/6/25, 11:39 PM
This radio button is of interest primarily if you want to save the archive files before the delete phase. If there is a long time
period between the write phase and the delete phase, there is a danger that the data could be changed before it is deleted,
which means that the data in the archive and in the database are no longer the same. The delete phase should therefore be
carried out as soon as possible after the write phase.

 Note
Since Before Images has been deactivated for the rollback segments, there should be enough space available (Oracle's
Rollback Tablespace).

If you have selected the After Event radio button, the delete program is run automatically once a specific event has
occurred. You select the relevant event by using the F4 input help for the Event field. an event requires that a parameter
be set (an argument), enter the required parameter in this field. A parameter qualifies an event. See also Background Event.

Once all delete jobs for an archiving session are complete, the ADK issues the event SAP_ARCHIVING_DELETE_FINISHED.
The event parameter is the number of the archiving session. You can use this event for event-driven scheduling of
accumulated archiving jobs, succh as the automatic backup of archive files using external tools.

 Note
You can use transaction SM62 to display and maintain events.

You can use the Build Index indicator to specify whether an index is to be constructed for a particular archiving object. You
can use this index to access specific data objects from the archive file (single document access).

 Recommendation
Instead of using this function for single document access, we recommend that you use the Archive Information System
(AS).

File Storage to Storage System

Use
You can specify here whether an archive file is to be transferred automatically after successful processing to a connected storage
system. This can be done manually or automatically using the SAP Content Management Infrastructure (which also contains the
ArchiveLink/CMS interface). You can also specify the sequence of the delete and storage phases.

Prerequisites
A storage system is linked to the SAP Business Suite software.

Features
To start automatic storage of the archive file, select the Start Automatically indicator. Select the relevant content repository.

 Note
If rules and conditions have been defined for the specified archiving object for Archive Routing, it is no longer possible at this
point to manually select the content repository as described above. During the archiving process, the Archive Routing settings
always override the manual selection of the content repositories. In this case, instead of an input field for the content
repository, the system displays the Archive Routing button, which you can use to access Archive Routing to maintain the rules
and conditions.

This is custom documentation. For more information, please visit SAP Help Portal. 45
 4/6/25, 11:39 PM
More information:

Archive Routing

Routing of Archive Files to Different Content Repositories

Under Sequence, you can specify when the storage is to take place:

If you select Delete Before Storage, the archive file is not stored until it has been processed by the delete program. If the
delete program is run in test mode, automatic storage is not carried out. This option improves performance.

You can use this setting to perform storage manually if no delete program has been run for the archive file. In this case, the
system informs you that this does not match the selected sequence. You must then ensure that the file is not stored at the
same time as the delete program is active.

If you select Store Before Delete, the archive file is stored as soon as the write program has created the archive file, but
before the delete program has edited it. The delete program can therefore only remove the contents of an archive file from
the database once the archive file has been stored. option offers enhanced backup, as the archived data is not deleted until
it has been stored.

During storage before delete, you can choose Delete Program Reads from the Storage System to control the read
behavior of the delete program during the delete process:

Indicator selected: After storage, the stored archive file is deleted from the file system. Consequently, during the
delete phase, the delete program reads the archive file from the storage system. ensures that the data is only
deleted from the database if it was successfully stored in the storage system.

Indicator not selected: After storage, the archive file is not deleted from the file system. The delete program reads
the archive file from the file system. This setting results in improved performance of the delete program without
neglecting backup considerations.

If in the settings for the delete program, the radio button Start Automatically is also selected, the delete program is
started automatically following storage. It therefore makes no difference whether the delete program is run in test or
production mode.

Similarly, if you select After Event,delete jobs are scheduled, but they are not run until triggered by the event that has been
configured in the settings for the delete program.

Settings for the Postprocessing Program

Use
Here you can schedule a postprocessing program to run after the delete phase. Postprocessing programs carry out operations
following an archiving session, such as updating statistics and cleaning up secondary indexes. Most archiving objects do not
require a postprocessing program.

Prerequisites
The archiving object being used has a postprocessing program.

To start the postprocessing program, you need to fulfill the following prerequisites:

The last delete program in the archiving session is finished.

No archive file has the status Archived, Archiving in Progress, or Delete in Progress.

This is custom documentation. For more information, please visit SAP Help Portal. 46
 4/6/25, 11:39 PM

Features

In the Variant input field, you define with which variant you want to schedule the postprocessing program.

By selecting the Start Automatically checkbox, you define that the postprocessing program starts automatically after the delete
phase.

Archive Routing

Use

You can use this function to create rules and conditions, based on which archive files are automatically routed to specific areas in
the file or storage system. You have the following options: You can enter one or morel logical file names to determine one or more
directories in the file system into which the archive files are written. You can also enter one or more content repositories to which
the archive files are to be routed during the store phase.

Which of these two options you choose depends on whether you are using a file system or a storage system connected through
ArchiveLink in your archiving strategy. However, it is also possible for you to specify both a logical file name and a content
repository for one archiving session. In this case, the specified directory would be used as an exchange directory before the
storage phase. It is also possible to specify only directories at first and then to extend the rules later by specifying content
repositories for storage of the archive files.

The criteria used in the rules and conditions for both directories and content repositories should be on the organizational unit level
(such as company code) or time-based (such as fiscal year).

Due to legal compliance issues, companies, especially those with international locations, are increasingly forced to keep archived
data separately in order to comply with different retention requirements for different kinds of data, lines of business or countries.
Compared to the manual selection of content repositories or the use of a standard directory such as ARCHIVE_GLOBAL_PATH,
Archive Routing offers companies more flexibility and automation options for this purpose, especially as the latter permits you to
specify only one content repository for all data of one archiving object.

Integration
Customizing

The routing rules and conditions are entered for individual archiving objects in Archive Routing. The function is available under
Archiving-Object-Specific Customizing in Archive Administration (transaction SARA). If no rules have been entered, the directory
or content repository are selected the traditional way. For more information, see Defining Logical Path and File Names and File
Storage to Storage System.

Archiving Process

The system checks the rules during the write phase of the archiving process. If you are also storing your archive files, then the
system checks the rules again during the store phase. It is important to note that Archive Routing does not use the actual contents
of the archive file to determine the directory or content repository, but the selection criteria entered in the variant for the write
session. Note that the set of data covered by the selection criteria in the variant does not have to be exactly the same as the set of
data covered by the routing rules and conditions. However, it is important rather the set of data for the variant selection is within
the set of data specified by the rules. If it is the case, the archiving session is carried out and the archive files are routed to the
appropriate directory or content repository. If not, the archiving session is terminated.

Features

This is custom documentation. For more information, please visit SAP Help Portal. 47
 4/6/25, 11:39 PM
In Customizing, you can create rules for each archiving object that determine which directory or content repository is to be chosen
based on the selection criteria of the write program variant. For each rule, you enter conditions that contain a selection criterion
and a corresponding value or interval. It is possible to create one or more rules per archiving object and one or more conditions per
rule. The complexity of the rules depends on how specific your criteria for separating your archived data into different directories
or content repositories is.

The smallest unit for which a directory or content repository can be determined using Archive Routing is an archiving session. This
means that the individual archive files, and therefore all the data objects (documents) in an archiving session are routed to one and
the same directory or content repository. If you want to route data to different directories or content repositories, you must start a
separate session for each directory or content repository.

Example
You define the following rules and conditions for archiving object SD_VBAK:

Sales Organization Creation Date Content Repository Logical File Name

0001 Any A1

0002 01.01.2000 to 12.31.2002 A2

0002 01.01.2003 to 12.31.9999 A3

These rules are checked during the write phase of the SD_VBAK archiving session. If the selection criteria of the write variant
match the values entered in the rules and conditions, as described above, then the data is routed to the appropriate content
repository during the storage phase. If not, the archiving session is terminated during the write phase. In this example, no logical
file name was specified. This means that prior to the storage phase the data is written to the previously defined standard exchange
directory (determined, for example, by ARCHIVE_GLOBAL_PATH).

More Information

Routing of Archive Files to Different Content Repositories

Routing of Archive Files to Different Directories

Routing of Archive Files to Different Content Repositories

Use
This process describes how you can use archive routing to define rules and conditions that enable archive files to be stored in
specific content repositories automatically during archiving. The actual storage process is also described here.

Process
1. Define Rules and Conditions for Archive Routing

You define the rules and conditions in the Customizing settings for specific archiving objects in archive administration
(transaction SARA) under Archive Routing.

a. Archiving Object

This is custom documentation. For more information, please visit SAP Help Portal. 48
 4/6/25, 11:39 PM
You first specify here the archiving objects for which the content repository is to be determined using archive
routing. By specifying a content repository here, you can override the content repository entered in the technical
settings.

The system requires this information so that it can assign a content repository. Archiving is not possible without
this.

b. Rules

You select an archiving object and enter one or more rules with the respective content repository here.

c. Conditions

You select one of the rules and enter the condition(s) that the system can use to determine a content repository
that is suitable for the rule. Enter a selection here, such as airline or posting date and the associated value or
interval. (Note the following: You can only enter single values and not ranges for selection values such as airline. The
single value, such as the ID LH, is entered in the From field.) You can use the possible entries (F4) to select the
selection values.

2. Routing of Archive Files

During an archiving session, the system checks the rules and conditions you have specified twice: Once during the write
phase and then again during the storage phase.

As described under Archive Routing, it is essential that the system uses the selection values or the content of the write
program variants to determine the content repository in which the archive files in an archiving session are to be stored. You
should therefore ensure that the data quantity covered by the selection values in the write variant is found within the data
quantity defined by the rules. If this is not the case, the system terminates the archiving session during the first check
before the write phase.

Archive files are first routed during the storage phase if all conditions described here are met and it was possible to
uniquely determine a content repository.

You can only define one content repository for each archiving session. If you want to use more than one content repository
for the same archiving object, you must start a separate archiving session for each content repository.

 Note
Following storage: Changes to the routing rules do not usually affect archive files that have already been stored. When
an archive file is created, the system transfers the content repository to archive administration and then always reads it
from there. This means that the system also finds an archive file even if the new routing rules would mean that it would
be stored in a different content repository.

The storage is not reorganized even if the routing rules are changed. This means that archive files that have already been
stored are not moved.

Result
During the storage phase, the system stored the archive files in the content repository according to the rules that you specified.

Example
The following examples show various archive routing scenarios.

You have created the following routing rules in archive routing:

Sales Organization Creation Date Content Repository Logical File Name

This is custom documentation. For more information, please visit SAP Help Portal. 49
 4/6/25, 11:39 PM

0001 Any A1 (rule 1)

0002 01.01.2000 to 12.31.2002 A2 (rule 2)

0003 01.01.2003 to 12.31.9999 A3 (rule 3)

In words, these rules mean the following:

Archive files for sales organization 0001 are stored in content repository A1.

Archive files for sales organization 0002 and a creation date between 2000 and 2002 are stored in content repository A2.

Archive files for sales organization 0002 and a creation date up to and including 2003 are stored in content repository A3.

 Note
The creation date refers to the selection field "Created On" in the write variant and not the date on which the archive
was written.

Example 1:

You start an archiving session with the following variant:

Selection variant

Sales organization From 0002 to

Created On From 01.01.2000 to 31.01.2000

Archive files that are to be generated using this variant should be stored in content repository A2. The sales organization is the
sales organization in the second rule and the date range is found in the date range for the same rule.

Example 2:

You start an archiving session with the following variant:

Selection variant

Sales document From 1 to 100.000

Sales Organization From 0002 to

Created On From 01.01.2000 to 31.01.2000

Or From 01.01.2001 to 31.01.2001

Without From 06.01.2001 to

This variant means that sales documents are to be archived if their document number is found between 1 and 100,000, which
belong to sales organization 0002 and were created in January 2000 or January 2001 but not on 6.1.2001.

The system would determine content repository A2 for these selection values. The system ignores the line in the sales document,
since this selection criterion does not appear in the rules. The system ignores the last line, since this selection is already found in
the range between 01.01.2001 to 01.21.2001 This leaves the following for archive routing:

Selection Variant

This is custom documentation. For more information, please visit SAP Help Portal. 50
 4/6/25, 11:39 PM

Sales Organization From 0002 to

Created on From 01.01.2000 to 31.01.2000

From 01.01.2001 to 31.01.2001

This is suitable for the requirements in rule 2.

Example 3:

Selection Variant

Sales Organization From 0002 to

Created On Greater or equal to 01.01.2003 to

The system was unable to determine any content repository here. It initially appears that the third rule should apply and the
system would use content repository A3. This is not however the case, since the system does not know here that all data that is
equal or later to 1.1.2003 is automatically suitable for the range "From 1.1.2003 to 12.31.9999".

See also:

If the archive routing function available in the standard system does not meet your requirements, you can use the Business Add-In
(BAdI) ARCH_ROUTING_EXTERN. For more information, see Business Add-In: Archive Routing..

Business Add-In: Archive Routing

Use
You can implement the Business Add-In (BAdI) ARCH_ROUTING_EXTERN (for the Routing of Archive Files to Directories in the file
system this BAdI is only available as of the next major release of SAP NetWeaver), if the standard Archive Routing function does
not sufficiently meet your specific requirements. The main purpose of this BAdI is to replace the standard Archive Routing process
with customer-specific code. This is possible for individual archiving objects. The BAdI is filter-dependent, with the archiving object
being the filter.

An active implementation of this BAdI for an archiving object replaces the entire Archive Routing for that archiving object. In this
case the system uses neither the rules as described under Archive Routing nor the content repository specified in technical
Customizing (V_ARC_USR). Other application-specific settings are not run either. The basic concept of Archive Routing, however,
remains the same - the content repository is still determined using the information in the selection variant.

The BAdI has two methods for determining the content repository from the selection variant:

PARAMS2CREP

PARAMS2PATH_EXTENSION

A detailed description of these methods is available in the system documentation of this BAdI.

 Caution
From a technical standpoint it is possible to insert other information into a customer-specific program for determining the
content repository, than that taken from the selection variant. However, keep in mind that the content repository is not
physically determined until the storage phase. During the write phase it is merely checked. This means that the algorithm

This is custom documentation. For more information, please visit SAP Help Portal. 51
 4/6/25, 11:39 PM
should be delivered at both points in the process. The system itself (ADK) only remembers the content repository at the time of
storage.

Routing of Archive Files to Different Directories

Use
This process describes how you can use archive routing to define rules and conditions that enable archive files to be automatically
stored in specific directories in the file system during archiving. The way in which archive files are actually stored is also described
here.

If you are not using a storage system that is connected using ArchiveLink, or you initally want to only store your data in the file
system, you can specify logical file names in Archive Routing to define directories in which archive files can be stored
automatically. If archive files are subsequently to be stored in content repositories, you can subsequently assign the correct
content repository to the rules. The system observes this assignment in the storage location.

Prerequisites
In Basis Customizing (transaction FILE), you have defined logical file names for use in Archive Routing and assigned them to the
individual logical file names. For more information, see Defining Logical Path and File Names.

Process

1. Define Rules and Conditions for Archive Routing

You define the rules and conditions in the Customizing settings for specific archiving objects in archive administration
(transaction SARA) under Archive Routing.

a. Archiving Object

You first specify here the archiving objects for which the directory is to be determined using archive routing.

b. Rules

You select an archiving object and enter one or more rules with the respective logical file names here.

c. Conditions

You select one of the rules and enter the condition(s) that the system can use to determine a directory that is
suitable for the rule. Enter a selection here, such as carriier ID or booking date and the associated value or interval.
(Note the following: You can only enter single values, such as carrier ID, and not intervals for selection values, The
single value, such as the ID LH, is entered in the From field.) You can use the possible entries (F4) to select the
selection values.

2. Routing of Archive Files

During the write phase of an archiving session, the system checks the rules and conditions that you have specified in the
Customizing settings for specific archiving objects.

As described under Archive Routing, it is essential that the system uses the selection values or the content of the write
program variants to determine the directory in which the archive files in an archiving session are to be stored. You should
therefore ensure that the data quantity covered by the selection values in the variant is found within the quantity defined by
the rules. If this is not the case, the system terminates the archiving session during the first check before the write phase.

This is custom documentation. For more information, please visit SAP Help Portal. 52
 4/6/25, 11:39 PM
Archive files are first routed to the respective directories during the write phase in the production mode, if all conditions
described here are met and it was possible to uniquely determine a directory using the logical file name.

You can only define one directory for each archiving session. If you want to use more than one directory for the same
archiving object, you must start a separate archiving session for each directory.

Result
During the write phase, the system stored the archive files in the directory according to the rules and conditions that you specified.

Example
Before archiving using SD_VBAK, define the routing rules as follows:

Sales Organization Creation Date Content Repository Logical File Name

0001 Z_MY_LOG_FILE1

0002 01.01.1999 to 12.31.1999 Z_MY_LOG_FILE2

0002 01.01.2000 to 12.31.2000 Z_MY_LOG_FILE3

0002 01.01.2001 to 12.31.2001 Z_MY_LOG_FILE4

In words, these rules mean the following:

Archive files for sales organization 0001 are created in the directory associated with the logical file name Z_MY_LOG_FILE1.

Archive files for sales organization 0002 and a creation date during 1999 are created in the directory associated with the
logical file name Z_MY_LOG_FILE2.

Archive files for sales organization 0002 and a creation date during 2000 are created in the directory associated with the
logical file name Z_MY_LOG_FILE3.

Archive files for sales organization 0002 and a creation date during 2001 are created in the directory associated with the
logical file name Z_MY_LOG_FILE4.

Archive files are not stored, since no content repository was specified. They remain in the file system. However, they are created in
the directories for the corresponding logical file names. Once archives have been generated for both sales organizations, you
decide to store the archive files. To do so, you extend the rules as follows:

Sales Organization Creation Date Content Repository Logical File Name

0001 A1 Z_MY_LOG_FILE1

0002 01.01.1999 to 12.31.1999 A2_1999 Z_MY_LOG_FILE2

0002 01.01.2000 to 12.31.2000 A2_2000 Z_MY_LOG_FILE3

0002 01.01.2001 to 12.31.2001 A2_2001 Z_MY_LOG_FILE4

Since the files have already been generated for the rules you defined previously and routed to the appropriate directories, you can
easily store these here.

These examples show it can be necessary to change routing rules for sessions that have not yet been stored. This is often the case
if a storage system is to be introduced at a subsequent stage.

This is custom documentation. For more information, please visit SAP Help Portal. 53
 4/6/25, 11:39 PM

More Information
Routing of Archive Files to Different Content Repositories

Basis Customizing (ADK Archiving)

Use
In Basis Customizing you can specify the file names under which the archive files are to be created. The logical file name is
composed of a name and a path. The path is a logical path, meaning that you must follow predefined conventions that determine
the physical format of the path during runtime (platform-specific) based on your specifications. File names and file paths can be
client-specific (transaction SF01) or cross-client-specific (transaction FILE).

For more information, see Defining Logical Path and File Names.

 Recommendation
We recommend that you maintain the platform-independent file names as cross-client files names.

 Note
If you want to transfer archive files to a storage system using the SAP Content Management infrastructure, ensure that the
correct content repository is set up in Archiving Object-Specific Customizing.

Defining Logical Path and File Names.

Use
To specify the platform-specific physical path and file name under which the archive files (which were created during archiving
using this archiving object) are to be stored, you define logical path and file names assign them to the archiving object.

 Note
By default, the system uses the logical file name ARCHIVE_DATA_FILE and the logical path name ARCHIVE GLOBAL PATH.
Consequently, the names only need to be changed if they have to be adjusted to meet special requirements.

Prerequisites
If you intend to transfer the archive files to a storage system using the Content Management Service (includes ArchiveLink
and the CMS interface) , you must ensure that this storage system has access to the archive files.

In the case of HSM systems, you must make sure that the archive files can be written to the file system of the HSM system.

Procedure
1. Defining logical path names

1. Start transaction FILE.

This is custom documentation. For more information, please visit SAP Help Portal. 54
 4/6/25, 11:39 PM
Alternatively, from the initial screen for Archive Administration (transaction SARA), choose Customizing Basis
Customizing Cross-Client File Name/Paths .

2. To enter a new path name, select an existing path name, such as ARCHIVE_GLOBAL_PATH, or choose New Entries. This
must be as descriptive as possible.

3. In the Logical File Path Definition dialog structure, double-click on the Assignment of Physical Path and Logical Paths
substructure.Double-click to select a syntax group or create a new syntax group.

4. Assign a physical path name to the logical path name.

 Caution
When assigning path names, the symbol <FILENAME> must appear at the end. At runtime, this symbol is replaced by
the physical file name (without path name). No part of the physical file name in the path name must be defined.

 Recommendation
If you want to store your archive files, enter the placeholder <F=ARCHIVELINK> in the logical path. With
<F=ARCHIVELINK><FILENAME> the files are created directly in the basis path of the content repository that has been
assigned to the archiving object. This way you can avoid an internal copy process during the store phase.

 Recommendation
You have created the subdirectory "data_archiving" for archive files in the global directory. You then specify a path
name:

· <P=DIR_GLOBAL>/data_archiving/<FILENAME> (Syntax group UNIX)

· <P=DIR_GLOBAL>\data_archiving\<FILENAME> (Syntax group WINDOWS NT)

In a heterogeneous system landscape (such as UNIX and Windows NT servers) all system-specific syntax groups must be
maintained. Ensure that the definitions for the various syntax groups point to the same directory.

1. Save your entry.

2. Defining Logical File Names

 Note
Logical file names client-specific (transaction SF01) or cross-client-specific (transaction FILE). A client-specific definition
always overrides a cross-client definition. Therefore, ensure that in every client any unnecessary client-specific definitions are
deleted.

The following describes the procedure for creating a cross-client definition using the transaction FILE. You create the client-
specific definition in the same way using transaction SF01.

1. Start transaction FILE for cross-client file names.

Alternatively, from the initial screen for Archive Administration, choose Customizing Basis Customizing Cross-Client
File Name/Paths .

For client-specific definitions, from the initial screen for Archive Administration, choose Customizing Basis-
Customizing Client-Specific File Names .

2. To enter a new file name, select an file path name, such as ARCHIVE_DATA_FILE, or choose New Entries. This must be as
descriptive as possible.

This is custom documentation. For more information, please visit SAP Help Portal. 55
 4/6/25, 11:39 PM
3. Double-click on the Logical File Name Definition, Cross-Client dialog structure.

You can access the Change View: Logical File Name Definition, Cross-Client: Overview screen.

4. Maintain the Physical File and Logical Path fields.

In the Physical File field, enter the physical file name you require.

The following parameters are of particular interest here:

PARAM_1: Two-character application abbreviation (such as HR; CO, MM) for classifying the archive files in the
system. The value is determined from the definition of the relevant archiving object at runtime.

PARAM_2: Single-character alphanumeric code (0-9, A-Z). If, when a new archive file is created, an existing file with
an identical physical name would result in a conflict, the ADK increases this value. This must therefore always be a
part of the physical name.

PARAM_3: At runtime, this parameter is filled with the name of the archiving object. In archive administration, this
enables you to check the file contents or to store the archive files by archiving object.

 Recommendation
To enable maximum space in the name range for the archive file, the following entry is recommended for this
field:

<PARAM_1>_<DATE>_<TIME>_<PARAM_2>.ARCHIVE

In the Logical Path field, you assign the logical path name defined previously to the current logical file name. You can assign
a logical path name to multiple logical file names.

5. Save your entry.

3. Assigning a Logical File Name to the Archiving Object

Once you have defined the logical path name and file name, you need to assign the logical file name to the archiving object.
Proceed as follows:

1. In the initial screen for Archive Administration, enter the name of an archiving object and choose Customizing.Under
Archiving Object-Specific Customizing, choose Technical Settings.

2. In the Logical File Name field, enter the required logical file name .

3. Save your entries.

Executing Data Archiving

Prerequisites
You have defined the necessary settings.

More information: Customizing for Data Archiving

You have executed or checked the necessary preparatory steps according to the checklist for data archiving.

More information: Archiving Checklist

Context

This is custom documentation. For more information, please visit SAP Help Portal. 56
 4/6/25, 11:39 PM
In addition to the main steps (creation and storage of archive files and the deletion of archived data from the database), data
archiving also includes other activities. These include scheduling preprocessing an postprocessing as well as reloading or reading
archive files.

Procedure

1. Call Archive Administration.

More information: Archive Administration

2. Enter the archiving object.

When you call from the application, the system automatically transfers the archiving object to Archive Administration.

You can branch to the network graphic to view the available archiving objects, their status and possible dependencies. From
the network graphic, you can access the initial screen for Archive Administration by double-clicking an archiving object.

3. Select the required Activity for the archiving object and schedule the corresponding background job.

a. Optional: If you want to prepare data for archiving(for example, selecting the delete checkbox), schedule the
preprocessing program.

More information: Scheduling Preprocessing for Data Archiving

b. Schedule the creation of archive files as your first archiving step.

More information: Creating Archive Files

c. Schedule the storage or the deletion of archived data. Decide on the sequence of these actions according to the
following criteria:

If security is your main concern, you should schedule the storage of the archive files first. In addition, you can
set the delete program to read the data from the storage system and not from the file system.

If the performance of the archiving program is more important to you, schedule the delete program first. To
do so, you need to have selected the Delete before Storage checkbox in archiving object-specific
Customizing.

More information:

Storing Archive Files

Deleting Archived Data from the Database

d. Optional (if offered by the archiving object): Schedule the postprocessing program.

More information: Scheduling Postprocessing for Data Archiving

e. Fill (or empty) an index for the archive files. The index is required for the display of individual documents belonging
to archiving objects.

More information: Filling and Emptying the Index

f. Access archived files, if necessary.

More information:

Retrieving Stored Archive Files

Reading Archive Files

This is custom documentation. For more information, please visit SAP Help Portal. 57
 4/6/25, 11:39 PM
g. In emergencies only (if data was archived incorrectly): Reload data to the database.

More information: Reloading Archived Data

Archiving Checklist

Use

This checklist helps to ensure that you complete the necessary archiving steps and that you perform them in the correct order.

Procedure

Before the first archiving session

1. In Basis Customizing, check that the logical file names are entered.

2. In cross-archiving object Customizing, check that the Central Repository for storage is maintained using the SAP Content
Management Infrastructure.

3. In application-specific Customizing, check that the residence times are defined.

Before using an archiving object for the first time

Check archiving object-specific Customizing settings:

Was the file name correctly assigned?

Are the deletion program variants maintained? (Note that the variants are client-specific)

Is the maximum archive file size correctly set?

Is the delete program set to run automatically?

Is index creation scheduled?

For each archiving session

1. Ensure that the user department and system administration coordinate their activities.

2. Check the network graphic to determine whether interdependencies exist (do other data objects have to be archived first?)

3. Schedule the archiving session (create variant).

4. If the delete program does not start automatically, start it manually.

5. If the archive files are not to be stored automatically by the Content Management Infrastructure,, trigger storage
manually.

Scheduling Preprocessing for Data Archiving

Context

You have the option of preparing the data in the database for archiving. For example, the preprocessing program selects the data
for archiving.

This is custom documentation. For more information, please visit SAP Help Portal. 58
 4/6/25, 11:39 PM

Procedure

1. Call Archive Administration (transaction SARA).

2. On the initial screen, enter the name of the archiving object in the Object Name field.

3. Choose Preprocessing.

This takes you to the Archive Administration: Preprocessing screen, in which you can schedule a background job for the
program.

4. Use the F4 help to choose a variant. If there is no variant available, choose Variant and enter the relevant variant.

 Note
You can use a variant only in one job. Otherwise you risk the data being archived more than once. If you use a variant
again, a dialog box notifies you of this. Choose Jobs with Selected Variant to access the overview of all jobs that already
have variants created. In the job overview, you can delete jobs that use a specific variant.

5. Enter the start date and the spool parameters.

More information:

Entering the Start Date

Entering Spool Parameters

 Note
You use the Archive Directory to determine the amount for available storage space in the current object-specific archive
directory.

Results

You have now entered all data required for the background job. To create the job, choose Execute.

Creating Archive Files

Context
Archiving begins with the creation of an archive file. This includes the following steps:

1. Creating an archive file with the write program

2. Reading the data to be archived from the database (in background processing)

3. Writing the data to the archive file

The creation of an archive file continues until archiving is complete or until a restriction defined in archiving-object-specific
Customizing (maximum size of an archive file or maximum number of data objects in archive file) has been reached. If archiving is
not completed due to a restriction, the write program creates an additional archive file for the data that has not been archived.

If a restriction defined in Customizing is reached during archiving, Archive Administration continues with the deletion phase (if the
following checkboxes have been selected in archiving-object-specific Customizing: Start Automatically and Deletion Phase

This is custom documentation. For more information, please visit SAP Help Portal. 59
 4/6/25, 11:39 PM
Before Storage).

 Note
It is always possible to schedule a write job, even outside of Archive Administration (transaction SARA), by using an external
Job Scheduler. This enables an improved reconciliation of the data archiving processes with the other processes in your system
environment.

More information: Scheduling Write Jobs Outside of Archive Administration.

Virus Scan

When you write archive files, you can run a virus scan on the data to be archived. The virus scan checks all data objects that
contain records with XSTRING fields (length of byte sequence variable) or X fields (byte sequence). Only these byte sequence data
types potentially contain and distribute viruses.

The ADK virus scan is integrated into the virus scan interface for SAP NetWeaver, and you can activate and implement it as
described there. The virus scan profile is called /SARC/ARCHIVING_ADK. It is deactivated when delivered. When the profile is
active, the message "Virus Scan with Virus Scan Profile /SARC/ARCHIVING_ADK Active" appears in the job log
of a write job. This message is always issued, even if no suspicious data objects has been detected.

If a virus is found, the ADK issues the message as follows:

Virus <Name> found in Object <Structure Type> <Component>. The write program terminates with a system
exception. The relevant session is handled the same as any other terminated session (for example, due to technical reasons) in
Archive Administration. Non-infected archive files that were written and completed correctly before the termination, remain intact.

Write Run Followed by Event

After the creation of all archive files for an archiving session has been completed, the Archive Development Kit (ADK) triggers the
system event SAP_ARCHIVING_WRITE_FINISHED. As a result of the reaction to the system event, you have the option of
scheduling subsequent archiving jobs automatically. These include refilling indexes or the value help, as well as saving archive files
prior to deletion. The event parameter is always the number of the archiving session.

For additional automation of the archiving process, you can transfer the archiving session number to the function module
ARCHIVE_GET_FILES_OF_SESSION. This determines, irrespective of the platform, the name and path of the archive files that
were written for an archiving session.

To define new jobs, use transaction SM36. To maintain events, use transaction SM62.

Archiving of Attachments

You can use generic object services (GOS) or SAP ArchiveLink to link attachments (for example, Office documents, notes, URLs)
with a data object.

If the write program is started for these data objects, the object itself is deleted from the database and written to the archive.
However, any attachments associated with the object remain in the content repository as standard.

Once the data object has expired and is deleted from the archive, any associations between the object and its attachments are
removed. The attachments are deleted using the report Reorganization of Documents and Send Requests (transaction
RSBCS_REORG).

 Note
For a few applications, GOS attachments can be used to archive the assigned attachments directly with the data object. To do
so, set the Archiving of GOS Attachments indicator on the archiving selection screen. For more information, see the field help.

This is custom documentation. For more information, please visit SAP Help Portal. 60
 4/6/25, 11:39 PM

Procedure

1. Call Archive Administration (transaction SARA).

2. On the initial screen, enter the name of the archiving object in the Object Name field.

3. Choose Write.

A new screen, on which you can schedule a background job for the write program, appears.

If archiving for the archiving object was executed or interrupted and if archiving files that have not yet been processed by
the relevant deletion program still exist for the archiving session, the system points this out.

 Caution
Multiple archiving of data can lead to problems. For this reason, some archiving objects require that data does not exist
multiple times in the archive as this can lead to incorrect results, for example, in forming totals.

Ensure the following:

The new write job you want to plan does not select any data contained in the archived files that have not yet been
processed by the deletion program.

No variants with overlapping selection values are used at the same time.

 Note
If the variant you have chosen is already being used in other jobs, you can use the Jobs with Selected Variant
pushbutton to display these and delete them, if necessary.

4. Use the F4 help to choose a variant. If no variant is available, choose Variant and enter the relevant variant. For more
information about variant maintenance, see Variant Maintenance for Archiving Jobs.

 Caution
If, in archiving-object-specific Customizing for the deletion program, the Start Automatically checkbox is selected and
you have chosen a product variant for the write program, the deletion program then starts its product variant. This
means that after archiving, the data is deleted from the database.

5. Enter the Start Date and the Spool Parameters.

 Note
Before you start archiving, you can use the Archive Directory pushbutton to determine the amount of available storage
space in the current object-specific archive directory. However, this function is not suitable for HSM systems.

Results
You have now entered all data required for the background job. To create the job, choose Execute.

 Note
After all archive files have been completely written for a run, ADK starts the system event SAP_ARCHIVING_WRITE_FINISHED.
This triggers subsequent processes, such as file backup using external tools.

The Goto menu offers access to the following:

This is custom documentation. For more information, please visit SAP Help Portal. 61
 4/6/25, 11:39 PM
Customizing

Job Overview: Offers an overview of all archiving jobs and the functions available for processing them. For more information
on the job overview, refer to Managing Jobs in the Job Overview.

Administration

Database Tables

Infosystem

 Note
You can view the logs for the started process on the initial screen of Archive Administration by choosing Logs.

Storing Archive Files

Prerequisites

An external storage system is linked to your SAP System. If you use a Hierarchical Space Management system (HSM) as a
store, enter the file path in transaction FILE,

The content repository, to which you want to transfer the file, has been maintained in archiving object-specific Customizing
for the archiving object.

You are in Archive Administration of the archiving object for which you want to store files.

Context
If you have not specified in archiving object-specific Customizing that archive files are to be transferred automatically after their
creation to a connected storage system, you can store the archive files retroactively by using the SAP Content Management
Infrastructure.

Procedure

1. Choose Storage System.

The Store/Retrieve Archive Files menu selection screen appears.

2. Choose Store Files

The Archive Administration: Store/Retrieve Archive Files selection screen appears.

3. Use Archive Selection, to select the archive files you want to store and specify the start date.

4. Confirm the storage request by choosing Execute.

The selected archive files will be transferred to the storage system at the specified time.

Next Steps

Retrieving Stored Archive Files

This is custom documentation. For more information, please visit SAP Help Portal. 62
 4/6/25, 11:39 PM

Retrieving Stored Archive Files

Prerequisites
You are in Archive Administration of the archiving object from which you want to retrieve files.

The archive files for retrieval are accessible from Archive Administration.

Context
You use SAP Content Management Infrastructure (also contains the ArchiveLink/CMS interface), to retrieve archive files stored in
a storage system into the SAP system for further processing such as evaluation.

Procedure

1. Choose Storage System.

The Store/Retrieve Archive Files menu selection screen appears.

2. Choose Retrieve Files

This takes you to the Archive Administration: Retrieve Files screen.

3. Use Archive Selection, to select the archive files you want to retrieve and specify the Start Date for the retrieval.

4. Confirm the retrieval by choosing Execute.

Results
The selected archive files will be retrieved into the SAP system at the specified time for further processing.

See also:

Storing Archive Files

Deleting Archived Data from the Database

Prerequisites
In Archive Administration, there are archiving sessions for which the delete phase is not yet complete.

You have waited for the write phase to be completed.

More information: Settings for the Delete Program

Context

In the third archiving step (after creating and storing archive files), Archive Administration starts the delete program. This reads
the archived data from the archive file and deletes it from the database.

This is custom documentation. For more information, please visit SAP Help Portal. 63
 4/6/25, 11:39 PM
Depending on the settings you have made in archiving object-specific Customizing, the deletion process for an archive file can run
at the same times as the creation of new archive files.

If you want to save the archive files prior to deletion or if you the next available timeframe for the delete phase is insufficient, you
can schedule the delete program manually. You do the scheduling in Archive Administration (transaction SARA), directly with an
external job scheduler, or you use the program RSARCHD.

 Note
If you do not carry out deletion until after the archive file has been stored, you can make a setting in Archiving Object-Specific
Customizing so that the system will read archive files the from the storage system during deletion. In this way, you can detect
early on errors that might arise when transferring or saving the archive files in the storage system.

Delete Run Followed by Event

After all delete jobs for an archiving session have been completed, the Archive Development Kit (ADK) triggers the system event
SAP_ARCHIVING_DELETE_FINISHED. As a result of the reaction to the system event, you have the option of scheduling
subsequent archiving jobs automatically. These include refilling indexes or the value help as well as saving archive files. The event
parameter is always the number of the archiving session.

For additional automation of the archiving process, you can transfer the archiving session number to the function module
ARCHIVE_GET_FILES_OF_SESSION. This determines the platform-independent name and path of the archive files that were
written for an archiving session.

To define new jobs, use transaction SM36. To define events, use transaction SM62.

 Note
You can also schedule event-controlled delete runs to start automatically. You can define the event that triggers the delete
program in the Settings for the Delete Program group box in archiving object-specific Customizing.

Procedure

1. Call Archive Administration (transaction SARA).

2. On the initial screen, enter the name of the archiving object in the Object Name field.

3. Choose Delete.

This takes you to a screen in which you can schedule a background job for the program.

 Note
If you only want to run the delete program for test purposes (so that the data is not deleted from the database), select
the Test Mode checkbox.

4. Choose Archive Selection.

This takes you to a dialog box that contains the archiving sessions for this archiving object. This should be the current
archiving session.

5. If you want to edit a complete archiving session, select an archiving session and choose Continue. You return to the initial
screen.

This is custom documentation. For more information, please visit SAP Help Portal. 64
 4/6/25, 11:39 PM
f you want to edit one or more specific archive files, expand the archiving session. Select the required archive files, than
choose Continue.

6. Enter the start date and the spool parameter.

More information:

Entering the Start Date

Entering the Spool Parameter

Results
You have entered all data required for the background job. Start the job with Execute.

 Note
You can view the logs for the started process from the initial screen of Archive Administration.

More information: Logs

Scheduling Postprocessing for Data Archiving

Prerequisites

A postprocessing program exists for the archiving object (not all archiving objects have a postprocessing program).

 Note
The postprocessing program processes the data after the archiving session in the database, for example, by deleting log data
that is no longer required or by updating statistics. For this, no access to the archive files is required. Postprocessing is not
usually necessary.

Procedure

1. On the initial screen for Archive Administration, choose Postprocessing.

2. On the Archive Administration: Postprocessing screen, you schedule the archiving job by entering the variant, the start
date, and the spool parameter.

More information:

Creating the Archiving Job Variant

Entering the Start Date

Entering the Spool Parameter

 Note
You use the Archive Directory pushbutton to determine the amount for available storage space in the current object-
specific archive directory.

This is custom documentation. For more information, please visit SAP Help Portal. 65
 4/6/25, 11:39 PM

Results
You have scheduled a background job and can execute it.

Reloading Archives

Prerequisites

 Caution
The reloading function is intended for emergencies, such as an error in Customizing or selecting the wrong documents for data
archiving. Therefore, data should be reloaded immediately after the erroneous archiving session. If you reload the data later you
may end up with inconsistencies in your database.

You are on the Archive Administration: Initial Entry screen of the transaction SARA. The name of the archiving object is
entered in the Object Name field.

Archive Administration has access to the archive files to be reloaded.

 Note
When reloading data, the system can only process complete archiving sessions. Archive files can be reloaded
completely or partially. In either case the archive file is marked as reloaded. Objects that were not reloaded are written
to a new archive file.

Procedure

1. Choose Goto Reload .

This takes you to a screen in which you can schedule a background job for the program.

2. Choose Archive Selection.

This takes you to a dialog box that contains the archiving sessions processed by the delete program.

3. Select the desired archiving session and choose Continue.

You return to the initial screen.

4. Enter the Start Date and the Spool Parameters.

Results
You have now entered all data required for the background job. To create the job, choose Execute.

See also:

Creating Archive Files

Archive Selection

This is custom documentation. For more information, please visit SAP Help Portal. 66
 4/6/25, 11:39 PM

Filling and Emptying the Index

Prerequisites

You are on the Archive Administration: Initial Entry screen of the transaction SARA. The name of the archiving object is entered in
the Object Name field.

Procedure

1. Choose Index.

The Filling and Emptying Index dialog box appears.

2. Choose Fill Index or Empty Index.

3. Define the variant, select the archive, and enter the start date and the spool parameter.

More information:

Selecting the Archive

Entering the Start Date

Entering the Spool Parameter

4. Choose Execute.

Reading Archive Files

Use
In addition to the data in the online database, archived data can also be read or analyzed. When data is analyzed, it is read
sequentially and elementary information such as item number, customer, and order date is displayed in list form. It is possible to
run an analysis for one or several archiving sessions. Not all archiving objects offer an analysis program.

Prerequisites

The archive files to be read are accessible from Archive Administration.

There is at least one read program for the archiving object used.

You are on the Archive Administration: Initial Entry screen (transaction SARA). You enter the name of the archiving object
in the Object Name field.

Procedure
1. Choose Read.

This takes you to the Archive Administration: Start Read Program screen, where you can schedule jobs.

2. In the Batch/Dialog field, you define whether the read program will run in the background (batch) or online (dialog).

3. In the Read Program field, enter the required read or analysis program and choose Execute.

This is custom documentation. For more information, please visit SAP Help Portal. 67
 4/6/25, 11:39 PM
Depending on the selected archiving object, you access a specific selection screen. You more information, see the
documentation for the relevant archiving object.

4. Enter the your selection and choose Execute.

This takes you to the Archive Administration: Select Files to Read dialog box. For more information, see Archive Selection.

5. Select the archive file that you want to read or analyze and confirm the selection by choosing Continue.

The Goto menu offers access to the following:

Customizing

Job Overview Offers an overview of all archiving jobs and the functions available for processing them.

More information: Managing Jobs in the Job Overview.

Administration

DB Tables

Information System

More Information

Archive Information System

Reporting Information Structures

Variant Maintenance for Archiving Jobs

Use

When you schedule jobs for the execution of archiving programs, such as the preprocessing, write or delete programs, you must
enter a variant. The purpose of this variant is to define which data is to be processed and to allow the user to make other settings
that are necessary for the processing of the data.

These variant settings can be made when you are scheduling jobs, using the Maintain function.

Features
Variant maintenance is always dependent on the corresponding archiving object. Therefore, the variants may vary considerably
depending on the archiving object. These differences, however, occur mainly in the section of the variant maintenance, in which the
data selection takes place. For more information about the variant maintenance for a specific archiving object, see the
corresponding documentation for the archiving object in the SAP Library.

The rest of the variant maintenance is the same for most archiving objects. The following settings are possible (depending on the
type of program to be scheduled: write, delete, and so on).

Under Process Control, you determine whether the process is to run in the test or production mode.

Test Mode

In the test mode, the program is only simulated. Depending on the program, either no archiving files are written, or no data
is deleted from the database.

This is custom documentation. For more information, please visit SAP Help Portal. 68
 4/6/25, 11:39 PM
Productive Mode

In this mode the data is physically processed, according to your selection criteria and, if applicable, additional archiving-
object-specific criteria. For example, during the delete phase data is actually removed from the database by the delete
program.

Additional settings you can make in the variant maintenance function:

Detailed Log

In this field you can decide whether a detailed log ( Complete option) is to be generated in addition to the summarized log
during the execution of the program. The summarized log contains each message only once. For each message the number
of affected objects is listed as well as an example of an object.

The detailed log contains all processed objects including the corresponding messages. If you choose Without Success
Messages, no success messages are written to the detailed log.

 Recommendation
Detailed logs should only be generated if you are processing a small number of objects, or, for example, in the test mode.
Otherwise the program may terminate, due to a memory overflow.

Log Output

Here you can determine, whether the log should be output into the List (spool for background programs), to the
application log, or to both.

The advantage of the application log output is that the log messages are displayed during the program runtime. (With
background programs this occurs every 30 minutes and with dialog programs, every 10 seconds). Logs that were output to
the list can only be viewed after the program has finished.

With the list output you have the option to automatically store the log in a storage system (see Spool Parameters under job
scheduling). Logs that were written to the application log can only be stored manually from within the display view.
Moreover, logs that were output to the list, are automatically removed when the corresponding background job is deleted.
Logs written to the application log must be deleted manually.

All logs can be displayed from within Archive Administration by choosing Goto Logs . For more information, see Logs.

Comment on Archiving Session

Here you can enter a short text that helps you identify and better find the archiving session in Archive Administration.

See also:

Logs

Entering the Start Date and Spool Parameters

Use

On the initial screen for scheduling the following archiving activities, you need to enter the start date and the spool parameters:

Write

Delete

Read

This is custom documentation. For more information, please visit SAP Help Portal. 69
 4/6/25, 11:39 PM
Fill and Empty the Index

Store and Provide Archive Files

Schedule Preprocessing

Schedule Postprocessing

Reload

Features
The Start Date and Spool Parameters pushbuttons are followed by a traffic light icon and a note. The table lists the three
possibilities.

Traffic Light Note

Red The values are not entered.

Yellow The values have already been maintained in this session, for the current action or the values for the spool
parameters were taken from the user settings or from the user-specific print parameters.

Green The values are entered.

Activities
Entering the Start Date

Entering the Spool Parameters

Entering Spool Parameters

Prerequisites

You are in Archive Administration (transaction SARA) and have selected one of the following actions:

Write

Delete

Reload

 Note
If the spool parameters are already maintained in the user-specific print parameters, these values are automatically copied
Otherwise, you only have to maintain the spool parameters once after entering the Archive Administration transaction. The
settings remain valid until the end of the archiving session.

Procedure

1. Choose Spool Parameter.

This is custom documentation. For more information, please visit SAP Help Portal. 70
 4/6/25, 11:39 PM
The Background Print Parameters screen is displayed. Here, you can maintain the settings for the printing the archiving
log.

2. Enter the general parameters for the printer, number of printouts, and number of pages.

3. Under Attributes, you can maintain a range of further attributes for spool requests.

4. Choose Continue.

Results
The spool parameters for printing the archiving log are entered. If you have also made your archive selection and entered the start
date, you can now schedule the required archiving action.

Next Steps
Entering the Start Date

Entering the Start Date

Prerequisites

You are in Archive Administration (transaction SARA) and you have selected one of the following actions: Write, delete, or reload.

 Note
You have to enter the start date only when you execute the first action of an archiving session. The start date is retained until
the end of the archiving session.

Procedure

1. Choose Start Date.

You reach the screen for maintaining the start date values.

2. Choose one of the buttons for defining the desired start date, and maintain the parameters in the fields available.

To schedule periodic jobs, use the Period Values function to enter the required start values.

Use the Restrictions pushbutton to define restrictions for the start date.

3. Choose Continue.

Results
You have entered the start date for the archiving action. If you have also made your archive selection and entered the spool
parameters, you can now schedule the required archiving action.

Next Steps
Entering the Spool Parameter

This is custom documentation. For more information, please visit SAP Help Portal. 71
 4/6/25, 11:39 PM
Selecting Archive Files

Archive Information System

Use
The Archive Information System (AS) is a generic tool for indexing data archives that is fully integrated into the SAP data
archiving environment . The indexes that are created, and which are called the Archive Information Structure, let you display the
archived data.

 Note
In this documentation the terms archive information structure and information structure (or infostructure) are used as
synonyms.

Features
The archive information structure includes the following components:

Archive Retrieval Configurator (ARC)

The ARC enables you to create archive information structures with the help of field catalogs, and to fill the structures with data
from the archive. The archive information structure, which represents a kind of archive index, provides the basis for archive data
reporting.

In the Archive Retrieval Configurator, you can decide whether you want to store your archive information structures on the
standard database of the SAP system or on a secondary database (Sybase IQ). Storing archive information structures on a Sybase
IQ database provides faster access to your data and relieves the SAP system database as the archiving indexes are stored on an
"external" database. For more information, see SAP Library for SAP ERP under Cross-Application Functions in SAP ERP
Cross-Application Components Information Lifecycle Management .

Archive Explorer

The Archive Explorer enables fast searches of archived data. It does this by accessing the archive information structures that have
been created and then stored in transparent database tables using the Archive Retrieval Configurator. Furthermore, the Archive
Explorer allows direct access of individual data objects in the archive, which can then be displayed in both technical and
application-specific views.

See also:

Using the Archive Information System

Using the Archive Information System

Use

This process describes the step-by-step procedures for using the Archive Information System (AS).

 Note

This is custom documentation. For more information, please visit SAP Help Portal. 72
 4/6/25, 11:39 PM
Reloading archived data can lead to problems with the Archive Information System, as the available information structures are
not updated automatically.

More information: Procedure for Reloaded Archives

Procedure
1. Checking available information structures

First you should check if an information structure already exists that you could use for reporting archived data. You can then
change this information structure to suit your needs. If there is no information structure available that you can use, you can create
a new one.

2. Creating the information structure

You define the information structure to be used for archive reporting. In doing this, you specify which source fields from the archive
are copied to which fields in the information structure. You do this with the help of application-specific field catalogs, which are
included in the features of the Archive Information System.

An information structure is only ever valid for one archiving object. Multiple information structures can be defined for one
archiving object. For more information, see Creating Information Structures.

3. Activating the information structure

After you have created an information structure, you need to activate it. Alternatively you can use a standard information
structure, provided that it fits your requirements.

At this stage, the system generates a transparent database table and the reporting program. For more information, see Activating
Information Structures.

4. Filling the information structure

During an archiving delete run all (activated) archive information structures belonging to an archiving object are filled
automatically. To do so, the Archive Development Kit (ADK) transfers all data records found in the archive to the AS interface.
From the defined infostructure, the AS filters the data from the data records transferred and enters it in a transparent database
table together with an access key. This table serves as the basis for later searches.

As well as the automatic fill using the delete program, an information structure can also be filled later for already available archives
This can be useful if you want to fill the information structure, report data that was already archived, or if you have changed the
fields of an information structure. For more information, see Filling Information Structures.

5. Reporting information structures

In Archive Explorer, define the archiving object and the information structure from which you want to report. In the selection
screen, where necessary, specify the display parameters for the archived data. Select a data object from the list of data objects
and, where possible, specify the view in which it is to be displayed. For more information, see Reporting Information Structures.

 Note
As well as standard reporting, there is also a special ad-hoc reporting function available that enables direct reporting from
archives. There is no need to fill the archive information structure with data from the archive.

This is custom documentation. For more information, please visit SAP Help Portal. 73
 4/6/25, 11:39 PM

Creating an Information Structure

Procedure
1. On the initial screen for Archive Retrieval Configuration (ARC), choose Archive Infostructure Create .

2. Enter the required data.

This includes the name of the new archive information structure, the archiving object for which the information structure is
intended, as well as a field catalog that you can select by choosing the F4 input help. In the field on the right you can also
enter a short text for the information structure.

3. Choose Create.

4. In the Selectable Fields frame, select all the fields that you want to include in the information structure.

5. Choose Include Selected Fields.

The selected fields are included in the information structure in the Infostructure Fields frame.

6. Save your entry. Choose Return to go back to the ARC entry screen.

Next Steps
Activating and Deactivating Information Structures

Activating and Deactivating Information Structures

Procedure
You are in the initial screen of the Archive Retrieval Configurator (ARC).

Activating an Information Structure

1. Choose Archive Infostructure Activate . The information structure is activated. This structure will be filled
automatically during the next delete phase for this archiving object.

2. Optional: If necessary, you can fill an active information structure for existing archives retroactively.

More information: Filling and Emptying Information Structures

The consequences of activation are:

The archive info structure can be reported in the Archive Explorer.

You can display status information about this information structure.

You cannot make any changes to the information structure.

Deactivating an Information Structure

In the menu, choose Archive Infostructure Deactivate .

This ensures that the system ignores this information structure during the next delete phase for the archiving object or if the
archive information structure is filled retroactively.

 Note
This is custom documentation. For more information, please visit SAP Help Portal. 74
 4/6/25, 11:39 PM
You can make changes to an inactive information structure. However, if you make changes, note that you might also have to
regenerate the table. When doing this, you must delete the data in it. Finally, you must refill the information structure.

Filling and Emptying Information Structures

Prerequisites

You are in the initial screen of the Archive Information System (transaction SARI).

The information structure to be filled has been created and activated.

 Note
An information structure can only be filled for archive files that have already been processed by the delete program.

Procedure
Filling Information Structures

1. Choose Status.

You are now in Status Administration:

2. Enter the name of the archiving object for which you want to fill and information structure.

3. Choose Status per Infostructure.

This takes you to the selection screen for archive information structures.

More information: Status per Infostructure

 Note
When filling the info structure, you can also select individual archiving sessions. Choose Status per Archive.

4. Select the archive infostructures that are to be filled with data from the archive.

5. Choose Fill Structures and enter your desired processing type in the dialog box that appears. Confirm your entry. The
information structure is filled.

 Note
Alternatively you can trigger the filling of an info structure from the Archive Retrieval Configurator entry screen. Enter
the relevant information structure and then select Environment Fill Structure . This takes you to the Status per
Info Structure screen.

Emptying Information Structures

1. Select the archive information structures or archiving session that you want to empty.

2. Choose Empty Structures.

The system empties the information structures.

This is custom documentation. For more information, please visit SAP Help Portal. 75
 4/6/25, 11:39 PM

Reporting Information Structures

Prerequisites
You have created and filled the information structure on which reporting is to be based.

The initial screen of the Archive Explorer appears.

Procedure

1. Enter the name of the information structure. It must be active.

To select an information structure, you can also enter the name of an archiving object and use F4 to display all active
information structures belonging to the object.

2. Choose menu option Archive Infostructure Reporting .

This takes you to the Archive Explorer selection screen.

3. Enter selection criteria to establish which data you want the reporting to read.

If you do not want to restrict the selection, choose Execute.

4. Choose Execute.

The system displays the information structure list. It contains all of the data that the reporting program has read from the
fields contained in the information structure.

5. Double click on the entry you want to access the archive directly. If more than one view is defined for this object, a dialog
with a choice of views appears.

 Note
Depending on the archiving object, the dialog box offers a technical view or a business view or both. Multiple business
views are also possible.

6. Select the desired view and confirm with Continue.

This takes you to the table overview for the selected data object.

7. To display the table contents, click on the magnifying glass symbol for a table (similar to the display function in transaction
SE16).

Results
You are now at the lowest level of data, that is the field level for the archived object. You can take the information directly from the
table.

Next Steps
Ad Hoc Reporting

Procedure for Reloaded Archives

This is custom documentation. For more information, please visit SAP Help Portal. 76
 4/6/25, 11:39 PM

Context
After archived data has been reloaded, the system does not automatically update the archive information structures, so the
Archive Information System status display displays an error. You must therefore perform the update manually.

Prerequisite

Archived data has been reloaded into your system.

You are in Status Administration of the Archive Information System.

Procedure

1. Choose the Status per Archive view.

2. Select all of the archiving sessions whose files were reloaded (these sessions have the status Reloaded).

3. Empty the information structures for the reloaded archive files using Empty Structures. You can usually do this online.
Scheduling as a background job is not necessary.

Results
The reloaded files have now disappeared from the display. If new archive files have been created during the reload, proceed as
follows:

1. Continue with the Status per Archive view.

2. Select the archiving sessions that were created by the reload (these sessions have the comment Created by reload from
<session>).

3. Fill the information structures for the newly created archive files.

More information: Filling and Emptying Information Structures.

 Note
If you performed this sequence in reverse order, in certain circumstances, the fill status of the newly created archive files
can appear as Incorrect. If this occurs, empty all of the information structures for which the fill status is Incorrect.
Perform the steps according to the standard procedure.

Status

Use
The Status function allows you to check whether an information structure has already been filled. Using this information, you can
then fill or empty specific information structures. Furthermore, you can check the actual indexing as well as the retention of
archive files.

You can go to the status screen either from the initial screen of the archive information system or from the Archive Retrieval
Configurator (choose Environment Fill Infostructure ).

Prerequisites

This is custom documentation. For more information, please visit SAP Help Portal. 77
 4/6/25, 11:39 PM
There must be at least one activated information structure for the archiving object.

Status per Archive

This function provides a list of the available archiving sessions and the information structures assigned to them. You can see from
the list for which archiving sessions the activated structures have been completely filled.

More information: Status per Archive

Status per Infostructure

This function provides a list of the statuses of the activated information structures. From this, you can see whether an information
structure has been completely filled with all archived data or data otherwise removed from the database.

More information: Status per Infostructure

Checking Indexing

This function checks the actual indexing of an archive file, that is, it checks whether data has been passed from the source fields to
the information structure. The affected archive files are marked accordingly.

You can call the Check Indexing function from the Extras menu.

Displaying File Residence

This function checks the residence of an archive file, that is, it checks whether Archive Administration can access the file. The
affected archive files are marked accordingly. A file can only be used to fill an information structure if is accessible by Archive
Administration. Otherwise direct access to the data object is only possible with the Archive Explorer.

You can call the Display Residence function from the Extras menu.

Filling or Deleting Information Structures

Use Fill Structures to fill information structures with data from the archive.

Use Empty Structures to delete the contents of information structures.

More Information

Filling and Emptying Information Structures

Procedure for Reloaded Archives

Status per Archive

Use

The following status information is displayed:

Archiving session identification, date, and status

Information structure fill status per archive file

Description of the information structure

This is custom documentation. For more information, please visit SAP Help Portal. 78
 4/6/25, 11:39 PM
Name and status of the archive file

 Note
Choose Compress to restrict the display to the archiving sessions. This gives you a better overview when you want to select
individual sessions. This function cannot be applied to individual archiving sessions.

The traffic light displays the following statuses:

Green: The system has already filled an information structure for this session.

Yellow: The system has filled an information structure for this session, however, all of the archive files could not be fully reported.

Red: The system has not yet filled an information structure (indicated by -) or has only partially filled an information structure.

An archive file can have the following statuses:

1) Complete

This archive file has been completely incorporated into the specified archive information structure.

1) Errors

This archive file has not been completely incorporated into the specified archive information structure.

1) -

This archive file was not selected when the archive information structure was filled.

The Complete status tells you that these archive files have been searched completely for source fields. However, it does not tell
you anything about the indexing of the files, that is, whether data has actually been moved from the source fields to the
information structure. You can check the indexing with the help of the Check Indexing function in the Extras menu.

More Information

Status per Infostructure

Status per Infostructure

Use
The following status information is displayed:

Description of the information structure

Archiving object name

Archiving session identification, date, and status

Information structure fill status per archive file

Name and status of the archive files

 Note
This is custom documentation. For more information, please visit SAP Help Portal. 79
 4/6/25, 11:39 PM
Choose Expand to display the complete list of status information. This expands the list to include the fill status for the
information structure. The name and status of the archive file are also displayed. This function cannot be applied to individual
information structures.

The traffic light displays the following statuses:

Green: The system has fully reported all archiving sessions for this information structure.

Yellow: The system cannot report, or can only partially report, some of the archiving sessions for this information structure.

Red: The system has not yet reported any archiving sessions for this information structure (indicated by "-").

An archive file can have the following statuses:

Complete

This archive file was completely incorporated when the archive info structure was filled.

 Note
The status tells you that the archive file has been searched completely for source fields. However, it does not tell you
anything about the indexing of the file, that is, whether data has actually been moved from the source fields to the
information structure. You can check the indexing with the help of the Check Indexing function in the Extras menu.

Erroneous

This archive file was not completely incorporated when the archive info structure was filled.

This archive file was not selected when the archive info structure was filled.

More Information
Status per Archive

Creating Database Indexes

Use
To avoid long runtimes when archive information structures are accessed, we recommend that you create a database index for
every infostructure. The index helps speed up accesses to the database table of the infostructure. If you are using an infostructure
that does not have a database index, you can use this function to create an index.

 Recommendation
Do not create your own database indexes for SAP infostructures, because this may create problems during the transport of the
infostructures, due to naming conventions. Instead, copy the relevant SAP infostructure into your own namespace and then
create an index for the new infostructure.

Integration
The data of the infostructure is saved in the database table, which is generated when the infostructure is activated, that is, directly
in the production system. Because productive systems are protected against changes to cross-client objects (settings in system

This is custom documentation. For more information, please visit SAP Help Portal. 80
 4/6/25, 11:39 PM
change option), it is not possible to create database indexes for generated Archive Information System tables. Instead, you can use
the function described below, provided by the Archive Information System, to do so.

Features

To create a database index for an infostructure, simply define it The index will then be generated when you activate its
infostructure in the database. The index definition is stored in table AIND_STR8.

To use the function for the definition of a database index from the Archive Information System, choose Customizing Goto
Database Index .

You will see a table whose rows correspond to the fields of the index you want to define. The columns of the table have the
following meanings:

Column Meaning

Index Name Name under which the index is saved in the ABAP dictionary

Position Position of a field in the index

Field Name Technical name of the filed in the infostructure

Assign the relevant fields to the table. If you need the field MANDT (Client), then you must incorporate it manually.

Note the following when you work with database indexes for archive information structures:

Entries in table AIND_STR8 are transported automatically together with the infostructure. You only need to trigger the
transport manually if the infostructure itself is not to be transported.

If you delete an infostructure, the corresponding entries in table AIND_STR8 are also deleted.

If you remove a field that is also part of an archive index from an infostructure, you must adapt table AIND_STR8 manually,
otherwise you will encounter problems when you try to activate the infostructure.

The system only recognizes index definition entries if no database table exists yet for the infostructure. Therefore, you may
have to delete the database table of the infostructure. You can find this function in the Archive Information System under
Customizing Utilities Delete Table .

 Note
Creating or changing a database index for an already existing infostructure generally means long runtimes, because you
must deactivate the infostructure, delete the corresponding tables, activate the infostructure, and then refill it. You can
use program ASCORRINDX to make changes to database indexes without having to delete the corresponding
infostructures and fill them again. For more information about how to use this program see the corresponding program
documentation.

Example
The index definition for the standard infostructure SAP_FI_DOC_002 contains the following rows:

Index Name Position Field Name

LIF 10 MANDT

LIF 20 LIFNR

This is custom documentation. For more information, please visit SAP Help Portal. 81
 4/6/25, 11:39 PM

LIF 30 BUKRS

REF 10 MANDT

REF 20 AWKEY

When you activate the infostructure a database table with two indexes is creates: The index LIF contains the fields MANDT, LIFNR,
and BUKRS (in that order), and the index REF contains the fields MANDT and AWKEY.

Partitioning

Use

The database tables that are generated when you create new archive information structures can become extremely large over the
duration of their usage. This puts an increased pressure on the database and makes it more difficult to handle the infostructures
and tables. To combat this effect, you can use partitioning to divide up the infostructures in such a way that the system distributes
the data across several tables instead of writing it into one single table. This facilitates the administration of the database, which is
more difficult with large data volumes.

Features
Configuration of Partitioning

You can call partitioning from the Archive Retrieval Configurator (transaction SARJ) by entering an infostructure and choosing
Goto Partitioning .

To configure the partitioning function, in the From Date field, enter the date as of which the system is supposed to write the entries
for the infostructure into a new table. The date refers to the creation date of the archiving session. If required, you can also enter
the name of the table that is to be generated in the Table Name field. If you do not want to specify a name, the system
automatically generates a table name that corresponds to the infostructure. The tables are not generated until the first data record
is written, which would be either during the delete phase or during the subsequent filling of the infostructure.

 Example
The following configuration data has been entered for partitioning:

From Date Table Name

01.01.0001

01.02.2005

14.04.2005

Based on these entries, the system would generate a separate database table for the following time periods: "Until 01.31.2005",
"02.01.2005" until "04.13.2005"and as of "04.14.2005".

For a detailed example of a partitioning scenario, see Example: Partitioning an Infostructure.

 Caution
The configuration entries for partitioning logically belong to the infostructure. This means it is cross-client and is transported
and shipped together with the infostructure. Changing the configuration settings means a modification of the infostructure.

This is custom documentation. For more information, please visit SAP Help Portal. 82
 4/6/25, 11:39 PM
Therefore, never change the partitioning of infostructures that are not part of your namespace. This particularly applies to the
SAP infostructures (those shipped by SAP) in customer systems. For more information, see Copying Infostructure Data.

The partitioning concept is so flexible that you do not have to specify that partitioning is to take place from the outset. In the case
of large data volumes, rebuilding the infostructure would be very resource intensive. This means that data that has already been
built does not need to be changed. All accesses to the Archive Information System remain intact. This applies to the Archive
Explorer and to programmed accesses with the function module AS_API_READ or other interfaces to the Archive Information
System.

Predefining Tables

In addition to partitioning you also have the option of predefining a table or several tables for a specific infostructure. This has the
following advantages:

The name of the predefined table is determined when configuration takes place. You can choose a name from within your
namespace or a name that matches your requirements. If you do not specify a table name the system automatically
generates a name, which you cannot influence.

The table you specify is generated in the development or Customizing system and is then transported to the production
system. This allows you to still make changes to the table, such as other technical settings or a different short text. In
addition, the table has the same name in all systems, which is not the case for the automatically generated AS tables
(ZARIX tables). This facilitates the administration of the system landscapes.

When you specify a table in the configuration, the system checks whether this table already exists. If so, it checks whether the
table matches the infostructure and rejects the entry you made if necessary. If the table does not exist, the system asks you
whether you want to generate the table. If you say yes, the table is generated in such a way that it corresponds to the infostructure.

 Note
We recommend that you always instruct the system generate these tables. This means you can be sure that the structure of the
table always matches the infostructure. We also recommend that you enter the same data for the object directory entry as that
of the infostructure. This is particularly important for package assignments.

Displaying Partitioning

You can use the display function to view the current settings of the partitioning of an infostructure. You can call up the display
function from within the status management of the Archive Information System by choosing Goto Partitioning or from within
the display of an infostructure in Customizing by choosing Technical Data.

Partitioning Configuration

This area on the display screen shows how partitioning was configured.

Current Partitioning

This area shows which tables the system used during which time periods so far. For the time periods that were entered in
the configuration and that appear in this area, the system uses the assigned table also in the future. When the first record
for the corresponding interval is written to the infostructure, the system sets the Change On date for that particular table.
The entry that does not have a change date contains the table that was generated when the infostructure was first
activated (normal AS table). This table only serves as a reference structure for partitioned infostructures.

Tables that have the G (Generated) indicator, have been generated.

If an entry only has the indicator N (Read Only) indicator, it means that the Archive Information System does not write any
more entries to this table. It only reads from this table. This happens when you change partitioning, by, for example,

This is custom documentation. For more information, please visit SAP Help Portal. 83
 4/6/25, 11:39 PM
grouping several time periods together. this is the case, the system sets the tables used up until then for the individual
tables to read only mode.

Assignment of Tables and Files

This area shows all the archive files that have entries in the infostructure. It lists the corresponding tables where the entries
can be found. This relationship is unique. A table always contains the complete set of entries of an archive file. The system
uses this information especially for the deletion of infostructure contents.

See also:

Example: Partitioning an Infostructure

Copying of Infostructure Data

Use
You can use this function to copy data from one infostructure to another.

Similar to other standard objects in the SAP system, SAP infostructures cannot be changed without running the risk of a
modification. This also includes changes to the partitioning of SAP Infostructures. If, however, a SAP Infostructure contains data
that you want to copy, you must delete all that data and rebuild it, in order for the data to be copied to one of your own
infostructures. This procedure is possible, but, depending on the amount of data to be copied, can take a long time.

A good alternative for your purpose is the function for copying infostructure data.

Prerequisites
The prerequisites must be fulfilled so you can copy data from one infostructure to another.

The target infostructure already exists. The system only copies the data from source infostructure, not the definitions of the
data.

Both infostructures are consistent. This applies to the definition of the infostructures and for their fill status. The copying of
infostructure data is not a correction program.

The source infostructure may not have a predefined table in the partition configuration. f the source infostructure lies
within your own namespace (such as a customer-specific infostructure), you first remove this table from the configuration
of the source infostructure. After you have copied the data you can enter this table in the configuration of the target
infostructure.

The source infostructure contains all the fields of the target infostructure. In addition, all the key fields of the target
infostructure must also be key fields of the source infostructure. Note that the target infostructure may have fewer fields
than the source infostructure.

The field types of the target infostructure correspond to the field types of the source infostructure. This only applies to the
technical field types. The data elements may be different, but not the field length.

The target infostructure should be empty.

 Recommendation
To avoid functional changes or problems when using the AS modules, we recommend that you fill the target
infostructure on the basis of the same field catalog as that of the standard infostructure that you want to copy.

This is custom documentation. For more information, please visit SAP Help Portal. 84
 4/6/25, 11:39 PM

Features
You can call this function from within the Archive Retrieval Configurator (transaction SARJ) by choosing Utilities Copy Data
or by executing the program AS_DATA_MOVE.

To copy the data you need to enter a Source Infostructure and a Target Infostructure.

Executing this function only takes a few seconds. It may, however, take longer, if the infostructures contain several thousand
archive files, for example. However, the runtime does not depend on the number of entries in the infostructures. After you have
executed the program, the source infostructure is empty and inactive. The target infostructure contains the data of the source
infostructure and is active if it was active before, or if the source infostructure was active.

The data transfer does not actually take place through copying, but rather by "moving" the tables. The system simply assigns the
tables of the source infostructure to the target infostructure by entering the tables of the source infostructure into the current
partitioning of the target infostructure and adjusting the status administration. For this simple moving of data to take place,
however, the above prerequisites must be fulfilled.

Example

You have an active SAP infostructure that already contains a large amount of data. This infostructure does not use partitioning and
does not have any predefined tables. You want to copy the data of an SAP infostructure to one of your own infostructures. To do
this, proceed as follows:

1. In the development or Customizing system (the system in which you make the developments and changes that are not
permitted in the productive system) you create your own infostructure. The new infostructure should look exactly like the
infostructure to be copied.

2. You make the desired changes to the new infostructure. In particular, you can configure the partitioning.

3. You transport the new infostructure into the productive system and leave it as inactive.

 Note
Make sure that during the next step no archiving session, delete session, or filling of an infostructure takes place for the
archiving object in question.

4. In the productive system, you copy the data of the SAP infostructure to the new infostructure (see above).

As a result of this procedure, the infostructures now have the following characteristics:

The SAP infostructure is The new infostructure is

Inactive Active

empty and without references to any tables. Filled for those archive files for which the SAP infostructure was
built

See also:

Example: Partitioning an Infostructure

Example: Partitioning an Infostructure

Use
This is custom documentation. For more information, please visit SAP Help Portal. 85
 4/6/25, 11:39 PM
You have an infostructure that already contains a large number of entries. The related ZARIX table is becoming to large. Since the
infostructure has not been partitioned yet, you want to do so now.

You want to change the infostructure so that no more data can be written to the existing table. You also want to set up the
partitioning so that the data for the current year, the last two years, and the next three years are written to a separate table.

To do this, proceed as follows:

1. Configure partitioning in the development or Customizing system (the system in which development and changes that are
not permitted in the live system take place) as follows:

From Date Table Name

01.01.0001

01.01.2003

01.01.2004

01.01.2005

01.01.2006

01.01.2007

01.01.2008

a. You transport these settings to the live system. It does not matter whether you enter the changes to the partitioning
configuration in a transport oder or whether you transport the infostructure from somewhere else. A complete
definition of the infostructure is always sent to the target system.

b. Continue archiving in the live system as usual.

After you have transported the configuration to the live system, the partitioning of the infostructure looks like this:

From Date To Date Table Name Change Date G N

01.01.0001 31.12.9999 ZARIXBC62 X

The infostructure is not partitioned yet. Table ZARIXBC62 is already a very large database table for the existing
infostructure. As long as you do not make any new entries in the infostructure, read access is from this table only. Not until
further set up of the infostructure does the system generate a new table, which it then fills. It is ensured that the system
does not add any additional data to the old table since the configuration of the partitioning covers the entire period for
which data can be entered. After an additional archiving session, partitioning could look like this:

From Date To Date Table Name Change Date G N

01.01.2005 31.12.2005 ZARIXBC64 28.06.2005 X

01.01.0001 31.12.9999 ZARIXBC62 X

The system has now generated database table ZARIXBC64 for the period from 01/01/2005 to 12/31/2005 that is
specified in the configuration. In 2006 the system will create the next table. Read access is possible from both tables.

This is custom documentation. For more information, please visit SAP Help Portal. 86
 4/6/25, 11:39 PM
You have two options for how to proceed: Either you use partitioning only for new entries to the infostructure or you ensure
that old entries are entered according to partitioning.

Partitioning for new entries only

In this case you do not need anything. New entries are written automatically to the infostructure according to
partitioning. When you delete the infostructure for older files, the system recognizes that these entries are still in the
old table ZARIXBC62. Once the infostructure is no longer set up for old files, then table ZARIXBC62 is empty and
the actual partitioning corresponds completely to the configuration.

Information from the configuration relating to the period prior to 2005 is not required for this scenario.

Partitioning for all entries

If you also want the partitioning to correspond to the configuration for the older files, you need to delete the
infostructure for all old sessions and then recreate it. In this case, the system uses the configuration entries for the
periods prior to 2005 and generates the relevant tables.

However, this procedure is usually not necessary and therefore we do not recommend it. It is necessary only if the
old table cannot be handled, even if no more new entries are made to it.

It is possible to combine both methods or to do a partial implementation.

After a conversion, you can remove empty tables that are no longer needed by deactivating the infostructure and
then immediately reactivating it. The system deletes tables that have been created unnecessarily.

Archive Retrieval Configurator

Use
The ARC allows you to create and configure information structures that are required by the Archive Information System (AS) to
execute archive searches.

Features
Creating Archive Infostructures

You use this function to create a new information structure based on application-specific field catalogs.

More information: Creating an Information Structure

Activating an Information Structure

With this, you can activate an available information structure so that during a subsequent archiving program delete phase of the
archiving object it automatically fills with data from the archive.

More information: Activating and Deactivating Information Structures

Filling Information Structures

This function allows you to fill an information structure with data from the available archives if the delete program has already
processed those archives. Normally this is not necessary because activated information structures are filled automatically during
the archiving program delete run.

More information: Filling and Emptying Information Structures

This is custom documentation. For more information, please visit SAP Help Portal. 87
 4/6/25, 11:39 PM
Field Catalogs

This function enables you to create new field catalogs or change customer-specific field catalogs.

More information: Field Catalogs

Other Functions

Additional ARC functions allow you to empty, deactivate, change, display, and delete archive information structures.

Field Catalogs

Use
A field catalog includes all of the fields that can be selected when creating or maintaining an archive information structure. You can
use it to specify which fields are incorporated in the information structure, and whether they should be key fields or data fields. You
can decide whether key- or data fields should be incorporated into the information structure. The fields contained in a field catalog
are always archiving object-specific.

You can create new field catalogs and edit existing ones.

 Note
Standard catalogs, which are designed to cover most application requirements, are supplied with the standard system's archive
information system. You should therefore create your own field catalogs only if the fields contained in the standard catalogs do
not meet your requirements.

 Note
If the standard transaction in the application permits only standard SAP field catalogs, the system does not take customer-
specific field catalogs into account.

Prerequisites
You need to have some expert knowledge to use this function. For example, you should be familiar with the data model of the
archiving object up to table level.

Features
Editing Available Field Catalogs

You can change the definition of the available field catalogs, for example, by adding further source fields or changing the allocation
of data- and key fields. The procedures for creating field catalogs are applicable in this case (see below).

 Note
You must copy a standard field catalog from the SAP namespace into your own namespace before you make any changes to it,
that is, before you change it to a customer-specific catalog. All entries that begin with "SAP" belong to the SAP namespace and
you should not make changes to them.

Creating New Field Catalogs

This is custom documentation. For more information, please visit SAP Help Portal. 88
 4/6/25, 11:39 PM
To create a new field catalog, you have the following options:

Use fields from a source table

Use fields from multiple source tables

For more information, see Creating Field Catalogs (One Source Table).

Deleting Field Catalogs

Before you delete a field catalog, you must first delete all of the archive information structures that use this field catalog. A
deletability check prevents the deletion of catalogs that are still in use. If you try to delete an SAP standard field catalog, the
system issues a warning message to this effect.

Creating Field Catalogs (One Source Table)

Procedure

1. In the initial screen of the Archive Retrieval Configurator (ARC), choose Environment Field Catalogs and then New
Entries.

2. Enter the name of the field catalog (it cannot begin with SAP), a description, and the archiving object for which the field
catalog is intended.

In the fields File in Index and Offset in Index, you can specify how the name of the archiving file and the offset of the data
object are included in the information structure. You can use the following values:

Values for file names

Value for file names Description

D Includes the file name as a data field. This is the minimum

value. It causes the archive file name to be entered in the
data area of the structure table.

K Includes the file name as a key field. Select this value if the
entries in the table would otherwise not be unique.

Values for the offset

Value for offset Description

D Includes the offset name as a data field. This value is

sufficient for a direct access to archived data.

K Includes the offset name as a key field. Select this value if

the entries in the table would otherwise not be unique.

No value The offset is not included in the structure table. Choose this
setting if you do not want direct access. This allows you to
reduce the size of the structure table.

This is custom documentation. For more information, please visit SAP Help Portal. 89
 4/6/25, 11:39 PM

 Note
If you include the offset as a key field, you must also include the archive file as a key field, otherwise a clear distinction
between archived objects by the offset cannot be guaranteed. If an archived object, such as a sales document, has
already been clearly identified by the document number in the field catalog key, then you do not need to include the
offset in the key.

3. To perform the field assignment, first select the catalog and then the Field Selection node in the navigation area. Choose
New Entries and enter the required data.

You can choose the field number and target field yourself. The name of the target field appears in the generated
table and should have a definition that makes sense for reporting. The field number describes its position in the
information structure and serves as a sort criterion.

However, the source field must correspond with the actual field name from the source table.

The source field entered directly in the field selection is also the reference field. The data type of the relevant field in
the information structure is derived from this reference field.

The source table must be a table for which the archiving object in the information structure writes data to the
archive. These tables are maintained in the transaction AOBJ for the archiving objects.

If you mark a Key field, that field is included in the key to the structure table. A table's key fields must come at the
beginning, that is, the field numbers of the key fields must be smaller than the field numbers of the data fields.
Furthermore, the key fields must be connected, that is, no non-key fields are allowed to come between key fields.

The Mandatory Key Field checkbox is valid only for key fields. If you select this checkbox, the data record will be
included only if the relevant field in the source table is not empty.

 Note
Tables that are processed by archiving classes can also be used as source tables. However, to do so, you must create a
normed read function module for each archiving class used.

4. Save your entries.

Creating Field Catalogs (More than One Source Table)

Prerequisites

You have created a field catalog with at least one field.

You are at the field selection for the field catalog.

Context

You can add additional source fields to field catalogs. This means:

For key fields, the system establishes field similarities between the join conditions of the different source tables.

The system can fill data fields with data from different source tables in an archive information structure.

Note the following special features:

For each source table, there must be a unique combination of fields in the key of the information structure. This means that
there can never be two data records with the same value combination within one data object.

This is custom documentation. For more information, please visit SAP Help Portal. 90
 4/6/25, 11:39 PM
For each key field, the system establishes the field similarity between the reference field and the additional source fields.

The system fills the information structure with archive data using an outer join based on the field combination. The system
writes a record for the data object if at least one of the source tables contains data.

When the system is filling an information structure, an incorrectly defined field catalog can cause a program termination.
Read the long text in the error message Q6234. Here you can also find a detailed example of how to create field catalogs.

The source field entered directly in the field selection is also the reference field. The data type of the relevant field in the
information structure is derived from this reference field. The fields entered in Additional Source Fields must be
compatible reference field type.

Procedure

1. Choose the field to which you want to add source fields.

2. In the navigation frame, choose the Additional Source Fields node.

3. Choose New Entries and enter the source table and the source field that are to be joined with the target field.

4. Save your entries.

Results
There is now a logical link (join) for key fields between the target field and the additional source field. When the system fills the
information structure, it moves the contents of the source fields assigned to the target field to the data fields.

Archive Explorer

Use
The Archive Explorer enables you to search for archived data and allows individual objects to be displayed from the archive.

Integration
You can go to the Archive Explorer from either the initial screen of the archive information system or from the Archive Retrieval
Configurator (choose Environment Archive Explorer ).

Prerequisites
To use Archive Explorer, you need to perform the following activities:

Create a suitable archive information structure

Activate the information structure

Fill the information structure

Features
On the Archive Explorer selection screen, the fields appear as in the archive information structure.

This is custom documentation. For more information, please visit SAP Help Portal. 91
 4/6/25, 11:39 PM
In the selection screen, you can define which archived data should be read by the Archive Explorer reporting program. An object
list from the set information structure is displayed as a result of this selection, from which you can access single data objects in
the archive.

A standard viewer is available to display the data objects. Independent of the underlying archiving object, there are also
application-specific viewers. The interface used can also be used for customer-specific extensions.

Activities

Report information structure

More Information
Creating an Information Structure

Activating and Deactivating Information Structures

Filling and Emptying Information Structures

Reporting

Use
You can use this function to report from the archive information structure that was created for the selected archiving object.

Prerequisites
You have created and built the archive information structure to be reported.

Features
Depending on the selection criteria entered, the system displays an object list for the archive information structure. You display a
data object by accessing the archive directly. If an application-specific view is realized for the archiving object used, you can
choose between the technical or the application-specific presentation of the data objects.

Activities

Reporting Information Structures

More Information
Ad Hoc Reporting

Ad Hoc Reporting

Use

This is custom documentation. For more information, please visit SAP Help Portal. 92
 4/6/25, 11:39 PM
You can use this function to report from the archive information structure that was created for the selected archiving object,
without this structure having to be filled first .

Prerequisites
The archive information structure to be reported has been created and activated.

Features
Depending on the selection criteria entered in the selection screen, an object is displayed for the set archive information structure.

To display a data object, the system accesses the archive directly. If an application-specific view is realized for the archiving object
used, a dialog box appears in which you can choose between the technical or the application-specific presentation of the data
object.

Unlike the standard reporting function, which requires that the archive information structure is filled with data from the archive,
the ad hoc reporting function reads directly from the archive. This enables you test archiving and report archived data that has not
yet been deleted from the database.

Activities
Report information structure

More Information
Report

Using List Variants

Use
In the Archive Explorer, you can save list variants with which you specify, for example, a selection of fields to be displayed.

Integration
You can operate the variant functions using the menu entries and function buttons of the SAP List Viewer.

Features
You can create both user-specific and cross-list variants to display the data for an archive information structure as well as the table
contents (as part of the technical view).

List Variants for Archive Information Structures

In the display of information structure data (the first list in the Archive Explorer), list variants are stored per archive information
structure. A list variant is only valid for the archive information structure for which it was created and cannot be used for other
archive information structures.

Once an archive information structure has been changed (but has kept the same name), the related list variants can still be used.
However, a list variant can be invalidated by the change, for example, where the field displayed in the list variant has been deleted

This is custom documentation. For more information, please visit SAP Help Portal. 93
 4/6/25, 11:39 PM
from the archive information structure. You should therefore modify the list variants accordingly.

 Example
Example: When you display the archive information structure CO_ORDER_001, use the list variant MY_VARIANT to specify that
the fields AUFNR (Order Number) and KTEXT (Short Text) are to be displayed. You cannot use these variants for the archive
information structure CO_ORDER_002, even if both archive information structures have identical structures.

If the archive information structure CO_ORDER_001 is changed so that the fields AUFK and KTEXT no longer appear, then the
list variant MY_VARIANT can still be used. However, is pointless as no fields are displayed. You can therefore modify these
variants using the relevant function of the ALV to fit the changed archive information structure.

For the archive information structure CO_ORDER_002, you can also create a list variant called MY_VARIANT. However, this is
not identical to the list variant of the same name for CO_ORDER_001.

List Variants for Tables

The technical view for single document display is used to display the table contents for the selected data objects. You can save list
variants per table here, which are independent of the archive information structure used. A list variant created for a specific table is
only valid for this table and cannot be used for other tables. However, a list variant for a specific table is always independent of the
archive information structure used. This is also valid where the archive information structure belongs to different archiving objects.
Therefore, it does not matter which archiving object was used to archive the table entries.

 Example
Example: You are using the archiving objects SD_VBAK and PP_ORDER and the related archive information structures
SD_VBAK_001 or PP_ORDER_001. Both archiving objects contain the table COEP. To display the table COEP, save the list
variant MY_VARIANT in the Archive Explorer. In contrast to the above list variants, this variant is only assigned to the COEP
table.

You can then use MY_VARIANT to display the COEP table, and it does not matter whether you enter the Archive Explorer via
the archive information structure SD_VBAK_001 or PP_ORDER_001.

Activities

In the Archive Explorer list display, you can access the list variant functions. Choose Settings Display Variants .

More information: Documentation about the SAP List Viewer

Archive File Browser

Use

Archive File Browser (AFB) provides functions for displaying the contents of archive files. It offers a technical view of the archived
tables in much the same way as the Data Browser does for data from the database.

Implementation Considerations

The AFB is a technical tool for data archiving administrators and anyone who needs to investigate problems with data archiving
and in archived data.

This is custom documentation. For more information, please visit SAP Help Portal. 94
 4/6/25, 11:39 PM
The data is only displayed in technical form, there is no business view formatting. The system structures the data from a technical
point of view according to session, file and data object. AFB ignores application-specific connections (such as logical data objects
that are composed from several technical data objects). Some archived structures (for instance COVP11) do contain the actual
data for particular database tables (for example, COEP and COBK).

Integration
You do not need to make any system settings in Customizing to be able to use the AFB.

Make sure that the user has the necessary authorizations, and that it is possible to access the archive files.

For more information, see Archive Files.

To accelerate the start of the AFB, you can set the selection of archive files for the start of the transaction.

More information: Speeding up the Start of the AFB.

Features
Displaying the Contents of Archive Files and Archiving Sessions

The AFB displays archived files. The way the data is structured corresponds to the structure in the archive. Evaluations of
archived tables together with data in the database are not offered.

More information:

Archive Files.

Displaying Data Object.

Searing for archived data

In addition to a search for archive files, a technical search for field contents is also possible in which the AFB searches for
the contents of fields in a table (similar to transaction SE16).

When making the search, the AFB always reads through the files and focuses on finding missing data. The focus on
completeness, even at the cost of poor performance.

More information:

Searching for Table Contents

Searching Efficiently for Table Entries

Constraints
The search for data in the AFB is not intended for the retrieval by end users, but for finding missing data.

When searching for data in the AFB, no index of the archived data is constructed. To do so, use the Archive Information
System.

Comparison with the Archive Information System

Archive Information System (AS) Archive File Browser (AFB)

The main focus is on creating an index for archive files. This When searching for the contents of archive files, the AFB reads
index can be used to find archived data quickly. through the area to be searched sequentially.

This is custom documentation. For more information, please visit SAP Help Portal. 95
 4/6/25, 11:39 PM

Archive Information System (AS) Archive File Browser (AFB)

Search is only possible using specific criteria (fields in info Search is possible using any fields
structures)

The index can be used by applications such as the Document No comparable interface
Relationship Browser or line item reports for cost accounting to
access archived data quickly.

To access archived data, you have to first create and activate an Access to archived data is possible immediately.
info structure. In the production system this usually involves
time and effort.

Business views, consequently also of interest to end users Technical representation of data, only of interest to
administrators

Archive Files

Definition

The AFB operates using data objects. An archive file is divided into a header and several data objects. A data object is often an
instance of the business object that corresponds to the archiving object.

 Example
For archiving object SD_VBAK the data for an individual sales order is saved in one data object. However, this type of
correspondence does not have to apply to every archiving object.

Structure

A data object always consists of exactly the data that is written to the archive by the write program between calling up the function
modules ARCHIVE_NEW_OBJECT and ARCHIVE_SAVE_OBJECT. Consequently, everything that can be read between the first and
second call up of function module ARCHIVE_GET_NEXT_OBJECT belongs to the same data object.

The AFB operates using these data objects. Except for the hex display, the AFB always displays exactly one object. During the
search, the system looks for data objects that correspond to particular criteria.

You can specify a data object by entering the archive file and the offset, or by entering the archive file and the number of the data
object. In the AFB there is always a current data object that is represented at least by the entry of archive file and offset. The
system often displays the number of the data object in addition. All displaying functions and functions for relative navigation (
Next File, Previous File, Continue) relate to the current object.

Sequence of archive files

The AFB always arranges archive files and data objects according to the same pattern. The data is sorted according to archiving
object, session and archive file key. The runs are always displayed in descending order, so that the most recent runs are at the top.

The AFB sorting rules:

Files are arranged alphabetically in ascending order according to their archiving objects.

More recent archiving runs come before older ones

This is custom documentation. For more information, please visit SAP Help Portal. 96
 4/6/25, 11:39 PM
Within the sessions the files are in ascending order

Use of this sort order:

In the archive file overview

When searching in the list of the files to be searched

During the search the files are dealt with in this order

For the functions for relative navigation ( Next File, Previous File, …) this sequence is used as the basis.

Authorization checks

In addition to checking the authorization to access the archive (authorization object S_ARCHIVE), checks have been implemented
in the AFB that allow or forbid the display of archived data in a similar way as for the Data Browser (transaction SE16). This
involves the display authorization for authorization object S_TABU_DIS. The authorization to display data from a table should not
change due to it being archived. The same should apply for archived data as for data from the database.

Required authorizations for different areas

Area Prerequisite

Data Object User requires display authorization for the table to be displayed.
This means not all data is necessarily displayed for a data object
(you receive corresponding messages in the log).

If the user does not have authorization for any of the tables of the
data object, then nothing is displayed for the current data object.

Table User requires display authorization for the table. Only those tables
for which the user has authorization can be displayed.

Hex display User requires display authorization for all tables that relate to the
archiving object of the file to be displayed.

If the user lacks authorization for one or more tables then nothing
is displayed for the archive file.

Search A user can only search for the content of tables for which he or she
has authorization.

Displaying Data Objects

Context
You want to display a data object with AFB.

Procedure

1. Expand the navigation tree in the archive files overview until you can see the key for the archive file you want.

2. By double-clicking the key of the archive file call up the first data object of this file. On the Data Object tab page, you will
see the data object with an overview of the table entries it contains.

This is custom documentation. For more information, please visit SAP Help Portal. 97
 4/6/25, 11:39 PM
3. Use the scroll keys to navigate to other data objects.

User Interface for the Archive File Browser

Use
The user interface is made up of the following areas:

Interface Area Description

Archive files overview Overview divided according to archiving object, session, and file.

More information: Archive Files Overview

Header information This area shows you which archive file and which data object are
displayed.

More information: Header Information

Scroll keys For navigating in the data objects and files.

More information: Navigation

Display area To display data. Here you see the content of the archive file in the
desired view. In this area you can define and execute a search.

More information: Display Area

Messages Collection of notifications and error messages that are generated.

More information: Messages

Archive Files Overview

Use
On the left side of the screen, the system displays an overview of the archive files in the form of a tree structure. The files are
grouped according to archiving object and archiving session. The files themselves are the end nodes of the tree structure.

You can set the fields displayed and also influence the quantity of archive files displayed using a filter function. You can also
determine an initial layout (including filter criteria).

For an overview of the screen areas in AFB, see User Interface.

Features
Double-click on an archive file in the overview to open a file. The first data object in this file for the current data object appears in
the display area. In the case of functions that select a data object (relative navigation, find), the system expands the archive file for
the current data object in the overview and selects it.

You can show the following fields in the archive files overview using the layout editing:

Fields in the archive file overview

This is custom documentation. For more information, please visit SAP Help Portal. 98
 4/6/25, 11:39 PM

Field Description

Number Number of data objects in the archive file The system automatically
totals this number at the archiving sessions level. The total refers
only to the files in the overview; not to all of the files in the system.

If, for example, you have set the filter so that only archiving
sessions from a certain creation data are displayed, then the total
at archiving object level contains only the data objects of the files
for these sessions, and not for every file of the archiving object.

The AFB obtains the number of objects from archive

administration. When certain errors occur, you may find that these
differ from the actual number of objects in an archive file

User Name of user who started the archiving. This field remains blank on
archiving object level.

Size (MB) File size in MB, shown to three decimal places. This number is
determined from archiving administration, and may (like the
number of data objects) differ from the actual size in certain
circumstances.

The file size is totaled at the level of the sessions and archiving
objects, using the same mechanism as for the number of data
objects.

Description The texts for the relevant object are displayed depending on the
level in the tree structure:

Level

Displayed Text

Archiving Objects

Description of the Archiving Object

Archiving Sessions

Comments about the archiving session that can be entered for

some archiving objects when scheduling the write program.

Archive Files

Comments on the file that can be changed in archive

administration.

Date Creation date of the archive session or archive file.

This field remains blank on archiving object level.

Time Creation time of the archive session or archive file.

This field remains blank on archiving object level.

Activities
Layout of the Archive Files Overview

The layout of the archive files overview contains the selection of the tree structure columns (except the hierarchy column), and
also the sequence and width of the columns. In addition you can also save the current filter criteria with the layout.

This is custom documentation. For more information, please visit SAP Help Portal. 99
 4/6/25, 11:39 PM
The layout editing contains the following functions:

Layout Function

Select Choose a layout already saved, with filter criteria if appropriate, and
use on the overview.

Change Change the current field selection and field sequence.

Save Save the current layout. You can choose whether you want to save
the layout user-specific or cross-user, and whether the system
should save the filter conditions with the layout.

Manage Manage the saved layouts. In particular, you can delete a layout and
select a layout as a default. The effect of the default is that when
you next start the AFB, this layout is used automatically, together
with any filter conditions.

Filter in the archive file overview

The AFB loads certain data to the main memory for each file that is displayed in the overview. Consequently, the time taken to
start the transaction and also the memory usage depend very much on how many archive files are being processed. You can use
filters to influence this quantity.

To change the current filter criteria, choose Set Filter.... You can choose any field that is displayed in the overview as a filter
criterion, this includes the archiving object, session, or file key. The system always uses all criteria directly for the selection of the
archive files. This means that both the creation date and time relate only to the archive files. The Name field refers only to the
comments for the archive file. File size and number of objects refers to the number of archive files, and not to the totals at higher
levels.

It is possible to save the filter criteria when you save a layout. When you choose a layout or start a transaction with a predefined
layout, the system uses the related filter.

For more information, see Speeding up the Start of the AFB.

Header Information

Use
The header information contains the current data object. For an overview of the screen areas in AFB, see User Interface.

Features
In the header information, you can place the cursor directly on a particular data object within an archive file.

Header Information Fields

Field Description and Notes

Archive File Archive file for the current data object

This archive file is also expanded and selected in the archive file
overview unless this selection has been changed manually or you

This is custom documentation. For more information, please visit SAP Help Portal. 100
 4/6/25, 11:39 PM
are currently evaluating a background search and the hit is not
located within an archive file from the overview.

Data Object The number of the current data object within its archive file

This field usually displays a value between one and the number of
data objects in the archive file. In the Hex Display, you may also
find data object number 0 (zero). Then the beginning of the archive
file is displayed. If you enter the offset of a data object directly in
the field Offset, then Unknown appears in the Data Object field.
The field is ready for input as soon as a data object has been
selected for the first time.

 Note
You should note that direct entry can entail a long runtime, as
the archive file may be read sequentially.

From Number of data objects in the archive file

Offset Offset of the current data object

To find a data object as quickly as possible, enter a value in the

Offset field.

 Note
Note that if you enter the offset direct, the functions Previous
Data Object and Next Data Object can no longer be used.

Display Area

Use
The AFB offers three different views in the display area of the current data object or the archive file currently being displayed.

The Data Object view represents all of the tables entries for the data object.

The Table view represents an individual table of the archiving object.

The Hex Display represents the content of the archive file in a highly technical form without additional formatting.

For an overview of the screen areas in AFB, see User Interface.

Features
Data Object

In the Data Object view, the system formats the archive file content in such a way that the content of all table entries for the
current data object is visible. The table entries are displayed in the same form as they are found in the archive. You receive a list
where the table name is in the first field, followed by the content of the relevant entry formatted as a character string.

The list is displayed using the SAP List Viewer and offers its standard functions.

 Note

This is custom documentation. For more information, please visit SAP Help Portal. 101
 4/6/25, 11:39 PM
Note that the standard functions of the SAP List Viewer refer only to the current data object. A search is then made using only
the data of the current data object.

For the display, the system formats every table entry as an individual character string. This means special attributes for the
individual fields are lost. You may find that a table is too wide to be displayed in its entirety. By double-clicking you can obtain field-
by-field formatting of the corresponding record.

 Note
If you want a different format for a particular table, select an entry for the required table and switch to the Table view. The
system then automatically displays all entries for this table from the current data object.

The table entries are displayed in this view in the same order as they were written to the archive, unless the data was saved using
archiving classes. Data for archiving classes is displayed with the other data for the current data object in accordance with the
entries that were not saved using archiving classes.

Table

The Table view displays the entries for the current data object that relate to a particular table. The data is formatted field-by-field.
The view of the table is similar to that of the Data Browser (transaction SE16).

The list is displayed using the SAP List Viewer and offers its standard functions.

 Note
Note that the standard functions of the SAP List Viewer refer only to the current data object. A search is then made using only
the data of the current data object.

In the Table Name field, you enter the name of the table for which you want to see the entries. You will usually find this field has
already been defined if you have already selected a data object.

You can use the input help to receive a selection of all tables that are archived with the archiving object for the current file. In the
event that no data object has been selected, you receive all tables for all archiving objects in the archive file overview. If you enter
the table directly, you have to choose data release to refresh to list.

 Note
Choose Settings Technical Field Names or Field Labels to switch between the display of technical names and field labels,
as required. This affects all parts of the AFB in which field labels occur, for example, in a search.

Depending on the view with which you previously looked at the current data object, the table name is predefined as follows:

· In the Data Object view, one entry is usually selected. The table for this entry is displayed with the Table view.

· The search switches automatically to the Table view at the first hit. The table, which is also used in the search criteria, is
displayed.

· In all other cases, the table name is predefined in such a way that the table is suitable for the archiving object of the current data
object. If the table no longer matches the archiving object through navigation to a data object for a different archiving object, then
the system selects a new table.

If you branch from the Table view to the search but have not yet selected a table for the search criteria, the system automatically
transfers the table being displayed.

This is custom documentation. For more information, please visit SAP Help Portal. 102
 4/6/25, 11:39 PM
Hex Display

The system presents the content of the archive file in raw format in the hex display,

 Note
This view is particularly useful if you want to look at the archive file header, or if the file is defective and this is the only way you
are able to display it.

The data in the file is represented in hex format (00 to FF for every byte). In the first column you see the offset in the archive file for
the first byte in each line. 32 bytes then follow in every line, in eight groups each having four bytes. In the area on the right, you can
see the equivalents in plain text. The respective character coding is taken into account (including unicode). This means it is
possible that only 16 characters (for example) relate to the 32 bytes As the data in the archive file is present in compressed form,
the header can only be recognized from the plain text representation at the beginning of the archive file. It is not possible to
recognize the data itself this way.

The part of the archive file that is displayed is determined by the offset and the number of displayed bytes. The system uses the
offset displayed in the header information. In this way, all navigation functions can also be used for the hex display.

 Note
The hex display recognizes the data object with the number 0 that represents the beginning of the file.

You can enter the number of bytes displayed in the Area Displayed field on the Hex Display tab page.

Analysis of Defective Files

You can use the hex display to analyze defective files that you are not able to display with the other views. To do this, you have to
have detailed and extensive knowledge of the structure of the archive files. The hex display bypasses the usual mechanism for
accessing files (meaning the function modules for the ADK). However, no files can be analyzed this way that are found in the
archive store ( SAP ArchiveLink).

Messages

Use

Each message or error message that is generated during a session with the Archive File Browser is collected in a log in the lower
area of the AFB. For an overview of the screen areas in AFB, see User Interface.

 Example
Examples of errors include error messages when accessing archive files or the message at the end of the search.

Features
The messages are displayed in the log as a list, with the latest message at the top.

Log Line Fields

Field Meaning

Type Severity of the Message

This is custom documentation. For more information, please visit SAP Help Portal. 103
 4/6/25, 11:39 PM

Message Context Information about the archive file relating to the message

If the message cannot be assigned directly to an archive file, then

the action which triggered the message is displayed.

Message Text Message short text

Long Text Icon indicating whether or not there is a long text for the message

 Note
You can read the long text of a message by double-clicking the message.

 Note
Use Delete Messages to delete all of the messages collected up to that point from the list (and from the memory).

Navigation in the Archive File Browser

Use
The Archive File Browser offer an overview of archive files and data objects. More information: User interface

Features

The the fields in the Header Information, the Archive File Overview and the scroll keys give you various options for navigating in
archive files and outside of archive files. You can combine some of these options.

Opening Archive Files

Double-click on an archive file in the overview to open a file. The first data object in this file for the current data object appears in
the display area.

Various methods for selecting a file:

By double-clicking on an archive file key, this file is selected

By double-clicking on a session, the first file in the session is selected

By double-clicking on an archiving object, the first file of the latest session that appears in the overview is selected

System actions depending on the view selected

Tab page before double-click Result

Documentation or search The system selects the first data object in the Data Object view.

Data object or table The system selects the first data object , no change to the view.

Hex display The display starts with the beginning (data object 0, offset 0) of the
selected archive file, no change to the view.

Scroll keys

This is custom documentation. For more information, please visit SAP Help Portal. 104
 4/6/25, 11:39 PM
You will find the scroll keys for the relative navigation between the archive file overview and the display area.

 Note
The first data object of an archive file means in the case of the hex display the data object number 0 (zero), that is, the start of
the archive file. With every other view the first data object literally means the very first data object in the archive file.

Navigation using Scroll Keys

Scroll Keys Features

First File The system highlights the first data object of the first file.

Previous File The system highlights the first data object of the file that is in the
overview in front of the file for the current data object.

Previous Data Object The system highlights the data object that is in front of the current
data object.

In the event the current data object is the first data object in the
archive file, the system highlights the last data object of the
previous archive file.

 Caution
Note that this procedure can be time-consuming, as it may be
necessary to read the entire archive file in sequence.

 Recommendation
This function is not recommended if you are entering an offset
direct.

Next Data Object The system highlights the data object that is in front of the current
data object.

If the current data object is already the last data object of the
archive file or the archive file cannot be accessed, the system
highlights the first data object in the following archive file.

 Recommendation
This function is not recommended if you are entering an offset
direct.

Next File The system highlights the first data object of the next archive file in
the overview.

Last File The system highlights the first data object of the last archive file in
the overview.

Continue Search The system determines the next hit in the search.

 Note
This button is only active if you have started either a search or
the background search report.

This is custom documentation. For more information, please visit SAP Help Portal. 105
 4/6/25, 11:39 PM

Searching for Table Contents

Use
You can use the search for table contents to search archive files. You search for data objects that meet specific criteria. These are
selection criteria for a specific table.

The system searches the files sequentially and displays the data objects. If you want to search larger archive files or a large
number of files, you can execute the search in the background.

Features
You have the option of performing the search online or scheduling the search query as a background job and evaluating the result
at a subsequent stage.

For more information, see Searching for Table Contents Online and Searching for Table Contents in the Background.

Activities
If you search using Search or Start Search, the system searches for the selected files in the order in which they are displayed in
the archive files overview. The system only searches through files that could actually contain the table from the selection criteria.
The system obtains this information from the definition of the archiving objects, and not direct from the archive files.

Once the system has found a matching data object, it switches to the view Table and displays the table entries from the search
criteria, meaning it displays all entries for the data object, and not just those that match the selection.

At this point you can switch to the other views, and use all of the other navigation options.

By choosing Continue Search, you can continue the search. Using this function you can do a complete search through each of the
files you want to search, in succession.

 Note
When the system finds a matching data object, it only switches to the view Talle if you are not already in one of the other views
Data Object, Table or Hex Display.

Search Procedure

The system checks whether the file for the current data object is in the search area. If this is the case, the system continues the
search with the next data object. If the current data object is the last in its file, the system continues with the first data object of
the next file in the search area.

If the current file is not in the search area, the system continues with the next file that is found in the search area. The next file in
this case is determined by the sequence in the archive file overview.

When carrying on with a search, the current search criteria are always used, and these may differ from the search criteria at the
start of the search.

 Note
You can navigate freely between two search steps as necessary, and also change the search area and search criteria.

This is custom documentation. For more information, please visit SAP Help Portal. 106
 4/6/25, 11:39 PM
If the system has reached the end of the search area, it generates a corresponding message and deactivates the Continue Search
function. It makes no difference whether the end of the search area was actually reached by the search or by any of the other
navigation functions.

Searching Online for Table Contents

Procedure

1. In the Archive File Browser, you find the area Files to be Searched on the tab page Search on the top left of the screen. Drag
the files to be searched from the archive files overview to this area by drag and drop.

 Note
Check that the Search Mode defined is Online Search.

For more information about the area Files to be Searched, see Areas Covered by the Search.

2. In the Search Criteria area, select the table whose fields you want to use for the search. You can enter the table directly or
use Other Table.

For more information about the area Search Criteria, see Areas Covered by the Search.

3. Choose Field Selection to define the fields for the search.

4. Enter the values that you want to use for the search.

5. Choose Start Search to start the search.

The system starts searching through the selected files. The search stops with the first hit. The system automatically
switches to the Table tab page and displays the contents of the table that you specified in the search criteria.

 Note
The Find Next button is activated.

6. Choose Find Next.

The system now resumes the search with the current data object. You can repeat this process until the search reaches the
end of the search area. The system then displays a corresponding message.

Searching for Table Contents in the Background

Context
You may find the online search is often unsuitable for searching through several or large archive files, and it is better to run time-
intensive processes in the background. The Archive File Browser gives you the option of saving your search requests, processing
them in the background, and evaluating the results later.

 Recommendation
Finding table contents in the background should only be used for ad hoc search requests. If you regularly need to access
archived data quickly, you are recommended to use the Archive Information System.

This is custom documentation. For more information, please visit SAP Help Portal. 107
 4/6/25, 11:39 PM

Procedure

1. Determine which files you want to search and the search criteria. For more information, see Searching for Table Contents
Online.

2. On the Search tab page, you choose Save for Background Search.

3. In the following dialog box, enter a unique text as the search description. You will later need to use this text to identify your
search.

The system saves your search request. The selection of files to be searched and the search criteria all belong to the search
request. In addition, a new entry appears in the Search Mode area bearing the description you entered.

4. Schedule program ASAFBSEARCH in the background using transaction SA38.

Program ASAFBSEARCH processes all pending search requests. All files are always read through completely. The program
determines all hits.

5. Once the program has finished, start the AFB using transaction AS_AFB.

6. Select a search request and choose Load Search Results.

Results
The system loads the search area, the search criteria and the results of your search. The result covers both the hit list and any
messages that are generated.

 Note
Both the search area and the search criteria can no longer be changed or are no longer ready for input. The Search Mode
switches from Online Search to Background Search Report.

As with the online search, you can navigate in the search result using Start Search and Continue Search. The system functions in
the same way as with the search in dialog mode, except that you are unable to change the search.

 Note
If you want to exit the results of the background search report in order to enter a new search, switch to the Search tab page and
choose Online Search in the Search Mode area.

Messages when searching in the background

The system saves any messages that are generated along with the search results. Error messages may occur during the search.
For example, if archive files cannot be accessed or are corrupted. These messages are displayed in the course of the background
search report, just as for the online search.

Search Areas

Use
Files to be Searched

This is custom documentation. For more information, please visit SAP Help Portal. 108
 4/6/25, 11:39 PM
In this search area, you define which files are to be searched. The files are represented as a list of archive file keys. The sequence of
the files corresponds to the display in the archive files overview. The search is made in the archive files overview from top to
bottom. Only those files that are located in the search area are searched.

 Caution
You should note that if you remove files from this area before you choose Cont. Search, these files are no longer included in the
new search.

You can transfer additional files from the archive files overview using drag and drop. If you use an archiving session or archiving
object in the search area instead of individual files, then all archive files that are in the overview under this session or object are
included in the area to be searched.

Search Criteria

In this search area, you define which table contents you want to search for in the archive files. It is only ever possible to search for
the contents of an individual table. You either enter this table direct or select it using Another Table. Only those tables matching
the archiving objects of the files to be searched are offered. If you have not yet defined any files to be searched, then all tables for
all archiving objects from the archive file overview are used. When you choose a new table, the system automatically proposes the
first ten fields of this table as the selection criteria. You can change this selection using Field Selection. You can select a maximum
of 75 fields.

More Information

Search Mode

Search Mode

Use
In the search mode area, you determine using the Online Search and Background Search Report functions which database the
system chooses for the Start Search and Cont. Search (Continue Search) functions.

Online Search: the system searches through the archive files direct.

Background Search Report: the system evaluates the results of a background search previously carried out.

To switch between the two options, choose Load Search Results.

Load Search Results: You want to choose the results of a background search and make them available for the evaluation. To
do this, the list of the files to be searched and the search criteria stored with the search request are downloaded and
displayed.

 Note
If results for the search request downloaded are already available, the system changes the search mode to Background
Search Report, and changes are not possible. If no results are available, the system changes the mode to Online Search
and changes to both the search area and search criteria are possible.

To start the search report, choose Start Search.

Change of Search Mode to Online Search

This is custom documentation. For more information, please visit SAP Help Portal. 109
 4/6/25, 11:39 PM
When you change the search mode from Background Search Report to Online Search the search results are discarded for the
time being, and you can change the search area and criteria.

 Note
If you have already started the background search report, the function Cont. Search continues to be active. You can use this
function to find the next hit online. However, the files are searched and not the result of the background search.

Change of Search Mode to

Background Search Report For a manual change from Online Search to Background Search Report you must have at least one
search request with results. Only in this case can you switch to Background Search Report.

If a previously completed search request has already been downloaded, the system uses this. Otherwise the system selects the
completed search request that is uppermost in the list.

List of Search Requests

The list of search requests contains the possible search requests and informs you which of these requests has already been
processed by search program ASAFBSEARCH.

List of Functions for Search Requests

Function Description

Save for Background Search For more information, see Searching for Table Contents in the
Background.

Load Search Results For more information, see Searching for Table Contents in the
Background.

Refresh To download the search requests again. The selection representing

the processing status is updated.

Delete Entry To delete search requests You can delete completed requests and
requests not yet processed.

Searching Efficiently for Table Entries

Context
You can use the Archive File Browser to always include all files that exist in the system in the search area, define the search criteria
and then choose Start Search. Using this procedure it can be a long time before you get a result. As a rule, the maximum runtime
of a dialog step is limited, meaning that in many cases you may not actually get a result.

The following options are available depending on the situation:

Use the Archive Information System

User entries prior to archiving

Restrict search area

Search in the background

This is custom documentation. For more information, please visit SAP Help Portal. 110
 4/6/25, 11:39 PM

Procedure

Use the Archive Information System

In many systems in which archiving takes place, the Archive Information System is also active. Any info structures that have
been created should also be used here. In this situation, the Archive Information System essentially offers more efficient
access to archived data than the Archive File Browser. The prerequisite for this is that the appropriate archive information
structures are available and have been constructed.

User Entries Prior to Archiving

In archive administration (transaction SARA) you can see which selection criteria were used at the start of an archive
session. To see how the archiving was started, choose the context menu (right mouse button) for the user entries made for
an archiving session. You can often use this information to identify which table entries could be contained in the files for the
session. You should then only search through files that could also contain the data.

Restrict Search Area

You do not have to make the system search through all of the available archive files. You can for example only select archive
files for sessions that match the user entries. If a time restriction is possible, you should set an appropriate filter in the
overview of the archive files before including the archive files in the search area.

Search in the Background

Perform the search in the background, particularly if you are interested in more than the first hit.

Example
For more information, see Examples of Efficient Working with the AFB.

Using Archive File Browser Efficiently

Use
The following examples and explanations should assist you in using the Archive File Browser efficiently.

You want to find a data object in an archive file.

More information: Finding Data Object in Archive File (Example)

You want to find a data object with a specific offset in an archive file.

More information: Finding Data Object with Offset in Archive File (Example)

During the search you want to skip several data objects or an archive file.

More information: Skipping Data Objects or an Archive File (Example)

You want to speed up the start of the Archive File Browser.

More information: Accelerate Start of Archive File Browser

You want to analyze corrupted files.

More information: Analyze Corrupted Files

This is custom documentation. For more information, please visit SAP Help Portal. 111
 4/6/25, 11:39 PM
You want to view the header data of the archive file.

More information: Displaying Header Data of the Archive File

Finding Data Object in Archive File (Example)

Use

You want to find data object 17 in archive file 003755-001BC_SFLIGHT as quickly as possible.

Procedure
1. Choose Find above the archive files overview.

2. In the following dialog box, enter the file key 003755-001BC_SFLIGHT. If the system does not find the file, check the filter
settings in the archive files overview.

3. Double-click the file key 003755-001BC_SFLIGHT.

4. Enter the number of the data object, in this case 17, in the Data Object field and choose data release.

Result
The system reads archive file 003755-001BC_SFLIGHT up to the 17th data object, and displays this in the Data Object view. From
there you can then navigate to other views or to other data objects.

Finding Data Object with Offset in Archive File (Example)

Use
This example shows you the fastest way to find the data object with offset 301451 in Archive File 003755-001BC_SFLIGHT in the
Archive File Browser.

Procedure
1. In the archive file overview, choose Find.

2. In the dialog box, enter the file key 003755-001BC_SFLIGHT.

If the system does not find the file, check the filter settings in the archive files overview.

3. Double-click file key 003755-001BC_SFLIGHT.

4. In the Offset field, enter 301451 and confirm your entry.

Result
The system displays the data object with this offset, or you receive an error message if no data object begins with this offset.

Skipping Data Objects or an Archive File (Example)

This is custom documentation. For more information, please visit SAP Help Portal. 112
 4/6/25, 11:39 PM

Use
You establish that during the search, meaning you have chosen Start Search or Continue Search, that although hits may occur in
the next 10 data objects or within the current file, they are of no interest to you, so you want use the normal navigation to skip
them.

Procedure

Area that you want to skip Procedure

10 data objects Add 10 to the current data object number and enter the result in
the Data Object field.

An archive file Choose Next File

You can also choose the next file in the overview by double-clicking, or if you are in the online search, delete the current file from
the search area.

 Note
Make sure that the current data object is not included in the search with the Continue Search. If the current data object has not
been selected through the search, you have to check yourself whether it meets your selection criteria, or you must go back one
data object before you choose Continue Search.

Accelerate Start of Archive File Browser

Context
When you start the Archive File Browser, loading the archive file overview in particular can be very time-consuming. We therefore
recommend creating a filter for the overview and defining this as a default setting.

Procedure

1. Having started the AFB, select the filter function over the archive files overview. Choose fields that significantly restrict the
search, such as the number of the archiving session or the creation date.

2. Choose Save Layout... in the drop-down menu for editing the layout of the archive files overview. Check that Filter
Conditions is selected.

3. Enter a name and a description for the layout. Save the layout.

4. Choose Manage Layout... and select your layout as a default setting.

Results
When you next start the Archive File Browser,only those archive files that match the filter will be included in the overview.

 Note
While you are working with the AFB, you can change the filter criteria at any time if you want to work with other archive files.

This is custom documentation. For more information, please visit SAP Help Portal. 113
 4/6/25, 11:39 PM

Analyze Corrupted Files

Use
In the Archive File Browser, you can use the Hex display to analyze corrupted archive files.

Procedure
In the archive file overview, select the corrupted file by double clicking it. The AFB attempts to read the first data object from the
file and display this in the Data Object view.

This is either successful or the system displays the corresponding error messages in the log according to the type of error
involved. You can toggle to the Hex display and analyze the file in all cases. To analyze the file, you require a good understanding of
the structure of archive files.

 Note
You cannot make corrections to the archive file using the Archive File Browser.

Displaying Header Data of the Archive File

Use
You want to display the header data of an archive file in the Archive File Browser.

Procedure
Switch to the hex display. In the archive file overview, select the the required archive file.

Result
The system displays the header data of the archive file on the right-hand side of the screen.

Table Analysis

Use
You use the table analysis to distribute the table entries to the selected fields. A table analysis counts the table entries and assigns
the number of entries found to the selected field values (for example, organizational units or periods) You use Analysis Variants to
determine the fields for the table analysis.

Integration
The analysis of the contents of a table is often necessary in the data archiving environment.

Features

This is custom documentation. For more information, please visit SAP Help Portal. 114
 4/6/25, 11:39 PM
You can use the table analysis to analyze the distribution of table entries to the selected fields. For more information, see
Performing Table Analysis.

To perform a table analysis, you always need an analysis variant. For more information, see Analysis Variant.

You can supplement a table you would like to include in an analysis with virtual fields. For more information, see Virtual
Fields.

You have multiple options for monitoring the space table analyses use on the database. For more information, see
Reorganizing Table Analysis.

In addition you can display or delete analysis variants, and display analyses performed in the background.

Activities

Transactions used within table analysis

Function Transaction Code

Table Analysis TAANA

Analysis Variant TAANA_AV

Virtual Fields TAANA_VF

Example
Table BKPF contains document headers for financial accounting. Each document is assigned to a company code. By using table
analysis you can identify how many entries relate to a particular company code.

Performing Table Analysis

Procedure
Analyzing Individual Tables

1. Using transaction TAANA you can access the screen Table Analysis: Administration.

2. Choose Table Analysis Execute .A dialog box appears.

3. Enter the name of the table. Depending on this table, the system offers the analysis variants available for selection in the
input help for the Analysis Variant field.

4. Select at least one analysis variant, or else create one.

 Note
The system offers analysis variant DEFAULT for every table. This variant contains no fields. Therefore it determines the
total number of entries in the client in which it is performed.

If an adequate analysis variant does not exist, the following options are available for creating analysis variants:

To create an ad hoc analysis variant specifically for a current table analyses, use Ad Hoc Variant. This variant is not
saved on the database, and is available only for the table analysis that you are currently scheduling. For more
information, see Creating an Ad Hoc Analysis Variant.

This is custom documentation. For more information, please visit SAP Help Portal. 115
 4/6/25, 11:39 PM
Use the transaction TAANA_AV to create an analysis variant. It is saved to the database and you can use it multiple
times. For more information, see Creating Analysis Variant.

5. If you want to restrict the number of records to be analyzed, choose Data Selection. The Data Selection for Table <Name>
window appears.

Enter the criteria with which you want to restrict the selection. By default, the system suggests the fields that are either
part of the table's primary key or are defined for secondary indexes. If necessary, you can add additional fields to the
selection by choosing New Field Selection. You can also restrict the number of entries to be analyzed using Maximum
Number of Entries. Save your entries.

 Note
While selecting the data, and later, when displaying the result, you can use the options in the Settings menu to switch
between technical field names and field labels.

6. Select the desired type of process control and choose Continue.

 Recommendation
To improve performance, we suggest analyzing large tables in the background, not online.

7. Specify a start time for background processing. Save your entries. When you perform the analysis online, it is started
immediately.

The table and analysis variant you selected for analysis are displayed on the left side of the screen.

 Note
While the table analysis is being performed, you can Refresh the current data.

8. Double-click the table analysis on the left side of the screen to display it.

The table analyses on the left side of the screen are sorted by table name, name, analysis variant, and time of analysis.

The result of the analysis is displaed on the right of the screen. If you restricted the number of records to be analyzed
before the analysis, the Data Selection button is displayed. You can use this button to display the values of the selection
restrictions that applied for the selected analysis.

Analyzing Multiple Table in One Step

If you want to analyze multiple tables in one step, proceed as follows:

1. Use transaction SA38 to start program TAAN_PROCESS_MULTIPLE. A selection screen appears.

 Recommendation
To improve performance, we suggest analyzing large tables in the background, not online (transaction SA38, Program
Execute in Background ).

2. Enter the table you want to analyze.

3. Enter the relevant analysis variant and start the program.

Use transaction TAANA to view the results of the table analysis (see above).

Result

This is custom documentation. For more information, please visit SAP Help Portal. 116
 4/6/25, 11:39 PM
The various field values with the number of related table entries in the evaluation are displayed in accordance with the analysis
variant you selected. The list is sorted in descending order by number of table entries.

Reorganizing Table Analysis

Procedure

You have several options for monitoring and regulating the space table analyses use on the database.

Reorganizing Table Analyses

Reorganization Options Description

Retain most recent table analysis for each table and analysis The system only retains the latest analysis with the status
variant Completed for each table and analysis variant and deletes all other
table analyses.

Exception:

Analyses with the status Scheduled as Background Job and In

Process are retained.

Delete table analyses that were performed before a certain date. All of the analyses performed before a specified date are deleted.
The reference date is the start date of the analysis.

Refresh table analyses that were performed before a certain date. All of the analyses performed before a specified date are deleted. A
new analysis for the relevant table is performed using the same
analysis variant.

We recommend reorganizing table analyses regularly (choose Utilities Reorganize Analyses... ), since the results of all table
analyses are saved in the database tables (TAAN*), and may use up a considerable amount of space .

Analysis variants have been provided to enable you to determine the space used by the analyses. The usage of space is specified
as the number of table rows in table TAAN_DATA. You can find most of the information about analyses you have performed in this
table.

Analysis variants for determining space usage

Analysis Variant Meaning

TAANA_ANALYSE_BY_OBJECT Space usage for each table and analysis variant

TAANA_ANALYSE_BY_DATE Space usage for each month and year in which you have performed
analyses

Analysis Variant

Use
To perform a table analysis, you always need an analysis variant. This relates to only one table and describes which fields are to be
analyzed.

Depending on the usage type there are two kinds of analysis variant available:
This is custom documentation. For more information, please visit SAP Help Portal. 117
 4/6/25, 11:39 PM
To create an analysis variant for future table analyses, use transaction TAANA_AV. The definition of this variant is saved on
the database, and can be used for future table analyses.

To create an ad hoc analysis variant for currently scheduled table analyses, use transaction TAANA. The definition of this
variant is not saved on the database, and as a result is only available for the table analysis that you are currently scheduling.

Features
Creating an analysis variant

For information on analysis variants that you can also use for future table analyses, see Creating an Analysis Variant.

For information on analysis variants that you can only use for currently scheduled table analyses, see Creating an Ad
hoc Analysis Variant.

Displaying an Analysis Variant

In transaction TAANA_AV, you can find on the left hand side of the screen a list of all the analysis variants created, sorted by
table names. To display an analysis variant, double-click on it. The analysis variant is then displayed on the right side of the
screen.

Deleting an Analysis Variant

To delete an analysis variant, display the variant you want to delete on the right side of the screen. Choose Edit Delete
.

Creating Analysis Variants

Context
To perform a table analysis, you always need an analysis variant. This relates to only one table and describes which fields are to be
analyzed.

The system saves the analysis variant to the database; it can then be used for future table analyses.

Procedure

1. With the transaction:

TAANA_AV or alternatively

Starting from the table analysis (transaction TAANA), choose Environment Analysis Variant

to go to the change mode for analysis variants for the table analysis.

2. Choose Edit New Entries and enter the name of the table for which you want to create an analysis variant.

3. Enter the name of the analysis variant that is in your namespace.

4. Choose Fields. The system offers you all table fields for selection.

 Note

This is custom documentation. For more information, please visit SAP Help Portal. 118
 4/6/25, 11:39 PM
The system first displays the fields contained in the ABAP Dictionary (DDIC). Then it displays the virtual fields defined in
the table analysis.

 Note
An analysis variant should contain as few field as possible (three to four fields). You should only choose fields with a low
selectivity, meaning with few characteristic values. Fields having high selectivity, for example document numbers, mean
that the results list for a table analysis is unduly long, which both reduces its usefulness and also takes up too much
space in the database.

5. Select the relevant fields or create virtual fields if necessary. For more information, see Virtual Fields.

6. Save the analysis variant.

Results
The new analysis variant is displayed on the left-hand side of the screen.

Creating an Ad Hoc Analysis Variant

Context
An ad hoc analysis variant is only available for the currently scheduled table analyses. The definition of this variant is not saved on
the database, and therefore is available only for the table analysis you are currently scheduling.

Procedure

1. With transaction TAANA you can access the screen Table Analysis:. Administration.

2. Choose Table Analysis Execute . A dialog box appears.

3. Enter the table name.

4. Choose the input help for the Analysis Variant.

5. In the dialog box Analysis Variants: Selection, choose Ad-Hoc Variant.

6. Select the fields for the analysis variant.

7. Choose Continue.

Alternatively, you can restrict the analysis to part of a table field, for example, to perform an aggregation on the year for
date fields. To do this, you use the DDIC definition of the table you want to analyze to specify the fields you want to
aggregate as subfields, and to specify the offset and length required. Enter the values in the offset and length subfields, for
example, offset = 0, length = 4 if you want an aggregation over the year for a date field.

 Note
You can only specify subfields for fields with ABAP types C (text field), N (numeric text field), D (date field), T (time
field), and P (packed number). With type P this function is particularly useful for fields containing timestamps (DDIC
data type TIMESTAMP or TIMESTAMPL). The standard format of these timestamps is "yyyymmddhhmmss" or
"yyyymmddhhmmss.sssssss", whereby the year can be aggregated (subfield length 4) or the month of the year
(subfield length 6).

This is custom documentation. For more information, please visit SAP Help Portal. 119
 4/6/25, 11:39 PM
8. Apply the analysis variant.

 Note
You do not need a transport request for the ad hoc variant.

Virtual Fields

Use
Virtual fields enable you to perform the following analyses within table analysis:

Analyze one part of a table field

 Example
The table contains a date field, and you would like to examine the distribution of the data across the year.

Analysis with a field that is not contained in the table to be analyzed but whose value can be determined from either the
available table fields or, if necessary, from other tables.

 Example
The table does not contain a field naming the archiving object that can be used for archiving a data record.

Within table analysis you can create as many virtual fields as you require for each table. Such fields are treated in the same way as
all other table fields. Virtual fields are not shown with separate IDs in transactions TAANA and TAANA_AV.

All of the virtual fields you have already created for the relevant table are available for analysis variants or ad hoc variants.

For more information, see Analysis Variant and Performing Table Analysis.

Features
Create virtual field

For more information, see Creating Virtual Fields.

Displaying Virtual Field: All virtual fields you have created are listed in the left screen area, sorted according to table name.
To display a field in the right screen area, double-click on it.

Deleting a Virtual Field: Proceed as detailed under "Displaying a virtual field" and choose Edit Delete .

Creating Virtual Fields

Procedure

1. The following alternative access options are available:

Enter the transaction TAANA_VF.

This is custom documentation. For more information, please visit SAP Help Portal. 120
 4/6/25, 11:39 PM
Enter transaction TAANA and choose Environment Virtual Fields .

Enter transaction TAANA_AV and choose Environment Virtual Fields .

2. Choose Edit New Entries and enter the name of the table for which you want to create virtual fields.

3. Enter a name for the new field. Make sure it is within your namespace.

4. Enter the data for the value determination, and technical attributes of the field.

5. Save your entries.

Data Archiving in SAP NetWeaver AS

The following table shows the archiving objects provided:

Objects in SAP NetWeaver Application Server Archiving Object

User changes US_USER

Authorization changes US_AUTH

Profile changes US_PROF

Work items WORKITEM

IDocs IDOC

Table changes BC_DBLOGS

Link Entries ArchiveLink ARCHIVELNK

Archive administration data BC_ARCHIVE

Change documents CHANGEDOCU

SAP product PRODUCT_MD

Archiving User and Authorization Changes (BC-ADM-SEC)

Archiving User and Authorization Changes (BC-ADM-SEC)

You can archive change documents of the following types that are generated in the course of user and authorization maintenance:

Users: Changes in assigned authorizations and other characteristics; changes in passwords

In transaction SU01 (user maintenance), choose the menu entry Environment → Archive and Read.

Profile: All changes

In transaction SU02 (profile maintenance), choose the menu entry Environment → Archive and Read.

Authorizations: All changes

This is custom documentation. For more information, please visit SAP Help Portal. 121
 4/6/25, 11:39 PM
In transaction SU03 (authorization maintenance), choose the menu entry Environment → Archive and Read.

Archiving User Change Records (BC-ADM-SEC)

You can archive change records for the following changes to user master records:

Authorization changes and changes to other user characteristics

Changes to user passwords

Object Definition
The archiving object US_USER is used to archive password change records from table USH04. The object US_PASS archives
records of changes to user master records other than password changes. In this way, for example, changes in the authorizations in
a user master record are recorded. These recordings are stored in the USH02 table.

Technical Information

Unless you are archiving a large number of change records, an archiving run should have no significant effect on the performance
of your system. The user change records require the following memory space (uncompressed):

US_PASS password change records: 300 bytes

US_USER user change records: 100 bytes

Dependencies
When you archive user change records, it does not have any effect on other archivable data. There are no particular dependencies
or relationships between user change records and other archivable data.

You can use the archiving objects US_PASS and US_USER within the framework of Information Lifecycle Management. To be able
to do this, you must activate the related business functions. The system then shows the ILM Actions group box. Using these
actions, you can, for example, run archiving during which the system evaluates the retention periods entered in Information
Retention Manager. You can also create snapshots (copies) of data, and you can delete data that does not meet your criteria.

Space Criteria and Storage Duration

We recommend a storage duration of 10 years for all user and authorization change records.

Change records are archived according to the date that you specify. All records older than the date specified are archived. Old
archives are not automatically deleted.

Log

The log files generated by archiving and deleting records are stored in the SAP spool system. The archiving log records the number
of change records archived. The delete log lists the change records that were deleted after the archiving session.

Creating an Archive File

Choose Tools → Administration → User Maintenance.Then choose Users,followed byEnvironment → Archive and Read, and then
the required archiving function.

This is custom documentation. For more information, please visit SAP Help Portal. 122
 4/6/25, 11:39 PM
The archiving function calls the standard archiving interface, where the correct archiving object is already specified.

You need only specify (or create) an appropriate report variant, specify the start time and printing specifications for the
background processing of the report, and schedule the report with Create job.

See also the documentation on the archiving procedure in general. You will find this documentation in the first section of this
document.

Executing the Deletion Program

You must explicitly delete archived records after an archiving session has been successfully completed. Be sure to check the
archiving log to be sure that the archiving session has been completed successfully. Also, be sure that you specify the same date
for the deletion program. Otherwise, too many or too few change records will be deleted.

Archiving Authorization Change Records (BC-ADM-SEC)

You can archive change records for all changes to authorizations.

Object Definition
The archiving object US_AUTH is used to archive change records for changes to authorizations from table USH12.

Technical Information
Unless you are archiving a large number of change records, an archiving run should have no significant effect on the performance
of your system. An authorization change record requires about 100 bytes (uncompressed).

Dependencies

Archiving authorization change records does not have any effect on other archivable data. There are no particular dependencies or
relationships between authorization change records and other archivable data.

You can use the archiving object US_AUTH within the framework of Information Lifecycle Management. To be able to do this, you
must activate the related business functions. The system then shows the ILM Actions group box. Using these actions, you can, for
example, run archiving during which the system evaluates the retention periods entered in Information Retention Manager. You can
also create snapshots (copies) of data, and you can delete data that does not meet your criteria.

Space Criteria and Storage Duration

We recommend a storage duration of 10 years for all user and authorization change records.

Change records are archived according to the date that you specify. All records older than the date specified are archived. Old
archives are not automatically deleted.

This is custom documentation. For more information, please visit SAP Help Portal. 123
 4/6/25, 11:39 PM

Log
The log files generated by archiving and deleting records are stored in the SAP spool system. The archiving log records the number
of change records archived. The delete log lists the change records that were deleted after the archiving session.

Creating an Archive File

Choose Tools → Administration → User Maintenance.Then choose Manual Maintenance → Edit Authorizations Manually
(transaction SU03), followed by Utilities Archive and Read, and choose the archiving function.

The archiving function calls the standard archiving interface, where the correct archiving object is already specified.

You need only specify (or create) an appropriate report variant, specify the start time and printing specifications for the
background processing of the report, and schedule the report with Create job.

See also the documentation on the archiving procedure in general. You will find this documentation in the first section of this
document.

Executing the Deletion Program

You must explicitly delete archived records after an archiving session has been successfully completed. Be sure to check the
archiving log to be sure that the archiving session has been completed successfully. Also, be sure that you specify the same date
for the deletion program. Otherwise, too many or too few change records will be deleted.

Archiving Profile Change Records (BC-ADM-SEC)

You can archive change records for all changes to profiles.

Object Definition
The archiving object US_PROF is used to archive change records for changes to authorization profiles from table USH10.

Technical Information
Unless you are archiving a large number of change records, an archiving run should have no significant effect on the performance
of your system. A profile change record requires between 0.5 and 1 KB (uncompressed).

Dependencies
Archiving profile change records does not have any effect on other archivable data. There are no particular dependencies or
relationships between profile change records and other archivable data.

You can use the archiving object US_PROF within the framework of Information Lifecycle Management. To be able to do this, you
must activate the related business functions. The system then shows the ILM Actions group box. Using these actions, you can, for
example, run archiving during which the system evaluates the retention periods entered in Information Retention Manager. You can
also create snapshots (copies) of data, and you can delete data that does not meet your criteria.

This is custom documentation. For more information, please visit SAP Help Portal. 124
 4/6/25, 11:39 PM

Space Criteria and Storage Duration

We recommend a storage duration of 10 years for all user and authorization change records.

Change records are archived according to the date that you specify. All records older than the date specified are archived. Old
archives are not automatically deleted.

Log

The log files generated by archiving and deleting records are stored in the SAP spool system. The archiving log records the number
of change records archived. The delete log lists the change records that were deleted after the archiving session.

Creating an Archive File

Choose Tools → Administration → User Maintenance.Then choose Manual Maintenance →Edit Authorizations
Manually(transaction code SU03), followed by Utilities → Archive and Read, and choose the archiving function.

The archiving function calls the standard archiving interface, where the correct archiving object is already specified.

You need only specify (or create) an appropriate report variant, specify the start time and printing specifications for the
background processing of the report, and schedule the report with Create job.

See also the documentation on the archiving procedure in general. You will find this documentation in the first section of this
document.

Executing the Deletion Program

You must explicitly delete archived records after an archiving session has been successfully completed. Be sure to check the
archiving log to be sure that the archiving session has been completed successfully. Also, be sure that you specify the same date
for the deletion program. Otherwise, too many or too few change records will be deleted.

Archiving Work Items

Definition

Archiving object WORKITEM for archiving and deleting work items.

Use
Archiving Work Items

The system archives all data (not including runtime data) that belongs to a work item. You can display archived work items, but you
cannot reload them into a system.

You can only archive completed workflow work items. This involves archiving all work items that are dependent on this workflow
work item as well. A work item that depends on superordinate work items cannot be archived on its own.

This is custom documentation. For more information, please visit SAP Help Portal. 125
 4/6/25, 11:39 PM
You archive log data, workflow manager data, dependent work items and work item attachments (for example, graphics files).

The other objects in the container of a work item are archived only as references. They are not deleted.

Criteria for the Permissibility of Archiving

You can only archive those work items that have one of the following statuses:

Completed (COMPLETED)

The execution of the work item is completed.

Logically deleted (CANCELLED)

Execution of the work item is no longer useful or required for the workflow logic.

Structure
Archive Work Items

Choose Tools → Business Workflow or Development → Workflow and then Administration → Workflow Runtime→ Reorganization
→ Archive Work Item. For more information about the archiving procedure, see Executing Archiving.

To define the required variants, use the following selection criteria. This determines which work items to archive:

Work item ID (work item number)

Task ID

Actual agent of the work item

Searches only through the work item’s the header data. To search through all of the tables in the Work Item Repository,
select Repository Search.

Date when the work item was created

Date when the work item was completed

Deleting Archived Work Items

Choose Tools → Business Workflow or Development → Workflow and then Administration → Workflow Runtime→ Reorganization
→ Archive Work Item. For more information about the archiving procedure, see Executing Archiving.

You can specify whether the deletion program started after archiving is to run in test mode. You specify whether or not the deletion
program is started at all in the general Customizing settings for Archiving.

To directly Delete Work Items that have not been archived, choose Tools → Business Workflow or Development → Workflow and
then Administration → Workflow Runtime → Reorganization → Delete Work Item. For performance reasons, use the report
RSWWCIDE for container anchors (Type C work items).

 Note
If you want to delete work items that meet the archiving criteria but that you do not want to archive, you should nevertheless
archive them, as it is better performance-wise to use the delete program of the archiving object WORKITEM than to delete the
work items directly. Carry out the archiving procedure and then delete the archive file containing the archived work items
manually in the file system.

Displaying Archived Work Items

This is custom documentation. For more information, please visit SAP Help Portal. 126
 4/6/25, 11:39 PM
Choose Tools → Business Workflow or Development → Workflow and then Administration → Workflow Runtime→ Reorganization
→ Archive Work Item. For more information about the archiving procedure, see Executing Archiving.

If you choose Evaluate, the report RSWWARCR is used for reading and displaying archived work items.

 Note
This report is only intended to be a template for your own customer-specific report, since the data selection from the archive
and the subsequent data formatting is generally customer-specific. The customer-specific adaptations are made after the
function module SWW_WI_LIST_ARCHIVED_READ is called.

Displaying Archived Work Items for an Object

The display of an archived work item is useful, for example, of you want to use the archive to determine the workflow followed to
release a specific document.

To display archived work items specific to an object, use the Archive Information System). The system automatically determines
the archive that contains the archived data. Otherwise you need to know the archive.

To use the archive information system, activate the archive information structure

SAP_O_2_WI_001. For more information, see Using the Archive Information System.

To display archived work items for an object, choose Tools → Business Workflow or Development → Workflow and then
Administration → Workflow Runtime→ Reorganization → Display Workflows from Archive. You can determine the archived
workflows for a given object.

The display is in the form of a restricted workflow log, without detailed data.

Note on the archive information structure

We recommend using the archive information structure SAP_O_2_WI_001. This is required if you use ABAP classes or XML objects.
If you are using only BOR objects, and are already using archive information structure SAP_BO_2_WI_001, you can continue to use
it. However, we recommend that you switch to the extended archive information structure SAP_O_2_WI_001.

To do this, you proceed as follows:

1. In transaction SARI, activate archive information structure SAP_BO_2_WI_001.

As a result, both archive information structures are available at the same time.

2. Fill the new structure for the available archive files in the Status Management of transaction SARI.

3. In transaction SARI, deactivate archive information structure SAP_BO_2_WI_001.

4. In Customizing of transaction SARI, delete the archive information structure SAP_BO_2_WI_001.

Integration
You specify technical values for the archiving session, such as name, path and maximum archive file size, as well as the settings for
the delete program, in Customizing for Archiving.

Archiving IDocs

Use
This is custom documentation. For more information, please visit SAP Help Portal. 127
 4/6/25, 11:39 PM
IDocs are stored in several database tables. To keep these tables (and the access times) small (to reduce the database load)
without losing any IDocs, you can archive the IDocs at the operating system level. These archives can then be moved to external
storage media, such as disks (using ArchiveLink) or magnetic tape.

Prerequisites
In Customizing, you specify where the archive files are located physically (that is, which storage media are used). For more
information, see Cross-Application Components (CA) -> Archiving Application Data -> Introduction to Data Archiving ->
Customizing.

Activities
Displaying or changing the archivable status

When can I archive IDocs?

Archiving functions for IDocs

How are IDocs written to and read from archive files?

 Caution
Make sure that you do not archive IDocs that may still be needed by the application.

Deleting Links with IDocs

When do I delete IDoc links (for example, with application documents?

Archiving: Technical Realization

How does archiving work from a technical perspective?

More Information
Archiving Application Data

General archiving information

Displaying or Changing the Archivable Status

Context
Certain IDoc statuses are classified as archivable in the standard system, whilst others are not. You can display or change this
classification.

 Note
The current status of an IDoc must be archivable before the IDoc can be archived.

Procedure
1. Choose the ALE Customizing transaction SALE Set Up System Monitoring IDoc Status Display Edit IDoc Status
Values (WE47) .

2. To change entries, choose .

This is custom documentation. For more information, please visit SAP Help Portal. 128
 4/6/25, 11:39 PM

3. Select the required status. By double-clicking you can call a detail screen, in which you can display or change the
archivability.

4. By using or you can display or change all statuses one after another.

Archiving Functions for IDocs

Use

Data is usually archived via the central transaction SARA. In the case of IDocs, the corresponding tables are addressed via the
archiving object IDOC.

Integration

Various processing methods are assigned to the IDOC archiving class: In the standard system, therefore, IDocs can be:

Archived

Deleted from the database

Reloaded from an archive: On the initial screen, choose Goto Reload

 Example
All of the IDocs generated by sales orders (message type ORDERS, IDoc inbound processing) in the month of January
are to be archived and subsequently deleted from the database tables. To do this, choose the "Archive" processing
method in the standard system and enter a time period and message type as report variants.

In addition, you can display the following:

Archive

Several IDocs are usually archived in one archive or archiving session, that is, the IDocs are grouped together in one
session. An archiving session is complete when the IDocs have been deleted from the database tables and exist only as
archive files.

The IDoc numbers of one or several archives or archive files

The IDocs (that is, control record, data- and status records) of one or several archives

IDocs from archives, that contain certain character strings (IDoc search)

This function is not a method of the IDOC archiving object, but rather an IDoc interface monitoring tool and hence only
available from the initial node.

Activities

You can also access the central transaction SARA by choosing Tools Administration Administration Data Archiving . Here
you enter the archiving object IDOC. When you select 'enter' the methods entered above are displayed for selection.

In object-specific Customizing, you can define the maximum size of the archive files and that the table entries are to be be deleted
from the database immediately after the archive files have been generated. With large datasets this can improve the performance.

In the standard system, the IDocs are selected for archiving according to certain criteria, for example the time at which the IDocs
were last changed (new status record). You can also define your own selection criteria. For more information, see subsection

This is custom documentation. For more information, please visit SAP Help Portal. 129
 4/6/25, 11:39 PM
Archiving:Technical Implementation

Archiving and Deleting IDocs

Prerequisites
The IDocs to be archived have an archivable status.

Procedure
1. Go to the central archiving transaction with SAP Menu Administration System Administration Administration
Data Archiving (transaction code SARA) . If necessary, check the object-specific Customizing:

Here, for example, you can set the indicator "detailed statement" in the variant to the deletion program: If required, this can
be entered in the archiving log of each individual IDoc which is archived. However, this can lead to very large logs which do
not necessarily contain useful information.

2. Enter the archiving object IDOC and choose the required action, here .

A warning will be displayed if some of the archiving sessions for the archiving object IDoc are still incomplete. You can
ignore the warning but you then run the risk of possibly archiving some IDocs twice.

3. Define the start date of the archiving session and the spool parameters (print output).

The traffic lights should now be green, indicating that these parameters have been maintained. Please note that you can set
the archiving mode for the print output to Store Only and therefore avoid printing every individual archiving log. Enter the
object type IDOC as the attachment parameter and use the F4 Help to select a suitable document type for the object type.
Also enter a free text as additional information for the archiving report.

4. Choose to create a report variant. As selection parameters, enter the message type and a time period within which the
IDocs received their last, current status.

 Note
You can specify whether you want to perform this variant as a Test run or Production run, in the Process Flow segment
on the selection parameter screen. If you choose Test, you get statistics of the processed IDocs. For a detailed log, select
Detailed Log.

Choose and save your variant.

5. Return to the archiving screen and choose .

If you selected immediately as the start date in step 3, the message New archiving job was generated is displayed in the
message bar at the bottom of the screen.

6. You can check whether your archiving session is complete by selecting Job overview. If you choose Administration, an
overview of the completed and incomplete archiving runs is then displayed. If IDocs which match your selection parameters
were found in the database tables, your archiving session is displayed as a folder full of archive files.

7. If not defined differently in object-specific Customizing, your IDocs are still located in the database after archiving, that is,
your archiving session is incomplete. To delete the IDocs, you must schedule a deletion job with the appropriate variant.
Choose the archive file from which the IDocs are to be deleted from the database.

Listing IDoc Numbers in Archive

This is custom documentation. For more information, please visit SAP Help Portal. 130
 4/6/25, 11:39 PM

Procedure

1. Choose Evaluate in the initial screen of the central archiving transaction.

2. Choose Execute.

The system displays the complete archiving sessions.

3. Select one or several sessions or files contained within and confirm your selection.

A list of IDocs from the archive files selected is displayed. As well as the IDoc number, the "logical" message, for example, is
output (output fields of report RSXARCR).

IDoc Search

Use
Users should be able to find IDocs not only by means of the address information or control information in the control record but
also according to the business data they contain. Questions like the following example should also be able to be answered: "Which
IDocs contain purchase orders for my material XY?"

The IDoc search function can be used to answer such questions. You can search for IDocs both in the database and in archive files.

Features

The function searches for character strings, that is, you must enter the value of a segment field as it appears in the field itself
(avoiding full stops and commas whenever possible).

You can enter a maximum of two values in two segment fields as selection criteria. If two values are entered, both must be present
in the IDoc in the corresponding segment fields for the IDoc to be included in the list of results (normal AND link in selection
fields).

You can also choose to only give the value instead of the segment field. This means that all data records (more precisely: the field
SDATA in the data records) are searched for in a non-structured manner in the character string, that is to say, the character string
which is found may span several segment fields.

If you select Quick Search mode, the search can be limited to a maximum of one hit in each IDoc, that is, the system terminates
the search in the current IDoc after one hit.

The search can and should also be restricted by entering additional search criteria which require values from the control record (in
the same way as the other monitoring programs): creation time, partner and message, direction, and so on.

This is custom documentation. For more information, please visit SAP Help Portal. 131
 4/6/25, 11:39 PM

Activities
1. Choose transaction WE09 ( SAP Menu Tools IDoc Interface/ALE Administration Services IDoc Search by
Contents WE09 ).

2. Choose the Data Source button to specify whether you want to search for IDocs from the database or the archive (or both) .

3. If you have set the Archive flag, you can select files using the archive information system or manually.

 Note
To be able to search in the archive information system, you must have

Deleted the IDocs from the database (complete archiving session)

Created an archive info structure in the central transaction SARA

4. Specify all available selection parameters, to restrict the IDoc search as far as possible.

Archiving: Technical Implementation

Use
The IDoc archiving tools were developed with the Archive Development Kit ( ADK), which supports object-oriented programming
methods. This has led to the use of archiving object IDOC, which contains the necessary database tables and the archiving class
IDOC, which has the function modules required for processing.

The archiving object IDOC is accessed "from outside" using reports which (indirectly) call the ADK function modules. The selection
parameters for these reports are configured in the variant maintenance function for the central archiving transaction. The ADK
function modules, in turn, use the function modules from archiving class IDOC to access the database tables. The figure below
illustrates this object-oriented structure.

This is custom documentation. For more information, please visit SAP Help Portal. 132
 4/6/25, 11:39 PM

All the function modules in the archiving class IDOC belong to the function group EDIA. This function group also includes the
function modules which the archiving programs use to call the ADK functions.

This is custom documentation. For more information, please visit SAP Help Portal. 133
 4/6/25, 11:39 PM

 Caution
In computer literature, data and the corresponding functions are sometimes combined in classes (for example, in C++). As you
can see, the term "class", as used here, refers to the "archiving object" which contains the data (the lines in the database table),
as well as the "archiving class" IDOC, which contains the corresponding functions.

The reports supplied with the standard system can be used as sample reports to write your own reports with selection parameters
which meet your requirements. For more information about standard reports, see Archiving: Descriptions of Standard Reports.

Authorizations for IDoc Archiving

Use

 Note
You need only the general archiving authorization.

Archiving: Descriptions of Standard Reports

Use

The following section contains information about the initial reports and the function module which they call from the function
group EDIA. This function module, in turn, calls the ADK standard class function modules. The reports are addressed by the central
archiving transaction SARA.

In order to address programs through the central archiving transaction SARA, you must replace the standard reports with the
programs in transaction AOBJ.

Name Description Selection Parameters

RSEXARCA Writes IDocs to the archive.

Time at which the control record
Calls EDI_ARCHIVE_IDOCS. was last changed

Uses the subroutine Time of IDoc creation

INITIALIZE_STATUS_QUALITY
Current status
(function group EDIA) to check whether the
IDocs can be archived. Logical message

Direction

IDoc number

Partner

RSEXARCD Deletes archived IDocs from the database. Archive files from incomplete archiving
sessions
Calls EDI_DELETE_ARCHIVED_IDOCS.

RSEXARCR Reads IDocs from an archive. Archive files from complete archiving
sessions
Calls EDI_READ_IDOC _ARCHIVE. Displays
the following control record fields for each
IDoc:

This is custom documentation. For more information, please visit SAP Help Portal. 134
 4/6/25, 11:39 PM
Logical message

Status

Date and time at which the control

record for the IDoc was last
changed

Direction

IDoc number

RSEXARCL Retrieves IDocs from the archive into the Archive files from complete archiving
database. Calls EDI_RELOAD_IDOC sessions
_ARCHIVE. Checks for client or IDoc
number conflicts via
IS_RELOADING_POSSIBLE (subroutine for
function group EDIA). Writes the new status
"35" for outbound IDocs, "71" for inbound
IDocs ("reloaded"). "Detailed statement"
indicator as for RSEXARCA.

RSEXARCI Creates index in table EDIDOCINDX. Calls None: Reads the archive files of the IDOC
ADK function module directly. object class.

RSEXARCJ Removes index in table EDIDOCINDX. Calls Date up to which the indexes should be
ADK function module directly. deleted.

Number of records after which a database

COMMIT should be transmitted.

Database Tables

Use

Definition

The IDOC archiving object for archiving IDocs consists of the following IDoc database tables:

Table Description

EDIDC Contains the IDoc control record

EDID4 Contains the IDoc data records

EDIDS Contains the IDoc data records

Deleting Links with IDocs

Context
As the IDoc number increases, not only the data records table gets bigger. The tables which contain links with application
documents, for example, also get bigger and from time to time should be emptied of obsolete entries.

This is custom documentation. For more information, please visit SAP Help Portal. 135
 4/6/25, 11:39 PM

 Note
IDocs links are always archived with them.

Procedure

1. Start the program RSRLDREL.

2. Enter a suitable end date.

The end date is suitable if all links that were generated before are no longer needed. For example, if you have already
archived and deleted all IDocs before this date and the application documents are also archived, you no longer need the
corresponding links (exception: Application documents and IDocs are to be retrieved from the archive into the SAP
System).

3. Select Selection by link type and enter a link type. Also refer to the table below.

Alternatively, you can do the selection by object/role. If, for example, you want to delete all links with standard orders, then
you should make your selections according to object type BUS2032 (standard order) in the function APPLOBJ.

If you want to delete the following links... Then select the link type...

Application document with outbound IDoc IDC0

Inbound IDoc with application document IDC1

Outbound IDoc with application document in the target system IDC9

Inbound IDoc with application document from the upstream IDCB

system

Inbound IDoc with communication IDocs in distributed systems IDC2

Copy of an IDoc with its original IDC3 (inbound), IDC7 (outbound)

Inbound IDoc with outbound IDoc from the upstream system IDC4

IDoc with TID ( port type tRFC, ALE audit). Does not work with IDC8 (inbound), IDCA (outbound)
deletion criterion. Both objects not available.

Outbound IDoc with reference IDoc (type IDCREF01) IDRF

You want to delete links last. Choose Both objects not available. If now, for example, only the application document
is available, you can actually display the numbers of the linked IDocs from the document, but no longer the IDocs
themselves.

 Note
This option does not work for links with TIDs (for ALE audit) although they appear to be there.

You want to delete the links if at least one of the two objects is no longer there (option One object not available).
Then, for example, you can no longer display the numbers of IDocs that have already been deleted from an
application document.

You generally want to delete all links that meet the other selection criteria. Select Without existence check.

This is custom documentation. For more information, please visit SAP Help Portal. 136
 4/6/25, 11:39 PM
You can perform a test run. Then the system only notifies you of the number of links that meet the selection criteria,
but does not delete them.

Data Aging for IDocs

The data aging object BC_IDOC supports data aging (see also Data Aging).

Use

IDocs are stored on the database in the tables EDIDC (control records), EDID4 (data records), and EDIDS (status records). To
relieve the working memory, IDocs can be moved from the HOT area to the COLD area depending on their status and time. This
procedure is called Data Aging for IDocs. The moved IDocs are still visible in the system, they can be deleted or archived but can
no longer be changed or processed. The aging object BC_IDOC contains the tables EDID4 (data records) and EDIDS (status
records).

Prerequisites
Your database must support data aging. Note the following in particular:

Prerequisites for Data Aging

Activities
1. Determining the Status

IDocs that are in a currently archivable status can be moved to the COLD area. You should check your IDocs for this
(Displaying or Changing the Archivable Status). IDocs that can still be processed are excluded from data aging. This affects
the following IDoc status values:

64 IDoc is ready to be transferred to the application

66 IDoc waiting for predecessor IDoc (serialization)

51 Application documentation not posted

75 IDoc is in the inbound queue

69 IDoc was edited

2. Maintaining the Residence Times

Only IDocs that were not changed or edited in the last 14 days are taken into consideration for data aging when using
standard settings. If, however, you want to use longer or shorter times, for example, for specific message types or partners,
use transaction Residence Times for Message Types or Partners (WEIDOCDAAG).

You can store different times for the following key fields:

Message type

IDoc Type

Enhancement

Sender or receiver report

Partner type

Partner number

Direction (inbound or outbound)

A more specific entry overwrites a less specific entry.

This is custom documentation. For more information, please visit SAP Help Portal. 137
 4/6/25, 11:39 PM

Example

Table Field Example 1 Example 2

Message type ORDERS ORDERS

IDoc Type ORDERS04

Enhancement

Partner port MYREMOTE

Partner type

Partner number

Direction

Residence time 3 12

The example above shows the following case:

IDocs with the message type ORDERS should be taken into consideration for a data aging run after just 3 days (Example 1). In
contrast to this rule, IDocs of partner port MYREMOTE (sent as ORDERS04) are left in the HOT area for 12 days (Example 2).

Archiving Table Change Logs (BC-DWB-CUS)

Definition

The archiving object BC_DBLOGS is used for archiving Customizing table change logs. The SAP system logs Customizing table
changes if:

1. The Log Data Changes checkbox has been selected in the technical settings for the table.

2. Logging is active.

 Note
Logging can be activated and deactivated for a particular client using the profile parameter rec/client.

Use

We recommend that you archive the change logs periodically, for example, quarterly or annually.

Structure

The logs are saved in the table DBTABLOG. The archiving object archives this table only.

The following functions are available for BC_DBLOGS:

Function/Program Assignment

Function Program

This is custom documentation. For more information, please visit SAP Help Portal. 138
 4/6/25, 11:39 PM

Write BC_DBLOGS_WRI

Delete RSLDARCH02

Read RSLDARCH03 (for the entire archiving session)

BC_DBLOGS_READ_AR_BY_INDEX

 Caution
Archiving automatically generates a comment in the
archiving session management entry. This comment
contains the time period that was archived. Do not
delete this text.

Read

For a read by program RSLDARCH03, the archive contents are

output in the form of a print list. You can evaluate and print the
table logs using the IMG Log (transaction SCU3).

For a read by program BC_DBLOGS_READ_AR_BY_INDEX, the

results are output in the form of an ALV Grid. Under Extras, you can
choose the data source from which the data is read. The options
that are available depend on whether you call the program in
archive management (transaction SARA) or in the ABAP Editor
(transaction SE38). Using the ABAP Editor, you can specify
whether the data is read from the database or from the archive. If
you choose to access the archive, then you can either select the
archived data manually, or you can read the data from the Archive
Information System based on an index. The prerequisite for reading
the data from the Archive Information System is that you have
activated the info structure SAP_BC_DBLOGS in transaction SARI.
This info structure is filled automatically after each archiving run.
However, you can also generate it explicitly in transaction SARI.

Integration

This archiving object does not depend on any other archiving

objects.

Log entries are archived independently of the client.

You can use the archiving object BC_DBLOGS within the framework
of Information Lifecycle Management. To be able to do this, you
must activate the related business functions. The system then
shows the ILM Actions group box. Using these actions, you can, for
example, run archiving during which the system evaluates the
retention periods entered in Information Retention Manager. You
can also create snapshots (copies) of data, and you can delete data
that does not meet your criteria.

Technical Data (BC-BEW-CTL)

This is custom documentation. For more information, please visit SAP Help Portal. 139
 4/6/25, 11:39 PM
Technical Data (BC-BEW-CTL)

An internal run-time analysis run in a highly-loaded development system showed that ca 100.000 log entries are archived in an
hour.

Variant Settings for Archiving (BC-DWB-CUS)

Use
Archiving checklist

Features
In the change logs, you specify which time interval is archived. You must specify the date and time of the beginning and end of the
time interval.

The system shows the ILM Actions group box if you are using the archiving object in Information Lifecycle Management and have
fulfilled the prerequisites for this (for example, you have activated the corresponding business functions). You can use these
actions to archive data during which, for example, the retention periods entered in the Information Retention Manager can be
evaluated. Additionally, you can create snapshots (copies) of data or destroy data that matches the requirements.

Under Log Settings you can specify the type of log (a complete detailed log or a partial log) and the type of log output. You can also
enter a comment for the archiving session. For more information, see Logs.

Archiving Object-Specific Customizing (BC-DWB-CUS)

Archiving Object-Specific Customizing (BC-DWB-CUS)

Use

Archiving Object-Specific Customizing

Activities

A data object is defined as 1.000 table entries for the object BC_DBLOGS for the input field Maximum no. of data objects in the
group box Archive file size.

By contrast, the Commit counter in the group box Deletion program settings refers to table entries not data objects.

This is custom documentation. For more information, please visit SAP Help Portal. 140
 4/6/25, 11:39 PM

Archiving Link Entries (BC-SRV-ARL)

Archiving Link Entries (BC-SRV-ARL)

Definition

The archiving object ARCHIVELNK is used to archive ArchiveLink link entries.

Use

A link entry is a unique reference from a document stored in an external storage system (using ArchiveLink) to a business object
generated in the SAP application component.

To create the link between the business objects in the SAP application and the documents in the external storage system, you
must carry out the following administrative tasks in the SAP System:

Definition of document types

Definition of storage systems

Assignment of document types and object types to storage systems and link tables

The business object is assigned to the corresponding stored document in the link table in the database.

You can specify an expiry date for each link entry. When the expiry date is reached, you can archive the link entry/entries and
delete them from the database using the ADK archiving transaction.

Structure

When you implement the archiving object ARCHIVELNK , data from the various ArchiveLink link tables is archived. For information
on table names and the number and names of link entries, choose Tools → Business Documents, → Miscellaneous → Stored
Documents → Stored documents → Expiry date → Display or Analyze.

The following functions are available for ARCHIVELNK :

Action Report

Archive OAARCH04

Delete OAARCH06

Reading OAARCH05

To call the transaction for archiving link entries, choose Tools → Administration → Administration → Archiving .

Application Customizing (BC-SRV-ARL)

Use
As well as basic Customizing for archiving, you must make settings in ArchiveLink basic Customizing for the generation of link
entries:

This is custom documentation. For more information, please visit SAP Help Portal. 141
 4/6/25, 11:39 PM
Maintain document types and classes

Maintain storage systems

Maintain links and link tables

You must also define retention times for the link entries.

Features
ArchiveLink Basic Customizing

For information about ArchiveLink Customizing, see Basic Customizing. You can also find the IMG activities for ArchiveLink in the
Implementation Guide (IMG), under SAP Web Application Server → Basis Services → ArchiveLink → Basic Customizing.

Retention Times for Link Entries

You should maintain retention times when you maintain the links. The retention period is the number of months after which a link
entry for a stored document can be removed from the link table.

Activities
For more information on setting or changing the retention period, see Setting Retention Periods (BC-SRV-ARL).

Setting Retention Periods (BC-SRV-ARL)

Setting Retention Periods (BC-SRV-ARL)

1. Choose Links, and enter the required retention period in months in the field Retention period.

2. Choose Tools → Business Documents → Miscellaneous → Stored Documents → Stored documents → Expiry date →
Change

3. Enter the required business object.

4. Enter the corresponding document type.

5. Specify whether or not it is a test run.

6. If it is a test run, a list of all the link entries with the newly calculated expiry date is displayed.

To change the expiry date, you need administration authorization for ArchiveLink (see Authorizations).

7. Choose Program → Execute.

A message confirming that the deletion date has been re-calculated is displayed.

Archiving Archive Administration Data (BC-CCM-ADK)

Definition
You can use archiving object BC_ARCHIVE to archive and delete archive administration data.

This is custom documentation. For more information, please visit SAP Help Portal. 142
 4/6/25, 11:39 PM

Use
You can use this archiving object to store information about archiving sessions that were selected for archiving in the management
of archiving objects.

Structure
Tables

The archiving object BC_ARCHIVE consists of the following tables, from which data is archived and deleted (valid for both ADK and
XML archiving objects):

Table Description

ADMI_RUN Header data for archiving sessions

ADMI_FILES Archive files for archiving sessions

ADMI_VARIA Content of archiving program variant

ADMI_SKIP Address of data objects that should be skipped

<Info-Tab> Archive file info table for an archiving object

ADMI_XRUN Archive files for archiving sessions of XML archiving objects

ADMI_XDOCS Resources (XML Archiving)

In addition, the archiving object uses the archiving class TEXT, which covers the following tables:

Table Table name

STXB SAPscript: Texts in non-SAPscript format

STXH STXD SAPscript text-file header

STXL STXD SAPscript text-file lines

Programs

BC_ARCHIVEis shipped with the following programs:

Program Function

BC_ARCHIVE_PRE Preprocessing

RSAADMAR Write

RSAADMLO Delete

RSAADMRL Reload

See also:

Archive Administration Data (BC-CCM-ADK)

This is custom documentation. For more information, please visit SAP Help Portal. 143
 4/6/25, 11:39 PM
Reloading Data

Variant Settings for Preprocessing (BC-CCM-ADK)

Use
You can use this program to set the To Be Archived indicator for several archiving sessions through mass processing. The program
can process archiving sessions for ADK and XML archiving objects.

Features
Selection Criteria

Under Archiving Sessions you can restrict the sessions to be marked using the following criteria:

Archiving Session

Number of the archiving session

Archiving Object

Archiving object to which the session belongs

Further Selection Criteria

Under Further Selection Criteria you can use additional criteria to further restrict your selection:

Date of Archiving Session

Creation date of the archiving session

Started by

User that started the archiving session

Additional Selection Criteria for ADK Archiving Objects

For ADK archiving objects you can enter the following additional selection criteria:

Stored in Archive System

Of the selected sessions, the program only marks those sessions for archiving, for which all archive files have been stored in
the storage system.

Sessions without Accessible Files

This is custom documentation. For more information, please visit SAP Help Portal. 144
 4/6/25, 11:39 PM
Of the selected sessions the program only marks those sessions for archiving for which no archive files are accessible in
the file system and for which no archive file has been stored in the storage system.

Additional Selection Criteria for XML Archiving Objects

For XML archiving objects you can enter the following additional selection criteria:

Sessions without Accessible Resources

Of the selected sessions the program only marks those sessions for archiving for which no accessible resources exist.

Additional Settings

The Processing Control, Log Options, and Archiving Session Note settings are standard settings that also apply to archiving
objects. For more information see the general archiving documentation under Variant Maintenance for Archiving Jobs.

See also:

Archiving Archive Administration Data (BC-CCM-ADK)

Variant Settings for Writing (BC-CCM-ADK)

Use

When you schedule the write program you must enter an already existing variant or create a new one. The variant contains
selection criteria for the administration data that you want to archive.

Features

Further Selection Criteria

Here you can enter criteria to select the data to be archived. The selection can take place using the client and the archiving object.

Additional Settings

The processing options, the log options, and the archiving session note are standard settings that also apply to other archiving
objects. For more information see the general archiving documentation under Variant Maintenance for Archiving Jobs.

See also:

Archiving Archive Administration Data (BC-CCM-ADK)

This is custom documentation. For more information, please visit SAP Help Portal. 145
 4/6/25, 11:39 PM

Variant Settings for Reloading (BC-CCM-ADK)

Use
You can use this function to reload archive administration data that was archived using archiving object BC_ARCHIVE back to the
database.

Prerequisites
Archiving sessions must exist for which the delete program ran in production mode.

Features
Further Selection Criteria

Here you can select the data to be reloaded. You can make your selection based on Client or Archiving Object.

Additional Settings

The Processing Options, the Log Options, and the Log Output option are standard settings that are also valid for other archiving
objects. For more information see the general documentation under Variant Maintenance for Archiving Jobs.

Activities
After you have reloaded the data, the system removes the To Be Archived indicator, so that the reloaded information is displayed
directly in Archive Administration (Archive Administration, Management Action). The system does not create a new archiving
session during reloading. Instead, the archiving session for which the data was reloaded remains in Archive Administration under
Completed Archiving Sessions and can still be evaluated there.

After reloading has been completed, the system issues a list of reloaded administration data.

See also:

Archiving Archive Administration Data (BC-CCM-ADK)

Reloading Data

Archive Administration Data (BC-CCM-ADK)

Setting the To Be ArchivedIndicator

This is custom documentation. For more information, please visit SAP Help Portal. 146
 4/6/25, 11:39 PM
Before you can archive the administration data of archiving sessions, you must indicate that these sessions are ready to be
archived. You have two options for setting this indicator:

manually (for individual sessions)

automatically (for several sessions; mass processing)

Setting the To Be Archived Indicator Manually

1. Call Archive Administration (transaction SARA) and enter the archiving object for which you want to archive administration
data.

2. Choose Management to display the relevant administration data.

3. Double click the desired archiving session and in the dialog box that appears choose the change mode.

4. Choose the To Be Archived indicator. Sessions for which you set the indicator in this manner appear subsequently as
Archiving Sessions Marked for Deletion in Archive Administration.

Setting the To Be Archived Indicator Automatically

If you want to archive the administration data of several archiving sessions, it is recommended that you set the To Be Archived
indicator automatically through the preprocessing program. The program can process archiving sessions of ADK and XML
archiving objects. You can select the archiving sessions to be archived in the selection screen of the preprocessing program, see
Variant Settings for Preprocessing (BC-CCM-ADK).

Archiving the Administration Data

In Archive Administration enter the archiving object BC_ARCHIVE and schedule archiving as usual.

 Caution
You can only archive administration data if no further jobs exist for the selected sessions. This means that there may not be any
entries left in the job overview of the archiving object.

Result

The archiving session you started writes the selected session information to one archive and deletes it from the database (whether
or not the data is deleted depends on the Customizing settings for the automatic start of the delete program, and the variant you
chose). The new archiving session then appears in the archive administration data of BC_ARCHIVE.

Archiving Change Documents (BC-SRV-ASF-CHD)

Background
Application programs write change documents for statutory or technical reasons. They must sometimes be retained for a long
time. Documents which no longer require direct access can be archived, to reduce the database load. They are then saved in these
archives for the statutory or technically-required period.

Technical Implementation

This is custom documentation. For more information, please visit SAP Help Portal. 147
 4/6/25, 11:39 PM
The archiving tools for change documents were developed with the Archive Development Kit (ADK), which supports object-
oriented programming methods. This refers to the archiving object CHANGEDOCU that contains the required database tables and
the archiving class CHANGEDOCU with the function modules to process them. If you want to access the archiving object
CHANGEDOCU, you have to use a report. All of the function modules in the CHANGEDOCU archiving class belong to the SCD5
function group. This function group also includes the function modules which the archiving programs use to call the ADK
functions.

Database tables
The CHANGEDOCU archiving object for archiving change documents contains the following database tables:

Table Description

CDKEYTAB Virtual table with the object key (only in archive, not in database)

CDHDR Change document header in the database

CDPOS Change document items in the database

CDPOS_UID Change document item key per table, if it is > 70 characters.

CDPOS-TBAKEY contains the UID for this entry.

CDPOS_STR The change document item for STRING fields in CDPOS-TBAKEY

then contains the UID for this entry.

Authorizations
If you want to archive, you need authorization for:

Archiving in general

For more information, see User Authorization Checks

Integration

You can display archived change documents with the Archive Explorer (transaction SARE).

To display each table in archiving object CHANGEDOCU using the Archive Information System, you need an information structure
based on the standard field catalog SAP_CHANGEDOCU1 delivered by SAP. The information structure must be set up and active.

For more information about information structures, see also Using the Archive Information System.

Variant Settings for Writing (BC-SRV-ASF-CHD)

Use

When you schedule the write program you must enter an already existing variant or create a new one. The variant contains
selection criteria for the change documents that you want to archive.

Features

Selecting Documents

This is custom documentation. For more information, please visit SAP Help Portal. 148
 4/6/25, 11:39 PM
In the Change Documents frame, you can select the documents you want to archive based on the following criteria:

Change doc. Object

Name of the change document whose entries are to be archived, such as ADRESSE

Object value

Value assigned to the change document object, such as BC010000002852

Further Selection Criteria

Here you can further restrict the set of documents to be archived:

From Date

Date as of which the change was executed

To Date

Date up to which the change was executed

From Time

Time as of which the change was executed

To Time

Time until the change was executed

Transaction code

Name of the transaction in which the change took place

Changed by (User Name)

Name of the user, who made the changes

Additional Settings

The processing options, the log options, and the archiving session note are standard settings that also apply to other archiving
objects. For more information see the general archiving documentation under Variant Maintenance for Archiving Jobs.

See also:

Creating Archive Files

Descriptions of Standard Reports

Use
This is an overview of the archiving programs to write, read, delete and reload change document data.

 Caution
These programs only archive the change document data. Connections to master data arh lost.

This is custom documentation. For more information, please visit SAP Help Portal. 149
 4/6/25, 11:39 PM
If you want to archive the change document data with its master data, the developers of these archiving objects must put the
archiving class CHANGEDOCU in their archiving object.

CHANGEDOCU_WRI Change documents: Write program

CHANGEDOCU_DEL Change documents: Deletion program

CHANGEDOCU_READ Read selected change documents from the database or from the
archive

CHANGEDOCU_REL Change documents: Reload program

RSSCD7AR Change documents - Write program

CHANGEDOCU_WRI

The data for the archive object CHANGEDOCU is written from the database into the archive.

You can specify the following selection parameters:

Change document object

(CDHDR-OBJECTCLAS e.g. MATERIAL)

Object value

CDHDR- OBJECTID e.g. 000000000000004711)

From Date

To Date

From Time (HH:MM:SS)

From Time (HH:MM:SS)

Transaction Code

User name of changer

In the flow control, choose:

Test mode

(No archiving - only simulation and output of the statistics)

Production Mode

(actual archiving)

In the detail log, you can choose:

No detail log

No success messages

Complete

In the log output, you can choose:

List

This is custom documentation. For more information, please visit SAP Help Portal. 150
 4/6/25, 11:39 PM
Application log

List and application log

You can enter a name for this archiving session, in the archiving session notes.

CHANGEDOCU_DEL

Deletes the change documents from the tables CDHDR, CDPOS, CDPOS_UID (from SAP Basis Release 6.20), CDPOS_STR (from
SAP Basis Release 7.0), which were archived in a selected archive.

Flow Control:

Test mode

(no deletion from DB - simulation and output of statistics)

Production Mode

(Delete from DB)

CHANGEDOCU_READ

Displays the change documents from the tables CDHDR, CDPOS, CDPOS_UID (from SAP Basis Release 6.10), CDPOS_STR (from
SAP Basis Release 7.0), which were archived in a selected archive, or saved in the database.

There are two ways to selecta a data source:

Database

Archive

Selection of archived change documents:

Change document object

(CDHDR-OBJECTCLAS e.g. MATERIAL)

Object value

(CDHDR- OBJECTID e.g. 000000000000004712)

Transaction Code

User name of changer

Time restriction:

From Date

To Date

From Time (HH:MM:SS)

From Time (HH:MM:SS)

Changed document caused by:

User

This is custom documentation. For more information, please visit SAP Help Portal. 151
 4/6/25, 11:39 PM
Transaction Code

CHANGEDOCU_REL

Reads the archived data in selected archives and writes it (fills the chabge document data) in the database tables CDHDR, CDPOS,
CDPOS_UID, CDPOS_STR. Duplicate entries are prevented.

You select the archives from among those offered. (Your archiving session names are useful here).

Archiving Long Text Logs (BC-SRV-ASF-AT)

Definition
Archiving of logged long texts with the archiving object S_AUT_LTXT.

 Note
The archiving object LO_CHVW has been revised within the framework of a project to standardize and optimize data archiving.
You can use the standardized archiving object by activating the business function Data Archiving: Standardization of Archiving
Objects (DA_ARCHOBJ_STANDARD_1). For more information see Data Archiving: Standardization of Archiving Objects or refer
to the business function documentation in the Switch Framework (transaction SFW5).

Use
A complete archiving cycle has the following 3 main steps:

Executing the preprocessing program:

The data to be archived is prepared for the write program.

Generating the archive files:

With the help of the write program, the long texts to be archived are sequentially written to newly generated archive files.
Note that archiving is client-dependent.

Executing the deletion program:

Once the long texts to be archived have been completely written to the archive files, the deletion program removes them
from the database. For security reasons, the system first reads the archived data, and does not start the deletion run until
this read operation has been completed successfully.

 Recommendation
SAP recommends that you perform the Delete Long Text Logs function (program S_AUT_DEL) prior to the start of archiving.
As a result, you ensure that irrelevant data records are not archived.

You should reload archived data into the database only in exceptional circumstances. For example, it may be necessary to reload
data if you discovered immediately after archiving that too much or the wrong data was archived. This data should be reloaded as
soon as possible after archiving has been carried out.

 Caution
After a release upgrade or code page switch, a reload of archived long texts may lead to a loss of data, and therefore must not
be carried out.

This is custom documentation. For more information, please visit SAP Help Portal. 152
 4/6/25, 11:39 PM
The reload program cannot be started if data of a non-archived preprocessing program exists. If necessary, discard this data
using the program S_AUT_ARCH_UNDO.

When you reload archived data, note that active info structures for the reloaded archive files must be manually deconstructed
(transaction SARI Status ).

The archiving programs use the Codepage information to format the data. A different data conversion may be required depending
on the current code page at the time of long text logging.

 Caution
If you changed the code page of the systems (for example as a result of an upgrade from SAP R/3 4.6C to SAP ERP including a
switchover to a two-byte Unicode code page), you have to record in the system the time at which this code page switch took
place. Specifying the wrong code page may result in loss of data.

You record the change in the code page in Customizing under SAP NetWeaver Application Server System Administration
Evaluation of Table Changes Document Code Page Migrations .

Structure

The archiving object S_AUT_LTXT archives the following tables:

AUT_D_STXH_ARCH

AUT_D_STXL_ARCH

The following programs are available for the archiving object:

Function Program:

Preprocessing S_AUT_ARCH_PRE

Write S_AUT_ARCH_WRI

Delete S_AUT_ARCH_DEL

Reload (to be run in exceptional cases only) S_AUT_ARCH_REL

Variant Settings for the Preprocessing Program (BC-SRV-ASF-

AT)

Use
The preprocessing program prepares the long text data for the write program, in order to save time during the writing of the
archive files.

Features
On the selection screen of the preprocessing program, you can enter an end date for archiving in the Long Text Logs area. All the
long texts that were created up to this date are prepared for archiving.

This is custom documentation. For more information, please visit SAP Help Portal. 153
 4/6/25, 11:39 PM

 Caution
This date must be in the past. In addition, it cannot fall in a period for which long texts were already archived.

You can enter a package size in the Options area. This defines the intervals (measured in number of long texts) in which changed
data is permanently stored on the database. If the packet size is too high, the program may terminate. The optimal value depends
on the configuration of your database system. The default value in the system is 1000.

Information on the other general selection options is available under Variant Maintenance for Archiving Jobs.

If data exists that resulted from a previous preprocessing program, but was not archived, the preprocessing program cannot be
restarted. A restart of the preprocessing program is only possible once this data has been removed from the system. This can be
done either by ending the archiving cycle that was started (write program and deletion program), or by discarding the data of the
preprocessing program using program S_AUT_ARCH_UNDO.

Variant Settings for the Write Program (BC-SRV-ASF-AT)

Use
The write program writes the long texts to archive files.

Prerequisites

It is essential that the preprocessing program has been completely finished before the write program is run.

Features
On the selection screen of the write program, you can choose between test and production mode in the Processing Options area.

If the write program of the archiving object is executed in test mode, the system only simulates the archiving in accordance with
the selection criteria you entered. An archive file is not created. You receive statistics on the table entries that would have been
written to the archive in production mode, as well as the size and number of archive files that would have been created.

In production mode of the write program for the archiving object, the system creates archive files in accordance with your
selection criteria. You receive statistics on the table entries that were written to the archive, as well as the size and number of
archive files that were created.

In addition, you can enter a comment on the archiving run, which for example contains information about the archived periods.
This comment appears at the following points:

In the overview of archiving runs in archive administration (transaction SARA). It can also be changed here.

During manual selection of archive files (e.g. evaluation programs). Here it facilitates selection of the archive files.

If you are using the archiving object within the framework of Information Lifecycle Management and the prerequisites for this are
satisfied (such as activation of the associated business functions), the ILM Actions frame is also shown. With the aid of these
actions, you can carry out an archiving in which the retention periods defined in the Information Retention Manager are
evaluated. Furthermore, you can make snapshots (copies) of data or destroy data that satisfies the appropriate criteria.

More Information
Variant Maintenance for Archiving Jobs
This is custom documentation. For more information, please visit SAP Help Portal. 154
 4/6/25, 11:39 PM

Variant Settings for the Deletion Program (BC-SRV-ASF-AT)

Use
Once the data objects have been written to the archive files, they are deleted from the database.

Features
It is essential that the write program has been completely finished before the deletion program is run. Here, you can schedule the
deletion program per archive file. You can do this manually or automatically. While the write program is running, you are not able to
start the deletion program.

 Note
In the Implementation Guide, you can enter specifications regarding the running of the deletion program for the archiving
object under SAP NetWeaver Application Server System Administration Data Archiving Archiving-Object-Specific
Customizing .

As in the write program, on the selection screen of the deletion program, you can choose between test and production mode in the
Processing Options area.

If you execute the deletion program of the archiving object in test mode, data is not deleted from the database; the deletion is only
simulated. You receive statistics on the table entries that would have been deleted from the database in production mode.

If you execute the deletion program of the archiving object in production mode, the archived data is deleted from the database. You
receive statistics about the deleted table entries.

Tracking Details for Archiving

Use

If you want to track details of the archiving, you can use the transaction S_AUT10 in enhancement mode to carry out an evaluation
of the logs of the table AUT_D_ARCH_HIST.

Prerequisites

In the standard system, logging is not active for AUT_D_ARCH_HIST. If you want to use this function, you must use the
transaction S_AUT01 to activate table logging for the table AUT_D_ARCH_HIST.

Features
In the evaluation of the table logs, you get the following detailed information:

Selection data of the preprocessing program (what data was included in this run)

Status of the archiving run: Empty (does not contain any data), Preprocessing Program Executed, Deletion Program
Executed or Reload Program Executed

Number of the archiving run in the Archive Development Kit (ADK)

Date/Time/User who ran the preprocessing, write, or deletion program or the program S_AUT_ARCH_UNDO

This is custom documentation. For more information, please visit SAP Help Portal. 155
 4/6/25, 11:39 PM

Evaluating Archived Long Texts

Use
You can display the archived long texts using the Archive Explorer of the Archive Information System. You can also access archived
texts directly from the transaction S_AUT10.

Prerequisites
For you to be able to carry out evaluation using the Archive Explorer, at least one archive info structure must be active and fully set
up.

Features
Archive Explorer

SAP supplies the archive info structure SAP_S_AUT_LTXT as the minimum instance of an archive info structure. For the archiving
object S_AUT_LTXT, the field catalog SAP_S_AUT_LTXT is available. On the basis of this, you can create your own info
structures, if you want to select further fields.

If the archive info structure was not active at the time of archiving, you must set it up manually (in the transaction SARI under
Status).

For the evaluation of referenced long texts, there must be no period for which data exists on the database that is followed by a
period for which data is archived. The program determines the long text on the basis of the data in the archive. Under these
conditions, it cannot be guaranteed that the displayed texts are correct. For example, the system could display a long text that
resulted from a later change, because this is the next available change in the archive. Archive the reloaded period again, or take
organizational measures to ensure that the reference target of a long text does not fall within the reloaded period.

Direct Access

In enhancement mode of the transaction S_AUT10, under Long Text Logs you can directly access the archived long texts. To do so,
specify that the system is to read from the archive when you choose the data source. You will find further information on the
transaction S_AUT10 under Evaluation of Logged Data.

Archiving Warehouse Management Records (LE-WM)

Batch programs have been provided to archive records in the Warehouse Management(WM) system and delete old data that is no
longer needed in the system. These programs can be used to free space in the database and to provide accessible records for
future reference.

Archiving Objects (LE-WM)

Technical Data of the Programs (LE-WM)

How to...

Set up the System to Run Archiving Programs (LE-WM)

Archive Warehouse Management Records (LE-WM)

This is custom documentation. For more information, please visit SAP Help Portal. 156
 4/6/25, 11:39 PM
Start a Test Run (LE-WM)

Read Archived Data (LE-WM)

Archiving Objects (LE-WM)

You can archive Warehouse Management (WM) records for the Warehouse Management system using the archiving objects and
reports in the following table:

Objects/Reports used for Archiving Records in the WM System

Object Table Report Records

RL_TA LTAK, LTAP RLREOT00S Transfer orders

RL_TB LTBK, LTBP RLREOB00S Transfer requirements

RL_LUBU LUBU RLREOU00 Posting change notices

RL_LINKP LINK, LINP RLREOI00 System inventory records

RL_LINV LINV RLREOH00 Inventory histories

RL_LSEG LSEG RLREOL00 Stock material movements

These reports archive processed records that have been in the WM system for a specific number of days. Using these programs, it
is possible to archive records for multiple warehouse numbers at the same time.

 Note
When you archive transfer orders for which employee performance data is to be recorded, the system checks whether the
performance data was processed in full. This is checked in the logical RTL database.

For test purposes, you can display a list of the records to be archived and deleted before you actually archive them. You can also
import archived data.

 Note
You can use these archiving objects in Information Lifecycle Management . You must have activated the corresponding
business functions to do this. The system then also shows the ILM Actions group box. You can use these actions to carry out
archiving, for example, where the retention periods stored in the Information Retention Manager can be evaluated. Additionally,
you can create snapshots (copies) of data or destroy data that matches the requirements. For more information, see ILM
Enhancements for Data Archiving , ILM Actions in the Write Program .

 Note
Archiving objects RL_LINKP, RL_LINV, RL_LUBU and RL_LSEG were revised in the course of a project to standardize and
optimize data archiving. You can use the standardized archiving object by activating the business function Data Archiving:
Standardization of Archiving Objects (technical name DA_ARCHOBJ_STANDARD_1). For more information, see the business
function documentation in the Switch Framework (transaction SFW5) in Data Archiving: Standardization of Archiving Objects .

Archiving Objects RL_TA and RL_TB

Write Program
This is custom documentation. For more information, please visit SAP Help Portal. 157
 4/6/25, 11:39 PM
The write program supports the ADK interruption concept, meaning that you can interrupt the write phase and continue it at a
later point in time. For more information, see Interrupting and Continuing Archiving Sessions .

On the selection screen for the write program, you can select the documents to be archived using selection criteria in the Transfer
Orders or Transfer Requirements and Restrictions group boxes. Under Process Control you can specify whether the write job is
started in test or production mode. If automatic starting of the deletion program was activated in the archiving object-specific
Customizing, you can also specify that the archiving object’s delete program is started with the test mode variant stored in the
archiving object-specific Customizing.

When the write program is executed, a compact log is written containing information about the processed data. On the selection
screen for the write program, you can specify that a detailed log is displayed. This contains the information found in the compact
log plus all the objects that were processed, including the corresponding messages.

Delete Program
The delete program contains the standard variants SAP&PROD (production mode) and SAP&TEST (test mode). During the write
and delete sessions, regular progress messages appear in the job log (background processing) and in the status line (dialog).

Access to Archived Data via the Archive Information System

The following field catalogs and information structures are provided for accessing archived transfer orders and requirements via
the Archive Information System (transaction SARI):

Archiving Object Field Catalog Information Structure

RL_TA SAP_RL_TA SAP_DRB_RL_TA

RL_TB SAP_RL_TB SAP_DRB_RL_TA

See also:

Transfer Orders in the DRB (LE-WM)

Transfer Requirements in the DRB (LE-WM)

Program Technical Data (MM-WM)

Memory Requirement

The amount of memory needed to archive records varies with the size and number of objects archived. For example, the memory
requirement for archiving transfer orders (TOs) is based on the following formula:

(TO header length + avg. no. of items) x no. of TOs

Run Time

The time needed to run the archiving program depends on the number of records that are archived and the system load and
performance.

Set up the System to Run Archiving Programs (LE-WM)

This is custom documentation. For more information, please visit SAP Help Portal. 158
 4/6/25, 11:39 PM
1. Check the path and archive names that are in the platform-independent table of archive names. The system then
references a physical data path that you can maintain as a system parameter.

You can find information about how to do this step in the SAP NetWeaver Implementation Guide.

2. Create variants for the reports:

Use Customizing for Archiving for the deletion report.

Use the archiving management transaction SARA for the archiving report.

3. In Customizing for Archiving , you determine the size of the archive file in MB and define the maximum number of
documents for each archive file.

4. If you want to save the archive optically, you also have to maintain the data for optical archiving in Customizing for
Archiving . For information about optical archiving, see the documentation on this topic.

In any case, you have to maintain the spool data and can decide whether you want the summary of the archived and deleted
documents to be printed or stored in a spool file.

You can find archiving management data using the transaction SARA. The PATH and FILE names under which the data is archived
are of particular significance.

Archiving WM Documents (LE-WM)

We recommend that you do not perform archiving directly in online mode, rather that you start it in the background, using the
archive management transaction SARA.

Archiving and deletion from the database are realized with two separate reports in Release 3.0. The archiving programs create the
archives and then start the delete programs as a separate job for each archive. The deletion reports can only delete data that you
have previously read from the archives (see also Schematic Procedure for Archiving).

The portion size of the archive files can be predefined. Performance is thereby improved considerably for large volumes of data,
since archiving and delete programs are processed in parallel.

Start a Test Run (LE-WM)

To determine how many documents will be archived, you can start these reports directly for a test run. You can also print the
displayed list.

1. In the SAP Main Menu select System Services Reporting .

2. The system displays the initial screen for starting reports.

3. Enter the report name (see table under Archiving Objects (MM-WM) ) and select Execute.

4. The system displays the initial screen.

5. Select only the check box for the Test run (do not delete) (for R L_TA and RL_TB this field is called Test mode ) field on the
initial screen of each report. Enter the number of days beyond which the records are to be archived. Do not select the check
box for the field Create archive (for RL_TA and RL_TB Production mode ).

6. You can also place a time limit on the archiving program. For example, you can limit the batch program to archive all
transfer orders that have been confirmed prior to 90 days ago. The system default is 200 days.

a. To display the log, select Execute .

This is custom documentation. For more information, please visit SAP Help Portal. 159
 4/6/25, 11:39 PM

 Note
When you start the report to archive and delete documents using the archiving management transaction SARA, the
system does not display a log online because these programs are started as a batch process.

Read Archived Data (LE-WM)

To read data that has been archived, select System Services Reporting from any menu and enter one of the following in the
Program field.

RLRB0001 Transfer requirements

RLRT0001 Transfer orders

RLRU0001 Posting change notices

RLRI0001 Inventory documents

RLRH0001 Inventory histories

The WM archive files have the general logical file name "ARCHIVE_DATA_FILE". You can start the reports used for reading the
archived files from archive management.

Archiving Deliveries (LE-SHP)

Definition

Archiving object RV_LIKP for archiving deliveries (inbound and outbound deliveries).

Use
Before using the archiving object for the first time, you should check Application Customizing.

Structure

Tables

When you use the archiving object RV_LIKP, data is archived from the following tables:

Table reference

Table Table name

EIKP Foreign Trade: Export/Import Header Data

EIPO Foreign Trade: Export/Import: Line Item Data

LIKP SD Document: Delivery: Header Data

LIPS SD Document: Delivery: Line Item Data

LIPSDG Appendix table for dangerous goods data

This is custom documentation. For more information, please visit SAP Help Portal. 160
 4/6/25, 11:39 PM

NAST Message Status

SADR Address Management: Company Data

VBFCL Sales Document Flow Cluster

VBPA SD document: Partner

VBUK SD Document: Header status and administrative data

VBUP SD Document: Item Status

VBUV Sales Document: Incompleteness log

LIPSDG Appendix table for dangerous goods data

DLFLD Non-changeable delivery fields (decentralized WMS)

LIPSPO LIPS reference data purchase order (decentralized WMS)

LIPSRF LIPS reference data (decentralized WMS)

 Note
To archive Handling Units, use the archiving object LE_HU (see also Archiving Handling Units (LO-HU)).

The following archiving classes are also archived:

Tables for Archiving Class TEXT

Tables for Archiving Class CHANGEDOCU

Programs

The following programs are delivered with RV_LIKP:

Program Function

S3LIKPWRS Write

S3LIKPDLS Delete

S3LIKPAU Analyze

S3LIKPPTS Check (preliminary)

S3LIKPRL Reload

The write program supports the ADK interruption concept, that is, you can interrupt the write phase and continue at a later point.
To be able to use this function, the Interruption Possible indicator must be set in Customizing (transaction AOBJ). This parameter
is not set by default. For more information, see Interrupting and Continuing Archiving Sessions.

The write program and the delete program output statistics on the archived or deleted data objects. The statistics can differ with
regard to both memory consumption and the affected database tables. Some data, such as the object lists of serial numbers, are
only written to the archive but are not deleted. Other data, such as index tables, are deleted but are not archived.

The standard variants SAP&PROD (production mode) and SAP&TEST (test mode) are delivered for the delete program. In the
preprocessing, write, and delete program, a progress message is regularly output in the job log and in the dialog (status line).

This is custom documentation. For more information, please visit SAP Help Portal. 161
 4/6/25, 11:39 PM
Call

To call the archiving of outbound deliveries, choose Shipping screen Environment Archiving Deliveries. To archive
inbound deliveries, choose Inbound Deliveries screen Environment Archiving Inbound Deliveries .

Alternatively, you can call archive administration under Tools Administration and then Administration Archiving and
enter RV_LIKP as the object name.

Integration
Outbound deliveries are to be archived before SD documents and billing documents. The sequence results from the linking of the
documents through the flow.

Inbound deliveries that are not relevant for goods movements can be archived only after the underlying purchase order has been
archived. Goods-movement-relevant inbound deliveries are completed after the goods receipt has been posted and can be
archived directly after the other conditions have been checked successfully.

If corresponding shipments exist (LE-TRA), deliveries can only be archived after these shipments have been archived.

 Note
You can use this archiving object in Information Lifecycle Management. The prerequisite for this is that you have activated the
associated business functions. The system then also displays the ILM Actions frame. With these actions, you can carry out an
archiving in which the retention periods defined in the Information Retention Manager are evaluated, for example. You can also
make snapshots (copies) of data or delete data that fulfills the prerequisites. For more information, see ILM Enhancements for
Data Archiving, in the section ILM Actions in the Write Program.

Enablement for Information Retrieval

The ILM object RV_LIKP assigned to this archiving object is enabled for use with the Information Retrieval Framework (IRF). The
IRF allows you to search for and retrieve personal data of a specified data subject, based on a data model you define in your
system. To help you get started with the data modeling process, SAP delivers an implementation of “BAdI: Tables Used by an ILM
Object” (BADI_DTINF_ILM_OBJ_TABLES) for RV_LIKP. See SAP Note 2743548 for more information.

Before you can start a search for personal data related to this ILM object, the following prerequisites must be fulfilled:

Assign the ILM object to a purpose for which the data was collected and processed using Customizing activity Maintain
Purposes (transaction DTINF_MAINTAIN_PURP).

If you also want to enable the retrieval of personal data stored in archive files, perform the following additional steps:

You use the Customizing activity Maintain Profiles (transaction DTINF_MAINT_PROFILE) to create a profile for the data
collection. In this profile, you define that archived personal data must be included in the search.

Ensure that for archiving object RV_LIKP, there is at least one active archive information structure that contains the
following selectable fields:

LIFNR (LIKP-LIFNR)

KUNNR (LKIP-KUNNR)

These fields are used by the IRF to determine which data should be fetched from the archive.

For more information, see Information Retrieval Framework (IRF).

This is custom documentation. For more information, please visit SAP Help Portal. 162
 4/6/25, 11:39 PM

Related Information
The Archiving Object
Variant Settings for Archiving (LE-SHP)
Variant Settings for Reloading (LE-SHP)
Analyzing an Existing Archive (LE-SHP)
Variant Settings for the Check (LE-SHP)
Deliveries in DRB (LE-SHP)

Special Archiving-Object-Specific Features (LE-SHP)

Archivability Checks

For deliveries you can use program S3LIKPPTS, which carries out an archivability check before documents are selected.The
program is scheduled as a preprocessing program.

See also:

Variant Settings for the Check (LE-SHP)

Checks (LE-SHP)
The following checks are carried out on a delivery before it can be archived:

Residence time

Flow (mandatory)

Status of the shipment document

Status of billing document

FI (optional)

Check residence of flow documents (optional)

Alternative database access (optional)

Residence time
A delivery can only be archived if a period defined in Customizing (residence time) has elapsed since the completion date. The
residence time is the time between the entry date of the document and the current date (system time). You have the option to use
the date of the last change to the document instead of the creation date as the residence time, by selecting the Change date
check box in the analysis or write program. Seealso:Application Customizing (LE-SHP) .

For this purpose, the system checks the following entries for the outbound delivery:

If a value has been maintained for delivery type and sales organization, then this value is checked in the document. If no
delivery type-specific entry exists, then the search is carried out using only the sales organization. If no residence time has
been maintained, the residence time is not used as an archivability criteria. The document can be archived immediately if it
has fulfilled the other criteria.

For this purpose, the system checks the following entries for the inbound delivery.

This is custom documentation. For more information, please visit SAP Help Portal. 163
 4/6/25, 11:39 PM
The residence time is checked only on the basis of the delivery type since inbound deliveries are not assigned to any sales
organization. In Customizing, maintain the entry Sales organization , as described under Application Customizing (LE-
SHP) .

The selection screen for the variants contains the checkbox Check doc. flow residence , with which you can set the basis for
calculation of the residence time.

If the checkbox is not set, then the residence time is calculated on the basis of the creation date of the document.

If the checkbox is set, then the residence time is calculated on the basis of the last flow document

Status of the shipment document

In the next stage, the transportation planning status is checked. If the shipment containing the delivery has a status of ‘A’ or ‘B’
(not processed or partially processed), then the delivery cannot be archived. If the shipment has status C (completed), then the
system also checks whether it has already been archived. If this is not the case, then the delivery cannot be archived.

Status of billing document

In the final stage, the status of the billing document is checked for the outbound deliveries, that is, the system checks whether the
billing document has been forwarded to Financial Accounting. The checking sequence for sales organization and delivery type is
the same as for the residence time. If no entry exists, then the status is set to ‘X’ (= to check).

Accounting documents
If the checkbox Check FI document is set, the system checks whether the billing document is settled in Financial Accounting (e.g.
via payment).

Alternative Database Access

If you select the Alternative DB access checkbox, you allow the database to use an alternative method for carrying out data
procurement This can, for example, be used to improve performance of the archiving program.

Variant Settings for Archiving (LE-SHP)

Use
When you schedule the write program you must enter an already existing variant or create a new one. The variant contains the
selection criteria for the deliveries you want to archive.

Integration
You can use the archiving object PR_ORDER within the framework of SAP NetWeaver Information Lifecycle Management . The
prerequisite for this is that you have activated the associated business functions. The system then additionally shows the ILM
Actions frame. With these actions, you can carry out an archiving in which the retention periods defined in the Information
Retention Manager are evaluated, for example. Furthermore, you can make snapshots (copies) of data or destroy data that
satisfies the prerequisites. Further information is available under ILM Enhancements in Data Archiving in the section ILM Actions in
the Write Program.

Features
This is custom documentation. For more information, please visit SAP Help Portal. 164
 4/6/25, 11:39 PM
Document Selection Criteria

You can choose the following selection criteria for the deliveries you want to archive under Deliveries and Restrictions :

Delivery type

The write program can process the following categories of deliveries:

Outbound deliveries and returns (sales document type J and T)

Inbound deliveries (sales document type 7)

Rough goods receipt (sales document type G)

Only one category of deliveries can be processed per archiving session.

Document number

Delivery type

Creation date

Shipping point/receiving point

Sales organization

Options

Residence time change date (sales document types J, T, 7, G)

If this indicator is set the residence time is calculated based on the last change date not the creation date. (For deliveries
that were not modified, the change date is identical to the creation date.)

Check residence of flow documents

If the checkbox is set, then the residence time is calculated on the basis of the creation date or change date of the
last flow document.

If the checkbox is not selected, then the residence time is calculated on the basis of the creation date or change
date of the delivery.

Do not check transportation planning status (sales document types J, T, 7)

Set this indicator if you want that the transportation planning status is not checked during the archivability check. The
deliveries relevant for transportation planning can also be archived if nothing else speaks against it. Independent of this
indicator a delivery is only archivable if a corresponding shipping document was already archived.

Make sure that if you use this indicator your residence time is long enough, to avoid accidentally archiving deliveries that
are needed for the planning of shipments.

Check FI document ( sales document types J, T)

Set this indicator if you want to check if all accounting documents belonging to a delivery have been balanced in accounting
(for example through payment).

Process Control
Choose Test Mode if you want the write program to simulate archiving for the selection criteria you entered. The system
reads the data, but does not create any archive files. The system produces statistics about the number of data records that
were read during the test run. You can delete the data later in a separate step by using the production mode variant of the
delete program.

This is custom documentation. For more information, please visit SAP Help Portal. 165
 4/6/25, 11:39 PM
Choose Production Mode when you start the write program to create actual archive files based on your selection criteria.

If in archiving-object-specific customizing you activated the automatic start of the delete program, you can also set the
indicator Delete with test variant (default setting). If this indicator is set the delete program of the archiving object is
started with the test mode variant saved in archiving-object-specific Customizing. If the indicator is not set, the delete
program starts with the production mode variant and the data is actually deleted from the database.

Detail Log

When you execute the write program, the system writes a log listing the number of archivable and not archivable deliveries in a
compact format. For the not archivable deliveries the log lists the reasons for why they were not archivable.

If you set the Detail Log indicator, the system produces a detail log which contains all the information of a normal log, plus a list of
all the objects that were processed with the corresponding messages.

The logs of the write and preprocessing programs can differ in terms of the number of not archivable deliveries, because the write
program accesses the database differently than the preprocessing program, due to performance reasons. The log of the write
program may be missing deliveries, for example, for which the archiving control has not been maintained.

Archiving Session Note

Here you can enter a text that describes the contents of the archiving session. This will help you search for the archiving session in
archive management, for example during the delete phase.

Activities
The following table provides an overview of some typical settings:

Task Settings

Test run
1. Select the delivery type (for example rough goods receipt)

2. Select the documents.

3. Select Test mode .

Production run
1. Select the delivery type (for example rough goods receipt)

2. Select the documents.

3. Enter the Residence time change date.

4. Set Check accounting document

5. Choose Production mode .

See also:

Creating Archive Files

Variant Settings for the Check (LE-SHP)

This is custom documentation. For more information, please visit SAP Help Portal. 166
 4/6/25, 11:39 PM

Use
When you schedule the preprocessing program you must enter an already existing variant or create a new one. The variant
contains the selection criteria for the deliveries you want to check.

 Note
You can also start the preprocessing program directly in the ABAP editor via report S3LIKPPTS.

Features
Document selection criteria

You can choose the following criteria for the deliveries you want to check, under Deliveries and Restrictions :

Delivery type

Document number

Delivery type

Creation date

Shipping point/Receiving point

Sales organization

For more information about the selection criteria see Variant Settings for Archiving (LE-SHP) .

Options

Residence time change date

Check residence of flow documents

Do not check transportation planning status

Check accounting document

For more information about these options see Variant Settings for Archiving (LE-SHP) .

Detail log

When you execute the preprocessing program, the system writes a log listing the number of archivable and not archivable
deliveries in a compact format. For the not archivable deliveries the log lists the reasons for why they were not archivable.

If you set the indicator Detail Log, the system produces a detail log which contains all the information of a normal log, plus a list of
all the objects that were processed with the corresponding messages.

The check log is divided into two sections – the header and the detail display. The header contains the statistical data of the check;
in the detail display shows the check status of each delivery. By clicking on a line that contains a delivery number you can call up
the order display transaction.

The logs of the write and preprocessing programs can differ in terms of the number of not archivable deliveries, because the write
program accesses the database differently than the preprocessing program, due to performance reasons. The log of the write
program may be missing deliveries, for example, for which the archiving control has not been maintained.

This is custom documentation. For more information, please visit SAP Help Portal. 167
 4/6/25, 11:39 PM

Variant Settings for Reloading (LE-SHP)

Use
You can set reloading criteria in variant settings for reloading.

 Caution

When reloading deliveries, the corresponding CO data is not simultaneously reloaded into the system. Therefore you should
reload deliveries only in case of emergency, for example, if documents were wrongly selected.

For this reason you cannot call this function up with the menu. Please contact your system administrator.

Features
The following options are available:

Entry Fields

Document selection

Select the documents to be reloaded.

Checkboxes

Test run

Select this option if you only want to simulate reloading, for example, to check possible errors.

See also:

Reloading Archived Data

Application Customizing (LE-SHP)

Use
In application Customizing you can set delivery-specific requirements for archiving.

RangeofFunctions
The following input fields are at your disposal:

Sales organization

Delivery type

Residence time of a delivery in days

You use these parameters to set the residence time for every combination of sales organization and delivery type.

This is custom documentation. For more information, please visit SAP Help Portal. 168
 4/6/25, 11:39 PM
Since inbound deliveries are not assigned to any sales organization, maintain a generic entry (X) for the sales organization
for this delivery type.

Check billing documents for completion

You use this parameter to check whether a billing document has been forwarded to Financial Accounting.

Entry Options in Application Customizing (V_TVARL)

The following table displays possible value combinations that you can use when maintaining views V_TVARL:

Sales organization Delivery type Document date

* *

0001 * 40

* LF 20

00* L* 100

0001 LF 1

The examples can be understood as follows:

1. The residence time is not used for any delivery types of any sales organizations.

2. A residence time of 40 days is used for all delivery types for sales organization 0001.

3. A residence time of 20 days is used for delivery type TA for all sales organizations.

4. A residence time of 100 days is used for all delivery types starting with L for all sales organizations starting with 00.

5. A residence time of 1 day is used for delivery type LF for sales organization 0001.

 Note
If you do not maintain the views, the system cannot archive the documents.

So that archiving for inbound deliveries functions correctly, you must make sure that you maintain a residence time
other than zero for this delivery type and that you set a generic entry for the sales organization. You should set your
entries as follows if EL is the delivery type of the inbound delivery:

Sales organization Delivery type Document date

* EL >1

See also:

Customizing

Analyzing an Existing Archive (LE-SHP)

Use

This is custom documentation. For more information, please visit SAP Help Portal. 169
 4/6/25, 11:39 PM
The Analyze function allows you to view a list of the most important header and item data for archived deliveries from a number of
archiving runs specified by you.

Entry Fields

Document selection

Select the documents that you want to display.

Display Function for Archived Deliveries (LE-SHP)

Use
You can use the Archive Information System (Transaction SARI) to display archived deliveries in single document display. Other
functions for displaying documents is the original document display via ArchiveLink and other linked documents via the Document
Relationship Browser (DRB).

Prerequisites
Archiving object RV _LIKP has at least one information structure, which is based on the standard field catalogs SAP_RV_LIKP_001
or SAP_RV_LIKP_002 delivered as part of the SAP System. The standard information structure delivered by SAP is SAP
SAP_DRB_RV_LIKP.

The information structure was activated and filled.

The information structure contains the field VBELN as a key field.

For you to be able to display the linked documents via DRB (see below), information structures for archiving objects SD _VBAK
and SD_VBRK have to be active and filled.

The Authorizations for displaying archived deliveries have been maintained.

Features
Single document display

You can display single archived deliveries via transaction VL03N (outbound deliveries) and VL33N (inbound deliveries). These
correspond to the original display transaction for deliveries in the database. However, archived deliveries can no longer be
modified. If this delivery has any archived Handling Units, they are also displayed.

Certain documents, such as WM transport orders or shipping units, do not have a display function and can therefore not be
displayed if they are in the database.

This is custom documentation. For more information, please visit SAP Help Portal. 170
 4/6/25, 11:39 PM
As of SAP R/3 Enterprise (Support Package 06) it is possible for you to directly display archived deliveries via the standard
transactions VL03N and VL33N. See SAP Note 574894.

Displaying linked documents via DRB

Via the Document Relationship Browser (DRB) you can display the entire process chain in which a specific document is
embedded. It does not matter whether the preceding or subsequent document you want to display is still in the database or was
already archived. The following prerequisites must be fulfilled to display linked documents:

The preceding or subsequent document you want to display must have an online display function.

If it has been archived, a preceding or subsequent document must be part of an active information structure.

From the single document display for archived deliveries you can call up the DRB via Environment → RelationshipBrowser . For
more information about displaying linked documents in DRB see Deliveries in DRB (LE-SHP) .

Displaying the Original Documents via ArchiveLink

From the list of the archive information structure you can call up this function via Original display . This is also true for linked work
items and IDocs.

The same prerequisites apply for displaying original documents as for the individual document display (see above).

You can only display documents via ArchiveLink if you are properly connected to ArchiveLink. This includes, for example, that the
ArchiveLink Viewer has been configured correctly, and that the function for accessing optical archives has been activated properly.
In addition, the link entries in the corresponding tables for ArchiveLink, Work Item and IDocs have to exist in the database.

Activities
From the Archive Information System you can call up the functions for single document display ( Outbound/Inbound Deliveries ),
original document display ( Display originals ) and DRB ( DRB: SD deliveries ) via the selection screen Display data object , which
appears when you select a document from the list of the archive information structure.

For more information about the Archive Information System see Archive Information System (AS) .

Authorizations (LE-SHP)
To display individual documents from archived deliveries via the archiving information system, you must have at least the following
authorizations:

1. Reading archives:

2. Object S_ARCHIVE Value Description

This is custom documentation. For more information, please visit SAP Help Portal. 171
 4/6/25, 11:39 PM

APPLIC SD Application

ARCH_OBJ RV_LIKP Archiving object

ACTVT 03 Displaying archives

3. Displaying archived deliveries

4. Object V_LIKP_VST Value Description

VSTEL * Shipping point; can be specified

ACTVT 03 Displaying the sales documents

5. Displaying documents set up via ArchiveLink:

Object S_WFAR_OBJ Value Description

OAARCHIV * Access to a physical archive: can be

specified

OAOBJEKTE * Object category access; can be specified

OADOKUMENT * Document type access; can be specified

ACTVT 03 Displaying archived originals

Archiving Shipment Documents (LE-TRA)

Definition

Archiving object SD_VTTK is used to archive shipments in sales and distribution. For more information about archiving SD
shipments, see Additional Information for Archiving Object SD_VTTK

 Note
You can use this archiving object in Information Lifecycle Management. ou must have activated the corresponding business
functions to do this. The system then also shows the ILM Actions group box. You can use these actions to carry out archiving,
for example, where the retention periods stored in the Information Retention Manager can be evaluated. Additionally, you can
create snapshots (copies) of data or destroy data that matches the requirements. For more information, see ILM
Enhancements for Data Archiving, ILM Actions in the Write Program.

Structure
Tables

SD_VTTK archives data from several different tables. In transaction DB15, you can find out which tables are affected. For more
information, see Tables and Archiving Objects.

 Note
To archive handling units, use archiving object LE_HU (see also Archiving Handling Units (LO-HU)).

This is custom documentation. For more information, please visit SAP Help Portal. 172
 4/6/25, 11:39 PM
Programs

The following programs are delivered for SD_VTTK.

Program Function

SDVTTKWRS Write

SDVTTKDLS Delete

SDVTTKRL Reload

Write Program

The write program supports the ADK interruption concept, meaning that you can interrupt the write phase and continue it at a
later point in time. To use this function, you must set the Interruption Possible checkbox in Customizing (transaction AOBJ).This
checkbox is not set by default. For more information, see Interrupting and Continuing Archiving Sessions.

You can select the documents that you want to archive on the selection screen for the write program under Shipments and
Restrictions . Under Process Control you can specify whether the write job is started in test or production mode. If automatic
starting of the deletion program was activated in the archiving object-specific Customizing, you can also specify that the archiving
object’s delete program is started with the test mode variant stored in the archiving object-specific Customizing.

During the write and delete phases, the system writes a compact log containing information about the processed data. On the
selection screen for the programs, you can indicate that you want a detailed log. This contains the information found in the
compact log plus all the objects that were processed, including the corresponding messages.

In the Archiving Session Note field, you can enter a short text for the archiving session to help you find the session in archive
management at a later date.

Delete Program

The delete program contains the standard variants SAP&PROD (production mode) and SAP&TEST (test mode). During the write
and delete sessions, regular progress messages appear in the job log (background processing) and in the status line (dialog).

ILM-Related Information for Archiving Object

This archiving object is enabled for SAP Information Lifecycle Management (SAP ILM). The SAP ILM object is SD_VTTK.

You can define your own condition fields for your application. The following table describes the conditions fields that you can
define:

Condition Field Description

BFART Transportation type

VSART Shipping type

This archiving object supports the legal case feature and you can set a legal hold on this archiving object. The business object
repository (BOR) object VTTK exists for the archiving object. VTTK is registered in transaction IRM_CUST Object Category-
Specific Customizing Mapping Object Type to BOR Object Type .

For more information, see SAP Library for SAP ILM on http://help.sap.com/erp. In SAP Library, choose SAP ERP Cross-
Application Functions Cross-Application Components SAP Information Lifecycle Management Using ILM Retention
Management in the Application System Putting Holds on Data for Legal Cases .

This is custom documentation. For more information, please visit SAP Help Portal. 173
 4/6/25, 11:39 PM

Policy Category Description

RST Residence rules

RTP Retention rules

Criteria for the Archivability of Shipments

A shipment can be archived if the following conditions are met:

1. The creation date of the shipment is at least n days ago, meaning that the residence time of the shipment since it was
created is n days.

2. The last change date of the shipment is at least m days ago, meaning that the residence time of the shipment since it was
last changed is m days. If the shipment has not yet been modified, the creation date is taken as the last change date.

3. The overall status of the shipment is at least x .

4. All deliveries in the shipment have the transportation planning status “C” (fully planned).

5. All deliveries in the shipment have the goods movement status ‘ ‘ (not relevant) or “C” (fully processed).

6. The shipment has the overall shipment cost calculation status ‘ ‘ (not relevant) or “C” (fully processed).

7. If the overall shipment cost calculation status is “C” (fully processed), the corresponding freight costing document must
already be archived, meaning that it can no longer exist in the system. (The document chain must be archived starting from
the back.)

8. All shipments that are linked with the current shipment in a transportation chain must also be archivable (that is, they must
also fulfill conditions 1-5 and be within the shipment number range you specified at the start of archiving).

While the system always checks the last five criteria, you can enter the first three criteria in Customizing for Sales and
Distribution under Data Transfer and Archiving Archiving Control for Sales Documents Archiving Control for Shipments
.

Displaying Archived Shipments

You can display archived shipments using the standard display transaction for shipments (VT03N). When you enter a shipment
number, the system checks whether the database contains the corresponding document. If it does not, the system automatically
attempts to read the document from the archive. If the system finds the document in the archive, the shipment is displayed within
the dialog.

 Note
To display archived shipments, you must have activated and configured at least one archive information structure for
SD_VTTK.

See also:

Shipment Document in the DRB (LE-TRA)

Archiving Shipment Documents (LE-TRA)

To archive shipment documents:

This is custom documentation. For more information, please visit SAP Help Portal. 174
 4/6/25, 11:39 PM
Enter a description for the variant and choose Maintain .

– the range of shipment documents to be archived

– Whether the system should create archive files without deleting data from the database during the test run.

– Whether the system issues a normal or a detail log. If you specify a detail log, the system reads all data within the
shipment number range you specify from the database. The system checks data to determine if it can be archived, and it
logs the result. ALL checks are carried out for every shipment. The write program runs faster if you do not mark the Detail
log check box.

You reach the data screen in which you can define further attributes for the variant.

Reloading Shipments (LE-TRA)

To reload archived shipment documents:

1. Choose Logistics Sales/distribution Shipping .

2. Choose Environment Reload documents .

3. If there is no variant, you must create a new one:

4. Enter a description for the variant and choose Maintain .

5. Define the following for the variant:

– The range of billing documents to be reloaded

– Whether reloading should run in test mode

– Whether to issue a standard or detailed log.

1. Choose Edit Continue.

2. You reach the data screen in which you can define further attributes for the variant.

3. Save your variant.

4. Select the archive file that contains the shipment documents.

5. Define a start time for the reload run.

6. Enter a spool parameter, if you want a printout.

Archiving Shipment Cost Documents (LE-TRA)

The following points will be followed in this section

Object Definition

Check criteria for the integration of archiving/deletion of data

Archiving Object Definition

This is custom documentation. For more information, please visit SAP Help Portal. 175
 4/6/25, 11:39 PM
You archive shipping cost documents using the SD_VFKK archiving object

The table lists the data archived by SD_VFKK . (You can also display this information by using Transaction SAR1 ).

Parent Segment Segment Description

VFKK Shipment cost document: Header data

VFKK VFKP Shipment cost document: Item data

VFKK VFKN Shipment cost document: Accounting

assignment

VFKK VFPA Shipment cost document: Partners

VFKP VFSI Shipment cost document: Subitem data

VFKP VFZP Shipment cost document: Condition

assignment

VFKP KONV Shipment cost document: Conditions

Criteria for Archiving and Deleting

The archiving program checks several criteria for every shipment cost document. A shipment cost document can be archived
when the following requirements are met:

The creation date of the shipment cost document must be at least N days in the past. I.e., the residence time of the
shipment cost document must be N days.

The last change date of the shipment cost document must be at least N days in the past. I.e., the residence time of the
shipment cost document since the last change must be M days. If the shipment cost document has not yet been changed,
then the creation date is used as the last change date.

The purchase order for the shipment cost document should be completed and archived. The system determines this by
checking whether the subsequent document(s) for the shipment cost document (i.e. service entry sheets) has already
been archived. This check can be activated in Archiving control for shipment costs.

The status of calculation must be set to "C" (fully calculated).

The status of account assignment must be set to "_" (blank = not relevant for account assignment) or "C" (fully account
assigned).

The status for forwarding must be set to "_" (blank = not relevant for forwarding) or "C" (fully forwarded).

The shipment, to which the shipment cost document refers, must be fully calculated.

The first four criteria are always checked by the program and cannot be altered, the last three, however, can be configured in
Customizing.

Archiving Shipment Costs with SD_VFKK

Use

This is custom documentation. For more information, please visit SAP Help Portal. 176
 4/6/25, 11:39 PM
Basic Information About Shipment Costs with SD_VFKK

You can use this archiving object to archive shipment cost documents. This archiving object is not related to any other archiving
objects.

This archiving object covers the following programs

Program Description

ILMSDVFKKWR Archiving Shipment Costs: Write to Archive

SDVFKKDL Delete Shipment Costs

SDVFKKRL Reload Shipment Costs

This archiving object also includes the following tables:

Table Description

VFKP Shipment Costs: Item Data

VFKN Account Determination in Shipment Costs Item

VFPA Partner for Shipment Costs

VFSI Shipment Costs: Sub-item Data

VFZP Correct Original Assignment of Conditions

KONV Conditions (Transaction Data)

VFKONV (Freight) Conditions

VFKGRP (Freight) Group Conditions

VFKK Shipment Costs: Header Data

SAP ILM-Related Information for Archiving Object

This archiving object is enabled for SAP Information Lifecycle Management (SAP ILM). The SAP ILM object is SD_VFKK. You can
define your own condition fields for your application. The following table describes the conditions fields that you can define:

Condition Field Description

BUKRS Company code

FKART Shipment cost type

This archiving object supports the legal case feature and you can set a legal hold on this archiving object. The business object
repository (BOR) object VFKK exists for the archiving object. VFKK is registered in transaction IRM_CUST Object Category-
Specific Customizing Mapping Object Type to BOR Object Type .

For more information, see SAP Library for SAP ILM on http://help.sap.com/erp. In SAP Library, choose SAP ERP Cross-
Application Functions Cross-Application Components SAP Information Lifecycle Management Using ILM Retention
Management in the Application System Putting Holds on Data for Legal Cases .

You can use the policy category RTP (Retention Rules).

This is custom documentation. For more information, please visit SAP Help Portal. 177
 4/6/25, 11:39 PM
Checks of Archiving Object SD_VFKK

The write program performs the following business and technical checks during document selection:

The following statuses in the shipment cost document must be completed:

VFKK-STBER = C

VFKK-STFRE = C (if relevant in document)

VFKK-STABR = C (if relevant)

The overall shipment cost calculation status in the shipment must be completed: VTTK-FBGST = C.

If you enable the Check PO function in Customizing for archiving, the system checks if the corresponding service entry
sheets and purchase orders are already archived.

Performing Application-Specific Customizing of SD_VFKK

We have no recommendation for any particular values for when you configure business and technical parameters. If you don’t
enter a value for the residence time, but you do enter a value in transaction VORI, the system archives the documents after one
year.

Defining Write Variant for SD_VFKK

The available selection criteria are the shipment cost document number and the creation date of the document. The retention
period you enter in Customizing for archiving uses the creation date to calculate when the system can archive the document.

Dependencies of SD_VFKK

The archiving object SD_VFKK interacts with the shipments component and with all the preceding documents in sales orders and
delivery.

Displaying SD_VFKK

You can’t display a single document. You can use the following infostructures in the archive information system:

SAP_SD_VFKK_001 (Shipment cost header)

SAP_SD_VFKK_002 (Shipment cost item)

You can also use the following field catalogs in the archive information system:

SAP_SD_VFKK_001

SAP_SD_VFKK_002

More Information
For more information about data archiving, see SAP Help Portal under http://help.sap.com/nw. In SAP Library, choose Function-
Oriented View Solution Life Cycle Management Data Archiving .

For more information about SAP ILM, see SAP Library on http://help.sap.com/erp. In SAP Library, choose SAP ERP Cross-
Application Functions Cross-Application Components SAP Information Lifecycle Management .

This is custom documentation. For more information, please visit SAP Help Portal. 178
 4/6/25, 11:39 PM

Archiving Shipment Cost Documents (LE-TRA)

To archive shipment cost documents:

1. Select Logistics Logistics Execution Transportation Shipment Shipment costs Environment Archive
documents

2. If there is no variant, you must create a new one:

3. Enter a description for the variant and choose Maintain .

4. Define the following for the variant:

The range of shipping cost documents to be archived

Whether the system should create archive files without deleting data from the database during a test run.

Whether the system issues a normal or a detail log. If you specify a detailed log, the system reads all data within the
shipment cost document number range you specify from the database. The system checks data to determine if it can be
archived, and it logs the result. ALL checks are carried out for every shipment cost document. The archiving program runs
faster if you do not mark the Issue log texts checkbox.

1. Choose Edit Continue.

2. You reach the data screen in which you can define further attributes for the variant.

3. Save your variant.

4. Define a start time for the archiving run.

5. Enter a spool parameter, if you want a printout.

Reloading Shipment Cost Documents (LE-TRA)

To reload shipment cost documents:

1. Select Logistics Logistics Execution Transportation .Shipment Shipment costs Environment Reload
documents

2. If there is no variant, you must create a new one:

3. Enter a description for the variant and choose Maintain .

4. Define the following for the variant:

The range of shipment cost documents to be reloaded

Whether reloading should run in test mode

Whether the system issues log texts

1. Choose Edit Continue.

2. You reach the data screen in which you can define further attributes for the variant.

3. Save your variant.

4. Choose the archive files from which you want to reload the shipment cost documents.

5. Define a start time for the reload run.

This is custom documentation. For more information, please visit SAP Help Portal. 179
 4/6/25, 11:39 PM
6. Enter a spool parameter, if you want a printout.

Result

The shipment cost documents you specified are reloaded. If a shipment cost document cannot be reloaded from the archive file
(maybe because it is not within the correct number range or because an error occurred during reloading), then it is placed in a new
archive file.

 Caution

It generally only makes sense to reload documents soon after they have been archived. If important data, such as master data
or Customizing settings, have been altered between the archiving and the reloading of the documents, this can lead to extreme
discrepancies in the documents, since the entire environment has changed.

Archiving of Direct Store Delivery (LE-DSD)

Definition
The following Direct Store Delivery business objects can be archived:

Objects Archiving objects

DSD: Archiving Object for Settlement Documents /DSD/SL

DSD: Archiving Object for Visit List /DSD/VC

Use

 Note
Before you use the archiving objects for the first time, you should check the application customizing.

You call archive administration using transaction SARA, and enter the relevant archiving object manually.

For information about how to archive objects, see the descriptions for the individual archiving objects with the title Archiving of
<Object Type> .

Integration
If you have activated Direct Store Delivery (DSD), you cannot archive master data that is connected with DSD. The system
executes DSD-specific checks for this. If the DSD-specific checks are successful (for example, a customer that is to be archived is
no longer used in any visit lists), the system deletes the corresponding DSD master data tables. Since DSD-specific master data
does not fulfill the typical requirements of archiving (avoidance of an increase in data volume, or fulfillment of statutory
documentation requirements), archiving is not required in DSD.

The system contains Business Add-Ins (BAdIs) to ensure that DSD-specific master data is not archived.

See also:

Archiving Object

This is custom documentation. For more information, please visit SAP Help Portal. 180
 4/6/25, 11:39 PM

Archiving of Settlement Documents (LE-DSD-RA-SL)

Definition

DSD settlement documents are archived and deleted using the archiving object /DSD/SL.

Use
DSD settlement documents are only archived if they are not used in route accounting in the Direct Store Delivery component
anymore.

You can display the logs for the write programs in one of two forms:

Log (summary)

Grouped display based on analog message texts with reference to a sample data record from a related archiving object.

Log (detail)

Individual display of all archiving objects belonging to an archiving run, including message texts.

For more information about the logs generated during archiving, see Logs .

Structure
Tables

If you use the archiving object /DSD/SL, data is archived from the following tables:

Table Table name

/DSD/SL_SLD_FLOW Settlement: Document Flow

/DSD/SL_SLD_HEAD Settlement Document Header

/DSD/SL_SLD_ITEM Settlement Document Item

/DSD/SL_SLD_MBAL Settlement Document: Payment Differences

/DSD/SL_SLD_PROC DSD: Settlement Runs

/DSD/SL_SLD_QBAL Settlement Document: Quantity Differences

/DSD/SL_SLD_QDET Settlement Document: Quantity Differences, Reasons for

Differences

Programs

The following programs are delivered for /DSD/SL:

Program Function

/DSD/SL_ARC_WRITE Write

/DSD/SL_ARC_DELETE Delete

This is custom documentation. For more information, please visit SAP Help Portal. 181
 4/6/25, 11:39 PM
The write program supports the ADK (Archive Development Kit) interruption concept, which allows you to interrupt the write
phase and continue it at a later point in time. If you want to use this function, the Interruption Possible indicator must be set in
Customizing (transaction AOBJ). This parameter is not preset. For more information, see Interrupting and Continuing Archiving
Sessions.

The standard variants SAP&PROD (production mode) and SAP&TEST (test mode) are available for the delete program.

During both the write and delete runs, progress messages are regularly issued in the job log (background processing) and in the
status line (dialog processing). For more information, see Logs.

Integration
Displaying archived settlement documents

To display archived settlement documents using the Archive Information System, you need the archive information structure
/DSD/SL_IS_01 (DSD settlement documents), which has been created on the basis of the SAP standard field catalog
/DSD/SL_FC_01 (DSD settlement documents).

The archive information structure must be set up and active before the system can use it.

For more information about archive information structures, see Using the Archive Information System .

ILM-Related Information for the Archiving Object

You can use this archiving object with the ILM object/DSD/SL within SAP Information Lifecycle Management. A prerequisite for
this is that you have activated the corresponding Information Lifecycle Management (ILM) business function (transaction SFW5).
The system then additionally shows the ILM Actions frame. With these actions, you can carry out an archiving in which the
retention periods defined in the Information Retention Manager are evaluated, for example. Furthermore, you can make snapshots
(copies) of data or destroy data that satisfies the prerequisites.

For more information about the Relevance business functions for SAP ILM, see Activating SAP ILM.

For more information about ILM Enhancements in data archiving, see ILM-Specific Enhancements in Archive
Administration.

The following fields for /DSD/SL are defined in the ILM policy and in processing for ILM policies (transaction IRMPOL):

Available Time Bases

Created On (CREATION_DATE)

Available Condition Fields

Tour Document Type (DSD_DOC_TYPE)

Available Policy Categories

RST: Residence Rules

RTP: Retention Rules

For more information, see SAP Information Lifecycle Management.

Enhancements (SD)
This is custom documentation. For more information, please visit SAP Help Portal. 182
 4/6/25, 11:39 PM
The BAdI ARC_SD_VTTK_CHECK is available for the archiving object SD Shipments ( SD_VTTK ). The system uses the BAdI to
check the dependencies between the shipment document and the settlement document .

The system creates the settlement documents during the final settlement run based on the shipment documents and other data.
If the final settlement run has the status settled , or if the settlement documents have already been archived, the system can also
archive the shipment document linked to the settlement document.

 Note
A check for the shipment document (SD_VTTK) is implemented in the BAdI ARC_SD_VTTK_CHECK, which is contained in the
write program SDVTTKWRS for archiving.

Variant Settings for Writing (LE-DSD-RA-SL)

Use
When you schedule the write program, you must enter an existing variant or create a new one. The variant contains the selection
criteria for the settlement documents that you want to archive.

Features
Document selection criteria

The selection criteria for the data records are the characteristics and key figures of the aspect. You can enter individual values or
value intervals as selection criteria.

You can use the following selection criteria for Settlement Documents :

Settlement document number

Settlement date

Driver

Tour document type

 Note
Shipment and visit list are allowed as tour document types.

Document

Minimum age

 Note
Specify the residence time in days. The residence time is a criterion for archiving settlement documents. The system
can only archive a settlement document that has not been settled if its age in days according to the creation date is
greater than the age defined by the residence time.

The default value of the Minimum Age field is 20. You can adjust this value.

The system only archives settlement documents if the selection criteria under Settlement Documents are within the selected
interval.

This is custom documentation. For more information, please visit SAP Help Portal. 183
 4/6/25, 11:39 PM
Other possible settings

The settings for the flow control, log options, and the note on the archiving run are options that are also valid for other archiving
objects. For more information, see the general archiving documentation under Variant Maintenance for Archiving Jobs .

See also:

Creating Archive Files

Displaying Archived Settlement Documents (LE-DSD-RA-SL)

Use
You can display specific settlement documents from the archive. The table can be displayed using the Archive Information System,
for example.

 Note
The system can only find documents for which there is a suitable archive index.

Features
To display archived settlement documents using the Archive Information System , you need the archive information structure
/DSD/SL_IS_01 (DSD settlement documents), which has been created on the basis of the SAP standard field catalog
/DSD/SL_FC_01 (field catalog for settlement document).

The archive information structure must be set up and active before the system can use it.

For more information about using archive information structures, see Using the Archive Information System .

Archiving of Visit Lists (LE-DSD-VC)

Definition
DSD Visit lists are archived and deleted using the archiving object /DSD/VC.

 Note
The system generates visit lists for day-to-day business from the planning tool Visit Plan . The visit lists contain all the
necessary information from the visit plans (such as data on the tour, shipment, and customer) so that a driver can execute a
tour. All visit plans are defined with a validity period. Once the system has generated the visit lists from the visit plans, or if the
validity period of the visit plans has expired, the system no longer requires them. Since the visit lists contain all required data
from the visit plans, the visit plans do not have to be archived separately. The user can determine when the system should
delete visit plans that are no longer required (after a specific residence time has elapsed).

Use
Visit lists define the tour that a driver executes, and also document the tour. Visit lists are only archived if they are not used in Visit
Control in the Direct Store Delivery component annymore, for example, if the tour is complete or a visit list is no longer valid. For

This is custom documentation. For more information, please visit SAP Help Portal. 184
 4/6/25, 11:39 PM
checking purposes, such as when a customer has made a complaint, the system can also make the visit lists available for reading
after archiving.

You can display the logs for the write programs in one of two forms:

Log (summary)

Grouped display based on analog message texts with reference to a sample data record from a related archiving object.

Log (detail)

Individual display of all archiving objects belonging to an archiving run, including message texts.

For more information about the logs generated during archiving, see Logs.

Structure
Tables

If you use the archiving object /DSD/VC, data is archived from the following tables:

Table Table name

/DSD/VC_VLH DSD: Visit List – Header Data

/DSD/VC_VLH_R DSD: Visit List – Header Data: Reference Documents

/DSD/VC_VLP DSD: Visit List – Item Data

/DSD/VC_VLP_R DSD: Visit List – Item Data: Reference Documents

NAST Message Status

Text (archiving class) SAPscript texts

Programs

The following programs are delivered for /DSD/VC:

Program Function

/DSD/VC_VL_ARC_WRITE Write

/DSD/VC_VL_ARC_DELETE Delete

The write program supports the ADK (Archive Development Kit) interruption concept, which allows you to interrupt the write
phase and continue it at a later point in time. If you want to use this function, the Interruption Possible indicator must be set in
Customizing (transaction AOBJ). This parameter is not preset. For more information, see Interrupting and Continuing Archiving
Sessions.

The standard variants SAP&PROD (production mode) and SAP&TEST (test mode) are available for the delete program.

During both the write and delete runs, progress messages are regularly issued in the job log (background processing) and in the
status line (dialog processing). For more information, see Logs.

Integration
This is custom documentation. For more information, please visit SAP Help Portal. 185
 4/6/25, 11:39 PM
Displaying archived visit lists

To display archived visit lists using the Archive Information System, you need the archive information structure /DSD/VC_IS_01
(DSD visit list), which has been created on the basis of the SAP standard field catalog /DSD/VC_FC_01 (DSD visit list).

The archive information structure must be set up and active before the system can use it.

For more information about archive information structures, see Using the Archive Information System .

ILM-Related Information for the Archiving Object

You can use this archiving object with the ILM object /DSD/VC within SAP Information Lifecycle Management. A prerequisite for
this is that you have activated the corresponding Information Lifecycle Management (ILM) business function (transaction SFW5).
The system then additionally shows the ILM Actions frame. With these actions, you can carry out an archiving in which the
retention periods defined in the Information Retention Manager are evaluated, for example. Furthermore, you can make
snapshots (copies) of data or destroy data that satisfies the prerequisites.

For more information about the Relevance business functions for SAP ILM, see Activating SAP ILM.

For more information about ILM Enhancements in data archiving, see ILM-Specific Enhancements in Archive
Administration.

The following fields are defined for /DSD/VC in the ILM policy and are visible when processing ILM policies (transaction IRMPOL):

Available Time References

Start Date (START_DATE)

Available Condition Fields

Visit Plan Type (VISITPLANTYPE)

Available Policy Categories

RST: Residence Rules

RTP: Retention rules

For more information, see SAP Information Lifecycle Management.

Variant Settings for Writing (LE-DSD-VC)

When you schedule the write program, you must enter an existing variant or create a new one.The variant contains the selection
criteria for the visit lists that you want to archive.

Features

Document selection criteria

The selection criteria for the data records are the characteristics and key figures of the aspect. You can enter individual values or
value intervals as selection criteria.

You can use the following selection criteria under Visit Lists :

Visit list ID

This is custom documentation. For more information, please visit SAP Help Portal. 186
 4/6/25, 11:39 PM
Visit plan ID

Visit plan type

Visit execution date

The system only archives visit lists if the selection criteria under Visit Lists are within the selected interval.

Other possible settings

The settings for the flow control, log options, and the note on the archiving run are options that are also valid for other archiving
objects.For more information, see the general archiving documentation under Variant Maintenance for Archiving Jobs .

See also:

Creating Archive Files

Displaying Archived Visit Lists (LE-DSD-VC)

Use
You can display individual visit lists from the archive. The table can be displayed using the Archive Information System, for
example.

 Note
The system can only find documents for which there is a suitable archive index.

Features
To display archived visit lists using the Archive Information System , you need the archive information structure /DSD/VC_IS_01
(DSD visit list), which has been created on the basis of the SAP standard field catalog /DSD/VC_FC_01 (DSD visit list).

The archive information structure must be set up and active before the system can use it.

For more information about using archive information structures, see Using the Archive Information System .

Archiving of DSD DEX Streams (LE-DSD)

Definition
Direct Exchange (DEX) communication streams are archived and deleted using the archiving object /DSD/DEX.

 Note
The electronic data exchange format Direct Exchange supports the automated exchange of data between the mobile device of
the driver and the back-end system in the mobile DSD scenario.

Use

This is custom documentation. For more information, please visit SAP Help Portal. 187
 4/6/25, 11:39 PM
If you receive customer complaints, you can audit the DEX process by checking the DEX data. With transaction "Display DEX Data
for Audit Purpose" (/DSD/DX_AUDIT) you are able to review the synchronization process between the front-end and back-end
system, including the back-end documents that have been created or changed. This transaction allows you to display the DEX data
and export it to a file or print it. If the data required for using the transaction /DSD/DX_AUDIT no longer exists in the database,
the system searches the archive files. This means that the transaction /DSD/DX_AUDIT is able to process the required DEX data
from the database directly or from the archive file.

The DEX data needs to be archived, because when you use DEX in the mobile DSD scenarios, the data volume in the DEX tables of
the back-end system keeps rising rapidly.

You can display the logs for the write programs in one of two forms:

Log (summary)

Grouped display based on analog message texts with reference to a sample data record from a related archiving object.

Log (detail)

Individual display of all archiving objects belonging to an archiving run, including message texts.

For more information about the logs generated during archiving, see Logs.

Structure
Tables

If you use the archiving object /DSD/DEX, data is archived from the following tables:

Table Table name

/DSD/DX_HD DEX Stream Header (backend)

/DSD/DX_IT DEX Stream Segments (backend)

/DSD/SL_SLD_DOCS Merging of Back-End Documents

Programs

The following programs are delivered for /DSD/DEX:

Program Function

/DSD/DX_ARC_WRITE Write

/DSD/DX_ARC_DELETE Delete

The write program supports the ADK (Archive Development Kit) interruption concept, which allows you to interrupt the write
phase and continue it at a later point in time. If you want to use this function, the Interruption Possible indicator must be set in
Customizing (transaction AOBJ). This parameter is not preset. For more information, see Interrupting and Continuing Archiving
Sessions.

The standard variants SAP&PROD (production mode) and SAP&TEST (test mode) are available for the delete program.

During both the write and delete runs, progress messages are regularly issued in the job log (background processing) and in the
status line (dialog processing). For more information, see Logs.

This is custom documentation. For more information, please visit SAP Help Portal. 188
 4/6/25, 11:39 PM

Integration
Displaying archived visit lists

To display archived DEX communication streams using the Archive Information System, you need the archive information
structure /DSD/DEX (DEX Info Structure), which has been created on the basis of the SAP standard field catalog /DSD/DEX (DEX
Field Catalog).

The archive information structure must be set up and active before the system can use it.

For more information about archive information structures, see Using the Archive Information System.

ILM-Related Information for the Archiving Object

You can use this archiving object with the ILM object /DSD/DEX within SAP Information Lifecycle Management. A prerequisite for
this is that you have activated the corresponding Information Lifecycle Management (ILM) business function (transaction SFW5).
The system then additionally shows the ILM Actions frame. With these actions, you can carry out an archiving in which the
retention periods defined in the Information Retention Manager are evaluated, for example. Furthermore, you can make
snapshots (copies) of data or destroy data that satisfies the prerequisites.

For more information about the Relevance business functions for SAP ILM, see Activating SAP ILM.

For more information about ILM Enhancements in data archiving, see ILM-Specific Enhancements in Archive
Administration.

The following fields are defined for /DSD/DEX in the ILM policy and are visible when processing ILM policies (transaction
IRMPOL):

Available Time References

Start Date (START_DATE)

Available Condition Fields

Scenario (SCENARIO)

Sales Office (SL_OFFICE)

Sales Type (SL_TYPE)

Available Policy Categories

RST: Residence Rules

RTP: Retention rules

For more information, see SAP Information Lifecycle Management.

Destroying DSD Route Settlement Tour Data with

/DSD/HH_RAHD_DESTRUCTION
You can use data destruction object /DSD/HH_RAHD_DESTRUCTION to destroy DSD route settlement tour data that is no longer
relevant after its retention period expires.

You can use data destruction object /DSD/HH_RAHD_DESTRUCTION to destroy DSD route settlement tour data that is no longer
relevant after its retention period expires. The data destruction object /DSD/HH_RAHD_DESTRUCTION is assigned data

This is custom documentation. For more information, please visit SAP Help Portal. 189
 4/6/25, 11:39 PM
destruction program /DSD/HH_RAHD_DES.

ILM Object-Based Information for the Data Destruction Object

The data destruction object /DSD/HH_RAHD_DESTRUCTION is assigned ILM object /DSD/HH_RAHD_DESTRUCTION.

Tables from which data records are deleted:

Table Description

/DSD/HH_RAHD DSD Route Settlement: Tour Header Data

/DSD/HH_RACAD Structure of Customer Data (One-Time Customers)

/DSD/HH_RACL Settlement Structure

/DSD/HH_RACOCICI Structure Check-Out / Check-In Money Item

/DSD/HH_RACOCIES Check-In/Out, Reload Check-In/Out Data Signatures

/DSD/HH_RACOCIHD Structure Check-Out / Check-In Header

/DSD/HH_RACOCIMI Structure Check-Out / Check-In Material Item

/DSD/HH_RACTR Structure Transmission Control

/DSD/HH_RADELCD Structure Outbound Delivery Conditions

/DSD/HH_RADELCND Structure for Outbound Delivery Conditions

/DSD/HH_RADELES Delivery/Order Signatures

/DSD/HH_RADELHD Structure Outbound Delivery Header

/DSD/HH_RADELIT Structure Outbound Delivery Item

/DSD/HH_RADS Structure Tour Distance

/DSD/HH_RADXHD DSD Route Accounting: DEX Header Data

/DSD/HH_RAEC Structure Receipts / Expenditures

/DSD/HH_RAECA Structure Collection Settlement

/DSD/HH_RAERRIDX DSD - RA: Error Index Structure

/DSD/HH_RAIVCD Structure Invoice Condition

/DSD/HH_RAIVCND Structure for Invoice Condition

/DSD/HH_RAIVES Invoice Signatures

/DSD/HH_RAIVHD Structure of Invoice Header

/DSD/HH_RAIVIT Structure of Invoice item

/DSD/HH_RAIVPRT Structure of Invoice Printout

/DSD/HH_RALOCKHD DSD - RA: Change Management Tour

/DSD/HH_RATS Structure of Tour Time

This is custom documentation. For more information, please visit SAP Help Portal. 190
 4/6/25, 11:39 PM

Table Description

/DSD/GS_GENDAT_I DSD: Generic Data Container

/DSD/GS_LAYOUT_I DSD: Layout of Generic Data Container

/DSD/SV_ERROR_HD DSD SV Error Table Movement Header

/DSD/SV_ERROR_IT DSD SV Error Table Movement Item

/DSD/SV_MM_DOC DSD SV Stock Transfer Documents per Tour

/DSD/SV_MM_HD DSD SV Material Movement Header

/DSD/SV_MM_IT DSD SV Material Movement Item

/DSD/SV_RACOCICI DSD SV: Check-Out / Check-In - Money Item

/DSD/SV_RACOCIHD DSD SV: Check-Out/Check-In - Header Data

/DSD/SV_RACOCIMI DSD SV: Check-Out / Check-In - Items

/DSD/SV_RL DSD SV Final Unloading Documents

/DSD/SV_RLD_HD DSD SV: Reload Header Data

/DSD/SV_RLD_IT Reload Item Data

/DSD/SV_SEALNO Loading Confirmation Seal Numbers

Standard Fields for ILM Object /DSD/HH_RAHD_DESTRUCTION

You can use the following fields to define ILM policies for data destruction object /DSD/HH_RAHD_DESTRUCTION:

Time Basis

CREATION_DATE

Condition Fields

DOC_TYP (/DSD/HH_DOC_TYP)

PLANT (WERKS_D)

Available Policy Categories

RTP: Retention Rules

Procedure
Finding Data Destruction Objects

To find data destruction object /DSD/HH_RAHD_DESTRUCTION DSD Tour Data Destruction, proceed as follows:

1. Execute transaction DOBJ.

2. To search for the data destruction object, choose Position.

This is custom documentation. For more information, please visit SAP Help Portal. 191
 4/6/25, 11:39 PM
3. Double-click data destruction object /DSD/HH_RAHD_DESTRUCTION to view more information such as the data
destruction program and the component.

4. In the dialog structure, double-click Structure Definition to display the tables from which data is destroyed.
Customizing Settings

To adjust data destruction object /DSD/HH_RAHD_DESTRUCTION and define retention rules, proceed as follows:

1. In transaction ILMARA, define an audit area and assign the ILM object.

2. In transaction IRMPOL, define ILM rules for data destruction object /DSD/HH_RAHD_DESTRUCTION.

3. In transaction IRMSIM, check (simulate) the retention rules for data destruction object /DSD/HH_RAHD_DESTRUCTION.

4. In transaction ILM_DESTRUCTION, apply the ILM rules for data destruction object /DSD/HH_RAHD_DESTRUCTION to
data.

For more information about the Customizing settings of data destruction objects, see

Processing Audit Areas

Editing ILM Policies

Evaluating Retention Management Definitions

Applying ILM Rules to Data

Executing Data Destruction Object /DSD/HH_RAHD_DESTRUCTION

You can destroy data from the database by executing a data destruction run for the corresponding data destruction object.

For more information about executing data destruction objects, see Data Destruction with a Data Destruction Object.

Specify the ILM object that is relevant for data destruction object /DSD/HH_RAHD_DESTRUCTION.

Start the data destruction (transaction ILM_DESTRUCTION):

1. Select Data from the Database as the Type of Data to Be Destroyed.

2. Enter the ILM object relevant for data destruction object /DSD/HH_RAHD_DESTRUCTION.

3. Choose Execute. In the destruction of data from the database, the actions to be started (Destroy and Administration) are
displayed.

4. Define variants for the data destruction program.

Define a selection variant for the data destruction.

To do so, you can use the following selection criteria to find the relevant DSD tour data:

General selection criteria for finding documents and checking the retention rules:

Tour

Additional selection criteria for finding the field content to be destroyed:

Tour Document Type

Plant

Created on

Standard ILM test and processing parameters:

This is custom documentation. For more information, please visit SAP Help Portal. 192
 4/6/25, 11:39 PM
Test Mode

Production Mode

Detailed Log

Log Output

Description of Data Destruction Run

5. Define a start date and the spool parameters for the data destruction run and choose Execute.
Additional Checks by the Data Destruction Program

There is an additional check for data destruction object /DSD/HH_RAHD_DESTRUCTION to see if the route settlement is already
completed.

Authorization Objects

You require the following authorization for data destruction:

S_ARCD_OBJ

Destroying DSD Connector Tour Data with

/DSD/ME_TOUR_HD_DESTRUCTION
You can use data destruction object /DSD/ME_TOUR_HD_DESTRUCTION to destroy DSD Connector Tour Data that is no longer
relevant after its retention period expires.

You can use data destruction object /DSD/ME_TOUR_HD_DESTRUCTION to destroy DSD Connector Tour Data that is no longer
relevant after its retention period expires. The data destruction object /DSD/ME_TOUR_HD_DESTRUCTION is assigned data
destruction program /DSD/ME_TOUR_HD_DES.

ILM Object-Based Information for the Data Destruction Object

The data destruction object /DSD/ME_TOUR_HD_DESTRUCTION is assigned ILM object /DSD/ME_TOUR_HD_DESTRUCTION.

Tables from which data records are deleted:

Table Description

/DSD/ME_TOUR_HD DSD Connector: Tour Header Data

/DSD/ME_CLR_HD Clearing

/DSD/ME_CNDLE DSD Connector: Table Listing/Exclusion Conditions

/DSD/ME_COCI_HD Check-Out Check-In Header

/DSD/ME_COCI_ITM Check-Out Check-In Item

/DSD/ME_COCI_PAY DSD Connector: Check in Check Out Payment

/DSD/ME_CUST_CPD DSD Connector: CpD Account

/DSD/ME_DEL_CND Pricing: Upload Manual Discount Condition for Deliveries

/DSD/ME_DEL_HD Delivery Header

This is custom documentation. For more information, please visit SAP Help Portal. 193
 4/6/25, 11:39 PM

Table Description

/DSD/ME_DX_HD DSD Connector - DEX Header

/DSD/ME_ES_HD DSD CN: Signatures Header Data

/DSD/ME_ES_ITM MDSD Signature Item

/DSD/ME_VIST_HD Sales Call Visit Header

/DSD/ME_EXPS_HD Driver's Expenses

/DSD/ME_VIST_ACT Activities during Sales Call

/DSD/ME_INVT_HD Stock Data

/DSD/ME_INV_HD Invoice Header

/DSD/ME_INV_ITM Invoice Item

/DSD/ME_ORD_CND Pricing: Upload manual discount condition for orders

/DSD/ME_ORD_HD Order Header

/DSD/ME_PAYM_HD DSD CN: Payments or Cash Collection received from Customer

/DSD/ME_PRO_FBAM MDSD Promotions - Feedback Amounts in Connector

/DSD/ME_PRO_FBFG MDSD Promotions - Feedback Free Goods in Connector

/DSD/ME_REVN_HD Payments or Collection from Customer

Standard Fields for ILM Object /DSD/ME_TOUR_HD_DESTRUCTION

You can use the following fields to define ILM policies for data destruction object /DSD/ME_TOUR_HD_DESTRUCTION:

Time Basis

START_DATE

Condition Fields

DOC_TYPE (/DSD/ME_DOCTYPE)

SHIP_TYPE (/DSD/ME_SHIPTYP)

Available Policy Categories

RTP: Retention Rules

Procedure
Finding Data Destruction Objects

To find data destruction object /DSD/ME_TOUR_HD_DESTRUCTION DSD Connector Tour Data Destruction, proceed as follows:

1. Execute transaction DOBJ.

2. To search for the data destruction object, choose Position.

This is custom documentation. For more information, please visit SAP Help Portal. 194
 4/6/25, 11:39 PM
3. Double-click data destruction object /DSD/ME_TOUR_HD_DESTRUCTION to view more information such as the data
destruction program and the component.

4. In the dialog structure, double-click Structure Definition to display the tables from which data is destroyed.
Customizing Settings

To adjust data destruction object /DSD/HH_RAHD_DESTRUCTION and define retention rules, proceed as follows:

1. In transaction ILMARA, define an audit area and assign the ILM object.

2. In transaction IRMPOL, define ILM rules for data destruction object /DSD/ME_TOUR_HD_DESTRUCTION.

3. In transaction IRMSIM, check (simulate) the retention rules for data destruction object
/DSD/ME_TOUR_HD_DESTRUCTION.

4. In transaction ILM_DESTRUCTION, apply the ILM rules for data destruction object /DSD/ME_TOUR_HD_DESTRUCTION to
data.

For more information about the Customizing settings of data destruction objects, see

Processing Audit Areas

Editing ILM Policies

Evaluating Retention Management Definitions

Applying ILM Rules to Data

Executing Data Destruction Object /DSD/ME_TOUR_HD_DESTRUCTION

You can destroy data from the database by executing a data destruction run for the corresponding data destruction object.

For more information about executing data destruction objects, see Data Destruction with a Data Destruction Object.

Specify the ILM object that is relevant for data destruction object /DSD/ME_TOUR_HD_DESTRUCTION.

Start the data destruction (transaction ILM_DESTRUCTION):

1. Select Data from the Database as the Type of Data to Be Destroyed.

2. Enter the ILM object relevant for data destruction object /DSD/ME_TOUR_HD_DESTRUCTION.

3. Choose Execute. In the destruction of data from the database, the actions to be started (Destroy and Administration) are
displayed.

4. Define variants for the data destruction program.

Define a selection variant for the data destruction.

To do so, you can use the following selection criteria to find the relevant DSD Connector Tour Data:

General selection criteria for finding documents and checking the retention rules:

Tour ID

Additional selection criteria for finding the field content to be destroyed:

Shipment Type

Document Type

Start date prior to

This is custom documentation. For more information, please visit SAP Help Portal. 195
 4/6/25, 11:39 PM
Standard ILM test and processing parameters:

Test Mode

Production Mode

Detailed Log

Log Output

Description of Data Destruction Run

5. Define a start date and the spool parameters for the data destruction run and choose Execute.
Additional Checks by the Data Destruction Program

There is an additional check for data destruction object /DSD/ME_TOUR_HD_DESTRUCTION to ensure the data remains in the
data base for a specified time.

Authorization Objects

You require the following authorization for data destruction:

S_ARCD_OBJ

Destroying DSD Loading Confirmations with

/DSD/SV_LC_HD_DESTRUCTION
You can use data destruction object /DSD/SV_LC_HD_DESTRUCTION to destroy DSD loading confirmation data that is no longer
relevant after its retention period expires.

You can use data destruction object /DSD/SV_LC_HD_DESTRUCTION to destroy DSD loading confirmation data that is no longer
relevant after its retention period expires. The data destruction object /DSD/SV_LC_HD_DESTRUCTION is assigned data
destruction program /DSD/SV_LC_HD_DES.

ILM Object-Based Information for the Data Destruction Object

The data destruction object /DSD/SV_LC_HD_DESTRUCTION is assigned ILM object /DSD/SV_LC_HD_DESTRUCTION.

Tables from which data records are deleted:

Table Description

/DSD/SV_LC_HD DSD LC: Loading Confirmation Header

/DSD/SV_LC_CG DSD LC: Loading Confirmation Item on Counting Group Level

/DSD/SV_LC_MAT DSD LC: Loading confirmation Item on Material Level

Standard Fields for ILM Object /DSD/SV_LC_HD_DESTRUCTION

You can use the following fields to define ILM policies for data destruction object /DSD/SV_LC_HD_DESTRUCTION:

Time Basis

CREATION_DATE (Created On)

This is custom documentation. For more information, please visit SAP Help Portal. 196
 4/6/25, 11:39 PM
Condition Fields

DOC_TYP (/DSD/SV_DOC_TYPE)

STATUS (/DSD/SV_LC_STATUS)

TRANS_PLAN_PT (TPLST)

Available Policy Categories

RTP: Retention Rules

Procedure
Finding Data Destruction Objects

To find data destruction object /DSD/SV_LC_HD_DESTRUCTION DSD Loading Confirmation Data Destruction, proceed as
follows:

1. Execute transaction DOBJ.

2. To search for the data destruction object, choose Position.

3. Double-click data destruction object /DSD/SV_LC_HD_DESTRUCTION to view more information such as the data
destruction program and the component.

4. In the dialog structure, double-click Structure Definition to display the tables from which data is destroyed.

Customizing Settings

To adjust data destruction object /DSD/SV_LC_HD_DESTRUCTION and define retention rules, proceed as follows:

1. In transaction ILMARA, define an audit area and assign the ILM object.

2. In transaction IRMPOL, define ILM rules for data destruction object /DSD/SV_LC_HD_DESTRUCTION.

3. In transaction IRMSIM, check (simulate) the retention rules for data destruction object /DSD/SV_LC_HD_DESTRUCTION
(Evaluating Retention Management Definitions).

4. In transaction ILM_DESTRUCTION, apply the ILM rules for data destruction object /DSD/SV_LC_HD_DESTRUCTION to
data.

For more information about the Customizing settings of data destruction objects, see

Processing Audit Areas

Editing ILM Policies

Evaluating Retention Management Definitions

Applying ILM Rules to Data

Executing Data Destruction Object /DSD/SV_LC_HD_DESTRUCTION

You can destroy data from the database by executing a data destruction run for the corresponding data destruction object.

For more information about executing data destruction objects, see Data Destruction with a Data Destruction Object.

Specify the ILM object that is relevant for data destruction object /DSD/SV_LC_HD_DESTRUCTION.

This is custom documentation. For more information, please visit SAP Help Portal. 197
 4/6/25, 11:39 PM
Start the data destruction (transaction ILM_DESTRUCTION):

1. Select Data from the Database as the Type of Data to Be Destroyed.

2. Enter the ILM object relevant for data destruction object /DSD/SV_LC_HD_DESTRUCTION.

3. Choose Execute. In the destruction of data from the database, the actions to be started (Destroy and Administration) are
displayed.

4. Define variants for the data destruction program.

Define a selection variant for the data destruction.

To do so, you can use the following selection criteria to find the relevant DSD loading confirmation data::

General selection criteria for finding documents and checking the retention rules:

Document Type

Document Number

Additional selection criteria for finding the field content to be destroyed:

Loading Confirmation Status

Transportation Planning Point

Created on

Standard ILM test and processing parameters:

Test Mode

Production Mode

Detailed Log

Log Output

Description of Data Destruction Run

5. Define a start date and the spool parameters for the data destruction run and choose Execute.
Additional Checks by the Data Destruction Program

There is an additional check for data destruction object /DSD/SV_LC_HD_DESTRUCTION to ensure the data remains in the data
base for a specified time.

Authorization Objects

You require the following authorization for data destruction:

S_ARCD_OBJ

Destroying DSD Visit Plans with /DSD/VC_VPH_DESTRUCTION

You can use data destruction object /DSD/VC_VPH_DESTRUCTION to destroy DSD Visit Plan data that is no longer relevant after
its retention period expires.

You can use data destruction object /DSD/VC_VPH_DESTRUCTION to destroy DSD Visit Plan data that is no longer relevant after
its retention period expires. The data destruction object /DSD/VC_VPH_DESTRUCTION is assigned data destruction program
/DSD/VC_VPH_DES.

This is custom documentation. For more information, please visit SAP Help Portal. 198
 4/6/25, 11:39 PM

ILM Object-Based Information for the Data Destruction Object

The data destruction object /DSD/VC_VPH_DESTRUCTION is assigned ILM object /DSD/VC_VPH_DESTRUCTION.

Tables from which data records are deleted:

Table Description

/DSD/VC_VPH DSD: Visit Plan - Header Data

/DSD/VC_VPP DSD: Visit Plan - Item Data

Standard Fields for ILM Object /DSD/VC_VPH_DESTRUCTION

You can use the following fields to define ILM policies for data destruction object /DSD/VC_VPH_DESTRUCTION:

Time Basis

END_OF_VALIDITY (Valid To Date)

Condition Fields

VISITPLANTYPE (Visit Plan Type)

Available Policy Categories

RTP: Retention Rules

Procedure
Finding Data Destruction Objects

To find data destruction object /DSD/VC_VPH_DESTRUCTION DSD Tour Data Destruction, proceed as follows:

1. Execute transaction DOBJ.

2. To search for the data destruction object, choose Position.

3. Double-click data destruction object /DSD/VC_VPH_DESTRUCTION to view more information such as the data
destruction program and the component.

4. In the dialog structure, double-click Structure Definition to display the tables from which data is destroyed.

Customizing Settings

To adjust data destruction object /DSD/VC_VPH_DESTRUCTION and define retention rules, proceed as follows:

1. In transaction ILMARA, define an audit area and assign the ILM object.

2. In transaction IRMPOL, define ILM rules for data destruction object /DSD/VC_VPH_DESTRUCTION.

3. In transaction IRMSIM, check (simulate) the retention rules for data destruction object /DSD/VC_VPH_DESTRUCTION
(Evaluating Retention Management Definitions).

4. In transaction ILM_DESTRUCTION, apply the ILM rules for data destruction object /DSD/VC_VPH_DESTRUCTION to data.

For more information about the Customizing settings of data destruction objects, see

This is custom documentation. For more information, please visit SAP Help Portal. 199
 4/6/25, 11:39 PM
Processing Audit Areas

Editing ILM Policies

Evaluating Retention Management Definitions

Applying ILM Rules to Data

Executing Data Destruction Object /DSD/VC_VPH_DESTRUCTION

You can destroy data from the database by executing a data destruction run for the corresponding data destruction object.

For more information about executing data destruction objects, see Data Destruction with a Data Destruction Object.

Specify the ILM object that is relevant for data destruction object /DSD/VC_VPH_DESTRUCTION.

Start the data destruction (transaction ILM_DESTRUCTION):

1. Select Data from the Database as the Type of Data to Be Destroyed.

2. Enter the ILM object relevant for data destruction object /DSD/VC_VPH_DESTRUCTION.

3. Choose Execute. In the destruction of data from the database, the actions to be started (Destroy and Administration) are
displayed.

4. Define variants for the data destruction program.

Define a selection variant for the data destruction.

To do so, you can use the following selection criteria to find the relevant DSD Visit Plans:

General selection criteria for finding documents and checking the retention rules:

Visit Plan ID

Additional selection criteria for finding the field content to be destroyed:

Visit Plan Type

Validity period ends before

Standard ILM test and processing parameters:

Test Mode

Production Mode

Detailed Log

Log Output

Description of Data Destruction Run

5. Define a start date and the spool parameters for the data destruction run and choose Execute.

Additional Checks by the Data Destruction Program

There is an additional check for data destruction object /DSD/VC_VPH_DESTRUCTION to see if the route settlement is already
completed.

Authorization Objects

You require the following authorization for data destruction:

S_ARCD_OBJ
This is custom documentation. For more information, please visit SAP Help Portal. 200
 4/6/25, 11:39 PM

Destroying DSD Deal Conditions with

/DSD/PR_HEAD_DESTRUCTION
You can use data destruction object /DSD/PR_HEAD_DESTRUCTION to destroy DSD deal condition data that is no longer relevant
after its retention period expires

You can use data destruction object /DSD/PR_HEAD_DESTRUCTION to destroy DSD deal condition data that is no longer
relevant after its retention period expires. The data destruction object /DSD/PR_HEAD_DESTRUCTION is assigned data
destruction program /DSD/PR_HEAD_DES.

ILM Object-Based Information for the Data Destruction Object

The data destruction object /DSD/PR_HEAD_DESTRUCTION is assigned ILM object /DSD/PR_HEAD_DESTRUCTION.

Tables from which data records are deleted:

Table Description

/DSD/PR_HEAD MDSD Promotions - Promotion Header

/DSD/PR_HEAD_T MDSD Promotions - Promotion Description

/DSD/PR_PCLN MDSD Promotions - Promotion Precondition

/DSD/PR_RSAM MDSD Promotions - Promotion Result Amounts

/DSD/PR_RSFG MDSD Promotions - Promotion Result Free Goods

/DSD/PR_ASGN MDSD Promotions - Customer Promotion Matrix

Standard Fields for ILM Object /DSD/PR_HEAD_DESTRUCTION

You can use the following fields to define ILM policies for data destruction object /DSD/PR_HEAD_DESTRUCTION:

Time Basis

END_OF_VALIDITY

Condition Fields

COND_TYPE (/DSD/PR_TYPE)

STATUS (/DSD/PR_STATUS)

Available Policy Categories

RTP: Retention Rules

Procedure
Finding Data Destruction Objects

To find data destruction object /DSD/PR_HEAD_DESTRUCTION DSD Deal Conditions Destruction, proceed as follows:

1. Execute transaction DOBJ.

This is custom documentation. For more information, please visit SAP Help Portal. 201
 4/6/25, 11:39 PM
2. To search for the data destruction object, choose Position.

3. Double-click data destruction object /DSD/PR_HEAD_DESTRUCTION to view more information such as the data
destruction program and the component.

4. In the dialog structure, double-click Structure Definition to display the tables from which data is destroyed.
Customizing Settings

To adjust data destruction object /DSD/PR_HEAD_DESTRUCTION and define retention rules, proceed as follows:

1. In transaction ILMARA, define an audit area and assign the ILM object.

2. In transaction IRMPOL, define ILM rules for data destruction object /DSD/PR_HEAD_DESTRUCTION.

3. In transaction IRMSIM, check (simulate) the retention rules for data destruction object /DSD/PR_HEAD_DESTRUCTION
(Evaluating Retention Management Definitions).

4. In transaction ILM_DESTRUCTION, apply the ILM rules for data destruction object /DSD/PR_HEAD_DESTRUCTION to
data.

For more information about the Customizing settings of data destruction objects, see

Processing Audit Areas

Editing ILM Policies

Evaluating Retention Management Definitions

Applying ILM Rules to Data

Executing Data Destruction Object /DSD/PR_HEAD_DESTRUCTION

You can destroy data from the database by executing a data destruction run for the corresponding data destruction object.

For more information about executing data destruction objects, see Data Destruction with a Data Destruction Object.

Specify the ILM object that is relevant for data destruction object /DSD/PR_HEAD_DESTRUCTION.

Start the data destruction (transaction ILM_DESTRUCTION):

1. Select Data from the Database as the Type of Data to Be Destroyed.

2. Enter the ILM object relevant for data destruction object /DSD/PR_HEAD_DESTRUCTION.

3. Choose Execute. In the destruction of data from the database, the actions to be started (Destroy and Administration) are
displayed.

4. Define variants for the data destruction program.

Define a selection variant for the data destruction.

To do so, you can use the following selection criteria to find the relevant DSD Deal Conditions:

General selection criteria for finding documents and checking the retention rules:

DSD Deal Conditions - Deal Condition Number

Additional selection criteria for finding the field content to be destroyed:

DSD Deal Conditions - Deal Condition Type

DSD Deal Conditions - Status of a Deal Condition

This is custom documentation. For more information, please visit SAP Help Portal. 202
 4/6/25, 11:39 PM
Validity period ends before

Standard ILM test and processing parameters:

Test Mode

Production Mode

Detailed Log

Log Output

Description of Data Destruction Run

5. Define a start date and the spool parameters for the data destruction run and choose Execute.
Additional Checks by the Data Destruction Program

There is an additional check for data destruction object /DSD/PR_HEAD_DESTRUCTION to see if the route settlement is already
completed.

Authorization Objects

You require the following authorization for data destruction:

S_ARCD_OBJ

This is custom documentation. For more information, please visit SAP Help Portal. 203