Fonction SAP APPL_LOG_INIT_MESSAGES - Application Log: (Partially) Initialize log in local memory

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
CONTINUE_PROTOCOL 0 SPACE X write current log
LOG_HANDLE BALHDR-LOG_HANDLE C 22 SPACE X
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 initializes (deletes) messages from local memoryfor the specified object and subobject. Either all messages(CONTINUE_PROTOCOL = SPACE), or only the messages which havebeen written into local memory since the last call ofAPPL_LOG_WRITE_DB are deleted, depending onthe parameter CONTINUE_PROTOCOL.
The header data are not initialized. You can write a new log for thecurrent object and subobject with the same header data as the previouslog (CONTINUE_PROTOCOL = SPACE) or use the current log withoutinitializing the header data. or its parameters.
The same object and subobject checks are made as in the function moduleAPPL_LOG_SET_OBJECT.

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

Description
This parameter specifies whether the current log is continued or a newlog is created the next time that a log header or message is writtenafter the function module.

Default
The initial value (SPACE) is default and means that a new log iscreated.

Description
This parameter contains the name of the object towhich the local memory of the function group is to be initialized.

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 subobject ofthe specified object, to which the local memory of thefunction group is to be initialized.

Value range
INCLUDE 'APPL_LOG_PAR_SUBOBJ_VALUES' OBJECT DOKU ID TX

Default
The parameter has the default value SPACE and must only be specifiedwhen the specified object has subobjects.