FPP or the emperors
new (object-oriented)
cloths
Jan Krieg, (FI-CA) SAP AG
Boris Greven, (ICM) SAP AG
Marina Plag, (FI-CA) SAP AG
Christian Mahr, (ICM) SAP AG
FPP: Framework for Parallel Processing
FPP: Maintenance and Administration
Definition of parallel runs
Parallelization Object
(persistence of run data)
Intervals
Intervals Status management for parallel runs
Intervals
Status management for Intervals
UI for maintenance of parallelization
Application Logs
objects and parallel runs
PPF: Parallel Processing Framework (software layer ABA)
Execution of parallel jobs
SAP AG 2005, Title of Presentation / Speaker Name / 2
FPP: Architecture
Package FPP
Package FPPUI (User Interface)
Package FPPIL (Interaction)
Package FPPCO (Controlling)
SAP AG 2005, Title of Presentation / Speaker Name / 3
Get rid of adjustment
IMPORT/EXPORT
ABAP (adjustment
RFDT could be necessary)
IMPORT/EXPORT
XML-Serialization
FPP_CLUST ABAP
Advance „MOVE-CORRESPONDING“
CL_DATA_CONTAINER
Example (AIR): Report ZGET_RID_OF_ADJUSTMENT
SAP AG 2005, Title of Presentation / Speaker Name / 4
Parallelization Object
GPART
ParallelObject 2
VTREF VKONT
ParallelObject 1 ParallelObject 3
Inheriting from
Basis class: CL_FPP_PARALLEL_OBJ
SAP AG 2005, Title of Presentation / Speaker Name / 5
Creation of a parallelization object I
Step 1: Create a database table for the interval distribution
Example: business partner
Foreign key relation
Interval distribution BUT000
Necessary for automatic
interval distribution
These data elements are mandatory
These data elements are specific to
the actual application
These fieldnames are mandatory
SAP AG 2005, Title of Presentation / Speaker Name / 6
Creation of a parallelization object II
Step 2: Create a class and implement the constructor
This is mandatory
Name of the interval distribution.
Name of the table for the interval distributions
If set, it is not possible to create interval
distribution with gaps between intervals
SAP AG 2005, Title of Presentation / Speaker Name / 7
Creation of a parallelization object III
Call transaction FPPOBJ and enjoy the
creation of interval distributions
SAP AG 2005, Title of Presentation / Speaker Name / 8
Parallel Run (Definition)
Data container
(replaces the
ADDONS)
CL_FPP_RUNS Customizing (FPP_CUST)
CL_FPP_PARALLEL_OBJ
CL_DATA_CONTAINER
CL_FPP_INTERVAL
CL_FPP_INTERVAL
CL_FPP_INTERVAL
CL_FPP_BAL
Parallelization
object and interval Application Log
distribution
SAP AG 2005, Title of Presentation / Speaker Name / 9
Definition of a mass activity
Viewcluster
• VC_FPP_CUST
• VC_NEW_MASS_ACT (Viewcluster for FI-CA)
Examples:
• Transaction FPP_SAMPLE
• Transaction FPP_SAMPLE_FICA
Some technical information:
• In the database tables the field MID replaces the FI-CA field AKTYP
• The new field APPL should be set to ‘FI-CA’
SAP AG 2005, Title of Presentation / Speaker Name / 10
Administration of a mass activity
SE93 : Create Transaction.
This transaction starts the report
FPP_UI_START_2
Set these parameters to the current
values of your mass activity
SAP AG 2005, Title of Presentation / Speaker Name / 11
Parallel Jobs = 2*N + 2 (N: level of parallelization)
N=4
Job 1 End 1
Job 2 End 2
FPP: Start PPF: Start
Job 3 End 3
Job 4 End 4
Time
SAP AG 2005, Title of Presentation / Speaker Name / 12
Exits (before or after an execution of the run)
All BADIs are assigned to the enhancement spot FPP_FRAMEWORK (SE18)
Class CL_FPP_RUNS:
Creation of a run (Constructor) BADI: FPP_INITIAL_RUN_DATA
Add external run ID (method SET_RUN_DATA) BADI: FPP_CHECK_EXT_RUNID
Saving of a run (method SAVE) BADI: FPP_RUN_SAVE
Class CL_FPP_SERVICES:
Copy of a run (method COPY_RUN) BADI: FPP_COPY_RUN
SAP AG 2005, Title of Presentation / Speaker Name / 13
Exits (during an execution of a run)
Start of a run
BADI: FPP_BEFORE_RUN
Function module: Begin parallelization
BADI: FPP_AT_JOB_START BADI: FPP_AT_JOB_START
Function module: Begin job Function module: Begin job
Job1 Job2
BADI: FPP_AT_JOB_END BADI: FPP_AT_JOB_END
Function module: End job Function module: End job
End
BADI: FPP_AFTER_RUN
Function module: End parallelization
SAP AG 2005, Title of Presentation / Speaker Name / 14
Exit for dynamic creation of interval distributions
If a parallel run is started and no parallelization object or no interval distribution is
provided, the following BADI is called:
BADI: FPP_FPP_CREATE_INTERVALS
This BADI provides two methods:
• GET_OBJECT Returns a parallelization object
• GET_INSTANCE
Returns an interval distribution
SAP AG 2005, Title of Presentation / Speaker Name / 15
Important database tables
FPP_RUNS Run data
FPP_RUN_INTERVAL Status management for intervals
FPP_CUST Customizing (there are 6 tables, please
look at the viewcluster VC_FPP_CUST)
All tables start with FPP_
SAP AG 2005, Title of Presentation / Speaker Name / 16
From old to new
The next slides are addressed to developers who
have to switch mass activities to the new framework
SAP AG 2005, Title of Presentation / Speaker Name / 17
From old to new (Interval function)
IMPORTING Run
parameter
ICL_RUN type ref to CL_FPP_RUNS
Application
ICL_APPL_LOG type ref to CL_FPP_BAL Log
ICL_INTERVAL type ref to CL_FPP_INTERVAL Actual
interval
ICL_COUNTER type ref to CL_FPP_COUNTER
Counter
EXPORTING
Complete,
failed, retry
EV_RESULT type FPP_RESULT
Application
EV_APPL_LOG type BALLOGHNDL Log
SAP AG 2005, Title of Presentation / Speaker Name / 18
From old to new (Interval function – parameters)
CALL FUNCTION t_fbstab-funcc
EXPORTING
i_low = intlo ICL_INTERVAL
i_high = inthi
i_basics = g_basics ICL_RUN All run data (ADDONS)
TABLES
t_counter = itab_counter
CHANGING
c_test_num = test_num ICL_COUNTER
c_success_num = success_num
c_error_num = error_num
c_itvl_rest = h_interval_restart_necessary
EV_RESULT
c_itvl_stat = h_itvl_status
EXCEPTIONS
error_message = 1
OTHERS = 2. No additional interval status
(table INTSTAT) in FPP
No ROLLBACK WORK in FPP
SAP AG 2005, Title of Presentation / Speaker Name / 19
From old to new (Interval status and restart)
• open
• in process
• cancelled To be set by the interval function (EV_RESULT)
• completed
• retry
Restart possible if no. of cancelled intervals > 0 and/or no. of open intervals > 0
Intervals with status retry will be executed in the same run if there are no
more open intervals.
New Customizing:
retry
restart
SAP AG 2005, Title of Presentation / Speaker Name / 20
From old to new (application log)
Import parameter of the interval function
ICL_APPL_LOG
Export parameter Linked to the interval
EV_APPL_LOG
• Additional logs for all other run exits (BEFORE_RUN, AT_JOB_START,
AT_JOB_END and AFTER_RUN)
• If there is no customizing for the application log the interval function can
provide a log handle (EV_APPL_LOG) which will be linked to the interval
SAP AG 2005, Title of Presentation / Speaker Name / 21
From old to new (closing of intervals)
Problem: A,B B,C C,D D,Z
Executed on job 1 Executed on job 2 Locking problem on object B
Solution: CL_FPP_INTERVAL->CLOSE_INTERVAL( ) Only if no gaps are allowed!
A,B B1,C C1,D D1,Z
Left boundary is shifted to the next physically existing database entry
• first interval won’t be changed
• right boundary of the last interval is set to the highest value (code page dependent)
SAP AG 2005, Title of Presentation / Speaker Name / 22
From old to new: User Interface for parallel runs
There are three possibilities to interact with the framework
1. By providing a DDIC-structure (replaces the TAMLAYA stuff)
2. By defining own screens (like FI-CA ADDONS)
3. By providing a DDIC-structure for free selections (identical to FI-CA)
SAP AG 2005, Title of Presentation / Speaker Name / 23
From old to new: Generated screen
DDIC structure
• Fieldname (without prefix) : Displayed as a simple field
• SEL_fieldname : Displayed as SELECT-OPTIONS
• FLG_fieldname : Displayed as a flag
The fields of the structure have to be grouped into frames
SAP AG 2005, Title of Presentation / Speaker Name / 24
From old to new: How to read data set by the generated screen?
Signature of method ICL_RUN->GET_STANDARD_DATA
This is a structure identical to the structure for standard data
• only simple fields and flags are stored in that structure
The system creates a structure for the SELECT_OPTIONS
• The fieldnames are identical to SEL_fieldname (as in the structure for
standard data)
• The type of a certain field is a table of the corresponding SELECT-OPTIONS
SAP AG 2005, Title of Presentation / Speaker Name / 25
From old to new: application specific screens
Report or function group
Screen number
Name of the tab strip
Three different application specific screen are possible
SAP AG 2005, Title of Presentation / Speaker Name / 26
From old to new: application specific screens
PBO:
lcl_run = cl_fpp_interaction_runs=>get_run( ). Get run data from
lcl_cont = lcl_run->get_data_container( ). interaction layer
CALL METHOD lcl_cont->getdata
EXPORTING
name = 'ANY_NAME'
CHANGING
data = ANY_DATA. All application specific data
is stored in a data container
PAI:
lcl_run = cl_fpp_interaction_runs=>get_run( ).
lcl_cont = lcl_run->get_data_container( ).
CALL METHOD lcl_cont->setdata
EXPORTING
iv_name = ‘ANY_NAME'
data = ANY_DATA.
Example: Function group FPP_SAMPLE, screen 1234
SAP AG 2005, Title of Presentation / Speaker Name / 27
From old to new: LAUFD and LAUFI
FPP knows nothing about LAUFD and LAUFI, but….
Method CL_FPP_RUNS->GET_RUN_DATA returns an “EXTERNAL_RUNID”
If APPL (customizing) is set to “FI-CA”
• it is possible to enter LAUFD and LAUFI via UI
• the external run ID is set to LAUFD/LAUFI
This is the only part in the Framework where we hard coded on FI-CA!
SAP AG 2005, Title of Presentation / Speaker Name / 28
How to use all the new stuff
\\dwdf034\FICA_INT\New Mass Activities\FPP- How To.doc
\\dwdf034\FICA_INT\New Mass Activities\OpenPoints.xls
Demo program for the data container (AIR): ZGET_RID_OF_ADJUSTMENT
Demo for mass activities: Transaction FPP_SAMPLE or FPP_SAMPLE_FICA
SAP AG 2005, Title of Presentation / Speaker Name / 29
SAP AG 2005, Title of Presentation / Speaker Name / 30
SAP AG 2005, Title of Presentation / Speaker Name / 31
