Turbo Pro filer displays a prompt in a dialog box when you must supply additional information to complete a command. The prompt describes the information that's needed. The contents may show a history list (previous responses) that you have given.
You can respond to a prompt in one of two ways:
II Enter a response and accept it by pressing Enter .
• Press Esc to cancel the dialog and return to the menu command that opened it.
Some prompts only present a choice between two items (like Yes/No). You can use Tab to select the choice you want and then press Enter, or press Yor N directly. Cancel the command by press-ing Esc.
For a more complete discussion of the keystroke commands to use when a dialog box is active, refer to Chapter 4.
Appendix E, Prompts and error messages 165
166
Here's an alphabetical list of all the prompts and messages generated by dialog boxes:
Enter code label to position to
Enter the address you wish to examine in the Code pane. The Code pane shows the disassembled instructions at the specified address.
Enter command line arguments
Enter the command-line arguments for the program you're profiling. You can modify the current command -line arguments or enter a new set.
You will then be prompted whether you want to reload your program from disk. Some languages or programs, such as programs written in C, require you to reload the program before the arguments take effect.
Enter file name to restore areas from
Enter the name of the file to restore areas from. If you specify an extension to the file name, it will be used. Otherwise the
extension .TF A will be used.
Enter file name to restore from
Enter the name of the file to restore the statistics to. If you specify an extension to the file name, it will be used. Otherwise the extension .TFS will be used.
Enter file name to save areas to
Enter the name of the file to save the current areas to. If you specify an extension to the file name, it will be used. Otherwise the extension .TFA will be used.
Enter file name to save to
Enter the name of the file to save the current statistics to. If you specify an extension to the file name, it will be used. Otherwise the extension .TFS will be used.
Enter file name to write to
Enter the name of a file to send the report to. If the file already exists, it will be overwritten.
Enter name of configuration file
Enter the name of a configuration file to read or write. If you are reading from a configuration file, you can enter a wildcard mask and get a list of matching files.
Turbo Pro filer User's Guide
Enter maximum number of areas
Enter the maximum number of areas that you wish to divide the program into. Since each area takes up some memory, try to set the maximum to as Iowa value as is reasonable.
Enter maximum symbol width to display
Enter the width for symbol names on reports and for symbol names displayed in windows.
Enter new directory
Enter the new drive and/or directory name that you want to become the current drive and directory.
Enter new line number
Enter a new line number to position the text file to. The first line in the file is line 1. If you specify a line number that is greater than the last line in the file, the file is positioned to the last line.
Enter new page height
Enter the number of lines on a page to be sent to the printer or a disk file. A normal II-inch sheet of paper has 66 lines.
Enter new page width
Enter the width of the page for reports sent to the printer or a disk file. A normal sheet of paper has 80 columns.
Enter program name to load
Enter the name of the program to load. If the program has the .EXE extension, you don't have to specify it; if the program has any other extension, you must supply it.
If you supply a wildcard specification or accept the default *.EXE, a list of matching files is displayed for you to select from.
Enter program run count
Enter the number of times that you want to run the program and accumulate performance statistics. The more times you run your program, the more accurate the clock timings will be.
Enter routine name to add
Enter the name of the function you wish to include, exclude, or set.
Enter search string
Enter a character string to search for. You can use a simple wild-card matching facility to specify an inexact search string; for example, use * to match zero or more of any characters, and? to match any single character.
Appendix E, Prompts and error messages 167
168
Enter source directory list
Enter the directory or directories to search for source files.
!fyou want to enter more than one directory, separate the different directory paths with a space or a semicolon (;). These directories will be searched, in the order that they appear in this list, for your source files.
Enter tab column spacing
Enter a number between 1 and 32 that specifies how far apart tab columns will be when Turbo Pro filer displays files in a Module window.
Usually, you use tabs for each level of control-structure nesting in your source code. If your source code has deeply nested control structures, you can use a small tab value (like 2 or 3) so that your source doesn't disappear off the right side of Module windows.
Pick a caller
Pick a routine from the list of callers. You will then be positioned to that routine in the window that you picked from the previous menu.
Pick a method name
You have specified a routine name that can refer to more than one method in an object. Pick the correct one from the list presented, with the arguments you want.
Pick a module
Select a module name to view in the Module window. You are presented with a list of all the modules in your program. Either use the cursor keys to move to the desired module, or start typing the name of the module. As you type the module name, the highlight bar will move to the first module that matches the letters you typed. When the highlight bar is on the desired module, press Enter.
Pick a source file
Pick a new source file to display in the Module window. The list shows all the source files that make up the module.
Pick a symbol name
Pick a symbol from the list of displayed symbols. You can start to type a name, and you will be positioned to the first symbol, start-ing with what you have typed so far.
Turbo Pro filer User's GuIde
Pick a window
Pick the window you want to make the active window by moving the highlight bar to it and pressing Enter or choosing the OK button.
You can close a window by moving the highlight bar to that window name and pressing the Del or Ctrl-Y.
Pick Interrupt
Pick an interrupt from the list of interrupts built in to Turbo Profiler.