## 5.5 Data Prompter Browser

The Browser is a file-viewing tool to help you determine details of the layout and organization of a data file. Specifically, the Browser can measure offsets from a particular point (the top of a file, the beginning of a line, or a marker) and display the results in bytes and lines. These results can be copied and pasted (with standard Motif Copy/Paste operations) into the appropriate sections of the Data Prompter.

### Starting the Browser

To browse a particular file:

1. Enter the path name of the file in the `Data file` field of either the simplified or the full Data Prompter.

   You can enter a name directly in the field or click on the ellipsis button (`...`) to the right and select a name from the `File Selection Dialog...` box.

2. Click on the ellipsis button again and select `Browser...`. The File Browser window appears, displaying the selected file (Figure 18).

Figure 18. File Browser Window. This window has just been opened and the cursor has not been moved from its initial position at the beginning of the file. No numbers will appear in the offset fields until the cursor is moved. The file displayed in the window is `/usr/local/dx/samples/data/record_multiscalar` (see Example 1 of "Record Style: Multivariable Data").

The File Browser window consists of three areas:

- The menu bar provides access to most of the Browser commands.
- The text window displays the contents of the selected data file.
- The offset area displays (in number of lines and bytes) the "distance" (or offset) between the cursor and a specified starting point.

### Browser Menu Bar

#### Browser File Menu

The single command in this menu is `Close`, which removes the Browser from the screen.

#### Browser Mark Menu

The commands in this menu control the placement of a "mark" in the selected file. The numbers displayed in the offset area are useful in specifying offset values for `header` (see Header), `layout` (see Layout), and `block` (see Block) in the Data Prompter.

Place mark | Replaces the character to the right of the cursor with a solid diamond-shaped mark. It will remain in place until moved to another position (with a new Place Mark command) or removed altogether. Note that the Browser allows only one mark at any time.
Clear mark | Removes a mark from the file.
Goto mark | Causes the Browser to display the text associated with a mark (if it is not already displayed in the file window).

#### Browser Page Menu

The two commands in this menu position the Browser at the beginning of the selected file (`First page`) or at the end of the file (`Last page`).

#### Browser Search Menu

The single command in this menu is `Search...`, which displays a search dialog box. Any string or regular expression can be entered in the `Search for` field. The search begins at the current position of the cursor and proceeds forward (the `Find Next` button) or back (the `Find Previous` button). Searches "wrap around" in either direction. The `Close` button closes the dialog box.

### Browser Text Window

The File Browser window displays the contents of the file being browsed. The cursor can be positioned anywhere in the text (with the left mouse button). When the cursor is repositioned, the values in the offset area below the file window are updated.

Browsing Large Data Files
If the file in the text window exceeds a certain size, the Browser displays it in "chunks," the scroll bar controlling only the current chunk. When the slider is moved to the bottom of the scroll bar, the Browser reads in the next chunk; to top of the scroll bar, the preceding chunk.

### Browser Offset Area

Five text fields at the bottom of the Browser display the "offsets" (in bytes and lines) from the top of the file or from a "mark" to the current position of the cursor. When the cursor is repositioned, the offset values are updated.

The text fields can be used to reposition the cursor anywhere in the file: enter a new value in a text field and press the Enter key. The cursor moves to the position specified by the new offset.

Copying Offset Values to the Data Prompter

1. Highlight an offset value by triple clicking on the value field or dragging the cursor over the value.
2. Position the cursor in the target field in the Data Prompter and click once with the middle mouse button. The offset value appears in the target field.

[ OpenDX Home at IBM | OpenDX.org ]