Notes.ini Entry


Name:
    JavaUserClasses

Syntax
    JavaUserClasses=Directory

Applies to:
    Servers and/or Workstations

Add-on:

    First Release:
      6.0

    Obsolete since:

      Category:
        Java

      Default:
        None

      UI equivalent:
        None

      Description:
      Specifies where the java user classes are located. By setting this variable, you override a security restriction contained in the agent class loader that does not allow classes with native methods to be loaded. This variable may be set in either or both the client and the server NOTES.INI file.

      For mutiple classes use the syntax: JavaUserClasses=<directory1>;<directory2\jarfile>;<zipfile1>;...

      To install a servlet, whether it is one you wrote or a pre-built one, you create a Servlets subdirectory in the Domino server data directory and copy the compiled servlets into this directory. Then edit the server's Notes.ini file and add a setting for JavaUserClasses to include a path for this subdirectory.

      For example: JavaUserClasses=c:\lotus\notes\data\domino\servlets

      Loading and reloading large Java applets leads to "out of memory" conditions. A workaround is to use JavaUserClasses in NOTES.INI to load all or most of the classes. This ensures the classes are loaded only once, so there is no significant heap size expansion for every applet instance that is loaded.

      Be aware that one drawback to using this variable is that, because it is in the NOTES.INI file, it doesn't replicate. If you have an agent, applet, or servlet that relies on JavaUserClasses, and the database that contains that item replicates somewhere, you have to manually add JavaUserClasses to the NOTES.INI file on the target system or the agent, applet, or servlet won't run. Another drawback is that the variable requires that the user have access to the file system on the server

      Note that you should not enter more than one JavaUserClasses entry in a NOTES.INI file. If you have more than one, only the first will be used; all others will be ignored. If you have multiple uses for JavaUserClasses, enter all the parameters on the same line.

      Keep in mind that there is a 256-byte limit for NOTES.INI entries. Use JavaUserClasses sparingly.

      ND7 Update:

      Allows code-sharing across agents and applets. The value list is a list of directories, JAR files, or ZIP files that are added to the Java Virtual Machine's internal classpath so that classes can be found via the system loader (rather than via attachment to the agent or applet). Note that this doesn't replicate and requires access to the file system on the server.

      Use a semicolon (;) to separate list items for Win32 and OS/2 systems and use a colon (:) to separate list items for UNIX systems; for example, a valid list for Win32 is:

      c:\classes;d:\appxyz\stuff.jar

      ND8 Update:

      Lotus Traveler also needs this variable to be set, and please be aware that this path can not hold any spaces. Be sure convert "Program Files" to "progra~1", and CHECK if this is the correct spelling using a Cmd box and a simple Dir statement.