Entering content frame

Procedure documentation Displaying the Diagnosis History Locate the document in its SAP Library structure

Use

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).

Prerequisites

You have the DBM operator authorization DBFileRead.

Syntax

diag_histlist [<YYYYMMDDHHMMSS>]

Example

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

Example

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 Entering a Command Without an 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 Entering a Command with an 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.

 

Leaving content frame