LOG_DUMP

Use the LOG_DUMP script function to output values of the memory ranges to a log file. The trace output is written to the file specified in the [GLOBAL] section of the INI file of the Automation Engine, see Automation Engine.

Important! This script function serves diagnostic purposes only. It can generate huge amounts of data in a short time and this can have a noticeable negative effect on system performance. Use it when the Support team instructs you to do so explicitly. Your support case assistant knows which values to set to collect targeted data with the lowest impact on your system performance.

Note: The TRACE_DUMP script function works similarly but writes the result to the trace file and considers the specified trace option and a trace level. For more information, see TRACE_DUMP.

See also Diagnostic Tools: Logs and Traces.

Syntax

LOG_DUMP (Memory range [, memory range,...][, additional info])

Parameters

  • Memory range

    Memory range that you want to write to the log.

    • Format: Script literal or script variable.

    • Allowed values:

      • "WORK MEMORY"

      • "LOCAL MEMORY"

      • "XML + XML-Handle"

      • "DB + Table name(column name;column name;...)"

      • "DB + Table name"

      • "SCRIPT_VARA"

      • "SCRIPT_PRG"

      • "USER_TAB"

      • "CLNT_TAB"

      • "EX_TAB"

      • "*_TAB"

      • "GIVE_ME_ALL"

      Note: Separate several memory ranges that are to be recorded with commas.

  • Additional info

    Any additional text or information

    Format: Script literal or script variable.

Return Codes

  • 0 - The trace was successful

  • 20209 - The indicated memory range is not supported

  • 20210 - The XML handle is wrong

  • 20211 - The table does not exist

Example

In the following example, a trace for several memory ranges is activated:

:SET &RET# = LOG_DUMP("XML + &xml_hnd#, SCRIPT_VARA, SCRIPT_PRG")

See also: