Fonction SAP BKK_UPT_DISP_START - Start Dispatcher for Parallel Processing

Paramètre	Reférence	Type	Long.	Valeur par déf.	Facultatif	Description
I_CNTINTV	I	I	4			Number of Intervals
I_DISPLAY_MODE	I	I	4	7	X	Display Mode (What Is to Be Displayed)
I_FREETASKS	I	I	4	1	X	Number of Free Tasks per Server
I_FUNCNAME	BKK_PAFUNCNAME	C	30			Name of Parallel Processing Application Function Module
I_JOBCLASS	C	C	0	'A'	X	Job Class
I_MAXTASKS	I	I	4		X	Maximum Number of Parallel Tasks
I_MINTASKS	I	I	4	1	X	Minimum Number of Tasks per Server
I_PARMTAB	BKKD_TAB_UPTPARM		0		X	Parameter for Function
I_PROGDATE	BKK_PRGDAT	D	8	SY-DATUM	X	Date of Program Run
I_PROGN	BKK_PROGN	C	40	SY-CPROG	X	Name of Program/Report for an Application Process
I_REPORTNAME	SYST-CPROG	C	40	'RFBKUPTJOB'		Report Name
I_XDEBUG	BOOLE-BOOLE	C	1		X	Debug Mode On/Off

Paramètre	Reférence	Type	Long.	Description
E_DISPID	BKK_DISPID	C	61	Dispatcher Identification
E_TASKSTATUS	BKKD_TASKSTATUS		0	Overall Status of Tasks

Exception	Description
CNTINTV_MISSING	Number of Intervals Missing
ERROR_DURING_INTV_BUILD	Error when Generating Interval Control Data
ERROR_GET_BTCH_SERVERS	Error when Determing Batch Servers
ERROR_RUNKEY	Error when Creating the Run Key
ERROR_SET_FUNC_PARAM	Error when Setting Function Parameters
ERROR_STARTING_JOBS	Error when Starting Jobs
FUNCNAME_MISSING	Function Name Missing
NO_BTCH_SERVERS	No Batch Servers Available
REPORTNAME_MISSING	Report Name Missing

Functionality
This function starts the dispatcher for the parallel processing offunctions. Within this function the report I_REPORTNAME and thefunction I_FUNCNAME for the I_CNTINTV number of intervalsare processed in parallel in the form of a batch job. After all of theintervals have been processed by the parallel job the function returnsto the calling program. The function can be called in batch or in theonline processing screen. The reports are always started as batch jobs.The parameters are transferred to the function called by the report byway of table I_PARMTAB.

Description
The dispatcher identification is a unique key for the dispatcher and iscompiled of the following: Program name '-' Date of program run '-'Sequence number of program run '-' 'Step number within the program run.
Example: RFBKSOPAR-20021001-001-001

Description
This parameter contains the total number of intervals to be processed.In the function BKK_UPT_DISP_INTERV_CREATE a control record iscreated for each interval in the table BKKMDISPINTERV .

Description
This parameter is only relevant for the execution of the calling programin the online processing screen. See the description of the functionBKK_UPT_DISP_INTERV_DISPLAY.

Value range
0...15 (larger number are calculated modulo 16)

Default
7

Description
The number of batch server tasks that are not put on a server (letfree). This parameter is used by the function
BKK_UPT_DISP_SERVERS_GET.

Value range
0...

Default
1

Description
Name of the function to be used in parallel processing. This function iscalled by the report I_REPORTNAME.

Description
These parameters are used to determine the job class. Jobs with class'A' are prcessed with greater priority than jobs with class 'C' . Thefunction BKK_UPT_DISP_JOBS_START requires these parameters whengenerating and starting the parallel jobs.

Value range
A...C (Only A is effective otherwise jobs with class C are started.)

Default
A

Description
The maximum number of tasks determines the maximum number of tasks to bestarted in parallel (Report I_REPORTNAME with call function I_FUNCNAME).The actual number (per server) is determined in functionBKK_UPT_DISP_SERVERS_GET. The parameters I_MINTASKS and I_FREETASKS alsoinfluence the number determined. If the number of intervals (I_CNTINTV)is smaller than I_MAXTASKS the value in I_MAXTASKS is reducedaccordingly.

Description
The minimum number of batch tasks that are to be started on a server(batch server). This parameter is used by the function
BKK_UPT_DISP_SERVERS_GET.

Value range
0..

Default
1

Description
This table contains the parameters for the function I_FUNCNAME called inthe report I_REPORTNAME. The function BKK_UPT_DISP_PARAM_EXPORT storesthese parameters.

Description
The date of the program run.

Default
This value is taken from the SY-DATUM field.

Description
Name of the calling program.

Default
The name is taken from the SY-CPROGN field.

Description
Name of the report that calls the function I_FUNCNAME that is tobe run in parallel processing.

Description
The test mode is activated or deactivated. No background jobs arestarted in test mode. The report to be started is executed in theforeground (there is no parallel processing).