Fonction SAP BAL_DB_LOGNUMBER_GET - Application Log: Database: Get internal log number from number range

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
I_CLIENT SYST-MANDT C 3 SY-MANDT X Client
I_LOG_HANDLE BALLOGHNDL C 22 Log handle

Paramètre Reférence Type Long. Description
E_LOGNUMBER BALOGNR C 20 Internal log number issued

Exception Description
LOGNUMBER_ALREADY_EXISTS Log number already exists
LOG_NOT_FOUND Log not found
NUMBERING_ERROR Error getting next number

Functionality
This function module gets a permanent internal log number LOGNUMBER(from number range object APPL_LOG number range interval 01), for a logwith the handle I_LOG_HANDLE.
The existing temporary LOGNUMBER (beginning with $...) is replaced.
This is normally done by Application Log when saving (with the functionmodule BAL_DB_SAVE).
You should only call the function module BAL_DB_LOGNUMBER_GET if:

  • you need the internal log number LOGNUMBER because your internal data
  • structures use it to refer to the log (LOG_HANDLE, which has itspermanent value straight away and does not need replacing when saving,is better).
    • you cannot replace the temporary log number with the permanent one when
    • saving.
      • you are sure that the function module BAL_DB_LOGNUMBER_GET call will be
      • followed by a save.
        This function module can also get a number for another client(parameter I_CLIENT). The last 4 characters are 'C' and the clientnumber, e.g. 0000000000001257C010. Related function modules
        Save and load logs
        Delete logs
        INCLUDE BAL_GENERAL_LINK OBJECT DOKU ID TX
        INCLUDE BAL_TP_SEE_FUNCTION_MODULE OBJECT DOKU ID TX
        INCLUDE BAL_DD_BALLOGHNDL OBJECT DOKU ID TX
        INCLUDE BAL_GENERAL_LINK OBJECT DOKU ID TX