Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

DAP Creation

For group of Objects a user creates the Data Archiving Process in the first step.
OutBoard Mass archiving allows a user to:

  • Create DAP (F8) for Objects without DAP
  • Reactivate DAP (CTRL+F11) for selected Objects

DAP Creation



Group archiving - settings


Press:

to save. The Mass Archiving Group must be saved  before being able to create/ reactivate DAP

Press:

to edit the settings of DAP use button Settings (F9) in the Application toolbar or go to Menu bar→ Group

For ChangeLogs and PSAs the DAP Settings are always the same – the data will be archived based on requests.
Information about individual tabs:
Data Archiving Process – the possibility to edit DAP parameters is only offered for a group of standard InfoProviders.
For ChangeLogs and PSAs the DAP Settings are always the same – the data will be archived based on requests. For a group of InfoProviders you can set here:

  • Characteristic for the Time Slices (only common Time Slices characteristics of all InfoProviders are optional)
  • Maximum Size in MB and Maximum Number of Data Objects
  • Package for DAP has to be specified here ($TMP or by user created package). When DAP is created it is automatically assigned to this package. In case of DAP reactivation the package in the Settings will be not assigned (if changed) - user has to change the Package in case of reactivation manually. Default value for Package is $TMP. Object from $TMP cannot be transported!
  • In SAP BW Release higher than 7.30 you are allowed also to archive non-compressed data via mass archiving
  • If using OutBoard storage management, the Aging profile for data should be defined here. Make sure to reactivate existing DAPs each time, when the storage profile is changed in Massarchiving Settings

In case you are archiving PSAs or Changelogs, the archiving is based on the request datum (when the data were loaded into Object) by default. Additional partitioning is now possible with the exception of Primary characteristic for time slices. In Mass archiving addition portioning is also possible.


Additional Partitioning

When specific additional partitioning characteristics are chosen, both the Initial and Scheduled run, will provide further options for the setup archiving request – option "Set characteristic values" becomes visible in both tabs.

Additional partitioning characteristics

This condition is than automatically used when new archiving variants are created.
Semantic group – semantic group for the Mass archiving can be specified – only common InfoObjects of InfoProviders appear in the selection. This tab is only provided for standard ODSes and InfoCubes. Automatic creation of semantic group – since OutBoard summer release 2014 it is possible to create a Semantic group automatically for DSO's. With the new option in Mass archiving settings "Automatic creation of Semantic Group" all key fields of the DSO will be used in Semantic group of the DAP. When this checkbox is enabled (can be found in "Data Archiving Process" Tab), "Semantic Group" tab is no longer required.
Initial run – overview of parameters needed for Initial Run Archiving Requests. Detailed description of Initial run settings can be found below.
Scheduled run – overview of parameters needed for Scheduled Run Archiving Requests. Detailed description of Scheduled run settings can be found below.
DAP can be created immediate or based on your selection in the standard Start Time screen.


Note

If an object has a DAP in place prior to the Mass Archiving Group DAP Settings. This will be indicated by Image Modified in the DAP column.


Tip

It is recommended that if an object is going to be grouped in a mass archive, then to avoid the potential conflicts with, i.e. time slices etc, then the DAP is best to be created in the mass archive level rather than on the individual object level. 

DAP column with indicator (ZVH_KO has created DAP)

When creating the DAP (button Create DAP (F8) in Group Menu), the user can start the process based on his choice in standard SAP scheduling screen.

Setting the start time for creating DAP

Based on the given Package (not $TMP) in the Settings the user will be asked, in which transport request the DAP should be added. If there already exist DAPs assigned to more requests, the one transport request corresponding to the DAP with the highest priority will be offered. The DAPs, which are created here, will be then automatically added in this provided transport request.

Group archiving - Transport request

The DAP creation process can be monitored by refreshing the screen (Refresh button in the Application toolbar or F5). After DAP of particular InfoProvider has been created, it can also be viewed by clicking on the DAP icon in the table of InfoProviders (jump into TA RSDAP). Although it is possible to edit DAP here, it is only recommended to change DAP on group level – functionality reactivate DAP.

Reactivate DAP

To reactivate DAPs for InfoProviders of the group, select them and go to the Menu Bar → Actions → DAP → Reactivate DAP (Ctrl+F11). To watch the process of reactivation; go to the Application Toolbar → Display Logs (Shift + F6). By the DAP reactivation the user is again asked, in which transport this request should go – in the screen is the one proposed, which was given by the DAP creation.

View Logs

Press:

To see logs for the group click on  Display Logs (Shift + F6) in Application toolbar and execute

Mass archiving - logs

Priority

OutBoard Mass archiving allows a user to prioritize creation of DAP, Initial Run and Scheduled Run and archiving for selected Objects of group. To update the priority user has to select Object(s) and use the function Set priority (Ctrl + F12).

Setting priority for InfoProvider

Priorities are integer numbers and the lower is the priority number the higher priority is set for Object(s). (E.g. Object with Priority set to 1 will be proceeded before Object with Priority set to 2…). This functionality is also accessible from Menu Bar → Actions → Set Priority. When a priority is set, this will be visible in priority column

Mass archiving - Priority column

As mentioned before, the group settings are dependent on the type of group. Based on the type of group you are able to change the Group Settings and define the way, how the objects will be archived.

Settings for Archiving

The user has two options:

  • Create and execute Initial Run - Used to execute an initial archiving of data. In the settings of the Initial Run a user specifies the start of archiving, end of archiving and by defining the archiving step in how many requests should be the mentioned time period divided.
  • Create and execute Scheduled Run – Used to execute a scheduled archiving of data. This archiving can be scheduled in a process chain and could be used for example to archive once a year data older than a year.

Initial Run and Initial Run Settings
In order to create user specific archiving requests the user must edit Settings → Initial Run tab.

Settings - Initial Run tab

With user specific Settings one or more archiving variants are created for each InfoProvider/Object. Later, when the Initial Run is started, these variants are used to create archiving requests and the archiving can be executed. As mentioned before, the group settings in mass archiving are dependent on the type of objects (i.e. PSA or Cube).
Based on the type of group you are offered different options of archiving data and also transporting of group objects. In the technical settings of Initial Run following parameters can be specified:
Run settings:

  • Duration of Initial Run: After this time the creation and execution of archiving request will be stopped and the Initial Run has to be restarted in order to continue with the archiving. Default value 0 means no time limitation for archiving. Values have to be entered in minutes i.e. 2 hours duration would be entered as 120.
  • Max degree of archiving object parallelism: Number of background jobs for Initial Run. If it is changed during the runtime, the new number will be updated.
  • Max degree of archiving variant parallelism: Number of archiving variants running in parallel for an object for when end-deletion is used.

Run Settings in Initial Run tab


Archiving conditions:
In this tab you define how the data is archived. This is done either relative or absolute. In the following we will describe each of these two options:

Select Conditions in Initial Run Tab

Relative mass archiving

Relative Select conditions in Initial Run Tab

Here you can define (with regard to the archiving start) which data will be archived. In the example above three archiving requests will be created. In the first archiving request the data older than and equal to 12.2010 will be archived, in the second archiving request all data older than or equal to 12.2011 will be archived, and finally in the last archiving request the data older than or equal to 12.2012 will be archived.
Parameters used to specify the data to be archived:
Time Shift when Initial Run Starts: Start of archiving - in the first request the data older that this value will be archived (information in the red rectangle).

  • Step Of Initial Run: This step divides the time period which should be archived into smaller time periods.
  • Time Shift when Initial Run Ends: End of archiving - in the last archiving request will be archived data older than this value (information in green rectangle).
  • Unit for Rounding the Time Shift: Only complete Time periods will be archived.

If the information about the time shift change to make these changes take affect; press Enter or "Confirm date settings" button.

Absolute mass archiving

Here, you can define absolute values for archiving – format of these values should be same as of the ones that are chosen for time-slice characteristic. Choose Display/Create Variants and define values for the absolute archiving:

Absolute select conditions in Initial Run Tab

Tip
titleMultiple row addition

To add multiple rows at one time, press the button marked on following picture and type in the number of empty rows to be added into variant definition.

 Mass archiving - variant definition - add multiple rows

Variants Definition also offer opportunity to Export the Absolute Archiving condition to the file and Import the Absolute Archiving condition form the file. Expected is an excel file in the .csv format.

Tip
The table operate with hidden rows and columns. Therefore it is necessary to use table in format as on figure bellow. In GRPID column is name of your Mass archiving group.

Format of Excel (*.csv) table

Use BADI to define variants - When the field is checked, BAdI defined by the user can be implemented to create variants for archiving.

Absolute Select Conditions (BAdl) in Initial Run Tab

The user can define variants for archiving based on absolute values, instead of relative archiving. Developers have only to create BAdI implementation for BAdI /DVD/NLS_INTIAL_RUN_VARIANTS. The ouput format of the BAdI implementing class method /DVD/NLS_CREATE_INIT_VAR should be  table type /DVD/NLS_TT_VAR_LIMITATION. The values of the output should have the same format as values for absolute archiving. What means in BAdI it shoud have the same format as Primary Partitioning Characteristic for DAP  - i_partnm. When this BAdI returns no values the initial run will be created the standard way.
The input parameters used for BAdI are the following:

_i_dapname_

Name of the InfoProvider

_i_start_

Time Shift when Initial Run starts

_i_step, i_shift_

Step of Initial Run

_i_end _

Time Shift when Initial Run ends

_i_rounit_

Unit of Rounding the Time Shift

_i_shunit _

Unit of Time Shift

_i_timnm_

BW Archiving: Characteristic for Time Slices

_i_variant_

Fiscal Year Variant

_i_partnm_

BW Archiving: Leading Characteristic for Partitioning

Create custom variants - In case the restriction of data for archiving is complicated and requires using not only time-characteristic to determine data to be archived but also one or multiple additional characteristics, then you can use the functionality for uploading from file. To use this, OutBoard custom variants should be created/added into massarchiving:

Custom variants

After choosing Display/Create Variants the user will jump into screen, where the custom variants can be created.

Image Modified

Custom variants in massarchiving

An archiving variant is created based on the rows specified in the Variants-Definition -> the first four columns with the same value are used to define one archiving variant. In the example above this means the first archiving variant is created to archive data that satisfies condition:
          0CALDAY between 05.01.2010 and 31.01.2010 AND
          ZCARRID equals 'LH' AND
          ZCONNID does not equal '0001542538'.
The variants can be also uploaded from .csv file separated by semicolons :

Image Modified

Import File

In the uploaded file only the following values need to be filled with relevant data:
InfoProvider;Variant number;Characteristic;Sign;Option;Lower limit;Upper limit

Supported Signs:
I: Include
E: exclude

Supported Options:
EQ (equal)
BT (between)
LE(less equal)
GE (greater equal)
LT(less then)
GT (greater then)

Process Flow Control

Process Flow Control in Initial Run Tab

  • Deletion-phase in last step only: For performance optimization reasons is suitable to delete the data at once for all Initial Run archiving variants. When this field is checked, Initial Run Archiving is done to the phase "50 - Verification Phase Ended Successfully" for each archiving variant except the last. After these Variants from Initial Run are executed to Verification  phase, the deletion phase will be started. If in Initial Run settings you choose Start of Initial Run a higher number than End of Initial Run, only the deletion archiving variant will be created here.
  • Without starting deletion – When this field is checked, the deletion variant will not be created for Initial Run. Therefore all archiving requests will be executed only to the phase "50 - Verification Phase Ended Successfully" and no deletion will occure. The deletion can still be scheduled, i.e. in Process chains.
  • Autom. Req. Invalidation After Error – An archiving request with error will be automatically invalidated.
  • Rebuild BWA index: when this field is checked, BWA index is rebuild when data is archived