You can use a property in the NOTES.INI file to specify JVM Properties for the Domino server. The property JavaUserOptionsFile specifies a text file which contains the properties to add to the JVM. This text file can be either ASCII or EBCDIC and have up to 256 properties specified. Each entry must be in the form of "property=value" and be on a separate line.
Java JVM property settings are applied on a per Domino server basis.
Any property that can be set with the -D Java option is valid. Domino already provides a way of adjusting the stack sizes, etc.
If Domino specifies a property, and that property is also specified in the JavaUserOptionsFile, the JavaUserOptionsFile value is used. For example, if Domino specifies the property "Foo=1", and the JavaUserOptionsFile specifies "Foo=2", the JVM is created with "Foo=2".
There are currently 2 exceptions to this: java.class.path and java.library.path. Domino will link the values specified in the JavaUserOptionsFile to what Domino is already setting for these two properties.
Multiple Domino servers can share the same options file.
One use of this feature is easier enablement of Java applications that have native methods. In order for the System.load() or System.loadLibrary() to find the service program, that service program must be in the current path. In this case, the administrator would have to know what directories the Domino for iSeries code uses. With this change, the administrator can set the JavaUserOptionsFile in the NOTES.INI and in the referenced file specify "java.library.path=/QSYS.LIB/PGMAPP.LIB" where PGMAPP.LIB is the library containing the service program loaded by the java application.
In the server's NOTES.INI the following line is added:
The file "/PGMApp/JvmOptions.properties" could have the following:
As of Domino 8.5.2 you can also use syntax like this::
Enhancement in release 8.5.2:
In Domino 8.5 and 8.5.1, the option -D was prepended to each line in the file.
For 8.5.2, this NOTES.INI setting has been enhanced to allow arbitrary user input of options.
For backward compatibility, -D continues to be prepended to any line that begins without a hyphen, and that contains "=", but any line that does begin with a hyphen will be passed to the JVM as is.
For example, if the options file contains four lines:
then three options are now passed to the JVM:
None, although you can specify this setting in the NOTES.INI Settings tab of the Configuration Settings document in the Domino Directory.
Lotus Notes/Domino 6.0
Note: Until Domino 8.0, this setting applied only to OS400, but in 8.0 was enhanced to work on all Domino platforms. For details, see the following technote:
Does the JavaUserOptionsFile parameter work with platforms other than AS400?