Creating a CodeAnalyst Project

This section demonstrates how to create a new CodeAnalyst project. All work takes place in the context of a CodeAnalyst project. You must either create a new project or open an existing project in order to collect and analyze performance data. Performance data is organized and saved as a “Session.” A project may contain multiple sessions. Sessions are saved with a project.

  1. Launch CodeAnalyst. The CodeAnalyst window displays.

  1. To create new project, click the New project icon in the toolbar or select File > New from the File menu.

A dialog box appears asking for the project name and the project location. You must name the project and you must specify its location.

  1. Enter the name of the new project into the Project Name field.
  2. Enter the path to the directory that will hold the new project into the Project location field. You may also browse to the project location by clicking the Browse button next to the project location field.
  3. Click OK to create the new project or click Cancel to dismiss the dialog box.

A dialog box appears asking for basic session settings. The session settings name the session to be created, control the kind of data to be collected, and specify the application program to be launched along with its working directory.

  1. Enter the name of the new session into the Session name field.
  2. Enter the Launch path to the application program to be launched.
  3. Enter the path to the Working directory. You may browse to either the application program or working directory by clicking the appropriate Browse button. This tutorial uses the example program that is installed with CodeAnalyst.

The profile configuration controls the method of data collection and the kind of performance data to be collected.

  1. Select Time-based profile (or another profile configuration) from the drop-down list of profile configurations. A brief description of the profile configuration is displayed from the selected configuration.

  1. Click the Show Options>>> button to display extended session settings. The extended session settings control the process of data collection.
  2. Click the check box to the left of Terminate the app after the profile to select that option. When this option is enabled, CodeAnalyst terminates the application program after collecting data. The “Profile duration” option specifies the maximum time period for data collection.
  3. Enter 10 into the Profile duration field to collect data for a maximum of 10 seconds.
  4. Click OK to confirm the session settings. CodeAnalyst is now ready to collect data.

After the new project is created, it becomes the current project with the new project name displayed in the sessions area on the left side of the CodeAnalyst window. No sessions are listed under TBP Sessions, EBP Sessions, or IBS Sessions until data have been collected and processed.

  1. Click on Session Settings in the toolbar or select Tools > Session Settings to change session settings.

Next: Analysis with Time-Based Profiling