JVM Resolution Action Properties

InstallShield 11 Universal

Available in InstallShield Universal Premier and Professional Only

After a JVM Resolution product action has been added to a component, set its Standard, Advanced, and Platform properties as described below.

Standard Properties

Property	Description
Active	Indicates if this action is active. If "False", it is inactive and is skipped.
Display Name	This property represents the name for this action as it displays in the interface. It is intended for administrative use only.
JVM ID	This is a required field that specifies the ID for the JVM, and is case sensitive. This key value must also be specified by Java application Launchers in order for it to access the resolved JVM. You may include more than one JVM Resolution action in a project, but the JVM ID for each must be unique.
Install Location	Specify the target directory where the bundled JVM should be installed. This can be an absolute path, or relative to the Install Location property value of the Product, Feature, or Component.
Use Installed JVM	If "True," then the JVMs installed to the Install Location specified in the previous property will be searched for. Leave set to "False" (the default) if you do not bundle a JVM with this installation.

Advanced Properties

Property	Description
Bean ID	Specify a unique identifier for this action.
Build Categories	This optional property represents the categories within which you can assign to this action. You can create as many Build Categories as you desire and assign them to the actions you want to be able to exclude from a build. Then, in the Build Configuration Advanced/Build Configuration Filter property, you would select the build category(ies) to exclude from that build.
Comments (Premier Only)	This optional property enables you to specify comments about this action. These comments are stored in the project file and are for your use only. They are ignored at run time.

Platform Properties

The Platform properties are generally consistent across platform packs. The platform packs to which you install are displayed in the center of the interface. To enable the properties for a platform, select the platform in the list and check its Enable check box. Note that for HP-UX, Versions 10.20, 11.x, and IA64 each have their own listing.

You will need to enter platform-specific property values for each platform on which the JVM should be resolved even if the property settings are identical for each platform. The reason for this is that you may need to have a different search process for each targeted platform.

Property	Description
JVM Search Instructions	Specify the JVMs that should be searched for at run time. If none are located and no bundled JVM is included with this action, an error is logged and the install exits. (On Windows target machines, there is an additional function whereby the end user can select the JVM to be used.) The order in which the JVMs are listed is important. The JVM Search attempts to find a matching JVM beginning with the first JVM specified in the list, and working its way down. Therefore, you should ensure that the JVM you most want to be used is listed first, the next most desired listed second, etc. See JVM Resolution/Search Process for details about this search process. See JVM Resolution/Setting Up a JVM Search for instructions to specify the JVMs that you wish to find.
JVM Resolution	This property determines the execution order of the search. There are two options, and they determine the sequence of the resolution: "Current, Search, Install"—The JVM searched for and located by the JVM searched for and located by the JVM Resolution process for the installation is used process for the installation is attempted to be used first; then an additional search is conducted; lastly, if a bundled JVM was included with this action, it is installed and used. "Search, Current, Install"—The search for a JVM is conducted first, then the JVM searched for and located by the JVM Resolution process for the installation is attempted to be used; lastly, if a bundled JVM was included with this action, it is installed and used.
Bundled JVM Arguments	This optional property enables you to pass arguments to the bundled JVM when it is launched. Examples of arguments (specific to the JVM) include setting the max/min heap size or turning on a trace flag.
Bundled JVM	This property identifies the prepackaged, self-extracting JVM to install. A path variable can also be used for this property.
Timeout	This is the maximum number of seconds that this bean has to resolve a JVM before it stops its search. If it times out, then the JVM Resolution process fails. Set this property to "0" (zero) for the search to never time out, or any number higher than zero to set the actual time before this process times out.
Use Current JVM	If "True," the search is skipped, and the JVM used for the installation is used for the Product Uninstaller JVM Resolution (if configured), any Java application Launcher whose JVM ID property matches the JVM ID property of the Product Uninstaller JVM Resolution, and running the application. If "False", then the search is executed using the properties entered for Search Instructions, Arguments, Resolution, etc.