Application Launcher Properties

• If the launcher will always be executed from within the directory where it is created, then specify relative paths to your classpath entries from that location. For example:
  
  app/MyApp.jar
  "app libs/MyLib.jar"
  
  
  

  When specifying classpath entries that include spaces, enclose each entry in double quotes, as illustrated in the example above.

• If the launcher can be executed from any working directory, then provide absolute paths in the classpath entries using either the $P or $PATH string resolution variables. For example:
  
  "$P(appFiles.absoluteInstallLocation)/MyApp.jar"
  --OR--
  "$PATH($P(appFiles.absoluteInstallLocation), MyApp.jar)"
  
  "$P(libFiles.absoluteInstallLocation)/MyLib.jar"
  --OR--
  "$PATH($P(libFiles.absoluteInstallLocation), MyApp.jar)"
  
  
  

  When using string resolution to provide an absolute path, it is a good practice to always enclose it in double quotes because the end user may install the product to a path that contains a space(s).

%IF_EXISTS%("<setting name>", "@<setting name>@")

Both of the arguments passed to this function need to be enclosed in double quotes. If they are not, then they resolve to an empty string. You can include multiple %IF_EXISTS% function calls in this property—be sure to place a space between them.

For example:

%IF_EXISTS%("INIT_HEAP_SIZE", "@INIT_HEAP_SIZE@20m")

%IF_EXISTS%("MAX_HEAP_SIZE", "@MAX_HEAP_SIZE@40m")

This is the command you would use to increase the heap size to accommodate the size of your project. If you receive an "out of memory" message when building or running your project, use this Java argument to increase the heap size until the error message is no longer received.

• If Java 1.2.2+ is used to launch the product, the above string resolves to -Xms20m -Xmx40m.
• If JVIEW is used, it resolves to an empty string.

This property should not be used for arguments to Java that are already handled by other properties within this action such as the classpath since that would result in the same command line option being specified to Java multiple times.