Ansicht
Dokumentation
BAL_LOG_MSG_CUMULATE - Application Log: Log: Message: Add Cumulatively
rdisp/max_wprun_time - Maximum work process run time Vendor Master (General Section)This documentation is copyright by SAP AG.
Functionality
A message is added to the log with (log handle) I_LOG_HANDLE cumulatively.
The message data is in the IMPORTING parameter I_S_MSG (structure BAL_S_MSG).
A message handle E_S_MSG_HANDLE, which uniquely identifies this message, is returned.
'Cumulative'
Some messages are sent several times by a program, without providing new information each time. Such
messages can be cumulated with BAL_LOG_MSG_CUMULATE to save memory. When the same message is repeated, no new message is added, the counter MSG_COUNT for the old message is incremented.
You can specify when messages are the same in the function module interface. The T100 data must be identical, and you can specify that other data must also be the same:
- I_COMPARE_ATTRIBUTES = 'X'
Message attributes (problem class PROBCLASS, level of detail DETLEVEL and sort field ALSORT) must be identical
- I_COMPARE_CONTEXT = 'X'
The context must be the same
- I_COMPARE_PARAMETERS = 'X'
The message parameters must be the same.
To find identical messages quickly for cumulation, the Application Log constructs a small index table containing as unambiguous a signature of a message as possible, at runtime. This index is only constructed if cumulation is used.
The Application Log configuration controls whether a message is directly displayed or collected. The Exporting parameters E_MSG_WAS_DISPLAYED and E_MSG_WAS_LOGGED tell you what was done with the message.
==>Note
The log handle is optional for function modules such as BAL_LOG_MSG_ADD, BAL_LOG_MSG_CUMULATE, BAL_LOG_MSG_ADD_FREE_TEXT, etc.
If it is not specified, the default log, which can be set, with other default data, with BAL_GLB_MSG_DEFAULTS_SET is used. If no default log is defined, it is set automatically by BAL_LOG_CREATE (see
here).
Related function modules
Further information
Overview of the most important function groups
Application Log: Technical documentation
Parameters
E_MSG_WAS_DISPLAYEDE_MSG_WAS_LOGGED
E_S_MSG_HANDLE
I_COMPARE_ATTRIBUTES
I_COMPARE_CONTEXT
I_COMPARE_PARAMETERS
I_LOG_HANDLE
I_S_MSG
Exceptions
LOG_IS_FULLLOG_NOT_FOUND
MSG_INCONSISTENT
Function Group
SBALGeneral Data in Customer Master General Material Data
This documentation is copyright by SAP AG.
Length: 3735 Date: 20240520 Time: 180505 sap01-206 ( 68 ms )
