NoteYou need to create an Application/Module profile if you wish to analyze the performance of a specific application and/or modules of interest.
The Application/Module Profile Configuration dialog box enables you to configure an existing application/module profile for the Activity you are configuring. The profile defines an application to launch and/or modules of interest.
Type in or browse to select the path for an executable. When collecting data on a Remote Agent system, type in paths as they are known on the Remote Agent system. For example, on Linux* OS , type in a path of the form "/path/to/executable/file".
If this check box is checked, after you have added the path for an executable in the Filename field, the path is also added to the Modules of Interest list.
(Optional) Type in or browse to select the working directory, the directory from which to launch the application. When collecting data on a Remote Agent system, type in paths as they are known on the Remote Agent system. For example, on Linux* OS , type in a path of the form "/path/to/executable/file".
Enter the command-line arguments for the application/module profile. For Java* applications, enter the .class or .html file that launches your Java application or applet. See Command Lines for Java Launchers and Applet Viewers.
NoteIf launching an application on a remote Linux* OS system, special characters, such as >, <, |, and & are not arguments to the application itself, but rather are used in the context of a shell interpreter (e.g., bash, csh, tcsh, etc.). If such characters are required, then create a shell script which invokes the actual program and uses those characters. Then specify that script as the application to launch.
Click to open the Application to Launch Options dialog box, and change the environment variables of the launched application.
Specify the remote system on which to launch the application. Any previously added remote systems appear in the drop-down list of remote systems.
Remote...
To add a new remote system, click Remote... to launch the Remote Systems dialog box and enter the details of the new system.
This setting is only available when you launch an application on a remote system. If you have a local copy of the application to launch on the remote system, specify the path for the local copy here. This setting may be required by some data collectors, and you will not be able to save the Activity until you provide the information.
NoteWhen using this setting, make sure that the local copy is identical to the one running on the Remote Agent system.
You can add specific modules for interest. Specifying modules of interest enables some data collectors to enhance the data collection on these modules.
Modules of interest are useful in these examples:
When your application uses one or more shared libraries (.so files), adding the shared libraries as modules of interest focuses the data collection on the launched application and the shared libraries.
When using a batch file to launch more than one executable, choosing the executables as modules of interest focuses the data collection on the launched files, instead of the batch file.
To select a module of interest:
Click New... in the Module of Interest groupChoose a Module of Interest dialog box opens. Type in or browse to select a module of interest. Click OK to add the selected file to the list of Modules of Interest. Click Cancel to cancel the operation.
Repeat for any additional modules.
Double-click an Activity to configure it, or select Configure > Modify <Activity name>.
The Activity Configuration dialog box opens.
Select the Application/module profile and click Configure on the Application/Module Profile side of the dialog box.
The Application/Module Profile Configuration dialog box opens.
NoteDepending on the data collector, an application/module profile can be required, optional, or unsupported. See the help on your data collector for more details.
