Administration Guide > Diagnostic Tools > LOG_DUMP

LOG_DUMP

Script function: Outputs values of the memory ranges to a log file

Syntax

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

Syntax	Description/Format
Memory range	Memory range to be recorded 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" Separate several memory ranges that are to be recorded with commas.
Additional info	Any text providing additional information Format: script literal or script variable

Syntax

Description/Format

Memory range

Memory range to be recorded

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"

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

Additional info

Any text providing additional 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.

Comments

This script function only serves diagnostic purposes and must only be used in close cooperation with the support team!

The trace output is written to the file specified in the INI file of the Server (see [GLOBAL] section).

The script function TRACE_DUMP works similarly but writes the result to the trace file and considers the specified trace option and a trace level.

Example

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

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

Script element	Description
TRACE	Outputs values to a trace file
TRACE_DUMP	Outputs values of the memory range to a trace file