Tracing SYSREVDB

The SYSREVDB internal trace collects tracing data during the execution of SYSREVDB. The data can be viewed on the screen or downloaded to a PC.The trace helps support when analyzing issues of SYSREVDB.

The trace is controlled by the TRACE command which may be issued from any screen in SYSREVDB.

The TRACE command and the supported options are described in detail in the Command Reference > TRACE Command.

Trace information is not provided by every module of SYSREVDB. The trace is expanded as needed.

Using the TRACE Command

Before you start the SYSREVDB trace, navigate to the page which you want to trace.

Start of instruction setTo start the trace:

  • Enter the command TRACE ON on the command line. This starts the full trace (level 9). If less data should be collected, use smaller trace level, like TRACE 4.

Once the trace is started, perform the SYSREVDB functions which should be traced. Then stop the tracing and print or download the trace data.

Start of instruction setTo stop the trace:

  • Enter the command TRACE OFF on the command line.

Start of instruction setTo print the trace data on the screen:

  • Enter the command TRACE PRINT on the command line.

Start of instruction setTo download the trace data to the PC:

  • Enter the command TRACE EXPORT on the command line.

When you stop and restart the trace, the new data is added to the data collected before. If you want to start a new trace from scratch, you must clear the trace data.

Start of instruction setTo clear the trace data:

  • Enter the command TRACE CLEAR on the command line.

    The trace data is implicitly cleared when you leave the SYSREVDB library.

Start of instruction setTo receive the trace status:

  • Enter the command TRACE (without option) on the command line. It prints the trace status (started or stopped) and if started, the used trace level.

Trace Output

In general, a trace entry contains a time stamp, the name of the object currently executing and the trace entry itself. The first trace entry shows the trace level, the Adabas Review version, and the version of SYSREVDB.

Example of a trace output:

2024-04-24 15:20:48.3 N-TRACE Trace is started. Level: 9 Review: 5.3_SP1 SYSREVDB: 5.3.1. 
2024-04-24 15:20:58.3 S-DBCMD Start of function 'Process command'. Command: TRACE OFF                                                                  
2024-04-24 15:20:58.3 N-TRACE Start of function 'Maintain TRACE command'.  
2024-04-24 15:20:58.3 N-TRACE Trace is stopped.

Using the REVTRACE Program

In a batch job or from the NEXT input, the trace can be maintained with the REVTRACE program. The REVTRACE program provides the same options as the TRACE command.

REVTRACE also allows tracing of the SYSREVDB initialization which is done before the main menu is displayed.

The REVTRACE program is described in Using Adabas Review in Batch Natural > Tracing SYSREVDB using Batch Natural.

Example of tracing SYSREVDB in batch Natural:

LOGON SYSREVDB                             
REVTRACE ON                                
SET TARGET=00129,DBID=177,FILE=37          
DELHIST HIST-TEST 2022-11-24 2022-12-01
REVTRACE PRINT                             
REVTRACE EXPORT                            
FIN

In batch, the exported trace data is written to work file 7.

On this page