Copyright: Copyright ® 1996 by SST Incorporated.


Contents

Getting Started

Web Detective and 32 bit Windows

Running Web Detective the First Time

Setting Trace Preferences

Setting Data View Preferences

Window Descriptions

The Protocol View

The Page View

The Object View

The Data View

Running Traces

Starting a Trace

Pausing a Trace

Continuing a Trace

Appending a Comment

Viewing Protocol Details

Validating Web Links

Viewing Web Peformance

Clearing the Current View

Clearing all Views

Exporting Trace Information

Importing Trace Information

General Procedures

Note that these procedures are listed in alphabetical order.

Exiting Web Detective

Finding a Trace Record

Printing the contents of a View

Setting up Your Printer

Saving the Configuration

Viewing Winsock Information

References

Keyboard Shortcuts

Toolbar

Index


Web Detective and 32 bit Windows

Web Detective uses the standard Microsoft defined debugging interface for Win32 applications. The Microsoft interface does not permit detaching from a process after debugging has started. Therefore, if Web Detective is terminated, it will also terminate all processes being traced. Stopping the trace will not detach Web Detective from a process.

Be sure that if you are tracing a server application,  leave the Web Detective application running after stopping the trace, or terminate the server application, and restart it (be sure that Web Detective is not running or the trace is stopped before starting the server application again).

•	Web Detective can trace a Win32 console application. To do this, launch the console application from Web Detective. See the topic Launch Application for more details on this procedure.

•	Web Detective does not trace Win32 applications started before Web Detective..

•	Web Detective does not trace 16 bit Windows applications.


Running Web Detective the First Time

The first time you run TracePlus Web Detective, follow the procedures below:

1 	In the Help menu, select View README.WRI.... This command provides information that has become available since the manual was printed,
and other vital information.

2 	Select Options... (Trace menu) to set your trace preferences. Alternatively, press Ctrl + O, or select the Trace icon in the tool bar.

3 	Select Filters... (Trace menu) to set trace functions and tasks. Alternatively, press Ctrl + F, or select the Filters icon in the tool bar.

To access help from the TracePlus window, press F1.


Setting Trace Preferences

To set your trace preferences, select Trace Options... in the Trace menu, or press Ctrl + O.

Shortcut:  Select the Options icon.

The Trace Options dialog box is displayed.  Select any field or button for more information on using this dialog box.

Select the Ok button, or press Enter to set your preferences and exit the dialog box.


Setting Data View Preferences

To set your data view preferences, select Data View Options... in the Trace menu, or press Ctrl + D.

Select the Ok button, or press Enter to set your preferences and exit the dialog box.


The Protocol View

The Protocol VIew displays trace records created each time a Winsock API function is called by a Windows application.

Organization of the Protocol View

The trace records appear as one or more lines in the scrolling listbox, and are numbered sequentially, starting at 1. If a Winsock API function fails, TracePlus will automatically call WSAGetLastError() and retrieve the underlying Winsock error code, unless specified otherwise (see the Filters dialog box).

The data for each packet is colored according to its status:

The function completed successfully.

The function failed.

A notification was received from WSAAsyncxxx().

The trace records can be selectively displayed in one of three ways:

•	Tree - Trace records appear as a single-line node of a tree. If you double-click or press Enter when the trace record is selected, the trace record will expand to show more information about the trace record.

•	Double Line - The trace record appears as two lines. The first line displays the API function and its return code, and the second line displays the timestamp, elapsed time, and the application that called the function. If you double-click or press Enter when the trace record is selected, the Event Details dialog box is displayed..

•	Single line - The trace record appears as a single line, displaying the API function and its return code. Like the double line trace record, double-clicking or pressing Enter will display the Event Details dialog box.

Timestamps

The timestamp that appears on the second line of the trace record (and in the Event Details dialog box) has a resolution of 1 millisecond, and will match a packet displayed in the Data View, or a trace record in the Socket View (if one is generated).


The Page View

The Page View lists all HTML pages requested by the application. As each object in the page is downloaded, the Page View is updated to reflect the current statistics for that page.

Organization of the Page View

A trace record is issued each time one of the above functions is called successfully. The Page View is configured as a grid with 10 columns:

•	Name - The filename of the object (relative to the URL).

•	Size - The size of the object in bytes

•	Time - The time that the socket changed state.

•	Elapsed - The amount of time in seconds necessary to download the page which includes the download time of all objects requested for that page.

•	Bytes/Sec - The average data transfer speed in number of bytes per second.

•	# Images -

•	# Links -

•	# Applets -

•	Title -

•	Status -

Viewing Page Objects

You can double-click on a specific Web page to display all objects associated with that page.The list of objects for the page is taken from the Object View.

Timestamps

The timestamp in the first column of the grid has a resolution of 1 millisecond, and matches the time of Winsock API function where the packet originated.


The Object View

The Object View displays statistics on objects requested from the Web server.

 A trace record is initialized when the Web client requests an object from the Web server and completes when either the object is retrieved or the server returns an error. The trace record will not visible to you until it has completed.

Organization of the Object View

The Object display is configured as a grid with 8 columns:

•	Time - The time that the object was retrieved.

•	Name - The filename of the object (relative to the URL).

•	Size - The size of the object in bytes

•	Elapsed - The amount of time in seconds necessary to download the object. The accuracy of this value is 1 millisecond.

•	Bytes/Sec - The average data transfer speed in number of bytes per second.

•	Type - The MIME type of the object (taken from the server response packet).

•	Status - Can be one of two values: "RETRIEVED" or "CACHED". For example, Object requests that have status codes between 200 and 299 will always display "RETRIEVED".

•	Host - The source of this object (taken from the server response packet).

Timestamps

The timestamp in the first column of the grid has a resolution of 1 millisecond, and matches the time of Winsock API function where the packet originated.


The Data View

The Data View displays contents of HTTP packets either sent or received by the Internet application being traced.

Organization of the Data View

The packets appear as one or more lines in the scrolling listbox. The formatting of the packets can be configured by changing the settings in the Data View Settings dialog box.

The data for each packet is colored according to its source:

Sent from an application (The packet was passed to either the send() or sendfrom() API function).

Received by an application. (The packet was returned by the recv() or recvfrom() API function).

Timestamps

The timestamp that appears at the far left of the packet data display has a resolution of 1 millisecond, and matches the time when the HTTP packet originated. You can locate the specific API function by finding the protocol trace record in the Protocol View whose timestamp matches this value.


Starting a Trace

To start a trace, select Start in the Trace menu, or press Ctrl + S.

Shortcut: Select the Start icon.

Before you start the trace, set you trace preferences and filters.

Note that you can drag single files from the Windows File Manager and drop them on the TracePlus window or the TracePlus icon. The specified .EXE file will be launched when the trace is started.


Pausing a Trace

To pause a trace, select Pause in the Trace Menu, or press Ctrl + A.

Alternatively, If you selected the Stop trace when activated option in the Trace Options dialog box, tracing will stop when you activate the TracePlus program.

Shortcut: Select the Stop icon.


Continuing a Trace

Select Continue in the Trace menu after you have stopped/paused the trace to save the current trace and continue tracing events.

Shortcut:  Select the Continue icon.


Appending a Comment

Select Append Comment... (Trace menu) to add a comment to the end of a trace while the trace is running.

Shortcut:  Select the Comment icon, or press Ctrl + Shift + A.

A dialog box similar to the following is displayed.

In the text box, type your comment and select the OK button.  To exit the dialog box without appending the comment, select the Cancel button.


Viewing Trace Event Details
Viewing Protocol Details

Select Details (Trace menu) to view details of trace events. Alternatively, double click on a trace record in the TracePlus window, or press Ctrl + E .

Shortcut: Select the Details icon in the tool bar.

A Details dialog box similar to the one below is displayed. Click on the fields and buttons below for more information on how to use this dialog box.

The Details dialog box can remain on the screen as long as the trace buffer is not cleared either by selecting the Reset Events item in the Trace menu or selecting the Clear icon.


Validating Web Links

To set your trace preferences, select Validate Links... in the View menu, or press Ctrl + L.

Shortcut:  Select the Validate Links icon.

The Validate Links dialog box is displayed.  Select any field or button for more information on using this dialog box.


Viewing Web Performance

To set your trace preferences, select Web Performance... in the View menu, or press Ctrl + W.

Shortcut:  Select the Web Performance icon.

The Web Performance dialog box is displayed.  Select any field or button for more information on using this dialog box.


Clearing the Current View

To clear the current View, select Reset View in the Trace menu. The other view(s) will retain their current contents.

If the API View is cleared and Event Details dialog box is currently visible, it will be closed.


Clearing all Views

To clear the trace log and buffers, select Reset Events in the Trace menu.

Shortcut:  Select the Clear icon.

If the Event Details dialog box is currently visible, it will be closed.


Saving Trace Information

You can save the current contents of the API View in ASCII format to a file by selecting Save Trace As... from the File menu.

Trace records are formatted according to the Level of Detail setting in the Options  dialog box.

•	The High setting formats the trace record as it appears in the Event Details dialog box.

•	The Low setting formats the trace record as a two line summary. This format is the same as viewing trace records in the API View with the Exploding and Single Line options turned off.

The trace log is prepended by a comments section which describes the conditions of the trace, i.e.:

•	The version of TracePlus that generated the trace log.

•	System information from the PC that generated the trace log.

•	Trace options in effect at the time the trace was started.

Saving Trace Information as an .RDF File

You can save the contents of all views as .RDF file. This file format saves all the TracePlus specific information needed to recreate the trace in another copy of TracePlus running on another PC.

Saving your trace in this format means you can use the TracePlus user interface to view trace logs at a later time.

The RDF file format actually consists of three interrelated files:

1 	filename.RDF - Contains the API trace records (API View)

2 	filename.RDV - Contains the data packets (Data View)

3 	filename.RSV- Contains the socket status information (Socket View)

When moving the RDF file to another computer, make sure that you move the associated .RDV and .RSV files as well.

Saving Trace Information as HTML

You can save the current contents of the API View as a Web page by selecting Save Trace As HTML... from the File menu.

The trace record formatting options are the same as those specified for ASCII files.

The resulting .HTM file can be uploaded to your Web server or displayed in a Web browser such as the Netscape Navigator or the Internet Explorer.


Importing Trace Log Files

Select Import Trace... (Trace menu) to import trace logs from another copy of TracePlus, such as one from a customer site that has been exported as a .RDF file.  This feature allows you to load traces made on other PCs into TracePlus. Once the log is loaded, you can view and manipulate it as if the trace was created on your own PC..

When you load an exported .RDF file onto your system and select Import Trace..., a dialog box similar to the following is displayed. This dialog box displays API functions and records from the remote PC. Select buttons, options, and fields for more information on using this dialog box.


Exiting TracePlus

Select Exit in the File menu or press Alt + F4.


Default


Printing the contents of a View

Select Print in the File menu,  or press Ctrl + P, or to print the contents of the current View.

Note: This feature is not available for the Socket View.

Shortcut:  Select the Print icon.

The default print range is all.  You cannot choose the Selection or Pages options.  You can select the print quality, the number of copies you want to print, and if you want the copies collated.

Press the Setup button to access the printer options available to you from the printer manufacturer.


Setting up Your Printer

Select Printer Setup in the File Menu to access the Print Setup dialog box and set up your printer.

Select the Options... button in the dialog box to access the printer options available to you from the printer manufacturer.


Saving the Configuration

Select Save Configuration (Configure menu) to save the window position, Trace Options dialog box settings, and the Filters dialog box settings (except for tasks, or applications).


Viewing Winsock Information

The Winsock Information dialog displays the following information about the Winsock implementation:

•	Highest compatible Winsock version.

•	Copyright notice returned from WSAStartup().

•	Maximum open sockets per process.

•	Maximum size of a UDP packet.


Keyboard

Following are the TracePlus keyboard shortcuts.

Access TracePlus help	F1
Append a comment to a trace	Ctrl + Shift + A
Clear trace log and buffer	Ctrl + R
Continue the trace	Ctrl + C
Display Protocol and Page details	Ctrl + E
Exit TracePlus	Alt + F4
Find a record	F3
Pause the trace	Ctrl + A
Print	Ctrl + P
Set trace preferences	Ctrl + O
Start the trace	Ctrl + S


Toolbar

The following command icons are available on the tool bar:

Saves the contents of the current trace log as an ASCII file.

Prints the contents of the screen.

Displays the details of a specified event.

Opens the Trace Options dialog box, so that you can
set trace preferences.

Obtain performance statistics on specified Web pages, or entire Web sites.

Verify that the links for a specified Web page or entire Web site are valid.

Clears the trace log and buffer.

Starts trace, and clears the current trace

Stops tracing events.

Continue tracing events.  It saves the current trace.


Index

A

Access Types

Appending a Comment

B

Backwards

Browse Records

Buffer Options Data

Buffer Options Field

Buffers

Buffers

C

Call

Cancel

Clear

Clearing all Views

Clearing the Current View

Close

Connect Options

Contents

Continuing a Trace

D

DBWin

Detail List Box

Display buffers in ASCII only

Display buffers in Hex ASCII

Display Formatting

Display Options Field

drag and drop

E

Errors Only

Errors

Exiting TracePlus

Exporting Trace Log Files

Exporting Trace Log Files

F

File

Finding a Record

Functions

G

Get

Getting API Help

H

Home Page

I

Importing Trace Log Files

Index

K

Keyboard

L

Launch Application

Launch specified application

Level of detail

Link Type

Log Exceptions Only

Log File

M

Machine name

Menus

N

Network Settings

O

Object View

Objects in selected HTML document

Ok

P

Packet Options

Page Statistics

Pausing a Trace

PC Configuration

Performance Page Statistics

Printer

Printing the contents of a View

R

Refresh

Retrieve FTP Objects

Running Web Detective the First Time

S

Save As

Saving the Configuration

Saving Trace Information

Select All

Select records to load

Selected Object URL

Setting Data View Preferences

Setting Trace Preferences

Setting up Your Printer

Sort By

Sort

Specifying the API Help File Location

Speed

Start

Starting a Trace

T

The Data View

The Object View

The Page View

The Protocol View

Toolbar

Trace log only

Trace log

U

User Authentication

V

Validating Web Links

Verify_Graphic_Images

Viewing Trace Event Details

Viewing Web Performance

Viewing Winsock Information

W

Web Detective and 32 bit Windows

Web Page Objects


Access Types

•	Preconfigured- Retrieve the proxy or direct configuration from the registry.

•	Local- resolve hostnames locally.

•	Gateway- use the gateway specified in the Windows Networking settings.

•	CERN- Use a CERN compliant proxy server (see below).

"Server" specifies a CERN proxy. For example, "proxy" defaults to a CERN proxy called "proxy" that listens at port 80 (decimal). An application can specify more than one proxy, including different proxies for the different protocols. For example, if you specify "ftp=ftp://ftp-gw gopher=http://jericho:99 proxy", FTP requests are made through the FTP proxy "ftp-gw", which listens at port 21 (default for FTP), and Gopher requests are made through a CERN proxy called "jericho", which listens at port 99. All other requests (for example, HTTP requests) are made through the CERN proxy called "proxy", which listens at port 80. Note that if the application is only using FTP, for example, it would not need to specify "ftp=ftp://ftp-gw:21". It could specify just "ftp-gw".


Backwards

Select this option if you want to see the log in reverse order while animation is enabled.


Browse Records

Select the Browse scroll buttons to view records ahead or behind the current record.


Buffer Options Data
Buffer Options (Data View)

The buffer size of the Data View uses the concept of displayable lines of text, rather than actual trace records (used in the API View).

The Data View will display up to the number of text lines specified. If the newest packet causes the number of lines to exceed the specified maximum, the oldest packets will be deleted from the display IFIFO).


Buffer Options Field

The number in parentheses below the Buffer Size option is the amount of memory in kilobytes.

Buffer Size:  Enter the number of records, between 25-2000 inclusive, that you want to buffer.

Circular:  When the number of records is one more than the number you specified in the Buffer Size option, the buffer drops the oldest record, giving the appearance of an endless buffer.  The larger the buffer size, the more records it can hold before losing the oldest record.

Stop when filled:  The buffer stops accepting record when the number of records you specified in the Buffer Size option is reached.  The trace is automatically stopped.


Buffers

Select this button to specify the way that data packets are formatted in the Event Details dialog box. The following Winsock API functions display data packets:

•	recv()

•	recvfrom()

•	send()

•	sendto()

Select any field or button below for more information on using this dialog box.

TracePlus will consume much more memory if you are tracing applications that send and receive data in large packet sizes (2048, 4096, etc.). To minimize memory usage, set a limit for buffer sizes, or turn off the buffer display altogether. Alternatively, you can set the trace buffer size to a smaller value, typically one half of the current buffer size.


Call

Select this button to display a description of the function shown in the details list box as outlined in the API help file. This button is grayed if the API help file is not accessible by TracePlus.


Cancel

Select this button to exit the dialog box without making any changes.


Clear

Select this button to cancel your choice(s) in the list box.


Close

Select this button to close the dialog box.


Connect Options

Select any field or button for more information on using this dialog box.

Select the Ok button, or press Enter to set your preferences and exit the dialog box.


DBWin

Outputs trace information to DBWin (a sample debugger available with Microsoft Windows SDK and Microsoft C/C++ (Visual C++TM)).  This option also supports output to WinScopeTM by Periscope.  TracePlus is compatible with any program capable of displaying messages sent by the function OutputDebugString( ).

Be aware that this option can slow your system down if many trace events are being logged.


Detail List Box

This window displays detail of a specified trace.  You can specify the trace for which you want more detail by double clicking on a trace record in the TracePlus window, or by entering a number in the Record text box and pressing the Get button.  Alternatively, you can scroll through the list box, or select the Animate button to view other records, or select the Find button to find a record alphanumberically.

The following information is displayed for every trace record:

•	PACKET SUMMARY:  A summary of the function, including record number, function, and the time it was called.

•	PACKET DETAILS: Contents of the packet as sent to/received from the host. Packet options separated by carriage return/line feed combinations will be displayed on separate lines.


Display buffers in ASCII only

This option displays buffer in text format.


Display buffers in Hex ASCII

This option displays buffer information in DEBUG style format.


Display Formatting

Data packets can be formatted in one of three ways:

1 	Automatic - When a packet is ready to be displayed, TracePlus will check the packet to determine the type of data in the packet, If all the data in the packet is ASCII (printable), the packet will be displayed as text. Otherwise, the packet will appear in hex.

2 	Hex/ASCII - This is the standard hexidecimal packet display provided by TracePlus. Packet data is displayed in rows of 16 hexidecimal digits, with the ASCII representation of each hex digit to the right of each row.

3 	ASCII packets only - If TracePlus determines that any of the data contained in a packet is not ASCII (printable), the packet will not be displayed.


Display Options Field

Minimize when trace started:  Minimizes the TracePlus application window to an icon.

Stop trace when activated:  Stops the trace when you activate the TracePlus window.

Always on top:  Keeps the TracePlus window on top of all other applications, so that it is always visible.


Errors

Select the Errors scroll buttons to scroll through errors.


Errors Only

Select this option if you want to view error messages while animation is enabled.


Exporting Trace Log Files
Exporting Trace Information

You can save the contents of all views as .RDF file by selecting Save as RDF... on the File menu.

Saving your trace in this format means you can use the Web Detective user interface to view trace logs at a later time.

To use this function effectively, remember the following:

•	Select this option before you start tracing an application.

•	This option will reset and the log file will be closed when you stop the trace.

•	You can overwrite, but not append, to an existing trace log.

The .RDF File Format

This file format saves all the Web Detective specific information needed to recreate the trace in another copy of the Web Detective running on another PC.

The RDF file format actually consists of three interrelated files:

1 	filename.RDF - Contains the protocol trace records (Protocol View)

2 	filename.RDV - Contains the data packets (Data View)

3 	filename.RPV- Contains the web page information (Page View)

4 	filename.ROV- Contains the web object information (Object View)

When moving the RDF file to another computer, make sure that you move the associated .RDV, .RPV, and .ROV files as well.


Exporting Trace Log Files

You can save the contents of all views as .RDF file by selecting Export Trace... in (Trace menu).

Saving your trace in this format means you can use the TracePlus user interface to view trace logs at a later time.

To use this function effectively, remember the following:

•	Select this option before you start tracing an application.

•	This option will reset and the log file will be closed when you stop the trace.

•	You can overwrite, but not append, to an existing trace log.

The .RDF File Format

This file format saves all the TracePlus specific information needed to recreate the trace in another copy of TracePlus running on another PC.

The RDF file format actually consists of three interrelated files:

1 	filename.RDF - Contains the API trace records (API View)

2 	filename.RDV - Contains the data packets (Data View)

3 	filename.RSV- Contains the socket status information (Socket View)

When moving the RDF file to another computer, make sure that you move the associated .RDV and .RSV files as well.


File

Outputs trace information to a log file. However, you can enter another file in the Log File text box, or choose another log file by selecting the Browse button.

The default is Append to existing file, which appends new trace information to the log file you specify.  If you deselect the default, the log file is deleted and a new file is created when you run a trace on another function.

Note that if you do not specify the log file, you can save the contents of a trace buffer in ASCII format to a file by selecting Save Trace As... (File menu).


Finding a Record
Finding a Trace Record

To find a record in the Details dialog box, select the Find button.  To search for strings in the trace log from the main screen, Select Find... (Trace menu) or press F3.

The Find dialog box is displayed.

You can search by any numeric or alphabetic characters.  If you search alphabetically, you can do a case-sensitive search (if the word for which you are searching contains capital letters) by selecting the Match Case option.  You can also search up or down through records.


Functions

Select this button to view the ODBC functions supported by the ODBC driver for the selected data source.

Supported functions are in black.  Unsupported functions are in red.

Select Ok or press Enter to exit the dialog box and return to the Data Source Information dialog box.


Get

Select this button to retrieve details for a trace you specify in the Record text box. The record is the first field that is displayed in the TracePlus window.  You can also use the scroll buttons to scroll backwards and forwards through record numbers.


Getting API Help

Before you access API you must first specify the location of the API help file by selecting API Help File... (File menu) and specifying the file in the API Help File dialog box.

Select [API_Name] API... (Help menu) to access help on the API.

Shortcut:  Select the API Help icon, or press Ctrl + F1.

Select Specific API_Name Function (Help menu) to access help on a specific API function.

Shortcut:  Select the API Function Help icon, or press Shift + F1.

Note that the public domain WINSOCK.HLP is included with TracePlus/Winsock and has hypertext links to the API functions that appear in the trace log. By pressing Shift + F1 in the main window, or pressing the Call button in the Details dialog box, you can get detailed help on that Winsock function.Select Specific API_Name Function (Help menu) to access help on a specific API.


Home Page

Specify a URL to be used as the top level Web page for the operation. All recursions to linked Web pages are relative to this page. This Web page will appear at the top of the tree. The URL must reference a valid HTML page.


Launch Application

This option enables you to launch applications from TracePlus and start tracing at the same time. The dialog box only appears if you have selected Launch Application from the Filters dialog box.

Each time you launch an application from TracePlus, the application filename is remembered by TracePlus. This list of previously launched applications appears underneath the Application text box.The list is sorted according to their priority, i.e. the most recent applications will appear at the top of the list.

Specifying an Application to Launch

Select the Browse button, or enter the application filename in the Application text box.  You can enter arguments to the application in the Command Line text box.

Selecting a recently used Application

If the application you want to launch is in the list, double-click on it with the mouse. The application filename will be copied to the Application text box. Press Ok to launch the application.


Launch specified application

Select this option if you want to run a trace on an application that is not displayed in the Tasks list box.  To select the application, select the Choose application... button, or enter the application in the Application text box.  You can enter arguments to the application in the Command Line text box.


Level of detail

Select High to output information details to printer, DBWin, or the file you specified in the option above.  Select Low to display only two lines of information to the Event Details dialog box.

Remember that this option does not change the format of the TracePlus main window.  This options affects either the File or Printer output options.


Link Type

Indicates the type of links that you want to validate.

•	All - Validate links both relative to the specified home page and on other web sites.

•	Local - Validate links relative to the specified home page only.

•	Remote - Validate links to pages on web sites that are not relative to the specified home page.


Log Exceptions Only

Select this option if you want to log functions that return errors only.


Log File

If you selected File in the Output Options field, and you do not want to accept the default log file, enter the name of the file to which you want trace information stored, or choose another log file by selecting the Browse button.

Note that if you do not specify the log file, you can save the contents a trace buffer in ASCII format to a file by selecting Save Trace As... (File menu).


Machine name

The name of the workstation is automatically displayed in this field under Windows 95, Windows NT and Windows for Workgroups.  This differentiates users when multiple workstations are traced by writing to the same log file on a network drive.


Menus

Insert Menus help text here


Network Settings

These settings are used when the Web Detective establishes a connection with the Web server. There are two available settings:

1 	Connect Retries- The number of times that the Web Detective will try to connect to the Web server before aborting.

2 	Connect Timeout- The amount of time in seconds that the Web Detective will wait for the Web server to respond.


Object View

Displays the Web objects accessed by TracePlus during an operation. The type of objects displayed in the tree view varies according to the type of operation being performed:

•	Web Performance: Each Web page accessed by TracePlus will be displayed in the tree view. A red ball next to a Web page title indicates that the page could not be accessed, in which case an error condition will be displayed after the page title.

•	Validate Links: All Web objects (pages, images, classes) accessed by TracePlus are displayed in the tree view. A red ball next to an object name indicates that the object could not be accessed, in which case an error condition will be displayed after the object name.


Objects in selected HTML document

Displays the objects downloaded by TracePlus which are referenced in the specified Web page. To display a list of objects for a page, select the page from the tree view. The following information is available for each object:

•	Time: The time that the object was downloaded by TracePlus.

•	Title: The title of the Web page as specified in HTML, or the object filename (minus the hostname).

•	Size: The size of the object in bytes.

•	Elapsed: The time used by TracePlus to download the object expressed as seconds.milliseconds.

•	Bytes/Sec: The approximate speed measured when downloading the object expressed in bytes per second.

•	Type: The MIME type of the object as specified in the HTTP response packet.

•	Status: The HTTP return code as specified in the HTTP response packet.

•	URL: The full pah used by TracePlus to access the object.


Ok

Select the Ok button or press Enter to set your changes and exit the dialog box.


Packet Options

You can limit the amount of packet data displayed in the Data View by specifying the maximum amount of bytes that will be displayed in a packet.

Additionally, you can choose to exclude packets entirely, if the packet size exceeds a certain threshold.

There are two settings that determine the maximum display size of a packet:

1 	Display entire packet - Show each byte of a packet, regardless of packet size.

2 	Display up to - If the packet size exceeds the specified amount, show only the specified number of bytes.

The option Display only packet size causes any packet exceeding the specified size to be represented in the Data View as a one line description of the packet size, i.e. "Packet size is xxxx bytes". This is particularly useful in filtering large binary file transfer packets common to  HTTP and FTP protocols.


Page Statistics

Displays the statistics accumulated while validating a specific Web page. Choose the Web page you are interested in from the tree view. The following statistics are available:

•	Started at: The time that the Web page was downloaded by the Web Detective.

•	Finished: The time when Web Detective finished checking all specified links.

•	Total Links: Total number of links found in the Web page.

•	Total Images: Total number of images found in the Web page.

•	Valid Links, Invalid Links: Accumulated totals for each condition encountered when verifying a link.

•	Valid Images, Invalid Images: Accumulated totals for each condition encountered when verifying a image reference.


PC Configuration

To view the remote PC configuration from which a log file was exported/imported, select the PC Config button in the Import Trace Records dialog box. Alternatively, after you close the Import Trace Records dialog box, select PC Configuration... (View menu).

The PC Configuration dialog box is displayed.


Performance Page Statistics
Page Statistics

Displays the statistics accumulated while downloading a specific Web page. Choose the Web page you are interested in from the tree view. The following statistics are available:

•	Started at: The time that the Web page was downloaded by the Web Detective.

•	Finished: The time when Web Detective finished checking all specified links.

•	Elapsed: The accumulated download time of all objects in the specified page, including the page itself.

•	Total Objects: Total number of objects retrieved for the Web page.

•	Bytes: Total number of bytes downloaded for all objects (not including the Web page).

•	Bits/Sec: Elapsed download time for all objects on the page, expressed as bits per second.


Printer

Outputs trace information to your printer.


Refresh

Refresh the list box.


Retrieve FTP Objects


Save As

Select this  button to save the performance statistics as a text file.


Select All

To select individual list box items, press Ctrl as you click with the left mouse button.  To select a range of list box items, click on the first item with the left mouse button, and then press Shift as you click on the last item with the left mouse button.  To select all items in the list box, select the Select All button.


Select records to load

Select All to load all records, or specify the record number at which you want to start.  Note that the total number of records is specified for your convenience.


Selected Object URL

Displays the URL of the Web page or image which is selected in the tree view. In the Web Performance dialog box, several statistics will be displayed beneath the URL:

•	Total Bytes: The total number of bytes for all objects referenced by the specified Web page.

•	Elapsed: The time used by TracePlus to download all objects referenced by the page in seconds.milliseconds.

•	Bytes/Sec: The download speed of all objects referenced by the page, expressed in bytes per second.


Sort

Select the option by which you want to sort information

•	If you choose address, addresses are listed in ascending order.

•	Module refers to the module that allocates the memory.

•	Size refers to the amount of memory the block occupies.


Sort By

Select the sort option by which you want to display performance statistics.


Specifying the API Help File Location

Select API Help File... (File menu) to specify the location of the API help file, if this file exists on your system.  Specify the file as in a standard Open dialog box.

Once you specify the location of the API help file, you can access API help while the debugger is running.  For more information on accessing API help, see Getting API Help.


Speed

Enter the number from 1 to 15. The higher the number, the slower the animation (that is, automated scrolling through the detail list box).  The range of values equates to .2 through 3 seconds. You can initiate animation by selecting the Start key.


Start

Select this button if you want to automate scrolling through the detail list box.  To set the animation delay, enter the number of seconds delay in the seconds text box.


Trace log only

Displays trace information to a window.


User Authentication

Enter your username and password for authentication with a proxy server. This is not used for access to secure Web pages.


Verify_Graphic_Images


Web Page Objects