Functionality
The messages of a handle collected till now (I_LOG_HANDLE_FROM) arecopied to the messages of another handle (I_LOG_HANDLE_TO).
There can be two cases:
A header message (header line for messages, which are copied) is sentbefore copyingIn this case, at first, the message level is increased by1, so that thenew messages can be indented in the tree by one level.Hereby, the level of each message in the old log is takenintoconsideration. You go back to the original level of H-message oncethe messages are appended.
In case no header message is sent before adding, the messages are addedat the current log level.Even here, the levels of the messages of sourcehandle are taken into consideration. You go back to the original levelafter appending the messages.
In case the process does not require those message copied by it, becausee.g. all the messages are managed by this process, then it can give theflag I_FLG_DELETE_BUFFER while calling. If this flag is set, then themessage handle must also be returned while calling the function moduleCACS_LOG_MESSAGES_GIVE. With this message handle, the original messageis deleted from the main memory by calling function moduleBAL_LOG_MSG_DELETE.