Requesting the Diagnosis History 

Use

You request the available diagnosis history.

If a database instance was not properly stopped, the system backs up certain database files when restarting the database instance.

These files are required for the diagnosis of problems that occurred previously. The files are backed up by the system in a diagnosis backup and stored in the directory DIAGHISTORY in the run directory of the database instance (Database Manager CLI default value). You can define this path using the parameter DIAG_HISTORY_PATH.

If you run the command without specifying the option <YYYYMMDDHHMMSS>, the system displays a list of all available diagnosis backups. The backups are listed with their time stamps and the paths under which they are stored. This means that you can also access the diagnosis backup using operating system resources.

If you enter the command again, and specify a time stamp for the option <YYYYMMDDHHMMSS>, the system displays the IDs <file_id> for the files belonging to the diagnosis backup. Using the <file_id>, you can display the contents of a file (Opening a Database File).

Prerequisites

You have the DBM operator authorization DBFileRead.

Syntax

diag_histlist [<YYYYMMDDHHMMSS>]

Command without option specified

dbmcli -d DB -u dbm,dbmp diag_histlist

OK
20010706140709 d:\sapdb\usr\wrk\DB\DIAGHISTORY\A74_20010706_14-07-09
20010706162223 d:\sapdb\usr\wrk\DB\DIAGHISTORY\A74_20010706_16-22-23

Command with option specified

dbmcli -d DB -u dbm,dbmp diag_histlist 20010706162223

OK
DIAGHIST#20010706_16-22-23\knldiag
DIAGHIST#20010706_16-22-23\knldump
DIAGHIST#20010706_16-22-23\knltrace
DIAGHIST#20010706_16-22-23\rtedump

Reply

The result of the request depends on whether you specify the option <YYYYMMDDHHMMSS> (time stamp).

After Command Entry Without Option

If you do not specify a time stamp, the system displays a list of all available diagnosis backups.

OK<NL>
<YYYYMMDDHHMMSS> <directory><NL>

<YYYYMMDDHHMMSS> <directory><NL>

...

After Command Entry With Option

If you specify a time stamp, the system displays a list of the files that belong to the diagnosis backup.

OK<NL>
<file_id><NL>

<file_id><NL>

...

In the event of errors, see Reply Format.