2.2.65. JOURNAL

The JOURNAL command controls the logging of information displayed in the Cmd tab of the Output pane.

Syntax

JOURNAL [/A] [OFF | ON="filename"]

where:

/A

Appends information to an existing file.

OFF

Closes the journal file and stops collecting information. This is the default setting.

ON

Starts writing information to the journal file.

filename

Specifies the journal filename. If you do not specify a filename extension, the extension .jou is used.

Quotation marks are optional if the filename contains only alphanumeric characters or periods. Filenames that contain a leading forward slash must be in double quotation marks ("/filename", for example). Filenames that contain a leading backward slash must be in single quotation marks ('\filename', for example).

Description

The JOURNAL command starts or stops saving, in a specified file, information displayed in the Cmd tab of the Output pane. The information you can direct to a file includes user command input, resulting output, error messages, and text specifically sent to the journal file.

Note

If the specified file exists and you do not specify the /A parameter, the existing contents of the file are overwritten and lost.

The JOURNAL command runs asynchronously unless it is in a macro.

Example

The following examples show how how to use JOURNAL:

JOURNAL ON=’c:\temp\log.txt’

Start logging output to the file c:\temp\log.txt, overwriting any existing file of that name.

JOURNAL /A ON="log"

Start logging output to the file log.jou in the current directory of the debugger, appending the new log text to the file if it already exists.

JOURNAL OFF

Stop logging output.

See also

The following commands provide similar or related functionality:

Copyright © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0235B
Non-Confidential