Go backward to dist[visualize]: Create Visualization Window Go up to 3.5 Visualization Go forward to dist[label]: Create a Label

dist[trace]: Create a Trace File

dist[trace](filename)

This call must be issued before dist[initialize] is executed. It triggers the generation of a file filename into which relevant events are logged.

> dist[trace](tracefile);
                                   tracefile
> dist[initialize]([[deneb,ultrasparc], [flytrap, r5000]]):

After dist[terminate] has been executed, this file may be used to create diagrams by calling on the command line

java visual.Main filename start end width height 

This creates a number of files in the Fig 3.2 format each of which contains a diagram of dimension width×height millimeters:

• filename-machines.fig displays by a horizontal bar those times when a machine was active executing a task; a short vertical bar denotes some load-changing event occurring at that particular time (e.g., waiting for a new task to be executed);
• filename-util.fig displays the number of machines active at a time;
• filename-tasks.fig displays by a horizontal bar from which begin time to which end time and by which machine a task was executed; it is not shown at which times the execution of a task was interrupted by waiting for the result of another task.

The labels start and end restrict the range of the visualization; there are two predefined labels initialize and terminate bounding the execution. Other labels may be generated by dist[label].

% java visual.Main tracefile initialize terminate 100 100
processing tracefile...
creating tracefile-machines.fig...
creating tracefile-util.fig...
creating tracefile-tasks.fig...
done.