Function
This method is used to determine plan values, budget values, actualvalues and commitments for the positions of a program sub-tree.

Notes
The standard output of the values is in controlling area currency. Byentering a valid reporting currency in either the REPORTING_CURRENCY orREPORTING_CURRENCY_ISO field, you can have the system output the valuesin a reporting currency that differs from the controlling areacurrency. For more information, refer to theDocumentation on the Reporting Currency in IM.
The standard output of the method are the current plan and budgetvalues of the program positions. By setting additional indicators, youcan also receive the following values:
READ_CARRY_FORWARD_VALUES_ALSO = X
During calculation of the plan and budget values of program positions,carryforward values are also taken into account.
During calculation of the plan, budget, actual and commitment values ofmeasures or appropriation requests, the measure values that werecarried forward are also taken into account (if requested; see below).
READ_FUTURE_VALUES_ALSO = X
During calculation of plan and budget values of program positions,values from the forecast are also taken into account.
READ_MEASURE_PLAN_ALSO = X
The plan values from measures and appropriation requests are also readand displayed on the program positions (in summarized form).
READ_MEASURE_BUDGET_ALSO = X
The budgets of measures and measures for appropriation requests areread and displayed on the program positions (in summarized form).
READ_MEASURE_ACTUALS_ALSO = X
The actual values and commitments of measures and measures forappropriation requests are read and displayed on the program positions(in summarized form).
INCLUDE IM_APPROVALYEAR OBJECT DOKU ID TX
INCLUDE IM_POSITION OBJECT DOKU ID TX
INCLUDE IM_PROGRAM OBJECT DOKU ID TX
See function documentation.
See function documentation.
See function documentation.
See function documentation.
See function documentation.
Refer to the functiondocumentation .
Refer to the functiondocumentation.

Meaning
Set this indicator in oreder to carry out a test run.
If the indicator is set, any errors are collected and returnedin RETURN.
You can enter a maximum number of errors that should be determined. Youenter this number in the TEST_RUN_MAX_NUMBER_MESSAGES parameter. Thedefault is 100 errors.
If the indicator is not set, processing terminates after thefirst error is found. Only this first error is returned in RETURN.
By using the TEST_RUN indicator and the TEST_RUN_MAX_NUMBER_MESSAGESparameter, you can pinpoint possible missing authorizations for readingvalues before you carry out the production run.
You should note that no values are returned in the PROGTREEVALUESLISTtable until there are absolutely no errors reported in RETURN !
SAP therefore recommends that you keep setting the TEST_RUN indicatoruntil there are no more errors reported in RETURN.
See documentation forTEST_RUN.
INCLUDE IM_PROGTREEVALUESLIST OBJECT DOKU ID TX

Meaning
Overview of the most important return messages (TYPE.ID.NUMBER):
INCLUDE IM_AP003 OBJECT DOKU ID TX
INCLUDE IM_AP005 OBJECT DOKU ID TX
INCLUDE IM_AP076 OBJECT DOKU ID TX
INCLUDE IM_AP154 OBJECT DOKU ID TX