Appendix I. LaunchAnywhere Executable Properties

The properties that LaunchAnywhere can modify are defined in Table I.1.

Table I.1. LaunchAnywhere Executable Properties
PropertyDefinition
lax.application.nameThis is the name of the application that the launcher executes.
lax.class.pathThis is the classpath for the application. By default, it is set to $IA_CLASSPATH$ (the classpath specified in the InstallAnywhere designer environment). When specifying the classpath, either forward or backward slashes (“/” or “”) may be used as directory separators, and either colons or semicolons may be used for path separators—InstallAnywhere will substitute the proper characters based on the installation platform. Mac end-users should use slashes for directory separators and not colons as InstallAnywhere will treat colons as path separators.
lax.command.line.argsThis is a list of arguments passed to the application's main method. These are specified in exactly the same way they would be on the command line. For example, if the application is invoked as java myApp arg1 arg2, set this property to _arg1 arg2_. Be sure to place quotes around any arguments that have spaces. When it is necessary to pass in an argument that is only known at install time (for instance, the installation directory), use an InstallAnywhere variable.
lax.java.compiler[Runtime only—cannot be set via “Edit Properties...”]: This is the JIT (just-in-time) compiler being used for execution of this application.
lax.main.methodThis is the name of the application's starting method that the LaunchAnywhere executable should invoke.
lax.mainclassThis is the class that gets launched by the LaunchAnywhere executable. This class must contain a method with a name defined by the lax.main.method property.
lax.nl.current.vmThis is the pathname of the VM executable currently being used by this application.
lax.nl.env.<lowercase>

[Windows and UNIX only]: You can access any System Environment variable (for example, access path via $lax.nl.env.path$) by specifying the property name as an all-lowercase string. These properties are resolved at application runtime, when LaunchAnywhere executes. You can also get access to System Environment variables via InstallAnywhere variables.

lax.nl.env.<UPPERCASE>

[Windows and UNIX only]: You can access any System Environment variable (for example, access PATH via $lax.nl.env.PATH$) by specifying the property name as an all-uppercase string. These properties are resolved at application runtime, when Launch-Anywhere executes. You can also get access to System Environment variables via LaunchAnywhere variables.

lax.nl.env.exact_case

[Windows and UNIX only]: You can access any System Environment variable (for example, access Path via $lax.nl.env.exact_ case.Path$) by specifying the property name as a string of the exact case as it is defined in the environment. Note that these properties are resolved at application runtime, when LaunchAnywhere executes. You can also get access to System Environment variables via LaunchAnywhere variables.

lax.nl.env.path[Runtime only—cannot be set via “Edit Properties...”]: This is the system path for the computer this application is running on.
lax.nl.java.compilerThis property defines the name of the JIT compiler that your application should use. If you set this option to no value (i.e., blank), the default JIT will be used. You can also name a specific JIT by defining it in this property. This property should be set to off if no JIT is to be used.
lax.nl.java.launcher.main.classThis is the class that contains the main method called by LaunchAnywhere.
lax.nl.java.launcher.main.methodThis is the name of the main method called by LaunchAnywhere.
lax.nl.java.option.additionalThe value of this property will be written to the command line verbatim. JVM properties or settings not directly supported by current LAX configuration properties can be included as part of the command line used to invoke Java.
lax.nl.java.option.check.sourceThis is set to on or off to tell the VM to verify byte codes.
lax.nl.java.option.debuggingThis turns on debugging in the VM so that an application can be debugged.
lax.nl.java.option.garbage.collection.background.threadThis determines whether to have a low-priority background thread that does garbage collection. It is set to on or off.
lax.nl.java.option.garbage.collection.extentThis is set to one of the following values:

min: Garbage collect everything except classes.

full: Garbage collect everything.

lax.nl.java.option.java.heap.size.initialThis defines the initial heap size for the installer that will be invoked. This number is always specified in bytes, not kilobytes or megabytes, and is analogous to the VM parameter –ms or Xms. The default is 16,777,216 (16MB).
lax.nl.java.option.java.heap.size.maxThis defines the maximum heap size in bytes for the installer that will be invoked. This number is always specified in bytes, not kilobytes or megabytes, and is analogous to the VM parameter -mx or Xmx. The default is 50,331,648 (48MB).
lax.nl.java.option.verboseThis is set to any of the following values:

gc: Output garbage collection messages.

normal: Output all normal verbose messages.

all: Output all normal and garbage collection messages.

none: Do not output any verbose messages.

lax.nl.java.option.verify.modeThis sets when Java will verify classes for security and errors. Values can be remote, all, or none.
lax.nl.message.vm.not.loadedThis is the message to show the end-user in a dialog box if no VM can be found.
lax.nl.valid.vm.listThis is the list of VMs that this LaunchAnywhere executable will allow the Java application to be run against. The value for this property can be any space-delimited combination of the following:

ALL (any VM)

JDK (any Java JDK)

JRE (any Java JRE)

J1 (any Java 1 VM)

J2 (any Java 2 VM)

JRE_J1 (any Java 1 JRE)

JDK_J1 (any Java 1 JDK)

JRE_J2 (any Java 2 JRE)

JDK_J2 (any Java 2 JDK)

MSJ (the Microsoft VM [jview])

The value of this property will also override the value listed in lax.nl.current.vm if the VM listed in that property is not of a valid type. The order of the valid VM list specifies the precedence in which VMs found on the system should be chosen if a valid VM is not listed in lax.nl.current.vm.
lax.nl.win32.microsoftvm.min.versionThis is the minimum version of the Microsoft VM that this LaunchAnywhere executable will find.
lax.resource.dirThis is the platform name in exact case.
lax.root.install.dirThis is the root directory of the entire installation (same as $USER_INSTALL_DIR$).
lax.stderr.redirectThis is the location of your application's stderr output. Set it to null to suppress, console to write to a console window, or any filename to output to a file. Note: If you are specifying a pathname to a Windows file, make sure to use escaped backslashes (i.e., c:\myfolder\output.txt).
lax.stdout.redirectThis is the location of your application's stdout output. Set it to null to suppress, console to write to a console window, or any filename to output to a file. Note: If you are specifying a pathname to a Windows file, make sure to use escaped backslashes (i.e., c:\myfolder\output.txt).
lax.user.dirThis is the end-user directory for your application (represented by “.”). You can also specify any arbitrary absolute or relative path. A relative path is relative to the launcher.
lax.versionThis is LaunchAnywhere's version number.
LISTPROPSThis property lists all system properties available to the Java application (it can take any value.) Stdout and stderr must be redirected to see the results of this output.

..................Content has been hidden....................

You can't read the all page of ebook, please click here login for view all page.
Reset
3.16.66.156