Skip to main content

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

  • Close [x]

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

  • Close [x]

Ask Professor INI: More on memory management and other questions

Professor INI, Professor, IBM Lotus
Professor INI has been writing about Notes.ini variables since Notes/Domino 5. When he's not writing, Professor INI enjoys reading product documentation and perusing the Lotus knowledge base for tech notes.

Summary:  A reader sets Professor INI straight on PercentAvailSysResources (Professor INI knows all too well that no one has all the answers), and the Professor tackles questions on Notes 6 INI variables, mail sound settings, and relocating bookmarks.nsf.

Date:  31 Oct 2006 (Published 15 Sep 2003)
Level:  Introductory
Also available in:   Russian

Activity:  5307 views
Comments:  

Although Ask Professor INI is presented as a monthly column, in some respects, it also serves as a forum. In addition to Notes.ini questions, readers on occasion also send in very useful information-to describe a mystery variable that stumped Professor INI, to provide additional information about a point we covered earlier, or even to correct a mistake that may have appeared in this space (even professors don't know everything). Professor INI greatly encourages this sort of interactive dialog. We've taken some good-natured ribbing from colleagues over the years who have accused Professor INI of being obsessed with the Notes.ini file and all its myriad wonders. However, Professor INI knows all too well that no one has all the answers for so large and dynamic a topic, so all contributions and clarifications you can provide are welcome. (A Business Partner even sent in an entire Notes database of Notes.ini information he had collected recently.)

This month Professor INI talks a bit more about managing memory with PercentAvailSysResources before answering several questions you've sent us over the past few weeks.

More on managing memory with PercentAvailSysResources

The August 2003 installment of Ask Professor INI included a brief mention of PercentAvailSysResources, one of the more widely used and discussed, undocumented Notes.ini variables in existence. PercentAvailSysResources helps control memory management in Domino releases through R5.0.11. Reader Scott Hopper of IBM pointed out that there's more to say about this variable than we've previously covered. This variable (originally introduced to allow quick adjustment for multiple partitions and to deal with problems on small memory and mixed-use machines) defines the percentage of physical memory that Domino uses to calculate how to size certain memory allocations.

For example, suppose you're running Domino on a server with two partitions with different workloads, and you want one partition to use 60 percent of the resources and the second to use 40 percent. To do this, set PercentAvailSysResources=60 in the first partition's Notes.ini file and PercentAvailSysResources=40 in the second partition's Notes.ini.

In large memory systems, PercentAvailSysResources can also be used to:

  • Prevent Domino from oversizing its memory usage and running into other problems
  • Tune performance

This variable defines the maximum size of the NSF buffer pool. This size also determines the values for other substantial memory uses.

Note that in R5.0.12 and later (including Domino 6), the use of the PercentAvailSysResources variable is discouraged. This variable is usually overridden by the default value (automatically calculated by Domino based on maximum shared memory for the platform), unless the maximum NSF buffer pool size defined by PercentAvailSysResources is larger than the default.

For more information on PercentAvailSysResources, see Scott's Performance Perspectives column, "Configuring Domino 5 for AIX/pSeries in large physical memory environments," published in the January 2003 issue of LDD Today.


And now a few questions...

The remainder of this column provides answers to a few questions readers have submitted recently.

Q. Where can I get a definitions list of all Notes.ini entries available for the Notes 6 client?

As we mentioned in our very first Ask Professor INI column, there is no complete compendium of Notes.ini variables. The Notes and Domino documentation is a good start, but it doesn't take much searching through your Notes.ini file before you begin discovering variables for which there is no documentation. Some of these are deliberately undocumented-they're temporary variables designed for quick-fix or debugging purposes, and they're dynamic, so changing them is meaningless (and potentially dangerous). On the other hand, at least some uncovered variables probably should be included in the documentation.

Since our first column nearly three years ago, a number of sources providing Notes.ini information has appeared on the Web. For example, the Notes.ini reference provided by DRCC offers a great deal of Notes.ini information, including descriptions of undocumented variables. You can use this reference in conjunction with a free tool called Configuration Manager for Notes from Wolcott Systems Group. This tool lets you view a sorted list of variables in your Notes.ini file. You can select a variable, and then click a provided link to view information on the variable in the DRCC Notes.ini reference. (You can also use this tool to compare two Notes.ini files. This allows you to see the differences between a Notes.ini configuration that's working and one that isn't.)

These and other Web sources can help augment the Notes/Domino documentation (although as with any Web content, complete accuracy cannot be guaranteed in every case). However, Professor INI is unaware of any complete, definitive list of all client and server variables. (Given the mercurial nature of Notes.ini variables, which can come and go without warning from one release to the next, it probably would be very difficult to keep such a list up-to-date.)

One final note: The first Ask Professor INI column mentioned the Admin Best Practices forum as a good source of Notes.ini information for Business Partners. This forum is no longer available. However, much of the information it contained has been incorporated into the product documentation.

Q. I have a program called Random Event Sounds (no longer produced that I can find), and it worked quite well with R4.6. It randomly picks sounds at intervals that the user can specify. I would like to make it work with R5 or Notes/Domino 6. I tried adding the line Incoming Mail Sound=RES2000.exe to my Notes.ini file, but that doesn't work. Any idea how I can get Notes to use the RES2000 as my mail sound?

You're on the right track, but there are a few things you may want to check. First, be sure to specify the complete pathname of your sound file in this setting. It's possible Notes simply can't find the file. Also, you mention that you're trying to get your sound file to work in both (or either) R5 or Notes/Domino 6. The Incoming Mail Sound variable doesn't work in R5; instead, use the NewMailTune variable. Also, be sure you're changing your client's Notes.ini file rather than the server's. (This may sound overly basic, but it's an easy mistake to make.) If you are running Notes/Domino 6, you may want to avoid fooling with Notes.ini altogether and instead, set this through the Play a Sound field on the Mail tab in the User Preferences dialog box (File - Preferences - User Preferences - Mail).

Q. I have a client experiencing very slow response. I looked at the Notes.ini file and found Console_Nupdate=80 300 7 22 29 691 367. What is the purpose of this on a client machine?

Professor INI can find no reference for Console_Nupdate (or any other similarly named variable). Can another reader help shed some light on this mystery?

Q. I know that desktop.dsk can be put in another location than the Notes\data directory and pointed to in Notes.ini with the desktop variable. Is this also possible with mail.box, smtp.box, and bookmark.nsf?

This question seems to pop up in one form or another fairly frequently (twice this past month alone). In two previous Notes.ini columns, we explained that there is no variable for specifying the location of your bookmark.nsf file as there is for desktop.dsk. The same is true for mail.box and smtp.box-Professor INI is not aware of any Notes.ini variables for controlling the location of these.

Do you have a Notes.ini question? Send it in to Professor INI. We'll answer as many questions as we can in future "Ask Professor INI" columns. Keep in mind, however, that we may not be able to answer every question, nor can we quickly respond to requests that require immediate attention. If you need an immediate response to a question, we recommend you post it in the Notes/Domino 6 Forum or Notes/Domino 4 and 5 Forum where someone from the general Notes community might be able to help, or contact Lotus Support Services.


Resources

About the author

Professor INI has been writing about Notes.ini variables since Notes/Domino 5. When he's not writing, Professor INI enjoys reading product documentation and perusing the Lotus knowledge base for tech notes.

Report abuse help

Report abuse

Thank you. This entry has been flagged for moderator attention.


Report abuse help

Report abuse

Report abuse submission failed. Please try again later.


developerWorks: Sign in


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


Rate this article

Comments

Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Lotus
ArticleID=12730
ArticleTitle=Ask Professor INI: More on memory management and other questions
publish-date=10312006
author1-email=
author1-email-cc=

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

For articles in technology zones (such as Java technology, Linux, Open source, XML), Popular tags shows the top tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), Popular tags shows the top tags for just that product zone.

For articles in technology zones (such as Java technology, Linux, Open source, XML), My tags shows your tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), My tags shows your tags for just that product zone.

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Try IBM PureSystems. No charge.

Special offers