Open •••
Change Dir •••
Get Info •••
DOS Shell
Quit Alt-X
The File menu contains commands for
IJ opening and loading a program to be profiled
III changing the current directory
D obtaining information about your program and system memory allocation
Il shelling out to the operating system
Il quitting the pro filer
Open The File I Open command opens the Program Load dialog box, shown here:
Chapter 4, The Turbo Profiler environment 73
74
Figure 4.5 The Program Load dialog box
daytime.exe dice.exe install.exe map.exe modl.exe ovrdemo.exe pl.exe p2.exe p3.exe p4.exe 5.exe
With this dialog box, you can do any of the following:
• load an explicit file into the Module window
• use wildcards to filter the file list to match your specifications
• choose a file from a history list of previously-entered file names
• view the contents of different directories or drives There are three ways to load a file from this dialog box:
1. Type in the file name, then choose OK (or press Enter).
2. Press Enter or Tab to activate the files list box. Select (highlight) the file name you want, then choose OK or press Enter.
. . . 3. Double-click the file name.
You'll get an error message if you attempt to load a non-existent file or a file that isn't an .EXE file or that doesn't have debug information.
Choose Cancel to leave the Program Load dialog box without loading a file.
Using the File Name Input box
When the File Name input box is active (the cursor is blinking in the box), you can do any of the following:
• Load an explicit file: Type in a full executable file name
(including disk drive and relative or absolute path, if you want;
you don't have to type the extension). Then choose OK (or
Turbo Pro filer User's Guide
A history list shOINS the last eight file names you've entered.
press Enter) to load that executable file's main source file into the Module window.
II Filter the file list: Type in a file name (including disk drive and relative or absolute path) with DOS wildcards (? and *). Then move to the Files list box of matching file names to choose the file you want, or to the Directory list box to change to a different directory.
II Choose from a history list: Press J, to make a history list drop down below the Name input box. To choose a file from the history list, double-click the file name, or select it with an arrow key and press Enter.
Using the Flies list box
By default, the Files list box displays all file names in the current directory that match the specifications in the Name input box as well as the names of directories you can move to from the current directory. If the Name input box specification includes a drive or path name, the list box displays all matching file names in the specified drive and directory.
To load a file from the Files list box,
1. Click the list box (or press Tab until the list box name is highlighted) .
2. When the name is highlighted, either press J, or
i
to select a file name (then press Enter), or double-click the file name.You can scroll the list box, if necessary, to see all the file names.
If the file you want is in another directory, tab to the Directories list box and select the directory you want to move into. (To access the parent directory of the one you are currently in, type .. \
* .
exeand press Enter.
If you need to load your program with some command-line arguments, refer to the description of the Run I Arguments input box on page 110.
Change Dir The File I Change Dir command brings up the New Directory dialog box.
Chapter 4, The Turbo Profiler environment 75
Figure 4.6 The New Directory dialog box
You'll get an error message If the new directory can 't be found.
76
Get Info
Figure 4.7 The Get Info text box
From this dialog box, you can log to a different current directory.
(The current directory is where Turbo Pro filer saves and looks for files.)
New Directory dialog box components
The New Directory dialog box contains an input box in which you type the path to the directory you want to access. When you have done so, choose OK to change directories, or Cancel to remain in your present one.
The File I Get Info command displays a text box with information about the program being profiled and your system's current memory configuration.
Program: C:\TPROFILE\PRIHE1.EXE Status : Loaded
Hode: Active Collection: Enabled -HelllOry-DOS : 226Kb Profi 1 er : 282Kb Symbols : 8Kb Program : 196Kb Available: OKb B H S -DOS : 112Kb Profiler : 240Kb Program : OKb Available: 32Kb DOS version: 3.20 6-14-1989 5: 27pm
~
The information in the Get Info box is for display only; you can't change any settings from this box. Here's what the categories in this information box represent:
• Program is the program being profiled; you determine which file to profile with the File I Open command .
• Status is the reason why Turbo Profile gained control: it can be anyone of these loaded messages:
Turbo Profiler User's Guide
No program loaded Control-Break
Terminated, exit code XX Stopped by area
NMI Interrupt Exception XX Divide by zero
• Mode is the profiling mode (active or passive); you specify the profiling mode with the Profile Mode radio button in the Profiling Options dialog box (accessed by choosing Statistics I Profiling Options).
• Collection tells whether automatic data collection is enabled or disabled; you specify the data-collection setting with the Statistics I Accumulation command.
• Memory tells
• DOS: Memory occupied by DOS and/or various device drivers.
• Profiler: Total memory used by the profiler.
• Symbols: Memory allocated for the program's symbol table.
• Program: Memory allocated to the current program being profiled.
• Available: Amount of remaining available memory.
• EMS shows use of expanded memory by DOS, Turbo Profiler, the program's symbol table, the program being profiled, and available memory, like the base memory display. EMS appears only if expanded memory is present.
• DOS version shows the current DOS version on your system.
• Current date and time shows today's date and the time of day.
After reviewing the information in the Get Info box, click OK or press Enterto return to the current window.
DOS Shell The File I DOS Shell command steps you out of Turbo Profiler and back to the DOS prompt, so you can enter a DOS command or program.
To return to Turbo Profiler, type EXIT at the DOS prompt.
-=:>
In remote profiling mode, the DOS command line appears on the Turbo Pro filer screen rather than on the User screen; this allows you to switch to DOS without disturbing your program's output.Because your program's output is always available on one
Chapter 4, The Turbo Profiler environment 77
Quit