Activating the Database Trace

Use

Use this command only when told to do so by support. The database trace is not required for normal database operation.

You activate the database trace with this command. In this way, selected database kernel activities are logged.

The database trace is stored in the binary file knltrace in the run directory of the database instance. To evaluate the file, you first create the text version of the database trace (Creating the Text Version of the Database Trace).

The <file_id> (see also: Opening a Database File) for opening this binary version is KNLTRC.

You specify which activities are to be logged using the option <activity_list> or ALL. Separate multiple activities by spaces.
Some activities allow you to specify a log level. This specification is optional. The Database Manager CLI default is Level 5.

The special option ALL activates the logging of all activities.

Prerequisites

You have the DBM operator authorization DBInfoRead or DBFileRead.

Syntax

trace_on <activity_list> | ALL [<level>]
<activity_list> :: = <activity_spec> | <activity_spec> <activity_list>
<actvity_spec> ::= <activity> | <activity> [<level>]
<activity> :: see table
<level> ::= 1|2|3|4|5|6|7|8|9

Option <activity>

Name

Possible Levels

ALL

1 – 9

CHECK

No specification of <level> allowed

CHECKALLOCATOR

1 – 9

CHECKCONVERTER

1 – 9

CHECKDATA

1 – 9

CHECKDEVSPACE

1 – 9

CHECKFRAMECTRL

1 – 9

CHECKIOMAN

1 – 9

CHECKLOG

1 – 9

CHECKMEMORY

1 – 9

CHECKRUNTIME

1 – 9

COMMANDS

No specification of <level> allowed

DEFAULT

No specification of <level> allowed

DELETE

No specification of <level> allowed

INDEX

No specification of <level> allowed

INSERT

No specification of <level> allowed

LOCK

No specification of <level> allowed

LONG

No specification of <level> allowed

OBJECT

No specification of <level> allowed

OBJECTADD

No specification of <level> allowed

OBJECTALTER

No specification of <level> allowed

OBJECTFREE

No specification of <level> allowed

OBJECTGET

No specification of <level> allowed

OPTIMIZER

No specification of <level> allowed

ORDER

No specification of <level> allowed

PAGES

No specification of <level> allowed

SELECT

No specification of <level> allowed

STANDARD

No specification of <level> allowed

TABLE

No specification of <level> allowed

TIME

No specification of <level> allowed

TOPICALLOCATOR

1 – 9

TOPICCONVERTER

1 – 9

TOPICDATA

1 – 9

TOPICDEVSPACE

1 – 9

TOPICFRAMECTRL

1 – 9

TOPICIOMAN

1 – 9

TOPICLOG

1 – 9

TOPICMEMORY

1 – 9

TOPICRUNTIME

1 – 9

UPDATE

No specification of <level> allowed

Activate the database trace for the areas
LOCK
COMMANDS
TOPICIOMAN
Level 7
CHECKDEVSPACE
Level 3

dbmcli -d a74 -u dbm,dbmp trace_on LOCK COMMANDS TOPICIOMAN 7 CHECKDEVSPACE 3

OK

Reply

The system outputs an OK message.

In the event of errors, see Reply Format.