next up previous contents
Next: 3.3 Legend Window Up: 3. Graphical User Interface Previous: 3.1 Main Window   Contents

3.2 Logfile Convertor Window

Figure 3.2: Logfile Convertor window allowing conversion of supported trace file format to SLOG-2 format.
Image convertor_init

If a non-slog2 file is selected in the Main window, the Logfile Convertor, as shown in Figure 3.2, will be invoked to prompt user to convert the file to SLOG-2 format readable by this viewer. Currently, four convertors are supported: CLOG -> SLOG-2, CLOG-2 -> SLOG-2, RLOG -> SLOG-2 and UTE -> SLOG-2. The convertor is generally selected based on the input file's file extension. If the wrong file convertor is selected, the user can correct it through the pale-blue pulldown menu located at the top of the window. The Logfile Convertor window can also be invoked by directly clicking on the Logfile Conversion button shown in the Table 3.2. The text field of the Output File Name usually displays the default slog2 filename recommended by the convertor based on the text field in the Input File Specification. If the text field does not display the default name as expected, hitting return key in the Input File Specification field will force an update of the Output File Name field with the default name. The Logfile Convertor has four major functions, each associated with a button in the lower panel of the window. They are listed in Table 3.4.


Table 3.4: Major functions in the Logfile Convertor window.
Icon Description Function
Image Convert24 Start Conversion Start the logfile conversion of the selected convertor
Image Stop24 Stop Conversion Stop the ongoing logfile conversion of the selected convertor
Image Help24 Usage of Convertor Print the usage information of the selected convertor
Image Home24 Return Home Return to the previous component that spawns the Logfile Convertor


Since the Logfile Convertor launches a separate Java process to do the logfile conversion, it requires certain parameters to launch the process correctly. All the parameters needed by any logfile convertor are supplied through a panel hidden by a splitter in the convertor window. The splitter has a divider that can be lifted up to display all the parameters used to launch the Java process, as in Figure 3.4. On the rare occasion that the default parameters are not correct, the text fields can be modified to reflect the situation.

Figure 3.3: Hidden parameters panel of the Logfile Convertor.
Image convertor_parameters

The standard output and error streams of the process are piped to the text area located in the middle of the window as the process is running. The Output File Size field displays the current size of the slog2 file as it is being generated. Also, the progress bar will be incremented to show the current ratio of the output to input file size, as in Figure 3.4. If the logfile conversion fails, the error message will be printed in the text area for diagnosis or a bug report.

Figure 3.4: Logfile conversion in progress.
Image convertor_progress


next up previous contents
Next: 3.3 Legend Window Up: 3. Graphical User Interface Previous: 3.1 Main Window   Contents