Programming with Reflection

image\rwnprg32.gif StartTrace method

 

Syntax object.StartTrace Filename, [IfFileExists], [TraceFormat]

 

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