Ansicht
Dokumentation

BAL_S_PROF - Application Log: Log Output Format Profile

BAL Application Log Documentation   ABAP Short Reference  
This documentation is copyright by SAP AG.

The display profile (structure BAL_S_PROF) specifies how the log is to appear. It contains the field catalog, which describes which fields are in the list and in the various chapter levels of the navigation tree.

The Application Log provides predefined display profiles which you can get with function modules (see here).
You can also construct your own display profile. If no display profile is specified, the standard display profile of transaction SLG1 is chosen.
The display profile contains the following fields (all fields are optional except MESS_FCAT):

• General parameters

• LANGU
  Log output language

• TITEL
  Screen title

• USE_GRID
  Messages are to be displayed with the ALV Grid Control, not the standard ALV (ignored if the display uses Grid Control by default).

• NO_TOOLBAR
  'X': The toolbar above the ALV grid is hidden (only meaningful if USE_GRID = 'X').
  If you manipulate the toolbar, you can insert your own buttons (see EXT_PUSH1, ..., EXT_PUSH4) or completely modify the toolbar (see CLBK_TOOLB).

• START_COL, START_ROW, END_COL, END_ROW
  Coordinates if the log is displayed in a popup.
  POP_ADJST
  If this parameter is 'X', the system adjusts the dialog box height
  (if the log is displayed in a dialog box) to the data to be displayed. The values entered above are then upper limits.

• NOT_EMPTY
  If this parameter is 'X', branches which are just one entry and all data (in the field catalog) are initial, are not displayed.
  Example:
  As document 1000013 initially has no position-dependent messages, the tree is initially (by document and item numbers):
  Document 1000012
  -- Item 0010
  -- Item 0020
  Document 1000013
  -- Item 0000
  Document 1000014
  -- Item 0010
  If NOT_EMPTY = 'X' the entry "Item 0000" is omitted because all fields after it are initial (including invisible ones).

• COLORS
  Problem class display colors. COLORS-PROBCLASS1 = "3" e.g. highlights all problem class 3 messages in yellow (standard).
  Message list parameters

• MESS_FCAT
  Message list field catalog (table type BAL_T_FCAT with structure BAL_S_FCAT).
  All fields of the structure BAL_S_SHOW and message or log header context fields can be displayed.

• MESS_SORT
  Message sort sequence table (table type BAL_T_SORT with structure BAL_S_SORT).
  Contains table and field name, serial number and sort ascending or descending flag. Fields mentioned here must have been previously mentioned in MESS_FCAT.

• SHOW_ALL
  "X": all messages are immediately visible in the list and need not be selected in the tree first.

• MESS_MARK
  "X": messages selectable via checkbox

• CWIDTH_OPT
  Optimize message list column width

• DISVARIANT
  Structure DISVARIANT: List viewer display variant data (Report name, handle, etc.)
  Note: if other ALV lists (or ALV grids) are displayed in the same program, you should use the handle to avoid confusing the diaplay variants of the various lists.

• Navigation tree parameters

• LEV1_FCAT, ..., LEV9_FCAT
  Field catalogs for chapter levels 1 to 9 (table type BAL_T_FCAT with structure BAL_S_FCAT).
  You can display all fields of the structure BAL_S_SHOW and message or log header context fields.

• LEV1_SORT, ..., LEV9_SORT
  Chapter level sort sequence table (table type BAL_T_SORT with structure BAL_S_SORT).

• HEAD_TEXT, HEAD_SIZE
  CHAR/INTEGER: Contents and width of the tree header

• ROOT_TEXT
  CHAR: Root node text (only to be used in exceptional cases. The root node should not be a header, which should be in HEAD_TEXT).

• TREE_SIZE
  INTEGER Tree Control size (in CHARACTER). This value is only approximate because of proportional font.

• TREE_ONTOP
  "X": tree control is displayed above the message list

• TREE_ADJST
  "X": if the tree is above the messages ( TREE_ONTOP = 'X'), try to adjust the hight of the tree to the number of rows to be displayed. TREE_SIZE is the maximum hight of the tree.

• EXP_LEVEL
  1,.., 9 the level to which the tree is to be expanded

• BYDETLEVEL
  "X": construct navigation tree by message field DETLEVEL.

• TREE_NOMSG
  "X": the tree contains no message data. It consists exclusively of log header data.
  

• Callback routines
  The callback routines are defined according to the DDIC structure BAL_S_CLBK.

• CLBK_READ
  Read external display data (e.g. material short text)
  (see here).

• CLBK_UCOM
  Perform user commands
  (see here).

• CLBK_UCBF
  Called BEFORE performing a user command
  (see here).

• CLBK_UCAF
  Called AFTER performing a user command
  (see here).

• CLBK_PBO
  Display PBO (e.g. to set a user status)
  (see here).
  

• CLBK_TOOLB
  Modification of toolbar using ALV Grid
  (USE_GRID = 'X' is prerequisite)
  (see here).
  

• User pushbuttons

• EXT_PUSH1, ..., EXT_PUSH4
  These components put user pushbuttons in the menu, without having to define a GUI status. Choosing one of these pushbuttons at PAI calls the user command "%EXT_PUSH1", ... "%EXT_PUSH4", to which you can react in the corresponding callback routine. A pushbutton definition has the following elements:
  EXT_PUSH1-ACTIVE = "X":,,pushbutton is active
  EXT_PUSH1-DEF-TEXT,, ,,pushbutton text
  EXT_PUSH1-DEF-ICON_ID,,pushbutton icon
  EXT_PUSH1-DEF-ICON_TEXT,,icon text
  EXT_PUSH1-DEF-QUICKINFO,,quick info
  EXT_PUSH1-DEF-PATH,, ,,fastpath
  EXT_PUSH1-POSITION,, ,,position at which the button is to appear
  ,, ' ': in the application toolbar
  ,, '3': in the toolbar above the message list on the left
  ,, (only if USE_GRID = 'X')
  ,, '4': in the toolbar above the message list on the right
  ,, (only if USE_GRID = 'X')

Further information

Overview of the most important function groups

Quick start documentation

Application Log: Technical documentation

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   PERFORM Short Reference  
This documentation is copyright by SAP AG.

Length: 9750 Date: 20240520 Time: 144647     sap01-206 ( 93 ms )