Agent Data12/09/2005 03:36:52 PM
This little utility allows you to scan a database to identify agent data notes that are no longer being referenced by an agent. Agent data notes are design elements created and used by agents when they run. Lotus identifies a number of technotes related to agent data. One of the issues that can arise is that some databases, over time, can accumulate hundreds of these elements causing the database to grow in size. Since most of these orphaned agent data notes are no longer attached to an agent, they will never be deleted. There is also no easy way to remove them since they do not show up in Designer.

Lotus released a tool to delete these agent notes (
http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg24004199), but you could only run the tool on one database at a time. Our tool does the same thing except that it allows you to run it on an entire directory. This makes the process of cleaning up the databases much easier, since you don't need to know which database to check ahead of time. We are also releasing the source code so that you can tweak the program to best fit your needs.

To run the tool, copy the exe into your Notes or Domino program directory. Open a command prompt and change to that directory.

To scan a database use the following command:
agentdata -v <database.nsf>

A picture named M2

To scan a directory use this command:
agentdata -vd <directory>

A picture named M3

For each database scanned the utility will print a line:

A picture named M4

This means that in names.nsf there was 1 agent data note, with 1 orphan data note (agentdata/orphan). Also at the end you will see something like the following:

A picture named M5

detailing the amount of space used up by both.

For a full list of options, type:
agentdata -h

A picture named M6



Click here to download agentdata.zip

This little utility allows you to scan a database to identify agent data notes that are no longer being referenced by an agent. Agent data notes are design elements created and used by agents when they run. Lotus identifies a number of technotes related to agent data. One of the issues that can arise is that some databases, over time, can accumulate hundreds of these elements causing the database to grow in size. Since most of these orphaned agent data notes are no longer attached to an agent, they will never be deleted. There is also no easy way to remove them since they do not show up in Designer.

Lotus released a tool to delete these agent notes (
http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg24004199), but you could only run the tool on one database at a time. Our tool does the same thing except that it allows you to run it on an entire directory. This makes the process of cleaning up the databases much easier, since you don't need to know which database to check ahead of time. We are also releasing the source code so that you can tweak the program to best fit your needs.

To run the tool, copy the exe into your Notes or Domino program directory. Open a command prompt and change to that directory.

To scan a database use the following command:
agentdata -v <database.nsf>



To scan a directory use this command:
agentdata -vd <directory>



For each database scanned the utility will print a line:



This means that in names.nsf there was 1 agent data note, with 1 orphan data note (agentdata/orphan). Also at the end you will see something like the following:



detailing the amount of space used up by both.

For a full list of options, type:
agentdata -h





Click here to download agentdata.zip
Contact Me
Free tools!
The BlogRoll
Lotus Domino ND6 RSS News Feed netcraft Lotus Geek Chris. A. Brandlehner CoComment Integrated
Monthly Archive
Photo Albums