Notes.ini Entry


Name:
    JavaCompilerTarget

Syntax
    JavaCompilerTarget=Number

Applies to:
    Servers

Add-on:

    First Release:
      8.0

    Obsolete since:

      Category:
        Java

      Default:
        The default behavior is equivalent to a JavaCompilerTarget=1.2 setting.

      UI equivalent:
        None

      Description:
      The JavaCompilerTarget INI setting lets you use features specific to different Java Development Kits (JDKs). You can set this variable to any value between 1.1 and 1.6, and then restart the client or server for this change to take effect. In each case, the "-source" flag is the latest source that can be specified with a particular "-target" flag.

      You can also specify JavaCompilerTarget=CurrentJavaVersion. In this case, the target flag is synched to the Java version included in future Notes/Domino releases. For example, if a future Notes/Domino version were to include JDK 1.9, then values from 1.1 - 1.9 would be supported and the parameter, JavaCompilerTarget=CurrentJavaVersion, would create "-target 1.9".

      If you use a value not shown below, the Java Debug console displays the usage guideline, "Warning: Invalid use of notes.ini variable JavaCompilerTarget ..." and substitutes the default value, JavaCompilerTarget=1.2.

      If JavaCompilerTarget=
      The resulting compiler flags are...
      ...And the agent would run on
      Notes/Domino releases...
      1.1
      -source 1.3 -target 1.1
      N/D 5.0 or later
      1.2
      -source 1.3 -target 1.2
      N/D 6.0 or later
      1.3
      -source 1.3 -target 1.3
      N/D 6.0 or later
      1.4
      -source 1.4 -target 1.4
      N/D 7.0 or later
      1.5
      -source 1.5 -target 1.5
      N/D 8.0 or later
      1.6
      -source 1.6 -target 1.6
      N/D 8.5 or later
      CurrentJavaVersion
      -source 1.6 -target 1.6
      N/D 8.5 or later

      These settings might prevent compiled agents from running on some earlier Notes/Domino installations (and with any Java Virtual Machine [JVM] version earlier than the target flag), regardless of whether the new language features are actually used in the agent's code.

      For example, setting the JavaCompilerTarget=1.6 could introduce the possibility of having an agent recompiled and replicated to a V8.0 server and then failing to run. Additionally, problems could arise editing and saving agents compiled in Notes/Domino installations that are not using the same notes.ini file setting. Therefore, it is suggested that organizations use a consistent setting across machines.

      Developers who will not be using language features specific to later JDKs are encouraged to keep the default Notes/Domino behavior to maximize backward compatibility.