Notes.ini Entry


Name:
    JavaUserOptionsFile

Syntax
    JavaUserOptionsFile=Path/Filename

Applies to:
    Servers - I5/OS

Add-on:

    First Release:

      Obsolete since:

        Category:
          Java

        Default:
          None

        UI equivalent:
          None

        Description:
        A new property in the NOTES.INI file can be used to specify JVM Properties for the Domino server. This new 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.

        Domino for i5/OS : Java JVM property settings 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".

        Note 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.

        For example:

        In the server's NOTES.INI the following line is added:

        JavaUserOptionsFile=/PGMApp/JvmOptions.properties

        The file "/PGMApp/JvmOptions.properties" could have the following:

        java.library.path=/QSYS.LIB/PGMAPP.LIB
        java.class.path=/PGMApp/bin/PGMApp.jar
        PGMApp.debug=0
        PGMApp.serverName=Server1

        Associated SPRs: CCAL5G52KL