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>

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
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