IBM Support

Compact agent tool to delete orphaned agent data notes

Downloadable files


Abstract

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.

Download Description

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.

Prerequisites

Technote: "Orphaned agent data notes cause performance problems" (#1101603).

URL LANGUAGE SIZE(Bytes)
Orphaned Agent Data Notes Cause Performance Problems US English 5000

Installation Instructions


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]

where
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


Examples:

When running the utility against a local database, type the following at the c:\Notes prompt:

Compagnt c:\Notes\Data\Database.nsf

When running the utility against a server database, type the following at the c:\Notes prompt:

Compagnt ServerName!!SubDir\Database.nsf

Download package

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
Notes4645_CompAg.zip 10/04/2002 US English 52235 FTP
Notes45x_CompAg.zip 10/04/2002 US English 20693 FTP
Notes41x_CompAg.zip 10/04/2002 US English 23885 FTP

Cross reference information
Segment Product Component Platform Version Edition
Messaging Applications Lotus End of Support Products Lotus Domino 7.0, 6.5, 6.0

Product Alias/Synonym

Lotus Notes Client


Document information

More support for: Lotus End of Support Products
Lotus Notes

Software version: 5.0, 6.0, 6.5, 7.0

Operating system(s): Windows, iOS

Reference #: 4004199

Modified date: 31 October 2005