home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv4.zip / VACPP / IBMCPP / HELP / CPPOPA3.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-05-16  |  295KB  |  11,150 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Trademarks and Service Marks ΓòÉΓòÉΓòÉ
  3.  
  4. The following terms used in this documentation are trademarks or service marks 
  5. of IBM Corporation in the United States and other countries: 
  6.  
  7.      C Set ++ 
  8.      IBM 
  9.      Operating System/2 
  10.      OS/2 
  11.      VisualAge 
  12.      WorkFrame 
  13.  
  14.  
  15. ΓòÉΓòÉΓòÉ 2. Introducing the Performance Execution Trace Analyzer ΓòÉΓòÉΓòÉ
  16.  
  17. The IBM VisualAge C++ for OS/2, V3.0 Performance Execution Trace Analyzer is an 
  18. application that helps you understand and improve the behavior of IBM C and C++ 
  19. programs. 
  20.  
  21. The Performance Analyzer traces the execution of a program and creates a trace 
  22. file. The trace file contains trace analysis data that can be displayed in 
  23. diagrams. Using these diagrams, you can improve the performance of a program, 
  24. examine occurrences that produce faults, and in general, understand what 
  25. happens when a program runs. 
  26.  
  27. The Performance Analyzer does not replace static analyzers or debuggers, but it 
  28. can complement them by helping you understand aspects of the program that would 
  29. otherwise be difficult or impossible to see. 
  30.  
  31. For instance, with the Performance Analyzer you can: 
  32.  
  33.  Time and tune programs 
  34.        The Performance Analyzer time stamps each trace event using a high 
  35.        resolution clock (about 838 nanoseconds per clock tick). As a result, 
  36.        the trace file contains a detailed record of when each traced function 
  37.        was called and when it returned. 
  38.  
  39.        The trace data also shows how long each function runs, which helps you 
  40.        find hot spots. 
  41.  Locate program hangs and deadlocks 
  42.        The Performance Analyzer provides a complete history of events leading 
  43.        up to the point where a program stops. You can view the function call 
  44.        stack from anywhere in the program. 
  45.  Trace multithreaded interactions 
  46.        When multithreaded programs are traced, you can look at the sequencing 
  47.        of functions across threads in some of the diagrams. This highlights 
  48.        problems within critical areas of the program. 
  49.  
  50.  Related Information 
  51.  
  52.      Preparing Your Program for the Performance Analyzer 
  53.      Starting the Performance Analyzer from OS/2 
  54.      Starting the Performance Analyzer from WorkFrame 
  55.      Creating a Trace File. 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 2.1. New and Enhanced Features ΓòÉΓòÉΓòÉ
  59.  
  60.  Performance Analyzer - Window Manager window 
  61.        The Performance Analyzer - Window Manager window is the control window 
  62.        for the Performance Analyzer. From this window, you can start most 
  63.        Performance Analyzer functions. For instance, you can: 
  64.            Start creating a new trace file 
  65.            Start analyzing an existing trace file 
  66.            Open and close a diagram. 
  67.  Trace On and Trace Off push buttons 
  68.        These buttons, which appear on the Application Monitor window, let you 
  69.        start and stop the trace of your program. In addition, you can add calls 
  70.        to PerfStart and PerfStop in your source code to start and stop 
  71.        gathering events at precise moments during program execution. 
  72.  WorkFrame integration 
  73.        If you have started the Performance Analyzer from WorkFrame, you can: 
  74.            Display Help information for library functions, such as IBM Open 
  75.             Class functions, OS/2 system functions, and C runtime functions. 
  76.            Start the WorkFrame editor from a Performance Analyzer diagram and 
  77.             edit your source code. 
  78.            Start other programs from the Performance Analyzer. 
  79.  Tracing capability in dynamic link libraries 
  80.        In addition to tracing functions in the executable file, the Performance 
  81.        Analyzer can trace your program's activity in: 
  82.            Statically or dynamically linked Dynamic link libraries (DLLs). 
  83.            The following system libraries: 
  84.               -  DOSCALL.DLL 
  85.               -  PMGPI.DLL 
  86.               -  PMWIN.DLL 
  87.            Dynamically linked load-on-call DLLs. If you only want to trace a 
  88.             load-on-call DLL, the Trace Generation window will not have any 
  89.             executables or DLLs listed in the window, and you will receive an 
  90.             informational message. 
  91.  Tracing capability for up to 64 threads 
  92.        The Performance Analyzer can trace up to 64 threads. The diagrams show 
  93.        activity on all or selected threads. 
  94.  Pop-up menus 
  95.        Clicking mouse button two in most diagrams displays pop-up menus that 
  96.        let you quickly access frequently used functions. 
  97.  Time find capability in Call Nesting 
  98.        The Call Nesting diagram has a search capability that lets you go to 
  99.        specific times in the trace file. 
  100.  Time Line diagram 
  101.        The Performance Analyzer can display user events in the Time Line 
  102.        diagram. 
  103.  Status Area 
  104.        Each diagram has a Status Area, which shows you detailed information 
  105.        about the trace file data. 
  106.  Vertical Ruler 
  107.        Many diagrams have a Vertical Ruler that shows your location in the 
  108.        trace file. 
  109.  
  110.  Related Information 
  111.  
  112.      Preparing Your Program for the Performance Analyzer 
  113.      Starting the Performance Analyzer from OS/2 
  114.      Starting the Performance Analyzer from WorkFrame 
  115.      Creating a Trace File 
  116.      Performance Analyzer - Window Manager Window 
  117.      Trace On Push Button 
  118.      Trace Off Push Button 
  119.      Starting and Stopping the Performance Analyzer from Your Program. 
  120.      Tracing Dynamic Link Libraries (DLLs). 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 3. Preparing Your Program for the Performance Analyzer ΓòÉΓòÉΓòÉ
  124.  
  125. Before you create a trace file and begin using the Performance Execution Trace 
  126. Analyzer, you must compile and link your program with the proper options. This 
  127. is described in Compiling and Linking Your Program. 
  128.  
  129. The Performance Analyzer provides several ways to customize trace files. If you 
  130. want to customize a trace file, you may have to complete some steps before you 
  131. compile and link your program. For more information and instructions, see the 
  132. following topics: 
  133.  
  134.      Tracing Dynamic Link Libraries (DLLs) 
  135.      Tracing System Calls 
  136.      Creating User Events in Your Program 
  137.      Starting and Stopping the Performance Analyzer from Your Program. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 3.1. Compiling and Linking Your Program ΓòÉΓòÉΓòÉ
  141.  
  142. You must compile and link your program with the proper options before you 
  143. create a trace file and analyze it with the Performance Analyzer. 
  144.  
  145. The Performance Analyzer provides several ways to customize trace files. If you 
  146. want to customize a trace file, you may have to complete some steps before you 
  147. compile and link your program. For more information and instructions, see the 
  148. following topics: 
  149.  
  150.      Tracing Dynamic Link Libraries (DLLs) 
  151.      Tracing System Calls 
  152.      Creating User Events in Your Program 
  153.      Starting and Stopping the Performance Analyzer from Your Program. 
  154.  
  155.  Compiling 
  156.  
  157.  When compiling your program, use the following options: 
  158.  
  159.  /Gh   Includes the profile hooks that allow the Performance Analyzer to 
  160.        monitor your executable. 
  161.  
  162.  /Ti   Includes debugging information in the compiled object file. 
  163.  
  164.  Linking 
  165.  
  166.  You must link the CPPOPA3.OBJ object file into your program. 
  167.  
  168.  When linking your program, use the following options: 
  169.  
  170.  /DE   Instructs the linker to include debug information in the executable 
  171.        (EXE) or dynamic link library (DLL) file. 
  172.  
  173.  /NOE  Instructs the linker not to search for symbols in the extended 
  174.        dictionaries of the libraries being linked. 
  175.  
  176.  Example 
  177.  
  178.  The following example shows how to compile and link a program called 
  179.  SAMPLE.EXE for use with the Performance Analyzer. The required object file is 
  180.  highlighted in bold. 
  181.  
  182.  Compile: 
  183.  
  184.     icc /c /Ti /Gh sample.c
  185.  
  186.  Link: 
  187.  
  188.     icc /b"/DE /NOE" /FeSAMPLE.EXE sample.obj cppopa3.obj
  189.  
  190.  Related Information 
  191.  
  192.      IBM C/C++ Tools: Programming Guide 
  193.      Tracing Dynamic Link Libraries (DLLs) 
  194.      Tracing System Calls 
  195.      Creating User Events in Your Program 
  196.      Starting and Stopping the Performance Analyzer from Your Program. 
  197.  
  198.  
  199. ΓòÉΓòÉΓòÉ 3.2. Tracing Dynamic Link Libraries (DLLs) ΓòÉΓòÉΓòÉ
  200.  
  201. You can trace statically or dynamically linked DLLs and load-on-call DLLs using 
  202. the Performance Analyzer. Compile and link any DLL to be traced for use by the 
  203. Performance Analyzer as explained in Compiling and Linking Your Program. 
  204.  
  205. You can trace DLLs without tracing the main program that calls the DLLs. 
  206.  
  207. The tracing of load-on-call DLLs occurs automatically; it cannot be suppressed. 
  208. Also, you cannot set triggers, or enable or disable functions in dynamically 
  209. linked DLLs. 
  210.  
  211.  
  212. ΓòÉΓòÉΓòÉ 3.3. Tracing System Calls ΓòÉΓòÉΓòÉ
  213.  
  214. If you want to trace calls into the OS/2 Toolkit Application Programming 
  215. Interface (API), specify the following Performance Analyzer libraries before 
  216. the OS/2 libraries in your link statement. You can link one or more libraries. 
  217. This is shown in the Example under Compiling and Linking Your Program. 
  218.  
  219. If you want to trace file accesses, you must link the _DOSCALL.LIB library. 
  220.  
  221. Notes 
  222.  
  223.      Output produced by cout stream objects is stored in the operating 
  224.       system's buffer and is not shown until tracing has stopped, and DosCalls 
  225.       for these calls are not displayed in the trace file. 
  226.      It is not possible to trace events in the DOSCALL intercept library only. 
  227.       The Performance Analyzer looks for at least one event from your program 
  228.       before logging DOS call events. If you link the _DOSCALL.LIB library, 
  229.       compile your program with the /Gh option to include events from your 
  230.       program in the trace file. 
  231.  
  232.  The APIs and their corresponding Performance Analyzer libraries are as 
  233.  follows. Each library listed also has an associated DLL. 
  234.  
  235.  API         Library 
  236.  DosCalls    _DOSCALL.LIB 
  237.  WinCalls    _PMWIN.LIB 
  238.  GpiCalls    _PMGPI.LIB 
  239.  
  240.  Important  The order in which these libraries are specified in the link 
  241.             statement is critical. If the replacement libraries do not precede 
  242.             the OS/2 libraries in the link statement, the Performance Analyzer 
  243.             will not interpret and trace the API calls. 
  244.  
  245.  Related Information 
  246.  
  247.      Compiling and Linking Your Program 
  248.      Tracing File Accesses 
  249.      IBM C/C++ Tools: Programming Guide. 
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ 3.4. Creating User Events in Your Program ΓòÉΓòÉΓòÉ
  253.  
  254. The CPPOPA3.OBJ file contains an entry point called PERF that accepts calls 
  255. from the program you are tracing. Calls to the PERF entry point at run time are 
  256. referred to as user events. User events cause text strings to be inserted into 
  257. the trace file. 
  258.  
  259. To add a call to the PERF entry point: 
  260.  
  261.    1. Declare a prototype for the PERF entry point. 
  262.  
  263.       If you add a user event to your program source file, you must also 
  264.       include a prototype for the PERF entry point. 
  265.  
  266.       For C and C++ programs, the prototype will be inserted for you when you 
  267.       compile your program if you place the following statement at the 
  268.       beginning of your source file: 
  269.  
  270.             #include <icsperf.h>
  271.  
  272.       Note:  If you want to insert the prototype yourself, the prototypes for C 
  273.              and C++ programs are as follows: 
  274.  
  275.       C Prototype 
  276.  
  277.             VOID PERF (PSZ string);
  278.  
  279.       C++ Prototype 
  280.  
  281.             EXTERN "C" {VOID PERF(PSZ string);}
  282.  
  283.    2. Add a call to the entry point everywhere you want a user event generated. 
  284.  
  285.       The following is an example of a call to the PERF entry point: 
  286.  
  287.             PERF (string);
  288.  
  289.             where:
  290.             string is an ASCIIZ string.
  291.  
  292.       When such a call is made, the string is placed in the trace file. You can 
  293.       see the string in the Call Nesting Statistics, and Time Line diagrams. 
  294.  
  295.       Warning: 
  296.           The string must consist of unique, static, alphanumeric characters. 
  297.            Otherwise, you will receive unpredictable results. 
  298.           The string must exist in storage when your program terminates. If 
  299.            the string exists in automatic storage on the stack or storage 
  300.            defined in a dynamically loaded DLL, the string will appear in the 
  301.            trace file, but the text may not appear as it was defined. (The 
  302.            string can be allocated on the heap if its contents are not deleted 
  303.            when your program terminates.) 
  304.  
  305.  Related Information 
  306.  
  307.      Compiling and Linking Your Program 
  308.      Tracing System Calls 
  309.      Starting and Stopping the Performance Analyzer from Your Program 
  310.      Annotate Window 
  311.      Call Nesting diagram 
  312.      Statistics diagram 
  313.      Time Line diagram 
  314.      Application Monitor Window 
  315.      IBM C/C++ Tools: Programming Guide. 
  316.  
  317.  
  318. ΓòÉΓòÉΓòÉ 3.5. Starting and Stopping the Performance Analyzer from Your Program ΓòÉΓòÉΓòÉ
  319.  
  320. The CPPOPA3.OBJ file contains entry points called PerfStart and PerfStop that 
  321. accept calls from the program you are tracing. Calls to the PerfStart and 
  322. PerfStop entry points cause the Performance Analyzer to start and stop tracing, 
  323. respectively. By putting these calls into your source code, you can control 
  324. precisely when the Performance Analyzer starts and stops recording events 
  325. during program execution. To turn tracing: 
  326.  
  327.      On, call the PerfStart entry point. 
  328.      Off, call the PerfStop entry point. 
  329.  
  330.  Notes: 
  331.  
  332.    1. If the trace is already on, calling PerfStart has no effect. If the trace 
  333.       is already off, calling PerfStop has no effect. 
  334.    2. You can also start and stop tracing with the Trace on and Trace off push 
  335.       buttons on the Application Monitor window. 
  336.  
  337.  You can place calls to the PerfStart and PerfStop entry points anywhere in 
  338.  your program, even in different functions, object modules, or DLLs. 
  339.  
  340.  To add calls to the PerfStart and PerfStop entry points: 
  341.  
  342.    1. Declare a prototype for the PerfStart and PerfStop entry points. 
  343.  
  344.       For C and C++ programs, the prototypes will be inserted for you when you 
  345.       compile your program if you place the following statement at the 
  346.       beginning of your source file: 
  347.  
  348.             #include <icsperf.h>
  349.  
  350.       Note:  If you want to insert the prototypes yourself, the prototypes for 
  351.              C and C++ programs are as follows: 
  352.  
  353.       C Prototype 
  354.  
  355.             VOID PerfStart (VOID);
  356.             VOID PerfStop (VOID);
  357.  
  358.       C++ Prototype 
  359.  
  360.             EXTERN "C" {VOID PerfStart (VOID);}
  361.             EXTERN "C" {VOID PerfStop (VOID);}
  362.  
  363.    2. Add a call to the appropriate entry point everywhere you want to start or 
  364.       stop tracing. 
  365.  
  366.       The following example shows how calls to the PerfStart and PerfStop entry 
  367.       points could be placed in your program: 
  368.  
  369.                  .
  370.                  .
  371.                  .
  372.             PerfStop();  // turn off tracing here
  373.                  .
  374.                  .
  375.                  .
  376.             PerfStart();  // resume tracing here
  377.  
  378.  Related Information 
  379.  
  380.      Compiling and Linking Your Program 
  381.      Tracing System Calls 
  382.      Annotate Window 
  383.      Call Nesting diagram 
  384.      Statistics diagram 
  385.      Time Line diagram 
  386.      Application Monitor Window 
  387.      IBM C/C++ Tools: Programming Guide. 
  388.  
  389.  
  390. ΓòÉΓòÉΓòÉ 4. Starting the Performance Analyzer from OS/2 ΓòÉΓòÉΓòÉ
  391.  
  392. After completing the instructions in Preparing Your Program for the Performance 
  393. Analyzer, you are ready to create a trace file and use the Performance Analyzer 
  394. to analyze your program. 
  395.  
  396. The command you enter to start the Performance Execution Trace Analyzer depends 
  397. on which of the following you want to do first: 
  398.  
  399.      Trace an executable 
  400.      Analyze an existing trace file. 
  401.      Display the Performance Analyzer's main control window 
  402.  
  403.  Tracing an Executable 
  404.  
  405.      If you have an executable you want to trace, you can start the analyzer 
  406.       from an OS/2 command prompt or a command file (.CMD) by entering: 
  407.  
  408.             icsperf myprog parms
  409.  
  410.       Where: 
  411.  
  412.       myprog         Represents an executable file name. This is optional. 
  413.       parms          Represents executable parameters. These are optional. 
  414.  
  415.       Note: 
  416.  
  417.       The first time you start the Performance Analyzer, a profile window 
  418.       appears and prompts you to specify where the Performance Analyzer's 
  419.       profile file should be located. If you want the default, press the OK 
  420.       push button. See Performance Analyzer - Specify Profile Location Window 
  421.       for more information. 
  422.  
  423.      You can also include the /go option in the command: 
  424.  
  425.             icsperf /go myprog parms
  426.  
  427.       Where: 
  428.  
  429.       /go            Option that executes your program, creates a trace file, 
  430.                      and then exits the Performance Analyzer. This option is 
  431.                      useful if you have several programs (requiring no manual 
  432.                      intervention) that you want to run in succession from an 
  433.                      OS/2 command file. This is optional. 
  434.       myprog         Represents an executable file name. 
  435.       parms          Represents executable parameters. These are optional. 
  436.  
  437.  Analyzing an Existing Trace File 
  438.  
  439.  If you want to start analyzing a trace file you have already created, you can 
  440.  start the analyzer from an OS/2 command prompt or a command file (.CMD) by 
  441.  entering: 
  442.  
  443.   icsperf /x myprog.trc
  444.  
  445.  Where: 
  446.  
  447.  /x            Represents one or more of the following analyzer options. If you 
  448.                have already created a trace file, these options cause the trace 
  449.                file to be displayed in their respective diagrams. Once you are 
  450.                familiar with the Performance Analyzer application, you can 
  451.                quickly open the diagrams by entering as many of these options 
  452.                as you want in your startup command. This is optional. 
  453.  
  454.                /cn       Displays the trace file in the Call Nesting diagram. 
  455.  
  456.                /ed       Displays the trace file in the Execution Density 
  457.                          diagram. 
  458.  
  459.                /cg       Displays the trace file in the Dynamic Call Graph. 
  460.  
  461.                /ss       Displays the trace file in the Statistics diagram. 
  462.  
  463.                /tl       Displays the trace file in the Time Line diagram. 
  464.  
  465.  myprog.trc    Represents a trace file name. 
  466.  
  467.  Displaying the Performance Analyzer's Main Control Window 
  468.  
  469.  If you enter the following command, the analyzer's main control window, the 
  470.  Performance Analyzer - Window Manager window, appears: 
  471.  
  472.   icsperf
  473.  
  474.  From this window, you can start either tracing an executable or analyzing an 
  475.  existing trace file. See Creating a Trace File to continue. 
  476.  
  477.  To analyze WorkPlace Shell objects: 
  478.  
  479.    1. Replace the RUNWORKPLACE line in your config.sys file with the following 
  480.       line: 
  481.  
  482.             SET RUNWORKPLACE=C:/OS2/CMD.EXE
  483.  
  484.    2. Restart your system. 
  485.    3. At an OS/2 prompt, type the following: 
  486.  
  487.             icsperf c:/os2/pmshell
  488.  
  489.  Related Information 
  490.  
  491.      Introducing the Performance Analyzer 
  492.      Preparing Your Program for the Performance Analyzer 
  493.      Performance Analyzer - Window Manager Window 
  494.      Creating a Trace File 
  495.      Analyzing a Trace File 
  496.  
  497.  
  498. ΓòÉΓòÉΓòÉ 5. Starting the Performance Analyzer from WorkFrame ΓòÉΓòÉΓòÉ
  499.  
  500. Before you start the Performance Analyzer from the WorkFrame environment, you 
  501. must: 
  502.  
  503.    1. Create a project for the program you want to analyze. 
  504.  
  505.       Note:  For information on creating a project, refer to your WorkFrame 
  506.       documentation. 
  507.  
  508.    2. Compile and link your program with Performance Analyzer options. 
  509.  
  510.       Note:  This is described in Compiling and Linking Your Program. 
  511.  
  512.    3. Open a project folder in the WorkFrame window. 
  513.  
  514.    4. Highlight an object that represents an executable file or a trace file. 
  515.  
  516.    5. Click mouse button two on the highlighted object to display a pop-up 
  517.       menu. 
  518.  
  519.    6. Select Analyze. 
  520.  
  521.  Related Information 
  522.  
  523.      Introducing the Performance Analyzer 
  524.      Preparing Your Program for the Performance Analyzer 
  525.      Performance Analyzer - Window Manager Window 
  526.      Creating a Trace File 
  527.      Analyzing a Trace File 
  528.      Search Paths... Choice 
  529.      Project Menu 
  530.      Exiting the Performance Analyzer. 
  531.  
  532.  
  533. ΓòÉΓòÉΓòÉ 6. Exiting the Performance Analyzer ΓòÉΓòÉΓòÉ
  534.  
  535. If you want to exit the Performance Analyzer, and are not in the process of 
  536. creating a trace file, do the following: 
  537.  
  538.    1. Select the Exit the Performance Analyzer choice from one of the following 
  539.       menus: 
  540.  
  541.           File menu on the Performance Analyzer - Window Manager window 
  542.           Application menu on the Trace Generation window 
  543.           Trace file menu on any of the diagrams. 
  544.  
  545.    2. Select Yes when prompted. 
  546.  
  547.  If you want to exit the Performance Analyzer while a trace file is being 
  548.  created, do the following: 
  549.  
  550.    1. Click on the Stop push button on the Application Monitor window. 
  551.  
  552.    2. Click on the Cancel push button on the Analyze Trace window. 
  553.  
  554.    3. Select the Exit the Performance Analyzer choice from the File menu on the 
  555.       Performance Analyzer - Window Manager window. 
  556.  
  557.    4. Select Yes when prompted. 
  558.  
  559.  Related Information 
  560.  
  561.      Performance Analyzer - Window Manager Window 
  562.      Quick Exit Choice 
  563.      Exit the Performance Analyzer Choice. 
  564.  
  565.  
  566. ΓòÉΓòÉΓòÉ 7. Creating a Trace File ΓòÉΓòÉΓòÉ
  567.  
  568. After compiling and linking your program, you can start the Performance 
  569. Analyzer and create a trace file. A trace file contains a chronological 
  570. sequence of events that occur during the execution of your program. 
  571.  
  572. By analyzing the trace file, you can learn about your program's structure, 
  573. locate and diagnose problems, and pinpoint ways to improve performance. The 
  574. Performance Analyzer provides five diagrams in which you can analyze the trace 
  575. file. Each diagram presents a different view of the trace file to give you an 
  576. overall idea of how your program performs. The diagrams are as follows: 
  577.  
  578.      Call Nesting 
  579.      Dynamic Call Graph 
  580.      Execution Density 
  581.      Statistics 
  582.      Time Line. 
  583.  
  584.  Note:  Before creating a trace file, you must prepare your program for use by 
  585.  the Performance Analyzer. For more information, see Preparing Your Program for 
  586.  the Performance Analyzer. 
  587.  
  588.  To create a trace file: 
  589.  
  590.    1. Click on the Create Trace... push button in the Performance Analyzer - 
  591.       Window Manager window. 
  592.  
  593.    2. Type the full path name and the file name of the program you want to 
  594.       trace in the Program Name entry field. If the program is in your current 
  595.       directory, you do not have to type the path name. 
  596.  
  597.       Note:  If you are not sure where the file is located, select the Find... 
  598.       push button. 
  599.  
  600.    3. Type any parameters that you want to pass to your program in the Program 
  601.       Parameters entry field. 
  602.  
  603.       Note:  This entry field is optional. 
  604.  
  605.    4. If you want the trace file to have a different path or file name than the 
  606.       defaults, type a path and file name in the Trace File Name entry field. 
  607.  
  608.       The default path name is the directory where your program resides. The 
  609.       default trace file name is myprog.trc, where myprog is the name of the 
  610.       program you are tracing. 
  611.  
  612.       Note:  This entry field is optional. 
  613.  
  614.    5. Type any comments that you want to make about your trace in the Trace 
  615.       File Description entry field. 
  616.  
  617.       Note:  This entry field is optional. 
  618.  
  619.    6. Select the OK push button. The Trace Generation window appears. 
  620.  
  621.    7. Select the Trace push button in the Trace Generation window. 
  622.  
  623.       Your program begins executing. When your program ends, the Analyze Trace 
  624.       window is displayed. 
  625.  
  626.    8. Click on the check box next to each diagram in which you want to view the 
  627.       trace file. 
  628.  
  629.  Related Information 
  630.  
  631.      Compiling and Linking Your Program 
  632.      Create Trace Window 
  633.      Trace Generation Window 
  634.      Analyze Trace Window. 
  635.  
  636.  
  637. ΓòÉΓòÉΓòÉ 8. Creating a Customized Trace File ΓòÉΓòÉΓòÉ
  638.  
  639. By default, the Performance Analyzer generates event information for every 
  640. function possible. However, this sometimes causes the trace file to become 
  641. large and difficult to manage. You can limit the size of your trace file by 
  642. changing the parameters that control its size prior to running your program. 
  643. The following parameters affect the size of the trace file: 
  644.  
  645.      Enabled or disabled state of components 
  646.      Call depth setting for each thread 
  647.      Time stamp setting 
  648.      File access setting 
  649.      Trigger settings. 
  650.  
  651.  You can also customize the trace file by: 
  652.  
  653.      Disabling buffer flushing or changing the buffer size setting to specify 
  654.       how often the buffer flushes to the trace file. For more information, see 
  655.       Changing the Buffer Size and Buffer Control Window. 
  656.      Giving the trace file a file name other than the default. The default 
  657.       file name is myprog.trc, where myprog is the name of the program you are 
  658.       tracing. For more information on specifying a different trace file name, 
  659.       see Name Trace File... Choice or Unique Trace File Name Choice. 
  660.      Attaching a description to the trace file. A description can make a trace 
  661.       file easier to identify, especially when you create more than one trace 
  662.       file from the same program and use different options for each trace. The 
  663.       description is displayed in the Status Area of any open diagram. For more 
  664.       information on attaching a description to a trace file, see Name Trace 
  665.       File... Choice or Unique Trace File Name Choice. 
  666.  
  667.  Related Information 
  668.  
  669.      Preparing Your Program for the Performance Analyzer 
  670.      Compiling and Linking Your Program 
  671.      Performance Analyzer - Window Manager Window 
  672.      Trace Generation Window. 
  673.  
  674.  
  675. ΓòÉΓòÉΓòÉ 8.1. Enabling and Disabling Components ΓòÉΓòÉΓòÉ
  676.  
  677. From the Edit menu in the Trace Generation window, you can control which parts 
  678. of your program are traced by enabling and disabling components. 
  679.  
  680. A component can be an executable file, dynamic load library (DLL) file, an 
  681. object (OBJ) file, or a function. EXE and DLL files contain object files, and 
  682. object files contain functions. 
  683.  
  684. To view or hide components in the window, click on the plus and minus icons to 
  685. expand and contract EXE, DLL, and OBJ files. 
  686.  
  687. When a component is enabled, data for that component will be included in the 
  688. trace file when the component is executed. When the component is disabled, no 
  689. data is recorded in the trace file when the component is executed. 
  690.  
  691. Note:  The Performance Analyzer's default is to enable all components that have 
  692. been compiled and linked with the proper options. 
  693.  
  694. When you disable: 
  695.  
  696.      An EXE, DLL, or OBJ file, the Performance Analyzer disables all functions 
  697.       within the selected file and removes any triggers set on functions within 
  698.       the file. 
  699.      A function, the Performance Analyzer removes any trigger set on it. 
  700.  
  701.  When you enable: 
  702.  
  703.      An EXE, DLL, or OBJ file, the Performance Analyzer enables all functions 
  704.       within the selected file. 
  705.  
  706.  When you set a trigger on a disabled function, the Performance Analyzer 
  707.  enables the function. 
  708.  
  709.  The following choices are available from the Edit menu on the Trace Generation 
  710.  window. The choices displayed in the menu change depending upon the type of 
  711.  component selected; therefore, all of the choices are not displayed at the 
  712.  same time. 
  713.  
  714.  Enable all executables 
  715.            Enables all functions in all executable files. 
  716.  Disable all executables 
  717.            Disables all functions in all executable files. 
  718.  Enable executable 
  719.            Enables all functions in a selected executable file. This choice is 
  720.            available when you select a disabled executable. 
  721.  Disable executable 
  722.            Disables all functions in a selected executable file. This choice is 
  723.            available when you select an enabled executable. 
  724.  Enable object file 
  725.            Enables all functions in a selected object file. This choice is 
  726.            available when you select a disabled object file. 
  727.  Disable object file 
  728.            Disables all functions in a selected object file. This choice is 
  729.            available when you select an enabled object file. 
  730.  Enable function 
  731.            Enables a function. This choice is available when you select a 
  732.            disabled function. 
  733.  Disable function 
  734.            Disables a function. This choice is available when you select an 
  735.            enabled function. 
  736.  Set trigger 
  737.            Sets a trigger on a function so that the Performance Analyzer traces 
  738.            the function and its associated calls. This choice is available when 
  739.            you select a function that does not have a trigger set on it. 
  740.  
  741.            Note:  If triggers are set, the Performance Analyzer traces all 
  742.            enabled components and only those functions on which triggers are 
  743.            set. If no triggers are set, the Performance Analyzer traces all 
  744.            enabled components. 
  745.  Remove trigger 
  746.            Removes a trigger on a function so that the Performance Analyzer 
  747.            does not trace the function and its associated calls. This choice is 
  748.            available when you select a function that has a trigger set on it. 
  749.  
  750.            Note:  If triggers are set, the Performance Analyzer traces all 
  751.            enabled components and only those functions on which triggers are 
  752.            set. If no triggers are set, the Performance Analyzer traces all 
  753.            enabled components. 
  754.  
  755.  You can enable or disable a component in one of the following ways: 
  756.  
  757.      Click on the file name or icon of the component you want to enable or 
  758.       disable. Then select the appropriate enable or disable choice from the 
  759.       Edit menu on the Trace Generation window. 
  760.      Double-click on the file name or icon of the component you want to enable 
  761.       or disable. 
  762.      Click mouse button two on the file name or icon of the component you want 
  763.       to enable or disable. Then select the appropriate enable or disable 
  764.       choice from the pop-up menu. 
  765.  
  766.  Note:  If the icon next to a component is: 
  767.  
  768.      Green (it also has no slash mark), the component is enabled. 
  769.      Red (it also has a slash mark), the component is disabled. 
  770.      White, the component cannot be traced. 
  771.  
  772.  
  773. ΓòÉΓòÉΓòÉ 8.2. Selecting the Call Depth for Each Thread ΓòÉΓòÉΓòÉ
  774.  
  775. Select Call depth... from the Options menu on the Trace Generation window to 
  776. select the number of calls you want to trace or to specify threads you want to 
  777. include or exclude from the trace file. When the Call Depth window is 
  778. displayed, you can select as many as 64 threads with a maximum nesting depth of 
  779. 128 for each thread. The default is to have all threads selected with the 
  780. maximum depth of 128. 
  781.  
  782. You may want to limit the call depth to isolate an area of interest and reduce 
  783. the amount of trace data. 
  784.  
  785. Related Information 
  786.  
  787.      Call Depth... Choice 
  788.      Trace Generation Window 
  789.      Keys Help. 
  790.  
  791.  
  792. ΓòÉΓòÉΓòÉ 8.3. Using Time Stamps ΓòÉΓòÉΓòÉ
  793.  
  794. Select Time stamp events from the Options menu on the Trace Generation window 
  795. to choose whether to time stamp events during the trace analysis. 
  796.  
  797. The Performance Analyzer uses an internal timer to get high resolution time 
  798. stamps. While logging events, the Performance Analyzer adds a small amount of 
  799. overhead time to the normal runtime speed of the program. The time added is 
  800. negligible, so you may not be able to tell the difference between code that has 
  801. been traced and code that has not, even for highly interactive programs. 
  802.  
  803. The overhead time added by the Performance Analyzer is not shown in the times 
  804. reported for user code in all of the Performance Analyzer diagrams. the 
  805. Performance Analyzer time stamps the buffer flush so that the buffer-flushing 
  806. overhead can be removed from the diagrams. 
  807.  
  808. If you choose to create a trace file without time stamps, you can only view it 
  809. in the Dynamic Call Graph and the Call Nesting and Statistics diagrams. 
  810.  
  811. Related Information 
  812.  
  813.      Time Stamp Events Choice 
  814.      Understanding Overhead Time 
  815.      Trace Generation Window 
  816.      Keys Help. 
  817.  
  818.  
  819. ΓòÉΓòÉΓòÉ 8.4. Tracing File Accesses ΓòÉΓòÉΓòÉ
  820.  
  821. When a DOS call references a file, the Performance Analyzer keeps track of the 
  822. file name associated with the traced DOS call. These calls are shown in the 
  823. diagrams under the functions that made the file accesses. They appear as 
  824. function names with their corresponding files in parentheses. 
  825.  
  826. The Performance Analyzer can trace file access calls that use the following DOS 
  827. calls: 
  828.  
  829.      DosOpen() 
  830.      DosRead() 
  831.      DosWrite() 
  832.      DosClose() 
  833.      DosDupHandle() 
  834.      DosResetBuffer() 
  835.      DosSetFilePtr() 
  836.      DosSetFileLocks() 
  837.      DosSetFileSize() 
  838.      DosQueryFileInfo() 
  839.      DosQueryHType() 
  840.  
  841.  To set file access: 
  842.  
  843.      Select the File access choice from the Options menu on the Trace 
  844.       Generation window. A check mark appears next to the choice to indicate 
  845.       that the choice is enabled. 
  846.  
  847.  To reset file access: 
  848.  
  849.      Select the File access choice from the Options menu on the Trace 
  850.       Generation window. The check mark is removed to indicate that the choice 
  851.       is disabled. 
  852.  
  853.  Notes: 
  854.  
  855.      The settings you enter are saved for the current session. If you want to 
  856.       save the settings for subsequent sessions, select the Options menu and 
  857.       then select the Save choice from the Settings cascaded menu. 
  858.      You can only select the File access choice when the _DOSCALL.LIB file is 
  859.       linked with your program. 
  860.  
  861.  Related Information 
  862.  
  863.      Trace Generation Window 
  864.      Keys Help. 
  865.  
  866.  
  867. ΓòÉΓòÉΓòÉ 8.5. Setting and Removing Triggers ΓòÉΓòÉΓòÉ
  868.  
  869. A trigger turns tracing on when it is called and then turns tracing off when it 
  870. returns. The Performance Analyzer allows you to set and remove triggers on 
  871. functions. You can set multiple triggers. 
  872.  
  873. By setting triggers to start or stop tracing at selected points in your 
  874. program, you can control the size of your trace file. 
  875.  
  876. You can set and remove triggers from the Edit and Function pop-up menus on the 
  877. Trace Generation window. 
  878.  
  879. Remember the following when using triggers: 
  880.  
  881.      If triggers are set, the Performance Analyzer traces all enabled 
  882.       components and only those functions on which triggers are set. If no 
  883.       triggers are set, the Performance Analyzer traces all enabled components. 
  884.      If a trigger function is nested within another trigger function, tracing 
  885.       is turned off only after the outer function returns. 
  886.      A function that has a trigger set on it has the letter T in the icon next 
  887.       to its function name in the Trace Generation window. 
  888.      If you disable an EXE, DLL, or object (OBJ) file, the Performance 
  889.       Analyzer disables all functions within the selected file and removes any 
  890.       triggers set on functions within the file. 
  891.      If you set a trigger on a disabled function, the Performance Analyzer 
  892.       enables the function. 
  893.      If you disable a function, the Performance Analyzer removes any trigger 
  894.       set on it. 
  895.  
  896.  Related Information 
  897.  
  898.      Set Trigger Choice 
  899.      Remove Trigger Choice 
  900.      Function Pop-up Menu 
  901.      Keys Help. 
  902.  
  903.  
  904. ΓòÉΓòÉΓòÉ 8.6. Changing the Buffer Size ΓòÉΓòÉΓòÉ
  905.  
  906. Select Buffer Control from the Options menu on the Trace Generation window to 
  907. change the buffer size or to enable buffer wrapping. 
  908.  
  909. During a trace analysis, the Performance Analyzer and your program share memory 
  910. with the trace buffer. The trace buffer allows the Performance Analyzer to log 
  911. events that are running in the address space of the program. 
  912.  
  913. When the trace buffer is full, the Performance Analyzer: 
  914.  
  915.    1. Stops the program 
  916.    2. Time stamps the start of the buffer flush 
  917.    3. Writes the events in the buffer to the trace file 
  918.    4. Time stamps the end of the buffer flush 
  919.    5. Restarts the program. 
  920.  
  921.       Note:  Time stamping the buffer flush allows the diagrams to remove the 
  922.       buffer-flushing overhead time. 
  923.  
  924.  You can select the size of the trace buffer, and thereby change the time spent 
  925.  flushing the buffer to the trace file. When you increase the size of the 
  926.  buffer, more events are recorded before the Performance Analyzer flushes the 
  927.  buffer. Likewise, when you decrease the size of the buffer, fewer events are 
  928.  recorded before the Performance Analyzer flushes the buffer. 
  929.  
  930.  You can also enable buffer wrapping, which causes the Performance Analyzer to 
  931.  overwrite older events in the buffer with newer ones. Since the buffer is 
  932.  flushed only when the program ends, less disk space is needed for the trace 
  933.  file, but some trace data is lost. The default for buffer wrapping is disable. 
  934.  For more information on disabling buffer wrapping, see Buffer Control Window. 
  935.  
  936.  Related Information 
  937.  
  938.      Buffer Control Window 
  939.      Trace Generation Window 
  940.      Keys Help. 
  941.  
  942.  
  943. ΓòÉΓòÉΓòÉ 8.7. Naming the Trace File ΓòÉΓòÉΓòÉ
  944.  
  945. Select Name trace file... from the Options menu on the Trace Generation window. 
  946. In the Name Trace File window, you can enter your own trace file name and a 
  947. short description. 
  948.  
  949. The default file name is myprog.trc, where myprog is the file name of the 
  950. program you are tracing. 
  951.  
  952. When you run several traces of the same program, this option lets you name each 
  953. trace file and describe what you did differently for each trace. 
  954.  
  955. For example, if you disable an object file for the first trace and disable time 
  956. stamps for the second trace, you could name the first trace file TRACE1 and 
  957. enter Disabled object file for its description. Likewise, you could name the 
  958. second trace file TRACE2. and enter Disabled time stamps for its description. 
  959.  
  960. A trace file's description is displayed in the Status Area of any open diagram. 
  961.  
  962. Related Information 
  963.  
  964.      Name Trace File... Choice 
  965.      Trace Generation Window 
  966.      Keys Help. 
  967.  
  968.  
  969. ΓòÉΓòÉΓòÉ 8.8. Saving Trace File Settings ΓòÉΓòÉΓòÉ
  970.  
  971. Trace settings (settings that determine how your program is traced) that you 
  972. enter are saved for the current session. You can save some trace settings for 
  973. subsequent traces. If you want to save settings for subsequent sessions, select 
  974. the Options menu and then select the Save choice from the Settings cascaded 
  975. menu. 
  976.  
  977. Related Information 
  978.  
  979.      Save Choice 
  980.      Trace Generation Window 
  981.      Keys Help. 
  982.  
  983.  
  984. ΓòÉΓòÉΓòÉ 9. Analyzing a Trace File ΓòÉΓòÉΓòÉ
  985.  
  986. After you have created your trace file, the Performance Analyzer provides five 
  987. diagrams in which you can view and analyze the data. Each diagram presents a 
  988. different view of the trace file to give you an overall idea of how your 
  989. program performs. 
  990.  
  991. The following list contains a description of each diagram and shows the icon 
  992. that represents it in the Performance Analyzer - Window Manager window when the 
  993. diagram is open. 
  994.  
  995.  Diagram/Icon                       Description 
  996.  
  997.    Call Nesting                     Shows the flow of control and interactions 
  998.                                     among the various threads. Use this diagram 
  999.                                     to diagnose problems with critical 
  1000.                                     sections, sequencing protocols, thread 
  1001.                                     delays, and program deadlocks and crashes. 
  1002.  
  1003.    Dynamic Call Graph               Shows overall view of program and the flow 
  1004.                                     of the program. You can easily see where 
  1005.                                     the most time was spent. 
  1006.  
  1007.    Execution Density                Shows the program by execution time and 
  1008.                                     assists in determining the trends of the 
  1009.                                     functions. 
  1010.  
  1011.    Statistics                       Provides a textual report of execution time 
  1012.                                     by function or executable. You can use this 
  1013.                                     diagram to find hot spots in the overall 
  1014.                                     execution. You can also use this diagram to 
  1015.                                     determine which user functions to inline. 
  1016.  
  1017.    Time Line                        Places the function calls and returns in 
  1018.                                     sequence along a time line. 
  1019.  
  1020.  To open a trace file in any diagram, use any of the following methods: 
  1021.  
  1022.      Click on the Analyze Trace... push button in the Performance Analyzer - 
  1023.       Window Manager window, and then, in Analyze Trace window, enter a trace 
  1024.       file name and select one of the diagram check boxes. 
  1025.      Double-click on the file name or icon of a trace file in the Performance 
  1026.       Analyzer - Window Manager window, then select one of the diagram check 
  1027.       boxes in the Analyze Trace window. 
  1028.      Click mouse button two on the file name or icon of a trace file in the 
  1029.       Performance Analyzer - Window Manager window, then select a diagram from 
  1030.       the Trace File pop-up menu. 
  1031.      From the Trace File menu of an open diagram, select Open as and then 
  1032.       select a diagram from the cascaded menu. 
  1033.  
  1034.  Related Information 
  1035.  
  1036.      Selecting a Trace File to Analyze 
  1037.      Performance Analyzer - Window Manager Window 
  1038.      Analyze Trace Window 
  1039.      Trace File Pop-up Menu 
  1040.      Selecting Functions to Inline 
  1041.      Hints for Using the Performance Analyzer. 
  1042.  
  1043.  
  1044. ΓòÉΓòÉΓòÉ 9.1. Selecting a Trace File to Analyze ΓòÉΓòÉΓòÉ
  1045.  
  1046. You select a trace file to analyze from the Analyze Trace window. Complete 
  1047. these steps to select a file: 
  1048.  
  1049.    1. Click on the Analyze Trace... push button in the Performance Analyzer - 
  1050.       Window Manager window. 
  1051.  
  1052.       The Analyze Trace window appears. 
  1053.  
  1054.    2. Type the full path name and file name of the trace file you want to 
  1055.       analyze in the Trace file name entry field. If the program is in your 
  1056.       current directory, you do not have to type the path name. 
  1057.  
  1058.       Note:  If you are not sure where the file is located, select the Find... 
  1059.       push button. 
  1060.  
  1061.    3. From the Diagrams group heading, select a diagram in which you want to 
  1062.       view the trace file by clicking on the check box next to the diagram 
  1063.       name. You can select one or more of the following diagrams: 
  1064.  
  1065.           Call Nesting 
  1066.           Dynamic Call Graph 
  1067.           Execution Density 
  1068.           Statistics 
  1069.           Time Line. 
  1070.  
  1071.    4. Select OK. 
  1072.  
  1073.  Related Information 
  1074.  
  1075.      Analyzing a Trace File 
  1076.      Call Nesting Diagram 
  1077.      Dynamic Call Graph 
  1078.      Execution Density Diagram 
  1079.      Statistical Summary Diagram 
  1080.      Time Line Diagram 
  1081.      Creating a Trace File. 
  1082.  
  1083.  
  1084. ΓòÉΓòÉΓòÉ 9.2. Understanding Overhead Time ΓòÉΓòÉΓòÉ
  1085.  
  1086. When you compile and link your program, the compiler generates hooks that 
  1087. enable the Performance Analyzer to intercept trace events. The time at which 
  1088. each trace event executes is recorded in the trace file. 
  1089.  
  1090. These hooks cause a small monitoring function to be called instead of the 
  1091. program's callee function. The monitoring function time stamps the event and 
  1092. then calls the program's callee function. 
  1093.  
  1094. The monitoring function is run in the program's address space, thereby avoiding 
  1095. the high overhead of an operating system context switch when events are 
  1096. recorded. As a result, it does not significantly affect the program's runtime 
  1097. performance. However, the monitoring function does take some small amount of 
  1098. time to execute. In order to compensate for this additional time introduced by 
  1099. the monitoring function, the diagrams adjust the timings appropriately. 
  1100.  
  1101. The Performance Analyzer dynamically determines how much time it takes to 
  1102. execute the monitoring function by internally calling it several times and 
  1103. computing an average prior to executing the program. As a result, it is 
  1104. recommended that you shut down other programs on your desktop so they will not 
  1105. interfere with the Performance Analyzer's timings. 
  1106.  
  1107. If the program is run stand-alone, events are not recorded and should run at or 
  1108. near the same speed as the same program compiled without the profile hooks. 
  1109.  
  1110. Related Information 
  1111.  
  1112.      Introducing the Performance Analyzer 
  1113.      Creating User Events in Your Program 
  1114.      Starting and Stopping the Performance Analyzer from Your Program 
  1115.      Tracing System Calls 
  1116.      Compiling and Linking Your Program 
  1117.      Starting the Performance Analyzer from OS/2 
  1118.      Starting the Performance Analyzer from WorkFrame 
  1119.      Performance Analyzer - Window Manager Window. 
  1120.  
  1121.  
  1122. ΓòÉΓòÉΓòÉ 9.3. Selecting Functions to Inline ΓòÉΓòÉΓòÉ
  1123.  
  1124. Your trace file can help you determine which functions to inline. To do this: 
  1125.  
  1126.    1. In addition to preparing your program for the Performance Analyzer as 
  1127.       described in Compiling and Linking Your Program, include the /Oi compiler 
  1128.       option, which causes user functions to be inlined. 
  1129.    2. Create a trace file and display it in the Statistics diagram. 
  1130.  
  1131.       Note:  Functions that appear in the Statistics diagram were not inlined. 
  1132.       If an inlined function appears in the Statistics diagram, the compiler 
  1133.       chose not to inline it. 
  1134.    3. Look for functions in the Statistics diagram that were called frequently 
  1135.       and had small average executable times. These functions may be good 
  1136.       candidates for inlining. 
  1137.  
  1138.  Related Information 
  1139.  
  1140.      Compiling and Linking Your Program 
  1141.      Statistics Diagram 
  1142.      IBM C/C++ Tools: Reference Summary 
  1143.      Keys Help. 
  1144.  
  1145.  
  1146. ΓòÉΓòÉΓòÉ 10. Performance Analyzer - Specify Profile Location Window ΓòÉΓòÉΓòÉ
  1147.  
  1148. When you start the Performance Analyzer for the first time, the Performance 
  1149. Analyzer - Specify Profile Location window appears. This window prompts you to 
  1150. type the path name where you want to store the ICSPERF.INI file. The 
  1151. ICSPERF.INI file stores your session settings. 
  1152.  
  1153. The default path name is the drive and directory where your OS/2 operating 
  1154. system is installed. If you want to store the ICSPERF.INI file in a drive and 
  1155. directory other than the default, type the full path name in the Path entry 
  1156. field, and then select OK. The ICSPERF.INI file is created in the directory you 
  1157. specified. 
  1158.  
  1159. Related Information 
  1160.  
  1161.      Introducing the Performance Analyzer. 
  1162.      Preparing Your Program for the Performance Analyzer 
  1163.  
  1164.  
  1165. ΓòÉΓòÉΓòÉ 11. Performance Analyzer - Window Manager Window ΓòÉΓòÉΓòÉ
  1166.  
  1167. The Performance Analyzer - Window Manager window is the Performance Analyzer's 
  1168. main control window and is always displayed while the Performance Analyzer is 
  1169. running. Once you have properly compiled and linked your program and started 
  1170. the Performance Analyzer, you can start most functions from this window, 
  1171. including creating and analyzing trace files. 
  1172.  
  1173. When you view a trace file, this window lists the file names of your 
  1174. executable, its trace file, and each open diagram. 
  1175.  
  1176. Areas of the Performance Analyzer - Window Manager Window 
  1177.  
  1178.      Menu Bar Summary 
  1179.         -  File 
  1180.         -  View 
  1181.         -  Options 
  1182.         -  Project (only available when working in the WorkFrame environment) 
  1183.         -  Help 
  1184.      Pop-up Menus 
  1185.         -  Executable 
  1186.         -  Trace file 
  1187.         -  Diagram 
  1188.      Push Buttons 
  1189.         -  Create Trace... 
  1190.         -  Analyze Trace.... 
  1191.  
  1192.  Related Information 
  1193.  
  1194.      Introducing the Performance Analyzer 
  1195.      Compiling and Linking Your Program 
  1196.      Creating a Trace File 
  1197.      Selecting a Trace File to Analyze 
  1198.      Exiting the Performance Analyzer 
  1199.      Keys Help. 
  1200.  
  1201.  
  1202. ΓòÉΓòÉΓòÉ 11.1. Performance Analyzer - Window Manager Window File Menu ΓòÉΓòÉΓòÉ
  1203.  
  1204. The Performance Analyzer - Window Manager window File menu has the following 
  1205. choices: 
  1206.  
  1207.  Create Trace...     Displays the Create Trace window, which lets you start 
  1208.                      creating a trace file for your program. 
  1209.  Analyze Trace...    Displays the Analyze Trace window, which lets you open a 
  1210.                      diagram and start analyzing your program. 
  1211.  Exit Performance Analyzer Lets you end the Performance Analyzer application. 
  1212.  
  1213.  Related Information 
  1214.  
  1215.      Compiling and Linking Your Program 
  1216.      Executable Pop-up Menu 
  1217.      Trace File Pop-up Menu 
  1218.      Diagram Pop-up Menu 
  1219.      Create Trace Window 
  1220.      Analyze Trace Window 
  1221.      Keys Help 
  1222.      Exiting the Performance Analyzer 
  1223.      Performance Analyzer - Window Manager Window 
  1224.      Keys Help. 
  1225.  
  1226.  
  1227. ΓòÉΓòÉΓòÉ 11.1.1. Create Trace... Choice ΓòÉΓòÉΓòÉ
  1228.  
  1229. Select the Create trace... choice to start creating a trace file. This choice 
  1230. is available from the File menu on the Performance Analyzer - Window Manager 
  1231. window. 
  1232.  
  1233. Note:  Before creating a trace file, you must compile and link your program 
  1234. with the proper options. 
  1235.  
  1236. When you select this choice, the Create Trace window appears. On the Create 
  1237. Trace window, specify the program you want to trace and any parameters you want 
  1238. to pass to the program. 
  1239.  
  1240. You can also display the Create Trace window by: 
  1241.  
  1242.      Clicking mouse button two on an executable file name or icon, , in the 
  1243.       Performance Analyzer - Window Manager window, and then selecting Create 
  1244.       trace... from the Executable pop-up menu. 
  1245.      Clicking on the Create Trace... push button in the Performance Analyzer - 
  1246.       Window Manager window. 
  1247.  
  1248.  Related Information 
  1249.  
  1250.      Compiling and Linking Your Program 
  1251.      Create Trace Window 
  1252.      Creating a Customized Trace File 
  1253.      Performance Analyzer - Window Manager Window 
  1254.      Keys Help. 
  1255.  
  1256.  
  1257. ΓòÉΓòÉΓòÉ 11.1.2. Analyze Trace... Choice ΓòÉΓòÉΓòÉ
  1258.  
  1259. Select the Analyze trace... choice to start analyzing an existing trace file. 
  1260. This choice is available from the File menu on the Performance Analyzer - 
  1261. Window Manager window. 
  1262.  
  1263. When you select this choice, the Analyze Trace window appears. On the Analyze 
  1264. Trace window, specify the diagrams in which you want to display and analyze the 
  1265. trace file. 
  1266.  
  1267. You can also display the Analyze Trace window by: 
  1268.  
  1269.      Clicking mouse button two on the file name or icon, , of a trace file in 
  1270.       the Performance Analyzer - Window Manager window, and then selecting 
  1271.       Analyze trace... from the Trace file pop-up menu. 
  1272.      Clicking on the Analyze Trace... push button in the Performance Analyzer 
  1273.       - Window Manager window. 
  1274.  
  1275.  Related Information 
  1276.  
  1277.      Compiling and Linking Your Program 
  1278.      Analyze Trace Window 
  1279.      Call Nesting Diagram 
  1280.      Dynamic Call Graph 
  1281.      Execution Density diagram 
  1282.      Statistics Diagram 
  1283.      Time Line Diagram 
  1284.      Performance Analyzer - Window Manager Window 
  1285.      Keys Help. 
  1286.  
  1287.  
  1288. ΓòÉΓòÉΓòÉ 11.1.3. Exit the Performance Analyzer Choice ΓòÉΓòÉΓòÉ
  1289.  
  1290. Select the Exit the Performance Analyzer choice to end the Performance Analyzer 
  1291. application and close all associated windows. This choice is available from the 
  1292. File menu on the Performance Analyzer - Window Manager window. 
  1293.  
  1294. Related Information 
  1295.  
  1296.      Exiting the Performance Analyzer 
  1297.      Performance Analyzer - Window Manager Window 
  1298.      Keys Help. 
  1299.  
  1300.  
  1301. ΓòÉΓòÉΓòÉ 11.2. Performance Analyzer - Window Manager Window View Menu ΓòÉΓòÉΓòÉ
  1302.  
  1303. The Performance Analyzer - Window Manager window View menu has the following 
  1304. choices: 
  1305.  
  1306.  Tree lines          Displays tree lines on the Performance Analyzer - Window 
  1307.                      Manager window. 
  1308.  Show icons          Displays icons that identify file types on the Performance 
  1309.                      Analyzer - Window Manager window. 
  1310.  Remove all windows  Removes and closes all open diagrams from your screen. 
  1311.  
  1312.  Related Information 
  1313.  
  1314.      Introducing the Performance Analyzer 
  1315.      Selecting a Trace File to Analyze 
  1316.      Performance Analyzer - Window Manager Window 
  1317.      Keys Help. 
  1318.  
  1319.  
  1320. ΓòÉΓòÉΓòÉ 11.2.1. Tree Lines Choice ΓòÉΓòÉΓòÉ
  1321.  
  1322. Select the Tree lines choice to display directory tree lines. This choice is 
  1323. available from the View menu on the Performance Analyzer - Window Manager 
  1324. window. 
  1325.  
  1326. A check mark next to this choice indicates that it is selected. To remove tree 
  1327. lines, select the choice again. The check mark is removed to show the choice is 
  1328. disabled. 
  1329.  
  1330. Note:  The settings you enter are saved for the current session. If you want to 
  1331. save the settings for subsequent sessions, select the Options menu and then 
  1332. select the Save choice from the Settings cascaded menu. 
  1333.  
  1334. Related Information 
  1335.  
  1336.      Performance Analyzer - Window Manager Window 
  1337.      Keys Help. 
  1338.  
  1339.  
  1340. ΓòÉΓòÉΓòÉ 11.2.2. Show Icons Choice ΓòÉΓòÉΓòÉ
  1341.  
  1342. Select the Show icons choice to display icons that identify file types. This 
  1343. choice is available from the View menu on the Performance Analyzer - Window 
  1344. Manager window. A check beside this choice indicates that it is selected. To 
  1345. remove the icons, select the choice again. 
  1346.  
  1347. Icons identify file types as follows: 
  1348.  
  1349.  Icon      File Type 
  1350.            Executable 
  1351.  
  1352.  
  1353.            Trace file 
  1354.  
  1355.  
  1356.            Call Nesting diagram 
  1357.  
  1358.  
  1359.            Dynamic Call Graph 
  1360.  
  1361.  
  1362.            Execution Density diagram 
  1363.  
  1364.  
  1365.            Statistics diagram 
  1366.  
  1367.  
  1368.            Time Line diagram 
  1369.  
  1370.  Related Information 
  1371.  
  1372.      Introducing the Performance Analyzer 
  1373.      Selecting a Trace File to Analyze 
  1374.      Call Nesting Diagram 
  1375.      Dynamic Call Graph 
  1376.      Execution Density Diagram 
  1377.      Statistics Diagram 
  1378.      Time Line Diagram 
  1379.      Performance Analyzer - Window Manager Window 
  1380.      Keys Help. 
  1381.  
  1382.  
  1383. ΓòÉΓòÉΓòÉ 11.2.3. Remove All Windows Choice ΓòÉΓòÉΓòÉ
  1384.  
  1385. The Remove all windows choice removes and closes all diagram windows displayed 
  1386. on your screen and diagram file names displayed in the Performance Analyzer - 
  1387. Window Manager window. This choice is available from the View menu on the 
  1388. Performance Analyzer - Window Manager window. 
  1389.  
  1390. Related Information 
  1391.  
  1392.      Introducing the Performance Analyzer 
  1393.      Selecting a Trace File to Analyze 
  1394.      Performance Analyzer - Window Manager Window 
  1395.      Keys Help. 
  1396.  
  1397.  
  1398. ΓòÉΓòÉΓòÉ 11.3. Performance Analyzer - Window Manager Window Options Menu ΓòÉΓòÉΓòÉ
  1399.  
  1400. The Performance Analyzer - Window Manager window Options menu has the following 
  1401. choices: 
  1402.  
  1403.  Font...             Displays the Font window, which lets you change the font, 
  1404.                      font style, and font size for the windows. 
  1405.  Quick exit          Provides a fast way to exit the Performance Analyzer. 
  1406.  Search paths...     When you are working in the WorkFrame environment, this 
  1407.                      choice displays a window in which you can specify where 
  1408.                      the Performance Analyzer can locate source files for 
  1409.                      editing. 
  1410.  Unique trace file name This choice gives each trace file a different name, 
  1411.                      which allows you to save several trace files created from 
  1412.                      the same program. 
  1413.  Settings            Displays a cascaded menu that lets you save settings or 
  1414.                      restore initial default settings. 
  1415.  
  1416.  Related Information 
  1417.  
  1418.      Introducing the Performance Analyzer 
  1419.      Selecting a Trace File to Analyze 
  1420.      Performance Analyzer - Window Manager Window 
  1421.      Keys Help. 
  1422.  
  1423.  
  1424. ΓòÉΓòÉΓòÉ 11.3.1. Font... Choice ΓòÉΓòÉΓòÉ
  1425.  
  1426. Select the Font... choice to change the font, font style, and font size for the 
  1427. text area on the Performance Analyzer - Window Manager window. This choice is 
  1428. available from the Options menu on the Performance Analyzer - Window Manager 
  1429. window. When you select this choice, the Font window appears. 
  1430.  
  1431. The Font window has the following areas: 
  1432.  
  1433.  Name entry field      Type a font name in this entry field or click on the 
  1434.                        scroll bar on the right side of the entry field to see a 
  1435.                        list of choices and select a name from the list. 
  1436.  Size entry field      Type a font size in this entry field or click on the 
  1437.                        scroll bar on the right side of the entry field to see a 
  1438.                        list of choices and select a size from the list. 
  1439.  Style entry field     Type a font style in this entry field or click on the 
  1440.                        scroll bar on the right side of the entry field to see a 
  1441.                        list of choices and select a style from the list. 
  1442.  Emphasis check boxes  Click on one of these check boxes to outline, 
  1443.                        underscore, or strikeout text. 
  1444.  Sample box            This box shows a sample of how text will appear with the 
  1445.                        settings you have selected. 
  1446.  Ok push button        Changes the font according to the settings you selected. 
  1447.  Reset push button     Changes all font settings to the default settings. 
  1448.  Cancel push button    Closes the window without making changes. 
  1449.  
  1450.  Note:  The settings you enter are saved for the current session. If you want 
  1451.  to save the settings for subsequent sessions, select the Options menu and then 
  1452.  select the Save choice from the Settings cascaded menu. 
  1453.  
  1454.  Related Information 
  1455.  
  1456.      Performance Analyzer - Window Manager Window 
  1457.      Keys Help. 
  1458.  
  1459.  
  1460. ΓòÉΓòÉΓòÉ 11.3.2. Quick Exit Choice ΓòÉΓòÉΓòÉ
  1461.  
  1462. Select the Quick exit choice to close all open diagrams and exit the 
  1463. Performance Analyzer without a prompt to confirm that you want to exit the 
  1464. application. This choice is available from the Options menu on the Performance 
  1465. Analyzer - Window Manager window. 
  1466.  
  1467. Related Information 
  1468.  
  1469.      Introducing the Performance Analyzer 
  1470.      Selecting a Trace File to Analyze 
  1471.      Performance Analyzer - Window Manager Window 
  1472.      Keys Help. 
  1473.  
  1474.  
  1475. ΓòÉΓòÉΓòÉ 11.3.3. Search Paths... Choice ΓòÉΓòÉΓòÉ
  1476.  
  1477. When you are working in the WorkFrame environment, select the Search paths... 
  1478. choice to specify where the Performance Analyzer can locate source files for 
  1479. editing. This choice is available from the Options menu on the Performance 
  1480. Analyzer - Window Manager window. 
  1481.  
  1482. When you select this choice, the Search Paths window appears. 
  1483.  
  1484. Related Information 
  1485.  
  1486.      Search Paths Window 
  1487.      Edit Source Choice 
  1488.      Performance Analyzer - Window Manager Window 
  1489.      Starting the Performance Analyzer from WorkFrame 
  1490.      Keys Help. 
  1491.  
  1492.  
  1493. ΓòÉΓòÉΓòÉ 11.3.3.1. Search Paths Window ΓòÉΓòÉΓòÉ
  1494.  
  1495. Use the Search Paths window to specify where the Performance Analyzer can 
  1496. locate source files for editing. When you are working in the WorkFrame 
  1497. environment, this window appears when you select the Search Paths... choice, 
  1498. which is available from the Options menu on the Performance Analyzer - Window 
  1499. Manager window. 
  1500.  
  1501. To locate a source file for editing, the Performance Analyzer must first locate 
  1502. the executable containing the name of the source file. The Performance Analyzer 
  1503. searches the following paths (in the order listed) to locate an executable: 
  1504.  
  1505.    1. Path specified in the Locate Executable window 
  1506.    2. Path specified in the Search path for executable files: entry field of 
  1507.       the Search Paths window 
  1508.    3. Directory where the executable to be traced is located (if you selected 
  1509.       the Edit source choice from the Trace Generation window) or the directory 
  1510.       where the executable was located when the trace file was created (if you 
  1511.       selected the Edit function choice from one of the diagrams) 
  1512.    4. The current working directory 
  1513.    5. Path specified by the PATH environment variable. 
  1514.  
  1515.  To identify the name of the source file, the Performance Analyzer looks at the 
  1516.  debug information in the executable. The Performance Analyzer then searches 
  1517.  the following paths (in the order listed) to locate the source file: 
  1518.  
  1519.    1. Path specified in the Locate Source File window 
  1520.    2. Path specified in the Search path for source files: entry field of the 
  1521.       Search Paths window 
  1522.    3. Path specified in the compile statement (if provided) 
  1523.    4. Directory where the executable to be traced is located (if you selected 
  1524.       the Edit source choice from the Trace Generation window) or the directory 
  1525.       where the executable was located when the trace file was created (if you 
  1526.       selected the Edit function choice from one of the diagrams) 
  1527.    5. The current working directory 
  1528.    6. Path specified by the INCLUDE environment variable. 
  1529.  
  1530.  To use the Search Paths window: 
  1531.  
  1532.    1. In the Search path for executable files: entry field, specify a path that 
  1533.       you want the Performance Analyzer to use when looking for executable 
  1534.       files. 
  1535.    2. In the Search path for source files: entry field, specify a path that you 
  1536.       want the Performance Analyzer to use when looking for source files. 
  1537.    3. Select the appropriate push button to continue: 
  1538.           OK 
  1539.           Cancel 
  1540.           Help 
  1541.  
  1542.  Note:  The paths you enter are automatically saved for the current session. If 
  1543.  you want to save the paths for subsequent sessions, select the Save choice. 
  1544.  This choice is available from the Settings cascading choice, which is on the 
  1545.  Options menu. 
  1546.  
  1547.  Related Information 
  1548.  
  1549.      Edit Source Choice 
  1550.      Performance Analyzer - Window Manager Window 
  1551.      Starting the Performance Analyzer from WorkFrame 
  1552.      Keys Help. 
  1553.  
  1554.  
  1555. ΓòÉΓòÉΓòÉ 11.3.4. Unique Trace File Name Choice ΓòÉΓòÉΓòÉ
  1556.  
  1557. Select the Unique trace file name choice to have the Performance Analyzer give 
  1558. each trace file a unique name. This choice is available from the Options menu 
  1559. on the Performance Analyzer - Window Manager window. 
  1560.  
  1561. The default name for a trace file is myprog.trc, where myprog is the name of 
  1562. the program you are tracing. If you create more than one trace file from the 
  1563. same program, the Performance Analyzer uses the default naming convention and 
  1564. overwrites the previous trace file. 
  1565.  
  1566. However, if this choice is selected, the Performance Analyzer attaches a number 
  1567. to each file name. 
  1568.  
  1569. Select this choice to enable it. A check mark appears next to the choice to 
  1570. indicate that it is enabled. Select this choice again to disable it. 
  1571.  
  1572. Related Information 
  1573.  
  1574.      Introducing the Performance Analyzer 
  1575.      Selecting a Trace File to Analyze 
  1576.      Performance Analyzer - Window Manager Window 
  1577.      Keys Help. 
  1578.  
  1579.  
  1580. ΓòÉΓòÉΓòÉ 11.3.5. Settings Cascading Choice ΓòÉΓòÉΓòÉ
  1581.  
  1582. Select the Settings cascading choice to display the following choices: 
  1583.  
  1584.  Save                Saves the current window settings. 
  1585.  Restore initial defaults Restores the preset default settings. 
  1586.  This choice is available from the Options menu on the Performance Analyzer - 
  1587.  Window Manager window. 
  1588.  
  1589.  Related Information 
  1590.  
  1591.      Performance Analyzer - Window Manager Window 
  1592.      Keys Help. 
  1593.  
  1594.  
  1595. ΓòÉΓòÉΓòÉ 11.3.5.1. Save Choice ΓòÉΓòÉΓòÉ
  1596.  
  1597. Select the Save choice to save the current window settings for subsequent 
  1598. Performance Analyzer sessions. This choice is available from the Settings 
  1599. cascading choice, which is on the Options menu on the Trace Generation window. 
  1600.  
  1601. If you do not select this choice, settings remain active for the current 
  1602. session. If you select this choice, settings remain active for subsequent 
  1603. sessions because they are stored in the ICSPERF.INI file. The saved settings 
  1604. remain active until the ICSPERF.INI file is erased. 
  1605.  
  1606. The Performance Analyzer will save the following on the Performance Analyzer - 
  1607. Window Manager window: 
  1608.  
  1609.      Font settings 
  1610.      Paths specified in Search paths window 
  1611.      Quick exit setting 
  1612.      Show icons setting 
  1613.      Tree lines setting 
  1614.      Unique trace file name setting 
  1615.      Window position 
  1616.      Window size 
  1617.  
  1618.  To restore the default settings, select the Restore initial defaults 
  1619.  
  1620.  Related Information 
  1621.  
  1622.      Restore Initial Defaults Choice 
  1623.      Performance Analyzer - Window Manager Window 
  1624.      Keys Help. 
  1625.  
  1626.  
  1627. ΓòÉΓòÉΓòÉ 11.3.5.2. Restore Initial Defaults Choice ΓòÉΓòÉΓòÉ
  1628.  
  1629. Select the Restore initial defaults choice to restore the Performance Analyzer 
  1630. default settings for the Performance Analyzer - Window Manager window. This 
  1631. choice is available from the Settings cascading choice, which is on the Options 
  1632. menu on the Performance Analyzer - Window Manager window. 
  1633.  
  1634. Related Information 
  1635.  
  1636.      Performance Analyzer - Window Manager Window 
  1637.      Keys Help. 
  1638.  
  1639.  
  1640. ΓòÉΓòÉΓòÉ 11.4. Performance Analyzer - Window Manager Window Project Menu ΓòÉΓòÉΓòÉ
  1641.  
  1642. This menu appears on the Performance Analyzer - Window Manager window when you 
  1643. start the Performance Analyzer within the WorkFrame environment. The Project 
  1644. menu gives you direct access to all of the actions that you can perform from 
  1645. your current location. 
  1646.  
  1647. Related Information 
  1648.  
  1649.      Trace Generation Window 
  1650.      Starting the Performance Analyzer from WorkFrame 
  1651.      Keys Help. 
  1652.  
  1653.  
  1654. ΓòÉΓòÉΓòÉ 11.5. Performance Analyzer - Window Manager Window Help Menu ΓòÉΓòÉΓòÉ
  1655.  
  1656. Select choices from the Help menu to display the various types of Help 
  1657. information. 
  1658.  
  1659. The Help menu has the following choices: 
  1660.  
  1661.  Help index 
  1662.                      Displays an index of Help topics. 
  1663.  General help 
  1664.                      Displays Help for the active window. 
  1665.  Using help 
  1666.                      Describes how to use Help. 
  1667.  How do I? 
  1668.                      Displays task Help. 
  1669.  Product information 
  1670.                      Displays information about the Performance Analyzer. 
  1671.  
  1672.  Related Information 
  1673.  
  1674.      Introducing the Performance Analyzer 
  1675.      Selecting a Trace File to Analyze 
  1676.      Performance Analyzer - Window Manager Window 
  1677.      Keys Help. 
  1678.  
  1679.  
  1680. ΓòÉΓòÉΓòÉ 11.5.1. Help Index Choice ΓòÉΓòÉΓòÉ
  1681.  
  1682. Select the Help index choice to display an alphabetical index of Performance 
  1683. Analyzer Help topics. This choice is available from the Help menu on the 
  1684. Performance Analyzer - Window Manager window. 
  1685.  
  1686. Use the Previous push button to return to the last panel you viewed. Use the 
  1687. Search... push button to locate topics in the index. Use the Print... push 
  1688. button to print a topic. 
  1689.  
  1690. Related Information 
  1691.  
  1692.      Performance Analyzer - Window Manager Window 
  1693.      Keys Help. 
  1694.  
  1695.  
  1696. ΓòÉΓòÉΓòÉ 11.5.2. General Help Choice ΓòÉΓòÉΓòÉ
  1697.  
  1698. Select the General help choice to display Help information for the active 
  1699. window. This choice is available from the Help menu on the Performance Analyzer 
  1700. - Window Manager window. 
  1701.  
  1702. The online Help panel displayed is the same panel that is displayed when you 
  1703. place your cursor inside the window and press F1. 
  1704.  
  1705. Related Information 
  1706.  
  1707.      Performance Analyzer - Window Manager Window 
  1708.      Keys Help. 
  1709.  
  1710.  
  1711. ΓòÉΓòÉΓòÉ 11.5.3. Using Help Choice ΓòÉΓòÉΓòÉ
  1712.  
  1713. Select the Using help choice for a description of how to use the Help facility. 
  1714. This choice is available from the Help menu on the Performance Analyzer - 
  1715. Window Manager window. 
  1716.  
  1717. Related Information 
  1718.  
  1719.      Performance Analyzer - Window Manager Window 
  1720.      Keys Help. 
  1721.  
  1722.  
  1723. ΓòÉΓòÉΓòÉ 11.5.4. How Do I? Choice ΓòÉΓòÉΓòÉ
  1724.  
  1725. Select the How do I? choice to display the Performance Analyzer task help. This 
  1726. choice is available from the Help menu on the Performance Analyzer - Window 
  1727. Manager window. 
  1728.  
  1729. Related Information 
  1730.  
  1731.      Performance Analyzer - Window Manager Window 
  1732.      Keys Help. 
  1733.  
  1734.  
  1735. ΓòÉΓòÉΓòÉ <hidden> VisualAge C++ Help Menu Choices ΓòÉΓòÉΓòÉ
  1736.  
  1737. The central portion of the Help menu is dedicated to all the online 
  1738. documentation that is shipped with VisualAge C++. Making a selection from any 
  1739. of these cascaded menus launches the VisualAge C++ documentation associated 
  1740. with the menu item. You can find the same documentation in the Information 
  1741. folder found in the VisualAge C++ Desktop folder. 
  1742.  
  1743. The cascaded menus are organized as follows: 
  1744.  
  1745.  At A Glance  
  1746.            Provides general information on using VisualAge C++, such as what is 
  1747.            new in this release, the overall tutorial, a description of all the 
  1748.            sample programs, and answers to frequently asked questions. 
  1749.  
  1750.  Using VisualAge C++  
  1751.            Provides direct access to the individual sections of the User's 
  1752.            Guide. For example, if you are using the Browser, you would look in 
  1753.            the Browsing section for more information. 
  1754.  
  1755.  How Do I... Selections  
  1756.            Provides access to the How Do I... information for each component of 
  1757.            VisualAge C++. Use How Do I... information to find out how to 
  1758.            perform common tasks within VisualAge C++. 
  1759.  
  1760.  C/C++  
  1761.            Provides access to the information that is specific to programming 
  1762.            in C and C++. 
  1763.  
  1764.  Class Libraries  
  1765.            Provides access to the VisualAge C++ Open Class Library 
  1766.            documentation. 
  1767.  
  1768.  Visual Programming  
  1769.            Provides access to the information that is specific to creating your 
  1770.            programs visually. 
  1771.  
  1772.  OS/2, PM, and Graphics  
  1773.            Provides access to the documentation for the key aspects of OS/2, 
  1774.            Presentation Manager, and graphics programming. 
  1775.  
  1776.  IPF, REXX, and Editing  
  1777.            Provides access to the IPF, REXX and Editor references. 
  1778.  
  1779.  SOM and WorkPlace Shell  
  1780.            Provides access to the information specific to SOM and the WorkPlace 
  1781.            Shell. 
  1782.  
  1783.  Multimedia  
  1784.            Provides access to the information that is specific to creating 
  1785.            multimedia applications. 
  1786.  
  1787.  
  1788. ΓòÉΓòÉΓòÉ 11.5.5. Product Information Choice ΓòÉΓòÉΓòÉ
  1789.  
  1790. Select the Product information choice to display copyright and version 
  1791. information about the Performance Analyzer application. This choice is 
  1792. available from the Help menu on the Performance Analyzer - Window Manager 
  1793. window. 
  1794.  
  1795. Related Information 
  1796.  
  1797.      Performance Analyzer - Window Manager Window 
  1798.      Keys Help. 
  1799.  
  1800.  
  1801. ΓòÉΓòÉΓòÉ 11.6. Performance Analyzer - Window Manager Window Executable Pop-up Menu ΓòÉΓòÉΓòÉ
  1802.  
  1803. After you have created a trace file and selected a diagram in which to view it, 
  1804. the Performance Analyzer - Window Manager window displays a list of component 
  1805. file names, including your executable file, your trace file, and any open 
  1806. diagrams. If the Show icons choice is selected in the View menu, this icon, , 
  1807. is displayed next to each executable listed in the window. 
  1808.  
  1809. Click on the executable file name or icon to display the Executable pop-up 
  1810. menu. The choices listed in the pop-up menu are different if you click on 
  1811. another file type. 
  1812.  
  1813. The Performance Analyzer - Window Manager window Executable pop-up menu has the 
  1814. following choices: 
  1815.  
  1816.  Create trace...     Displays the window from which you can create a trace 
  1817.                      file. The file name on which you clicked appears in the 
  1818.                      window's Program Name entry field. 
  1819.  Close               Closes the selected executable, its associated trace file, 
  1820.                      and all diagrams in which the trace data is displayed. 
  1821.  
  1822.  Related Information 
  1823.  
  1824.      Introducing Performance Analyzer 
  1825.      Selecting a Trace File to Analyze 
  1826.      Exiting the Performance Analyzer 
  1827.      Performance Analyzer - Window Manager Window. 
  1828.  
  1829.  
  1830. ΓòÉΓòÉΓòÉ 11.6.1. Create Trace... Choice ΓòÉΓòÉΓòÉ
  1831.  
  1832. Select the Create trace... choice to start creating a trace file. This choice 
  1833. is available from the Executable pop-up menu on the Performance Analyzer - 
  1834. Window Manager window. 
  1835.  
  1836. When you select this choice, the Create Trace window appears. On the Create 
  1837. Trace window, specify the program you want to trace and any parameters you want 
  1838. to pass to the program. 
  1839.  
  1840. Note:  Before creating a trace file, you must compile and link your program 
  1841. with the proper options. 
  1842.  
  1843. Related Information 
  1844.  
  1845.      Compiling and Linking Your Program 
  1846.      Create Trace Window 
  1847.      Creating a Customized Trace File 
  1848.      Performance Analyzer - Window Manager Window 
  1849.      Keys Help. 
  1850.  
  1851.  
  1852. ΓòÉΓòÉΓòÉ 11.6.2. Close Choice ΓòÉΓòÉΓòÉ
  1853.  
  1854. Select the Close choice to close the selected executable, its trace file, and 
  1855. all diagrams in which the trace data is displayed. Only the Performance 
  1856. Analyzer - Window Manager window remains open. This choice is available from 
  1857. the Executable pop-up menu on the Performance Analyzer - Window Manager window. 
  1858.  
  1859. Related Information 
  1860.  
  1861.      Exiting the Performance Analyzer 
  1862.      Performance Analyzer - Window Manager Window 
  1863.      Keys Help. 
  1864.  
  1865.  
  1866. ΓòÉΓòÉΓòÉ 11.7. Performance Analyzer - Window Manager Window Trace File Pop-up Menu ΓòÉΓòÉΓòÉ
  1867.  
  1868. After you have created a trace file and selected a diagram in which to view it, 
  1869. the Performance Analyzer - Window Manager window displays a list of component 
  1870. file names, including your executable file, your trace file, and any open 
  1871. diagrams. If the Show icons choice is selected in the View menu, this icon, , 
  1872. is displayed next to each trace file listed in the window. 
  1873.  
  1874. Click on the trace file name or icon to display the Trace File pop-up menu. The 
  1875. choices listed in the pop-up menu are different if you click on another file 
  1876. type. 
  1877.  
  1878. The Performance Analyzer - Window Manager window Trace File pop-up menu has the 
  1879. following choices: 
  1880.  
  1881.  Analyze trace... 
  1882.            Displays the window from which you can select Performance Analyzer 
  1883.            diagrams to analyze the trace file. The file name on which you 
  1884.            clicked appears in the window's Trace File Name entry field. 
  1885.  Open as Call Nesting 
  1886.            Opens the Call Nesting diagram and displays the trace file in it. 
  1887.  Open as Dynamic Call Graph 
  1888.            Opens the Dynamic Call Graph and displays the trace file in it. 
  1889.  Open as Execution Density 
  1890.            Opens the Execution Density diagram and displays the trace file in 
  1891.            it. 
  1892.  Open as Statistics 
  1893.            Opens the Statistics diagram and displays the trace file in it. 
  1894.  Open as Time Line 
  1895.            Opens the Time Line diagram and displays the trace file in it. 
  1896.  Close 
  1897.            Closes the selected trace file and all diagrams in which the trace 
  1898.            file is displayed. 
  1899.  Delete File 
  1900.            Deletes the selected trace file from your hard disk if you select 
  1901.            Yes in the Trace File - Delete window (displayed when you select 
  1902.            this choice). 
  1903.  
  1904.  Related Information 
  1905.  
  1906.      Introducing the Performance Analyzer 
  1907.      Selecting a Trace File to Analyze 
  1908.      Performance Analyzer - Window Manager Window. 
  1909.  
  1910.  
  1911. ΓòÉΓòÉΓòÉ 11.7.1. Analyze Trace... Choice ΓòÉΓòÉΓòÉ
  1912.  
  1913. Select the Analyze trace... choice to analyze an existing trace file. This 
  1914. choice is available from the Trace file pop-up menu on the Performance Analyzer 
  1915. - Window Manager window. 
  1916.  
  1917. When you select this choice, the Analyze Trace window appears. 
  1918.  
  1919. Related Information 
  1920.  
  1921.      Performance Analyzer - Window Manager Window 
  1922.      Keys Help. 
  1923.  
  1924.  
  1925. ΓòÉΓòÉΓòÉ 11.7.2. Open As Call Nesting Choice ΓòÉΓòÉΓòÉ
  1926.  
  1927. Select the Open as Call Nesting choice to display the trace file in the Call 
  1928. Nesting diagram. This choice is available from the Trace file pop-up menu on 
  1929. the Performance Analyzer - Window Manager window. 
  1930.  
  1931. Related Information 
  1932.  
  1933.      Call Nesting Diagram 
  1934.      Performance Analyzer - Window Manager Window 
  1935.      Keys Help. 
  1936.  
  1937.  
  1938. ΓòÉΓòÉΓòÉ 11.7.3. Open As Dynamic Call Graph Choice ΓòÉΓòÉΓòÉ
  1939.  
  1940. Select the Open as Dynamic Call Graph choice to display the trace file in the 
  1941. Dynamic Call Graph. This choice is available from the Trace file pop-up menu on 
  1942. the Performance Analyzer - Window Manager window. 
  1943.  
  1944. Related Information 
  1945.  
  1946.      Keys Help. 
  1947.  
  1948.  
  1949. ΓòÉΓòÉΓòÉ 11.7.4. Open As Execution Density Choice ΓòÉΓòÉΓòÉ
  1950.  
  1951. Select the Open as Execution Density choice to display the trace file in the 
  1952. Execution Density diagram. This choice is available from the Trace file pop-up 
  1953. menu on the Performance Analyzer - Window Manager window. 
  1954.  
  1955. Related Information 
  1956.  
  1957.      Execution Density Diagram 
  1958.      Performance Analyzer - Window Manager Window 
  1959.      Keys Help. 
  1960.  
  1961.  
  1962. ΓòÉΓòÉΓòÉ 11.7.5. Open As Statistics Choice ΓòÉΓòÉΓòÉ
  1963.  
  1964. Select the Open as Statistics choice to display the trace file in the 
  1965. Statistics diagram. This choice is available from the Trace file pop-up menu on 
  1966. the Performance Analyzer - Window Manager window. 
  1967.  
  1968. Related Information 
  1969.  
  1970.      Statistics Diagram 
  1971.      Performance Analyzer - Window Manager Window 
  1972.      Keys Help. 
  1973.  
  1974.  
  1975. ΓòÉΓòÉΓòÉ 11.7.6. Open As Time Line Choice ΓòÉΓòÉΓòÉ
  1976.  
  1977. Select the Open as Time Line choice to display the trace file in the Time Line 
  1978. diagram. This choice is available from the Trace file pop-up menu on the 
  1979. Performance Analyzer - Window Manager window. 
  1980.  
  1981. Related Information 
  1982.  
  1983.      Time Line Diagram 
  1984.      Performance Analyzer - Window Manager Window 
  1985.      Keys Help. 
  1986.  
  1987.  
  1988. ΓòÉΓòÉΓòÉ 11.7.7. Close Choice ΓòÉΓòÉΓòÉ
  1989.  
  1990. Select the Close choice to close the selected trace file and all diagrams in 
  1991. which the trace data is displayed. Only the Performance Analyzer - Window 
  1992. Manager window remains open. This choice is available from the Trace file 
  1993. pop-up menu on the Performance Analyzer - Window Manager window. 
  1994.  
  1995. Related Information 
  1996.  
  1997.      Exiting the Performance Analyzer 
  1998.      Performance Analyzer - Window Manager Window 
  1999.      Keys Help. 
  2000.  
  2001.  
  2002. ΓòÉΓòÉΓòÉ 11.7.8. Delete File Choice ΓòÉΓòÉΓòÉ
  2003.  
  2004. When you select the Delete file choice, the trace file is deleted from the disk 
  2005. on which it is stored. This choice is available from the Trace file pop-up menu 
  2006. on the Performance Analyzer - Window Manager window. 
  2007.  
  2008. Related Information 
  2009.  
  2010.      Executable Pop-up Menu 
  2011.      Trace file Pop-up Menu 
  2012.      Performance Analyzer - Window Manager Window. 
  2013.  
  2014.  
  2015. ΓòÉΓòÉΓòÉ 11.8. Performance Analyzer - Window Manager Window Diagram Pop-up Menu ΓòÉΓòÉΓòÉ
  2016.  
  2017. After you have created a trace file and selected a diagram in which to view it, 
  2018. the Performance Analyzer - Window Manager window displays a list of component 
  2019. file names, including your executable file, your trace file, and any open 
  2020. diagrams. If the Show icons choice is selected in the View menu, an icon is 
  2021. displayed next to each diagram file name listed in the window. 
  2022.  
  2023. Click on the diagram file name or icon to display the Diagram pop-up menu. The 
  2024. choices listed in the pop-up menu are different if you click on another file 
  2025. type. 
  2026.  
  2027. The Performance Analyzer - Window Manager window Diagram pop-up menu has the 
  2028. following choices: 
  2029.  
  2030.  Display   Makes the selected diagram active and brings it to the foreground of 
  2031.            your desktop. 
  2032.  Close     Closes the selected diagram. 
  2033.  
  2034.  Related Information 
  2035.  
  2036.      Introducing the Performance Analyzer 
  2037.      Show Icons Choice 
  2038.      Analyze Trace Window 
  2039.      Selecting a Trace File to Analyze 
  2040.      Performance Analyzer - Window Manager Window. 
  2041.  
  2042.  
  2043. ΓòÉΓòÉΓòÉ 11.8.1. Display Choice ΓòÉΓòÉΓòÉ
  2044.  
  2045. When you select the Display choice, the Performance Analyzer makes the selected 
  2046. diagram active and brings it to the foreground of the desktop. This choice is 
  2047. available from the Diagram pop-up menu on the Performance Analyzer - Window 
  2048. Manager window. 
  2049.  
  2050. Related Information 
  2051.  
  2052.      Executable Pop-up Menu 
  2053.      Trace file Pop-up Menu 
  2054.      Performance Analyzer - Window Manager Window. 
  2055.  
  2056.  
  2057. ΓòÉΓòÉΓòÉ 11.8.2. Close Choice ΓòÉΓòÉΓòÉ
  2058.  
  2059. Select the Close choice to close the selected diagram. Only the Performance 
  2060. Analyzer - Window Manager window remains open. This choice is available from 
  2061. the Diagram pop-up menu on the Performance Analyzer - Window Manager window. 
  2062.  
  2063. Related Information 
  2064.  
  2065.      Exiting the Performance Analyzer 
  2066.      Performance Analyzer - Window Manager Window 
  2067.      Keys Help. 
  2068.  
  2069.  
  2070. ΓòÉΓòÉΓòÉ 12. Create Trace Window ΓòÉΓòÉΓòÉ
  2071.  
  2072. The Create Trace window lets you specify the name of the program that you want 
  2073. to trace and any parameters that you want to include in the trace. 
  2074.  
  2075. You can display the Create Trace window from the Performance Analyzer - Window 
  2076. Manager window by: 
  2077.  
  2078.      Clicking on the Create Trace... push button 
  2079.      Selecting the Create trace... choice from the File menu. 
  2080.      Clicking mouse button two on an executable file name or icon (if 
  2081.       displayed), and then selecting Create trace... from the pop-up menu. 
  2082.  
  2083.  Areas of the Create Trace Window 
  2084.  
  2085.      Program Name: Entry Field 
  2086.      Optional Entry Fields 
  2087.         -  Program Parameters: 
  2088.         -  Trace File Name: 
  2089.         -  Trace File Description: 
  2090.      Push Buttons 
  2091.         -  Find... 
  2092.         -  OK 
  2093.         -  Cancel 
  2094.         -  Help. 
  2095.  
  2096.  Related Information 
  2097.  
  2098.      Creating a Trace File 
  2099.      Performance Analyzer - Window Manager Window 
  2100.      Trace Generation Window 
  2101.      Keys Help. 
  2102.  
  2103.  
  2104. ΓòÉΓòÉΓòÉ 12.1. Program Name Entry Field ΓòÉΓòÉΓòÉ
  2105.  
  2106. Type the full path name and program you want to trace in the Program Name: 
  2107. entry field. This entry field is available on the Create Trace window. If the 
  2108. program is in your current directory, you do not have to type the path. 
  2109.  
  2110. Note:  If you are not sure where the file is located, select the Find... push 
  2111. button. 
  2112.  
  2113. Related Information 
  2114.  
  2115.      Creating a Trace File 
  2116.      Performance Analyzer - Window Manager Window 
  2117.      Trace Generation Window 
  2118.      Keys Help. 
  2119.  
  2120.  
  2121. ΓòÉΓòÉΓòÉ 12.2. Program Parameters Entry Field ΓòÉΓòÉΓòÉ
  2122.  
  2123. Type any parameters that you want to pass to your program in the Program 
  2124. Parameters: entry field. This entry field is available on the Create Trace 
  2125. window. 
  2126.  
  2127. Note:  This entry field is optional. 
  2128.  
  2129. Related Information 
  2130.  
  2131.      Creating a Trace File 
  2132.      Performance Analyzer - Window Manager Window 
  2133.      Trace Generation Window 
  2134.      Keys Help. 
  2135.  
  2136.  
  2137. ΓòÉΓòÉΓòÉ 12.3. Trace File Name Entry Field ΓòÉΓòÉΓòÉ
  2138.  
  2139. Type the name of the path and trace file in the Trace File Name: entry field. 
  2140. This entry field is available on the Create Trace window. 
  2141.  
  2142. The default name for the trace file is myprog.trc, where myprog is the name of 
  2143. the program you are tracing. 
  2144.  
  2145. The Performance Analyzer places the trace file in the current directory unless 
  2146. you specify a path. 
  2147.  
  2148. Note:  This entry field is optional. 
  2149.  
  2150. Related Information 
  2151.  
  2152.      Creating a Trace File 
  2153.      Creating a Customized Trace File 
  2154.      Unique trace file name 
  2155.      Performance Analyzer - Window Manager Window 
  2156.      Trace Generation Window 
  2157.      Keys Help. 
  2158.  
  2159.  
  2160. ΓòÉΓòÉΓòÉ 12.4. Trace File Description Entry Field ΓòÉΓòÉΓòÉ
  2161.  
  2162. Type any comments that you want to make about your trace in the Trace File 
  2163. Description: entry field. This entry field is available on the Create Trace 
  2164. window. 
  2165.  
  2166. A description can make a trace file easier to identify, especially when you 
  2167. create more than one trace file from the same program and use different options 
  2168. for each trace. The description is displayed in the Status Area of any open 
  2169. diagram. 
  2170.  
  2171. Note:  This entry field is optional. 
  2172.  
  2173. Related Information 
  2174.  
  2175.      Creating a Trace File 
  2176.      Creating a Customized Trace File 
  2177.      Unique trace file name 
  2178.      Performance Analyzer - Window Manager Window 
  2179.      Trace Generation Window 
  2180.      Keys Help. 
  2181.  
  2182.  
  2183. ΓòÉΓòÉΓòÉ 13. Analyze Trace Window ΓòÉΓòÉΓòÉ
  2184.  
  2185. The Analyze Trace window lets you specify the name of the trace file that you 
  2186. want to analyze and the Performance Analyzer diagrams in which you want to 
  2187. display it. 
  2188.  
  2189. Note:  A trace file must have been created before you can open a diagram. See 
  2190. Creating a Trace File for instructions. 
  2191.  
  2192. You can display the Analyze Trace window from the Performance Analyzer - Window 
  2193. Manager window by: 
  2194.  
  2195.      Clicking on the Analyze Trace... push button 
  2196.      Selecting the Analyze trace... choice from the File menu. 
  2197.      Click mouse button two on a trace file name or icon (if displayed), and 
  2198.       then selecting Analyze trace... from the pop-up menu. 
  2199.  
  2200.  Areas of the Analyze Trace Window 
  2201.  
  2202.      Trace File Name: Entry Field 
  2203.      Diagrams Check Boxes 
  2204.         -  Call Nesting 
  2205.         -  Dynamic Call Graph 
  2206.         -  Execution Density 
  2207.         -  Statistics 
  2208.         -  Time Line 
  2209.      Push Buttons 
  2210.         -  Find... 
  2211.         -  OK 
  2212.         -  Cancel 
  2213.         -  Help. 
  2214.  
  2215.  Related Information 
  2216.  
  2217.      Call Nesting Diagram 
  2218.      Dynamic Call Graph 
  2219.      Execution Density Diagram 
  2220.      Statistics Diagram 
  2221.      Time Line Diagram 
  2222.      Performance Analyzer - Window Manager Window 
  2223.      Keys Help. 
  2224.  
  2225.  
  2226. ΓòÉΓòÉΓòÉ 13.1. Trace File Name Entry Field ΓòÉΓòÉΓòÉ
  2227.  
  2228. Type the full path and file name of the trace file that you want to analyze in 
  2229. the Trace File Name: entry field. This entry field is available on the Analyze 
  2230. Trace window. 
  2231.  
  2232. If the program is in your current directory, you do not have to type the path. 
  2233.  
  2234. Note:  If you are not sure where the file is located, select the Find... push 
  2235. button. 
  2236.  
  2237.  
  2238. ΓòÉΓòÉΓòÉ 14. Trace Generation Window ΓòÉΓòÉΓòÉ
  2239.  
  2240. The Trace Generation window lists the file names of the preloaded components in 
  2241. the program and lets you control which parts of your program are traced. 
  2242.  
  2243. A component can be an executable file, a dynamic load library (DLL) file, an 
  2244. object file, or a function. EXE and DLL files contain object files, and object 
  2245. files contain functions. 
  2246.  
  2247. Click on the plus and minus icons to expand and contract EXE, DLL, and object 
  2248. files to view or hide components. 
  2249.  
  2250. Note:  Before creating a trace file, you must compile and link your program 
  2251. with the proper options. 
  2252.  
  2253. Areas of the Trace Generation Window 
  2254.  
  2255.      Menu Bar Summary 
  2256.         -  Application 
  2257.         -  Edit 
  2258.         -  View 
  2259.         -  Options 
  2260.         -  Project (only available when working in the WorkFrame environment) 
  2261.         -  Help 
  2262.      Pop-up Menus 
  2263.         -  Executable 
  2264.         -  Object File 
  2265.         -  Function 
  2266.      Push Button 
  2267.         -  Trace. 
  2268.  
  2269.  Related Information 
  2270.  
  2271.      Compiling and Linking Your Program 
  2272.      Creating a Trace File 
  2273.      Creating a Customized Trace File 
  2274.      Keys Help. 
  2275.  
  2276.  
  2277. ΓòÉΓòÉΓòÉ 14.1. Trace Generation Window Application Menu ΓòÉΓòÉΓòÉ
  2278.  
  2279. The Trace Generation window Application menu has the following choices: 
  2280.  
  2281.  Window manager      Makes the Performance Analyzer - Window Manager window 
  2282.                      active. 
  2283.  Exit Performance Analyzer Lets you end the Performance Analyzer application. 
  2284.  
  2285.  Related Information 
  2286.  
  2287.      Trace Generation Window 
  2288.      Keys Help. 
  2289.  
  2290.  
  2291. ΓòÉΓòÉΓòÉ 14.1.1. Window Manager Choice ΓòÉΓòÉΓòÉ
  2292.  
  2293. Makes the Performance Analyzer - Window Manager window active and brings it to 
  2294. the foreground of your desktop. This choice is available from the Application 
  2295. menu on the Trace Generation window. 
  2296.  
  2297. Related Information 
  2298.  
  2299.      Trace Generation Window 
  2300.      Keys Help. 
  2301.  
  2302.  
  2303. ΓòÉΓòÉΓòÉ 14.1.2. Exit the Performance Analyzer Choice ΓòÉΓòÉΓòÉ
  2304.  
  2305. Select the Exit the Performance Analyzer choice to end the Performance Analyzer 
  2306. application and close all associated windows. This choice is available from the 
  2307. Application menu on the Trace Generation window. 
  2308.  
  2309. Related Information 
  2310.  
  2311.      Exiting the Performance Analyzer 
  2312.      Trace Generation Window 
  2313.      Keys Help. 
  2314.  
  2315.  
  2316. ΓòÉΓòÉΓòÉ 14.2. Trace Generation Window Edit Menu ΓòÉΓòÉΓòÉ
  2317.  
  2318. The Trace Generation window Edit menu has the following choices: 
  2319.  
  2320. Note:  This is a dynamic menu that displays choices based on the type of 
  2321. component selected. 
  2322.  
  2323.  Enable all executables 
  2324.                      Enables all functions in all executable files. 
  2325.  Disable all executables 
  2326.                      Disables all functions in all executable files. 
  2327.  Enable executable 
  2328.                      Enables all functions in a selected executable file. This 
  2329.                      choice is available when you select a disabled executable. 
  2330.  Disable executable 
  2331.                      Disables all functions in a selected executable file. This 
  2332.                      choice is available when you select an enabled executable. 
  2333.  Enable object file 
  2334.                      Enables all functions in a selected object file. This 
  2335.                      choice is available when you select a disabled object 
  2336.                      file. 
  2337.  Disable object file 
  2338.                      Disables all functions in a selected object file. This 
  2339.                      choice is available when you select an enabled object 
  2340.                      file. 
  2341.  Enable function 
  2342.                      Enables a function. This choice is available when you 
  2343.                      select a disabled function. 
  2344.  Disable function 
  2345.                      Disables a function. This choice is available when you 
  2346.                      select an enabled function. 
  2347.  Set trigger 
  2348.                      Sets a trigger on a function so that the Performance 
  2349.                      Analyzer traces the function and its associated calls. 
  2350.                      This choice is available when you select a function that 
  2351.                      does not have a trigger set on it. 
  2352.  
  2353.                      Note:  If triggers are set, the Performance Analyzer 
  2354.                      traces all enabled components and only those functions on 
  2355.                      which triggers are set. If no triggers are set, the 
  2356.                      Performance Analyzer traces all enabled components. 
  2357.  Remove trigger 
  2358.                      Removes a trigger on a function so that the Performance 
  2359.                      Analyzer does not trace the function and its associated 
  2360.                      calls. This choice is available when you select a function 
  2361.                      that has a trigger set on it. 
  2362.  
  2363.                      Note:  If triggers are set, the Performance Analyzer 
  2364.                      traces all enabled components and only those functions on 
  2365.                      which triggers are set. If no triggers are set, the 
  2366.                      Performance Analyzer traces all enabled components. 
  2367.  
  2368.  Related Information 
  2369.  
  2370.      Executable Pop-up Menu 
  2371.      Object File Pop-up Menu 
  2372.      Function Pop-up Menu 
  2373.      Trace Generation Window 
  2374.      Keys Help. 
  2375.  
  2376.  
  2377. ΓòÉΓòÉΓòÉ 14.2.1. Enable All Executables Choice ΓòÉΓòÉΓòÉ
  2378.  
  2379. Select the Enable all executables choice to enable all functions in all 
  2380. executable files. This choice is available from the Edit menu on the Trace 
  2381. Generation window. 
  2382.  
  2383. When you enable executables, the Performance Analyzer includes information 
  2384. about them in the trace file. 
  2385.  
  2386. The default is to enable all components that have been compiled and linked with 
  2387. the proper options. 
  2388.  
  2389. To enable all executables, select Enable all executables from the Edit menu. 
  2390.  
  2391. Related Information 
  2392.  
  2393.      Disable All Executables Choice 
  2394.      Executable Pop-up Menu 
  2395.      Object file Pop-up Menu 
  2396.      Function Pop-up Menu 
  2397.      Trace Generation Window 
  2398.      Keys Help. 
  2399.  
  2400.  
  2401. ΓòÉΓòÉΓòÉ 14.2.2. Disable All Executables Choice ΓòÉΓòÉΓòÉ
  2402.  
  2403. Select the Disable all executables choice to disable all functions in all 
  2404. executable files. This choice is available from the Edit menu on the Trace 
  2405. Generation window. 
  2406.  
  2407. When you disable executables, the Performance Analyzer does not include 
  2408. information about them in the trace file. 
  2409.  
  2410. The default is to enable all components that have been compiled and linked with 
  2411. the proper options. 
  2412.  
  2413. Related Information 
  2414.  
  2415.      Enable All Executables Choice 
  2416.      Executable Pop-up Menu 
  2417.      Object file Pop-up Menu 
  2418.      Function Pop-up Menu 
  2419.      Trace Generation Window 
  2420.      Keys Help. 
  2421.  
  2422.  
  2423. ΓòÉΓòÉΓòÉ 14.2.3. Enable Executable Choice ΓòÉΓòÉΓòÉ
  2424.  
  2425. Select the Enable executable choice to enable all functions in a selected 
  2426. executable file. This choice is available from the Edit menu and the Executable 
  2427. pop-up menu on the Trace Generation window. You can select this choice when a 
  2428. disabled executable is selected. 
  2429.  
  2430. When you enable an executable, the Performance Analyzer includes information 
  2431. about the executable in the trace file. 
  2432.  
  2433. The default is to enable all components that have been compiled and linked with 
  2434. the proper options. 
  2435.  
  2436. Enable an executable in any of the following ways: 
  2437.  
  2438.      Click on the file name or icon of the executable you want to enable. Then 
  2439.       select Enable executable from the Edit menu. 
  2440.      Double-click on the file name or icon of the executable you want to 
  2441.       enable. 
  2442.      Click mouse button two on the file name or icon of the executable you 
  2443.       want to enable. Then select Enable executable from the Executable pop-up 
  2444.       menu. 
  2445.  
  2446.  Note 
  2447.  
  2448.  If the icon next to a component is: 
  2449.  
  2450.      Green (it also has no slash mark), the component is enabled. 
  2451.      Red (it also has a slash mark), the component is disabled. 
  2452.      White, the component cannot be traced. 
  2453.  
  2454.  Related Information 
  2455.  
  2456.      Disable Executable Choice 
  2457.      Executable Pop-up Menu 
  2458.      Object file Pop-up Menu 
  2459.      Function Pop-up Menu 
  2460.      Trace Generation Window 
  2461.      Keys Help. 
  2462.  
  2463.  
  2464. ΓòÉΓòÉΓòÉ 14.2.4. Disable Executable Choice ΓòÉΓòÉΓòÉ
  2465.  
  2466. Select the Disable executable choice to disable all functions in a selected 
  2467. executable file. This choice is available from the Edit menu and the Executable 
  2468. pop-up menu on the Trace Generation window. You can select this choice when an 
  2469. enabled executable is selected. 
  2470.  
  2471. When you disable an executable, the Performance Analyzer does not include 
  2472. information about the executable in the trace file. 
  2473.  
  2474. The default is to enable all components that have been compiled and linked with 
  2475. the proper options. 
  2476.  
  2477. Disable an executable in any of the following ways: 
  2478.  
  2479.      Click on the file name or icon of the executable you want to disable. 
  2480.       Then select Disable executable from the Edit menu. 
  2481.      Double-click on the file name or icon of the executable you want to 
  2482.       enable. 
  2483.      Click mouse button two on the file name or icon of the executable you 
  2484.       want to disable. Then select Disable executable from the Executable 
  2485.       pop-up menu. 
  2486.  
  2487.  Note:  If the icon next to a component is: 
  2488.  
  2489.      Green (it also has no slash mark), the component is enabled. 
  2490.      Red (it also has a slash mark), the component is disabled. 
  2491.      White, the component cannot be traced. 
  2492.  
  2493.  Related Information 
  2494.  
  2495.      Enable Executable Choice 
  2496.      Executable Pop-up Menu 
  2497.      Object file Pop-up Menu 
  2498.      Function Pop-up Menu 
  2499.      Trace Generation Window 
  2500.      Keys Help. 
  2501.  
  2502.  
  2503. ΓòÉΓòÉΓòÉ 14.2.5. Enable Object File Choice ΓòÉΓòÉΓòÉ
  2504.  
  2505. Select the Enable object file choice to enable all functions in a selected 
  2506. object file. This choice is available from the Edit menu and the Object file 
  2507. pop-up menu on the Trace Generation window. You can select this choice when a 
  2508. disabled object file is selected. 
  2509.  
  2510. When you enable an object file, the Performance Analyzer includes information 
  2511. about the object in the trace file. 
  2512.  
  2513. The default is to enable all components that have been compiled and linked with 
  2514. the proper options. 
  2515.  
  2516. Enable an object file in any of the following ways: 
  2517.  
  2518.      Click on the file name or icon of the object file you want to enable. 
  2519.       Then select Enable object file from the Edit menu. 
  2520.      Double-click on the file name or icon of the object file you want to 
  2521.       enable. 
  2522.      Click mouse button two on the file name or icon of the object file you 
  2523.       want to enable. Then select Enable object file from the Object file 
  2524.       pop-up menu. 
  2525.  
  2526.  Note:  If the icon next to a component is: 
  2527.  
  2528.      Green (it also has no slash mark), the component is enabled. 
  2529.      Red (it also has a slash mark), the component is disabled. 
  2530.      White, the component cannot be traced. 
  2531.  
  2532.  Related Information 
  2533.  
  2534.      Disable Object File Choice 
  2535.      Executable Pop-up Menu 
  2536.      Object file Pop-up Menu 
  2537.      Function Pop-up Menu 
  2538.      Trace Generation Window 
  2539.      Keys Help. 
  2540.  
  2541.  
  2542. ΓòÉΓòÉΓòÉ 14.2.6. Disable Object File Choice ΓòÉΓòÉΓòÉ
  2543.  
  2544. Select the Disable object file choice to disable all functions in a selected 
  2545. object file. This choice is available from the Edit menu and the Object file 
  2546. pop-up menu on the Trace Generation window. You can select this choice when an 
  2547. enabled object file is selected. 
  2548.  
  2549. When you disable an object file, the Performance Analyzer does not include 
  2550. information about the object in the trace file. 
  2551.  
  2552. The default is to enable all components that have been compiled and linked with 
  2553. the proper options. 
  2554.  
  2555. Disable an object file in any of the following ways: 
  2556.  
  2557.      Click on the file name or icon of the object file you want to disable. 
  2558.       Then select Disable object file from the Edit menu. 
  2559.      Double-click on the file name or icon of the object file you want to 
  2560.       disable. 
  2561.      Click mouse button two on the file name or icon of the object file you 
  2562.       want to disable. Then select Disable object file from the Object file 
  2563.       pop-up menu. 
  2564.  
  2565.  Note:  If the icon next to a component is: 
  2566.  
  2567.      Green (it also has no slash mark), the component is enabled. 
  2568.      Red (it also has a slash mark), the component is disabled. 
  2569.      White, the component cannot be traced. 
  2570.  
  2571.  Related Information 
  2572.  
  2573.      Enable Object File Choice 
  2574.      Executable Pop-up Menu 
  2575.      Object file Pop-up Menu 
  2576.      Function Pop-up Menu 
  2577.      Trace Generation Window 
  2578.      Keys Help. 
  2579.  
  2580.  
  2581. ΓòÉΓòÉΓòÉ 14.2.7. Enable Function Choice ΓòÉΓòÉΓòÉ
  2582.  
  2583. Select the Enable function choice to enable a function. This choice is 
  2584. available from the Edit menu and the Function pop-up menu on the Trace 
  2585. Generation window. You can select this choice when a disabled function is 
  2586. selected. 
  2587.  
  2588. When you enable a function, the Performance Analyzer includes information about 
  2589. the function in the trace file. 
  2590.  
  2591. The default is to enable all components that have been compiled and linked with 
  2592. the proper options. 
  2593.  
  2594. Enable a function in any of the following ways: 
  2595.  
  2596.      Click on the name or icon of the function you want to enable. Then select 
  2597.       Enable function from the Edit menu. 
  2598.      Double-click on the name or icon of the function you want to enable. 
  2599.      Click mouse button two on the file name or icon of the function you want 
  2600.       to enable. Then select Enable function from the Function pop-up menu. 
  2601.  
  2602.  Note:  If the icon next to a component is: 
  2603.  
  2604.      Green (it also has no slash mark), the component is enabled. 
  2605.      Red (it also has a slash mark), the component is disabled. 
  2606.      White, the component cannot be traced. 
  2607.  
  2608.  Related Information 
  2609.  
  2610.      Disable Function Choice 
  2611.      Executable Pop-up Menu 
  2612.      Object file Pop-up Menu 
  2613.      Function Pop-up Menu 
  2614.      Trace Generation Window 
  2615.      Keys Help. 
  2616.  
  2617.  
  2618. ΓòÉΓòÉΓòÉ 14.2.8. Disable Function Choice ΓòÉΓòÉΓòÉ
  2619.  
  2620. Select the Disable function choice to disable a function. This choice is 
  2621. available from the Edit menu and the Function pop-up menu on the Trace 
  2622. Generation window. You can select this choice when an enabled function is 
  2623. selected. 
  2624.  
  2625. When you disable a function, the Performance Analyzer does not include 
  2626. information about the function in the trace file. 
  2627.  
  2628. The default is to enable all components that have been compiled and linked with 
  2629. the proper options. 
  2630.  
  2631. Disable a function in any of the following ways: 
  2632.  
  2633.      Click on the name or icon of the function you want to disable. Then 
  2634.       select Disable function from the Edit menu. 
  2635.      Double-click on the name or icon of the function you want to disable. 
  2636.      Click mouse button two on the file name or icon of the function you want 
  2637.       to disable. Then select Disable function from the Function pop-up menu. 
  2638.  
  2639.  Note:  If the icon next to a component is: 
  2640.  
  2641.      Green (it also has no slash mark), the component is enabled. 
  2642.      Red (it also has a slash mark), the component is disabled. 
  2643.      White, the component cannot be traced. 
  2644.  
  2645.  Related Information 
  2646.  
  2647.      Enable Function Choice 
  2648.      Executable Pop-up Menu 
  2649.      Object file Pop-up Menu 
  2650.      Function Pop-up Menu 
  2651.      Trace Generation Window 
  2652.      Keys Help. 
  2653.  
  2654.  
  2655. ΓòÉΓòÉΓòÉ 14.2.9. Set Trigger Choice ΓòÉΓòÉΓòÉ
  2656.  
  2657. Select the Set trigger choice to set a trigger on a function. This choice is 
  2658. available from the Edit menu and the Function pop-up menu on the Trace 
  2659. Generation window. You can select this choice when a function is selected. You 
  2660. select a function by clicking on the file name or icon of the function in the 
  2661. Trace Generation window. 
  2662.  
  2663. A trigger turns tracing on when it is called and then turns tracing off when it 
  2664. returns. By setting triggers to start or stop tracing at selected points in 
  2665. your program, you can control the size of your trace file. For more information 
  2666. on controlling the size of your trace file, see Creating a Customized Trace 
  2667. File. 
  2668.  
  2669. The Performance Analyzer allows you to set multiple triggers. If a trigger 
  2670. function is nested within another trigger function, tracing is turned off only 
  2671. after the outer function returns. 
  2672.  
  2673. Notes 
  2674.  
  2675.      When a trigger is set on a function inside an object file, only that 
  2676.       function and its children log events in the object file. To receive trace 
  2677.       data about other functions in the object file, you can set triggers on 
  2678.       multiple functions. 
  2679.      If triggers are set, the Performance Analyzer traces all enabled 
  2680.       components and only those functions on which triggers are set. If no 
  2681.       triggers are set, the Performance Analyzer traces all enabled components. 
  2682.  
  2683.  Set a trigger in either of the following ways: 
  2684.  
  2685.    1. Method One 
  2686.         a. On the Trace Generation window, select the function you want to 
  2687.            trigger. 
  2688.         b. Select the Set trigger choice from the Edit menu. The letter T 
  2689.            appears in the icon next to the function name. 
  2690.    2. Method Two 
  2691.         a. On the Trace Generation window, click mouse button two on the 
  2692.            function you want to trigger or the icon next to it. 
  2693.         b. Click on the Set trigger choice in the Function pop-up menu. 
  2694.  
  2695.  Related Information 
  2696.  
  2697.      Setting and Removing Triggers 
  2698.      Remove Trigger Choice 
  2699.      Function Pop-up Menu 
  2700.      Trace Generation Window 
  2701.      Keys Help. 
  2702.  
  2703.  
  2704. ΓòÉΓòÉΓòÉ 14.2.10. Remove Trigger Choice ΓòÉΓòÉΓòÉ
  2705.  
  2706. Select the Remove trigger choice to remove a trigger that has been set on a 
  2707. function. This choice is available from the Edit menu and the Function pop-up 
  2708. menu on the Trace Generation window. 
  2709.  
  2710. You can select this choice when a function on which a trigger has been set is 
  2711. selected. You select a function by clicking on the function name or icon in the 
  2712. Trace Generation window. 
  2713.  
  2714. A trigger turns tracing on when it is called and then turns tracing off when it 
  2715. returns. By setting triggers to start or stop tracing at selected points in 
  2716. your program, you can control the size of your trace file. For more information 
  2717. on controlling the size of your trace file, see Creating a Customized Trace 
  2718. File. 
  2719.  
  2720. The Performance Analyzer allows you to set multiple triggers. If a trigger 
  2721. function is nested within another trigger function, tracing is turned off only 
  2722. after the outer function returns. 
  2723.  
  2724. Note:  If triggers are set, the Performance Analyzer traces all enabled 
  2725. components and only those functions on which triggers are set. If no triggers 
  2726. are set, the Performance Analyzer traces all enabled components. 
  2727.  
  2728. Remove a trigger in either of the following ways: 
  2729.  
  2730.    1. Method One 
  2731.         a. Select a function on which a trigger has been set. A function that 
  2732.            has a trigger has the letter T in the icon next to its function name 
  2733.            in the Trace Generation window. 
  2734.         b. Select the Remove trigger choice from the Edit menu. The T is 
  2735.            removed from the icon next to the function name. 
  2736.    2. Method Two 
  2737.         a. Select a function on which a trigger has been set by clicking mouse 
  2738.            button two on the function name or the icon next to it in the Trace 
  2739.            Generation window. 
  2740.         b. Click on the Remove trigger choice in the Function pop-up menu. 
  2741.  
  2742.  Related Information 
  2743.  
  2744.      Setting and Removing Triggers 
  2745.      Set Trigger Choice 
  2746.      Function Pop-up Menu 
  2747.      Trace Generation Window 
  2748.      Keys Help. 
  2749.  
  2750.  
  2751. ΓòÉΓòÉΓòÉ 14.3. Trace Generation Window View Menu ΓòÉΓòÉΓòÉ
  2752.  
  2753. The Trace Generation window View menu has the following choices: 
  2754.  
  2755.  Traceable filter 
  2756.            Displays only the components that are traceable. 
  2757.  Tree lines 
  2758.            Displays lines between file names to show relationships. 
  2759.  
  2760.  Related Information 
  2761.  
  2762.      Trace Generation Window 
  2763.      Keys Help. 
  2764.  
  2765.  
  2766. ΓòÉΓòÉΓòÉ 14.3.1. Traceable Filter Choice ΓòÉΓòÉΓòÉ
  2767.  
  2768. Select the Traceable filter choice to view only the components that are 
  2769. traceable. This choice is available from the View menu on the Trace Generation 
  2770. window. 
  2771.  
  2772. To filter the traceable components, select Traceable filter from the View menu. 
  2773. A check mark is displayed next to the choice to show it is enabled. 
  2774.  
  2775. To reset the filter, select Traceable filter from the View menu. The check mark 
  2776. is removed to show the choice is disabled. 
  2777.  
  2778. Note:  The settings you enter are saved for the current session. If you want to 
  2779. save the settings for subsequent sessions, select the Options menu and then 
  2780. select the Save choice from the Settings cascaded menu. 
  2781.  
  2782. Related Information 
  2783.  
  2784.      Trace Generation Window 
  2785.      Keys Help. 
  2786.  
  2787.  
  2788. ΓòÉΓòÉΓòÉ 14.3.2. Tree Lines Choice ΓòÉΓòÉΓòÉ
  2789.  
  2790. Select the Tree lines choice to display directory tree lines. This choice is 
  2791. available from the View menu on the Trace Generation window. 
  2792.  
  2793. A check mark next to this choice indicates that it is selected. To remove tree 
  2794. lines, select the choice again. The check mark is removed to show the choice is 
  2795. disabled. 
  2796.  
  2797. Note:  The settings you enter are saved for the current session. If you want to 
  2798. save the settings for subsequent sessions, select the Options menu and then 
  2799. select the Save choice from the Settings cascaded menu. 
  2800.  
  2801. Related Information 
  2802.  
  2803.      Trace Generation Window 
  2804.      Keys Help. 
  2805.  
  2806.  
  2807. ΓòÉΓòÉΓòÉ 14.4. Trace Generation Window Options Menu ΓòÉΓòÉΓòÉ
  2808.  
  2809. Select choices from the Options menu to customize your trace sessions. 
  2810.  
  2811. The Trace Generation window Options menu has the following choices: 
  2812.  
  2813.  Buffer control... 
  2814.            Select the size of the event log buffer, and enable and disable 
  2815.            buffer wrapping. 
  2816.  Call depth... 
  2817.            Select the call depth limit for each thread. 
  2818.  File access 
  2819.            Select to trace or not trace file accesses. 
  2820.  Font... 
  2821.            Displays the Font window, which lets you change the font, font 
  2822.            style, and font size for the Trace Generation window. 
  2823.  Name trace file... 
  2824.            Type a new path or rename the trace file for the program you are 
  2825.            analyzing and change the trace file description. 
  2826.  Timeout control... 
  2827.            Select the maximum number of seconds your program may run without 
  2828.            logging events. Use this choice when your program is in a continuous 
  2829.            loop or deadlock. 
  2830.  Time stamp events 
  2831.            Select to log or not log time stamps. 
  2832.  Settings 
  2833.            Displays a cascaded menu that lets you save settings or restore 
  2834.            initial default settings. 
  2835.  
  2836.  Related Information 
  2837.  
  2838.      Trace Generation Window 
  2839.      Keys Help. 
  2840.  
  2841.  
  2842. ΓòÉΓòÉΓòÉ 14.4.1. Buffer Control... Choice ΓòÉΓòÉΓòÉ
  2843.  
  2844. Select the Buffer control... choice to set the size of the event log buffer, 
  2845. and to enable or disable buffer wrapping. This choice is available from the 
  2846. Options menu on the Trace Generation window. 
  2847.  
  2848. The event log buffer size determines how often the data from the trace analysis 
  2849. is written to the trace file. The default is set to 256 kilobytes (KB). 
  2850.  
  2851. You can enable or disable buffer wrapping to choose when the data is written to 
  2852. the trace file. The default is to disable buffer wrapping. 
  2853.  
  2854. When you select Buffer control..., a Buffer Control window appears. 
  2855.  
  2856. Related Information 
  2857.  
  2858.      Creating a Customized Trace File 
  2859.      Trace Generation Window 
  2860.      Keys Help. 
  2861.  
  2862.  
  2863. ΓòÉΓòÉΓòÉ 14.4.1.1. Buffer Control Window ΓòÉΓòÉΓòÉ
  2864.  
  2865. Use the Buffer Control window to set the size of the event log buffer and 
  2866. choose to enable or disable buffer wrapping. This window appears when you 
  2867. select the Buffer control... choice, which is available from the Options menu 
  2868. on the Trace Generation window. 
  2869.  
  2870. The Buffer control window is displayed when you select the Buffer control... 
  2871. choice from the Options menu on the Trace Generation window. 
  2872.  
  2873. The number of times the buffer is written to the trace file (buffer flushes) is 
  2874. listed in the Statistics diagram. The buffer is flushed when it is full and 
  2875. whenever a dynamic link library (DLL) is loaded. 
  2876.  
  2877. The event log buffer size determines how often the data from the trace analysis 
  2878. is written to the trace file. The default is set to 256 kilobytes (KB). 
  2879.  
  2880. You can enable or disable buffer wrapping to choose when the data is written to 
  2881. the trace file. The default for buffer wrapping is disable. 
  2882.  
  2883. This window has two group headings: Buffer Size and Buffer Wrapping. 
  2884.  
  2885. Buffer Size Group Heading 
  2886.  
  2887. The Buffer Size determines the size of the event log buffer. The event log 
  2888. buffer size determines how often the data from the trace analysis is written to 
  2889. the trace file. The default is set to 256 kilobytes (KB). 
  2890.  
  2891. Set the buffer size by selecting the spin buttons in the Buffer Size group 
  2892. heading. The top spin button increases the buffer size and the bottom spin 
  2893. button decreases the buffer size. 
  2894.  
  2895. Select the appropriate push button to continue: 
  2896.  
  2897.      OK 
  2898.      Cancel 
  2899.      Help. 
  2900.  
  2901.  Note:  The settings you enter are saved for the current session. If you want 
  2902.  to save the settings for subsequent sessions, select the Options menu and then 
  2903.  select the Save choice from the Settings cascaded menu. 
  2904.  
  2905.  Buffer Wrapping Group Heading 
  2906.  
  2907.  You can enable or disable buffer wrapping to choose when the data is written 
  2908.  to the trace file. 
  2909.  
  2910.  When buffer wrapping is enabled, the trace data is written to the trace file 
  2911.  only when tracing has stopped. As the program is traced, the buffer fills and 
  2912.  overwrites older events in the buffer with newer ones. Since the buffer is 
  2913.  flushed only when the program ends, less disk space is needed for the trace 
  2914.  file, but some trace data is lost. 
  2915.  
  2916.  When buffer wrapping is disabled, the data is written to the trace file every 
  2917.  time the buffer fills. The default for buffer wrapping is disable. 
  2918.  
  2919.  Enable or disable buffer wrapping by selecting a radio button. 
  2920.  
  2921.      Select the On radio button to enable buffer wrapping. 
  2922.      Select the Off radio button to disable buffer wrapping. 
  2923.  
  2924.  Select the appropriate push button to continue: 
  2925.  
  2926.      OK 
  2927.      Cancel 
  2928.      Help. 
  2929.  
  2930.  Note:  The settings you enter are saved for the current session. If you want 
  2931.  to save the settings for subsequent sessions, select the Options menu and then 
  2932.  select the Save choice from the Settings cascaded menu. 
  2933.  
  2934.  Related Information 
  2935.  
  2936.      Creating a Customized Trace File 
  2937.      Trace Generation Window 
  2938.      Keys Help. 
  2939.  
  2940.  
  2941. ΓòÉΓòÉΓòÉ 14.4.2. Call Depth... Choice ΓòÉΓòÉΓòÉ
  2942.  
  2943. Select the Call depth... choice to set the nesting depth for each thread in 
  2944. your program. This choice is available from the Options menu on the Trace 
  2945. Generation window. 
  2946.  
  2947. You can select as many as 64 threads with a maximum nesting depth of 128 for 
  2948. each thread. The default is to have all threads selected with the maximum depth 
  2949. of 128. 
  2950.  
  2951. When you select Call depth, a Call Depth window appears. 
  2952.  
  2953. Related Information 
  2954.  
  2955.      Creating a Customized Trace File 
  2956.      Trace Generation Window 
  2957.      Keys Help. 
  2958.  
  2959.  
  2960. ΓòÉΓòÉΓòÉ 14.4.2.1. Call Depth Window ΓòÉΓòÉΓòÉ
  2961.  
  2962. Use the Call Depth window to set the nesting depth for each thread in your 
  2963. program. This window appears when you select the Call depth... choice, which is 
  2964. available from the Options menu on the Trace Generation window. 
  2965.  
  2966. You can select as many as 64 threads with a maximum nesting depth of 128 for 
  2967. each thread. The default is to have all threads selected with the maximum depth 
  2968. of 128. 
  2969.  
  2970. Changing the Call Depth 
  2971.  
  2972. The Call Depth window displays 64 thread entry fields. 
  2973.  
  2974. To set call depth, use any of the following methods: 
  2975.  
  2976.    1. Method One 
  2977.  
  2978.         a. Select (or deselect) threads by clicking on them. 
  2979.  
  2980.         b. Click on the spin buttons next to the Set selected entry field until 
  2981.            the desired call depth is shown, or click in the entry field and 
  2982.            type the desired call depth. 
  2983.  
  2984.         c. Press the Set selected push button to change all selected threads to 
  2985.            the desired call depth. 
  2986.  
  2987.            Note:  To disable tracing of any event in a thread, set the call 
  2988.            depth of that thread to 0. 
  2989.  
  2990.         d. Select the appropriate push button to continue: 
  2991.  
  2992.                OK 
  2993.                Cancel 
  2994.                Help. 
  2995.  
  2996.    2. Method Two 
  2997.  
  2998.         a. Select a thread by double-clicking on it. A box appears around the 
  2999.            value in the Depth column of the selected thread. 
  3000.  
  3001.         b. Type the desired call depth. 
  3002.  
  3003.         c. Press Enter. 
  3004.  
  3005.         d. Repeat these steps for each thread you want to change. 
  3006.  
  3007.  Note:  The settings you enter are saved for the current session. If you want 
  3008.  to save the settings for subsequent sessions, select the Options menu and then 
  3009.  select the Save choice from the Settings cascaded menu. 
  3010.  
  3011.  Related Information 
  3012.  
  3013.      Creating a Customized Trace File 
  3014.      Trace Generation Window 
  3015.      Keys Help. 
  3016.  
  3017.  
  3018. ΓòÉΓòÉΓòÉ 14.4.3. File Access Choice ΓòÉΓòÉΓòÉ
  3019.  
  3020. Select the File access choice to keep track of file access calls using the 
  3021. following DOS calls: 
  3022.  
  3023.      DosOpen() 
  3024.      DosRead() 
  3025.      DosWrite() 
  3026.      DosClose() 
  3027.      DosDupHandle() 
  3028.      DosResetBuffer() 
  3029.      DosSetFilePtr() 
  3030.      DosSetFileLocks() 
  3031.      DosSetFileSize() 
  3032.      DosQueryFileInfo() 
  3033.      DosQueryHType() 
  3034.  
  3035.  This choice is available from the Options menu on the Trace Generation window. 
  3036.  You can only select this choice if you have linked _DOSCALL.LIB into your 
  3037.  program. 
  3038.  
  3039.  When a DOS call references a file, the Performance Analyzer keeps track of the 
  3040.  file name associated with the traced DOS calls. These calls are shown in the 
  3041.  diagrams under the functions that made the file accesses. They appear as 
  3042.  function names with their corresponding files in parentheses. 
  3043.  
  3044.  To set file access: 
  3045.  
  3046.      Select the Trace Generation window Options menu. 
  3047.      Select the File access choice. A check mark is displayed next to the 
  3048.       choice to show that it is selected. 
  3049.  
  3050.  To reset file access: 
  3051.  
  3052.      Select the Trace Generation window Options menu. 
  3053.      Select the File access choice. The check mark is removed to show that the 
  3054.       choice is not selected. 
  3055.  
  3056.  Notes: 
  3057.  
  3058.      The settings you enter are saved for the current session. If you want to 
  3059.       save the settings for subsequent sessions, select the Options menu and 
  3060.       then select the Save choice from the Settings cascaded menu. 
  3061.      You can only select the File access choice when the _DOSCALL.LIB file is 
  3062.       linked with your program. 
  3063.  
  3064.  Related Information 
  3065.  
  3066.      Creating a Customized Trace File 
  3067.      Trace Generation Window 
  3068.      Keys Help. 
  3069.  
  3070.  
  3071. ΓòÉΓòÉΓòÉ 14.4.4. Font... Choice ΓòÉΓòÉΓòÉ
  3072.  
  3073. Select the Font... choice to change the font, font style, and font size for the 
  3074. text area on the Trace Generation window. This choice is available from the 
  3075. Options menu on the Trace Generation window. When you select this choice, the 
  3076. Font window appears. 
  3077.  
  3078. The Font window has the following areas: 
  3079.  
  3080.  Name entry field      Type a font name in this entry field or click on the 
  3081.                        scroll bar on the right side of the entry field to see a 
  3082.                        list of choices and select a name from the list. 
  3083.  Size entry field      Type a font size in this entry field or click on the 
  3084.                        scroll bar on the right side of the entry field to see a 
  3085.                        list of choices and select a size from the list. 
  3086.  Style entry field     Type a font style in this entry field or click on the 
  3087.                        scroll bar on the right side of the entry field to see a 
  3088.                        list of choices and select a style from the list. 
  3089.  Emphasis check boxes  Click on one of these check boxes to outline, 
  3090.                        underscore, or strikeout text. 
  3091.  Sample box            This box shows a sample of how text will appear with the 
  3092.                        settings you have selected. 
  3093.  Ok push button        Changes the font according to the settings you selected. 
  3094.  Reset push button     Changes all font settings to the default settings. 
  3095.  Cancel push button    Closes the window without making changes. 
  3096.  
  3097.  Note:  The settings you enter are saved for the current session. If you want 
  3098.  to save the settings for subsequent sessions, select the Options menu and then 
  3099.  select the Save choice from the Settings cascaded menu. 
  3100.  
  3101.  Related Information 
  3102.  
  3103.      Trace Generation Window 
  3104.      Keys Help. 
  3105.  
  3106.  
  3107. ΓòÉΓòÉΓòÉ 14.4.5. Name Trace File... Choice ΓòÉΓòÉΓòÉ
  3108.  
  3109. Select the Name trace file choice to create a trace file with a name other than 
  3110. the default or to rename a trace file you are analyzing. This choice is 
  3111. available from the Options menu on the Trace Generation window. 
  3112.  
  3113. The default name for the trace file is myprog.trc, where myprog is the name of 
  3114. the program you are tracing. 
  3115.  
  3116. When you select Name trace file..., a Name Trace File window appears. On this 
  3117. window, you can also add or change a trace file description. 
  3118.  
  3119. Related Information 
  3120.  
  3121.      Creating a Customized Trace File 
  3122.      Trace Generation Window 
  3123.      Keys Help. 
  3124.  
  3125.  
  3126. ΓòÉΓòÉΓòÉ 14.4.5.1. Name Trace File Window ΓòÉΓòÉΓòÉ
  3127.  
  3128. Use the Name Trace File window to give a trace file a different name and to 
  3129. attach a description to it. This window appears when you select the Name trace 
  3130. file... choice from the Options menu on the Trace Generation window. 
  3131.  
  3132. The default name for a trace file is myprog.trc, where myprog is the name of 
  3133. the program you are tracing. If you create more than one trace file from the 
  3134. same program, The Performance Analyzer uses the default naming convention and 
  3135. overwrites the previous trace file. 
  3136.  
  3137. This choice is useful when you want to save two or more trace files created 
  3138. from the same program. 
  3139.  
  3140. If you try to create a trace file with the same name as one that is currently 
  3141. displayed in a diagram, the Performance Analyzer allows you to display this 
  3142. window and name the new trace file. For more information, see Resolve Name 
  3143. Conflict Window. 
  3144.  
  3145. A description can make a trace file easier to identify, especially when you 
  3146. create more than one trace file from the same program and use different options 
  3147. for each trace. The description is displayed in the Status Area of any open 
  3148. diagram. 
  3149.  
  3150. Naming the Trace File and Adding a Description 
  3151.  
  3152. To name or change the name of a trace file and attach a description to it: 
  3153.  
  3154.    1. Type the new path, file name, and file extension in the Trace file entry 
  3155.       field. 
  3156.  
  3157.    2. Type a description for the trace file in the Description entry field. 
  3158.  
  3159.       Note:  This entry field is optional. 
  3160.  
  3161.    3. Select the appropriate push button to continue: 
  3162.  
  3163.           OK 
  3164.           Cancel 
  3165.           Help. 
  3166.  
  3167.  Related Information 
  3168.  
  3169.      Resolve Name Conflict Window 
  3170.      Unique Trace File Name Choice 
  3171.      Trace Generation Window 
  3172.      Keys Help. 
  3173.  
  3174.  
  3175. ΓòÉΓòÉΓòÉ 14.4.6. Timeout Control... Choice ΓòÉΓòÉΓòÉ
  3176.  
  3177. Select the Timeout control... choice to specify the maximum number of seconds 
  3178. your program can run without logging events. This choice is available from the 
  3179. Options menu on the Trace Generation window. 
  3180.  
  3181. Use this choice when your program deadlocks to determine where the problem is 
  3182. located. 
  3183.  
  3184. When you select Timeout control..., a Timeout Control window appears. 
  3185.  
  3186. Related Information 
  3187.  
  3188.      Creating a Customized Trace File 
  3189.      Trace Generation Window 
  3190.      Keys Help. 
  3191.  
  3192.  
  3193. ΓòÉΓòÉΓòÉ 14.4.6.1. Timeout Control Window ΓòÉΓòÉΓòÉ
  3194.  
  3195. Use the Timeout Control window to specify the maximum number of seconds your 
  3196. program can run without logging events. This window appears when you select the 
  3197. Timeout control... choice, which is available from the Options menu on the 
  3198. Trace Generation window. 
  3199.  
  3200. Use this choice when your program deadlocks to determine where the problem is 
  3201. located. 
  3202.  
  3203. Setting a Timeout 
  3204.  
  3205. To use the Timeout Control window: 
  3206.  
  3207.    1. Type a number from 0 to 3600 in the Number entry field or use the spin 
  3208.       buttons to scroll to the number of seconds you want. 
  3209.  
  3210.       Note:  A 0 in the Number entry field implies that there is not a maximum 
  3211.       limit. 
  3212.    2. Select the appropriate push button to continue: 
  3213.           OK 
  3214.           Cancel 
  3215.           Help. 
  3216.  
  3217.  Note:  The settings you enter are saved for the current session. If you want 
  3218.  to save the settings for subsequent sessions, select the Options menu and then 
  3219.  select the Save choice from the Settings cascaded menu. 
  3220.  
  3221.  Related Information 
  3222.  
  3223.      Analyze Trace Window 
  3224.      Trace Generation Window 
  3225.      Keys Help. 
  3226.  
  3227.  
  3228. ΓòÉΓòÉΓòÉ 14.4.7. Time Stamp Events Choice ΓòÉΓòÉΓòÉ
  3229.  
  3230. Select the Time stamp events choice to enable or disable time stamps. This 
  3231. choice is available from the Options menu on the Trace Generation window. 
  3232.  
  3233. To set time stamp events on: 
  3234.  
  3235.      Select the Trace Generation window Options menu. 
  3236.      Select the Time stamp events choice. A check mark is displayed next to 
  3237.       the choice to show that it is selected. 
  3238.  
  3239.  To set time stamp events off: 
  3240.  
  3241.      Select the Trace Generation window Options menu. 
  3242.      Select the Time stamp events choice. The check mark is removed to show 
  3243.       that the choice is not selected. 
  3244.  
  3245.  If you choose to disable time stamps, the Performance Analyzer produces a 
  3246.  smaller trace file and only the Statistics and Call Nesting diagrams and the 
  3247.  Dynamic Call Graph can be viewed. 
  3248.  
  3249.  The default is to have time stamps enabled. 
  3250.  
  3251.  Note:  The settings you enter are saved for the current session. If you want 
  3252.  to save the settings for subsequent sessions, select the Options menu and then 
  3253.  select the Save choice from the Settings cascaded menu. 
  3254.  
  3255.  Related Information 
  3256.  
  3257.      Creating a Customized Trace File 
  3258.      Trace Generation Window 
  3259.      Keys Help. 
  3260.  
  3261.  
  3262. ΓòÉΓòÉΓòÉ 14.4.8. Settings Cascading Choice ΓòÉΓòÉΓòÉ
  3263.  
  3264. Select the Settings cascading choice to display a cascaded menu that lets you 
  3265. save settings or restore Analyzer default settings. This choice is available 
  3266. from the Options menu on the Trace Generation window. 
  3267.  
  3268. Related Information 
  3269.  
  3270.      Trace Generation Window 
  3271.      Keys Help. 
  3272.  
  3273.  
  3274. ΓòÉΓòÉΓòÉ 14.4.8.1. Save Choice ΓòÉΓòÉΓòÉ
  3275.  
  3276. Select the Save choice to save the current window settings for subsequent 
  3277. Performance Analyzer sessions. This choice is available from the Settings 
  3278. cascading choice, which is on the Options menu on the Trace Generation window. 
  3279.  
  3280. If you do not select this choice, settings remain active for the current 
  3281. session. If you select this choice, settings remain active for subsequent 
  3282. sessions because they are stored in the ICSPERF.INI file. The saved settings 
  3283. remain active until the ICSPERF.INI file is erased. 
  3284.  
  3285. The Performance Analyzer will save the following settings on the Trace 
  3286. Generation window: 
  3287.  
  3288.      Buffer size 
  3289.      Buffer wrapping 
  3290.      File access 
  3291.      Font 
  3292.      Call depth 
  3293.      Time stamp events 
  3294.      Timeout Control 
  3295.      Traceable filter 
  3296.      Tree lines 
  3297.      Window position 
  3298.      Window size 
  3299.  
  3300.  To restore the default settings, select the Restore Initial Defaults 
  3301.  
  3302.  Related Information 
  3303.  
  3304.      Restore Initial Defaults Choice 
  3305.      Trace Generation Window 
  3306.      Keys Help. 
  3307.  
  3308.  
  3309. ΓòÉΓòÉΓòÉ 14.4.8.2. Restore Initial Defaults Choice ΓòÉΓòÉΓòÉ
  3310.  
  3311. Select the Restore Initial Defaults choice to restore the Performance Analyzer 
  3312. default settings for the Trace Generation window. This choice is available from 
  3313. the Settings cascading choice, which is on the Options menu on the Trace 
  3314. Generation window. 
  3315.  
  3316. Related Information 
  3317.  
  3318.      Trace Generation Window 
  3319.      Keys Help. 
  3320.  
  3321.  
  3322. ΓòÉΓòÉΓòÉ 14.5. Trace Generation Window Project Menu ΓòÉΓòÉΓòÉ
  3323.  
  3324. This menu appears on the Trace Generation window when you start the Performance 
  3325. Analyzer within the WorkFrame environment. The Project menu gives you direct 
  3326. access to all of the actions that you can perform from your current location. 
  3327.  
  3328. When you select the Edit source choice from this menu, the source file for a 
  3329. selected object file or function is displayed in WorkFrame's default editor. 
  3330.  
  3331. Related Information 
  3332.  
  3333.      Edit Source Choice 
  3334.      Search Paths Window 
  3335.      Trace Generation Window 
  3336.      Starting the Performance Analyzer from WorkFrame 
  3337.      Keys Help. 
  3338.  
  3339.  
  3340. ΓòÉΓòÉΓòÉ 14.5.1. Edit Source Choice ΓòÉΓòÉΓòÉ
  3341.  
  3342. Select the Edit source choice to edit a source file in WorkFrame's default 
  3343. editor. This choice lets you edit the source for an object file or a function 
  3344. selected on the Trace Generation window. When you are working in the WorkFrame 
  3345. environment, this choice is available from the Project menu on the Trace 
  3346. Generation window. It is also available from the Object file pop-up menu and 
  3347. the Function pop-up menu on the Trace Generation window. 
  3348.  
  3349. To locate a source file for editing, the Performance Analyzer must first locate 
  3350. the executable containing the name of the source file. The Performance Analyzer 
  3351. searches the following paths (in the order listed) to locate an executable: 
  3352.  
  3353.    1. Path specified in the Locate Executable window 
  3354.    2. Path specified in the Search path for executable files: entry field of 
  3355.       the Search Paths window 
  3356.    3. Directory where the executable to be traced is located 
  3357.    4. The current working directory 
  3358.    5. Path specified by the PATH environment variable. 
  3359.  
  3360.  To identify the name of the source file, the Performance Analyzer looks at the 
  3361.  debug information in the executable. The Performance Analyzer then searches 
  3362.  the following paths (in the order listed) to locate the source file: 
  3363.  
  3364.    1. Path specified in the Locate Source File window 
  3365.    2. Path specified in the Search path for source files: entry field of the 
  3366.       Search Paths window 
  3367.    3. Path specified in the compile statement (if provided) 
  3368.    4. Directory where the executable to be traced is located 
  3369.    5. The current working directory 
  3370.    6. Path specified by the INCLUDE environment variable. 
  3371.  
  3372.  If, after searching these paths, the Performance Analyzer cannot find the: 
  3373.  
  3374.    1. Executable, it displays the Locate Executable window to let you enter the 
  3375.       path where the executable resides. 
  3376.    2. Source file, it displays the Locate Source File window to let you enter 
  3377.       the path where the source file resides. 
  3378.  
  3379.  If you are editing the source for: 
  3380.  
  3381.      An object file, the source is opened to the first line of the file. 
  3382.      A function, the source is opened to the first line of the function's 
  3383.       code. 
  3384.  
  3385.  Notes 
  3386.  
  3387.    1. The Performance Analyzer remembers the paths you enter in the Locate 
  3388.       Executable and Locate Source File windows and uses them to look for files 
  3389.       the next time you select the Edit source choice. 
  3390.    2. You can specify paths that you want the Performance Analyzer to use by 
  3391.       selecting the Search Paths choice in the Options menu on the Performance 
  3392.       Analyzer - Window Manager window. The paths you enter are automatically 
  3393.       saved for the current session. If you want to save the paths for 
  3394.       subsequent sessions, select the Options menu and then select the Save 
  3395.       choice from the Settings cascaded menu. 
  3396.  
  3397.  Related Information 
  3398.  
  3399.      Locate Executable Window 
  3400.      Locate Source File Window 
  3401.      Search Paths Window 
  3402.      Trace Generation Window 
  3403.      Starting the Performance Analyzer from WorkFrame 
  3404.      Keys Help. 
  3405.  
  3406.  
  3407. ΓòÉΓòÉΓòÉ 14.6. Trace Generation Window Help Menu ΓòÉΓòÉΓòÉ
  3408.  
  3409. Select choices from the Help menu to display the various types of Help 
  3410. information. 
  3411.  
  3412. The Help menu has the following choices: 
  3413.  
  3414.  Help index 
  3415.                      Displays an index of Help topics. 
  3416.  General help 
  3417.                      Displays Help for the active window. 
  3418.  Using help 
  3419.                      Describes how to use Help. 
  3420.  How do I? 
  3421.                      Displays task Help. 
  3422.  Product information 
  3423.                      Displays information about the Performance Analyzer. 
  3424.  
  3425.  Related Information 
  3426.  
  3427.      Trace Generation Window 
  3428.      Keys Help. 
  3429.  
  3430.  
  3431. ΓòÉΓòÉΓòÉ 14.6.1. Help Index Choice ΓòÉΓòÉΓòÉ
  3432.  
  3433. Select the Help index choice to display an alphabetical index of Performance 
  3434. Analyzer Help topics. This choice is available from the Help menu on the Trace 
  3435. Generation window. 
  3436.  
  3437. Use the Previous push button to return to the last topic you viewed. Use the 
  3438. Search... push button to locate topics in the index. Use the Print... push 
  3439. button to print a topic. 
  3440.  
  3441. Related Information 
  3442.  
  3443.      Trace Generation Window 
  3444.      Keys Help. 
  3445.  
  3446.  
  3447. ΓòÉΓòÉΓòÉ 14.6.2. General Help Choice ΓòÉΓòÉΓòÉ
  3448.  
  3449. Select the General help choice to display Help information for the active 
  3450. window. This choice is available from the Help menu on the Trace Generation 
  3451. window. 
  3452.  
  3453. The online Help panel displayed is the same panel that is displayed when you 
  3454. place your cursor inside the window and press F1. 
  3455.  
  3456. Related Information 
  3457.  
  3458.      Trace Generation Window 
  3459.      Keys Help. 
  3460.  
  3461.  
  3462. ΓòÉΓòÉΓòÉ 14.6.3. Using Help Choice ΓòÉΓòÉΓòÉ
  3463.  
  3464. Select the Using help choice for a description of how to use the Help facility. 
  3465. This choice is available from the Help menu on the Trace Generation window. 
  3466.  
  3467. Related Information 
  3468.  
  3469.      Trace Generation Window 
  3470.      Keys Help. 
  3471.  
  3472.  
  3473. ΓòÉΓòÉΓòÉ 14.6.4. How Do I? Choice ΓòÉΓòÉΓòÉ
  3474.  
  3475. Select the How do I? choice to display the Performance Analyzer task help. This 
  3476. choice is available from the Help menu on the Trace Generation window. 
  3477.  
  3478. Related Information 
  3479.  
  3480.      Trace Generation Window 
  3481.      Keys Help. 
  3482.  
  3483.  
  3484. ΓòÉΓòÉΓòÉ 14.6.5. Product Information Choice ΓòÉΓòÉΓòÉ
  3485.  
  3486. Select the Product information choice to display copyright and version 
  3487. information about the Performance Analyzer application. This choice is 
  3488. available from the Help menu on the Trace Generation window. 
  3489.  
  3490. Related Information 
  3491.  
  3492.      Trace Generation Window 
  3493.      Keys Help. 
  3494.  
  3495.  
  3496. ΓòÉΓòÉΓòÉ 14.7. Trace Generation Window Executable Pop-up Menu ΓòÉΓòÉΓòÉ
  3497.  
  3498. The Trace Generation window displays a list of component file names that make 
  3499. up your program. 
  3500.  
  3501. Click mouse button two on the file name or icon of an executable (EXE) or 
  3502. dynamic link library (DLL) file to display the Executable pop-up menu. The 
  3503. pop-up menu and the choices listed in the menu are different if you click on 
  3504. another file type. 
  3505.  
  3506. The Trace Generation window Executable pop-up menu has the following choices: 
  3507.  
  3508.  Disable executable 
  3509.            Disables the selected executable file so that the Performance 
  3510.            Analyzer does not record trace analysis data for it in the trace 
  3511.            file. This choice is available when you select an enabled 
  3512.            executable. 
  3513.  Enable executable 
  3514.            Enables the selected executable file so that the Performance 
  3515.            Analyzer records trace analysis data for it in the trace file. This 
  3516.            choice is available when you select a disabled executable. 
  3517.  
  3518.  Related Information 
  3519.  
  3520.      Introducing the Performance Analyzer 
  3521.      Edit Menu 
  3522.      Trace Generation Window 
  3523.      Keys Help. 
  3524.  
  3525.  
  3526. ΓòÉΓòÉΓòÉ 14.8. Trace Generation Window Object File Pop-up Menu ΓòÉΓòÉΓòÉ
  3527.  
  3528. The Trace Generation window displays a list of component file names that make 
  3529. up your program, including those of object files. 
  3530.  
  3531. Click mouse button two on the file name of an object file (or the plus/minus 
  3532. icon next to it) to display the Object File pop-up menu. The pop-up menu and 
  3533. the choices listed in the menu are different if you click on another file type. 
  3534.  
  3535. The Trace Generation window Object File pop-up menu has the following choices: 
  3536.  
  3537.  Disable object file 
  3538.            Disables the selected object file so that the Performance Analyzer 
  3539.            does not record trace analysis data for it in the trace file. This 
  3540.            choice is available when you select an enabled object file. 
  3541.  Enable object file 
  3542.            Enables the selected object file so that the Performance Analyzer 
  3543.            records trace analysis data for it in the trace file. This choice is 
  3544.            available when you select a disabled object file. 
  3545.  Edit source 
  3546.            Displays the source file for a selected object file in WorkFrame's 
  3547.            default editor. The Performance Analyzer finds the source file and 
  3548.            opens it to the first line of the file. 
  3549.  
  3550.  Related Information 
  3551.  
  3552.      Edit Menu 
  3553.      Edit Source Choice 
  3554.      Project Menu 
  3555.      Trace Generation Window 
  3556.      Starting the Performance Analyzer from WorkFrame 
  3557.      Keys Help. 
  3558.  
  3559.  
  3560. ΓòÉΓòÉΓòÉ 14.9. Trace Generation Window Function Pop-up Menu ΓòÉΓòÉΓòÉ
  3561.  
  3562. The Trace Generation window displays a list of component file names that make 
  3563. up your program, including those of functions. 
  3564.  
  3565. Click mouse button two on the name of a function (or the plus/minus icon next 
  3566. to it) to display the Function pop-up menu. The pop-up menu and the choices 
  3567. listed in the menu are different if you click on another file type. 
  3568.  
  3569. The Trace Generation window Function pop-up menu has the following choices: 
  3570.  
  3571.  Disable function 
  3572.            Disables the selected function so that the Performance Analyzer does 
  3573.            not record trace analysis data for it in the trace file. This choice 
  3574.            is available when you select an enabled function. 
  3575.  Enable function 
  3576.            Enables the selected function so that the Performance Analyzer 
  3577.            records trace analysis data for it in the trace file. This choice is 
  3578.            available when you select a disabled function. 
  3579.  Set trigger 
  3580.            Sets a trigger on a function so that the Performance Analyzer traces 
  3581.            the function and its associated calls. This choice is available when 
  3582.            you select a function that does not have a trigger set on it. 
  3583.  
  3584.            Note:  If triggers have not been set, the Performance Analyzer 
  3585.            traces enabled executables, DLLs, object files, and functions (and 
  3586.            their associated calls). If triggers have been set, the Performance 
  3587.            Analyzer traces enabled executables, DLLs, and object files, but it 
  3588.            only traces functions (and their associated calls) on which triggers 
  3589.            have been set. 
  3590.  Remove trigger 
  3591.            Removes a trigger on a function so that the Performance Analyzer 
  3592.            does not trace the function and its associated calls. This choice is 
  3593.            available when you select a function that has a trigger set on it. 
  3594.  
  3595.            Note:  If triggers have not been set, the Performance Analyzer 
  3596.            traces enabled executables, DLLs, object files, and functions (and 
  3597.            their associated calls). If triggers have been set, the Performance 
  3598.            Analyzer traces enabled executables, DLLs, and object files, but it 
  3599.            only traces functions (and their associated calls) on which triggers 
  3600.            have been set. 
  3601.  Edit source 
  3602.            Displays the source file for a selected function in WorkFrame's 
  3603.            default editor. The Performance Analyzer finds the source file and 
  3604.            opens it to the line where the function begins. 
  3605.  
  3606.  Related Information 
  3607.  
  3608.      Edit Menu 
  3609.      Edit Source Choice 
  3610.      Project Menu 
  3611.      Trace Generation Window 
  3612.      Starting the Performance Analyzer from WorkFrame 
  3613.      Keys Help. 
  3614.  
  3615.  
  3616. ΓòÉΓòÉΓòÉ 14.10. Locate Executable Window ΓòÉΓòÉΓòÉ
  3617.  
  3618. When you select the Edit source choice (available when working in the WorkFrame 
  3619. environment), the Performance Analyzer must find the source file containing the 
  3620. code you want to edit before it can be displayed in the editor. 
  3621.  
  3622. When searching for a source file, the Performance Analyzer first looks for the 
  3623. executable containing the object file or function you want to edit. (You can 
  3624. select object files and functions for editing on the Trace Generation window. 
  3625. You can select functions for editing on any of the diagrams.) Then it looks at 
  3626. the debug information in the executable to identify the name of the source file 
  3627. containing the code you want to edit. 
  3628.  
  3629. The Performance Analyzer searches the following paths (in the order listed) 
  3630. when looking for an executable file: 
  3631.  
  3632.    1. Path specified in the Locate Executable window 
  3633.    2. Path specified in the Search path for executable files: entry field of 
  3634.       the Search Paths window 
  3635.    3. Directory where the executable to be traced is located (if you selected 
  3636.       the Edit source choice from the Trace Generation window) or the directory 
  3637.       where the executable was located when the trace file was created (if you 
  3638.       selected the Edit function choice from one of the diagrams) 
  3639.    4. The current working directory 
  3640.    5. Path specified by the PATH environment variable. 
  3641.  
  3642.  The Locate Executable window is only displayed if the Performance Analyzer 
  3643.  cannot find the executable in any of these paths. 
  3644.  
  3645.  To use the Locate Executable window: 
  3646.  
  3647.    1. Enter the path name where the executable containing the source file is 
  3648.       located. 
  3649.  
  3650.       Note:  If you are not sure where the file is located, select the Find... 
  3651.       push button. 
  3652.    2. Select the appropriate push button to continue: 
  3653.           OK 
  3654.           Cancel 
  3655.           Help 
  3656.  
  3657.  Notes 
  3658.  
  3659.    1. The Performance Analyzer remembers the path you enter in the Locate 
  3660.       Executable window and uses it to look for files the next time you select 
  3661.       the Edit source choice. 
  3662.    2. Specify paths that you want the Performance Analyzer to use by selecting 
  3663.       the Search Paths choice in the Options menu on the Performance Analyzer - 
  3664.       Window Manager window. The paths you enter are automatically saved for 
  3665.       the current session. If you want to save the paths for subsequent 
  3666.       sessions, select the Options menu and then select the Save choice from 
  3667.       the Settings cascaded menu. 
  3668.  
  3669.  Related Information 
  3670.  
  3671.      Edit Source Choice 
  3672.      Locate Source File Window 
  3673.      Search Paths Window 
  3674.      Trace Generation Window 
  3675.      Starting the Performance Analyzer from WorkFrame 
  3676.      Keys Help. 
  3677.  
  3678.  
  3679. ΓòÉΓòÉΓòÉ 14.11. Locate Source File Window ΓòÉΓòÉΓòÉ
  3680.  
  3681. When you select the Edit source choice (available when working in the WorkFrame 
  3682. environment), the Performance Analyzer must find the source file containing the 
  3683. code you want to edit before it can be displayed in the editor. 
  3684.  
  3685. When searching for a source file, the Performance Analyzer first looks for the 
  3686. executable containing the object file or function you want to edit. Then it 
  3687. looks at the debug information in the executable to identify the name of the 
  3688. source file containing the code you want to edit. 
  3689.  
  3690. The Performance Analyzer searches the following paths (in the order listed) 
  3691. when looking for a source file: 
  3692.  
  3693.    1. Path specified in the Locate Source File window 
  3694.    2. Path specified in the Search path for source files: entry field of the 
  3695.       Search Paths window 
  3696.    3. Path specified in the compile statement (if provided) 
  3697.    4. Directory where the executable to be traced is located (if you selected 
  3698.       the Edit source choice from the Trace Generation window) or the directory 
  3699.       where the executable was located when the trace file was created (if you 
  3700.       selected the Edit function choice from one of the diagrams) 
  3701.    5. The current working directory 
  3702.    6. Path specified by the INCLUDE environment variable. 
  3703.  
  3704.  The Locate Source File window is only displayed if the Performance Analyzer 
  3705.  cannot find the source file in any of these paths. 
  3706.  
  3707.  To use the Locate Source File window: 
  3708.  
  3709.    1. Enter the path name where the source file is located. 
  3710.  
  3711.       Note:  If you are not sure where the file is located, select the Find... 
  3712.       push button. 
  3713.  
  3714.  
  3715.    2. Select the appropriate push button to continue: 
  3716.           OK 
  3717.           Cancel 
  3718.           Help 
  3719.  
  3720.  Notes 
  3721.  
  3722.    1. The Performance Analyzer remembers the path you enter in the Locate 
  3723.       Source File window and uses it to look for files the next time you select 
  3724.       the Edit source choice. 
  3725.    2. Specify paths that you want the Performance Analyzer to use by selecting 
  3726.       the Search Paths choice in the Options menu on the Performance Analyzer - 
  3727.       Window Manager window. The paths you enter are automatically saved for 
  3728.       the current session. If you want to save the paths for subsequent 
  3729.       sessions, select the Options menu and then select the Save choice from 
  3730.       the Settings cascaded menu. 
  3731.  
  3732.  Related Information 
  3733.  
  3734.      Edit Source Choice 
  3735.      Locate Executable Window 
  3736.      Search Paths Window 
  3737.      Trace Generation Window 
  3738.      Starting the Performance Analyzer from WorkFrame 
  3739.      Keys Help. 
  3740.  
  3741.  
  3742. ΓòÉΓòÉΓòÉ 14.12. Resolve Name Conflict Window ΓòÉΓòÉΓòÉ
  3743.  
  3744. The Resolve Name Conflict window appears when you're trying to create a new 
  3745. trace file with the same name as one that is currently displayed in a diagram. 
  3746.  
  3747. To correct this problem, you can do any of the following: 
  3748.  
  3749.      Give the trace file a different name. To do this: 
  3750.         1. Click on the Rename trace file push button. 
  3751.         2. Enter a different trace file name in the Name Trace File window. You 
  3752.            can also give the trace file a description that will make it easier 
  3753.            to identify. 
  3754.         3. Click on the OK push button. 
  3755.      Overwrite the existing trace file by creating a new one. To do this: 
  3756.         1. Click on the Cancel push button to return to the Window Manager 
  3757.            window. 
  3758.         2. Close the diagram or diagrams using the trace file you want to 
  3759.            recreate. 
  3760.         3. Create another trace file using the same executable file. 
  3761.      Create another trace file using the same executable file, but with Unique 
  3762.       trace file name choice selected. To do this: 
  3763.         1. Click on the Cancel push button to return to the Window Manager 
  3764.            window. 
  3765.         2. Select Unique trace file name from the Options menu on the 
  3766.            Performance Analyzer - Window Manager window. 
  3767.         3. Create another trace file using the same executable file. 
  3768.  
  3769.  
  3770. ΓòÉΓòÉΓòÉ 15. Application Monitor Window ΓòÉΓòÉΓòÉ
  3771.  
  3772. After you select the Trace push button (on the Trace Generation window) to 
  3773. start tracing your program, the Performance Analyzer displays the Application 
  3774. Monitor window. 
  3775.  
  3776. This window is displayed until your entire program has run or you select the 
  3777. Stop push button, which causes your program to stop running. When you stop the 
  3778. program, you also stop the collection of trace data. 
  3779.  
  3780. Areas of the Application Monitor Window 
  3781.  
  3782.      Status Area 
  3783.      Push Buttons 
  3784.         -  Stop 
  3785.         -  Trace on 
  3786.         -  Trace off. 
  3787.  
  3788.  Note:  The Help push button displays this Help information. 
  3789.  
  3790.  Related Information 
  3791.  
  3792.      Selecting a Trace File to Analyze 
  3793.      Trace Generation Window 
  3794.      Keys Help. 
  3795.  
  3796.  
  3797. ΓòÉΓòÉΓòÉ 15.1. Status Area ΓòÉΓòÉΓòÉ
  3798.  
  3799. The following information is displayed in the Status Area on the Application 
  3800. Monitor window: 
  3801.  
  3802.      Name of the program being traced 
  3803.      Name of the trace file 
  3804.      Number of bytes written to the trace file 
  3805.      Number of events written to the trace file 
  3806.  
  3807.  Related Information 
  3808.  
  3809.      Trace Off Push Button 
  3810.      Trace On Push Button 
  3811.      Selecting a Trace File to Analyze 
  3812.      Trace Generation Window 
  3813.      Keys Help. 
  3814.  
  3815.  
  3816. ΓòÉΓòÉΓòÉ 16. Call Nesting Diagram ΓòÉΓòÉΓòÉ
  3817.  
  3818. Call Nesting Diagram 
  3819.  
  3820. The Call Nesting diagram shows the trace file as a vertical series of function 
  3821. calls and returns. Use this diagram to diagnose problems with critical 
  3822. sections, sequencing protocols, program deadlocks and crashes, and thread 
  3823. delays. 
  3824.  
  3825. Each thread in the Call Nesting diagram has its own starting column of 
  3826. functions. A call is shown as a step to the right and a return is shown as a 
  3827. line back to the left. The calls are labeled with the name of the function 
  3828. being called. 
  3829.  
  3830. Use the mouse to select a call, a return or a user event. When the call is 
  3831. selected, it is highlighted. 
  3832.  
  3833. Context switches between threads are shown by dashed horizontal lines. While 
  3834. the vertical lines do not show elapsed scaled times in this diagram, you can 
  3835. clearly see the flow of control and the interactions among the various threads. 
  3836.  
  3837. You can use this diagram to find where a deadlock occurred. 
  3838.  
  3839. Areas of the Call Nesting Window 
  3840.  
  3841. The following topics describe the areas of the Call Nesting diagram: 
  3842.  
  3843.      Menu Bar Summary 
  3844.  
  3845.       The choices available from the Call Nesting diagram menu bar are: 
  3846.         -  Trace file 
  3847.         -  Edit 
  3848.         -  View 
  3849.         -  Options 
  3850.         -  Project 
  3851.         -  Help 
  3852.      Status Area 
  3853.  
  3854.       The Status Area provides information about the following: 
  3855.         -  Trace Description 
  3856.         -  Filters 
  3857.      Call Nesting Pop-up Menus 
  3858.         -  Call Nesting Diagram Pop-up 
  3859.         -  Call Nesting Selected Item Pop-up 
  3860.  
  3861.  Related Information 
  3862.  
  3863.      Analyze Trace Window 
  3864.      Dynamic Call Graph 
  3865.      Execution Density Diagram 
  3866.      Statistics Diagram 
  3867.      Time Line Diagram 
  3868.      Hints and Tips 
  3869.      Keys Help. 
  3870.  
  3871.  
  3872. ΓòÉΓòÉΓòÉ 16.1. Call Nesting Trace File Menu ΓòÉΓòÉΓòÉ
  3873.  
  3874. The following choices are available from the Call Nesting Trace file menu: 
  3875.  
  3876.  Open as 
  3877.            Shows a new or an additional diagram. 
  3878.  
  3879.  Printer settings... 
  3880.            Allows you to choose printer settings for your output. 
  3881.  
  3882.  Print selected region... 
  3883.            Prints a selected area of the diagram. 
  3884.  
  3885.  Window Manager 
  3886.            Displays the Window Manager 
  3887.  
  3888.  Exit Performance Analyzer 
  3889.            Exits the Performance Analyzer. 
  3890.  
  3891.  Related Information 
  3892.  
  3893.      Analyze Trace Window 
  3894.      Dynamic Call Graph 
  3895.      Execution Density Diagram 
  3896.      Statistics Diagram 
  3897.      Time Line Diagram 
  3898.      Keys Help. 
  3899.  
  3900.  
  3901. ΓòÉΓòÉΓòÉ 16.1.1. Open as Cascading Choice ΓòÉΓòÉΓòÉ
  3902.  
  3903. Select the Open as cascading choice to view another diagram. You can open as 
  3904. many new diagram windows as you want. 
  3905.  
  3906. To select a new diagram: 
  3907.  
  3908.    1. Select Open as from the Trace file menu. A cascaded menu is displayed 
  3909.       with the following choices: 
  3910.  
  3911.            Call Nesting 
  3912.            Dynamic Call Graph 
  3913.            Execution Density 
  3914.            Statistics 
  3915.            Time Line 
  3916.  
  3917.    2. Select the name of the diagram you want to view. A new window opens to 
  3918.       display the diagram you selected. 
  3919.  
  3920.  Related Information 
  3921.  
  3922.      Dynamic Call Graph 
  3923.      Execution Density Diagram 
  3924.      Statistics Diagram 
  3925.      Time Line Diagram 
  3926.      Keys Help. 
  3927.  
  3928.  
  3929. ΓòÉΓòÉΓòÉ 16.1.1.1. Call Nesting Choice ΓòÉΓòÉΓòÉ
  3930.  
  3931. The Call Nesting choice is available from the Open as cascaded menu. When you 
  3932. select Call Nesting diagram, the Call Nesting Diagram displays. 
  3933.  
  3934. Related Information 
  3935.  
  3936.      Open As Choice 
  3937.      Keys Help. 
  3938.  
  3939.  
  3940. ΓòÉΓòÉΓòÉ 16.1.1.2. Dynamic Call Graph Choice ΓòÉΓòÉΓòÉ
  3941.  
  3942. The Dynamic Call Graph choice is available from the Open as cascaded menu. When 
  3943. you select Dynamic Call Graph, the Dynamic Call Graph  displays. 
  3944.  
  3945. Related Information 
  3946.  
  3947.      Open As Choice 
  3948.      Keys Help. 
  3949.  
  3950.  
  3951. ΓòÉΓòÉΓòÉ 16.1.1.3. Execution Density Choice ΓòÉΓòÉΓòÉ
  3952.  
  3953. The Execution Density choice is available from the Open as cascaded menu. When 
  3954. you select Execution Density, the Execution Density Diagram displays. 
  3955.  
  3956. Related Information 
  3957.  
  3958.      Open As Choice 
  3959.      Keys Help. 
  3960.  
  3961.  
  3962. ΓòÉΓòÉΓòÉ 16.1.1.4. Statistics Choice ΓòÉΓòÉΓòÉ
  3963.  
  3964. The Statistics choice is available from the Open as cascaded menu. When you 
  3965. select Statistics, the Statistics Diagram displays. 
  3966.  
  3967. Related Information 
  3968.  
  3969.      Open As Choice 
  3970.      Keys Help. 
  3971.  
  3972.  
  3973. ΓòÉΓòÉΓòÉ 16.1.1.5. Time Line Choice ΓòÉΓòÉΓòÉ
  3974.  
  3975. The Time Line choice is available from the Open as cascaded menu. When you 
  3976. select Time Line, the Time Line Diagram displays. 
  3977.  
  3978. Related Information 
  3979.  
  3980.      Open As Choice 
  3981.      Keys Help. 
  3982.  
  3983.  
  3984. ΓòÉΓòÉΓòÉ 16.1.2. Printer Settings... Choice ΓòÉΓòÉΓòÉ
  3985.  
  3986. Select the Printer settings... choice to select settings for your print jobs. 
  3987.  
  3988. When you select the Printer settings... choice, the Printer Settings window 
  3989. appears. 
  3990.  
  3991.      OK 
  3992.      Font 
  3993.      Job 
  3994.      Cancel 
  3995.      Help 
  3996.  
  3997.  Related Information 
  3998.  
  3999.      Keys Help. 
  4000.  
  4001.  
  4002. ΓòÉΓòÉΓòÉ <hidden> Printer Settings Window ΓòÉΓòÉΓòÉ
  4003.  
  4004. The Printer Settings window allows you to choose which printer you want to use 
  4005. and how your output will be printed. This window displays a list of all 
  4006. printers installed on your system.  You can select your choice by highlighting 
  4007. it. 
  4008.  
  4009. Select the Font push button to change the font of the print job. 
  4010.  
  4011. Note:  The Execution Density diagram does not have a Font push button. 
  4012.  
  4013. From the Font window, select the appropriate choices. 
  4014.  
  4015. Select the Job properties... push button for more detailed information about 
  4016. your print job. 
  4017.  
  4018. From the Job properties... window, select the appropriate push buttons and 
  4019. check boxes. You can select from the following: 
  4020.  
  4021.      Orientation 
  4022.      Form Configuration 
  4023.      Select Form Source 
  4024.      Select Form 
  4025.      Default Font 
  4026.      Resolution 
  4027.      Performance Options 
  4028.  
  4029.  From the Printer Settings window, select the appropriate push button. 
  4030.  
  4031.  Related Information 
  4032.  
  4033.      Keys Help. 
  4034.  
  4035.  
  4036. ΓòÉΓòÉΓòÉ 16.1.3. Print Selected Region... Choice ΓòÉΓòÉΓòÉ
  4037.  
  4038. Select the Print selected region... choice to print a selected area of the Call 
  4039. Nesting diagram. 
  4040.  
  4041. To print an area of the Call Nesting diagram, highlight the area and then 
  4042. select this choice from the Trace file menu. The Print Selected Region window 
  4043. appears. 
  4044.  
  4045. Related Information 
  4046.  
  4047.      Keys Help. 
  4048.  
  4049.  
  4050. ΓòÉΓòÉΓòÉ <hidden> Print Selected Region Window ΓòÉΓòÉΓòÉ
  4051.  
  4052. The Print Selected Region window displays your printer and job name. Select the 
  4053. appropriate push button to continue. 
  4054.  
  4055. Click on the Print push button to accept the defaults. The diagram will print 
  4056. on the selected printer. 
  4057.  
  4058. Click on the Cancel push button to cancel the print request. 
  4059.  
  4060. Related Information 
  4061.  
  4062.      Keys Help. 
  4063.  
  4064.  
  4065. ΓòÉΓòÉΓòÉ 16.1.4. Window Manager Choice ΓòÉΓòÉΓòÉ
  4066.  
  4067. Select the Window manager choice to display the Window Manager window. 
  4068.  
  4069. Related Information 
  4070.  
  4071.      Performance Analyzer - Window Manager 
  4072.      Keys Help. 
  4073.  
  4074.  
  4075. ΓòÉΓòÉΓòÉ 16.1.5. Exit Performance Analyzer Choice ΓòÉΓòÉΓòÉ
  4076.  
  4077. Select the Exit Performance Analyzer choice from the Trace file menu to exit 
  4078. the application. 
  4079.  
  4080. Related Information 
  4081.  
  4082.      Keys Help. 
  4083.  
  4084.  
  4085. ΓòÉΓòÉΓòÉ 16.2. Call Nesting Edit Menu ΓòÉΓòÉΓòÉ
  4086.  
  4087. The Edit menu allows you to locate and change text in the Call Nesting diagram. 
  4088.  
  4089. Items you can select from this menu include the following: 
  4090.  
  4091.  Find                     Find a function call, function return, an annotation, 
  4092.                           or a user event. 
  4093.  Find Next                Find the next occurrence of the last item you 
  4094.                           searched for. 
  4095.  Annotate                 Insert comments in your diagram. 
  4096.  Select time              Go to a specific time in the diagram. 
  4097.  Select time range        Select all events in a specified time. 
  4098.  Select all               Select the entire Call Nesting diagram. 
  4099.  
  4100.  Related Information 
  4101.  
  4102.      Dynamic Call Graph 
  4103.      Execution Density Diagram 
  4104.      Statistics Diagram 
  4105.      Time Line Diagram 
  4106.      Keys Help. 
  4107.  
  4108.  
  4109. ΓòÉΓòÉΓòÉ 16.2.1. Find Cascading Choice ΓòÉΓòÉΓòÉ
  4110.  
  4111. Select the Find cascading choice to locate text. 
  4112.  
  4113. Items you can select from the cascaded menu include: 
  4114.  
  4115.      Function... for the text of function calls 
  4116.      User Event... to locate user events. 
  4117.      Annotation... to locate annotated text. 
  4118.  
  4119.  Related Information 
  4120.  
  4121.      Keys Help. 
  4122.  
  4123.  
  4124. ΓòÉΓòÉΓòÉ 16.2.1.1. Function Choice ΓòÉΓòÉΓòÉ
  4125.  
  4126. Select the Function choice to search for functions. 
  4127.  
  4128. When you select the Function choice, the Find Function window appears. 
  4129.  
  4130. Related Information 
  4131.  
  4132.      Keys Help. 
  4133.  
  4134.  
  4135. ΓòÉΓòÉΓòÉ 16.2.1.1.1. Find Function Window ΓòÉΓòÉΓòÉ
  4136.  
  4137. Use the Find Function window to search for a specific function in the Call 
  4138. Nesting diagram. You can choose to search when the function was called or 
  4139. returned. 
  4140.  
  4141. Searching for Calls or Returns 
  4142.  
  4143. To search for a function call or return: 
  4144.  
  4145. Note:  The Performance Analyzer begins searching at any area that is 
  4146. highlighted and stops at the end of the diagram. To make sure the entire 
  4147. diagram is searched for a particular function, highlight an area at the top of 
  4148. the diagram before you start the search. 
  4149.  
  4150.    1. Select Find... from the Edit menu in the Call Nesting diagram. 
  4151.  
  4152.    2. Select Function... from the cascaded menu, and the Find Function window 
  4153.       appears. 
  4154.  
  4155.    3. Do any of the following for the Find string entry field: 
  4156.  
  4157.           Leave the entry field blank and press enter to display a list of all 
  4158.            functions in the list box 
  4159.           Enter the file name of the function that you want to display in the 
  4160.            list box 
  4161.           Enter the first few characters of the function file name that you 
  4162.            want to display in the list box 
  4163.           Enter an asterisk (*) and part or all of the function file name that 
  4164.            you want to display in the list box. 
  4165.  
  4166.            Note:  This is useful when you are searching for a C++ de-mangled 
  4167.            function that has class information in front of the function name. 
  4168.  
  4169.       Click on the Case sensitive check box to enable case sensitive searching. 
  4170.  
  4171.    4. Select a function from the list box. 
  4172.  
  4173.           Choose to search for when the function was called or returned. 
  4174.  
  4175.           Select the Call  radio button to find when a function was called. 
  4176.  
  4177.            OR 
  4178.           Select the Return  radio button to find when a function returned. 
  4179.  
  4180.    5. Select the appropriate push button to continue: 
  4181.  
  4182.           OK 
  4183.           Cancel 
  4184.           Help 
  4185.  
  4186.       Note: 
  4187.  
  4188.       The function is highlighted when found. 
  4189.  
  4190.  Related Information 
  4191.  
  4192.      Call Nesting Diagram 
  4193.      Find Annotation Window 
  4194.      Find User Event Window 
  4195.      Keys Help. 
  4196.  
  4197.  
  4198. ΓòÉΓòÉΓòÉ 16.2.1.2. User Event Choice ΓòÉΓòÉΓòÉ
  4199.  
  4200. Select the User event choice to search for user events. 
  4201.  
  4202. When you select the User event choice, the Find User Event window appears. 
  4203.  
  4204. Related Information 
  4205.  
  4206.      Keys Help. 
  4207.  
  4208.  
  4209. ΓòÉΓòÉΓòÉ <hidden> Find User Event Window ΓòÉΓòÉΓòÉ
  4210.  
  4211. Use the Find User Event... window to search for a specific user event in the 
  4212. Call Nesting diagram. 
  4213.  
  4214. Note:  This choice is only available when there are user events or file 
  4215. accesses in the trace file. 
  4216.  
  4217. Find User Event... 
  4218.  
  4219. To search for a user event or file access: 
  4220.  
  4221. Note:  The Performance Analyzer begins searching at any area that is 
  4222. highlighted and stops at the end of the diagram. To make sure the entire 
  4223. diagram is searched for a particular user event, highlight an area at the top 
  4224. of the diagram before you start the search. 
  4225.  
  4226.    1. Select Find... from the Edit menu in the Call Nesting diagram. 
  4227.  
  4228.    2. Select User event... from the cascaded menu, and the Find (User Event) 
  4229.       window appears. 
  4230.  
  4231.    3. Use the Find string entry field, the Case sensitive check box and the 
  4232.       Thread list box in the dialog window to get a list of user events. 
  4233.  
  4234.       Note:  If you don't know the entire string, you can enter an asterisk (*) 
  4235.       with a few characters of the string in the Find string entry field. 
  4236.  
  4237.    4. Select a user event or file access from the list box. 
  4238.  
  4239.    5. Select the appropriate push button to continue: 
  4240.  
  4241.           OK 
  4242.           Cancel 
  4243.           Help. 
  4244.  
  4245.       Note:  The user event is highlighted when found. 
  4246.  
  4247.  Related Information 
  4248.  
  4249.      Call Nesting Diagram 
  4250.      Defining User Events and Creating Prototypes 
  4251.      Find Function Window 
  4252.      Find Annotation Window 
  4253.      Keys Help. 
  4254.  
  4255.  
  4256. ΓòÉΓòÉΓòÉ 16.2.1.3. Annotation Choice ΓòÉΓòÉΓòÉ
  4257.  
  4258. Select the Annotation choice to search for annotations. 
  4259.  
  4260. When you select the Annotation choice, the Find Annotation window appears. 
  4261.  
  4262. Related Information 
  4263.  
  4264.      Keys Help. 
  4265.  
  4266.  
  4267. ΓòÉΓòÉΓòÉ <hidden> Find Annotation Window ΓòÉΓòÉΓòÉ
  4268.  
  4269. Use the Find Annotation...  window to search for a specific annotation in the 
  4270. Call Nesting diagram. 
  4271.  
  4272. Find Annotation... 
  4273.  
  4274. To search for an annotation: 
  4275.  
  4276. Note:  The Performance Analyzer begins searching at any area that is 
  4277. highlighted and stops at the end of the diagram. To make sure the entire 
  4278. diagram is searched for a particular annotation, highlight an area at the top 
  4279. of the diagram before you start the search. 
  4280.  
  4281.    1. Select Find... from the Edit menu in the Call Nesting diagram. 
  4282.  
  4283.    2. Select Annotation... from the cascaded menu, and the Find (Annotation) 
  4284.       window appears. 
  4285.  
  4286.    3. Follow the directions in the dialog window to get a list of all 
  4287.       annotations. 
  4288.  
  4289.       Note:  If you don't know the entire annotation, you can enter an asterisk 
  4290.       (*) with a few characters of the annotation in the Find string entry 
  4291.       field. 
  4292.  
  4293.    4. Select an annotation from the list box. 
  4294.  
  4295.    5. Select the appropriate push button to continue: 
  4296.  
  4297.           OK 
  4298.           Cancel 
  4299.           Help 
  4300.  
  4301.       Note:  The annotated comment is highlighted when found. 
  4302.  
  4303.  Related Information 
  4304.  
  4305.      Call Nesting Diagram 
  4306.      Find Function Window 
  4307.      Find User Event Window 
  4308.      Keys Help. 
  4309.  
  4310.  
  4311. ΓòÉΓòÉΓòÉ 16.2.2. Find Next Choice ΓòÉΓòÉΓòÉ
  4312.  
  4313. Select the Find next choice to locate the next instance of the searched text. 
  4314.  
  4315. To find the next occurrence, select Find next from the Edit menu. Press the 
  4316. Enter key to start the search. The string is highlighted when found. A message 
  4317. box appears if the string cannot be found. 
  4318.  
  4319. Related Information 
  4320.  
  4321.      Call Nesting Diagram Pop-up Menu 
  4322.      Find Function Window 
  4323.      Find User Event Window 
  4324.      Find Annotation Window 
  4325.      Keys Help. 
  4326.  
  4327.  
  4328. ΓòÉΓòÉΓòÉ 16.2.3. Annotate... Choice ΓòÉΓòÉΓòÉ
  4329.  
  4330. Select the Annotate... choice to add notes that will appear on the screen, or 
  4331. to change or delete existing annotated text. The annotated comments that are 
  4332. added to the diagram are saved, and will appear on the screen to the right of 
  4333. the function name. 
  4334.  
  4335. When you select the Annotate... choice, an Annotate window appears. 
  4336.  
  4337. Related Information 
  4338.  
  4339.      Call Nesting Selected Item Pop-up Menu 
  4340.      Keys Help. 
  4341.  
  4342.  
  4343. ΓòÉΓòÉΓòÉ <hidden> Annotate Window ΓòÉΓòÉΓòÉ
  4344.  
  4345. Use the Annotate window to add annotated comments to the Call Nesting diagram. 
  4346. The Performance Analyzer saves the comments to the trace file so you can see 
  4347. the comments later. 
  4348.  
  4349. Adding Annotated Comments 
  4350.  
  4351. To add an annotated comment to the diagram: 
  4352.  
  4353.    1. Click on the function where you want to add the comment. 
  4354.  
  4355.    2. Select the Annotation  choice from the Edit  menu. 
  4356.  
  4357.    3. Type the comment in the window. The comment is limited to 64 characters. 
  4358.  
  4359.    4. Select the appropriate push button to continue: 
  4360.  
  4361.           Add/Change 
  4362.           Remove 
  4363.           Cancel 
  4364.           Help. 
  4365.  
  4366.  Deleting Annotated Comments 
  4367.  
  4368.  To delete an annotated comment: 
  4369.  
  4370.    1. Click on the comment you want to remove. 
  4371.  
  4372.    2. Select Annotate...  from the Edit menu. 
  4373.  
  4374.    3. Remove the comment. 
  4375.  
  4376.  Related Information 
  4377.  
  4378.      Find Annotation Window 
  4379.      Defining User Events 
  4380.      Call Nesting Selected Item Pop-up Menu 
  4381.      Keys Help. 
  4382.  
  4383.  
  4384. ΓòÉΓòÉΓòÉ 16.2.4. Select Time... Choice ΓòÉΓòÉΓòÉ
  4385.  
  4386. Select the Select time... choice to scroll and select highlighted functions 
  4387. occurring at a specified time. 
  4388.  
  4389. Select the Select time...  choice to go to a specific time in the diagram. When 
  4390. you select Select time..., the Select Time window appears. 
  4391.  
  4392. Related Information 
  4393.  
  4394.      Keys Help. 
  4395.  
  4396.  
  4397. ΓòÉΓòÉΓòÉ 16.2.4.1. Select Time Window ΓòÉΓòÉΓòÉ
  4398.  
  4399. Use the Select Time  window to go to a specific time in the diagram. 
  4400.  
  4401. Going to a Specific Time 
  4402.  
  4403. To select the time: 
  4404.  
  4405.    1. Select the appropriate radio button: 
  4406.  
  4407.           Seconds (s) 
  4408.           Milliseconds (ms) 
  4409.           Microseconds (us) 
  4410.  
  4411.    2. Use the spin buttons to select the time you want to display. 
  4412.  
  4413.    3. Select the appropriate push button to continue: 
  4414.  
  4415.           OK 
  4416.           Cancel 
  4417.           Help. 
  4418.  
  4419.  Related Information 
  4420.  
  4421.      Select Time Window 
  4422.      Keys Help. 
  4423.  
  4424.  
  4425. ΓòÉΓòÉΓòÉ 16.2.5. Select Time Range... Choice ΓòÉΓòÉΓòÉ
  4426.  
  4427. Select the Select time range... choice to scroll to all highlighted functions. 
  4428.  
  4429. Select the Select time range... choice to chose a specific period of time to 
  4430. view. When you select the Select time range... choice, the Select Time Range 
  4431. window appears. 
  4432.  
  4433. Related Information 
  4434.  
  4435.      Select Time Range Window 
  4436.      Keys Help. 
  4437.  
  4438.  
  4439. ΓòÉΓòÉΓòÉ 16.2.5.1. Select Time Range Window ΓòÉΓòÉΓòÉ
  4440.  
  4441. Use the Select Time Range window to view a specific period of time. The Select 
  4442. Time Range window shows you a range of time. 
  4443.  
  4444. Selecting Time Periods 
  4445.  
  4446. To select the time period: 
  4447.  
  4448.    1. In the Start time list box, use the spin buttons to select the start time 
  4449.       you want to highlight. 
  4450.  
  4451.    2. To select the time, select the appropriate radio button: 
  4452.  
  4453.           seconds (s), 
  4454.           milliseconds (ms), 
  4455.           microseconds (us). 
  4456.  
  4457.    3. In the End time list box, use the spin buttons to select the end time, 
  4458.       where the highlight will stop. 
  4459.  
  4460.    4. To select the time, select the appropriate radio button: 
  4461.  
  4462.           seconds (s), 
  4463.           milliseconds (ms), 
  4464.           microseconds (us). 
  4465.  
  4466.    5. Select the appropriate push button to continue: 
  4467.  
  4468.           OK 
  4469.           Cancel 
  4470.           Help. 
  4471.  
  4472.  Related Information 
  4473.  
  4474.      Select Time Window 
  4475.      Keys Help. 
  4476.  
  4477.  
  4478. ΓòÉΓòÉΓòÉ 16.2.6. Select All Choice ΓòÉΓòÉΓòÉ
  4479.  
  4480. Select the Select all... choice to select and highlight all functions. 
  4481.  
  4482. Select the Select all choice to highlight the entire diagram. To remove the 
  4483. highlighting, select a specific function. 
  4484.  
  4485. Related Information 
  4486.  
  4487.      Keys Help. 
  4488.  
  4489.  
  4490. ΓòÉΓòÉΓòÉ 16.3. Call Nesting View Menu ΓòÉΓòÉΓòÉ
  4491.  
  4492. The View menu allows you to change displayed information. 
  4493.  
  4494. Items you can select from this menu include the following: 
  4495.  
  4496.  Include Functions 
  4497.            Controls the functions to include or exclude in the diagram. 
  4498.  
  4499.  Include Threads. 
  4500.            Controls the threads to include or exclude in the diagram. 
  4501.  
  4502.  Related Information 
  4503.  
  4504.      Dynamic Call Graph 
  4505.      Execution Density Diagram 
  4506.      Statistics Diagram 
  4507.      Time Line Diagram 
  4508.      Keys Help. 
  4509.  
  4510.  
  4511. ΓòÉΓòÉΓòÉ 16.3.1. Include Functions... Choice ΓòÉΓòÉΓòÉ
  4512.  
  4513. Select the Include functions... choice to list all the functions in the trace 
  4514. file and select one or more for viewing. 
  4515.  
  4516. Note:  Any items on the call stack that lead to the selected function will also 
  4517.        be displayed. 
  4518.  
  4519.  When you select Include functions..., the Include Functions window is 
  4520.  displayed. 
  4521.  
  4522.  Related Information 
  4523.  
  4524.      Call Nesting Diagram Pop-up Menu 
  4525.      Keys Help. 
  4526.  
  4527.  
  4528. ΓòÉΓòÉΓòÉ 16.3.1.1. Include Functions Window ΓòÉΓòÉΓòÉ
  4529.  
  4530. Use the Include Functions  window to isolate specific functions or view all 
  4531. functions. This window filters the trace file allowing you to isolate specific 
  4532. areas of interest or areas where problems are occurring. 
  4533.  
  4534. Isolating Specific Functions 
  4535.  
  4536. To include functions: 
  4537.  
  4538.    1. Scroll the list to find the function or functions you want displayed. 
  4539.  
  4540.    2. Highlight each function you want displayed. 
  4541.  
  4542.    3. Select the appropriate push button to continue: 
  4543.  
  4544.           OK 
  4545.           Cancel 
  4546.           Help 
  4547.  
  4548.  Note:  All calls which called the selected function are also displayed. 
  4549.  
  4550.  Viewing All Functions 
  4551.  
  4552.    1. To select all functions, select the Select all push button. 
  4553.  
  4554.    2. Select the appropriate push button to continue: 
  4555.  
  4556.           OK 
  4557.           Cancel 
  4558.           Help 
  4559.  
  4560.  Viewing A Specific Function 
  4561.  
  4562.    1. To select a specific function, select the Deselect all push button. 
  4563.  
  4564.    2. Select a specific function. 
  4565.  
  4566.    3. Select the appropriate push button to continue: 
  4567.  
  4568.           OK 
  4569.           Cancel 
  4570.           Help 
  4571.  
  4572.  Related Information 
  4573.  
  4574.      Call Nesting Diagram Pop-up Menu 
  4575.      Keys Help. 
  4576.  
  4577.  
  4578. ΓòÉΓòÉΓòÉ 16.3.2. Include Threads... Choice ΓòÉΓòÉΓòÉ
  4579.  
  4580. Select the Include threads... choice to select which threads are displayed in 
  4581. the diagram. 
  4582.  
  4583. Use the Include threads...  choice to filter the trace file, which allows you 
  4584. to isolate specific areas of interest or areas where problems are occurring. 
  4585.  
  4586. When you select Include threads..., the Include Threads window is displayed. 
  4587.  
  4588. Related Information 
  4589.  
  4590.      Call Nesting Diagram Pop-up Menu 
  4591.      Keys Help. 
  4592.  
  4593.  
  4594. ΓòÉΓòÉΓòÉ 16.3.2.1. Include Threads Window ΓòÉΓòÉΓòÉ
  4595.  
  4596. Use the Include Threads window to select or isolate specific threads, and to 
  4597. enable and display specific pattern recognitions in the Call Nesting diagram. 
  4598.  
  4599. Use the mouse to highlight your thread selection. You can choose a particular 
  4600. thread or all threads. 
  4601.  
  4602. You can also enable Pattern Recognition  from this window. Pattern recognition 
  4603. looks at a single thread and finds patterns of calls and returns. When this 
  4604. choice is enabled, the Call Nesting diagram displays these patterns as a curved 
  4605. arc and the number of repetitions are on the right. 
  4606.  
  4607. Note:  Pattern Recognition can only be enabled when a single thread pattern is 
  4608. displayed. When Pattern Recognition is enabled, the Call Nesting diagram will 
  4609. not display annotations. 
  4610.  
  4611. Selecting Specific Threads 
  4612.  
  4613. To select a specific threads: 
  4614.  
  4615.    1. Select the specific threads you want to display. 
  4616.  
  4617.    2. Select the appropriate push button to continue: 
  4618.  
  4619.           OK 
  4620.           Cancel 
  4621.           Help. 
  4622.  
  4623.  Displaying Patterns 
  4624.  
  4625.  To display the patterns for a thread: 
  4626.  
  4627.    1. Select the specific threads you want to display. 
  4628.  
  4629.    2. Select the Pattern Recognition check box. 
  4630.  
  4631.    3. Select the appropriate push button to continue: 
  4632.  
  4633.           OK 
  4634.           Cancel 
  4635.           Help. 
  4636.  
  4637.  Selecting All Threads 
  4638.  
  4639.  To select all threads: 
  4640.  
  4641.    1. Highlight All threads to select all threads. 
  4642.  
  4643.    2. Select the appropriate push button to continue: 
  4644.  
  4645.           OK 
  4646.           Cancel 
  4647.           Help 
  4648.  
  4649.  Related Information 
  4650.  
  4651.      Call Nesting Diagram Pop-up Menu 
  4652.      Keys Help. 
  4653.  
  4654.  
  4655. ΓòÉΓòÉΓòÉ 16.4. Call Nesting Options Menu ΓòÉΓòÉΓòÉ
  4656.  
  4657. The Options menu allows you to customize the Call Nesting diagram and display 
  4658. additional information. 
  4659.  
  4660. The following choices are available from the Options menu: 
  4661.  
  4662.  Call Stack               Displays all the functions currently on the call 
  4663.                           stack from a selected point. 
  4664.  Correlation...           Synchronizes other diagrams to display the same 
  4665.                           highlighted region. 
  4666.  Font                     Selects the font, font style, and font size for the 
  4667.                           function names. 
  4668.  Thread layout            Selects the indentation amount for each thread column 
  4669.                           and draws separator bars between threads. 
  4670.  Status Area              Area at top of window that describes the diagram. You 
  4671.                           can select which items will appear in the Status 
  4672.                           Area. 
  4673.  Tool bar                 Use the Tool bar for a shortcut to other menus. 
  4674.  Settings                 Select to save the current settings or restore the 
  4675.                           defaults. 
  4676.                           Save           Select to save the current settings. 
  4677.  
  4678.                           Restore initial defaults Select to restore initial 
  4679.                                          defaults. 
  4680.  
  4681.  Related Information 
  4682.  
  4683.      Dynamic Call Graph 
  4684.      Execution Density Diagram 
  4685.      Statistics Diagram 
  4686.      Time Line Diagram 
  4687.      Call Nesting Diagram Pop-up Menu 
  4688.      Call Nesting Selected Item Pop-up Menu 
  4689.      Keys Help. 
  4690.  
  4691.  
  4692. ΓòÉΓòÉΓòÉ 16.4.1. Call Stack... Choice ΓòÉΓòÉΓòÉ
  4693.  
  4694. Select the Call stack... choice to display the hierarchy of function calls in a 
  4695. thread. 
  4696.  
  4697. When you select the Call stack... choice, a Call Stack window appears. 
  4698.  
  4699. Related Information 
  4700.  
  4701.      Call Nesting Selected Item Pop-up Menu 
  4702.      Keys Help. 
  4703.  
  4704.  
  4705. ΓòÉΓòÉΓòÉ <hidden> Call Stack Window ΓòÉΓòÉΓòÉ
  4706.  
  4707. Select the Call Stack  window to display the order in which the functions were 
  4708. called at a selected point. 
  4709.  
  4710. Displaying the Call Stack 
  4711.  
  4712. To display a call stack for a function: 
  4713.  
  4714.    1. Click on a function to select it. 
  4715.  
  4716.    2. Select Call Stack  from the Options menu. A Call  Stack window appears 
  4717.       the function you selected and its parents (called functions) in the order 
  4718.       in which they were called. 
  4719.  
  4720.    3. Select the appropriate push button to continue: 
  4721.  
  4722.           OK 
  4723.           Help. 
  4724.  
  4725.  Related Information 
  4726.  
  4727.      Call Nesting Diagram 
  4728.      Call Nesting Selected Item Pop-up Menu 
  4729.      Keys Help. 
  4730.  
  4731.  
  4732. ΓòÉΓòÉΓòÉ 16.4.2. Correlation... Choice ΓòÉΓòÉΓòÉ
  4733.  
  4734. Select the Correlation... choice to show the location of a particular function 
  4735. in the Call Nesting window with other available views. 
  4736.  
  4737. When you select the Correlation... choice, the Correlation window appears. 
  4738.  
  4739. Related Information 
  4740.  
  4741.      Call Nesting Selected Item Pop-up Menu 
  4742.      Keys Help. 
  4743.  
  4744.  
  4745. ΓòÉΓòÉΓòÉ 16.4.3. Font... Choice ΓòÉΓòÉΓòÉ
  4746.  
  4747. Select the Font... choice to change the font, font style, and font size for the 
  4748. text area of the Call Nesting window. This choice is available from the Options 
  4749. menu of the Call Nesting window. 
  4750.  
  4751. When you select the Font... choice, the When you select this choice, the Font 
  4752. window appears. 
  4753.  
  4754. The Font window has the following areas: 
  4755.  
  4756.  Name entry field      Type a font name in this entry field or click on the 
  4757.                        scroll bar on the right side of the entry field to see a 
  4758.                        list of choices and select a name from the list. 
  4759.  Size entry field      Type a font size in this entry field or click on the 
  4760.                        scroll bar on the right side of the entry field to see a 
  4761.                        list of choices and select a size from the list. 
  4762.  Style entry field     Type a font style in this entry field or click on the 
  4763.                        scroll bar on the right side of the entry field to see a 
  4764.                        list of choices and select a style from the list. 
  4765.  Emphasis check boxes  Click on one of these check boxes to outline, 
  4766.                        underscore, or strikeout text. 
  4767.  Sample box            This box shows a sample of how text will appear with the 
  4768.                        settings you have selected. 
  4769.  Ok push button        Changes the font according to the settings you selected. 
  4770.  Reset push button     Changes all font settings to the default settings. 
  4771.  Cancel push button    Closes the window without making changes. 
  4772.  
  4773.  Related Information 
  4774.  
  4775.      Call Nesting Diagram Pop-up Menu 
  4776.      Keys Help. 
  4777.  
  4778.  
  4779. ΓòÉΓòÉΓòÉ <hidden> Correlation Window ΓòÉΓòÉΓòÉ
  4780.  
  4781. Use the Correlation  window to mark a point in a chronologically-scaled 
  4782. diagram, such as the Call Nesting diagram, Execution Density diagram, or Time 
  4783. Line diagram, and then find that same point in another chronologically-scaled 
  4784. diagram. 
  4785.  
  4786. To correlate two or more diagrams using the Correlation... choice: 
  4787.  
  4788.    1. Open your trace file in a diagram that has correlation capability (Call 
  4789.       Nesting, Execution Density, or Time Line). 
  4790.  
  4791.    2. Open at least one other window with a different diagram or the same 
  4792.       diagram at a different scale. (You can change a diagram's scale by 
  4793.       selecting the Zoom in or Zoom out choice.) 
  4794.  
  4795.    3. Highlight the area between the events of interest in one of the diagrams. 
  4796.       To highlight an area: 
  4797.  
  4798.         a. Click and hold mouse button one on the first event. 
  4799.  
  4800.         b. While holding mouse button one, drag the pointer to the last event. 
  4801.  
  4802.         c. Release the mouse button. 
  4803.  
  4804.    4. Select Correlation... from the Options menu. The Correlation  window 
  4805.       appears. 
  4806.  
  4807.    5. Select the name of each diagram you want to correlate. 
  4808.  
  4809.    6. Select the appropriate push button to continue: 
  4810.  
  4811.           OK 
  4812.           Select all 
  4813.           Deselect all 
  4814.           Cancel 
  4815.           Help. 
  4816.  
  4817.       When you select the OK  push button, the Performance Analyzer highlights 
  4818.       correlated points in the selected diagrams. 
  4819.  
  4820.  To correlate two or more diagrams using the drag and drop method: 
  4821.  
  4822.    1. Open your trace file in a diagram that has correlation capability (Call 
  4823.       Nesting, Execution Density, or Time Line). 
  4824.    2. Open a second diagram that allows correlation (Call Nesting, Execution 
  4825.       Density, or Time Line) or open a second window of the same diagram and 
  4826.       change its scale. (You can change the scale by selecting the Zoom in or 
  4827.       Zoom out choice.) 
  4828.    3. Highlight the area between the events of interest in one of the diagrams. 
  4829.       To highlight an area: 
  4830.         a. Click and hold mouse button one on the first event. 
  4831.  
  4832.         b. While holding mouse button one, drag the pointer to the last event. 
  4833.  
  4834.         c. Release the mouse button. 
  4835.    4. Click and hold mouse button two on the diagram that you highlighted, drag 
  4836.       the mouse to the other diagram, and then release the button. 
  4837.  
  4838.       The area you highlighted first is highlighted in the other diagram. 
  4839.  
  4840.  Related Information 
  4841.  
  4842.      Zoom In Choice 
  4843.      Zoom Out Choice 
  4844.      Call Nesting Diagram 
  4845.      Call Nesting Diagram Pop-up Menu 
  4846.      Execution Density Diagram 
  4847.      Time Line Diagram 
  4848.      Keys Help. 
  4849.  
  4850.  
  4851. ΓòÉΓòÉΓòÉ 16.4.4. Thread layout... Choice ΓòÉΓòÉΓòÉ
  4852.  
  4853. Select the Thread layout... choice to arrange the starting placement of 
  4854. multiple threads within the Call Nesting window. 
  4855.  
  4856. When you select Thread layout..., a Thread Layout window appears. 
  4857.  
  4858. Related Information 
  4859.  
  4860.      Call Nesting Diagram Pop-up Menu 
  4861.      Keys Help. 
  4862.  
  4863.  
  4864. ΓòÉΓòÉΓòÉ 16.4.4.1. Thread Layout Window ΓòÉΓòÉΓòÉ
  4865.  
  4866. Use the Thread Layout  window to control the thread indentation and to control 
  4867. whether separator bars are drawn between the threads. 
  4868.  
  4869. Controlling Indentation and Separator Bars 
  4870.  
  4871. To use the Thread Layout  window: 
  4872.  
  4873.    1. Select the spin buttons in the Indents per thread entry field until the 
  4874.       value you want displays. The maximum indentation value is 20 pixels. 
  4875.  
  4876.    2. Select the check box to draw separator lines between the threads. A check 
  4877.       mark symbol in the box indicates to draw separator bars and an empty box 
  4878.       indicates not to draw the separator bars. 
  4879.  
  4880.    3. Select the appropriate push button to continue: 
  4881.  
  4882.           Set 
  4883.           Apply 
  4884.           Cancel 
  4885.           Help. 
  4886.  
  4887.  Related Information 
  4888.  
  4889.      Call Nesting Diagram 
  4890.      Time Line Diagram 
  4891.      Call Nesting Diagram Pop-up Menu 
  4892.      Keys Help. 
  4893.  
  4894.  
  4895. ΓòÉΓòÉΓòÉ 16.4.5. Status Area... Choice ΓòÉΓòÉΓòÉ
  4896.  
  4897. The Status Area, located at the top of the window, describes the settings of 
  4898. the diagram. 
  4899.  
  4900. Select the Status area... choice to change the appearance of the area at the 
  4901. top of the Call Nesting window. 
  4902.  
  4903. You can select Status area from the Options menu and a Status area 
  4904.  
  4905. When you select the Status area... choice, the Status Area window. appears. 
  4906.  
  4907. Related Information 
  4908.  
  4909.      Keys Help. 
  4910.  
  4911.  
  4912. ΓòÉΓòÉΓòÉ 16.4.5.1. Status Area Window ΓòÉΓòÉΓòÉ
  4913.  
  4914. Use the Status Area  window to control the area at the top of the window. 
  4915.  
  4916. The check boxes represent the choices in the Status Area that you can show or 
  4917. hide. When you disable the check box the choice is hidden. Likewise, when you 
  4918. enable the check box the choice displays in the Status Area. 
  4919.  
  4920. In each diagram the Status Area displays different information. When you select 
  4921. the Status Area  window, the choices in the window change based upon the Status 
  4922. Area of the diagram. 
  4923.  
  4924. Choices from the Status Area include: 
  4925.  
  4926.      Trace Description 
  4927.      Filters 
  4928.  
  4929.  Select the appropriate check box to continue. 
  4930.  
  4931.  Related Information 
  4932.  
  4933.      Dynamic Call Graph Status Area Window 
  4934.      Execution Density Status Area Window 
  4935.      Time Line Status Area. Window 
  4936.      Keys Help. 
  4937.  
  4938.  
  4939. ΓòÉΓòÉΓòÉ 16.4.6. Tool Bar Cascading Choice ΓòÉΓòÉΓòÉ
  4940.  
  4941. Select the Tool bar cascading choice to have the Tool bar display or not 
  4942. display in your window, and to enable and disable the Hover help. 
  4943.  
  4944. The choices from the Tool bar cascaded menu are: 
  4945.  
  4946.  Show                     Choose to either show or hide the Tool bar. 
  4947.  Hover                    Choose to either enable or disable displaying the 
  4948.                           help text when the mouse pointer hovers over the Tool 
  4949.                           bar buttons. 
  4950.  
  4951.  Related Information 
  4952.  
  4953.      Keys Help. 
  4954.  
  4955.  
  4956. ΓòÉΓòÉΓòÉ 16.4.6.1. Tool Bar Show Choice ΓòÉΓòÉΓòÉ
  4957.  
  4958. Select the Show choice from the Tool bar cascaded menu to show the Tool bar in 
  4959. your window. When the Show choice is enabled, a check mark will appear beside 
  4960. the choice. 
  4961.  
  4962. Select the Show choice again to remove the check mark and the Tool bar choice 
  4963. will be disabled. 
  4964.  
  4965. Related Information 
  4966.  
  4967.      Tool Bar Hover Choice 
  4968.      Keys Help. 
  4969.  
  4970.  
  4971. ΓòÉΓòÉΓòÉ 16.4.6.2. Tool Bar Hover Choice ΓòÉΓòÉΓòÉ
  4972.  
  4973. Select the Hover choice from the Tool Bar cascaded menu to display the name of 
  4974. the Tool bar function it represents when you position the mouse pointer over 
  4975. the buttons. When the Hover choice is enabled, a check mark will appear beside 
  4976. the choice. 
  4977.  
  4978. Select the Hover choice again to remove the check mark and the Hover choice 
  4979. will be disabled. 
  4980.  
  4981. Related Information 
  4982.  
  4983.      Tool Bar Show Choice 
  4984.      Keys Help. 
  4985.  
  4986.  
  4987. ΓòÉΓòÉΓòÉ 16.4.7. Settings Cascading Choice ΓòÉΓòÉΓòÉ
  4988.  
  4989. Select the Settings cascading choice to save changes made to the Call Nesting 
  4990. window or to restore the defaults. 
  4991.  
  4992. The choices from the Settings cascaded menu are: 
  4993.  
  4994.  Save                     Save the current session settings. 
  4995.  Restore initial defaults Restore the original settings. 
  4996.  
  4997.  Related Information 
  4998.  
  4999.      Save Choice 
  5000.      Restore Initial Defaults Choice 
  5001.      Keys Help. 
  5002.  
  5003.  
  5004. ΓòÉΓòÉΓòÉ 16.4.7.1. Save Choice ΓòÉΓòÉΓòÉ
  5005.  
  5006. Select the Save choice to save the current settings. These settings are stored 
  5007. in the ICSPERF.INI file and remain active until that file is erased. 
  5008.  
  5009. To restore the default settings, select the Restore defaults choice. 
  5010.  
  5011. Related Information 
  5012.  
  5013.      Restore Initial Defaults Choice 
  5014.      Keys Help. 
  5015.  
  5016.  
  5017. ΓòÉΓòÉΓòÉ 16.4.7.2. Restore Initial Defaults Choice ΓòÉΓòÉΓòÉ
  5018.  
  5019. Select the Restore initial defaults choice to change to the original or default 
  5020. settings. You can select the Save choice to save settings. 
  5021.  
  5022. Related Information 
  5023.  
  5024.      Save Choice 
  5025.      Keys Help. 
  5026.  
  5027.  
  5028. ΓòÉΓòÉΓòÉ 16.5. Call Nesting Project Menu ΓòÉΓòÉΓòÉ
  5029.  
  5030. This menu appears when you start the Performance Analyzer from within the 
  5031. WorkFrame environment. The Project menu gives you direct access to all of the 
  5032. actions that you can perform from your current location. 
  5033.  
  5034. When you select the Edit function choice from this menu, the source code for 
  5035. the selected function is displayed in the default editor for WorkFrame's edit 
  5036. action. 
  5037.  
  5038. Related Information 
  5039.  
  5040.      Search Paths Window 
  5041.      Trace Generation Window 
  5042.      Keys Help 
  5043.  
  5044.  
  5045. ΓòÉΓòÉΓòÉ 16.5.1. Edit Function Choice ΓòÉΓòÉΓòÉ
  5046.  
  5047. Select the Edit function choice to edit a source file in WorkFrame's default 
  5048. editor. This choice lets you edit the source for a function selected on the 
  5049. Call Nesting diagram. When you are working in the WorkFrame environment, this 
  5050. choice is available from the Project menu on the Call Nesting diagram. It is 
  5051. also available from the Selected Item pop-up menu on the Call Nesting diagram. 
  5052.  
  5053. To locate a source file for editing, the Performance Analyzer must first locate 
  5054. the executable containing the name of the source file. The Performance Analyzer 
  5055. searches the following paths (in the order listed) to locate an executable: 
  5056.  
  5057.    1. Path specified in the Locate Executable window 
  5058.    2. Path specified in the Search path for executable files: entry field of 
  5059.       the Search Paths window 
  5060.    3. Directory where the executable was located when the trace file was 
  5061.       created 
  5062.    4. The current working directory 
  5063.    5. Path specified by the PATH environment variable. 
  5064.  
  5065.  To identify the name of the source file, the Performance Analyzer looks at the 
  5066.  debug information in the executable. The Performance Analyzer then searches 
  5067.  the following paths (in the order listed) to locate the source file: 
  5068.  
  5069.    1. Path specified in the Locate Source File window 
  5070.    2. Path specified in the Search path for source files: entry field of the 
  5071.       Search Paths window 
  5072.    3. Path specified in the compile statement (if provided) 
  5073.    4. Directory where the executable was located when the trace file was 
  5074.       created 
  5075.    5. The current working directory 
  5076.    6. Path specified by the INCLUDE environment variable. 
  5077.  
  5078.  If, after searching these paths, the Performance Analyzer cannot find the: 
  5079.  
  5080.    1. Executable, it displays the Locate Executable window to let you enter the 
  5081.       path where the executable resides. 
  5082.    2. Source file, it displays the Locate Source File window to let you enter 
  5083.       the path where the source file resides. 
  5084.  
  5085.  Once the source file for a function is located, the file is opened to the 
  5086.  first line of the function's code. 
  5087.  
  5088.  Notes 
  5089.  
  5090.    1. The Performance Analyzer remembers the paths you enter in the Locate 
  5091.       Executable and Locate Source File windows and uses them to look for files 
  5092.       the next time you select the Edit function choice. 
  5093.    2. You can specify paths that you want the Performance Analyzer to use by 
  5094.       selecting the Search Paths choice in the Options menu on the Performance 
  5095.       Analyzer - Window Manager window. The paths you enter are automatically 
  5096.       saved for the current session. If you want to save the paths for 
  5097.       subsequent sessions, select the Options menu and then select the Save 
  5098.       choice from the Settings cascaded menu. 
  5099.  
  5100.  Related Information 
  5101.  
  5102.      Locate Executable Window 
  5103.      Locate Source File Window 
  5104.      Search Paths Window 
  5105.      Starting the Performance Analyzer from WorkFrame 
  5106.      Keys Help. 
  5107.  
  5108.  
  5109. ΓòÉΓòÉΓòÉ 16.6. Call Nesting Help Menu ΓòÉΓòÉΓòÉ
  5110.  
  5111. The Help menu has the following choices: 
  5112.  
  5113.  Help index          Displays an index of Help topics. 
  5114.  General help        Displays Help for the active window. 
  5115.  Using help          Describes how to use Help. 
  5116.  How do I?           Displays task Help. 
  5117.  Product information Displays information about the Performance Analyzer. 
  5118.  
  5119.  Related Information 
  5120.  
  5121.      Call Nesting Diagram 
  5122.      Dynamic Call Graph 
  5123.      Execution Density Diagram 
  5124.      Statistics Diagram 
  5125.      Time Line Diagram 
  5126.      Hints and Tips 
  5127.      Keys Help. 
  5128.  
  5129.  
  5130. ΓòÉΓòÉΓòÉ 16.6.1. Help Index Choice ΓòÉΓòÉΓòÉ
  5131.  
  5132. Select the Help index choice to display an alphabetical index of Performance 
  5133. Analyzer Help topics. This choice is available from the Help menu of the Call 
  5134. Nesting diagram. 
  5135.  
  5136. Use the Previous push button to return to the last topic you viewed. Use the 
  5137. Search... push button to locate topics in the index. Use the Print... push 
  5138. button to print a topic. 
  5139.  
  5140. Related Information 
  5141.  
  5142.      Call Nesting Diagram 
  5143.      Dynamic Call Graph 
  5144.      Execution Density Diagram 
  5145.      Statistics Diagram 
  5146.      Time Line Diagram 
  5147.      Hints and Tips 
  5148.      Keys Help. 
  5149.  
  5150.  
  5151. ΓòÉΓòÉΓòÉ 16.6.2. General Help Choice ΓòÉΓòÉΓòÉ
  5152.  
  5153. Select the General help choice to display Help information for the active 
  5154. window. This choice is available from the Help menu of the Call Nesting 
  5155. diagram. 
  5156.  
  5157. The online Help panel displayed is the same panel that is displayed when you 
  5158. place your cursor inside the window and press F1. 
  5159.  
  5160. Related Information 
  5161.  
  5162.      Call Nesting Diagram 
  5163.      Dynamic Call Graph 
  5164.      Execution Density Diagram 
  5165.      Statistics Diagram 
  5166.      Time Line Diagram 
  5167.      Hints and Tips 
  5168.      Keys Help. 
  5169.  
  5170.  
  5171. ΓòÉΓòÉΓòÉ 16.6.3. Using Help Choice ΓòÉΓòÉΓòÉ
  5172.  
  5173. Select the Using help choice for a description of how to use the IBM 
  5174. Performance Analyzer Help facility. This choice is available from the Help menu 
  5175. of the Call Nesting diagram. 
  5176.  
  5177. Related Information 
  5178.  
  5179.      Call Nesting Diagram 
  5180.      Dynamic Call Graph 
  5181.      Execution Density Diagram 
  5182.      Statistics Diagram 
  5183.      Time Line Diagram 
  5184.      Hints and Tips 
  5185.      Keys Help. 
  5186.  
  5187.  
  5188. ΓòÉΓòÉΓòÉ 16.6.4. How Do I? Choice ΓòÉΓòÉΓòÉ
  5189.  
  5190. Select the How do I? choice to display the Performance Analyzer task help. This 
  5191. choice is available from the Help menu of the Call Nesting diagram. 
  5192.  
  5193. Related Information 
  5194.  
  5195.      Call Nesting Diagram 
  5196.      Dynamic Call Graph 
  5197.      Execution Density Diagram 
  5198.      Statistics Diagram 
  5199.      Time Line Diagram 
  5200.      Hints and Tips 
  5201.      Keys Help. 
  5202.  
  5203.  
  5204. ΓòÉΓòÉΓòÉ 16.6.5. Product Information Choice ΓòÉΓòÉΓòÉ
  5205.  
  5206. Select the Product information choice to display copyright and version 
  5207. information about the Performance Analyzer application. This choice is 
  5208. available from the Help menu of the Call Nesting diagram. 
  5209.  
  5210. Related Information 
  5211.  
  5212.      Call Nesting Diagram 
  5213.      Dynamic Call Graph 
  5214.      Execution Density Diagram 
  5215.      Statistics Diagram 
  5216.      Time Line Diagram 
  5217.      Hints and Tips 
  5218.      Keys Help. 
  5219.  
  5220.  
  5221. ΓòÉΓòÉΓòÉ 16.7. Call Nesting Status Area ΓòÉΓòÉΓòÉ
  5222.  
  5223. The Status Area, located at the top of the window, describes the settings of 
  5224. the diagram. 
  5225.  
  5226. You can select the Status area... choice to change the appearance of the area 
  5227. at the top of the Call Nesting window. 
  5228.  
  5229. When you select the Status area... choice, the Status Area window. appears. 
  5230.  
  5231. The choices in the Status area window include: 
  5232.  
  5233.  Trace description 
  5234.            Select for a brief description of the trace file. 
  5235.  Filters 
  5236.            Select to display selected filters. 
  5237.  
  5238.  Related Information 
  5239.  
  5240.      Dynamic Call Graph Status Area 
  5241.      Execution Density Status Area 
  5242.      Time Line Status Area 
  5243.      Keys Help. 
  5244.  
  5245.  
  5246. ΓòÉΓòÉΓòÉ 16.8. Call Nesting Diagram Pop-up Menu ΓòÉΓòÉΓòÉ
  5247.  
  5248. The pop-up menus allow you to quickly access features that are frequently used. 
  5249.  
  5250. The Call Nesting Diagram Pop-up Menu contains actions that can be applied to 
  5251. the entire diagram and the Call Nesting Selected Item Pop-up Menu contains 
  5252. actions that can be a applied to the highlighted item. 
  5253.  
  5254. To access the Call Nesting Diagram Pop-up Menu, click mouse button two on the 
  5255. background area of the diagram. 
  5256.  
  5257. The menu is displayed with the following choices: 
  5258.  
  5259.      Find 
  5260.      Find next 
  5261.      Include function... 
  5262.      Include threads... 
  5263.      Font... 
  5264.      Thread layout... 
  5265.  
  5266.  Related Information 
  5267.  
  5268.      Call Nesting Selected Item Pop-up Menu 
  5269.      Keys Help. 
  5270.  
  5271.  
  5272. ΓòÉΓòÉΓòÉ 16.9. Call Nesting Selected Item Pop-up Menu ΓòÉΓòÉΓòÉ
  5273.  
  5274. The pop-up menus allow you to quickly access features that are frequently used. 
  5275.  
  5276. The Call Nesting Selected Item Pop-up Menu contains actions that can be applied 
  5277. to the highlighted item and the Call Nesting Diagram Pop-up Menu contains 
  5278. actions that can be a applied to the entire diagram. 
  5279.  
  5280. To access the Call Nesting Selected Item Pop-up Menu, click mouse button two on 
  5281. the highlighted area of the diagram. 
  5282.  
  5283. The menu is displayed with the following choices: 
  5284.  
  5285.      Annotate... 
  5286.      Call stack... 
  5287.      Correlation... 
  5288.      Edit function 
  5289.  
  5290.  Related Information 
  5291.  
  5292.      Call Nesting Diagram Pop-up Menu 
  5293.      Keys Help. 
  5294.  
  5295.  
  5296. ΓòÉΓòÉΓòÉ 17. Dynamic Call Graph ΓòÉΓòÉΓòÉ
  5297.  
  5298. Dynamic Call Graph 
  5299.  
  5300. The Dynamic Call Graph is a graphical view of the execution of the target 
  5301. program. The Dynamic Call Graph uses arcs and nodes to represent functions and 
  5302. calls and each one has associated information. See Arcs and Nodes for more 
  5303. detailed information. 
  5304.  
  5305. Colors and sizes of nodes and arcs depict the time spent in the node and the 
  5306. number of calls between nodes. 
  5307.  
  5308. A node represents a function.  An arc, which is displayed between a pair of 
  5309. nodes, represents a call from one function to another. 
  5310.  
  5311. Double click on any node for the  Function Information window to display 
  5312. additional information. 
  5313.  
  5314. Double click on any arc for the  Who Calls Whom window to  display  additional 
  5315. information. Only calls made during the given execution of the program are 
  5316. displayed. 
  5317.  
  5318. Areas of the Dynamic Call Graph Window 
  5319.  
  5320. The following choices are available from the Dynamic Call Graph menu bar: 
  5321.  
  5322.      Menu Bar Summary 
  5323.  
  5324.       The choices available from the Dynamic Call Graph menu bar are: 
  5325.         -  Trace file 
  5326.         -  View 
  5327.         -  Options 
  5328.         -  Project 
  5329.         -  Help. 
  5330.      Status Area 
  5331.  
  5332.       The Status Area provides information about the following: 
  5333.         -  Trace Description 
  5334.         -  Filters 
  5335.         -  Selected Object 
  5336.  
  5337.  
  5338.  Related Information 
  5339.  
  5340.      Call Nesting Diagram 
  5341.      Execution Density Diagram 
  5342.      Statistics Diagram 
  5343.      Time Line Diagram 
  5344.      Analyze Trace Window 
  5345.      Hints and Tips 
  5346.      Keys Help 
  5347.  
  5348.  
  5349. ΓòÉΓòÉΓòÉ 17.1. Dynamic Call Graph Arcs and Nodes ΓòÉΓòÉΓòÉ
  5350.  
  5351. Arcs and Nodes 
  5352.  
  5353. Colors and sizes of nodes and arcs depict the time spent in the node and the 
  5354. number of calls between nodes. 
  5355.  
  5356. The time spent in a particular node and the number of calls in an arc are shown 
  5357. in different colors. The following table shows what each color means to nodes 
  5358. and arcs. Node colors are based on the maximum executable time spent in a 
  5359. function. Arc colors are based on the maximum number of calls between pairs of 
  5360. functions. 
  5361.  
  5362. Color and Size representation of Nodes and Arc 
  5363.  
  5364. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5365. ΓöéColor          ΓöéNodes                    ΓöéArc            Γöé
  5366. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5367. ΓöéGray           Γöé0 - 1/8                  Γöé0 - 1/8        Γöé
  5368. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5369. ΓöéBlue           Γöé1/8 - 1/4                Γöé1/8 - 1/4      Γöé
  5370. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5371. ΓöéYellow         Γöé1/4 - 1/2                Γöé1/4 - 1/2      Γöé
  5372. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5373. ΓöéRed            Γöé1/2 - maximum            Γöé1/2 - maximum  Γöé
  5374. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5375.  
  5376. Note:  The currently selected nodes are surrounded by a green box and the 
  5377. currently selected arcs are shown in green. 
  5378.  
  5379. Dynamic Function Information 
  5380.  
  5381.  Functions 
  5382.            Double clicking on a function displays a function information dialog 
  5383.            which shows you the function name, object name and executable name. 
  5384.            Select one of the following buttons: 
  5385.  
  5386.                Select the Who calls me button to display the fully qualified 
  5387.                 function, listed in the Function Information window, and 
  5388.                 functions that called it. 
  5389.  
  5390.                Select the Whom do I call button to display the fully qualified 
  5391.                 function, listed in the Function Information window and 
  5392.                 functions that it called. 
  5393.  
  5394.  Arcs 
  5395.            Double clicking on an arc displays an arc information dialog window 
  5396.            which shows fully qualified function names of the nodes involved 
  5397.            with this call. Select one of the following buttons: 
  5398.  
  5399.                Select the Find caller button to display the function that 
  5400.                 originated the call. The originating caller is displayed in the 
  5401.                 center of the Dynamic Call Graph. 
  5402.  
  5403.                Select the Find callee button to display the function called by 
  5404.                 the originating caller. The called function is displayed in the 
  5405.                 center of the Dynamic Call Graph. 
  5406.  
  5407.  Related Information 
  5408.  
  5409.      Dynamic Call Graph 
  5410.      Dynamic Call Graph Status Area 
  5411.      Keys Help. 
  5412.  
  5413.  
  5414. ΓòÉΓòÉΓòÉ 17.2. Dynamic Call Graph Trace File Menu ΓòÉΓòÉΓòÉ
  5415.  
  5416. The following choices are available from the Dynamic Call Graph Trace file 
  5417. menu: 
  5418.  
  5419.  Open as 
  5420.            Shows a new or an additional diagram. 
  5421.  
  5422.  Printer settings... 
  5423.            Allows you to choose printer settings for your output. 
  5424.  
  5425.  Print selected region... 
  5426.            Prints the information that is displayed in the current window. 
  5427.  
  5428.  Window Manager 
  5429.            Displays the Window Manager 
  5430.  
  5431.  Exit Performance Analyzer 
  5432.            Exits the Performance Analyzer. 
  5433.  
  5434.  Related Information 
  5435.  
  5436.      Analyze Trace Window 
  5437.      Call Nesting Diagram 
  5438.      Execution Density Diagram 
  5439.      Statistics Diagram 
  5440.      Time Line Diagram 
  5441.      Keys Help. 
  5442.  
  5443.  
  5444. ΓòÉΓòÉΓòÉ 17.2.1. Open As Cascading Choice ΓòÉΓòÉΓòÉ
  5445.  
  5446. Select the Open as choice to view another diagram. You can open as many new 
  5447. windows as you want. 
  5448.  
  5449. To select a new diagram: 
  5450.  
  5451.    1. Select Open as from the Trace file menu. A cascaded menu is displayed 
  5452.       with the following choices: 
  5453.  
  5454.            Call Nesting 
  5455.            Dynamic Call Graph 
  5456.            Execution Density 
  5457.            Statistics 
  5458.            Time Line 
  5459.  
  5460.    2. Select the name of the diagram you want to view. A new window opens and 
  5461.       displays the diagram you selected. 
  5462.  
  5463.  Related Information 
  5464.  
  5465.      Selecting a Trace File to Analyze 
  5466.      Keys Help. 
  5467.  
  5468.  
  5469. ΓòÉΓòÉΓòÉ 17.2.1.1. Call Nesting Choice ΓòÉΓòÉΓòÉ
  5470.  
  5471. The Call Nesting  choice is available from the Open as  cascaded menu. When you 
  5472. select Call Nesting, the Call Nesting Diagram displays. 
  5473.  
  5474. Related Information 
  5475.  
  5476.      Open As Choice 
  5477.      Keys Help. 
  5478.  
  5479.  
  5480. ΓòÉΓòÉΓòÉ 17.2.1.2. Dynamic Call Graph Choice ΓòÉΓòÉΓòÉ
  5481.  
  5482. The Dynamic Call Graph choice is available from the Open as cascaded menu. When 
  5483. you select Dynamic Call Graph, the Dynamic Call Graph displays. 
  5484.  
  5485. Related Information 
  5486.  
  5487.      Open As Choice 
  5488.      Keys Help. 
  5489.  
  5490.  
  5491. ΓòÉΓòÉΓòÉ 17.2.1.3. Execution Density Choice ΓòÉΓòÉΓòÉ
  5492.  
  5493. The Execution Density choice is available from the Open as cascaded menu. When 
  5494. you select Execution Density, the Execution Density diagram displays. 
  5495.  
  5496. Related Information 
  5497.  
  5498.      Open As Choice 
  5499.      Keys Help. 
  5500.  
  5501.  
  5502. ΓòÉΓòÉΓòÉ 17.2.1.4. Statistics Choice ΓòÉΓòÉΓòÉ
  5503.  
  5504. The Statistics choice is available from the Open as cascaded menu. When you 
  5505. select Statistics, the Statistics Diagram displays. 
  5506.  
  5507. Related Information 
  5508.  
  5509.      Open As Choice 
  5510.      Keys Help. 
  5511.  
  5512.  
  5513. ΓòÉΓòÉΓòÉ 17.2.1.5. Time Line Choice ΓòÉΓòÉΓòÉ
  5514.  
  5515. The Time Line choice is available from the Open as cascaded menu. When you 
  5516. select Time Line, the Time Line diagram displays. 
  5517.  
  5518. Related Information 
  5519.  
  5520.      Open As Choice 
  5521.      Keys Help. 
  5522.  
  5523.  
  5524. ΓòÉΓòÉΓòÉ 17.2.2. Printer Settings... Choice ΓòÉΓòÉΓòÉ
  5525.  
  5526. Select the Printer settings... choice to select settings for your print jobs. 
  5527.  
  5528. When you select the Printer settings... choice, the Printer Settings window 
  5529. appears. 
  5530.  
  5531.      OK 
  5532.      Font 
  5533.      Job 
  5534.      Cancel 
  5535.      Help 
  5536.  
  5537.  Related Information 
  5538.  
  5539.      Keys Help. 
  5540.  
  5541.  
  5542. ΓòÉΓòÉΓòÉ 17.2.3. Print Selected Region... Choice ΓòÉΓòÉΓòÉ
  5543.  
  5544. Select the Print selected region... choice to print the information from the 
  5545. Dynamic Call Graph. 
  5546.  
  5547. To print the Dynamic Call Graph, select the Print selected region...  choice 
  5548. from the Trace file menu. The Print Selected Region window appears. 
  5549.  
  5550. Related Information 
  5551.  
  5552.      Keys Help. 
  5553.  
  5554.  
  5555. ΓòÉΓòÉΓòÉ 17.2.4. Window Manager Choice ΓòÉΓòÉΓòÉ
  5556.  
  5557. Select the Window Manager choice to display the Window Manager window. 
  5558.  
  5559. Related Information 
  5560.  
  5561.      Performance Analyzer - Window Manager 
  5562.      Keys Help. 
  5563.  
  5564.  
  5565. ΓòÉΓòÉΓòÉ 17.2.5. Exit Performance Analyzer Choice ΓòÉΓòÉΓòÉ
  5566.  
  5567. Select Exit Performance Analyzer to close Performance Analyzer and all windows. 
  5568.  
  5569. Related Information 
  5570.  
  5571.      Keys Help. 
  5572.  
  5573.  
  5574. ΓòÉΓòÉΓòÉ 17.3. Dynamic Call Graph View Menu ΓòÉΓòÉΓòÉ
  5575.  
  5576. The following choices are available from the View menu: 
  5577.  
  5578.  Include threads 
  5579.            Controls the threads to include or exclude in the diagram. 
  5580.  
  5581.  Overview 
  5582.            Use to navigate through large diagrams quickly. 
  5583.  
  5584.  Zoom in 
  5585.            Enlarges the size of the diagram without changing the size of the 
  5586.            window. 
  5587.  
  5588.  Zoom out 
  5589.            Decreases the size of the diagram without changing the size of the 
  5590.            window. 
  5591.  
  5592.  Re-lay 
  5593.            Sizes to fit all of the diagram in the window. 
  5594.  
  5595.  Restore 
  5596.            Restores nodes to the diagram to show the default view. 
  5597.  
  5598.  Related Information 
  5599.  
  5600.      Call Nesting Diagram 
  5601.      Execution Density Diagram 
  5602.      Statistics Diagram 
  5603.      Time Line Diagram 
  5604.      Keys Help. 
  5605.  
  5606.  
  5607. ΓòÉΓòÉΓòÉ 17.3.1. Include Threads... Choice ΓòÉΓòÉΓòÉ
  5608.  
  5609. Select the Include threads... choice to select which threads are displayed in 
  5610. the diagram. 
  5611.  
  5612. Use the Include threads...  choice to filter the trace file, which allows you 
  5613. to isolate specific areas of interest or areas where problems are occurring. 
  5614. When you select this choice, an Include Threads window appears. 
  5615.  
  5616. Related Information 
  5617.  
  5618.      Keys Help. 
  5619.  
  5620.  
  5621. ΓòÉΓòÉΓòÉ 17.3.1.1. Include Threads Window ΓòÉΓòÉΓòÉ
  5622.  
  5623. Use the Include Threads window to select or isolate specific threads in the 
  5624. Dynamic Call Graph. 
  5625.  
  5626. Use the mouse to highlight your thread selection. You can choose any thread or 
  5627. a combination of threads. 
  5628.  
  5629. Note:  The percentages are based upon the total execution time of the selected 
  5630. threads, not the total execution time. 
  5631.  
  5632. When you change the threads you affect the percentages. 
  5633.  
  5634. Selecting Specific Threads 
  5635.  
  5636. To select a specific thread: 
  5637.  
  5638.    1. Select the specific threads you want to display. 
  5639.  
  5640.    2. Select the appropriate push button to continue: 
  5641.  
  5642.           OK 
  5643.           Select all 
  5644.           Deselect all 
  5645.           Cancel 
  5646.           Help. 
  5647.  
  5648.  Selecting All Threads 
  5649.  
  5650.  To select all threads: 
  5651.  
  5652.    1. Highlight All threads to select all threads. 
  5653.  
  5654.    2. Select the appropriate push button to continue: 
  5655.  
  5656.           OK 
  5657.           Select all 
  5658.           Deselect all 
  5659.           Cancel 
  5660.           Help 
  5661.  
  5662.  Related Information 
  5663.  
  5664.      Dynamic Call Graph 
  5665.      Execution Density Diagram 
  5666.      Analyze Trace Window 
  5667.      Keys Help. 
  5668.  
  5669.  
  5670. ΓòÉΓòÉΓòÉ 17.3.2. Overview Choice ΓòÉΓòÉΓòÉ
  5671.  
  5672. Select the Overview choice to display a scaled-down image of the diagram you 
  5673. are viewing. 
  5674.  
  5675. When you select the Overview choice, the Overview dialog window appears. The 
  5676. Overview window lets you navigate through large diagrams. 
  5677.  
  5678. Switching Views 
  5679.  
  5680. To change the view of the diagram, use the following to: 
  5681.  
  5682.    1. View a larger or smaller area of the diagram. 
  5683.  
  5684.       Press and hold mouse button one while pointing to any edge of the shaded 
  5685.       rectangle in the Overview window. By moving the mouse, the rectangle 
  5686.       becomes larger or smaller. When you release mouse button one, the main 
  5687.       window is redrawn to reflect the new view. 
  5688.  
  5689.    2. View a different area of the diagram. 
  5690.  
  5691.       Press and hold mouse button one in the center of the shaded rectangle in 
  5692.       the Overview window. Move the rectangle over the part of diagram that you 
  5693.       want to view. When you release mouse button one, the main window is 
  5694.       redrawn to reflect the new view. 
  5695.  
  5696.  Related Information 
  5697.  
  5698.      Dynamic Call Graph 
  5699.      Keys Help. 
  5700.  
  5701.  
  5702. ΓòÉΓòÉΓòÉ <hidden> Overview Window ΓòÉΓòÉΓòÉ
  5703.  
  5704. Use the Overview  window to display a scaled-down image of the Dynamic Call 
  5705. Graph. The Overview  window lets you navigate through large trace files. 
  5706.  
  5707. Switching Views 
  5708.  
  5709. To view a larger or smaller area of the Dynamic Call Graph: 
  5710.  
  5711. Press and hold mouse button one while pointing to any edge of the shaded 
  5712. rectangle in the Overview  window. By moving the mouse forward or backward, the 
  5713. rectangle becomes larger or smaller. When you release mouse button one, the 
  5714. main window is redrawn to reflect the new view. 
  5715.  
  5716. View a Different Area of the Graph 
  5717.  
  5718. Press and hold mouse button one in the center of the shaded rectangle in the 
  5719. Overview  window. Move the rectangle over the part of the diagram that you want 
  5720. to view. When you release mouse button one, the main window is redrawn to 
  5721. reflect the new view. 
  5722.  
  5723. Related Information 
  5724.  
  5725.      Dynamic Call Graph 
  5726.      Analyze Trace Window. 
  5727.      Keys Help. 
  5728.  
  5729.  
  5730. ΓòÉΓòÉΓòÉ 17.3.3. Zoom In Choice ΓòÉΓòÉΓòÉ
  5731.  
  5732. Select the Zoom in choice to enlarge the diagram without changing the window 
  5733. size. The Zoom in  choice makes the selected object appear closer and makes the 
  5734. diagram appear larger in the window. 
  5735.  
  5736. If a node or an arc is selected, Zoom in centers that node in the window while 
  5737. enlarging the diagram. You can enlarge the diagram up to five times its default 
  5738. size. 
  5739.  
  5740. To enlarge the diagram, select Zoom in from the View menu or press the Ctrl and 
  5741. the + key. Each time you select Zoom in from the View menu or press Ctrl and 
  5742. the + key, the window appears a larger view of the diagram. 
  5743.  
  5744. To return the diagram to the original size, use the Re-lay choice in the View 
  5745. menu. 
  5746.  
  5747. Related Information 
  5748.  
  5749.      Zoom Bar 
  5750.      Zoom Out Choice 
  5751.      Keys Help. 
  5752.  
  5753.  
  5754. ΓòÉΓòÉΓòÉ 17.3.4. Zoom Out Choice ΓòÉΓòÉΓòÉ
  5755.  
  5756. Select the Zoom out choice to decrease the size of the diagram so the entire 
  5757. diagram can be displayed without changing the window size. The Zoom out  choice 
  5758. makes the selected object appear further away making the diagram appear smaller 
  5759. in the window. 
  5760.  
  5761. The original default view is the smallest that the graph can be displayed. 
  5762.  
  5763. To decrease the view of the diagram, select Zoom out from the View menu or 
  5764. press the Ctrl key and the + key. Each time you select Zoom out from the View 
  5765. menu or press the Ctrl key and the - key, the window appears a smaller view of 
  5766. the diagram. 
  5767.  
  5768. To return the diagram to the original size, use the Re-lay choice in the View 
  5769. menu. 
  5770.  
  5771. Related Information 
  5772.  
  5773.      Zoom Bar 
  5774.      Zoom In Choice 
  5775.      Keys Help. 
  5776.  
  5777.  
  5778. ΓòÉΓòÉΓòÉ 17.3.5. Re-lay Choice ΓòÉΓòÉΓòÉ
  5779.  
  5780. Select the Re-lay choice to center and resize the nodes. 
  5781.  
  5782. See Dynamic Call Graph for more information about isolating nodes and arcs. 
  5783.  
  5784. To re-lay the diagram, select Re-lay from the View menu. The diagram is 
  5785. centered in the window with all selected elements sized to fit. 
  5786.  
  5787. Related Information 
  5788.  
  5789.      Zoom Bar 
  5790.      Restore Choice 
  5791.      Keys Help. 
  5792.  
  5793.  
  5794. ΓòÉΓòÉΓòÉ 17.3.6. Restore Choice ΓòÉΓòÉΓòÉ
  5795.  
  5796. Select the Restore choice to return the diagram to the default view. 
  5797.  
  5798. To restore a diagram, select Restore from the View menu. The entire diagram is 
  5799. restored to the default view and all nodes and arcs are visible in the window. 
  5800.  
  5801. Related Information 
  5802.  
  5803.      Zoom Bar 
  5804.      Re-lay Choice 
  5805.      Keys Help. 
  5806.  
  5807.  
  5808. ΓòÉΓòÉΓòÉ 17.4. Dynamic Call Graph Options Menu ΓòÉΓòÉΓòÉ
  5809.  
  5810. The Options menu allows you to customize the Dynamic Call Graph and display 
  5811. additional information. 
  5812.  
  5813. The following choices are available from the Options menu: 
  5814.  
  5815.  Scale node sizes 
  5816.            Scales node sizes. 
  5817.  
  5818.  Find function 
  5819.            Searches for functions in the diagram. 
  5820.  
  5821.  Status area 
  5822.            Area at the top of the window describes the diagram. 
  5823.  
  5824.  Tool bar 
  5825.            Use the Tool bar for a shortcut to other menus. 
  5826.  
  5827.  Settings 
  5828.            Saves the current settings or restores the default settings. 
  5829.  
  5830.  Related Information 
  5831.  
  5832.      Call Nesting Diagram 
  5833.      Execution Density Diagram 
  5834.      Statistics Diagram 
  5835.      Time Line Diagram 
  5836.      Keys Help. 
  5837.  
  5838.  
  5839. ΓòÉΓòÉΓòÉ 17.4.1. Scale Node Sizes Choice ΓòÉΓòÉΓòÉ
  5840.  
  5841. Select the Scale node sizes choice to choose how you want to display the 
  5842. diagram. When you enable the Scale node size function a check mark appears 
  5843. beside the menu choice, and the arcs and nodes are then displayed in proportion 
  5844. to the execution and active time. To disable the Scale node size function, 
  5845. click on it again to remove the check mark. 
  5846.  
  5847. Related Information 
  5848.  
  5849.      Analyze Trace Window 
  5850.      Execution Density Diagram Pop-up Menu 
  5851.      Keys Help. 
  5852.  
  5853.  
  5854. ΓòÉΓòÉΓòÉ 17.4.2. Find Function... Choice ΓòÉΓòÉΓòÉ
  5855.  
  5856. Select the Find function... choice to search for a function in the diagram. 
  5857. When you select the Find function... choice, the Find Function window appears. 
  5858.  
  5859. Related Information 
  5860.  
  5861.      Keys Help. 
  5862.  
  5863.  
  5864. ΓòÉΓòÉΓòÉ <hidden> Find Function Window ΓòÉΓòÉΓòÉ
  5865.  
  5866. Use the Find function  window to search for a specific function in the diagram. 
  5867.  
  5868. Finding a Function 
  5869.  
  5870. To find a function: 
  5871.  
  5872.    1. Do any of the following for the Find string entry field: 
  5873.  
  5874.           Leave the entry field blank and press enter to display a list of all 
  5875.            functions in the list box 
  5876.           Enter the file name of the function that you want to display in the 
  5877.            list box 
  5878.           Enter the first few characters of the function file name that you 
  5879.            want to display in the list box 
  5880.           Enter an asterisk (*) and part or all of the function file name that 
  5881.            you want to display in the list box. 
  5882.  
  5883.            Note:  This is useful when you are searching for a C++ de-mangled 
  5884.            function that has class information in front of the function name. 
  5885.  
  5886.       Click on the Case sensitive check box to enable case sensitive searching. 
  5887.  
  5888.    2. Select a function from the list box. 
  5889.  
  5890.    3. Select the appropriate push button to continue: 
  5891.  
  5892.           OK 
  5893.           Cancel 
  5894.           Help 
  5895.  
  5896.       Note:  The function is highlighted and centered when found. 
  5897.  
  5898.  Related Information 
  5899.  
  5900.      Keys Help. 
  5901.  
  5902.  
  5903. ΓòÉΓòÉΓòÉ 17.4.3. Status Area... Choice ΓòÉΓòÉΓòÉ
  5904.  
  5905. Select the Status area... choice to change the appearance of the area at the 
  5906. top of the Dynamic Call Graph window. 
  5907.  
  5908. The Status area includes: 
  5909.  
  5910.      Trace Description 
  5911.      Filters 
  5912.      Selected Object 
  5913.  
  5914.  When you select Status area, the Status Area window appears. 
  5915.  
  5916.  Related Information 
  5917.  
  5918.      Keys Help. 
  5919.  
  5920.  
  5921. ΓòÉΓòÉΓòÉ 17.4.3.1. Status Area Window ΓòÉΓòÉΓòÉ
  5922.  
  5923. Use the Status Area  window to control the area at the top of the window. 
  5924.  
  5925. The check boxes represent the choices in the Status Area that you can show or 
  5926. hide or display. When you disable the check box the choice is hidden. Likewise, 
  5927. when you enable the check box the choice displays in the Status Area. 
  5928.  
  5929. In each diagram the Status Area displays different information. When you select 
  5930. the Status Area  window, the choices in the window change based upon the Status 
  5931. Area of the diagram. 
  5932.  
  5933. Choices from the Status Area include: 
  5934.  
  5935.      Trace Description 
  5936.      Filters 
  5937.      Selected Object 
  5938.  
  5939.  Select the appropriate check box to continue. 
  5940.  
  5941.  Related Information 
  5942.  
  5943.      Call Nesting Status Area Window 
  5944.      Execution Density Status Area Window 
  5945.      Time Line Status Area Window. 
  5946.      Keys Help. 
  5947.  
  5948.  
  5949. ΓòÉΓòÉΓòÉ 17.4.4. Tool Bar Cascading Choice ΓòÉΓòÉΓòÉ
  5950.  
  5951. Select the Tool bar cascading choice to have the Tool bar display or not 
  5952. display in your window, and to enable and disable the Hover help. 
  5953.  
  5954. The choices from the Tool bar cascaded menu are: 
  5955.  
  5956.  Show                     Choose to either show or hide the Tool bar. 
  5957.  Hover                    Choose to either enable or disable displaying the 
  5958.                           help text when the mouse pointer hovers over the Tool 
  5959.                           bar buttons. 
  5960.  
  5961.  Related Information 
  5962.  
  5963.      Keys Help. 
  5964.  
  5965.  
  5966. ΓòÉΓòÉΓòÉ 17.4.5. Settings Cascading Choice ΓòÉΓòÉΓòÉ
  5967.  
  5968. The choices from the Settings cascaded menu allow you to save current settings 
  5969. or switch to the original settings. 
  5970.  
  5971.  Save 
  5972.            Save the current session settings. 
  5973.  
  5974.  Restore initial defaults 
  5975.            Restore the original settings. 
  5976.  
  5977.  Related Information 
  5978.  
  5979.      Save Choice 
  5980.      Restore Initial Defaults Choice 
  5981.      Keys Help. 
  5982.  
  5983.  
  5984. ΓòÉΓòÉΓòÉ 17.4.5.1. Save Choice ΓòÉΓòÉΓòÉ
  5985.  
  5986. Select the Save choice to save the current settings. These settings are stored 
  5987. in the ICSPERF.INI file and remain active until that file is erased. 
  5988.  
  5989. To restore the default settings, select the Restore initial defaults choice. 
  5990.  
  5991. Related Information 
  5992.  
  5993.      Restore Initial Defaults Choice 
  5994.      Keys Help 
  5995.  
  5996.  
  5997. ΓòÉΓòÉΓòÉ 17.4.5.2. Restore Initial Defaults Choice ΓòÉΓòÉΓòÉ
  5998.  
  5999. Select the Restore initial defaults choice to change to the original or default 
  6000. settings. You can select the Save choice to save settings. 
  6001.  
  6002. Related Information 
  6003.  
  6004.      Save Choice 
  6005.      Keys Help 
  6006.  
  6007.  
  6008. ΓòÉΓòÉΓòÉ 17.5. Dynamic Call Graph Project Menu ΓòÉΓòÉΓòÉ
  6009.  
  6010. This menu appears when you start the Performance Analyzer from within the 
  6011. WorkFrame environment. The Project menu gives you direct access to all of the 
  6012. actions that you can perform from your current location. 
  6013.  
  6014. When you select the Edit function choice from this menu, the source code for 
  6015. the selected function is displayed in the default editor for WorkFrame's edit 
  6016. action. 
  6017.  
  6018. Related Information 
  6019.  
  6020.      Search Paths Window 
  6021.      Trace Generation Window 
  6022.      Keys Help 
  6023.  
  6024.  
  6025. ΓòÉΓòÉΓòÉ 17.5.1. Edit Function Choice ΓòÉΓòÉΓòÉ
  6026.  
  6027. Select the Edit function choice to edit a source file in WorkFrame's default 
  6028. editor. This choice lets you edit the source for a function selected on the 
  6029. Dynamic Call Graph. When you are working in the WorkFrame environment, this 
  6030. choice is available from the Project menu on the Dynamic Call Graph. 
  6031.  
  6032. To locate a source file for editing, the Performance Analyzer must first locate 
  6033. the executable containing the name of the source file. The Performance Analyzer 
  6034. searches the following paths (in the order listed) to locate an executable: 
  6035.  
  6036.    1. Path specified in the Locate Executable window 
  6037.    2. Path specified in the Search path for executable files: entry field of 
  6038.       the Search Paths window 
  6039.    3. Directory where the executable was located when the trace file was 
  6040.       created 
  6041.    4. The current working directory 
  6042.    5. Path specified by the PATH environment variable. 
  6043.  
  6044.  To identify the name of the source file, the Performance Analyzer looks at the 
  6045.  debug information in the executable. The Performance Analyzer then searches 
  6046.  the following paths (in the order listed) to locate the source file: 
  6047.  
  6048.    1. Path specified in the Locate Source File window 
  6049.    2. Path specified in the Search path for source files: entry field of the 
  6050.       Search Paths window 
  6051.    3. Path specified in the compile statement (if provided) 
  6052.    4. Directory where the executable was located when the trace file was 
  6053.       created 
  6054.    5. The current working directory 
  6055.    6. Path specified by the INCLUDE environment variable. 
  6056.  
  6057.  If, after searching these paths, the Performance Analyzer cannot find the: 
  6058.  
  6059.    1. Executable, it displays the Locate Executable window to let you enter the 
  6060.       path where the executable resides. 
  6061.    2. Source file, it displays the Locate Source File window to let you enter 
  6062.       the path where the source file resides. 
  6063.  
  6064.  Once the source file for a function is located, the file is opened to the 
  6065.  first line of the function's code. 
  6066.  
  6067.  Notes 
  6068.  
  6069.    1. The Performance Analyzer remembers the paths you enter in the Locate 
  6070.       Executable and Locate Source File windows and uses them to look for files 
  6071.       the next time you select the Edit function choice. 
  6072.    2. You can specify paths that you want the Performance Analyzer to use by 
  6073.       selecting the Search Paths choice in the Options menu on the Performance 
  6074.       Analyzer - Window Manager window. The paths you enter are automatically 
  6075.       saved for the current session. If you want to save the paths for 
  6076.       subsequent sessions, select the Options menu and then select the Save 
  6077.       choice from the Settings cascaded menu. 
  6078.  
  6079.  Related Information 
  6080.  
  6081.      Locate Executable Window 
  6082.      Locate Source File Window 
  6083.      Search Paths Window 
  6084.      Starting the Performance Analyzer from WorkFrame 
  6085.      Keys Help. 
  6086.  
  6087.  
  6088. ΓòÉΓòÉΓòÉ 17.6. Dynamic Call Graph Help Menu ΓòÉΓòÉΓòÉ
  6089.  
  6090. The Help menu has the following choices: 
  6091.  
  6092.  Help index          Displays an index of Help topics. 
  6093.  General help        Displays Help for the active window. 
  6094.  Using help          Describes how to use Help. 
  6095.  How do I?           Displays task Help. 
  6096.  Product information Displays information about the Performance Analyzer. 
  6097.  
  6098.  Related Information 
  6099.  
  6100.      Call Nesting Diagram 
  6101.      Dynamic Call Graph 
  6102.      Execution Density Diagram 
  6103.      Statistics Diagram 
  6104.      Time Line Diagram 
  6105.      Hints and Tips 
  6106.      Keys Help. 
  6107.  
  6108.  
  6109. ΓòÉΓòÉΓòÉ 17.6.1. Help Index Choice ΓòÉΓòÉΓòÉ
  6110.  
  6111. Select the Help index choice to display an alphabetical index of Performance 
  6112. Analyzer Help topics. This choice is available from the Help menu of the 
  6113. Dynamic Call Graph. 
  6114.  
  6115. Use the Previous push button to return to the last topic you viewed. Use the 
  6116. Search... push button to locate topics in the index. Use the Print... push 
  6117. button to print a topic. 
  6118.  
  6119. Related Information 
  6120.  
  6121.      Call Nesting Diagram 
  6122.      Dynamic Call Graph 
  6123.      Execution Density Diagram 
  6124.      Statistics Diagram 
  6125.      Time Line Diagram 
  6126.      Hints and Tips 
  6127.      Keys Help. 
  6128.  
  6129.  
  6130. ΓòÉΓòÉΓòÉ 17.6.2. General Help Choice ΓòÉΓòÉΓòÉ
  6131.  
  6132. Select the General help choice to display Help information for the active 
  6133. window. This choice is available from the Help menu of the Dynamic Call Graph. 
  6134.  
  6135. The online Help panel displayed is the same panel that is displayed when you 
  6136. place your cursor inside the window and press F1. 
  6137.  
  6138. Related Information 
  6139.  
  6140.      Call Nesting Diagram 
  6141.      Dynamic Call Graph 
  6142.      Execution Density Diagram 
  6143.      Statistics Diagram 
  6144.      Time Line Diagram 
  6145.      Hints and Tips 
  6146.      Keys Help. 
  6147.  
  6148.  
  6149. ΓòÉΓòÉΓòÉ 17.6.3. Using Help Choice ΓòÉΓòÉΓòÉ
  6150.  
  6151. Select the Using help choice for a description of how to use the IBM 
  6152. Performance Analyzer Help facility. This choice is available from the Help menu 
  6153. of the Dynamic Call Graph. 
  6154.  
  6155. Related Information 
  6156.  
  6157.      Call Nesting Diagram 
  6158.      Dynamic Call Graph 
  6159.      Execution Density Diagram 
  6160.      Statistics Diagram 
  6161.      Time Line Diagram 
  6162.      Hints and Tips 
  6163.      Keys Help. 
  6164.  
  6165.  
  6166. ΓòÉΓòÉΓòÉ 17.6.4. How Do I? Choice ΓòÉΓòÉΓòÉ
  6167.  
  6168. Select the How do I? choice to display the Performance Analyzer task help. This 
  6169. choice is available from the Help menu of the Dynamic Call Graph. 
  6170.  
  6171. Related Information 
  6172.  
  6173.      Call Nesting Diagram 
  6174.      Dynamic Call Graph 
  6175.      Execution Density Diagram 
  6176.      Statistics Diagram 
  6177.      Time Line Diagram 
  6178.      Hints and Tips 
  6179.      Keys Help. 
  6180.  
  6181.  
  6182. ΓòÉΓòÉΓòÉ 17.6.5. Product Information ΓòÉΓòÉΓòÉ
  6183.  
  6184. Select the Product information choice to display copyright and version 
  6185. information about the Performance Analyzer application. This choice is 
  6186. available from the Help menu of the Dynamic Call Graph. 
  6187.  
  6188. Related Information 
  6189.  
  6190.      Call Nesting Diagram 
  6191.      Dynamic Call Graph 
  6192.      Execution Density Diagram 
  6193.      Statistics Diagram 
  6194.      Time Line Diagram 
  6195.      Hints and Tips 
  6196.      Keys Help. 
  6197.  
  6198.  
  6199. ΓòÉΓòÉΓòÉ 17.7. Dynamic Call Graph Status Area ΓòÉΓòÉΓòÉ
  6200.  
  6201. The Status Area, located at the top of the window, describes the settings of 
  6202. the diagram. 
  6203.  
  6204. You can select the Status area choice to change the appearance of the area at 
  6205. the top of the Dynamic Call Graph window. 
  6206.  
  6207. When you select the Status area... choice,the Status Area window appears. 
  6208.  
  6209. The choices in the Status area window include: 
  6210.  
  6211.  Trace description 
  6212.            Select for a brief description of the trace file. 
  6213.  Filters 
  6214.            Select to display selected filters. 
  6215.  Selected object 
  6216.            Select to display selected object. 
  6217.  
  6218.            Note:  If you highlight a node, a function name is displayed. If you 
  6219.            highlight an arc, a function call is displayed. 
  6220.  
  6221.  Related Information 
  6222.  
  6223.      Call Nesting Status Area 
  6224.      Execution Density Status Area 
  6225.      Time Line Status Area 
  6226.      Keys Help 
  6227.  
  6228.  
  6229. ΓòÉΓòÉΓòÉ 17.8. Dynamic Call Graph Zoom Bar ΓòÉΓòÉΓòÉ
  6230.  
  6231. There are several ways to zoom in the Dynamic Call Graph window. 
  6232.  
  6233. When zooming in and out, the Dynamic Call Graph takes the selected node or arc 
  6234. that is highlighted, and uses it as the focal point. 
  6235.  
  6236. Zooming in the Dynamic Call Graph 
  6237.  
  6238. You can use the: 
  6239.  
  6240.      Zoom in choice from the View menu to change the diagram view. 
  6241.  
  6242.       When zooming in, your view is a step closer to the selected object and 
  6243.       the object in the window appears larger. 
  6244.  
  6245.      Zoom out choice from the View menu to change the diagram view. 
  6246.  
  6247.       When zooming out, your view is a step further away from the selected 
  6248.       object and the object in the window appears smaller. 
  6249.  
  6250.      Zoom bar in the Dynamic Call Graph window by sliding the arm up or down, 
  6251.       to change the diagram view. 
  6252.  
  6253.      Re-lay choice from the View menu to return to the original diagram view. 
  6254.  
  6255.      Overview choice from the View menu to quickly move around in the viewing 
  6256.       area of the diagram. 
  6257.  
  6258.       The Overview choice provides you with another option of viewing.  Use it 
  6259.       to move quickly to other areas of the diagram when zooming in and out. 
  6260.  
  6261.       When using the Overview choice, you have a miniature version of the 
  6262.       Dynamic Call Graph window.  The gray box highlights the area currently in 
  6263.       view in the window. 
  6264.  
  6265.       Moving the small gray box around in the Overview window allows you to 
  6266.       change the view in the Dynamic Call Graph  window quickly.  You can also 
  6267.       grab the sides of the gray box to resize the area being shown in the 
  6268.       diagram window. 
  6269.  
  6270.       Related Information 
  6271.  
  6272.         -  Zoom In Choice 
  6273.         -  Zoom Out Choice 
  6274.         -  Dynamic Call Graph 
  6275.         -  Keys Help. 
  6276.  
  6277.  
  6278. ΓòÉΓòÉΓòÉ 17.9. Dynamic Call Graph Function Information Window ΓòÉΓòÉΓòÉ
  6279.  
  6280. Use the Function Information window to display information about: 
  6281.  
  6282.      a selected function 
  6283.      the total execution time in seconds and percentages 
  6284.      active time in seconds and percentages, 
  6285.      which function called the selected function 
  6286.  
  6287.       and 
  6288.      the functions that the selected function called. 
  6289.  
  6290.  Displaying the Function Information Window 
  6291.  
  6292.  To display the Function Information window: 
  6293.  
  6294.  Double-click on a node using mouse button one. 
  6295.  
  6296.  Using the Function Information Window 
  6297.  
  6298.  The name of the function appears on the left side of the split bar area. The 
  6299.  object file and executable name appear on the right side of the split bar 
  6300.  area. 
  6301.  
  6302.  The following information is provided in the Function Information Window: 
  6303.  
  6304.      Execution time (in time and percentage) 
  6305.      Time on stack (in time and percentage) 
  6306.      Number of calls 
  6307.  
  6308.  The following lists the push buttons and gives an explanation of each push 
  6309.  button: 
  6310.  
  6311.  Who calls me 
  6312.  
  6313.            Select this push button to display only the selected node and the 
  6314.            nodes that called the selected node. To return to the diagram, 
  6315.            select Restore graph from the Options menu. 
  6316.  Whom do I call 
  6317.  
  6318.            Select this push button to display only the selected node and the 
  6319.            nodes that the selected node calls. 
  6320.  Cancel    Closes the window. 
  6321.  Help      Displays Help. 
  6322.  
  6323.  Note:  If the trace file does not have time stamps, 
  6324.  
  6325.      the Execution Time and Time on stack will not be displayed. 
  6326.      the nodes will all be displayed in the same color and size. 
  6327.  
  6328.       and 
  6329.      the Scale node sizes choice will be disabled. 
  6330.  
  6331.  Related Information 
  6332.  
  6333.      Who Calls Whom Window 
  6334.      Dynamic Call Graph 
  6335.      Analyze Trace Window. 
  6336.      Keys Help. 
  6337.  
  6338.  
  6339. ΓòÉΓòÉΓòÉ 17.10. Dynamic Call Graph Who Calls Whom Window ΓòÉΓòÉΓòÉ
  6340.  
  6341. Use the Who Calls Whom window to display information about a selected arc. 
  6342.  
  6343. To display the Who Calls Whom window, double-click on an arc. 
  6344.  
  6345. Using the Who Calls Whom Window 
  6346.  
  6347. The Who Calls Whom window shows the name of the calling function, the called 
  6348. function, and the number of times the call is made. 
  6349.  
  6350. The calling function field and the called function field each have a split bar 
  6351. function between the function name and the object file and executable name. 
  6352.  
  6353. Use the split bar to change the size of the left or right field in either the 
  6354. calling function or the called function fields. 
  6355.  
  6356. The following lists the push buttons and how to use each one: 
  6357.  
  6358.  Find caller 
  6359.            Select this push button to select and center the node that makes the 
  6360.            call represented by the selected arc. 
  6361.  Find callee 
  6362.            Select this push button to select and center the node that is called 
  6363.            by the call represented in the selected arc. 
  6364.  Cancel 
  6365.            Closes the window. 
  6366.  
  6367.  Related Information 
  6368.  
  6369.      Function Information Window 
  6370.      Dynamic Call Graph 
  6371.      Analyze Trace Window. 
  6372.      Keys Help. 
  6373.  
  6374.  
  6375. ΓòÉΓòÉΓòÉ 18. Execution Density Diagram ΓòÉΓòÉΓòÉ
  6376.  
  6377. Execution Density Diagram 
  6378.  
  6379. The Execution Density diagram shows trends of program execution by displaying 
  6380. the trace data chronologically from top to bottom as thin horizontal lines of 
  6381. various colors in different columns. 
  6382.  
  6383. The Execution Density diagram consists of columns which contain thin lines of 
  6384. various colors. The following list describes the diagram components: 
  6385.  
  6386.      Each vertical column represents a function. 
  6387.      The thickness of each line represents a unit of time called a time slice. 
  6388.      The color of each line represents the percentage of program execution 
  6389.       time spent in the given function for that time slice. 
  6390.  
  6391.  Note:  Only selected threads are used in calculating this percentage. 
  6392.  
  6393.  For instance, in the default setting, functions executing more than 50 percent 
  6394.  of a given time slice have a red line drawn in the appropriate column at the 
  6395.  vertical location corresponding to the time slice. 
  6396.  
  6397.  See Color window for more information about how the color is determined and 
  6398.  how you can change the colors and percentages that are used. 
  6399.  
  6400.  The trace is displayed at 100 percent magnification.  You can magnify or 
  6401.  filter the diagram to change the amount of detail displayed. 
  6402.  
  6403.  See Filters for more information about filtering and magnifying. 
  6404.  
  6405.  Note: 
  6406.  
  6407.    1. When a thread switch occurs in the Execution Density diagram, the time 
  6408.       between the last recorded event in the previous thread and the first 
  6409.       event in the new thread will be allotted to the previous thread. 
  6410.  
  6411.    2. Events that take small amounts of time might be hard to distinguish until 
  6412.       the magnification has been increased. See Filters for more information 
  6413.       about changing the scale of the pages. 
  6414.  
  6415.  Areas of the Execution Density Window 
  6416.  
  6417.  The following topics describe the areas of the Execution Density diagram: 
  6418.  
  6419.      Menu Bar Summary 
  6420.  
  6421.       The choices available from the Execution Density diagram menu bar are: 
  6422.         -  Trace file 
  6423.         -  Edit 
  6424.         -  View 
  6425.         -  Options 
  6426.         -  Project 
  6427.         -  Help. 
  6428.      Status Area 
  6429.  
  6430.       The Status Area provides information about the following: 
  6431.         -  Trace Description 
  6432.         -  Time Slice 
  6433.         -  Selected Region 
  6434.         -  Filters 
  6435.         -  Selected Object 
  6436.      Current Column Indicator 
  6437.      Vertical Ruler 
  6438.      Execution Density Pop-up Menus 
  6439.         -  Execution Density Diagram Pop-up Menu. 
  6440.         -  Execution Density Selected Item Pop-up Menu. 
  6441.  
  6442.  Related Information 
  6443.  
  6444.      Call Nesting Diagram 
  6445.      Dynamic Call Graph 
  6446.      Statistics Diagram 
  6447.      Time Line Diagram 
  6448.      Hints and Tips 
  6449.      Keys Help. 
  6450.  
  6451.  
  6452. ΓòÉΓòÉΓòÉ 18.1. Execution Density Trace File Menu ΓòÉΓòÉΓòÉ
  6453.  
  6454. The following choices are available from the Execution Density Trace file menu: 
  6455.  
  6456.  Open As Choice 
  6457.            Shows a new or an additional diagram. 
  6458.  
  6459.  Printer settings... 
  6460.            Allows you to choose printer settings for your output. 
  6461.  
  6462.  Print selected region... 
  6463.            Prints a selected area of the diagram. 
  6464.  
  6465.  Window Manager 
  6466.            Displays the Window Manager. 
  6467.  
  6468.  Exit Performance Analyzer 
  6469.            Exits the Performance Analyzer. 
  6470.  
  6471.  Related Information 
  6472.  
  6473.      Analyze Trace Window 
  6474.      Call Nesting Diagram 
  6475.      Dynamic Call Graph 
  6476.      Statistics Diagram 
  6477.      Time Line Diagram 
  6478.      Keys Help. 
  6479.  
  6480.  
  6481. ΓòÉΓòÉΓòÉ 18.1.1. Open As Cascading Choice ΓòÉΓòÉΓòÉ
  6482.  
  6483. Select the Open as choice to view another diagram. You can open as many new 
  6484. diagram windows as you want. 
  6485.  
  6486. To select a new diagram: 
  6487.  
  6488.    1. Select Open as from the Trace file menu. A cascaded menu is displayed 
  6489.       with the following choices: 
  6490.  
  6491.            Call Nesting 
  6492.            Dynamic Call Graph 
  6493.            Execution Density 
  6494.            Statistics 
  6495.            Time Line 
  6496.  
  6497.    2. Select the name of the diagram you want to view. A new window opens and 
  6498.       displays the diagram you selected. 
  6499.  
  6500.  Related Information 
  6501.  
  6502.      Selecting a Trace File to Analyze 
  6503.      Keys Help. 
  6504.  
  6505.  
  6506. ΓòÉΓòÉΓòÉ 18.1.1.1. Call Nesting Choice ΓòÉΓòÉΓòÉ
  6507.  
  6508. The Call Nesting choice is available from the Open as cascaded menu. When you 
  6509. select Call Nesting, the Call Nesting Diagram displays. 
  6510.  
  6511. Related Information 
  6512.  
  6513.      Open As Choice 
  6514.      Keys Help. 
  6515.  
  6516.  
  6517. ΓòÉΓòÉΓòÉ 18.1.1.2. Dynamic Call Graph Choice ΓòÉΓòÉΓòÉ
  6518.  
  6519. The Dynamic Call Graph choice is available from the Open as cascaded menu. When 
  6520. you select Dynamic Call Graph, the Dynamic Call Graph displays. 
  6521.  
  6522. Related Information 
  6523.  
  6524.      Open As Choice 
  6525.      Keys Help. 
  6526.  
  6527.  
  6528. ΓòÉΓòÉΓòÉ 18.1.1.3. Execution Density Choice ΓòÉΓòÉΓòÉ
  6529.  
  6530. The Execution Density choice is available from the Open as cascaded menu. When 
  6531. you select Execution Density, the Execution Density Diagram diagram displays. 
  6532.  
  6533. Related Information 
  6534.  
  6535.      Open As Choice 
  6536.      Keys Help. 
  6537.  
  6538.  
  6539. ΓòÉΓòÉΓòÉ 18.1.1.4. Statistics Choice ΓòÉΓòÉΓòÉ
  6540.  
  6541. The Statistics choice is available from the Open as cascaded menu. When you 
  6542. select Statistics, the Statistics Diagram  displays. 
  6543.  
  6544. Related Information 
  6545.  
  6546.      Open As Choice 
  6547.      Keys Help. 
  6548.  
  6549.  
  6550. ΓòÉΓòÉΓòÉ 18.1.1.5. Time Line Choice ΓòÉΓòÉΓòÉ
  6551.  
  6552. The Time Line choice is available from the Open as cascaded menu. When you 
  6553. select Time Line, the Time Line  diagram displays. 
  6554.  
  6555. Related Information 
  6556.  
  6557.      Open As Choice 
  6558.      Keys Help. 
  6559.  
  6560.  
  6561. ΓòÉΓòÉΓòÉ 18.1.2. Printer Settings... Choice ΓòÉΓòÉΓòÉ
  6562.  
  6563. Select the Printer settings... choice to select settings for your print jobs. 
  6564.  
  6565. When you select the Printer settings... choice, the Printer Settings window 
  6566. appears. 
  6567.  
  6568.      OK 
  6569.      Font 
  6570.      Job 
  6571.      Cancel 
  6572.      Help 
  6573.  
  6574.  Related Information 
  6575.  
  6576.      Keys Help. 
  6577.  
  6578.  
  6579. ΓòÉΓòÉΓòÉ 18.1.3. Print Selected Region... Choice ΓòÉΓòÉΓòÉ
  6580.  
  6581. Select the Print selected region... choice to print a selected area of the 
  6582. Execution Density diagram. 
  6583.  
  6584. To print an area of the Execution Density diagram, highlight the area and then 
  6585. select this choice from the Trace file menu. The Print Selected Region window 
  6586. appears. 
  6587.  
  6588. Related Information 
  6589.  
  6590.      Keys Help. 
  6591.  
  6592.  
  6593. ΓòÉΓòÉΓòÉ 18.1.4. Window Manager Choice ΓòÉΓòÉΓòÉ
  6594.  
  6595. Select the Window manager choice to display the Window Manager window. 
  6596.  
  6597. Related Information 
  6598.  
  6599.      Performance Analyzer - Window Manager 
  6600.      Keys Help. 
  6601.  
  6602.  
  6603. ΓòÉΓòÉΓòÉ 18.1.5. Exit Performance Analyzer ΓòÉΓòÉΓòÉ
  6604.  
  6605. Select Exit Performance Analyzer to close the Performance Analyzer and all the 
  6606. active windows. 
  6607.  
  6608. Related Information 
  6609.  
  6610.      Keys Help. 
  6611.  
  6612.  
  6613. ΓòÉΓòÉΓòÉ 18.2. Execution Density Edit Menu ΓòÉΓòÉΓòÉ
  6614.  
  6615. The Edit menu allows you to locate and change text in the Execution Density 
  6616. diagram. 
  6617.  
  6618. Items you can select from this menu include the following: 
  6619.  
  6620.  Find function 
  6621.            Search for a function. 
  6622.  
  6623.  Find Next 
  6624.            Find the next occurrence of the last item you searched for. 
  6625.  
  6626.  Select time 
  6627.            Go to a specific time in the diagram. 
  6628.  
  6629.  Select time range 
  6630.            Select a specified time in the diagram. 
  6631.  
  6632.  Select all 
  6633.            Select the entire Execution Density diagram. 
  6634.  
  6635.  Related Information 
  6636.  
  6637.      Call Nesting Diagram 
  6638.      Dynamic Call Graph 
  6639.      Statistics Diagram 
  6640.      Time Line Diagram 
  6641.      Keys Help. 
  6642.  
  6643.  
  6644. ΓòÉΓòÉΓòÉ 18.2.1. Find Function... Choice ΓòÉΓòÉΓòÉ
  6645.  
  6646. Select the Find function... choice to search for a function call or return. 
  6647.  
  6648. When you select the Find function... choice, the Find Function window appears. 
  6649.  
  6650. Related Information 
  6651.  
  6652.      Execution Density Diagram Pop-up Menu 
  6653.      Keys Help. 
  6654.  
  6655.  
  6656. ΓòÉΓòÉΓòÉ <hidden> Find Function Window ΓòÉΓòÉΓòÉ
  6657.  
  6658. Use the Find function  window to search for a specific function in the diagram. 
  6659. You can choose to search when the function was called or returned. 
  6660.  
  6661. Searching for Calls or Returns 
  6662.  
  6663. To search for a function call or return: 
  6664.  
  6665.    1. Do any of the following for the Find string entry field: 
  6666.  
  6667.           Leave the entry field blank and press enter to display a list of all 
  6668.            functions in the list box 
  6669.           Enter the file name of the function that you want to display in the 
  6670.            list box 
  6671.           Enter the first few characters of the function file name that you 
  6672.            want to display in the list box 
  6673.           Enter an asterisk (*) and part or all of the function file name that 
  6674.            you want to display in the list box. 
  6675.  
  6676.            Note:  This is useful when you are searching for a C++ de-mangled 
  6677.            function that has class information in front of the function name. 
  6678.  
  6679.       Click on the Case sensitive check box to enable case sensitive searching. 
  6680.  
  6681.    2. Select a function from the list box. 
  6682.  
  6683.           Choose to search for when the function was called or returned. 
  6684.  
  6685.           Select the Call  radio button to find when a function was called. 
  6686.  
  6687.            OR 
  6688.           Select the Return  radio button to find when a function returned. 
  6689.  
  6690.    3. Select the appropriate push button to continue: 
  6691.  
  6692.           OK 
  6693.           Cancel 
  6694.           Help 
  6695.  
  6696.       Note:  The function is highlighted when found. 
  6697.  
  6698.  Related Information 
  6699.  
  6700.      Find Next Choice 
  6701.      Keys Help. 
  6702.  
  6703.  
  6704. ΓòÉΓòÉΓòÉ 18.2.2. Find Next Choice ΓòÉΓòÉΓòÉ
  6705.  
  6706. Select the Find next choice to locate the next instance of the searched text. 
  6707.  
  6708. To find the next occurrence, select Find next from the Edit menu. The string is 
  6709. highlighted when found. A message box appears if the string cannot be found. 
  6710.  
  6711. Related Information 
  6712.  
  6713.      Execution Density Diagram Pop-up Menu 
  6714.      Keys Help. 
  6715.  
  6716.  
  6717. ΓòÉΓòÉΓòÉ 18.2.3. Select Time... Choice ΓòÉΓòÉΓòÉ
  6718.  
  6719. Select the Select time... choice to go to a specific time in the diagram. When 
  6720. you select the Select time... choice, the Select Time window appears. 
  6721.  
  6722. Related Information 
  6723.  
  6724.      Select Time Range Window 
  6725.      Analyze Trace Window 
  6726.      Keys Help. 
  6727.  
  6728.  
  6729. ΓòÉΓòÉΓòÉ <hidden> Select Time Window ΓòÉΓòÉΓòÉ
  6730.  
  6731. Use the Select Time  window to go to a specific time in the diagram. 
  6732.  
  6733. Going to a Specific Time 
  6734.  
  6735. To select the time: 
  6736.  
  6737.    1. Select the appropriate radio button: 
  6738.  
  6739.           seconds (s) 
  6740.           milliseconds (ms) 
  6741.           microseconds (us) 
  6742.  
  6743.    2. Use the spin buttons to select the time you want to display. 
  6744.  
  6745.    3. Select the appropriate push button to continue: 
  6746.  
  6747.           OK 
  6748.           Cancel 
  6749.           Help. 
  6750.  
  6751.  Related Information 
  6752.  
  6753.      Select Time Range Window 
  6754.      Call Nesting Diagram 
  6755.      Execution Density Diagram 
  6756.      Time Line Diagram. 
  6757.      Keys Help. 
  6758.  
  6759.  
  6760. ΓòÉΓòÉΓòÉ 18.2.4. Select Time Range... Choice ΓòÉΓòÉΓòÉ
  6761.  
  6762. Select the Select time... choice to chose to view a specific time period. 
  6763.  
  6764. When you select the Select time... choice, the Select Time Range window 
  6765. appears. 
  6766.  
  6767. Related Information 
  6768.  
  6769.      Select Time Window 
  6770.      Analyze Trace Window 
  6771.      Keys Help. 
  6772.  
  6773.  
  6774. ΓòÉΓòÉΓòÉ <hidden> Select Time Range Window ΓòÉΓòÉΓòÉ
  6775.  
  6776. Use the Select Time Range window to view a specific period of time. 
  6777.  
  6778. Selecting Time Periods 
  6779.  
  6780. To select the time period: 
  6781.  
  6782.    1. In the Start time list box, use the spin buttons to select the start time 
  6783.       you want to highlight. 
  6784.  
  6785.    2. To select the time, select the appropriate radio button: 
  6786.  
  6787.           seconds (s), 
  6788.           milliseconds (ms), 
  6789.           microseconds (us). 
  6790.  
  6791.    3. In the End time list box, use the spin buttons to select the end time, 
  6792.       where the highlight will stop. 
  6793.  
  6794.    4. To select the time, select the appropriate radio button: 
  6795.  
  6796.           seconds (s), 
  6797.           milliseconds (ms), 
  6798.           microseconds (us). 
  6799.  
  6800.    5. Select the appropriate push button to continue: 
  6801.  
  6802.           OK 
  6803.           Cancel 
  6804.           Help. 
  6805.  
  6806.  Related Information 
  6807.  
  6808.      Call Nesting Diagram 
  6809.      Execution Density Diagram 
  6810.      Time Line Diagram 
  6811.      Analyze Trace Window 
  6812.      Select Time Window. 
  6813.      Keys Help. 
  6814.  
  6815.  
  6816. ΓòÉΓòÉΓòÉ 18.2.5. Select All Choice ΓòÉΓòÉΓòÉ
  6817.  
  6818. Select the Select all choice to highlight the entire diagram. To remove the 
  6819. highlighting, select a specific function. 
  6820.  
  6821. Related Information 
  6822.  
  6823.      Select Time Window 
  6824.      Select Time Range Window 
  6825.      Keys Help. 
  6826.  
  6827.  
  6828. ΓòÉΓòÉΓòÉ 18.3. Execution Density View Menu ΓòÉΓòÉΓòÉ
  6829.  
  6830. The choices available from the View menu are: 
  6831.  
  6832.  Zoom In 
  6833.            Magnifies the Execution Density diagram to view a region of 
  6834.            interest. 
  6835.  
  6836.  Zoom Out 
  6837.            Reduces the Execution Density diagram. 
  6838.  
  6839.  Zoom to selected range 
  6840.            Magnifies an area of interest. 
  6841.  
  6842.  Scale pages 
  6843.            Controls the number of pages the diagram uses. 
  6844.  
  6845.  Include functions 
  6846.            Isolates specific functions to view in your program. 
  6847.  
  6848.  Include threads 
  6849.            Selects which threads are displayed in the diagram. 
  6850.  
  6851.  Related Information 
  6852.  
  6853.      Call Nesting Diagram 
  6854.      Dynamic Call Graph 
  6855.      Statistics Diagram 
  6856.      Time Line Diagram 
  6857.      Keys Help. 
  6858.  
  6859.  
  6860. ΓòÉΓòÉΓòÉ 18.3.1. Zoom In Choice ΓòÉΓòÉΓòÉ
  6861.  
  6862. Select the Zoom In choice to magnify the Execution Density diagram. 
  6863.  
  6864. Selecting the Zoom In choice will magnify the Execution Density diagram by a 
  6865. factor of 5.  The point in the trace file at the top of the current page will 
  6866. remain fixed, resulting in the view changing to show the top one fifth of the 
  6867. previously displayed page. If the diagram is already scaled to its maximum, 
  6868. this choice will be disabled. 
  6869.  
  6870. Note:  If the diagram is scaled within a factor of 5 of the maximum 
  6871. magnification, this choice will bring the diagram to its full magnification. 
  6872.  
  6873. The Zoom In choice is offered in both the View menu and the Execution Density 
  6874. Diagram Pop-up Menu Also, holding the Ctrl key and pressing the + key will 
  6875. perform the same function. 
  6876.  
  6877. Related Information 
  6878.  
  6879.      Zoom Out Choice 
  6880.      Zoom to Selected Range Choice 
  6881.      Execution Density Selected Item Pop-up Menu 
  6882.      Keys Help. 
  6883.  
  6884.  
  6885. ΓòÉΓòÉΓòÉ 18.3.2. Zoom Out Choice ΓòÉΓòÉΓòÉ
  6886.  
  6887. Select the Zoom Out choice to reduce the magnification of the Execution Density 
  6888. diagram. 
  6889.  
  6890. Selecting the Zoom Out choice will decrease the magnification of the Execution 
  6891. Density diagram by a factor of 5.  The point in the trace file at the top of 
  6892. the current page will remain fixed, resulting in the view changing to display 
  6893. the previously displayed page in the top one fifth of the new view.  If 
  6894. necessary, the diagram will adjust to ensure that time past the end of the 
  6895. trace file is not displayed. If the diagram is already scaled to its minimum 
  6896. magnification, this choice will be disabled. 
  6897.  
  6898. Note:  If the diagram is scaled within a factor of 5 of the minimum 
  6899. magnification, this choice will bring the diagram to a full 100 % view. 
  6900.  
  6901. The Zoom Out choice is offered in both the View menu and the Execution Density 
  6902. Pop-up Menu Also, holding the Ctrl key and pressing the - key will perform the 
  6903. same function. 
  6904.  
  6905. Related Information 
  6906.  
  6907.      Zoom In Choice 
  6908.      Zoom to Selected Range Choice 
  6909.      Execution Density Selected Item Pop-up Menu 
  6910.      Keys Help. 
  6911.  
  6912.  
  6913. ΓòÉΓòÉΓòÉ 18.3.3. Zoom to Selected Range Choice ΓòÉΓòÉΓòÉ
  6914.  
  6915. Select the Zoom to selected range to magnify an area of interest in the 
  6916. Execution Density diagram. 
  6917.  
  6918. To magnify a range of interest, highlight the range using the mouse or the 
  6919. Select time range... choice and select Zoom to selected range from the View 
  6920. menu. The scale of the diagram will be expanded so that the highlighted area 
  6921. fills the entire display. 
  6922.  
  6923. Note:  When the magnification is at its maximum, the choice will be disabled. 
  6924. Also, if it is impossible to magnify the diagram to the degree required to 
  6925. stretch the highlighted region across the entire diagram, the highest possible 
  6926. magnification will be used. 
  6927.  
  6928. Shortcut Method 
  6929.  
  6930. After highlighting the area of interest, use mouse button two to click on the 
  6931. highlighted area.  From the displayed Selected Item Pop-up Menu, choose Zoom to 
  6932. selected range. 
  6933.  
  6934. Related Information 
  6935.  
  6936.      Zoom In Choice 
  6937.      Zoom Out Choice 
  6938.      Execution Density Selected Item Pop-up Menu 
  6939.      Keys Help. 
  6940.  
  6941.  
  6942. ΓòÉΓòÉΓòÉ 18.3.4. Scale Pages... Choice ΓòÉΓòÉΓòÉ
  6943.  
  6944. Select the Scale pages... choice to choose how many pages you want used to 
  6945. display the diagram. When you select the Scale pages... choice, a Scale pages 
  6946. window appears. 
  6947.  
  6948. Related Information 
  6949.  
  6950.      Analyze Trace Window 
  6951.      Execution Density Diagram Pop-up Menu 
  6952.      Keys Help. 
  6953.  
  6954.  
  6955. ΓòÉΓòÉΓòÉ <hidden> Scale Pages Window ΓòÉΓòÉΓòÉ
  6956.  
  6957. Use the Scale Pages  window to choose how much time is shown in the time slice. 
  6958. When you allow more pages, the diagram shows more detailed information. When 
  6959. you reduce the pages, the diagram shows less detailed information. 
  6960.  
  6961. Note:  Scaling adjusts the number that you select to get an integral number of 
  6962. full screens. 
  6963.  
  6964. The Performance Analyzer shows the total execution time for your program above 
  6965. the slider. Beneath the slider, it shows the current page size based on the 
  6966. size of the current window. 
  6967.  
  6968. The page size is determined by the height and width of the current window. 
  6969.  
  6970. Scaling the Pages 
  6971.  
  6972. To scale the pages in the diagram, do the following: 
  6973.  
  6974.    1. Use the slider to set the number of pages: 
  6975.  
  6976.           Move the slider arm to the Maximum  position to increase the number 
  6977.            of pages in the diagram. 
  6978.           Move the slider arm to the Minimum  position to decrease the number 
  6979.            of pages in the diagram. 
  6980.  
  6981.            Note:  When you move the slider arm, the page number changes to show 
  6982.            the new selection. Additionally, the Tics per row and Approximate 
  6983.            time slice values change to display the new settings. 
  6984.  
  6985.    2. Select the appropriate push button to continue: 
  6986.  
  6987.           OK 
  6988.           Cancel 
  6989.           Help. 
  6990.  
  6991.  Related Information 
  6992.  
  6993.      Analyze Trace Window 
  6994.      Execution Density Diagram 
  6995.      Time Line Diagram. 
  6996.      Keys Help. 
  6997.  
  6998.  
  6999. ΓòÉΓòÉΓòÉ 18.3.5. Include Functions... Choice ΓòÉΓòÉΓòÉ
  7000.  
  7001. Select the Include functions... choice to isolate specific functions to view in 
  7002. your program. This choice filters the trace file allowing you to isolate 
  7003. specific areas of interest or areas where problems are occurring. 
  7004.  
  7005. When you select the Include functions... choice, an Include Functions window 
  7006. appears. 
  7007.  
  7008. Related Information 
  7009.  
  7010.      Analyze Trace Window 
  7011.      Execution Density Diagram Pop-up Menu 
  7012.      Keys Help. 
  7013.  
  7014.  
  7015. ΓòÉΓòÉΓòÉ <hidden> Include Functions Window ΓòÉΓòÉΓòÉ
  7016.  
  7017. Use the Include Functions  window to isolate specific functions or view all 
  7018. functions. This window filters the trace file allowing you to isolate specific 
  7019. areas of interest or areas where problems are occurring. 
  7020.  
  7021. Isolating Specific Functions 
  7022.  
  7023. To include functions: 
  7024.  
  7025.    1. To include a specific function, select the Deselect all push button. 
  7026.  
  7027.    2. Scroll the list to find the function or functions you want displayed. 
  7028.  
  7029.    3. Select each function you want displayed. 
  7030.  
  7031.    4. Select the appropriate push button to continue: 
  7032.  
  7033.           OK 
  7034.           Cancel 
  7035.           Help 
  7036.  
  7037.  Viewing All Functions 
  7038.  
  7039.    1. To select all functions, select the Select all  push button. 
  7040.  
  7041.    2. Select the appropriate push button to continue: 
  7042.  
  7043.           OK 
  7044.           Cancel 
  7045.           Help 
  7046.  
  7047.  Related Information 
  7048.  
  7049.      Call Nesting Diagram 
  7050.      Execution Density Diagram 
  7051.      Dynamic Call Graph 
  7052.      Analyze Trace Window. 
  7053.      Keys Help. 
  7054.  
  7055.  
  7056. ΓòÉΓòÉΓòÉ 18.3.6. Include Threads... Choice ΓòÉΓòÉΓòÉ
  7057.  
  7058. Select the Include threads... choice to select which threads are displayed in 
  7059. the diagram. 
  7060.  
  7061. When you select the Include threads...  choice, an Include Threads window 
  7062. appears. The Include Threads window allows you to isolate specific threads in 
  7063. your program or show all threads. This choice filters the trace file allowing 
  7064. you to isolate specific areas of interest or areas where problems are 
  7065. occurring. 
  7066.  
  7067. Related Information 
  7068.  
  7069.      Analyze Trace Window 
  7070.      Execution Density Diagram Pop-up Menu 
  7071.      Keys Help. 
  7072.  
  7073.  
  7074. ΓòÉΓòÉΓòÉ 18.3.6.1. Include Threads Window ΓòÉΓòÉΓòÉ
  7075.  
  7076. Use the Include Threads window to select or isolate specific threads, and to 
  7077. enable and display specific pattern recognitions in the Execution Density 
  7078. diagram. 
  7079.  
  7080. Use the mouse to highlight your thread selection. You can choose a particular 
  7081. thread or all threads. 
  7082.  
  7083. Note:  The percentages are based upon the total execution time of the selected 
  7084. threads, not the total execution time. 
  7085.  
  7086. When you change the threads you affect the percentages. 
  7087.  
  7088. Selecting Specific Threads 
  7089.  
  7090. To select a specific thread: 
  7091.  
  7092.    1. Select the specific threads you want to display. 
  7093.  
  7094.    2. Select the appropriate push button to continue: 
  7095.  
  7096.           OK 
  7097.           Select all 
  7098.           Deselect all 
  7099.           Cancel 
  7100.           Help. 
  7101.  
  7102.  Selecting All Threads 
  7103.  
  7104.  To select all threads: 
  7105.  
  7106.    1. Highlight All threads to select all threads. 
  7107.  
  7108.    2. Select the appropriate push button to continue: 
  7109.  
  7110.           OK 
  7111.           Select all 
  7112.           Deselect all 
  7113.           Cancel 
  7114.           Help 
  7115.  
  7116.  Related Information 
  7117.  
  7118.      Dynamic Call Graph 
  7119.      Execution Density Diagram 
  7120.      Analyze Trace Window 
  7121.      Keys Help. 
  7122.  
  7123.  
  7124. ΓòÉΓòÉΓòÉ 18.4. Execution Density Options Menu ΓòÉΓòÉΓòÉ
  7125.  
  7126. The Options menu allows you to customize the Execution Density diagram and 
  7127. display additional information. 
  7128.  
  7129. The following choices are available from the Options menu: 
  7130.  
  7131.  Color 
  7132.            Selects the colors used to display the percentage of time used by 
  7133.            each function and the percentage of time each color represents. 
  7134.  
  7135.  Column width 
  7136.            Controls the width (in pixels) for each function column in the 
  7137.            diagram. 
  7138.  
  7139.  Correlation... 
  7140.            Synchronizes other diagrams to display the same highlighted region. 
  7141.  
  7142.  Status area 
  7143.            Control the gray area at the top of the window. 
  7144.  
  7145.  Tool bar 
  7146.            Use the Tool bar for a shortcut to other menus. 
  7147.  
  7148.  Settings 
  7149.            Saves the current settings or restores the defaults. 
  7150.  
  7151.  Related Information 
  7152.  
  7153.      Call Nesting Diagram 
  7154.      Dynamic Call Graph 
  7155.      Statistics Diagram 
  7156.      Time Line Diagram 
  7157.      Keys Help. 
  7158.  
  7159.  
  7160. ΓòÉΓòÉΓòÉ 18.4.1. Color... Choice ΓòÉΓòÉΓòÉ
  7161.  
  7162. Select the Color... choice to control the colors that are used in the diagram, 
  7163. and their meaning. Each color represents a range of percentages consumed by a 
  7164. function, across all threads, in a single time slice. When you select the 
  7165. Color... choice, a Color window displays. 
  7166.  
  7167. Related Information 
  7168.  
  7169.      Execution Density Diagram Pop-up Menu 
  7170.      Keys Help. 
  7171.  
  7172.  
  7173. ΓòÉΓòÉΓòÉ <hidden> Color Window ΓòÉΓòÉΓòÉ
  7174.  
  7175. Use the Color  window to show the current colors and time slices. For each 
  7176. color, a value is displayed to the left that shows the amount of time the color 
  7177. represents. 
  7178.  
  7179.  Color             Percent range 
  7180.  Blue              0 to 1.9 
  7181.  Dark cyan         2 to 4.9 
  7182.  Cyan              5 to 9.9 
  7183.  Pale gray         10 to 24.9 
  7184.  Pink              25 to 49.9 
  7185.  Red               50 to 100 
  7186.  You can change the color and the percentage time each color represents. 
  7187.  
  7188.  Setting Time Slice Colors 
  7189.  
  7190.  To change the colors used, do the following: 
  7191.  
  7192.    1. Select a spin button under Threshold Percentages to change the time 
  7193.       percentage that each color represents. 
  7194.  
  7195.    2. Select a spin button to the right of the color fields to change the 
  7196.       colors. 
  7197.  
  7198.    3. Select the appropriate push button to continue: 
  7199.  
  7200.           OK 
  7201.           Cancel 
  7202.           Help 
  7203.  
  7204.    4. To restore the initial defaults, select the Settings choice from the 
  7205.       Options menu, then select Restore initial defaults. 
  7206.  
  7207.  Related Information 
  7208.  
  7209.      Execution Density Diagram. 
  7210.      Hints and Tips 
  7211.      Keys Help. 
  7212.  
  7213.  
  7214. ΓòÉΓòÉΓòÉ 18.4.2. Column Width... Choice ΓòÉΓòÉΓòÉ
  7215.  
  7216. Select the Column width... choice to change the width of the displayed columns. 
  7217. This width can vary between 3 and 32, and the default is 16. Using this choice, 
  7218. along with changing the Scale Pages dialog, can either bring fine details into 
  7219. broader view, or allow you to see larger patterns and more information. 
  7220.  
  7221. When you select the Column width... choice, the Column Width window appears. 
  7222.  
  7223. Related Information 
  7224.  
  7225.      Execution Density Diagram Pop-up Menu 
  7226.      Keys Help. 
  7227.  
  7228.  
  7229. ΓòÉΓòÉΓòÉ <hidden> Column Width Window ΓòÉΓòÉΓòÉ
  7230.  
  7231. Use the Column Width  window to choose the width of the displayed columns. Use 
  7232. this window to enhance the display and see the details of the trace file. 
  7233.  
  7234. Changing the Columns Width 
  7235.  
  7236. To change the width of the columns: 
  7237.  
  7238.    1. Use the spin buttons to change the numbers. You can set the number 
  7239.       between 3 and 32 pixels per column. The default is 16. Select the top 
  7240.       spin button to increase the value and select the bottom spin button to 
  7241.       decrease the value. 
  7242.  
  7243.    2. Select the appropriate push button to continue: 
  7244.  
  7245.           OK 
  7246.           Cancel 
  7247.           Help. 
  7248.  
  7249.  Related Information 
  7250.  
  7251.      Execution Density Diagram. 
  7252.      Keys Help. 
  7253.  
  7254.  
  7255. ΓòÉΓòÉΓòÉ 18.4.3. Correlation... Choice ΓòÉΓòÉΓòÉ
  7256.  
  7257. Select the Correlation... choice to mark a point in the Call Nesting diagram, 
  7258. Execution Density diagram, or Time Line diagram and then find that same point 
  7259. in another Call Nesting diagram, Execution Density diagram, or Time Line 
  7260. diagram. You can correlate more than two diagrams at a time. 
  7261.  
  7262. When you select the Correlate... choice, the Correlation window appears. 
  7263.  
  7264. Related Information 
  7265.  
  7266.      Execution Density Selected Item Pop-up Menu 
  7267.      Analyze Trace Window 
  7268.      Keys Help. 
  7269.  
  7270.  
  7271. ΓòÉΓòÉΓòÉ 18.4.4. Status Area... Choice ΓòÉΓòÉΓòÉ
  7272.  
  7273. Select the Status area... choice to control the area at the top of the window. 
  7274. When you select the Status area... choice, the Status Area window appears. 
  7275.  
  7276. Related Information 
  7277.  
  7278.      Execution Density Status Area 
  7279.      Keys Help. 
  7280.  
  7281.  
  7282. ΓòÉΓòÉΓòÉ 18.4.4.1. Status Area Window ΓòÉΓòÉΓòÉ
  7283.  
  7284. Use the Status Area  window to control the area at the top of the window. 
  7285.  
  7286. The check boxes represent the choices in the Status Area that you can show or 
  7287. hide. When you disable the check box the choice is hidden. Likewise, when you 
  7288. enable the check box the choice displays in the Status Area. 
  7289.  
  7290. In each diagram the Status Area displays different information. When you select 
  7291. the Status Area  window, the choices in the window change based upon the Status 
  7292. Area of the diagram. 
  7293.  
  7294. Choices from the Status Area include: 
  7295.  
  7296.      Trace Description 
  7297.      Time Slice 
  7298.      Selected Region 
  7299.      Filters 
  7300.      Selected Object 
  7301.  
  7302.  Select the appropriate check box to continue. 
  7303.  
  7304.  Related Information 
  7305.  
  7306.      Call Nesting Status Area Window 
  7307.      Dynamic Call Graph Status Area Window 
  7308.      Time Line Status Area Window. 
  7309.      Keys Help. 
  7310.  
  7311.  
  7312. ΓòÉΓòÉΓòÉ 18.4.5. Tool Bar Cascading Choice ΓòÉΓòÉΓòÉ
  7313.  
  7314. Select the Tool bar cascading choice to have the Tool bar display or not 
  7315. display in your window, and to enable and disable the Hover help. 
  7316.  
  7317. The choices from the Tool bar cascaded menu are: 
  7318.  
  7319.  Show                     Choose to either show or hide the Tool bar. 
  7320.  Hover                    Choose to either enable or disable displaying the 
  7321.                           help text when the mouse pointer hovers over the Tool 
  7322.                           bar buttons. 
  7323.  
  7324.  Related Information 
  7325.  
  7326.      Keys Help. 
  7327.  
  7328.  
  7329. ΓòÉΓòÉΓòÉ 18.4.6. Settings Cascading Choice ΓòÉΓòÉΓòÉ
  7330.  
  7331. The choices from the Settings cascaded menu allow you to save current settings 
  7332. or return to the original settings. 
  7333.  
  7334.  Save 
  7335.            Save the current session settings. 
  7336.  
  7337.  Restore initial defaults 
  7338.            Restore the original settings. 
  7339.  
  7340.  Related Information 
  7341.  
  7342.      Save Choice 
  7343.      Restore Initial Defaults Choice 
  7344.      Keys Help. 
  7345.  
  7346.  
  7347. ΓòÉΓòÉΓòÉ 18.4.6.1. Save Choice ΓòÉΓòÉΓòÉ
  7348.  
  7349. Select the Save choice to save the current settings. These settings are stored 
  7350. in the ICSPERF.INI file and remain active until that file is erased. 
  7351.  
  7352. To restore the default settings, select the Restore initial defaults choice. 
  7353.  
  7354. Related Information 
  7355.  
  7356.      Restore Initial Defaults Choice 
  7357.      Keys Help. 
  7358.  
  7359.  
  7360. ΓòÉΓòÉΓòÉ 18.4.6.2. Restore Initial Defaults Choice ΓòÉΓòÉΓòÉ
  7361.  
  7362. Select the Restore initial defaults choice to change to the original or default 
  7363. settings. You can select the Save choice to save settings. 
  7364.  
  7365. Related Information 
  7366.  
  7367.      Save Choice. 
  7368.      Keys Help. 
  7369.  
  7370.  
  7371. ΓòÉΓòÉΓòÉ 18.5. Execution Density Project Menu ΓòÉΓòÉΓòÉ
  7372.  
  7373. This menu appears when you start the Performance Analyzer from within the 
  7374. WorkFrame environment. The Project menu gives you direct access to all of the 
  7375. actions that you can perform from your current location. 
  7376.  
  7377. When you select the Edit function choice from this menu, the source code for 
  7378. the selected function is displayed in the default editor for WorkFrame's edit 
  7379. action. 
  7380.  
  7381. Related Information 
  7382.  
  7383.      Search Paths Window 
  7384.      Trace Generation Window 
  7385.      Keys Help 
  7386.  
  7387.  
  7388. ΓòÉΓòÉΓòÉ 18.5.1. Edit Function Choice ΓòÉΓòÉΓòÉ
  7389.  
  7390. Select the Edit function choice to edit a source file in WorkFrame's default 
  7391. editor. This choice lets you edit the source for a function selected on the 
  7392. Execution Density diagram. When you are working in the WorkFrame environment, 
  7393. this choice is available from the Project menu on the Execution Density 
  7394. diagram. It is also available from the Selected Item pop-up menu on the 
  7395. Execution Density diagram. 
  7396.  
  7397. To locate a source file for editing, the Performance Analyzer must first locate 
  7398. the executable containing the name of the source file. The Performance Analyzer 
  7399. searches the following paths (in the order listed) to locate an executable: 
  7400.  
  7401.    1. Path specified in the Locate Executable window 
  7402.    2. Path specified in the Search path for executable files: entry field of 
  7403.       the Search Paths window 
  7404.    3. Directory where the executable was located when the trace file was 
  7405.       created 
  7406.    4. The current working directory 
  7407.    5. Path specified by the PATH environment variable. 
  7408.  
  7409.  To identify the name of the source file, the Performance Analyzer looks at the 
  7410.  debug information in the executable. The Performance Analyzer then searches 
  7411.  the following paths (in the order listed) to locate the source file: 
  7412.  
  7413.    1. Path specified in the Locate Source File window 
  7414.    2. Path specified in the Search path for source files: entry field of the 
  7415.       Search Paths window 
  7416.    3. Path specified in the compile statement (if provided) 
  7417.    4. Directory where the executable was located when the trace file was 
  7418.       created 
  7419.    5. The current working directory 
  7420.    6. Path specified by the INCLUDE environment variable. 
  7421.  
  7422.  If, after searching these paths, the Performance Analyzer cannot find the: 
  7423.  
  7424.    1. Executable, it displays the Locate Executable window to let you enter the 
  7425.       path where the executable resides. 
  7426.    2. Source file, it displays the Locate Source File window to let you enter 
  7427.       the path where the source file resides. 
  7428.  
  7429.  Once the source file for a function is located, the file is opened to the 
  7430.  first line of the function's code. 
  7431.  
  7432.  Notes 
  7433.  
  7434.    1. The Performance Analyzer remembers the paths you enter in the Locate 
  7435.       Executable and Locate Source File windows and uses them to look for files 
  7436.       the next time you select the Edit function choice. 
  7437.    2. You can specify paths that you want the Performance Analyzer to use by 
  7438.       selecting the Search Paths choice in the Options menu on the Performance 
  7439.       Analyzer - Window Manager window. The paths you enter are automatically 
  7440.       saved for the current session. If you want to save the paths for 
  7441.       subsequent sessions, select the Options menu and then select the Save 
  7442.       choice from the Settings cascaded menu. 
  7443.  
  7444.  Related Information 
  7445.  
  7446.      Locate Executable Window 
  7447.      Locate Source File Window 
  7448.      Search Paths Window 
  7449.      Starting the Performance Analyzer from WorkFrame 
  7450.      Keys Help. 
  7451.  
  7452.  
  7453. ΓòÉΓòÉΓòÉ 18.6. Execution Density Help Menu ΓòÉΓòÉΓòÉ
  7454.  
  7455. The Help menu has the following choices: 
  7456.  
  7457.  Help index          Displays an index of Help topics. 
  7458.  General help        Displays Help for the active window. 
  7459.  Using help          Describes how to use Help. 
  7460.  How do I?           Displays task Help. 
  7461.  Product information Displays information about the Performance Analyzer. 
  7462.  
  7463.  Related Information 
  7464.  
  7465.      Call Nesting Diagram 
  7466.      Dynamic Call Graph 
  7467.      Execution Density Diagram 
  7468.      Statistics Diagram 
  7469.      Time Line Diagram 
  7470.      Hints and Tips 
  7471.      Keys Help. 
  7472.  
  7473.  
  7474. ΓòÉΓòÉΓòÉ 18.6.1. Help Index Choice ΓòÉΓòÉΓòÉ
  7475.  
  7476. Select the Help index choice to display an alphabetical index of Performance 
  7477. Analyzer Help topics. This choice is available from the Help menu of the 
  7478. Execution Density diagram. 
  7479.  
  7480. Use the Previous push button to return to the last topic you viewed. Use the 
  7481. Search... push button to locate topics in the index. Use the Print... push 
  7482. button to print a topic. 
  7483.  
  7484. Related Information 
  7485.  
  7486.      Call Nesting Diagram 
  7487.      Dynamic Call Graph 
  7488.      Execution Density Diagram 
  7489.      Statistics Diagram 
  7490.      Time Line Diagram 
  7491.      Hints and Tips 
  7492.      Keys Help. 
  7493.  
  7494.  
  7495. ΓòÉΓòÉΓòÉ 18.6.2. General Help Choice ΓòÉΓòÉΓòÉ
  7496.  
  7497. Select the General help choice to display Help information for the active 
  7498. window. This choice is available from the Help menu of the Execution Density 
  7499. diagram. 
  7500.  
  7501. The online Help panel displayed is the same panel that is displayed when you 
  7502. place your cursor inside the window and press F1. 
  7503.  
  7504. Related Information 
  7505.  
  7506.      Call Nesting Diagram 
  7507.      Dynamic Call Graph 
  7508.      Execution Density Diagram 
  7509.      Statistics Diagram 
  7510.      Time Line Diagram 
  7511.      Hints and Tips 
  7512.      Keys Help. 
  7513.  
  7514.  
  7515. ΓòÉΓòÉΓòÉ 18.6.3. Using Help Choice ΓòÉΓòÉΓòÉ
  7516.  
  7517. Select the Using help choice for a description of how to use the IBM 
  7518. Performance Analyzer Help facility. This choice is available from the Help menu 
  7519. of the Execution Density diagram. 
  7520.  
  7521. Related Information 
  7522.  
  7523.      Call Nesting Diagram 
  7524.      Dynamic Call Graph 
  7525.      Execution Density Diagram 
  7526.      Statistics Diagram 
  7527.      Time Line Diagram 
  7528.      Hints and Tips 
  7529.      Keys Help. 
  7530.  
  7531.  
  7532. ΓòÉΓòÉΓòÉ 18.6.4. How Do I? Choice ΓòÉΓòÉΓòÉ
  7533.  
  7534. Select the How do I? choice to display the Performance Analyzer task help. This 
  7535. choice is available from the Help menu of the Execution Density diagram. 
  7536.  
  7537. Related Information 
  7538.  
  7539.      Call Nesting Diagram 
  7540.      Dynamic Call Graph 
  7541.      Execution Density Diagram 
  7542.      Statistics Diagram 
  7543.      Time Line Diagram 
  7544.      Hints and Tips 
  7545.      Keys Help. 
  7546.  
  7547.  
  7548. ΓòÉΓòÉΓòÉ 18.6.5. Product Information ΓòÉΓòÉΓòÉ
  7549.  
  7550. Select the Product information choice to display copyright and version 
  7551. information about the Performance Analyzer application. This choice is 
  7552. available from the Help menu of the Execution Density diagram. 
  7553.  
  7554. Related Information 
  7555.  
  7556.      Call Nesting Diagram 
  7557.      Dynamic Call Graph 
  7558.      Execution Density Diagram 
  7559.      Statistics Diagram 
  7560.      Time Line Diagram 
  7561.      Hints and Tips 
  7562.      Keys Help. 
  7563.  
  7564.  
  7565. ΓòÉΓòÉΓòÉ 18.7. Execution Density Current Column Indicator ΓòÉΓòÉΓòÉ
  7566.  
  7567. An arrow called the current column indicator is displayed at the top of the 
  7568. columns. The current column indicator lets you move to each column. Use the 
  7569. mouse to move to each column. 
  7570.  
  7571. To move the current column indicator, click on the column of interest and the 
  7572. arrow moves. You can drag the current column indicator arrow with the mouse and 
  7573. the Selected object information will change. 
  7574.  
  7575. Related Information 
  7576.  
  7577.      Execution Density Status Area 
  7578.      Keys Help. 
  7579.  
  7580.  
  7581. ΓòÉΓòÉΓòÉ 18.8. Execution Density Vertical Ruler ΓòÉΓòÉΓòÉ
  7582.  
  7583. The Vertical Ruler, located to the left of the diagram window, shows scale. 
  7584.  
  7585. To change the scale, select the Scale pages... choice from the View menu, and 
  7586. the Scale Pages window appears. 
  7587.  
  7588. Related Information 
  7589.  
  7590.      Execution Density Status Area 
  7591.      Keys Help. 
  7592.  
  7593.  
  7594. ΓòÉΓòÉΓòÉ 18.9. Execution Density Status Area ΓòÉΓòÉΓòÉ
  7595.  
  7596. The Status Area, located at the top of the window, describes the settings of 
  7597. the diagram. 
  7598.  
  7599. You can select the Status area choice to change the appearance of the area at 
  7600. the top of the Execution Density window. 
  7601.  
  7602. When you select the Status area... choice,the Status Area window appears. 
  7603.  
  7604. The choices in the Status area window include: 
  7605.  
  7606.  Trace description 
  7607.            Shows the description given to the trace file. 
  7608.  Time slice 
  7609.            Displays the value of the time slice. 
  7610.  Selected region 
  7611.            Displays the start, end, and total time of a selected region. 
  7612.  Filters 
  7613.            Shows when selected filters, such as functions and threads, are 
  7614.            active. 
  7615.  Selected object 
  7616.            Displays the name of the selected object. 
  7617.  
  7618.  Related Information 
  7619.  
  7620.      Call Nesting Status Area 
  7621.      Dynamic Call Graph Status Area 
  7622.      Time Line Status Area 
  7623.      Keys Help. 
  7624.  
  7625.  
  7626. ΓòÉΓòÉΓòÉ <hidden> Trace Description Status Line ΓòÉΓòÉΓòÉ
  7627.  
  7628. Trace description displays the descriptive text associated with the trace file 
  7629. being viewed in the diagram. This description comes from information you supply 
  7630. in either the Create Trace window or in the Trace Generation window before the 
  7631. trace file is created. 
  7632.  
  7633. Related Information 
  7634.  
  7635.      Execution Density Status Area Window 
  7636.      Execution Density Diagram. 
  7637.      Keys Help. 
  7638.  
  7639.  
  7640. ΓòÉΓòÉΓòÉ <hidden> Time Slice Status Line ΓòÉΓòÉΓòÉ
  7641.  
  7642. Time slice displays the amount of time associated with the height of a single 
  7643. horizontal line (or pixel) in the diagram. The time slice may be changed by 
  7644. changing the diagram's scale. The Performance Analyzer divides the entire trace 
  7645. time into equal time slices. 
  7646.  
  7647. Related Information 
  7648.  
  7649.      Execution Density Status Area Window 
  7650.      Execution Density Diagram. 
  7651.      Keys Help. 
  7652.  
  7653.  
  7654. ΓòÉΓòÉΓòÉ <hidden> Selected Region Status Line ΓòÉΓòÉΓòÉ
  7655.  
  7656. Selected region displays the start, end, and total time of a selected region. 
  7657.  
  7658. You can highlight a region of the diagram to see how long it took the code to 
  7659. execute. 
  7660.  
  7661. To highlight, press and hold mouse button one and drag the pointer across the 
  7662. region of the diagram that you want to check. Release mouse button one to end 
  7663. the highlighting. 
  7664.  
  7665.  Start time     Shows the point where you started selecting 
  7666.  End time       Displays the point where you stopped. 
  7667.  Elapsed time   Shows how long the selected region took to execute. 
  7668.  
  7669.  So, if you started selecting on the main function at 2.3 seconds and ended at 
  7670.  17.5 seconds, the Start time would be 2.3 seconds, the End time would be 17.5 
  7671.  seconds, and the Elapsed time would be 15.2 seconds. 
  7672.  
  7673.  Related Information 
  7674.  
  7675.      Execution Density Status Area Window 
  7676.      Execution Density Diagram. 
  7677.      Keys Help. 
  7678.  
  7679.  
  7680. ΓòÉΓòÉΓòÉ <hidden> Filters Status Line ΓòÉΓòÉΓòÉ
  7681.  
  7682. Filters shows when selected filters, such as threads and functions, are active. 
  7683. Filters allow you to temporarily reduce the amount of trace data displayed. 
  7684.  
  7685. So when you select specific threads or functions to display, you are filtering 
  7686. the trace data displayed. 
  7687.  
  7688. Related Information 
  7689.  
  7690.      Include Functions Window 
  7691.      Include Threads Window 
  7692.      Execution Density Diagram 
  7693.      Execution Density Status Area Window. 
  7694.      Keys Help. 
  7695.  
  7696.  
  7697. ΓòÉΓòÉΓòÉ <hidden> Selected Object Status Line ΓòÉΓòÉΓòÉ
  7698.  
  7699. Selected object displays the name of the selected object. Use mouse button one 
  7700. to click on an area of the diagram to see the name of the object file. 
  7701.  
  7702. Note:  In the Execution Density diagram, the current column indicator 
  7703. designates the selected object. 
  7704.  
  7705. Related Information 
  7706.  
  7707.      Execution Density Diagram 
  7708.      Execution Density Status Area Window. 
  7709.      Keys Help. 
  7710.  
  7711.  
  7712. ΓòÉΓòÉΓòÉ 18.10. Execution Density Diagram Pop-up Menu ΓòÉΓòÉΓòÉ
  7713.  
  7714. The pop-up menus allow you to quickly access the most often used features. 
  7715. There are two pop-up menus: Diagram and Selected Item. 
  7716.  
  7717. Execution Density Diagram Pop-up Menu 
  7718.  
  7719. This pop-up menu contains most of the choices from the Edit and Options menus. 
  7720. To access this menu, use mouse button two to click on the background area of 
  7721. the diagram. The menu is displayed with the following choices: 
  7722.  
  7723.      Find Function 
  7724.      Find next 
  7725.      Zoom in 
  7726.      Zoom out 
  7727.      Scale pages 
  7728.      Include functions 
  7729.      Include threads 
  7730.      Color 
  7731.      Column width 
  7732.  
  7733.  Related Information 
  7734.  
  7735.      Execution Density Selected Item Pop-up Menu 
  7736.      Execution Density Diagram 
  7737.      Keys Help. 
  7738.  
  7739.  
  7740. ΓòÉΓòÉΓòÉ 18.11. Execution Density Selected Item Pop-up Menu ΓòÉΓòÉΓòÉ
  7741.  
  7742. Execution Density Selected Item Pop-up Menu 
  7743.  
  7744. To access this pop-up menu, highlight a region of interest, move the mouse 
  7745. pointer into that area, and click on mouse button two. This menu contains the 
  7746. following choices: 
  7747.  
  7748.      Zoom to selected range 
  7749.      Correlation 
  7750.      Edit function 
  7751.  
  7752.  Related Information 
  7753.  
  7754.      Execution Density Diagram Pop-up Menu 
  7755.      Execution Density Diagram 
  7756.      Keys Help. 
  7757.  
  7758.  
  7759. ΓòÉΓòÉΓòÉ 19. Statistics Diagram ΓòÉΓòÉΓòÉ
  7760.  
  7761. Statistics Diagram 
  7762.  
  7763. The Statistics diagram gives you a textual report of execution time by function 
  7764. or executable. Use this information to find hot spots in the overall program 
  7765. execution. 
  7766.  
  7767. The Statistics diagram has two panes: Statistics Summary Pane and Statistics 
  7768. Details Pane. 
  7769.  
  7770. Resizing the Window 
  7771.  
  7772. You can resize the windows horizontally and the panes vertically. To resize a 
  7773. window or window pane, press and drag the mouse pointer on the split bar until 
  7774. the windows or window panes are the size you want. 
  7775.  
  7776. Note:  Times are shown in milliseconds. 
  7777.  
  7778. Areas of the Statistics Window 
  7779.  
  7780. The following topics describe the areas of the Statistics diagram: 
  7781.  
  7782.      Menu Bar Summary 
  7783.  
  7784.       The choices available from the Statistics diagram menu bar are: 
  7785.         -  Trace file 
  7786.         -  View 
  7787.         -  Options 
  7788.         -  Project 
  7789.         -  Help. 
  7790.      the Summary pane 
  7791.      the Details pane 
  7792.  
  7793.  Related Information 
  7794.  
  7795.      Statistics Summary Pane 
  7796.      Statistics Details Pane 
  7797.      Call Nesting Diagram 
  7798.      Dynamic Call Graph 
  7799.      Execution Density Diagram 
  7800.      Time Line Diagram 
  7801.      Hints and Tips 
  7802.      Keys Help. 
  7803.  
  7804.  
  7805. ΓòÉΓòÉΓòÉ 19.1. Statistics Summary Pane ΓòÉΓòÉΓòÉ
  7806.  
  7807. The Summary pane is in the top area of the window. You must scroll the window 
  7808. panes to view all of the information. Information provided in the Summary pane 
  7809. is as follows: 
  7810.  
  7811.      Executable name 
  7812.      Trace file description 
  7813.  
  7814.       Note:  This will only appear if you entered a description on the Create 
  7815.       Trace window in the Trace File Description field when you created the 
  7816.       trace file. 
  7817.      Execution date 
  7818.      Execution time 
  7819.  
  7820.  
  7821.      Number of executables generating events 
  7822.      Number of functions generating events 
  7823.      Number of threads generating events 
  7824.  
  7825.  
  7826.      Total number of events 
  7827.      Total number of annotations 
  7828.      Number of user events 
  7829.  
  7830.  
  7831.      Maximum call nest depth 
  7832.      Number of trace buffer flushes 
  7833.      Total trace time excluding overhead 
  7834.      Trace overhead 
  7835.  
  7836.  Related Information 
  7837.  
  7838.      Statistics Details Pane 
  7839.      Hints and Tips 
  7840.      Keys Help. 
  7841.  
  7842.  
  7843. ΓòÉΓòÉΓòÉ 19.2. Statistics Details Pane ΓòÉΓòÉΓòÉ
  7844.  
  7845. The Details pane is in the bottom area of the window. You must scroll the 
  7846. window panes to view all of the information. 
  7847.  
  7848. The Details pane has a left and right pane. The left pane displays the fully 
  7849. qualified name of the component that the statistics have been gathered on. 
  7850.  
  7851. Information provided on the left side of the Details pane is as follows: 
  7852.  
  7853. When you have selected Functions from the View and Details on menus, you see: 
  7854.  
  7855.      Function 
  7856.      Object file 
  7857.      Executable 
  7858.  
  7859.  When you have selected Executables from the View and Details on menus, you 
  7860.  see: 
  7861.  
  7862.      Executable 
  7863.  
  7864.  With function names, if user events have been included in the trace, they will 
  7865.  appear as separate entries in the list of function names. 
  7866.  
  7867.  The user events will be the function name that made the call to the user 
  7868.  event, followed by the user event in parentheses. 
  7869.  
  7870.  For executables, only the executable name is displayed. 
  7871.  
  7872.  Information provided on the right side of the Details pane is as follows: 
  7873.  
  7874.      Percent Of Execution 
  7875.      Percent On Stack 
  7876.      Number of Calls 
  7877.      Execution Time 
  7878.      Time on Stack 
  7879.      Minimum Call 
  7880.      Maximum Call 
  7881.      Average Call 
  7882.  
  7883.  Note:  If you disabled the Time stamp events choice before you created your 
  7884.  trace file, only the Number of Calls column will be displayed on the right 
  7885.  side of the Details pane. 
  7886.  
  7887.  Related Information 
  7888.  
  7889.      Statistics Summary Pane 
  7890.      Hints and Tips 
  7891.      Keys Help. 
  7892.  
  7893.  
  7894. ΓòÉΓòÉΓòÉ 19.3. Statistics Trace File Menu ΓòÉΓòÉΓòÉ
  7895.  
  7896. The following choices are available from the Statistics Trace file menu: 
  7897.  
  7898.  Open as 
  7899.            Displays a new or an additional diagram. 
  7900.  
  7901.  Save as text 
  7902.            Creates a file containing the summary information. 
  7903.  
  7904.  Printer settings... 
  7905.            Allows you to choose printer settings for your output. 
  7906.  
  7907.  Print 
  7908.            Prints the textual report of the Statistics diagram. 
  7909.  
  7910.  Window Manager 
  7911.            Displays the Window Manager window. 
  7912.  
  7913.  Exit Performance Analyzer 
  7914.            Exits the Performance Analyzer and closes all windows. 
  7915.  
  7916.  Related Information 
  7917.  
  7918.      Call Nesting Diagram 
  7919.      Dynamic Call Graph 
  7920.      Execution Density Diagram 
  7921.      Time Line Diagram 
  7922.      Keys Help. 
  7923.  
  7924.  
  7925. ΓòÉΓòÉΓòÉ 19.3.1. Open As Cascading Choice ΓòÉΓòÉΓòÉ
  7926.  
  7927. Select the Open as cascading choice to view another diagram. You can open as 
  7928. many new diagram windows as you want. 
  7929.  
  7930. To select a new diagram: 
  7931.  
  7932.    1. Select Open as from the Trace file menu. A cascaded menu is displayed 
  7933.       with the following choices: 
  7934.  
  7935.            Call Nesting 
  7936.            Dynamic Call Graph 
  7937.            Execution Density 
  7938.            Statistics 
  7939.            Time Line 
  7940.  
  7941.    2. Select the name of the diagram you want to view. A new window opens and 
  7942.       displays the diagram you selected. 
  7943.  
  7944.  Related Information 
  7945.  
  7946.      Selecting a Trace File to Analyze 
  7947.      Keys Help. 
  7948.  
  7949.  
  7950. ΓòÉΓòÉΓòÉ 19.3.1.1. Call Nesting Choice ΓòÉΓòÉΓòÉ
  7951.  
  7952. The Call Nesting choice is available from the Open as cascaded menu. When you 
  7953. select Call Nesting, the Call Nesting Diagram diagram displays. 
  7954.  
  7955. Related Information 
  7956.  
  7957.      Open As Choice 
  7958.      Keys Help. 
  7959.  
  7960.  
  7961. ΓòÉΓòÉΓòÉ 19.3.1.2. Dynamic Call Graph Choice ΓòÉΓòÉΓòÉ
  7962.  
  7963. The Dynamic Call Graph choice is available from the Open as cascaded menu. When 
  7964. you select Dynamic Call Graph, the Dynamic Call Graph displays. 
  7965.  
  7966. Related Information 
  7967.  
  7968.      Open As Choice 
  7969.      Keys Help. 
  7970.  
  7971.  
  7972. ΓòÉΓòÉΓòÉ 19.3.1.3. Execution Density Choice ΓòÉΓòÉΓòÉ
  7973.  
  7974. The Execution density choice is available from the Open as cascaded menu. When 
  7975. you select Execution Density, the Execution Density Diagram diagram displays. 
  7976.  
  7977. Related Information 
  7978.  
  7979.      Open As Choice 
  7980.      Keys Help. 
  7981.  
  7982.  
  7983. ΓòÉΓòÉΓòÉ 19.3.1.4. Statistics Choice ΓòÉΓòÉΓòÉ
  7984.  
  7985. The Statistics choice is available from the Open as cascaded menu. When you 
  7986. select Statistics, the Statistics Diagram displays. 
  7987.  
  7988. Related Information 
  7989.  
  7990.      Open As Choice 
  7991.      Keys Help. 
  7992.  
  7993.  
  7994. ΓòÉΓòÉΓòÉ 19.3.1.5. Time Line Choice ΓòÉΓòÉΓòÉ
  7995.  
  7996. The Time Line choice is available from the Open as cascaded menu. When you 
  7997. select Time Line, the Time Line diagram displays. 
  7998.  
  7999. Related Information 
  8000.  
  8001.      Open As Choice 
  8002.      Keys Help. 
  8003.  
  8004.  
  8005. ΓòÉΓòÉΓòÉ 19.3.2. Save As Text... Choice ΓòÉΓòÉΓòÉ
  8006.  
  8007. Select the Save as text... choice to save the Statistics diagram as an ASCII 
  8008. file. When you select the Save as text... choice, the Save As Text window 
  8009. appears. 
  8010.  
  8011. Related Information 
  8012.  
  8013.      Keys Help. 
  8014.  
  8015.  
  8016. ΓòÉΓòÉΓòÉ 19.3.2.1. Save As Text Window ΓòÉΓòÉΓòÉ
  8017.  
  8018. The Save as Text window lets you select the file name where the Performance 
  8019. Analyzer will save all the text contained in the Summary and Details areas of 
  8020. the window into an ASCII file. 
  8021.  
  8022. Note:  Save As Text does not save the binary trace file. 
  8023.  
  8024. Related Information 
  8025.  
  8026.      Keys Help. 
  8027.  
  8028.  
  8029. ΓòÉΓòÉΓòÉ 19.3.3. Printer Settings... Choice ΓòÉΓòÉΓòÉ
  8030.  
  8031. Select the Printer settings... choice to select settings for your print jobs. 
  8032.  
  8033. When you select the Printer settings... choice, the Printer Settings window 
  8034. appears. 
  8035.  
  8036.      OK 
  8037.      Font 
  8038.      Job 
  8039.      Cancel 
  8040.      Help 
  8041.  
  8042.  Related Information 
  8043.  
  8044.      Keys Help. 
  8045.  
  8046.  
  8047. ΓòÉΓòÉΓòÉ 19.3.4. Print... Choice ΓòÉΓòÉΓòÉ
  8048.  
  8049. Select the Print... choice to print the information from the Statistics 
  8050. diagram. 
  8051.  
  8052. To print the Statistics diagram, select the Print...  choice from the Trace 
  8053. file menu. The Print window appears. 
  8054.  
  8055. Related Information 
  8056.  
  8057.      Keys Help. 
  8058.  
  8059.  
  8060. ΓòÉΓòÉΓòÉ 19.3.5. Window Manager Choice ΓòÉΓòÉΓòÉ
  8061.  
  8062. Select the Window manager choice to display the Window Manager window. 
  8063.  
  8064. Related Information 
  8065.  
  8066.      Performance Analyzer - Window Manager 
  8067.      Keys Help. 
  8068.  
  8069.  
  8070. ΓòÉΓòÉΓòÉ 19.3.6. Exit Performance Analyzer Choice ΓòÉΓòÉΓòÉ
  8071.  
  8072. Select Exit Performance Analyzer to exit the Performance Analyzer and all 
  8073. windows. 
  8074.  
  8075. Related Information 
  8076.  
  8077.      Keys Help. 
  8078.  
  8079.  
  8080. ΓòÉΓòÉΓòÉ 19.4. Statistics View Menu ΓòÉΓòÉΓòÉ
  8081.  
  8082. The choices from the View menu are: 
  8083.  
  8084.  Details on 
  8085.            Select to view the Details window by function or executable. 
  8086.  
  8087.  Include threads 
  8088.            Select which threads to include or exclude in the diagram. 
  8089.  
  8090.  Sort 
  8091.            Select how you want to sort the Details window. 
  8092.  
  8093.  Related Information 
  8094.  
  8095.      Call Nesting Diagram 
  8096.      Dynamic Call Graph 
  8097.      Execution Density Diagram 
  8098.      Time Line Diagram 
  8099.      Keys Help. 
  8100.  
  8101.  
  8102. ΓòÉΓòÉΓòÉ 19.4.1. Details On Choice ΓòÉΓòÉΓòÉ
  8103.  
  8104. Select the Details on choice to view the executables or the functions: 
  8105.  
  8106.  Functions                Groups details by function. 
  8107.  Executables              Groups details by executables. 
  8108.  
  8109.  Related Information 
  8110.  
  8111.      Find Choice 
  8112.      Keys Help. 
  8113.  
  8114.  
  8115. ΓòÉΓòÉΓòÉ 19.4.1.1. Functions Choice ΓòÉΓòÉΓòÉ
  8116.  
  8117. Select the Functions choice to view the functions included in the trace. 
  8118.  
  8119. To view the functions, select Functions from the Details on menu. A check mark 
  8120. displays to show the choice is selected. 
  8121.  
  8122. Related Information 
  8123.  
  8124.      Executables Choice 
  8125.      Keys Help. 
  8126.  
  8127.  
  8128. ΓòÉΓòÉΓòÉ 19.4.1.2. Executables Choice ΓòÉΓòÉΓòÉ
  8129.  
  8130. Select the Executables choice to view the executables included in the trace. 
  8131.  
  8132. To view the executables, select Executables from the Details on menu. A check 
  8133. mark displays to show the choice is selected. 
  8134.  
  8135. Related Information 
  8136.  
  8137.      Functions Choice 
  8138.      Keys Help. 
  8139.  
  8140.  
  8141. ΓòÉΓòÉΓòÉ 19.4.2. Include Threads... Choice ΓòÉΓòÉΓòÉ
  8142.  
  8143.  Select the Include threads... choice to select which threads are displayed in 
  8144. the diagram. When you select the Include threads... choice, an Include Threads 
  8145. window appears. 
  8146.  
  8147. Note:  The percentages are based upon the total execution time of the selected 
  8148. threads, not the total execution time. 
  8149.  
  8150. When you change the threads you affect the percentages. 
  8151.  
  8152. Related Information 
  8153.  
  8154.      Keys Help. 
  8155.  
  8156.  
  8157. ΓòÉΓòÉΓòÉ 19.4.2.1. Include Threads Window ΓòÉΓòÉΓòÉ
  8158.  
  8159. Use the Include Threads window to select or isolate specific threads, and to 
  8160. enable and display specific pattern recognitions in the Statistics diagram. 
  8161.  
  8162. Use the mouse to highlight your thread selections. 
  8163.  
  8164. Note:  The percentages are based upon the total execution time of the selected 
  8165. threads, not the total execution time. 
  8166.  
  8167. When you change the threads you affect the percentages. 
  8168.  
  8169. Selecting Specific Threads 
  8170.  
  8171. To select a specific thread: 
  8172.  
  8173.    1. Select the specific threads you want to display. 
  8174.  
  8175.    2. Select the appropriate push button to continue: 
  8176.  
  8177.           OK 
  8178.           Select all 
  8179.           Deselect all 
  8180.           Cancel 
  8181.           Help. 
  8182.  
  8183.  Selecting All Threads 
  8184.  
  8185.  To select all threads: 
  8186.  
  8187.    1. Select the Select all push button in the Include threads window to select 
  8188.       all threads. 
  8189.  
  8190.    2. Select the appropriate push button to continue: 
  8191.  
  8192.           OK 
  8193.           Select all 
  8194.           Deselect all 
  8195.           Cancel 
  8196.           Help 
  8197.  
  8198.  Related Information 
  8199.  
  8200.      Dynamic Call Graph 
  8201.      Execution Density Diagram 
  8202.      Analyze Trace Window 
  8203.      Keys Help. 
  8204.  
  8205.  
  8206. ΓòÉΓòÉΓòÉ 19.4.3. Sort Cascading Choice ΓòÉΓòÉΓòÉ
  8207.  
  8208. Select the Sort choice to sort the Details windows based on one of the columns. 
  8209.  
  8210. When you select Sort, a cascaded menu is displayed with the following choices: 
  8211.  
  8212.      Function name 
  8213.      Object file name 
  8214.      Executable name 
  8215.      Execution time 
  8216.      Time on call stack 
  8217.      Number of calls 
  8218.      Minimum call 
  8219.      Maximum call 
  8220.      Average call. 
  8221.  
  8222.  Related Information 
  8223.  
  8224.      Analyze Trace Window 
  8225.      Keys Help. 
  8226.  
  8227.  
  8228. ΓòÉΓòÉΓòÉ 19.4.3.1. Function Name Choice ΓòÉΓòÉΓòÉ
  8229.  
  8230. Select the Function name choice to sort the names of the functions listed in 
  8231. the Function column in the Details window in alphabetical order. The names are 
  8232. placed in alphabetical order. 
  8233.  
  8234. Select the choice and the Details window sorts all data by function name. 
  8235.  
  8236. Related Information 
  8237.  
  8238.      Sort Choice 
  8239.      Object file name 
  8240.      Executable name 
  8241.      Execution time 
  8242.      Time on call stack 
  8243.      Number of calls 
  8244.      Minimum call 
  8245.      Maximum call 
  8246.      Average call. 
  8247.      Keys Help. 
  8248.  
  8249.  
  8250. ΓòÉΓòÉΓòÉ 19.4.3.2. Object File Name Choice ΓòÉΓòÉΓòÉ
  8251.  
  8252. Select the Object file name choice to sort on the Object file column in the 
  8253. Details window in alphabetical order. 
  8254.  
  8255. Select the choice and the Details window sorts all data by object file name. 
  8256.  
  8257. Related Information 
  8258.  
  8259.      Sort Choice 
  8260.      Function name 
  8261.      Executable name 
  8262.      Execution time 
  8263.      Time on call stack 
  8264.      Number of calls 
  8265.      Minimum call 
  8266.      Maximum call 
  8267.      Average call. 
  8268.      Keys Help. 
  8269.  
  8270.  
  8271. ΓòÉΓòÉΓòÉ 19.4.3.3. Executable Name Choice ΓòÉΓòÉΓòÉ
  8272.  
  8273. Select the Executable name choice to sort by the Executable column in the 
  8274. Details window in alphabetical order. 
  8275.  
  8276. Select the choice and the Details window sorts all data by executable name. 
  8277.  
  8278. Related Information 
  8279.  
  8280.      Sort Choice 
  8281.      Function name 
  8282.      Object file name 
  8283.      Execution time 
  8284.      Time on call stack 
  8285.      Number of calls 
  8286.      Minimum call 
  8287.      Maximum call 
  8288.      Average call. 
  8289.      Keys Help. 
  8290.  
  8291.  
  8292. ΓòÉΓòÉΓòÉ 19.4.3.4. Execution Time Choice ΓòÉΓòÉΓòÉ
  8293.  
  8294. Select the Execution Time choice to sort by the Execution Time column in the 
  8295. Details window in ascending order based upon execution time. 
  8296.  
  8297. Select the choice and the Details window sorts all data by execution time. 
  8298.  
  8299. Each entry in this column designates the percentage of the total execution time 
  8300. spent in a particular function. 
  8301.  
  8302. Related Information 
  8303.  
  8304.      Sort Choice 
  8305.      Function name 
  8306.      Object file name 
  8307.      Executable name 
  8308.      Time on call stack 
  8309.      Number of calls 
  8310.      Minimum call 
  8311.      Maximum call 
  8312.      Average call. 
  8313.      Keys Help. 
  8314.  
  8315.  
  8316. ΓòÉΓòÉΓòÉ 19.4.3.5. Time on Call Stack Choice ΓòÉΓòÉΓòÉ
  8317.  
  8318. Select the Time on call stack choice to sort by the Time on call stack column 
  8319. in the Details window in descending order. 
  8320.  
  8321. Select the choice and the Details window sorts all data by the Call stack 
  8322. column. The function with the most time is placed at the top of the column. 
  8323.  
  8324. Each entry in this column designates the total amount of time a particular 
  8325. function was on the call stack. 
  8326.  
  8327. Related Information 
  8328.  
  8329.      Sort Choice 
  8330.      Function name 
  8331.      Object file name 
  8332.      Executable name 
  8333.      Execution time 
  8334.      Number of calls 
  8335.      Minimum call 
  8336.      Maximum call 
  8337.      Average call. 
  8338.      Keys Help. 
  8339.  
  8340.  
  8341. ΓòÉΓòÉΓòÉ 19.4.3.6. Number of Calls Choice ΓòÉΓòÉΓòÉ
  8342.  
  8343. Select the Number of calls choice to sort the Number of calls column in the 
  8344. Details window in descending order. 
  8345.  
  8346. Select the choice and the Details window sorts all data by number of calls 
  8347. column. 
  8348.  
  8349. Each entry in this column designates the total number of times a particular 
  8350. function is called. 
  8351.  
  8352. Related Information 
  8353.  
  8354.      Sort Choice 
  8355.      Function name 
  8356.      Object file name 
  8357.      Executable name 
  8358.      Execution time 
  8359.      Time on call stack 
  8360.      Minimum call 
  8361.      Maximum call 
  8362.      Average call. 
  8363.      Keys Help. 
  8364.  
  8365.  
  8366. ΓòÉΓòÉΓòÉ 19.4.3.7. Minimum Call Choice ΓòÉΓòÉΓòÉ
  8367.  
  8368. Select the Minimum call choice to sort the Minimum call column in the Details 
  8369. window in ascending order. The function with the least number of calls is 
  8370. placed at the top. 
  8371.  
  8372. Select the choice and the Details window sorts all data by the minimum call 
  8373. time column. 
  8374.  
  8375. Each entry in this column designates the minimum time spent in a call to a 
  8376. particular function. 
  8377.  
  8378. Related Information 
  8379.  
  8380.      Sort Choice 
  8381.      Function name 
  8382.      Object file name 
  8383.      Executable name 
  8384.      Execution time 
  8385.      Time on call stack 
  8386.      Number of calls 
  8387.      Maximum call 
  8388.      Average call. 
  8389.      Keys Help. 
  8390.  
  8391.  
  8392. ΓòÉΓòÉΓòÉ 19.4.3.8. Maximum Call Choice ΓòÉΓòÉΓòÉ
  8393.  
  8394. Select the Maximum call  choice to sort the Maximum callcolumn in the Details 
  8395. window in descending order. 
  8396.  
  8397. The function with the most calls is placed at top. 
  8398.  
  8399. Select the choice and the Details window sorts all data by Maximum Call time 
  8400. column. 
  8401.  
  8402. Each entry in this column designates the average amount of time spent in calls 
  8403. to a particular function. 
  8404.  
  8405. Related Information 
  8406.  
  8407.      Sort Choice 
  8408.      Function name 
  8409.      Object file name 
  8410.      Executable name 
  8411.      Execution time 
  8412.      Time on call stack 
  8413.      Number of calls 
  8414.      Minimum call 
  8415.      Average call. 
  8416.      Keys Help. 
  8417.  
  8418.  
  8419. ΓòÉΓòÉΓòÉ 19.4.3.9. Average Call Choice ΓòÉΓòÉΓòÉ
  8420.  
  8421. Select the Average call choice to sort the Average call column in the Details 
  8422. window in descending order. The function with the longest average call time is 
  8423. placed at the top. 
  8424.  
  8425. Select the choice and the Details window sorts all data by Average the call 
  8426. time column. 
  8427.  
  8428. Each entry in this column designates the average amount of time spent in calls 
  8429. to a particular function. 
  8430.  
  8431. Related Information 
  8432.  
  8433.      Sort Choice 
  8434.      Function name 
  8435.      Object file name 
  8436.      Executable name 
  8437.      Execution time 
  8438.      Time on call stack 
  8439.      Number of calls 
  8440.      Minimum call 
  8441.      Maximum call 
  8442.      Keys Help. 
  8443.  
  8444.  
  8445. ΓòÉΓòÉΓòÉ 19.5. Statistics Options Menu ΓòÉΓòÉΓòÉ
  8446.  
  8447. The Options menu allows you to customize the Statistics diagram and display 
  8448. additional information. 
  8449.  
  8450. The following choices are available from the Options menu: 
  8451.  
  8452.  Find 
  8453.            Searches for a function or an executable. 
  8454.  
  8455.  Font 
  8456.            Selects the font and font size for the Summary and Details panes. 
  8457.  
  8458.  Tool bar 
  8459.            Use the Tool bar for a shortcut to other menus. 
  8460.  
  8461.  Settings 
  8462.            Saves the current settings or restores the default settings. 
  8463.  
  8464.  Related Information 
  8465.  
  8466.      Call Nesting Diagram 
  8467.      Dynamic Call Graph 
  8468.      Execution Density Diagram 
  8469.      Time Line Diagram 
  8470.      Hints and Tips 
  8471.      Keys Help. 
  8472.  
  8473.  
  8474. ΓòÉΓòÉΓòÉ 19.5.1. Find... Choice ΓòÉΓòÉΓòÉ
  8475.  
  8476. Select the Find... choice to search for functions or executables in the 
  8477. Statistics diagram. 
  8478.  
  8479. Find Functions: 
  8480.  
  8481. When you select the Find...  choice, and Functions is enabled, a Find Function 
  8482. window appears. 
  8483.  
  8484. Note:  To enable the Functions choice, from the View menu, select Details on, 
  8485. then select Functions A check mark appears beside the word Functions when it is 
  8486. enabled.  Click on it again to disable it. 
  8487.  
  8488. Find Executables: 
  8489.  
  8490. When you select the Find...  choice, and Executables is enabled, a Find 
  8491. Executables window appears. 
  8492.  
  8493. Note:  To enable the Executables choice, from the View menu, select Details on, 
  8494. then select Executables A check mark appears beside the word Executables when 
  8495. it is enabled.  Click on it again to disable it. 
  8496.  
  8497. Related Information 
  8498.  
  8499.      Keys Help. 
  8500.  
  8501.  
  8502. ΓòÉΓòÉΓòÉ <hidden> Find Functions Window ΓòÉΓòÉΓòÉ
  8503.  
  8504. Use the Find Functions window to search for a specific function in the diagram. 
  8505.  
  8506. Searching for Functions 
  8507.  
  8508. To search for a function: 
  8509.  
  8510.    1. From the View menu, select Details on, then click on Functions. 
  8511.  
  8512.       Note:  Depending upon whether you selected Functions or Executables, the 
  8513.       Find window comes up with the appropriate selection in the container 
  8514.       area. 
  8515.  
  8516.    2. Leave the Find string entry field blank and press enter to get a display 
  8517.       a list of all functions in the list box, or enter the file name (or part 
  8518.       of the file name) of the function you want to display in the list box. 
  8519.  
  8520.       Click on the Case sensitive check box to enable case sensitive searching. 
  8521.  
  8522.    3. Select a function from the list box. 
  8523.  
  8524.    4. Select the appropriate push button to continue: 
  8525.  
  8526.           OK 
  8527.           Cancel 
  8528.           Help 
  8529.  
  8530.       Note:  The function is highlighted when found. 
  8531.  
  8532.  Related Information 
  8533.  
  8534.      Find Executables Choice 
  8535.      Keys Help. 
  8536.  
  8537.  
  8538. ΓòÉΓòÉΓòÉ <hidden> Find Executables Window ΓòÉΓòÉΓòÉ
  8539.  
  8540. Use the Find executables window to search for a specific executable in the 
  8541. diagram. 
  8542.  
  8543. Searching for Executables 
  8544.  
  8545. To search for an executable: 
  8546.  
  8547.    1. From the View menu, select Details on, then click on Executables. 
  8548.  
  8549.       Note:  Depending upon whether you selected Functions or Executables, the 
  8550.       Find window comes up with the appropriate selection in the container 
  8551.       area. 
  8552.  
  8553.    2. Leave the Find string entry field blank and press enter to get a display 
  8554.       a list of all executables in the list box, or enter the file name (or 
  8555.       part of the file name) of the executable you want to display in the list 
  8556.       box. 
  8557.  
  8558.       Click on the Case sensitive check box to enable case sensitive searching. 
  8559.  
  8560.    3. Select an executable from the list box. 
  8561.  
  8562.    4. Select the appropriate push button to continue: 
  8563.  
  8564.           OK 
  8565.           Cancel 
  8566.           Help 
  8567.  
  8568.       Note:  The executable is highlighted when found. 
  8569.  
  8570.  Related Information 
  8571.  
  8572.      Find Function Choice 
  8573.      Keys Help. 
  8574.  
  8575.  
  8576. ΓòÉΓòÉΓòÉ 19.5.2. Font... Choice ΓòÉΓòÉΓòÉ
  8577.  
  8578. Select the Font... choice to change the font, font style, and font size for the 
  8579. text area of the Statistics window. This choice is available from the Options 
  8580. menu of the Statistics window. When you select this choice, the Font window 
  8581. appears. 
  8582.  
  8583. The Font window has the following areas: 
  8584.  
  8585.  Name entry field      Type a font name in this entry field or click on the 
  8586.                        scroll bar on the right side of the entry field to see a 
  8587.                        list of choices and select a name from the list. 
  8588.  Size entry field      Type a font size in this entry field or click on the 
  8589.                        scroll bar on the right side of the entry field to see a 
  8590.                        list of choices and select a size from the list. 
  8591.  Style entry field     Type a font style in this entry field or click on the 
  8592.                        scroll bar on the right side of the entry field to see a 
  8593.                        list of choices and select a style from the list. 
  8594.  Emphasis check boxes  Click on one of these check boxes to outline, 
  8595.                        underscore, or strikeout text. 
  8596.  Sample box            This box shows a sample of how text will appear with the 
  8597.                        settings you have selected. 
  8598.  Ok push button        Changes the font according to the settings you selected. 
  8599.  Reset push button     Changes all font settings to the default settings. 
  8600.  Cancel push button    Closes the window without making changes. 
  8601.  
  8602.  Related Information 
  8603.  
  8604.      Keys Help. 
  8605.  
  8606.  
  8607. ΓòÉΓòÉΓòÉ 19.5.3. Tool Bar Cascading Choice ΓòÉΓòÉΓòÉ
  8608.  
  8609. Select the Tool bar cascading choice to have the Tool bar display or not 
  8610. display in your window, and to enable and disable the Hover help. 
  8611.  
  8612. The choices from the Tool bar cascaded menu are: 
  8613.  
  8614.  Show                     Choose to either show or hide the Tool bar. 
  8615.  Hover                    Choose to either enable or disable displaying the 
  8616.                           help text when the mouse pointer hovers over the Tool 
  8617.                           bar buttons. 
  8618.  
  8619.  Related Information 
  8620.  
  8621.      Keys Help. 
  8622.  
  8623.  
  8624. ΓòÉΓòÉΓòÉ 19.5.4. Settings Cascading Choice ΓòÉΓòÉΓòÉ
  8625.  
  8626. The choices from the Settings cascaded menu allow you to save current settings 
  8627. or switch to the original settings. 
  8628.  
  8629.  Save 
  8630.            Save the current session settings. 
  8631.  
  8632.  Restore initial defaults 
  8633.            Restore the original settings. 
  8634.  
  8635.  Related Information 
  8636.  
  8637.      Save Choice 
  8638.      Restore Initial Defaults Choice 
  8639.      Keys Help. 
  8640.  
  8641.  
  8642. ΓòÉΓòÉΓòÉ 19.5.4.1. Save Choice ΓòÉΓòÉΓòÉ
  8643.  
  8644. Select the Save choice to save the current settings. These settings are stored 
  8645. in the ICSPERF.INI file and remain active until that file is erased. 
  8646.  
  8647. To restore the default settings, select the Restore defaults choice. 
  8648.  
  8649. Related Information 
  8650.  
  8651.      Restore Initial Defaults Choice 
  8652.      Keys Help. 
  8653.  
  8654.  
  8655. ΓòÉΓòÉΓòÉ 19.5.4.2. Restore Initial Defaults Choice ΓòÉΓòÉΓòÉ
  8656.  
  8657. Select the Restore initial defaults choice to change to the original or default 
  8658. settings. You can select the Save choice to save settings. 
  8659.  
  8660. Related Information 
  8661.  
  8662.      Save Choice 
  8663.      Keys Help. 
  8664.  
  8665.  
  8666. ΓòÉΓòÉΓòÉ 19.6. Statistics Project Menu ΓòÉΓòÉΓòÉ
  8667.  
  8668. This menu appears when you start the Performance Analyzer from within the 
  8669. WorkFrame environment. The Project menu gives you direct access to all of the 
  8670. actions that you can perform from your current location. 
  8671.  
  8672. When you select the Edit function choice from this menu, the source code for 
  8673. the selected function is displayed in the default editor for WorkFrame's edit 
  8674. action. 
  8675.  
  8676. Related Information 
  8677.  
  8678.      Search Paths Window 
  8679.      Keys Help 
  8680.  
  8681.  
  8682. ΓòÉΓòÉΓòÉ 19.6.1. Edit Function Choice ΓòÉΓòÉΓòÉ
  8683.  
  8684. Select the Edit function choice to edit a source file in WorkFrame's default 
  8685. editor. This choice lets you edit the source for a function selected on the 
  8686. Statistics diagram. When you are working in the WorkFrame environment, this 
  8687. choice is available from the Project menu on the Statistics diagram. It is also 
  8688. available from the pop-up menu on the Statistics diagram. 
  8689.  
  8690. To locate a source file for editing, the Performance Analyzer must first locate 
  8691. the executable containing the name of the source file. The Performance Analyzer 
  8692. searches the following paths (in the order listed) to locate an executable: 
  8693.  
  8694.    1. Path specified in the Locate Executable window 
  8695.    2. Path specified in the Search path for executable files: entry field of 
  8696.       the Search Paths window 
  8697.    3. Directory where the executable was located when the trace file was 
  8698.       created 
  8699.    4. The current working directory 
  8700.    5. Path specified by the PATH environment variable. 
  8701.  
  8702.  To identify the name of the source file, the Performance Analyzer looks at the 
  8703.  debug information in the executable. The Performance Analyzer then searches 
  8704.  the following paths (in the order listed) to locate the source file: 
  8705.  
  8706.    1. Path specified in the Locate Source File window 
  8707.    2. Path specified in the Search path for source files: entry field of the 
  8708.       Search Paths window 
  8709.    3. Path specified in the compile statement (if provided) 
  8710.    4. Directory where the executable was located when the trace file was 
  8711.       created 
  8712.    5. The current working directory 
  8713.    6. Path specified by the INCLUDE environment variable. 
  8714.  
  8715.  If, after searching these paths, the Performance Analyzer cannot find the: 
  8716.  
  8717.    1. Executable, it displays the Locate Executable window to let you enter the 
  8718.       path where the executable resides. 
  8719.    2. Source file, it displays the Locate Source File window to let you enter 
  8720.       the path where the source file resides. 
  8721.  
  8722.  Once the source file for a function is located, the file is opened to the 
  8723.  first line of the function's code. 
  8724.  
  8725.  Notes 
  8726.  
  8727.    1. The Performance Analyzer remembers the paths you enter in the Locate 
  8728.       Executable and Locate Source File windows and uses them to look for files 
  8729.       the next time you select the Edit function choice. 
  8730.    2. You can specify paths that you want the Performance Analyzer to use by 
  8731.       selecting the Search Paths choice in the Options menu on the Performance 
  8732.       Analyzer - Window Manager window. The paths you enter are automatically 
  8733.       saved for the current session. If you want to save the paths for 
  8734.       subsequent sessions, select the Options menu and then select the Save 
  8735.       choice from the Settings cascaded menu. 
  8736.  
  8737.  Related Information 
  8738.  
  8739.      Locate Executable Window 
  8740.      Locate Source File Window 
  8741.      Search Paths Window 
  8742.      Starting the Performance Analyzer from WorkFrame 
  8743.      Keys Help. 
  8744.  
  8745.  
  8746. ΓòÉΓòÉΓòÉ 19.7. Statistics Help Menu ΓòÉΓòÉΓòÉ
  8747.  
  8748. The Help menu has the following choices: 
  8749.  
  8750.  Help index          Displays an index of Help topics. 
  8751.  General help        Displays Help for the active window. 
  8752.  Using help          Describes how to use Help. 
  8753.  How do I?           Displays task Help. 
  8754.  Product information Displays information about the Performance Analyzer. 
  8755.  
  8756.  Related Information 
  8757.  
  8758.      Call Nesting Diagram 
  8759.      Dynamic Call Graph 
  8760.      Execution Density Diagram 
  8761.      Statistics Diagram 
  8762.      Time Line Diagram 
  8763.      Hints and Tips 
  8764.      Keys Help. 
  8765.  
  8766.  
  8767. ΓòÉΓòÉΓòÉ 19.7.1. Help Index Choice ΓòÉΓòÉΓòÉ
  8768.  
  8769. Select the Help index choice to display an alphabetical index of Performance 
  8770. Analyzer Help topics. This choice is available from the Help menu of the 
  8771. Statistics diagram. 
  8772.  
  8773. Use the Previous push button to return to the last topic you viewed. Use the 
  8774. Search... push button to locate topics in the index. Use the Print... push 
  8775. button to print a topic. 
  8776.  
  8777. Related Information 
  8778.  
  8779.      Call Nesting Diagram 
  8780.      Dynamic Call Graph 
  8781.      Execution Density Diagram 
  8782.      Statistics Diagram 
  8783.      Time Line Diagram 
  8784.      Hints and Tips 
  8785.      Keys Help. 
  8786.  
  8787.  
  8788. ΓòÉΓòÉΓòÉ 19.7.2. General Help Choice ΓòÉΓòÉΓòÉ
  8789.  
  8790. Select the General help choice to display Help information for the active 
  8791. window. This choice is available from the Help menu of the Statistics diagram. 
  8792.  
  8793. The online Help panel displayed is the same panel that is displayed when you 
  8794. place your cursor inside the window and press F1. 
  8795.  
  8796. Related Information 
  8797.  
  8798.      Call Nesting Diagram 
  8799.      Dynamic Call Graph 
  8800.      Execution Density Diagram 
  8801.      Statistics Diagram 
  8802.      Time Line Diagram 
  8803.      Hints and Tips 
  8804.      Keys Help. 
  8805.  
  8806.  
  8807. ΓòÉΓòÉΓòÉ 19.7.3. Using Help Choice ΓòÉΓòÉΓòÉ
  8808.  
  8809. Select the Using help choice for a description of how to use the IBM 
  8810. Performance Analyzer Help facility. This choice is available from the Help menu 
  8811. of the Statistics diagram. 
  8812.  
  8813. Related Information 
  8814.  
  8815.      Call Nesting Diagram 
  8816.      Dynamic Call Graph 
  8817.      Execution Density Diagram 
  8818.      Statistics Diagram 
  8819.      Time Line Diagram 
  8820.      Hints and Tips 
  8821.      Keys Help. 
  8822.  
  8823.  
  8824. ΓòÉΓòÉΓòÉ 19.7.4. How Do I? Choice ΓòÉΓòÉΓòÉ
  8825.  
  8826. Select the How do I? choice to display the Performance Analyzer task help. This 
  8827. choice is available from the Help menu of the Statistics diagram. 
  8828.  
  8829. Related Information 
  8830.  
  8831.      Call Nesting Diagram 
  8832.      Dynamic Call Graph 
  8833.      Execution Density Diagram 
  8834.      Statistics Diagram 
  8835.      Time Line Diagram 
  8836.      Hints and Tips 
  8837.      Keys Help. 
  8838.  
  8839.  
  8840. ΓòÉΓòÉΓòÉ 19.7.5. Product Information ΓòÉΓòÉΓòÉ
  8841.  
  8842. Select the Product information choice to display copyright and version 
  8843. information about the Performance Analyzer application. This choice is 
  8844. available from the Help menu of the Statistics diagram. 
  8845.  
  8846. Related Information 
  8847.  
  8848.      Call Nesting Diagram 
  8849.      Dynamic Call Graph 
  8850.      Execution Density Diagram 
  8851.      Statistics Diagram 
  8852.      Time Line Diagram 
  8853.      Hints and Tips 
  8854.      Keys Help. 
  8855.  
  8856.  
  8857. ΓòÉΓòÉΓòÉ 20. Time Line Diagram ΓòÉΓòÉΓòÉ
  8858.  
  8859. Time Line Diagram 
  8860.  
  8861. The Time Line diagram displays the sequence of nested function calls and 
  8862. returns. Time stamps determine the exact placement of an event along the time 
  8863. dimension on the vertical axis. This provides a direct and natural presentation 
  8864. of the chronological relationships of events. 
  8865.  
  8866. The Time Line diagram is similar to the Call Nesting diagram, but the distance 
  8867. between successive events in the diagram are drawn in proportion to the actual 
  8868. time between the events as recorded in the trace file. 
  8869.  
  8870. The names of functions are only drawn when the time spent in that function is 
  8871. large enough to allow the name to be drawn. This value is dependent upon the 
  8872. size of the font being used. For example, with the default font, the distance 
  8873. between the call to the function and the next event must be at least twenty 
  8874. scan lines. This is done to ensure that the function name will not be 
  8875. overwritten by another function name or overdrawn by a line representing a 
  8876. function call or thread switch. 
  8877.  
  8878. You can use this diagram to find where a deadlock occurred. Access violations, 
  8879. system exceptions and other such program errors are recorded in the trace file 
  8880. as user events, as are any messages generated in the code by calls to the 
  8881. Performance Analyzer. These events are indicated by a black diamond in the 
  8882. diagram, and if there is sufficient space, the text associated will be drawn to 
  8883. the right of the events. 
  8884.  
  8885. Areas of the Time Line Window 
  8886.  
  8887. The following topics describe the areas of the Time Line diagram: 
  8888.  
  8889.      Menu Bar Summary 
  8890.  
  8891.       The following choices are available from the Time Line diagram menu bar: 
  8892.         -  Trace File 
  8893.         -  Edit 
  8894.         -  View 
  8895.         -  Options 
  8896.         -  Project 
  8897.         -  Help. 
  8898.      Status Area 
  8899.  
  8900.       The Status Area provides information about the following: 
  8901.         -  Trace Description 
  8902.         -  Time Slice 
  8903.         -  Selected Region 
  8904.      Vertical Ruler 
  8905.      Time Line Pop-up Menus 
  8906.         -  Time Line Diagram Pop-up Menu. 
  8907.         -  Time Line Selected Item Pop-up Menu. 
  8908.  
  8909.  Related Information 
  8910.  
  8911.      Call Nesting Diagram 
  8912.      Dynamic Call Graph 
  8913.      Execution Density Diagram 
  8914.      Statistics Diagram 
  8915.      Time Line Diagram. 
  8916.      Hints and Tips 
  8917.      Keys Help. 
  8918.  
  8919.  
  8920. ΓòÉΓòÉΓòÉ 20.1. Time Line Trace File Menu ΓòÉΓòÉΓòÉ
  8921.  
  8922. The following choices are available from the Trace file menu : 
  8923.  
  8924.  Open as 
  8925.            Shows a new or an additional diagram. 
  8926.  
  8927.  Printer settings... 
  8928.            Allows you to choose printer settings for your output. 
  8929.  
  8930.  Print selected region... 
  8931.            Prints a selected area of the diagram. 
  8932.  
  8933.  Window Manager 
  8934.            Displays the Window Manager. 
  8935.  
  8936.  Exit Performance Analyzer 
  8937.            Exits the Performance Analyzer. 
  8938.  
  8939.  Related Information 
  8940.  
  8941.      Call Nesting Diagram 
  8942.      Dynamic Call Graph 
  8943.      Execution Density Diagram 
  8944.      Statistics Diagram 
  8945.      Keys Help. 
  8946.  
  8947.  
  8948. ΓòÉΓòÉΓòÉ 20.1.1. Open As Cascading Choice ΓòÉΓòÉΓòÉ
  8949.  
  8950. Select the Open as choice to view another diagram. You can open as many new 
  8951. diagram windows as you want. 
  8952.  
  8953. To select a new diagram: 
  8954.  
  8955.    1. Select Open as from the Trace file menu. A cascaded menu is displayed 
  8956.       with the following choices: 
  8957.  
  8958.            Call Nesting 
  8959.            Dynamic Call Graph 
  8960.            Execution Density 
  8961.            Statistics 
  8962.            Time Line 
  8963.  
  8964.    2. Select the name of the diagram you want to view. A new window opens and 
  8965.       displays the diagram you selected. 
  8966.  
  8967.  Related Information 
  8968.  
  8969.      Selecting a Trace File to Analyze 
  8970.      Keys Help. 
  8971.  
  8972.  
  8973. ΓòÉΓòÉΓòÉ 20.1.1.1. Call Nesting Choice ΓòÉΓòÉΓòÉ
  8974.  
  8975. The Call Nesting choice is available from the Open as cascaded menu. When you 
  8976. select Call Nesting, the Call Nesting Diagram displays. 
  8977.  
  8978. Related Information 
  8979.  
  8980.      Open As Choice 
  8981.      Keys Help. 
  8982.  
  8983.  
  8984. ΓòÉΓòÉΓòÉ 20.1.1.2. Dynamic Call Graph Choice ΓòÉΓòÉΓòÉ
  8985.  
  8986. The Dynamic Call Graph choice is available from the Open as cascaded menu. When 
  8987. you select Dynamic Call Graph, the Dynamic Call Graph displays. 
  8988.  
  8989. Related Information 
  8990.  
  8991.      Open As Choice 
  8992.      Keys Help. 
  8993.  
  8994.  
  8995. ΓòÉΓòÉΓòÉ 20.1.1.3. Execution Density Choice ΓòÉΓòÉΓòÉ
  8996.  
  8997. The Execution Density choice is available from the Open as cascaded menu. When 
  8998. you select Execution Density, the Execution Density Diagram diagram displays. 
  8999.  
  9000. Related Information 
  9001.  
  9002.      Open As Choice 
  9003.      Keys Help. 
  9004.  
  9005.  
  9006. ΓòÉΓòÉΓòÉ 20.1.1.4. Statistics Choice ΓòÉΓòÉΓòÉ
  9007.  
  9008. The Statistics choice is available from the Open as cascaded menu. When you 
  9009. select Statistics, the Statistics Diagram  displays. 
  9010.  
  9011. Related Information 
  9012.  
  9013.      Open As Choice 
  9014.      Keys Help. 
  9015.  
  9016.  
  9017. ΓòÉΓòÉΓòÉ 20.1.1.5. Time Line Choice ΓòÉΓòÉΓòÉ
  9018.  
  9019. The Time Line choice is available from the Open as cascaded menu. When you 
  9020. select Time Line, the Time Line  diagram displays. 
  9021.  
  9022. Related Information 
  9023.  
  9024.      Open As Choice 
  9025.      Keys Help. 
  9026.  
  9027.  
  9028. ΓòÉΓòÉΓòÉ 20.1.2. Printer Settings... Choice ΓòÉΓòÉΓòÉ
  9029.  
  9030. Select the Printer settings... choice to select settings for your print jobs. 
  9031.  
  9032. When you select the Printer settings... choice, the Printer Settings window 
  9033. appears. 
  9034.  
  9035.      OK 
  9036.      Font 
  9037.      Job 
  9038.      Cancel 
  9039.      Help 
  9040.  
  9041.  Related Information 
  9042.  
  9043.      Keys Help. 
  9044.  
  9045.  
  9046. ΓòÉΓòÉΓòÉ 20.1.3. Print Selected Region... Choice ΓòÉΓòÉΓòÉ
  9047.  
  9048. Select the Print selected region... choice to print a selected area of the Time 
  9049. Line diagram. 
  9050.  
  9051. To print an area of the Time Line diagram, highlight the area and then select 
  9052. this choice from the Trace file menu. The Print Selected Region window appears. 
  9053.  
  9054. Related Information 
  9055.  
  9056.      Keys Help. 
  9057.  
  9058.  
  9059. ΓòÉΓòÉΓòÉ 20.1.4. Window Manager Choice ΓòÉΓòÉΓòÉ
  9060.  
  9061. Select the Window manager choice to display the Window Manager window. 
  9062.  
  9063. Related Information 
  9064.  
  9065.      Performance Analyzer - Window Manager 
  9066.      Keys Help. 
  9067.  
  9068.  
  9069. ΓòÉΓòÉΓòÉ 20.1.5. Exit Performance Analyzer Choice ΓòÉΓòÉΓòÉ
  9070.  
  9071. Select Exit Performance Analyzer to exit the Performance Analyzer and close all 
  9072. associated windows. 
  9073.  
  9074. Related Information 
  9075.  
  9076.      Keys Help. 
  9077.  
  9078.  
  9079. ΓòÉΓòÉΓòÉ 20.2. Time Line Edit Menu ΓòÉΓòÉΓòÉ
  9080.  
  9081. The Edit menu allows you to locate and change text in the Time Line diagram. 
  9082.  
  9083. Items you can select from this menu include the following: 
  9084.  
  9085.  Find function 
  9086.            Search for a function call or return. 
  9087.  
  9088.  Find Next 
  9089.            Find the next occurrence of the last item you searched for. 
  9090.  
  9091.  Select time 
  9092.            Go to a specific time in the diagram. 
  9093.  
  9094.  Select time range 
  9095.            Select a specified time in the diagram. 
  9096.  
  9097.  Select all 
  9098.            Select the entire Time Line diagram. 
  9099.  
  9100.  Related Information 
  9101.  
  9102.      Call Nesting Diagram 
  9103.      Dynamic Call Graph 
  9104.      Execution Density Diagram 
  9105.      Statistics Diagram 
  9106.      Keys Help. 
  9107.  
  9108.  
  9109. ΓòÉΓòÉΓòÉ 20.2.1. Find Function... Choice ΓòÉΓòÉΓòÉ
  9110.  
  9111. Select the Find function... choice to search for a function call or return. 
  9112.  
  9113. When you select the Find function... choice, the Find Function window appears. 
  9114.  
  9115. Related Information 
  9116.  
  9117.      Find Next Choice 
  9118.      Time Line Diagram Pop-up Menu 
  9119.      Keys Help. 
  9120.  
  9121.  
  9122. ΓòÉΓòÉΓòÉ <hidden> Find Function Window ΓòÉΓòÉΓòÉ
  9123.  
  9124. Use the Find function  window to search for a specific function in the diagram. 
  9125. You can choose to search when the function was called or returned. 
  9126.  
  9127. Searching for Calls or Returns 
  9128.  
  9129. To search for a function call or return: 
  9130.  
  9131.    1. Do any of the following for the Find string entry field: 
  9132.  
  9133.           Leave the entry field blank and press enter to display a list of all 
  9134.            functions in the list box 
  9135.           Enter the file name of the function that you want to display in the 
  9136.            list box 
  9137.           Enter the first few characters of the function file name that you 
  9138.            want to display in the list box 
  9139.           Enter an asterisk (*) and part or all of the function file name that 
  9140.            you want to display in the list box. 
  9141.  
  9142.            Note:  This is useful when you are searching for a C++ de-mangled 
  9143.            function that has class information in front of the function name. 
  9144.  
  9145.       Click on the Case sensitive check box to enable case sensitive searching. 
  9146.  
  9147.    2. Select a function from the list box. 
  9148.  
  9149.       For Call Nesting, Execution Density and Time Line Diagrams: 
  9150.  
  9151.           Choose to search for when the function was called or returned. 
  9152.  
  9153.           Select the Call  radio button to find when a function was called. 
  9154.  
  9155.            OR 
  9156.           Select the Return  radio button to find when a function returned. 
  9157.  
  9158.    3. Select the appropriate push button to continue: 
  9159.  
  9160.           OK 
  9161.           Cancel 
  9162.           Help 
  9163.  
  9164.       Note:  The function is highlighted when found. 
  9165.  
  9166.  Related Information 
  9167.  
  9168.      Find Next Choice 
  9169.      Keys Help. 
  9170.  
  9171.  
  9172. ΓòÉΓòÉΓòÉ 20.2.2. Find Next Choice ΓòÉΓòÉΓòÉ
  9173.  
  9174. Select the Find Next choice to locate the next instance of the searched text. 
  9175.  
  9176. To find the next occurrence, select Find next from the Edit menu. The string is 
  9177. highlighted when found. A message box appears if the string cannot be found. 
  9178.  
  9179. Related Information 
  9180.  
  9181.      Find Window 
  9182.      Time Line Diagram Pop-up Menu 
  9183.      Keys Help. 
  9184.  
  9185.  
  9186. ΓòÉΓòÉΓòÉ 20.2.3. Select Time... Choice ΓòÉΓòÉΓòÉ
  9187.  
  9188. Select the Select time... choice to go to a specific time in the diagram. When 
  9189. you select the Select time... choice, the Select Time window appears. 
  9190.  
  9191. Related Information 
  9192.  
  9193.      Select Time Range Window 
  9194.      Keys Help. 
  9195.  
  9196.  
  9197. ΓòÉΓòÉΓòÉ 20.2.3.1. Select Time Window ΓòÉΓòÉΓòÉ
  9198.  
  9199. Use the Select Time  window to go to a specific time in the diagram. 
  9200.  
  9201. Going to a Specific Time 
  9202.  
  9203. To select the time: 
  9204.  
  9205.    1. Select the appropriate radio button: 
  9206.  
  9207.           seconds (s) 
  9208.           milliseconds (ms) 
  9209.           microseconds (us) 
  9210.  
  9211.    2. Use the spin buttons to select the time you want to display. 
  9212.  
  9213.    3. Select the appropriate push button to continue: 
  9214.  
  9215.           OK 
  9216.           Cancel 
  9217.           Help. 
  9218.  
  9219.  Related Information 
  9220.  
  9221.      Select Time Range Window 
  9222.      Call Nesting Diagram 
  9223.      Execution Density Diagram 
  9224.      Time Line Diagram. 
  9225.      Keys Help. 
  9226.  
  9227.  
  9228. ΓòÉΓòÉΓòÉ 20.2.4. Select Time Range... Choice ΓòÉΓòÉΓòÉ
  9229.  
  9230. Select the Select time range... choice to choose a specific period of time to 
  9231. view. When you select the Select time range... choice, the Select Time Range 
  9232. window appears. 
  9233.  
  9234. Related Information 
  9235.  
  9236.      Select Time Window 
  9237.      Keys Help. 
  9238.  
  9239.  
  9240. ΓòÉΓòÉΓòÉ <hidden> Select Time Range Window ΓòÉΓòÉΓòÉ
  9241.  
  9242. Use the Select Time Range window to view a specific period of time. 
  9243.  
  9244. Selecting Time Periods 
  9245.  
  9246. To select the time period: 
  9247.  
  9248.    1. In the Start time list box, use the spin buttons to select the start time 
  9249.       you want to highlight. 
  9250.  
  9251.    2. To select the time, select the appropriate radio button: 
  9252.  
  9253.           seconds (s), 
  9254.           milliseconds (ms), 
  9255.           microseconds (us). 
  9256.  
  9257.    3. In the End time list box, use the spin buttons to select the end time, 
  9258.       where the highlight will stop. 
  9259.  
  9260.    4. To select the time, select the appropriate radio button: 
  9261.  
  9262.           seconds (s), 
  9263.           milliseconds (ms), 
  9264.           microseconds (us). 
  9265.  
  9266.    5. Select the appropriate push button to continue: 
  9267.  
  9268.           OK 
  9269.           Cancel 
  9270.           Help. 
  9271.  
  9272.  Related Information 
  9273.  
  9274.      Select Time Window 
  9275.      Call Nesting Diagram 
  9276.      Execution Density Diagram 
  9277.      Time Line Diagram 
  9278.      Analyze Trace Window 
  9279.      Keys Help. 
  9280.  
  9281.  
  9282. ΓòÉΓòÉΓòÉ 20.2.5. Select All Choice ΓòÉΓòÉΓòÉ
  9283.  
  9284. Select the Select all choice to highlight the entire diagram. To remove the 
  9285. highlighting, select a specific function. 
  9286.  
  9287. Related Information 
  9288.  
  9289.      Select Time Window 
  9290.      Select Time Range Window 
  9291.      Keys Help. 
  9292.  
  9293.  
  9294. ΓòÉΓòÉΓòÉ 20.3. Time Line View Menu ΓòÉΓòÉΓòÉ
  9295.  
  9296. The choices available from the View menu are: 
  9297.  
  9298.  Zoom in 
  9299.            Magnifies a region of interest in the diagram. 
  9300.  
  9301.  Zoom out 
  9302.            Reduces the diagram to starting size. 
  9303.  
  9304.  Zoom to selected range 
  9305.            Magnify the diagram to focus on the highlighted area. 
  9306.  
  9307.  Scale pages 
  9308.            Selects the size of the diagram. 
  9309.  
  9310.  Related Information 
  9311.  
  9312.      Call Nesting Diagram 
  9313.      Dynamic Call Graph 
  9314.      Execution Density Diagram 
  9315.      Statistics Diagram 
  9316.      Keys Help. 
  9317.  
  9318.  
  9319. ΓòÉΓòÉΓòÉ 20.3.1. Zoom In Choice ΓòÉΓòÉΓòÉ
  9320.  
  9321. Select the Zoom In choice to magnify the Time Line  diagram. 
  9322.  
  9323. Selecting the Zoom In choice will magnify the Time Line diagram by  a factor of 
  9324. 5. The point in the trace file at the top of the current page will remain 
  9325. fixed, resulting in the view changing to show the top one fifth of the 
  9326. previously displayed page. 
  9327.  
  9328. If the diagram is already scaled to its maximum, this choice will be disabled. 
  9329. If the diagram is scaled within a factor of 5 of the maximum magnification, 
  9330. this choice will bring the diagram to its full magnification. 
  9331.  
  9332. The Zoom In choice is offered in both the View menu and the Time Line Diagram 
  9333. Pop-up Menu Also, holding the Ctrl key and pressing the + key will perform the 
  9334. same function. 
  9335.  
  9336. Related Information 
  9337.  
  9338.      Zoom Out Choice 
  9339.      Zoom to Selected Range Choice 
  9340.      Time Line Selected Item Pop-up Menu 
  9341.      Keys Help. 
  9342.  
  9343.  
  9344. ΓòÉΓòÉΓòÉ 20.3.2. Zoom Out Choice ΓòÉΓòÉΓòÉ
  9345.  
  9346. Select the Zoom Out choice to reduce the magnification of the Time Line 
  9347. diagram. 
  9348.  
  9349. Selecting the Zoom Out choice will decrease the magnification of the Execution 
  9350. Density diagram by a factor of 5.  The point in the trace file at the top of 
  9351. the current page will remain fixed, resulting in the view changing to display 
  9352. the previously displayed page in the top one fifth of the new view.  If 
  9353. necessary, the diagram will adjust to ensure that time past the end of the 
  9354. trace file is not displayed. 
  9355.  
  9356. If the diagram is already scaled to its minimum magnification, this choice will 
  9357. be disabled.  If the diagram is scaled within a factor of 5 of the minimum 
  9358. magnification, this choice will bring the diagram to a full 100 % view. 
  9359.  
  9360. The Zoom Out choice is offered in both the View menu and the Time Line Diagram 
  9361. Pop-up Menu Also, holding the Ctrl key and pressing the - key will perform the 
  9362. same function. 
  9363.  
  9364. Related Information 
  9365.  
  9366.      Zoom In Choice 
  9367.      Zoom to Selected Range Choice 
  9368.      Time Line Diagram Pop-up Menu 
  9369.      Keys Help. 
  9370.  
  9371.  
  9372. ΓòÉΓòÉΓòÉ 20.3.3. Zoom to Selected Range Choice ΓòÉΓòÉΓòÉ
  9373.  
  9374. Select the Zoom to selected range to magnify an area of interest in the Time 
  9375. Line diagram. 
  9376.  
  9377. To magnify a region of interest, highlight the region using the mouse or the 
  9378. Select time range... choice and select Zoom to selected range from the View 
  9379. menu. The scale of the diagram will be expanded so that the highlighted area 
  9380. fills the entire display. 
  9381.  
  9382. Note:  When the magnification is at its maximum, the choice will be disabled. 
  9383. Also, if it is impossible to magnify the diagram to the degree required to 
  9384. stretch the highlighted region across the entire diagram, the highest possible 
  9385. magnification will be used. 
  9386.  
  9387. Shortcut Method 
  9388.  
  9389. After highlighting the area of interest, use mouse button two to click on the 
  9390. highlighted area.  From the displayed Time Line Selected Item Pop-up Menu, 
  9391. choose Zoom to selected region. 
  9392.  
  9393. Related Information 
  9394.  
  9395.      Zoom In Choice 
  9396.      Zoom Out Choice 
  9397.      Time Line Selected Item Pop-up Menu 
  9398.      Keys Help. 
  9399.  
  9400.  
  9401. ΓòÉΓòÉΓòÉ 20.3.4. Scale Pages... Choice ΓòÉΓòÉΓòÉ
  9402.  
  9403. Use the Scale pages... choice to select the size of the diagram and to control 
  9404. which functions are displayed in the diagram. Scaling is the process of 
  9405. changing the granularity of the detail in a  trace diagram: to step back from a 
  9406. diagram to get a bigger picture or to zoom in to see the finer points. 
  9407.  
  9408. When you select the Scale pages... choice, a Scale Pages window appears. 
  9409.  
  9410. Related Information 
  9411.  
  9412.      Time Line Diagram Pop-up Menu 
  9413.      Restore Initial Defaults Choice 
  9414.      Keys Help. 
  9415.  
  9416.  
  9417. ΓòÉΓòÉΓòÉ 20.4. Time Line Options Menu ΓòÉΓòÉΓòÉ
  9418.  
  9419. The Options menu allows you to customize the Time Line diagram and display 
  9420. additional information. 
  9421.  
  9422. The following choices are available from the Options menu: 
  9423.  
  9424.  Call Stack 
  9425.            Shows all functions on the call stack at a selected point. 
  9426.  
  9427.  Correlation 
  9428.            Synchronizes other diagrams to display the same highlighted region. 
  9429.  
  9430.  Font 
  9431.            Selects the font, font style, and font size for the diagram. 
  9432.  
  9433.  Thread layout 
  9434.            Selects the indentation amount for each thread column and whether to 
  9435.            draw separator bars between threads. 
  9436.  
  9437.  Status area 
  9438.            Controls the gray area at the top of the window. 
  9439.  
  9440.  Tool bar 
  9441.            Use the Tool bar for a shortcut to other menus. 
  9442.  
  9443.  Settings 
  9444.            Saves the current settings or restores the defaults. 
  9445.  
  9446.  Related Information 
  9447.  
  9448.      Call Nesting Diagram 
  9449.      Dynamic Call Graph 
  9450.      Execution Density Diagram 
  9451.      Statistics Diagram 
  9452.      Time Line Diagram Pop-up Menu 
  9453.      Time Line Selected Item Pop-up Menu 
  9454.      Keys Help. 
  9455.  
  9456.  
  9457. ΓòÉΓòÉΓòÉ 20.4.1. Call Stack... Choice ΓòÉΓòÉΓòÉ
  9458.  
  9459. Select the Call Stack... choice to display the order in which the functions 
  9460. were called at a selected point. 
  9461.  
  9462. When you select the Call Stack... choice, the Call Stack window appears. 
  9463.  
  9464. Related Information 
  9465.  
  9466.      Time Line Selected Item Pop-up Menu 
  9467.      Restore Initial Defaults Choice 
  9468.      Keys Help. 
  9469.  
  9470.  
  9471. ΓòÉΓòÉΓòÉ <hidden> Call Stack Window ΓòÉΓòÉΓòÉ
  9472.  
  9473. Select the Call Stack  window to display the order in which the functions were 
  9474. called at a selected point. 
  9475.  
  9476. Displaying the Call Stack 
  9477.  
  9478. To display a call stack for a function: 
  9479.  
  9480.    1. Click on a function to select it. 
  9481.  
  9482.    2. Select Call Stack  from the Options menu. A Call  Stack window appears 
  9483.       the function you selected and its parents (called functions) in the order 
  9484.       in which they were called. 
  9485.  
  9486.    3. Select the appropriate push button to continue: 
  9487.  
  9488.           OK 
  9489.           Help. 
  9490.  
  9491.  Related Information 
  9492.  
  9493.      Call Nesting Diagram 
  9494.      Time Line Diagram. 
  9495.      Keys Help. 
  9496.  
  9497.  
  9498. ΓòÉΓòÉΓòÉ 20.4.2. Correlation... Choice ΓòÉΓòÉΓòÉ
  9499.  
  9500. Select the Correlation... choice to mark a point in the Call Nesting diagram, 
  9501. Execution Density diagram, or Time Line diagram and then find that same point 
  9502. in another Call Nesting diagram, Execution Density diagram, or Time Line 
  9503. diagram. You can correlate more than two diagrams at a time. 
  9504.  
  9505. When you select the Correlate... choice, the Correlation window appears. 
  9506.  
  9507. Related Information 
  9508.  
  9509.      Time Line Selected Item Pop-up Menu 
  9510.      Keys Help. 
  9511.  
  9512.  
  9513. ΓòÉΓòÉΓòÉ 20.4.3. Font... Choice ΓòÉΓòÉΓòÉ
  9514.  
  9515. Select the Font... choice to change the font, font style, and font size for the 
  9516. text area of the Time Line window. This choice is available from the Options 
  9517. menu of the Time Line window. When you select this choice, the Font window 
  9518. appears. 
  9519.  
  9520. The Font window has the following areas: 
  9521.  
  9522.  Name entry field      Type a font name in this entry field or click on the 
  9523.                        scroll bar on the right side of the entry field to see a 
  9524.                        list of choices and select a name from the list. 
  9525.  Size entry field      Type a font size in this entry field or click on the 
  9526.                        scroll bar on the right side of the entry field to see a 
  9527.                        list of choices and select a size from the list. 
  9528.  Style entry field     Type a font style in this entry field or click on the 
  9529.                        scroll bar on the right side of the entry field to see a 
  9530.                        list of choices and select a style from the list. 
  9531.  Emphasis check boxes  Click on one of these check boxes to outline, 
  9532.                        underscore, or strikeout text. 
  9533.  Sample box            This box shows a sample of how text will appear with the 
  9534.                        settings you have selected. 
  9535.  Ok push button        Changes the font according to the settings you selected. 
  9536.  Reset push button     Changes all font settings to the default settings. 
  9537.  Cancel push button    Closes the window without making changes. 
  9538.  
  9539.  Related Information 
  9540.  
  9541.      Time Line Diagram Pop-up Menu 
  9542.      Keys Help. 
  9543.  
  9544.  
  9545. ΓòÉΓòÉΓòÉ 20.4.4. Thread Layout... Choice ΓòÉΓòÉΓòÉ
  9546.  
  9547. Select the Thread layout...  choice to control thread indentation and to 
  9548. control drawing of thread separator bars between the threads. A Thread Layout 
  9549. window appears. 
  9550.  
  9551. Related Information 
  9552.  
  9553.      Time Line Diagram Pop-up Menu 
  9554.      Keys Help. 
  9555.  
  9556.  
  9557. ΓòÉΓòÉΓòÉ <hidden> Thread Layout Window ΓòÉΓòÉΓòÉ
  9558.  
  9559. Use the Thread Layout  window to control the thread indentation and to control 
  9560. whether separator bars are drawn between the threads. 
  9561.  
  9562. Controlling Indentation and Separator Bars 
  9563.  
  9564. To use the Thread Layout  window: 
  9565.  
  9566.    1. Select the spin buttons in the Indents per thread entry field until the 
  9567.       value you want displays. The maximum indentation value is 20 pixels. 
  9568.  
  9569.    2. Select the check box to draw separator lines between the threads. A check 
  9570.       mark symbol in the box indicates to draw separator bars and an empty box 
  9571.       indicates not to draw the separator bars. 
  9572.  
  9573.    3. Select the appropriate push button to continue: 
  9574.  
  9575.           Set 
  9576.           Apply 
  9577.           Cancel 
  9578.           Help. 
  9579.  
  9580.  Related Information 
  9581.  
  9582.      Call Nesting Diagram 
  9583.      Time Line Diagram 
  9584.      Keys Help. 
  9585.  
  9586.  
  9587. ΓòÉΓòÉΓòÉ 20.4.5. Status Area... Choice ΓòÉΓòÉΓòÉ
  9588.  
  9589. Select the Status area... choice to control the area at the top of the window. 
  9590. When you select the Status area... choice, the Status Area window appears. 
  9591.  
  9592. Related Information 
  9593.  
  9594.      Keys Help. 
  9595.  
  9596.  
  9597. ΓòÉΓòÉΓòÉ 20.4.5.1. Status Area Window ΓòÉΓòÉΓòÉ
  9598.  
  9599. Use the Status Area  window to control the area at the top of the window. 
  9600.  
  9601. The check boxes represent the choices in the Status Area that you can show or 
  9602. hide. When you disable the check box the choice is hidden. Likewise, when you 
  9603. enable the check box the choice displays in the Status Area. 
  9604.  
  9605. In each diagram the Status Area displays different information. When you select 
  9606. the Status Area  window, the choices in the window change based upon the Status 
  9607. Area of the diagram. 
  9608.  
  9609. Choices from the Status Area include: 
  9610.  
  9611.      Trace Description 
  9612.      Time Slice 
  9613.      Selected Region 
  9614.  
  9615.  Select the appropriate check box to continue. 
  9616.  
  9617.  Related Information 
  9618.  
  9619.      Call Nesting Status Area Window 
  9620.      Execution Density Status Area Window 
  9621.      Dynamic Call Graph Status Area Window 
  9622.      Keys Help. 
  9623.  
  9624.  
  9625. ΓòÉΓòÉΓòÉ 20.4.6. Tool Bar Cascading Choice ΓòÉΓòÉΓòÉ
  9626.  
  9627. Select the Tool bar cascading choice to have the Tool bar display or not 
  9628. display in your window, and to enable and disable the Hover help. 
  9629.  
  9630. The choices from the Tool bar cascaded menu are: 
  9631.  
  9632.  Show                     Choose to either show or hide the Tool bar. 
  9633.  Hover                    Choose to either enable or disable displaying the 
  9634.                           help text when the mouse pointer hovers over the Tool 
  9635.                           bar buttons. 
  9636.  
  9637.  Related Information 
  9638.  
  9639.      Keys Help. 
  9640.  
  9641.  
  9642. ΓòÉΓòÉΓòÉ 20.4.7. Settings Cascading Choice ΓòÉΓòÉΓòÉ
  9643.  
  9644. The choices from the Settings cascaded menu allow you to save current settings 
  9645. or switch to the original settings. 
  9646.  
  9647.  Save 
  9648.            Save the current session settings. 
  9649.  
  9650.  Restore Initial Defaults Choice 
  9651.            Restore the original settings. 
  9652.  
  9653.  Related Information 
  9654.  
  9655.      Save Choice 
  9656.      Restore Initial Defaults Choice 
  9657.      Keys Help. 
  9658.  
  9659.  
  9660. ΓòÉΓòÉΓòÉ 20.4.7.1. Save Choice ΓòÉΓòÉΓòÉ
  9661.  
  9662. Select the Save choice to save the current settings. These settings are stored 
  9663. in the ICSPERF.INI file and remain active until that file is erased. 
  9664.  
  9665. To restore the default settings, select the Restore initial defaults choice. 
  9666.  
  9667. Related Information 
  9668.  
  9669.      Restore Initial Defaults Choice 
  9670.      Keys Help. 
  9671.  
  9672.  
  9673. ΓòÉΓòÉΓòÉ 20.4.7.2. Restore Initial Defaults Choice ΓòÉΓòÉΓòÉ
  9674.  
  9675. Select the Restore initial defaults choice to change to the original or default 
  9676. settings. You can select the Save choice to save settings. 
  9677.  
  9678. Related Information 
  9679.  
  9680.      Save Choice 
  9681.      Keys Help. 
  9682.  
  9683.  
  9684. ΓòÉΓòÉΓòÉ 20.5. Time Line Project Menu ΓòÉΓòÉΓòÉ
  9685.  
  9686. This menu appears when you start the Performance Analyzer from within the 
  9687. WorkFrame environment. The Project menu gives you direct access to all of the 
  9688. actions that you can perform from your current location. 
  9689.  
  9690. When you select the Edit function choice from this menu, the source code for 
  9691. the selected function is displayed in the default editor for WorkFrame's edit 
  9692. action. 
  9693.  
  9694. Related Information 
  9695.  
  9696.      Search Paths Window 
  9697.      Trace Generation Window 
  9698.      Keys Help 
  9699.  
  9700.  
  9701. ΓòÉΓòÉΓòÉ 20.5.1. Edit Function Choice ΓòÉΓòÉΓòÉ
  9702.  
  9703. Select the Edit function choice to edit a source file in WorkFrame's default 
  9704. editor. This choice lets you edit the source for a function selected on the 
  9705. Time Line diagram. When you are working in the WorkFrame environment, this 
  9706. choice is available from the Project menu on the Time Line diagram. It is also 
  9707. available from the Selected Item pop-up menu on the Time Line diagram. 
  9708.  
  9709. To locate a source file for editing, the Performance Analyzer must first locate 
  9710. the executable containing the name of the source file. The Performance Analyzer 
  9711. searches the following paths (in the order listed) to locate an executable: 
  9712.  
  9713.    1. Path specified in the Locate Executable window 
  9714.    2. Path specified in the Search path for executable files: entry field of 
  9715.       the Search Paths window 
  9716.    3. Directory where the executable was located when the trace file was 
  9717.       created 
  9718.    4. The current working directory 
  9719.    5. Path specified by the PATH environment variable. 
  9720.  
  9721.  To identify the name of the source file, the Performance Analyzer looks at the 
  9722.  debug information in the executable. The Performance Analyzer then searches 
  9723.  the following paths (in the order listed) to locate the source file: 
  9724.  
  9725.    1. Path specified in the Locate Source File window 
  9726.    2. Path specified in the Search path for source files: entry field of the 
  9727.       Search Paths window 
  9728.    3. Path specified in the compile statement (if provided) 
  9729.    4. Directory where the executable was located when the trace file was 
  9730.       created 
  9731.    5. The current working directory 
  9732.    6. Path specified by the INCLUDE environment variable. 
  9733.  
  9734.  If, after searching these paths, the Performance Analyzer cannot find the: 
  9735.  
  9736.    1. Executable, it displays the Locate Executable window to let you enter the 
  9737.       path where the executable resides. 
  9738.    2. Source file, it displays the Locate Source File window to let you enter 
  9739.       the path where the source file resides. 
  9740.  
  9741.  Once the source file for a function is located, the file is opened to the 
  9742.  first line of the function's code. 
  9743.  
  9744.  Notes 
  9745.  
  9746.    1. The Performance Analyzer remembers the paths you enter in the Locate 
  9747.       Executable and Locate Source File windows and uses them to look for files 
  9748.       the next time you select the Edit function choice. 
  9749.    2. You can specify paths that you want the Performance Analyzer to use by 
  9750.       selecting the Search Paths choice in the Options menu on the Performance 
  9751.       Analyzer - Window Manager window. The paths you enter are automatically 
  9752.       saved for the current session. If you want to save the paths for 
  9753.       subsequent sessions, select the Options menu and then select the Save 
  9754.       choice from the Settings cascaded menu. 
  9755.  
  9756.  Related Information 
  9757.  
  9758.      Locate Executable Window 
  9759.      Locate Source File Window 
  9760.      Search Paths Window 
  9761.      Starting the Performance Analyzer from WorkFrame 
  9762.      Keys Help. 
  9763.  
  9764.  
  9765. ΓòÉΓòÉΓòÉ 20.6. Time Line Help Menu ΓòÉΓòÉΓòÉ
  9766.  
  9767. The Help menu has the following choices: 
  9768.  
  9769.  Help index          Displays an index of Help topics. 
  9770.  General help        Displays Help for the active window. 
  9771.  Using help          Describes how to use Help. 
  9772.  How do I?           Displays task Help. 
  9773.  Product information Displays information about the Performance Analyzer. 
  9774.  
  9775.  Related Information 
  9776.  
  9777.      Call Nesting Diagram 
  9778.      Dynamic Call Graph 
  9779.      Execution Density Diagram 
  9780.      Statistics Diagram 
  9781.      Time Line Diagram 
  9782.      Hints and Tips 
  9783.      Keys Help. 
  9784.  
  9785.  
  9786. ΓòÉΓòÉΓòÉ 20.6.1. Help Index Choice ΓòÉΓòÉΓòÉ
  9787.  
  9788. Select the Help index choice to display an alphabetical index of Performance 
  9789. Analyzer Help topics. This choice is available from the Help menu of the Time 
  9790. Line diagram. 
  9791.  
  9792. Use the Previous push button to return to the last topic you viewed. Use the 
  9793. Search... push button to locate topics in the index. Use the Print... push 
  9794. button to print a topic. 
  9795.  
  9796. Related Information 
  9797.  
  9798.      Call Nesting Diagram 
  9799.      Dynamic Call Graph 
  9800.      Execution Density Diagram 
  9801.      Statistics Diagram 
  9802.      Time Line Diagram 
  9803.      Hints and Tips 
  9804.      Keys Help. 
  9805.  
  9806.  
  9807. ΓòÉΓòÉΓòÉ 20.6.2. General Help Choice ΓòÉΓòÉΓòÉ
  9808.  
  9809. Select the General help choice to display Help information for the active 
  9810. window. This choice is available from the Help menu of the Time Line diagram. 
  9811.  
  9812. The online Help panel displayed is the same panel that is displayed when you 
  9813. place your cursor inside the window and press F1. 
  9814.  
  9815. Related Information 
  9816.  
  9817.      Call Nesting Diagram 
  9818.      Dynamic Call Graph 
  9819.      Execution Density Diagram 
  9820.      Statistics Diagram 
  9821.      Time Line Diagram 
  9822.      Hints and Tips 
  9823.      Keys Help. 
  9824.  
  9825.  
  9826. ΓòÉΓòÉΓòÉ 20.6.3. Using Help Choice ΓòÉΓòÉΓòÉ
  9827.  
  9828. Select the Using help choice for a description of how to use the IBM 
  9829. Performance Analyzer Help facility. This choice is available from the Help menu 
  9830. of the Time Line diagram. 
  9831.  
  9832. Related Information 
  9833.  
  9834.      Call Nesting Diagram 
  9835.      Dynamic Call Graph 
  9836.      Execution Density Diagram 
  9837.      Statistics Diagram 
  9838.      Time Line Diagram 
  9839.      Hints and Tips 
  9840.      Keys Help. 
  9841.  
  9842.  
  9843. ΓòÉΓòÉΓòÉ 20.6.4. How Do I? Choice ΓòÉΓòÉΓòÉ
  9844.  
  9845. Select the How do I? choice to display the Performance Analyzer task help. This 
  9846. choice is available from the Help menu of the Time Line diagram. 
  9847.  
  9848. Related Information 
  9849.  
  9850.      Call Nesting Diagram 
  9851.      Dynamic Call Graph 
  9852.      Execution Density Diagram 
  9853.      Statistics Diagram 
  9854.      Time Line Diagram 
  9855.      Hints and Tips 
  9856.      Keys Help. 
  9857.  
  9858.  
  9859. ΓòÉΓòÉΓòÉ 20.6.5. Product Information ΓòÉΓòÉΓòÉ
  9860.  
  9861. Select the Product information choice to display copyright and version 
  9862. information about the Performance Analyzer application. This choice is 
  9863. available from the Help menu of the Time Line diagram. 
  9864.  
  9865. Related Information 
  9866.  
  9867.      Call Nesting Diagram 
  9868.      Dynamic Call Graph 
  9869.      Execution Density Diagram 
  9870.      Statistics Diagram 
  9871.      Time Line Diagram 
  9872.      Hints and Tips 
  9873.      Keys Help. 
  9874.  
  9875.  
  9876. ΓòÉΓòÉΓòÉ 20.7. Time Line Status Area ΓòÉΓòÉΓòÉ
  9877.  
  9878. The Status Area, located at the top of the window, describes the settings of 
  9879. the diagram. 
  9880.  
  9881. You can select the Status area choice to change the appearance of the area at 
  9882. the top of the Time Line window. 
  9883.  
  9884. When you select the Status area... choice,the Status Area window appears. 
  9885.  
  9886. The choices in the Status area window include: 
  9887.  
  9888.  Trace description 
  9889.            Shows the description given to the trace file. 
  9890.  Time slice 
  9891.            Displays the value of the time slice. 
  9892.  Selected region 
  9893.            Displays the start, end, and total time of a selected region. 
  9894.  
  9895.  Related Information 
  9896.  
  9897.      Call Nesting Status Area 
  9898.      Execution Density Status Area 
  9899.      Dynamic Call Graph Status Area 
  9900.      Execution Density Status Area 
  9901.      Keys Help. 
  9902.  
  9903.  
  9904. ΓòÉΓòÉΓòÉ 20.8. Time Line Vertical Ruler ΓòÉΓòÉΓòÉ
  9905.  
  9906. The Vertical Ruler, located to the left of the diagram window, shows scale. 
  9907.  
  9908. To change the scale, select the Scale pages... choice from the View menu, and 
  9909. the Scale Pages window appears. 
  9910.  
  9911. Related Information 
  9912.  
  9913.      Keys Help. 
  9914.  
  9915.  
  9916. ΓòÉΓòÉΓòÉ 20.9. Time Line Diagram Pop-up Menu ΓòÉΓòÉΓòÉ
  9917.  
  9918. The pop-up menus allow you to quickly access the most often used features. 
  9919. There are two pop-up menus: Diagram and Selected Item. 
  9920.  
  9921. This pop-up menu contains almost all the choices from the Edit and Options 
  9922. menus. To access this menu, use mouse button two to click on the background 
  9923. area of the diagram. The menu is displayed with the following choices: 
  9924.  
  9925.      Find function 
  9926.      Find next 
  9927.      Zoom in 
  9928.      Zoom out 
  9929.      Scale pages 
  9930.      Font 
  9931.      Thread layout 
  9932.  
  9933.  Related Information 
  9934.  
  9935.      Time Line Selected Item Pop-up Menu 
  9936.      Keys Help. 
  9937.  
  9938.  
  9939. ΓòÉΓòÉΓòÉ 20.10. Time Line Selected Item Pop-up Menu ΓòÉΓòÉΓòÉ
  9940.  
  9941. To access this pop-up menu, highlight a region of interest, move the mouse 
  9942. pointer into that area, and click on mouse button two. This menu contains the 
  9943. following choices: 
  9944.  
  9945.      Zoom to selected range 
  9946.      Call Stack 
  9947.      Correlation 
  9948.      Edit function 
  9949.  
  9950.  Related Information 
  9951.  
  9952.      Time Line Diagram Pop-up Menu 
  9953.      Keys Help. 
  9954.  
  9955.  
  9956. ΓòÉΓòÉΓòÉ 21. System Exceptions ΓòÉΓòÉΓòÉ
  9957.  
  9958. Certain system exceptions generated by your program will be logged in the trace 
  9959. file as user events. The system exceptions that are logged as user events are: 
  9960.  
  9961.      XCPT_ACCESS_VIOLATION 
  9962.      XCPT_ILLEGAL_INSTRUCTION 
  9963.      XCPT_INTEGER_DIVIDE_BY_ZERO 
  9964.      XCPT_INTEGER_OVERFLOW 
  9965.      XCPT_PRIVILEGED_INSTRUCTION 
  9966.      XCPT_FLOAT_DENORMAL_OPERAND 
  9967.      XCPT_FLOAT_DIVIDE_BY_ZERO 
  9968.      XCPT_FLOAT_INEXACT_RESULT 
  9969.      XCPT_FLOAT_INVALID_OPERATION 
  9970.      XCPT_FLOAT_OVERFLOW 
  9971.      XCPT_FLOAT_STACK_CHECK 
  9972.      XCPT_FLOAT_UNDERFLOW 
  9973.      XCPT_UNABLE_TO_GROW_STACK 
  9974.      XCPT_SIGNAL 
  9975.      XCPT_GUARD_PAGE_VIOLATION 
  9976.  
  9977.  These system exceptions appear in the Call Nesting, Time Line, and Statistics 
  9978.  diagrams. In the Call Nesting diagram, you can search for system exceptions 
  9979.  user events. 
  9980.  
  9981.  In the Call Nesting and Time Line diagrams, system exceptions appear as 
  9982.  follows: 
  9983.  
  9984.   System Exception: Guard page violation
  9985.  
  9986.  Related Information 
  9987.  
  9988.      Find User Event Window 
  9989.      Call Nesting 
  9990.      Statistics 
  9991.      Time Line diagrams. 
  9992.      Trace Generation Window 
  9993.      Keys Help. 
  9994.  
  9995.  
  9996. ΓòÉΓòÉΓòÉ 22. Hints for Using the Performance Analyzer ΓòÉΓòÉΓòÉ
  9997.  
  9998. The Performance Execution Trace Analyzer helps you understand the behavior of 
  9999. your program by collecting execution trace data and presenting it in several 
  10000. diagrams. The following hints can help you take advantage of some of the 
  10001. Performance Analyzer's features: 
  10002.  
  10003.      Hint 1: Reduce the amount of trace data the Performance Analyzer 
  10004.       collects. 
  10005.  
  10006.      Hint 2: Use Performance Analyzer features to customize your trace file. 
  10007.  
  10008.      Hint 3: Use a combination of diagrams to understand your program. 
  10009.  
  10010.      Hint 4: Use correlation to see different aspects of a point of interest. 
  10011.  
  10012.      Hint 5: Use the Dynamic Call Graph's color and size characteristics. 
  10013.  
  10014.      Hint 6: Use the Execution Density diagram to see trends. 
  10015.  
  10016.      Hint 7: Use the zoom function to see details. 
  10017.  
  10018.      Hint 8: Find patterns of calls and returns. 
  10019.  
  10020.      Hint 9: Place annotations in your trace files. 
  10021.  
  10022.      Hint 10: Use the diagrams to help you understand exception exits. 
  10023.  
  10024.  
  10025. ΓòÉΓòÉΓòÉ 22.1. Hint 1: Reduce the amount of trace data the Performance Analyzer collects. ΓòÉΓòÉΓòÉ
  10026.  
  10027. By default, the Performance Analyzer generates event information for every 
  10028. function possible. However, this sometimes causes the trace file to become very 
  10029. large. Besides using a large amount of disk space, the Performance Analyzer may 
  10030. take an unacceptable amount of time to create a diagram from the trace file 
  10031. and, once created, the diagram may be difficult to manage. 
  10032.  
  10033. The following topics describe several ways you can limit the size of your trace 
  10034. file: 
  10035.  
  10036.      Creating a Customized Trace File 
  10037.      Enabling and Disabling Components 
  10038.      Selecting the Call Depth for Each Thread 
  10039.      Using Time Stamps 
  10040.      Tracing File Accesses 
  10041.      Setting and Removing Triggers 
  10042.      Starting and Stopping the Performance Analyzer from Your Program 
  10043.      Trace On Push Button 
  10044.      Trace Off Push Button 
  10045.  
  10046.  
  10047. ΓòÉΓòÉΓòÉ 22.2. Hint 2: Use Performance Analyzer features to customize your trace file. ΓòÉΓòÉΓòÉ
  10048.  
  10049.      Add user events to your program before you trace it. User events are 
  10050.       calls to a Performance Analyzer defined function. You pass it a character 
  10051.       string, and that character string is inserted into your trace file. You 
  10052.       can view the string in the Call Nesting, Statistics, and Time Line 
  10053.       diagrams. Since the Performance Analyzer time stamps user events, they 
  10054.       appear in the Time Line diagram at the time they occurred in the 
  10055.       execution. Be sure to use static, constant character strings for your 
  10056.       user event strings. 
  10057.  
  10058.       If you add a user event to your program source file, you must also 
  10059.       include a prototype for the PERF entry point. For C and C++ programs, the 
  10060.       prototype will be inserted for you when you compile your program if you 
  10061.       place the following statement at the beginning of your source file: 
  10062.  
  10063.             #include <icsperf.h>
  10064.  
  10065.       Note: 
  10066.  
  10067.       If you want to insert the prototype yourself, the prototypes for C and 
  10068.       C++ programs are as follows: 
  10069.  
  10070.       C Prototype 
  10071.  
  10072.             VOID PERF (PSZ string);
  10073.  
  10074.       C++ Prototype 
  10075.  
  10076.             EXTERN "C" {VOID PERF(PSZ string);}
  10077.  
  10078.       Add a call to the entry point everywhere you want a user event generated. 
  10079.       A sample user event that could be placed in your program is: 
  10080.  
  10081.             PERF ("well, we actually got to this code");
  10082.  
  10083.       The Performance Analyzer time stamps the entrance and exit of each 
  10084.       function. If you want to get better time resolution for a large function 
  10085.       for example, you can divide the function into smaller functions during 
  10086.       performance measurements, or you can add user events. User events enable 
  10087.       you to subdivide large functions into higher resolution time slices. For 
  10088.       more information and examples, see Creating User Events in Your Program. 
  10089.      The CPPOPA3.OBJ file contains entry points called PerfStart and PerfStop 
  10090.       that accept calls from the program you are tracing. Calls to the 
  10091.       PerfStart and PerfStop entry points cause the Performance Analyzer to 
  10092.       start and stop tracing, respectively. 
  10093.  
  10094.       By putting these calls into your source code, you can control precisely 
  10095.       when the Performance Analyzer starts and stops gathering event during 
  10096.       program execution. For more information and examples, see Starting and 
  10097.       Stopping the Performance Analyzer from Your Program. 
  10098.      Use the Annotate... choice in the Call Nesting diagram to insert notes 
  10099.       and reminders into your trace file after it is created. You can place 
  10100.       annotations next to any event you select in the diagram. For more 
  10101.       information, see Annotate... Choice. 
  10102.      You can select the File access choice from the Options menu to trace 
  10103.       common access calls that your program makes. By determining when and 
  10104.       where file access calls occur and identifying the files they access, you 
  10105.       can better understand how your program is behaving. For more information, 
  10106.       see Tracing System Calls. 
  10107.      You can also trace APIs by linking to the Performance Analyzer's 
  10108.       traceable versions of the DOS, PM WIN, and PM GPI libraries: 
  10109.       _DOSCALL.LIB, _PMWIN.LIB, and _PMGPI.LIB, respectively. For more 
  10110.       information, see Tracing System Calls. 
  10111.  
  10112.  
  10113. ΓòÉΓòÉΓòÉ 22.3. Hint 3: Use a combination of diagrams to understand your program. ΓòÉΓòÉΓòÉ
  10114.  
  10115. Sometimes two or more diagrams can help you understand a program better. For 
  10116. instance, if you have a new program to learn, and you don't want to wade 
  10117. through code listings to determine how the code works, you can use the Dynamic 
  10118. Call Graph and the Call Nesting and Time Line diagrams to get a good 
  10119. understanding of the program's flow. 
  10120.  
  10121. The Call Nesting diagram shows the order in which functions are called and 
  10122. returned. The times for these events are displayed in the Time Line diagram. 
  10123.  
  10124. The Dynamic Call Graph shows all of the program's threads, the relative 
  10125. importance (in execution time) of the different functions, and the call 
  10126. hierarchy. 
  10127.  
  10128. For a description of each of the Performance Analyzer diagrams, see Analyzing a 
  10129. Trace File. 
  10130.  
  10131.  
  10132. ΓòÉΓòÉΓòÉ 22.4. Hint 4: Use correlation to see different aspects of a point of interest. ΓòÉΓòÉΓòÉ
  10133.  
  10134. Correlation is helpful because one diagram cannot show everything of interest 
  10135. within a trace file. Additionally, some events are easier to find in one 
  10136. diagram, but the information in another is more meaningful; therefore, you can 
  10137. locate the event in one diagram and correlate to another. 
  10138.  
  10139. For these and other instances, the Performance Analyzer provides three 
  10140. time-scaled diagrams that can be correlated: Call Nesting, Execution Density, 
  10141. and Time Line. You can correlate these diagrams based on a specific time or 
  10142. event, or on a range of time or events. 
  10143.  
  10144. For example, use the Call Nesting diagram to identify the order and names of 
  10145. functions called, and then use the Time Line diagram to find out how long a 
  10146. function took to execute. 
  10147.  
  10148. Or you can use the Execution Density diagram to see general patterns that lead 
  10149. up to a certain point, and then correlate that point to the Call Nesting 
  10150. diagram to see the exact order of the function calls. 
  10151.  
  10152. For instructions on correlating diagrams, see Correlation Window. 
  10153.  
  10154.  
  10155. ΓòÉΓòÉΓòÉ 22.5. Hint 5: Use the Dynamic Call Graph's color and size characteristics. ΓòÉΓòÉΓòÉ
  10156.  
  10157. The Dynamic Call Graph shows you information associated with calls and 
  10158. functions. In this diagram, a node represents a function and an arc, which is 
  10159. displayed between a pair of nodes, represents a call from one function to 
  10160. another. Double-click on any node to display a window that provides both the 
  10161. name of the represented function and execution information. Double-click on any 
  10162. arc to display a window that provides the caller and callee of the arc. 
  10163.  
  10164. Node and Arc Color 
  10165.  
  10166. Node color is based on the execution time spent in a function; arc color is 
  10167. based on the number of calls between pairs of functions. 
  10168.  
  10169. For nodes: white is used for functions with no execution time; gray is used for 
  10170. functions with execution times less than 1/8 of the maximum execution time; 
  10171. blue is used for functions with execution times between 1/8 and 1/4 of the 
  10172. maximum; yellow is used for functions with execution times between 1/4 and 1/2 
  10173. of the maximum; and red is used for functions with execution times greater than 
  10174. 1/2 of the maximum. 
  10175.  
  10176. For arcs: white shows that no calls were made between the functions; gray shows 
  10177. that less than 1/8 of the maximum number of calls made were made between the 
  10178. functions; blue shows that 1/8 to 1/4 of the maximum number of calls made were 
  10179. made between the functions; yellow shows that 1/4 to 1/2 of the maximum number 
  10180. of calls made were made between the functions; and red shows that at least 1/2 
  10181. of maximum number of calls made were made between the functions. 
  10182.  
  10183. Green shows that a node or an arc is selected. 
  10184.  
  10185. Node Size 
  10186.  
  10187. Node size represents both execution time and active time. The height of each 
  10188. node is determined by its execution time relative to the function that has the 
  10189. greatest execution time. The width of each node is determined by its active 
  10190. time relative to the function that has the greatest active time. Active time is 
  10191. the time spent on the call stack. If a function is waiting for a message, the 
  10192. time spent waiting is logged as active time. 
  10193.  
  10194. A node representing a main function that doesn't do much processing on its own 
  10195. would be short and wide because it spends little time executing, but remains on 
  10196. the call stack for a long time. 
  10197.  
  10198. Conversely, a node representing a function that does not call any other 
  10199. functions (a leaf node) would be at least as tall as it is wide (maybe taller) 
  10200. because it is executing whenever it is on the call stack. 
  10201.  
  10202. For more information, see Dynamic Call Graph and Arcs and Nodes. 
  10203.  
  10204.  
  10205. ΓòÉΓòÉΓòÉ 22.6. Hint 6: Use the Execution Density diagram to see trends. ΓòÉΓòÉΓòÉ
  10206.  
  10207. Trends can help you identify areas that execute well and areas that need more 
  10208. attention. 
  10209.  
  10210. The Execution Density diagram is similar to the Time Line diagram in that time 
  10211. is proportional along the vertical axis. The trace time is divided into a 
  10212. series of equal time slices. The Performance Analyzer assigns every function 
  10213. traced a vertical column in the diagram. If a particular function is executed 
  10214. during a time slice, the Performance Analyzer displays color in its column. 
  10215.  
  10216. Think of these time slices as buckets that will hold a certain capacity of 
  10217. time. The Performance Analyzer walks through the trace file filling up each 
  10218. bucket in sequence. When a bucket becomes full, the Performance Analyzer 
  10219. examines its contents and calculates the percentage of the time slice that each 
  10220. function accumulated. Then, the Performance Analyzer maps the percentages to a 
  10221. range, and from there to a color, which is displayed on your screen. (Both the 
  10222. ranges and the colors can be varied by selecting the Color choice in the 
  10223. diagram's Options menu.) The colors help you quickly identify functions that 
  10224. use the most time and those that use the least. 
  10225.  
  10226. When you alter the scale of the diagram, you actually change the buckets' 
  10227. capacity. When filling, each bucket's contents will differ, and the diagram 
  10228. will look different. An event that previously filled a small part of a large 
  10229. bucket might now fill a large part of several smaller buckets. 
  10230.  
  10231. The Execution Density diagram has filtering capabilities that make it easier to 
  10232. see trends. One way to filter out some of the functions is to set their colors 
  10233. equal to the background color. For example, if you don't want to see functions 
  10234. that take 0 to 1 percent of the execution time during a given time slice, set 
  10235. the color for that range to the background color and those functions will not 
  10236. be displayed. 
  10237.  
  10238. For more information, see Execution Density Diagram. 
  10239.  
  10240.  
  10241. ΓòÉΓòÉΓòÉ 22.7. Hint 7: Use the zoom function to see details. ΓòÉΓòÉΓòÉ
  10242.  
  10243. A useful technique for zooming in to the Execution Density and Time Line 
  10244. diagrams is using the zoom and correlation functions together. Zooming 
  10245. sometimes forces the highlighted region off the page; however, correlation can 
  10246. help you quickly find it again. To use this technique: 
  10247.  
  10248.    1. Open your trace file in a diagram that has both zoom and correlation 
  10249.       capabilities (Execution Density or Time Line). 
  10250.    2. Open another diagram that allows correlation (Call Nesting, Execution 
  10251.       Density, or Time Line). 
  10252.    3. Highlight the area that you want to enlarge (that is, zoom in on) in the 
  10253.       first diagram. 
  10254.    4. Correlate the first diagram to the second. 
  10255.    5. In the first diagram, select the Zoom in choice from the View menu as 
  10256.       many times as you want. 
  10257.    6. Correlate the second diagram to the first. 
  10258.  
  10259.       The region you originally highlighted is back in view. 
  10260.  
  10261.       Note:  If you zoom in too far, you can select the Zoom out choice to 
  10262.       quickly go back one step. 
  10263.  
  10264.  For more information, see Zoom In Choice, Zoom Out Choice, and Correlation 
  10265.  Window. 
  10266.  
  10267.  If you don't want to open another diagram, follow these steps to use the zoom 
  10268.  function: 
  10269.  
  10270.    1. Highlight the area that you want to enlarge. 
  10271.    2. Select the Zoom in choice, and then scroll until you see the area you 
  10272.       highlighted. 
  10273.    3. Continue alternately selecting Zoom in and scrolling to the highlighted 
  10274.       area until the diagram is enlarged to the degree you desire. 
  10275.  
  10276.       Note:  If you zoom in too far, you can select the Zoom out choice to 
  10277.       quickly go back one step. 
  10278.  
  10279.  For more information, see Zoom In Choice and Zoom Out Choice. 
  10280.  
  10281.  Not only does the Zoom to selected range choice provide a quick way to zoom in 
  10282.  on an area of interest, it also provides an easy way to restore the diagram to 
  10283.  full scale after it's been reduced. To restore the diagram to full scale: 
  10284.  
  10285.    1. Select the Select all choice in the View menu. 
  10286.    2. Select the Zoom to selected range choice in the Options menu. 
  10287.  
  10288.  For more information, see Zoom In Choice, Zoom Out Choice, and Zoom To 
  10289.  Selected Range Choice. 
  10290.  
  10291.  
  10292. ΓòÉΓòÉΓòÉ 22.8. Hint 8: Find patterns of calls and returns. ΓòÉΓòÉΓòÉ
  10293.  
  10294. The Call Nesting diagram's Pattern Recognition feature identifies patterns of 
  10295. calls and returns on a single thread. 
  10296.  
  10297. When this feature is on, the Call Nesting diagram identifies these patterns 
  10298. with a curved arc. The number of consecutive repetitions of each pattern is 
  10299. displayed next to the arc. Grouping repeated patterns shortens the number of 
  10300. pages needed to display the trace file. 
  10301.  
  10302. An experienced user seeing many repetitions of patterns could improve 
  10303. performance by grouping functions with pragma alloc_text statements, thereby 
  10304. limiting the number of page swaps between calls in the pattern. 
  10305.  
  10306. For more information, see Include Threads... Choice. 
  10307.  
  10308.  
  10309. ΓòÉΓòÉΓòÉ 22.9. Hint 9: Place annotations in your trace files. ΓòÉΓòÉΓòÉ
  10310.  
  10311.      An annotation is a way of placing a bookmark or reminder in the trace 
  10312.       file after it has been created. In the Call Nesting diagram, you can use 
  10313.       the Annotate... choice to insert notes and reminders next to any function 
  10314.       you select. 
  10315.      You also can make notes to yourself in the trace file with user events. 
  10316.       User events are placed in the code before you create the trace file to 
  10317.       mark where certain structures are executed or to help you locate specific 
  10318.       areas in the trace file during analysis. Consider a user event to be a 
  10319.       smart "print" statement that can be used for a variety of debugging 
  10320.       purposes. 
  10321.  
  10322.  For more information on inserting annotations and customizing a trace file, 
  10323.  see Annotate... choice and Hint 2: Use Performance Analyzer features to 
  10324.  customize your trace file. 
  10325.  
  10326.  
  10327. ΓòÉΓòÉΓòÉ 22.10. Hint 10: Use the diagrams to help you understand exception exits. ΓòÉΓòÉΓòÉ
  10328.  
  10329. Because the Performance Analyzer is constantly recording events, you not only 
  10330. have a record of where exception exits occur, you also have a record of when 
  10331. they occur. 
  10332.  
  10333. For example, when your program causes an exception, you can open your trace 
  10334. file in the: 
  10335.  
  10336.  Call Nesting diagram... 
  10337.            to find the function in which the exit occurred, what happened 
  10338.            before it reached that point, and where any unexpected thread 
  10339.            switches may have occurred. 
  10340.  
  10341.  Dynamic Call Graph... 
  10342.            to find the call hierarchy and how many functions executed prior to 
  10343.            the exit. 
  10344.  
  10345.  Execution Density diagram... 
  10346.            to find trends of activity and abnormal behavior, such as a function 
  10347.            taking longer than it should. 
  10348.  
  10349.  Statistics diagram... 
  10350.            to find cumulative information about function execution times and 
  10351.            numbers of calls. 
  10352.  
  10353.  Time Line diagram... 
  10354.            to find each function's execution time and when each call and return 
  10355.            was made. 
  10356.  
  10357.  For more information, see Analyzing a Trace File. 
  10358.  
  10359.  For more information on specific features and techniques, see other 
  10360.  Performance Analyzer online help topics or the user's guide that came with 
  10361.  your software. 
  10362.  
  10363.  
  10364. ΓòÉΓòÉΓòÉ 22.11. Limitations of the Performance Analyzer ΓòÉΓòÉΓòÉ
  10365.  
  10366. Note the following when using the Performance Analyzer: 
  10367.  
  10368.      If you have written customized setjmp or longjmp functions to replace the 
  10369.       C Set ++ library versions, the Performance Analyzer will not function 
  10370.       correctly. 
  10371.      A user event can be created as a constant character string or can be 
  10372.       specified as an area into which a character string has been built. After 
  10373.       the application has terminated, the Performance Analyzer accesses the 
  10374.       data area of the target application so that the user events can be 
  10375.       written to disk. Therefore, each user event must occupy a unique storage 
  10376.       location. 
  10377.      The Performance Analyzer's timing counter wraps after approximately one 
  10378.       hour. If you attempt to collect events more than one hour after you first 
  10379.       start collecting events, the time stamps will not be accurate. 
  10380.      The Performance Analyzer cannot accurately determine when thread switches 
  10381.       occur. Because of this, the call stack may not be accurate near thread 
  10382.       switches. In the Execution Density and  Time Line diagrams, the time 
  10383.       after a thread switch is associated with the function on the top of the 
  10384.       call stack of the switched-out thread. If there is no such function, the 
  10385.       time is not associated with any function, causing gaps to appear in the 
  10386.       diagrams. 
  10387.      If you minimize the Trace Generation window, the window of the target 
  10388.       application remains in its original state. 
  10389.      If you minimize the Overview window in the Dynamic Call Graph, it does 
  10390.       not appear in the OS/2 Window List. 
  10391.      File access calls are not traced for I/O flush operations that occur 
  10392.       after the target application has finished.  They are not included in the 
  10393.       function-called counts for those file accesses. 
  10394.      The Performance Analyzer can trace and analyze applications generated by 
  10395.       the IBM C Set ++ compiler. You cannot use the Performance Analyzer to 
  10396.       trace files produced by other 16-bit or 32-bit compilers. The Performance 
  10397.       Analyzer can trace only the first 64 threads in your program. 
  10398.      The Performance Analyzer cannot generate or analyze trace data for child 
  10399.       processes in a multiprocess application. 
  10400.      Tracing applications that are currently being debugged by IPMD.EXE or 
  10401.       analyzed by the Performance Analyzer in another session can cause 
  10402.       unpredictable results. 
  10403.      The Performance Analyzer cannot calculate operating system overhead. Be 
  10404.       aware that running other applications in the background while running the 
  10405.       Performance Analyzer will impact your execution times. 
  10406.      C++ applications often have functions that consist of a small number of 
  10407.       instructions. On fast machines, these function call times are small 
  10408.       compared to the system clock resolution of 838 nanoseconds. As a result, 
  10409.       reported overall execution times may be imprecise, especially when these 
  10410.       small functions are called thousands of times. 
  10411.  
  10412.  For information on Performance Analyzer features, see other online help topics 
  10413.  or the user's guide that came with your software. 
  10414.  
  10415.  
  10416. ΓòÉΓòÉΓòÉ 23. Keys Help ΓòÉΓòÉΓòÉ
  10417.  
  10418. Ctrl+H 
  10419.  
  10420. On the Trace Generation window and each of the diagrams, you can display Help 
  10421. information for many functions by highlighting the function and pressing 
  10422. Ctrl+H. This Help information is available for functions such as IBM Open Class 
  10423. functions, OS/2 system functions, and C runtime functions. 
  10424.  
  10425. Performance Analyzer - Window Manager Window 
  10426.  
  10427. The following are shortcut keys for the File menu. 
  10428.  
  10429.  Choice              Shortcut Keys 
  10430.  Exit Performance Analyzer F3 
  10431.  
  10432.  Trace Generation Window 
  10433.  
  10434.  The following are shortcut keys for the Program menu. 
  10435.  
  10436.  Choice              Shortcut Keys 
  10437.  Window manager      Ctrl+W 
  10438.  Exit Performance Analyzer F3 
  10439.  
  10440.  Call Nesting Diagram 
  10441.  
  10442.  The following are shortcut keys for the Trace file menu. 
  10443.  
  10444.  Choice              Shortcut Keys 
  10445.  Window manager      Ctrl+W 
  10446.  Exit Performance Analyzer F3 
  10447.  
  10448.  The following are shortcut keys for the Edit menu. 
  10449.  
  10450.  Choice              Shortcut Keys 
  10451.  Find next           Ctrl+N 
  10452.  Annotate...         Ctrl+A 
  10453.  
  10454.  The following are shortcut keys for the Find... cascaded menu. 
  10455.  
  10456.  Choice              Shortcut Keys 
  10457.  Function...         Ctrl+F 
  10458.  
  10459.  Dynamic Call Graph 
  10460.  
  10461.  The following are shortcut keys for the Trace file menu. 
  10462.  
  10463.  Choice              Shortcut Keys 
  10464.  Window manager      Ctrl+W 
  10465.  Exit Performance Analyzer F3 
  10466.  
  10467.  The following are shortcut keys for the View menu. 
  10468.  
  10469.  Choice              Shortcut Keys 
  10470.  Zoom in             Ctrl++ 
  10471.  Zoom out            Ctrl+- 
  10472.  
  10473.  The following are shortcut keys for the Options menu. 
  10474.  
  10475.  Choice              Shortcut Keys 
  10476.  Find function...    Ctrl+F 
  10477.  
  10478.  Execution Density Diagram 
  10479.  
  10480.  The following are shortcut keys for the Trace file menu. 
  10481.  
  10482.  Choice              Shortcut Keys 
  10483.  Window manager      Ctrl+W 
  10484.  Exit Performance Analyzer F3 
  10485.  
  10486.  The following are shortcut keys for the Edit menu. 
  10487.  
  10488.  Choice              Shortcut Keys 
  10489.  Find function...    Ctrl+F 
  10490.  Find next           Ctrl+N 
  10491.  
  10492.  The following are shortcut keys for the View menu. 
  10493.  
  10494.  Choice              Shortcut Keys 
  10495.  Zoom in             Ctrl++ 
  10496.  Zoom out            Ctrl+- 
  10497.  
  10498.  Statistics Diagram 
  10499.  
  10500.  The following are shortcut keys for the Trace file menu. 
  10501.  
  10502.  Choice              Shortcut Keys 
  10503.  Window manager      Ctrl+W 
  10504.  Exit Performance Analyzer F3 
  10505.  
  10506.  The following are shortcut keys for the Options menu. 
  10507.  
  10508.  Choice              Shortcut Keys 
  10509.  Find...             Ctrl+F 
  10510.  
  10511.  Time Line Diagram 
  10512.  
  10513.  The following are shortcut keys for the Trace file menu. 
  10514.  
  10515.  Choice              Shortcut Keys 
  10516.  Window manager      Ctrl+W 
  10517.  Exit Performance Analyzer F3 
  10518.  
  10519.  The following are shortcut keys for the Edit menu. 
  10520.  
  10521.  Choice              Shortcut Keys 
  10522.  Find function...    Ctrl+F 
  10523.  Find next           Ctrl+N 
  10524.  
  10525.  The following are shortcut keys for the View menu. 
  10526.  
  10527.  Choice              Shortcut Keys 
  10528.  Zoom in             Ctrl++ 
  10529.  Zoom out            Ctrl+- 
  10530.  
  10531.  
  10532. ΓòÉΓòÉΓòÉ <hidden> Add/Change Push Button ΓòÉΓòÉΓòÉ
  10533.  
  10534. Select the Add/Change push button to add or change the comments you have added 
  10535. in the Annotation dialog window of the Call Nesting diagram. 
  10536.  
  10537.  
  10538. ΓòÉΓòÉΓòÉ <hidden> Analyze Trace... Push Button ΓòÉΓòÉΓòÉ
  10539.  
  10540. Select the Analyze Trace... push button to quickly access the Analyze Trace 
  10541. window from which you can select Performance Analyzer diagrams to analyze a 
  10542. trace file. 
  10543.  
  10544.  
  10545. ΓòÉΓòÉΓòÉ <hidden> Apply Push Button ΓòÉΓòÉΓòÉ
  10546.  
  10547. Select the Apply push button to use the selected settings in the current window 
  10548. without making them permanent. 
  10549.  
  10550.  
  10551. ΓòÉΓòÉΓòÉ <hidden> Cancel Push Button ΓòÉΓòÉΓòÉ
  10552.  
  10553. Select the Cancel push button to exit the current window without saving any 
  10554. changes. 
  10555.  
  10556.  
  10557. ΓòÉΓòÉΓòÉ <hidden> Deselect All Push Button ΓòÉΓòÉΓòÉ
  10558.  
  10559. Select the Deselect all push button to deselect all selected elements in the 
  10560. window. This push button is available from the Correlation, Include Functions, 
  10561. and Include threads windows. 
  10562.  
  10563.  
  10564. ΓòÉΓòÉΓòÉ <hidden> Create Trace... Push Button ΓòÉΓòÉΓòÉ
  10565.  
  10566. Select the Create Trace... push button to quickly access the Create Trace 
  10567. window from which you can start creating a trace file. 
  10568.  
  10569.  
  10570. ΓòÉΓòÉΓòÉ <hidden> Find Caller Push Button ΓòÉΓòÉΓòÉ
  10571.  
  10572. Select the Find Caller push button in the Who Calls Whom window to select and 
  10573. center the node that makes the call. For more information, see the Who Calls 
  10574. Whom window. 
  10575.  
  10576.  
  10577. ΓòÉΓòÉΓòÉ <hidden> Find Callee Push Button ΓòÉΓòÉΓòÉ
  10578.  
  10579. Select the Find Callee push button in the Who Calls Whom window to select and 
  10580. center the node that is called. For more information, see the Who Calls Whom 
  10581. window. 
  10582.  
  10583.  
  10584. ΓòÉΓòÉΓòÉ <hidden> Find Push Button ΓòÉΓòÉΓòÉ
  10585.  
  10586. Select the Find push button in the Find window to start searching for a user 
  10587. event, a file access, a call for a function, a return to a function, or an 
  10588. annotation. For more information, see the Find Function window. 
  10589.  
  10590.  
  10591. ΓòÉΓòÉΓòÉ <hidden> Find Push Button ΓòÉΓòÉΓòÉ
  10592.  
  10593. Click on the Find push button to display the Find File window, which helps you 
  10594. locate a file that you want to trace or analyze. 
  10595.  
  10596.  
  10597. ΓòÉΓòÉΓòÉ <hidden> Font Push Button ΓòÉΓòÉΓòÉ
  10598.  
  10599. Select the Font push button in the Printer Settings  window to select from 
  10600. available fonts. 
  10601.  
  10602.  
  10603. ΓòÉΓòÉΓòÉ <hidden> Job Properties Push Button ΓòÉΓòÉΓòÉ
  10604.  
  10605. Select the Job properties push button in the  Printer Settings window for more 
  10606. detailed information about your print job. 
  10607.  
  10608. From the Job properties... window, select the appropriate push buttons and 
  10609. check boxes. 
  10610.  
  10611.  
  10612. ΓòÉΓòÉΓòÉ <hidden> Help Push Button ΓòÉΓòÉΓòÉ
  10613.  
  10614. Select the Help push button to learn how to use the window that is currently 
  10615. displayed. 
  10616.  
  10617.  
  10618. ΓòÉΓòÉΓòÉ <hidden> OK Push Button ΓòÉΓòÉΓòÉ
  10619.  
  10620. Select the OK push button to save the changes and close the window. 
  10621.  
  10622.  
  10623. ΓòÉΓòÉΓòÉ <hidden> Remove Push Button ΓòÉΓòÉΓòÉ
  10624.  
  10625. Select the Remove push button to remove a comment from the Annotate dialog 
  10626. window in the Call Nesting diagram. 
  10627.  
  10628.  
  10629. ΓòÉΓòÉΓòÉ <hidden> Reset Push Button ΓòÉΓòÉΓòÉ
  10630.  
  10631. Select the Reset push button to return to the default font settings. 
  10632.  
  10633.  
  10634. ΓòÉΓòÉΓòÉ <hidden> Set Push Button ΓòÉΓòÉΓòÉ
  10635.  
  10636. Select the Set push button to accept the changes in the current window. 
  10637.  
  10638.  
  10639. ΓòÉΓòÉΓòÉ <hidden> Select All Push Button ΓòÉΓòÉΓòÉ
  10640.  
  10641. Select the Select all push button to select all elements in the window. 
  10642.  
  10643.  
  10644. ΓòÉΓòÉΓòÉ <hidden> Stop Push Button ΓòÉΓòÉΓòÉ
  10645.  
  10646. Select the Stop push button in the Application Monitor window to stop your 
  10647. program while it is being analyzed by the Performance Analyzer. When you stop 
  10648. the application, you also stop the collection of trace data. 
  10649.  
  10650. The Analyze Trace window is displayed after the trace stops so that you can 
  10651. select one or more diagrams in which to view the trace data. 
  10652.  
  10653. Related Information 
  10654.  
  10655.      Trace Off Push Button. 
  10656.      Trace On Push Button. 
  10657.      Analyze Trace Window 
  10658.      Selecting a Trace File to Analyze. 
  10659.  
  10660.  
  10661. ΓòÉΓòÉΓòÉ <hidden> Trace Push Button ΓòÉΓòÉΓòÉ
  10662.  
  10663. Select a program you want to trace, and then click on the Trace push button to 
  10664. close the Trace Generation window and begin tracing your program. 
  10665.  
  10666.  
  10667. ΓòÉΓòÉΓòÉ <hidden> Trace Off Push Button ΓòÉΓòÉΓòÉ
  10668.  
  10669. Select the Trace off push button in the Application Monitor window to stop 
  10670. tracing events in your program. Trace off does not cause your program to stop 
  10671. running; it stops trace events from being recorded to the trace file. When the 
  10672. Application Monitor window is displayed, the Performance Analyzer has already 
  10673. started tracing events, so you can select Trace off anytime after the window is 
  10674. displayed. 
  10675.  
  10676. Note:  Return events are still logged for functions that were called before you 
  10677. turned trace off, and execution time will still be logged against functions 
  10678. that were called but have not returned to the caller. 
  10679.  
  10680. You can also turn tracing off from your program by calling the Performance 
  10681. Analyzer function PerfStop. To turn tracing back on, call the Performance 
  10682. Analyzer function PerfStart. 
  10683.  
  10684. The calls to PerfStart and PerfStop can be anywhere in your program, even in 
  10685. different functions, object modules, or DLLs. If the trace is already off, 
  10686. Calling PerfStop has no effect. If the trace is already on, Calling PerfStart 
  10687. has no effect. For instructions, see Starting and Stopping the Performance 
  10688. Analyzer from Your Program. 
  10689.  
  10690. Related Information 
  10691.  
  10692.      Trace On Push Button. 
  10693.      Selecting a Trace File to Analyze. 
  10694.  
  10695.  
  10696. ΓòÉΓòÉΓòÉ <hidden> Trace On Push Button ΓòÉΓòÉΓòÉ
  10697.  
  10698. Select the Trace on push button in the Application Monitor window to start 
  10699. tracing events in your program. Trace on does not cause your program to start 
  10700. running; it causes trace events to start being recorded to the trace file. When 
  10701. the Application Monitor window is displayed, the Performance Analyzer has 
  10702. already started tracing events, so you cannot select Trace on until you have 
  10703. first selected Trace off. 
  10704.  
  10705. You can also turn tracing on from your program by calling the Performance 
  10706. Analyzer function PerfStart. To turn tracing off, call the Performance Analyzer 
  10707. function PerfStop. 
  10708.  
  10709. The calls to PerfStart and PerfStop can be anywhere in your program, even in 
  10710. different functions, object modules, or DLLs. If the trace is already on, 
  10711. Calling PerfStart has no effect. If the trace is already off, Calling PerfStop 
  10712. has no effect. For instructions, see Starting and Stopping the Performance 
  10713. Analyzer from Your Program. 
  10714.  
  10715. Related Information 
  10716.  
  10717.      Trace Off Push Button 
  10718.      Selecting a Trace File to Analyze. 
  10719.  
  10720.  
  10721. ΓòÉΓòÉΓòÉ <hidden> Who Calls Whom Push Button ΓòÉΓòÉΓòÉ
  10722.  
  10723. Select the Who calls whom push button in the Function Information window to 
  10724. display only the selected node and the nodes that called the selected node. For 
  10725. more information, see the Function Information window. 
  10726.  
  10727.  
  10728. ΓòÉΓòÉΓòÉ <hidden> Whom Do I Call Push Button ΓòÉΓòÉΓòÉ
  10729.  
  10730. Select the Whom do I call push button in the Function Information window to 
  10731. display only the selected node and the nodes that the selected node called. For 
  10732. more information, see the Function Information window. 
  10733.  
  10734.  
  10735. ΓòÉΓòÉΓòÉ 23.1. Glossary ΓòÉΓòÉΓòÉ
  10736.  
  10737. Double-click on any term to see its definition: 
  10738.  
  10739.      Active Time 
  10740.      Annotation 
  10741.      Arc 
  10742.      Buffer Wrapping 
  10743.      Buffer Wrap 
  10744.      Call 
  10745.      Call Nesting Diagram 
  10746.      Component 
  10747.      Correlation 
  10748.      Disabling Components 
  10749.      Dos calls 
  10750.      Dynamic Call Graph 
  10751.      Enabling Components 
  10752.      Events 
  10753.      Executable File 
  10754.      Execution Density Diagram 
  10755.      File Access 
  10756.      Flush 
  10757.      function 
  10758.      Hot Spots 
  10759.      Microseconds (us) 
  10760.      Milliseconds (ms) 
  10761.      Minus Icon 
  10762.      Node 
  10763.      Object Files 
  10764.      Overhead 
  10765.      Pixels 
  10766.      Profile Hooks 
  10767.      Plus Icon 
  10768.      Return 
  10769.      Run Time 
  10770.      Scaling 
  10771.      Statistics 
  10772.      Seconds (s) 
  10773.      Shortcut Keys 
  10774.      Thread 
  10775.      Tic 
  10776.      Time Line Diagram 
  10777.      Time Stamp 
  10778.      Trace Analysis 
  10779.      Trace file 
  10780.      Trigger 
  10781.      User Event 
  10782.  
  10783.  
  10784. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10785.  
  10786. Trademark of International Business Machines Corporation. 
  10787.  
  10788.  
  10789. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10790.  
  10791. The Performance Analyzer determines the time slice by dividing the total trace 
  10792. time into equal units. For instance, a 10-second trace file would have 10 time 
  10793. slices equal to 1 second each. 
  10794.  
  10795. The time slice value can change based on the page size in the Execution Density 
  10796. diagram or Time Line diagram. Each page represents an overall diagram or 100% 
  10797. view, there is one page. As you magnify the diagram, the number of pages 
  10798. increase and the time slice value increases. 
  10799.  
  10800.  
  10801. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10802.  
  10803. Active time is the total time a function is on the call stack while its thread 
  10804. is executing. The time is displayed in the Statistics diagram and Dynamic Call 
  10805. Graph 
  10806.  
  10807.  
  10808. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10809.  
  10810. An annotation is a descriptive comment or an explanatory note that you can add 
  10811. to the Call Nesting diagram. Annotations are a way to place a bookmark in the 
  10812. trace file. You can add notes to the diagram about what is being displayed next 
  10813. to the calls and returns. The Performance Analyzer writes these comments in the 
  10814. trace file, so you can display the comments anytime you look at the trace file 
  10815. in the future. 
  10816.  
  10817.  
  10818. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10819.  
  10820. An arc is a directed line connecting two nodes in the Dynamic Call Graph. It 
  10821. shows the relationship between the two nodes. 
  10822.  
  10823.  
  10824. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10825.  
  10826. When buffer wrapping is enabled, the trace data is written only when the 
  10827. tracing has stopped. As the program is traced, the buffer fills and overwrites 
  10828. the older events in the buffer. When buffer wrapping is disabled, the data is 
  10829. written to the trace file every time the buffer fills. 
  10830.  
  10831.  
  10832. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10833.  
  10834. A buffer wrap occurs when the trace buffer overflows so that subsequent events 
  10835. are written to the beginning of the buffer. When this happens, older events are 
  10836. overwritten. The trace file size is limited by the number of events contained 
  10837. in the buffer. 
  10838.  
  10839.  
  10840. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10841.  
  10842. To call is to bring a function into effect, such as specifying the entry 
  10843. conditions and then jumping to an entry point in the function. 
  10844.  
  10845.  
  10846. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10847.  
  10848. The Call Nesting diagram shows the program execution as a vertical series of 
  10849. function calls and returns. Each thread has its own starting column of 
  10850. functions. A call is drawn as a step to the right and a return as a line back 
  10851. to the left. The calls are labeled with the name of the function being called. 
  10852. Context switches between threads are shown by dashed horizontal lines. 
  10853.  
  10854.  
  10855. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10856.  
  10857. A component can be an executable file, an object, or a function from your 
  10858. program. 
  10859.  
  10860.  
  10861. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10862.  
  10863. Correlation allows you to mark a point in a Call Nesting diagram, Execution 
  10864. Density diagram, or Time Line diagram and then find that same point in another 
  10865. Call Nesting diagram, Execution Density diagram, or Time Line diagram. 
  10866.  
  10867.  
  10868. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10869.  
  10870. When you disable an executable, object file, or function, the Performance 
  10871. Analyzer does not include information about that component in the trace file. 
  10872.  
  10873. You can disable a component for one trace analysis to tailor the data in the 
  10874. trace file. 
  10875.  
  10876.  
  10877. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10878.  
  10879. Dos calls  are calls made to the operating system through functions with names 
  10880. beginning with a Dos prefix, such as, DosExit and DosOpen. 
  10881.  
  10882.  
  10883. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10884.  
  10885. The Dynamic Call Graph shows a graphical view of the target program's 
  10886. execution. Each function called is displayed as a node. Calls are shown as arcs 
  10887. between nodes. The colors and sizes of nodes and arcs show the amount of time 
  10888. spent in the function and the number of calls between functions. 
  10889.  
  10890.  
  10891. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10892.  
  10893. When you enable an executable, object file, or function, the Performance 
  10894. Analyzer includes information about that component in the trace file. You can 
  10895. enable a component for one trace analysis to tailor the data in the trace file. 
  10896.  
  10897.  
  10898. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10899.  
  10900. An environment variable is a variable associated with a given process and is 
  10901. inherited from its parent process. For example, PATH. 
  10902.  
  10903.  
  10904. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10905.  
  10906. An event  occurs anytime a function is called or returns. The Performance 
  10907. Analyzer records all events in the trace file. 
  10908.  
  10909.  
  10910. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10911.  
  10912. An executable is a file of compressed images of a program that includes each of 
  10913. the program segments, such as code, data, and call stack and control records 
  10914. that tell the loader how to tie all of the program segments together. 
  10915.  
  10916.  
  10917. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10918.  
  10919. The Execution Density diagram displays trace data in a vertical dimension 
  10920. scaled by the execution time just like the Time Line diagram, but calls and 
  10921. returns are not shown. Instead, the entire execution time is divided into a 
  10922. fixed number of horizontal slices, or scan lines, as determined by the number 
  10923. of pages to be used for the entire diagram. Each function that logs events is 
  10924. assigned to a fixed column of the diagram. The Performance Analyzer draws the 
  10925. diagram by coloring each slice of the column depending on the percentage of the 
  10926. slice that the corresponding function used. For instance in the default 
  10927. setting, yellow represents 0 to 1 percent of the time slice was used in the 
  10928. function and pink represents that 2 to 5 percent of the time slice was used. 
  10929.  
  10930.  
  10931. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10932.  
  10933. File access  occurs when a given file is opened, read, written, or closed in a 
  10934. program. 
  10935.  
  10936.  
  10937. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10938.  
  10939. A flush  occurs when the virtual logging buffer for a trace is full and the 
  10940. Buffer wrap choice in the Trace Generation window has not been selected. The 
  10941. Performance Analyzer processes the contents of the virtual logging buffer and 
  10942. the events are written to the trace file. After the buffer is flushed, the 
  10943. Performance Analyzer resumes tracing the program. 
  10944.  
  10945.  
  10946. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10947.  
  10948. A function is defined by the Performance Analyzer to be a callable section 
  10949. within the program. For the Performance Analyzer, procedures and subroutines 
  10950. are synonyms of functions. 
  10951.  
  10952.  
  10953. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10954.  
  10955. Hot spots  are areas within a program where a disproportionate amount of time 
  10956. was spent. The Performance Analyzer traces how long a function ran, which helps 
  10957. determine which functions caused the hot spots. 
  10958.  
  10959.  
  10960. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10961.  
  10962. Causes the time to display in microseconds. 
  10963.  
  10964.  
  10965. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10966.  
  10967. Causes the time to display in milliseconds. 
  10968.  
  10969.  
  10970. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10971.  
  10972. The minus icon is displayed beside an executable and object file in the Trace 
  10973. Generation window when the file can not be shown or expanded. 
  10974.  
  10975.  
  10976. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10977.  
  10978. A node is the representation of an individual function or executable in the 
  10979. Dynamic Call Graph. 
  10980.  
  10981.  
  10982. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10983.  
  10984. Object files are compiler output files that are linked to comprise an 
  10985. executable. 
  10986.  
  10987.  
  10988. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10989.  
  10990. Overhead  is the time it takes to log events in the trace file. The Performance 
  10991. Analyzer measures its overhead and adjusts the timing information accordingly. 
  10992.  
  10993.  
  10994. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  10995.  
  10996. Pixels  are picture elements of a display area. 
  10997.  
  10998.  
  10999. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11000.  
  11001. When a profile hook is specified, the compiler generates a call to a profiling 
  11002. hook function as the first instruction in the prologue of each function. There 
  11003. are two profiling hook functions: 
  11004.  
  11005.  _Profile_Hook32 
  11006.            Profile hook for all 32-bit functions. 
  11007.  _ProfileHook16 
  11008.            Profile hook for all 16-bit callback functions. These functions are 
  11009.            defined with either the _Far16 _Cdecl, or _Far16 _Pascal linkage 
  11010.            keywords. 
  11011.  
  11012.  For more information about profile hooks, see the  Programming Guide. 
  11013.  
  11014.  
  11015. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11016.  
  11017. The plus icon is displayed beside an executable and object file in the Trace 
  11018. Generation window when the file can be shown or expanded. 
  11019.  
  11020.  
  11021. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11022.  
  11023. A return is a language construct within a function designating the end of the 
  11024. execution sequence in the function. 
  11025.  
  11026.  
  11027. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11028.  
  11029. Run time is the time during which a program is being executed. 
  11030.  
  11031.  
  11032. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11033.  
  11034. Scaling is the process of changing the granularity of the detail in a trace 
  11035. diagram: to step back from a diagram to get a bigger picture or to zoom in to 
  11036. see the finer points. 
  11037.  
  11038.  
  11039. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11040.  
  11041. The Statistics Diagram provides a textual report of execution time by function. 
  11042. It also provides summary information. 
  11043.  
  11044.  
  11045. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11046.  
  11047. Causes the time to display in seconds. 
  11048.  
  11049.  
  11050. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11051.  
  11052. Shortcut keys are keys you use to invoke menu choices. When two key names are 
  11053. joined by a plus sign (+), use these two keys together. Hold down the first key 
  11054. and then press the second key. 
  11055.  
  11056. You can use keyboard shortcuts for most of the menu choices in the Performance 
  11057. Analyzer. 
  11058.  
  11059. For a list of shortcut keys, select any of the following: 
  11060.  
  11061.      Call Nesting Diagram 
  11062.      Dynamic Call Graph 
  11063.      Execution Density Diagram 
  11064.      Statistics Diagram 
  11065.      Time Line Diagram 
  11066.      Trace Generation Window 
  11067.  
  11068.  
  11069. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11070.  
  11071. A thread  is the basic unit of execution. A thread gives a program its context, 
  11072. including registers, call stack, and processor mode. Multiple threads can be 
  11073. running at the same time, and any particular thread can start another thread. 
  11074.  
  11075.  
  11076. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11077.  
  11078. A tic is the smallest unit of time measured by the Performance Analyzer 
  11079. counter. A tic measures approximately 838 nanoseconds. 
  11080.  
  11081.  
  11082. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11083.  
  11084. The Time Line diagram displays the sequence of nested function calls and 
  11085. returns. Time stamps determine the exact placement of an event along the time 
  11086. dimension on the vertical axis. This provides a direct and natural presentation 
  11087. of the chronological relationships of events. 
  11088.  
  11089.  
  11090. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11091.  
  11092. A time stamp is the actual time at which an event occurred when the program was 
  11093. being traced. The Performance Analyzer time stamps when your program calls and 
  11094. returns from a function. 
  11095.  
  11096.  
  11097. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11098.  
  11099. A trace analysis  is a record of events obtained during the execution of a 
  11100. program. It contains the sequences and timing of the events during program 
  11101. execution. 
  11102.  
  11103.  
  11104. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11105.  
  11106. A trace file  is a file that contains a chronological sequence of records 
  11107. describing events which occurred during the program execution. The trace file 
  11108. contains the trace analysis information from your program. This file can be 
  11109. displayed by the diagrams. 
  11110.  
  11111.  
  11112. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11113.  
  11114. A trigger function  turns tracing on when it is called and then turns tracing 
  11115. off when it returns. If a trigger function is nested within another trigger 
  11116. function, tracing is turned off only after the outer function returns. 
  11117.  
  11118.  
  11119. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11120.  
  11121. A user event is a call to the Performance Analyzer, defined by the user, in the 
  11122. program. The Performance Analyzer inserts text strings into the diagrams given 
  11123. by the parameter supplied by this call. User events can help you diagnose 
  11124. problem areas in your program. 
  11125.  
  11126.  
  11127. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11128.  
  11129. The word program as used in this online help generally refers to the executable 
  11130. file you are tracing; and the word application  as used in this online help 
  11131. generally refers to the Performance Analyzer. 
  11132.  
  11133. Other use of the words program and application may be used synonymously. 
  11134.  
  11135.  
  11136. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11137.  
  11138. A trace event is either a call to a function or a return from a function. 
  11139.  
  11140.  
  11141. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11142.  
  11143. The maximum number of calls made is the number of calls made between the two 
  11144. functions that contained the greatest number of calls between them. 
  11145.  
  11146.  
  11147. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  11148.  
  11149. The maximum execution time is the amount of time required to execute the 
  11150. function that has the greatest execution time.