You display the available diagnosis history.
If a database instance was not properly stopped, the system backs up certain database files when the database instance is restarted. These files are required to diagnose problems that occurred previously. The files are backed up by the system in a diagnosis backup and stored in the DIAGHISTORY directory in the run directory of the database instance (default value of the Database Manager). You can specify this path using the DIAG_HISTORY_PATH parameter.
If you run the command without specifying the <YYYYMMDDHHMMSS> option, 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 run the command with the <YYYYMMDDHHMMSS> (time stamp) option, the system displays the file IDs of the files belonging to the diagnosis backup. You can use the file ID to display the contents of a database file (see: Opening a Database File).
You have the DBM operator authorization DBFileRead.
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
The result of the request depends on whether you specify the option <YYYYMMDDHHMMSS> (time stamp).
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>
...
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.