Ansicht
Dokumentation

MEASUREM_POINT_UPD_PYEAR - NOTRANSL: RFC Meßpunkt: Änderung der Jahresleistung eines Zählers

Functionality

This RFC-capable function module was specially created for changing the annual estimate of a measuring point defined as a counter.

The annual estimate is used during scheduling by performance-dependent maintenance plans to forecast the counter reading development.

The function module can be used in the following scenarios:

A user-defined program should automatically update the annual estimate for every counter reading entry. To do this, call up the function module from the Customer Exit IMRC0001. At this point, COMMIT WORK has already been triggered at ABAP level. Therefore, the parameter COMMIT_WORK is ignored. The changed annual estimate is written to the database together with the counter readings.

A user-defined forecast program runs periodically or on specific occasions to update the annual estimate of several counters. In this scenario, the function module replaces a batch input and performs significantly better. It can be called up in three ways:

JEvery call leads directly to a database COMMIT. This is the default setting (COMMIT_WORK = 'X').

The database COMMIT is only updated after a high number of calls (for example, in packages of 1000 counters). The database is changed with a performance-reasonable array operation. In this case you only transfer the parameter COMMIT_WORK with 'X' to a package for the last call, previously with ' '.

After this function module, other modules are called up that change other data fields or other objects. All changes should be written to the same database COMMIT. In this case, transfer the parameter COMMIT_WORK with ' '. Before the COMMIT, the function module MEASUREM_DIALOG_UPDATE must be called up. The COMMIT itself can, for example, be triggered with the function module ABAP4_COMMIT_WORK.

Value of the annual estimate: If the calling-up program cannot transfer a floating point format to the R/3 system, then you can use the parameter PYEAR_IN_CHAR instead of PYEAR_IN_FLTP. The transfer takes place in a text field that is interpreted as a floating point number by the R/3 system.

Unit of measurement in the annual estimate. If you divert the annual estimate directly from the measurement document fields (overall counter reading READG or counter reading difference CDIFF), then the value applies to the corresponding SI unit and you set the parameter TAKE_SI_UNIT = 'X'. Otherwise, the unit assigned to the measuring point is used. You can also use other units of measurement. To do that, use the parameter OTHER_UNIT and transfer the unit of measurement in external format, that is, in the log-on language and in upper/lower case.

COMMIT_WORK
IMPT_BA
MEASUREMENT_POINT
OTHER_UNIT
PYEAR_IN_CHAR
PYEAR_IN_FLTP
TAKE_SI_UNIT
WAIT_AFTER_COMMIT

IMPTT_NOT_FOUND
NO_AUTHORITY
POINT_IS_NO_COUNTER
POINT_LOCKED
UNIT_UNFIT
UPDATE_FAILED
VALUE_IS_NULL
VALUE_NOT_FLTP

IMR0

BAL_S_LOG - Application Log: Log header data CL_GUI_FRONTEND_SERVICES - Frontend Services
This documentation is copyright by SAP AG.

Length: 3723 Date: 20240523 Time: 071051 sap01-206 ( 81 ms )