Starting the Data Pump Viewer

The Data Pump Viewer can be started in several ways:

• by selecting the Data Pump shortcut in the Data Pump program group.
• by selecting "Data Pump" from the Start Menu.
• by typing Blast.exe with the appropriate command line options from a DOS prompt or the Run Menu.

The Data Pump Viewer Window

The Data Pump Viewer Window is divided into three main sections: the Command Area, the View Area, and the Status Bar.

The Command Area

The Command Area has two bars: the Title Bar and the Menu Bar. The left side of the Title Bar displays the name of the phonebook listing that is loaded; the right side contains standard window controls. The Menu Bar has File, Script, and Help menus.

File Menu:

FILE MENU

Open Listing - Displays a standard "Open File" dialog to allow you to select a phonebook listing to load.

Edit Listing - Opens the Phonebook Editor application to allow selection of a listing for editing. For modifications to take effect in Data Pump, you must "load" the listing using the "Open Listing " menu option.

Online - Toggles the communications port from closed to open, and vice versa.

Exit - Exits the Data Pump Viewer.

Script Menu:

SCRIPT MENU

Run - Displays a standard "Open File" dialog to allow you to select a script to run.

Pause - Temporarily halts execution of a script.

Single Step - Allows you to execute a script one line at a time for debugging purposes. When Single Step is enabled, you will have to hit ENTER after each line is executed to continue running the script.

Single Step can be enabled either before or during script execution. To enable Single Step before execution, select the Single Step menu item before selecting the Run menu item. Or, it is possible to put a WERROR statement in your script at the point before Single Step operation is desired. When the script reaches the WERROR command, select Single Step from the Script Menu and continue operation.

Halt - Halts execution of a script. This menu item is grayed out if no script is currently loaded.

Help Menu:

Help Topics - Opens the Data Pump documentation with your installed browser.

About BLAST - Opens a dialog displaying the version of Data Pump you are running.

The View Area

The View Area has the Terminal, Terminal History, Script, and Log Viewers. Each view is selected by clicking on the appropriate tab at the bottom of the View Area.

Terminal Viewer - The Terminal Viewer displays a terminal session. In the Terminal Viewer. you can see what is being transmitted to the remote system via script commands like TSEND and TUPLOAD. Additionally, you can see what is being received from the remote system. It is possible to type on the keyboard to transmit characters to the remote system for the purpose of developing and debugging your application. The Terminal Viewer has no terminal emulation capabilities.

TERMINAL VIEWER

Terminal History Viewer - The Terminal History Viewer displays characters that have been received in the Terminal Viewer but have scrolled off the screen. The Terminal History Viewer has an elevator bar to scroll back through the history.

TERMINAL HISTORY VIEWER

Script Viewer - The Script Viewer displays the currently executing script. Any operation that requests user input or that outputs information to the user from within a script (e.g., ASK, CLEAR, CLEOL, CURSOR, DISPLAY, MENU, PUT, WERROR, and WRITE) will be displayed in the Script Viewer. See also Managing the Script View under BLASTscript Topics.

SCRIPT VIEWER

Log Viewer - The Log Viewer displays the BLAST Log as it is being created.

LOG VIEWER

The Status Bar

Located in the lower right-hand corner of the Data Pump Viewer, the Status Bar has indicators for DCD, ONLINE, WAIT, and SCRIPT.

DCD - Shows the status of the Data Carrier Detect signal. If Data Carrier is detected, the indicator displays DCD. Otherwise, the indicator is blank.

ONLINE - Shows whether the communications port is currently open or closed. If the communications port is open, the indicator displays ONLINE. If the communications port is closed, the indicator is blank.

WAIT - Shows whether Data Pump is loaded and ready to process commands. When Data Pump is loaded and ready to process commands, the indicator is blank. Otherwise the indicator displays WAIT.

SCRIPT - Shows when a script is running. When a script is running, the indicator displays SCRIPT. Otherwise, the indicator is blank.