Fonction SAP APPL_LOG_SET_OBJECT - Appplication log: Set current object and subobject

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
LOG_HANDLE BALHDR-LOG_HANDLE C 22 SPACE X
NO_LOG 0 SPACE X Flag: Collect or output messages
OBJECT BALHDR-OBJECT C 20 SPACE X Object name
SUBOBJECT BALHDR-SUBOBJECT C 20 SPACE X Subobject name

Exception Description
OBJECT_NOT_FOUND Object not found
SUBOBJECT_NOT_FOUND Subobject not found

Functionality
This function module checks whether the specified object exists andwhether the specified sub-object exists for the object. If nosub-object has been specified the module checks whether there are nosub-objects for the object.
A missing object or sub-object triggers the exceptions OBJECT_NOT_FOUNDor SUBOBJECT_NOT_FOUND respectively.
If the check is successful the function module resets the object,sub-object and the flag "Collect message" or "Output message" in thelocal memory.
With the flag you can control whether, when calling the functionmodules for writing (APPL_LOG_WRITE_SINGLE_MESSAGE,APPL_LOG_WRITE_MESSAGES, APPL_LOG_WRITE_MESSAGE_PARAMS), the messagesshould be written to the local memory or output on the screen.

Example
Example call:
DATA: OBJECT LIKE BALHDR-OBJECT,
SUBOBJECT LIKE BALHDR-SUBOBJECT.
...
CALL FUNCTION 'APPL_LOG_SET_OBJECT'
EXPORTING
OBJECT = OBJECT
SUBOBJECT = SUBOBJECT
NO_LOG = SPACE
EXCEPTIONS
OBJECT_NOT_FOUND = 01
SUBOBJECT_NOT_FOUND = 02.

Notes

  • The decision whether to collect or output messages per
  • object/sub-object is valid until explicitly redefined with thisfunction module.

    Description
    With the flag you can control whether, when calling the functionmodules for writing (APPL_LOG_WRITE_SINGLE_MESSAGE,APPL_LOG_WRITE_MESSAGES, APPL_LOG_WRITE_MESSAGE_PARAMS), the messagesshould be written to the local memory or output on the screen.
    The decision whether to collect or output messages perobject/sub-object is valid until explicitly redefined with thisfunction module.

    Value range
    Possible values are:
    SPACE,,Messages are logged or collected.
    'X' ,,Messages are output directly.

    Default
    All messages are logged.

    Description
    This parameter contains the name of the object, thatis to be set in the local memory as the current object.

    Value range
    INCLUDE 'APPL_LOG_PAR_OBJECT_VALUES' OBJECT DOKU ID TX

    Default
    INCLUDE 'FU_PAR_OBL' OBJECT DOKU ID TX

    Description
    This parameter contains the name of a sub-objectfor the specified object that is to be set in thelocal memory.

    Value range
    INCLUDE 'APPL_LOG_PAR_SUBOBJ_VALUES' OBJECT DOKU ID TX

    Default
    The parameter is preallocated with SPACE. Therefore it only needs to beset when sub-objects exist for the specified object.