Description

Starts capturing data coming from the host to a disk file. Data being transmitted to the host can also be captured. The captured data includes all escape sequences and control codes, but does not include flow control, such as Xon/Xoff characters. The data is captured in binary format and is not translated in any way.

Arguments

Filename Argument Type: String
Required
Specifies the file to which data is written.

IfFileExists Argument Type: Enumeration
Optional
Specifies what to do if the file already exists. The default is rcCancel. The possible values are:

rcCancel

Generates an error if the file exists.

rcOverwrite

Overwrites the existing file.

rcAppend

Appends trace data to the existing file.

TraceFormat Argument Type: Enumeration
Optional
Specifies what kind of trace to perform. The default is rcTraceDefault. The possible values are:

rcTraceDefault

Captures both incoming and outgoing data. The traced data does not include timing information.

rcTraceEvents

Captures all communications activity, keystrokes, commands, and menu selections. The information is recorded in a proprietary binary format, and must be processed (using the ProcessEventTrace built-in function) to create a readable ASCII file.

rcTraceTimed

Captures both incoming and outgoing data, and includes information about when data moved between the PC and the host, in HH:MM:SS.hh notation.

rcTraceIncomingOnly

Captures incoming data only. This option does not format the data in any way, and does not include timing information.

$image\jump.gif$ Keyword Index

$image\popup.gif$ Related Topics

$image\popup.gif$ Reflection products that use this command