This section describes launching WindView; both the integrated and optional products with the default settings use the same process. For information on installing the optional product, see 2.4 WindView Optional Product.

There are slight differences between the launch process and the work environment for Windows and UNIX. In a Windows application, all subwindows, dialog boxes, and other elements reside in a master window. Thus WindView for Windows resides in the main Tornado window. In a UNIX application, each task or function exists in a separate window. When you launch WindView for UNIX, a main WindView control window opens, within which all WindView subwindows and dialog boxes appear. Throughout this manual the main Tornado window on Windows hosts and the main WindView window on UNIX hosts is called the main window and the menus at the top of this window will be called the main Tools menu, the main Help menu, and so on (see Figure 2-1).   

From this step on, the Windows and UNIX versions of WindView look the same except for stylistic differences in the windows. In either environment, WindView displays a Collection Configuration dialog box similar to Figure 2-3.

The default specifies that the Base Events are collected at the Context Switch event-logging level, in other words, only events that cause context switches are logged. This is the lowest level of collection and is usually referred to as CSE level logging; for more information on what data is logged for the different levels, see 3.2 Selecting a Logging Level. A list of libraries called Additional Instrumentation appears, but it is grayed out in the default configuration. For a discussion of collecting data from additional instrumented libraries, see 3.3 Instrumented Objects.

The Reset button resets all the WindView settings to the defaults. The first time you run WindView, click Reset to assure that you are using the default settings.

Pressing the Properties button brings up the Control Properties dialog box. This dialog box allows you to configure the collection buffers and the upload path. After you familiarize yourself with the defaults described below, accept them by clicking OK. Also accept the defaults in the Collection Configuration dialog box with OK.   

Follow the instructions in Tornado Getting Started to start a simulator and target server. If you have changed the target server defaults, see Configuring the Target Server for TSFS. (TSFS is required for the integrated simulator.) Once you have a target and a target server and have launched WindView, you can start WindView data collection. Click the button on the Control window.   

While WindView is running, click the button; the Current Content and Peak Content fields in the lower half of the Control window are updated. To obtain a regular update of the log status while event collection continues, press the button; it causes the information fields to be updated every 20 seconds.

While a regular update is useful, each query to the target from WindView generates additional events. Thus a regular update increases the amount of intrusion caused by WindView on the log data you collect.

To stop WindView, click the button on the Control window. (Don't worry about not having enough data. Even an idling target generates significant events.)

The default configuration uploads the data directly into a view graph. Click the button on the Control window. A new view graph opens containing your log data. The log file looks similar to Figure 2-5.    

To save the log file, use the Save menu item on the main File menu. The Save As dialog box appears, allowing you to save your log file in any location. Select a path and enter a file name. The file is automatically saved with a .wvr extension to indicate a WindView log.