Compact agent tool to delete orphaned agent data notes
The Compact Agent tool cited below is provided "as is", unsupported; any problems with the tool should not be reported back to Lotus since it is an unsupported tool.
Important Note: The Compact Agent tool cited below is provided "as is", unsupported. Any problems with the tool should not be reported back to IBM/Lotus since it is an unsupported utility.
The utility does two things: deletes orphaned Agent Data Notes, and optionally fixes up damaged agents. In the case when the number of orphaned Agent Data Notes gets so large that it is impossible to open the database, it is possible to damage the agent's persistent data. If you run the utility to remove the orphaned Agent Data Notes, and are able to open such a database, you will not be able to either save or execute the damaged agents.
When the Agent Manager tries to load the damaged agent it will display the following error message on the server console:
"File object is truncated - file may have been damaged."
If you run the utility with an optional flag 'f' (for fix), it will clean out the garbage from the persistent data which will enable you to edit and run these agents.
The error message usually associated with this issue will be one of the following:
"Insufficient Memory: too many Design elements (Desk design pool)"
"The maximum space for display of views, forms, macros and shared fields has been exceeded for this database. Please delete some of them"
"Memory Allocation Request Exceeded 65,000 bytes"
Note: Use the information in this document in conjunction with the document, "Orphaned Agent Data Notes Cause Performance Problems" (#1101603). See the Install Instructions section below for a link to this document.
Technote: "Orphaned agent data notes cause performance problems" (#1101603).
|Orphaned Agent Data Notes Cause Performance Problems||US English||5000|
There must be at least one shared LotusScript agent in the database for this utility to function and delete orphaned Agent Data Notes. This is because Agent Data Notes are created only for LotusScript agents, and this utility compares the Agent Data Notes to existing Script agents to find and remove orphans.
The Compact Agent Program can be run only from a Win32 client; however, it can be run on a local database or a database on a server. To run it on a server database, you use the syntax Server!!dbname.nsf. Here are the details:
1. Click on the link or navigate to one of the following URLs, depending on your version of Notes:
Notes 4.6x, 5.x, 6.x, 7.x Clients: ftp://public.dhe.ibm.com/software/lotus/tools/notes/Notes4645_CompAg.zip
Notes 4.5x Clients: ftp://public.dhe.ibm.com/software/lotus/tools/notes/Notes45x_CompAg.zip
Notes 4.1x Clients: ftp://public.dhe.ibm.com/software/lotus/tools/notes/Notes41x_CompAg.zip
2. Download this file to your local drive.
3. Unzip the file.
4. Copy the Compagnt.exe file to your Notes Program directory
5. Open/run a DOS prompt and switch to your Notes Program directory. For example: cd c:\Notes
6. Run the utility from the DOS prompt by typing: compagnt file [-f]
file = fully qualified path to your database. For example: c:\Notes\Data\Database.nsf or ServerName!!SubDir\Database.nsf
[-f ] is the optional fix parameter
When running the utility against a local database, type the following at the c:\Notes prompt:
When running the utility against a server database, type the following at the c:\Notes prompt:
|Download||RELEASE DATE||LANGUAGE||SIZE(Bytes)||Download Options|
|Messaging Applications||Lotus End of Support Products||Lotus Domino||7.0, 6.5, 6.0|
Lotus Notes Client
More support for:
Lotus End of Support Products
Software version: 5.0, 6.0, 6.5, 7.0
Operating system(s): Windows, iOS
Reference #: 4004199
Modified date: 31 October 2005