Title:
Notes.ini Variables for iNotes Web Access
Product: Lotus iNotes > Lotus Domino Web Access > 6.x, 5.x
Platform(s): Platform Independent
Document Number: 1089521 Date: 19.01.2004
This document is based on the following :
About SPRs
Problem
What Domino server Notes.ini variables affect Domino Web Access (a.k.a. iNotes Web Access)?
Note: Notes.ini parameters applicable to Domino Web Access 6.5 and 6.0.3 (and higher) are appended to the bottom of this technote.
Note: Notes.ini parameters are case sensitive on Unix platforms.
An article exists on the Lotus Developer Domain (
www.lotus.com/ldd) site which contains information regarding Notes.ini variables that affect iNotes Web Access. The version of this article as of January 10, 2003 is copied below. However, please keep in mind that the article may be updated on LDD when new variables are introduced. The most current version of the article can be accessed at the following URL:
http://www-10.lotus.com/ldd/today.nsf/54dd141eed99bf278525697a00561a66/5036a5bc34265e6b85256be6001dc5fa?OpenDocument<< beginning of article >>
Variables that affect iNotes Web Access
Many customers have found Lotus iNotes Web Access an extremely useful new product. Thousands of people now use iNotes Web Access to open their Notes mail files through a Web browser. Amid all the excitement, however, administrators and technical users have started asking the inevitable question: How does iNotes Web Access affect my NOTES.INI file? This month's edition of Ask Professor INI is devoted to answering this question.
Q. Which server NOTES.INI variables affect iNotes Web Access?
When discussing NOTES.INI variables related to iNotes Web Access, it's important to distinguish between two types of settings:
New variables introduced with iNotes Web Access
Existing variables that have to be set a particular way so that iNotes Web Access runs properly
Most new variables are readily identified by the fact their names begin with iNotes_WA, for example iNotes_WA_MessageFormat. The majority of these are undocumented and/or unsupported variables, so if you encounter an iNotes Web Access variable not listed in this article, don't change it unless told to do so by Lotus Support.
Note: All iNotes Web Access variables must be set on the Domino server on which the Notes mail files reside. Do not add them to the user's local NOTES.INI file on the Notes client. Doing so will have no affect on iNotes Web Access and may cause Notes to run incorrectly.
New iNotes Web Access variables
The following lists new NOTES.INI variables introduced to support iNotes Web Access. Note that most of these variables have not been documented, although we do support them with all the usual caveats about exercising caution when modifying your NOTES.INI, of course.
iNotes_WA_DisableActCntSecurity
First available in 5.0.8, this variable enables/disables the iNotes Web Access Active Content Filter. A setting of 1 disables the filter. Setting this variable to 0 (or omitting it from the server's NOTES.INI file) enables the filter. By default, this variable is set to 0.
iNotes_WA_NameLookupMaxNumMatch
First available in 5.0.9, this variable specifies the maximum number of names to return on a name validation. The default is 200.
iNotes_WA_LogoutRedirect
First available in 5.0.10, this variable specifies the URL to redirect users to after logging out from the server, doing normal cache clearing with the iNotes control, and clearing browser credentials. This variable allows sites that have additional actions that need to happen on a logout (such as logging out from a reverse proxy server) to specify a URL to do this additional activity. Or you can use this variable to return people to an initial login page. This variable has no default value.
iNotes_WA_MessageFormat
First available in 5.0.11, this variable determines whether to use the plain text editor or the rich text editor when composing mail messages. Setting this to 1 forces all users on the server to use the plain text editor only. By default, this variable is set to 0.
Existing iNotes Web Access related variables
In addition to the above, there are two existing NOTES.INI variables important to the successful operation of iNotes Web Access.
$DolsDirectoryCatalog
First available in 5.0.10, this variable specifies the name of the Domino Directory the user can take off-line. When this variable is set, an option appears on the user preference interface. For example, if NOTES.INI contains $DolsDirectoryCatalog=catalog.nsf, the user sees a new preference setting, "Include server's Name and Address Book." If the user enables this setting, the server's catalog.nsf will be included among the files when the user goes off-line. This variable is actually part of Domino Off-Line Services (DOLS). iNotes Web Access uses DOLS to allow users to work off-line. This variable has no default value.
Log_DirCat
First available in 5.0, this variable logs information about the Directory Cataloger task to the Miscellaneous Events view of the log file (LOG.NSF). This lets you monitor the Directory Catalog build process. This is a standard Domino NOTES.INI setting, described in the Domino Administrator's Guide. Set this to 1 for iNotes Web Access. This variable has no default value.