Application settings dialog

   

  The application settings dialog collects all information that is required to start your application with profiling enabled. This dialog is presented when you create a new session. From a running session it is available through JProfiler's main menu via View->Application settings.
  In the application settings dialog you configure the following details:
  • Session name
    Every session has a unique name that is presented in the "Open session" pane of the start center and in the open session dialog. It is also used for the title of the main window and the terminal window. Next to the name text field you see an ID which is used for choosing the session in offline profiling or for remote profiling with the "nowait" option.
  • Session type
    There are four different session types. Depending on this choice, the middle part of the tab will display different options.
    • Local sessions
      A local session starts your application when the session is opened. You need to specify the virtual machine, as well as your application's class path, main class, parameters and working directory. Your application will be started in a separate terminal window and is prevented from exiting while JProfiler is attached to it. Local sessions are most convenient for profiling GUI and console applications where you have written the main class yourself.
    • Remote sessions
      A remote session connects to a running application which has been started with JProfiler's profiling agent. The profiling agent listens on the default port of 8849 which can be changed in the agent's initialization parameters. Remote sessions are most convenient for profiling server applications on remote machines and application servers where you write classes which are loaded and invoked within the application server's framework.
    • Applet sessions
      Applet sessions are used for profiling applets with Sun's applet viewer which is shipped with every JDK. You only need to supply the URL to a HTML page containing the applet.

      Note: If the applet view is too restrictive for your applet, please use the Java plugin integration wizard available on the New session tab of the start center.

    • Web Start sessions
      JProfiler can profile Java Web Start applications. You only need to supply the URL for the JNLP file or select a cached application.
  • Additional Java file path
    With the two radio buttons on the left you choose whether to set the
    • Additional class path
      The session-specific additional class path allows you to enter directories and jar files which are prepended to the default class path (see there for more details on choosing the class path). The class path is also used by the bytecode viewer to find class files for display.
    • Additional source path
      The session-specific additional source path allows you to enter archives and directories which are prepended to the default source path (see there for more details on choosing the source path). Note that the sources of the selected JDK contained in src.jar or src.zip will be automatically appended if they are installed. The source path is is used by the source code viewer to display Java sources.
    • Additional native library path
      The session-specific native library path allows you to enter directories which are prepended to the default native library path (see there for more details on choosing the native library path). You only need the native library path for loading native libraries with calls to java.lang.System.loadLibrary() or for resolving dependent libraries that have to be dynamically loaded by your native libraries.

    Adjusting the class and source path during an active session is effective for the source code and bytecode viewer only.