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.