Ansicht
Dokumentation
BAL_GLB_AUTHORIZATION_RESET - Application Log: Global: Cancel authorization
BAL Application Log Documentation Fill RESBD Structure from EBP Component StructureThis documentation is copyright by SAP AG.
Functionality
Critical functions such as configuration (function module BAL_GLB_CONFIG_SET) and initialization (function module BAL_GLB_MEMORY_REFRESH) should normally only be performed by the mother program. Lower level routines should not perform these global activities.
Problems can occur when a lower-level routine calls the initialization module, for example because this routine was not originally intended to be called in this context.
You can avoid such effects with authorizations:
The mother program (the first program to have control)
can get an authorization at the start with the function module BAL_GLB_AUTHORIZATION_GET, which returns a unique key in E_AUTHORIZATION.
The critical functions can only be performed by specifying the key I_AUTHORIZATION. If I_AUTHORIZATION is not specified, or has the wrong value, the action (e.g. initialize memory) is refused. BAL_GLB_AUTHORIZATION_GET can not be repeated, so you cannot get a second key.
You can return the key with BAL_GLB_AUTHORIZATION_RESET (specifying the key).
All the above function modules can then be called without authorization.
The following function modules require authorization:
BAL_GLB_AUTHORIZATION_GET
BAL_GLB_AUTHORIZATION_RESET
BAL_GLB_CONFIG_SET
BAL_GLB_MEMORY_REFRESH
BAL_GLB_MSG_DEFAULTS_SET
BAL_STATISTICS_GLB_SET
==>Note
To remove the data of a single log from memory use the function module
BAL_LOG_REFRESH, which does not require authorization as it only affects one log and not the entire function group memory.
==>Note
Your programs should allow for the fact that an action can be refused and not assume successful performance.
- ==>Example
It is common to initialize memory, call a function and then look for errors in the log. This shifts program exception handling to the log tool, which is not its purpose.
You should not do this because the messages collected by the Application Log and memory reset can be controlled externally, so you cannot control which messages are in the log.
Further information
Overview of the most important function groups
Application Log: Technical documentation
Parameters
I_AUTHORIZATIONExceptions
NOT_AUTHORIZEDFunction Group
SBAL_TOOLBOXVendor Master (General Section) General Material Data
This documentation is copyright by SAP AG.
Length: 3390 Date: 20240520 Time: 181330 sap01-206 ( 55 ms )
