How do you activate an agent?

Posted on 2001-06-07
Last Modified: 2013-12-18

l have an shared agent built to extract informations for all new inbound mail. l used the setting "After New Mail Has Arrived" and "Newly received mail documents" for the part "When should this agent run?" and "Which document(s) should it act on?" respectively.

The agent works fine, but the only problem is that the agent does not seems to get trigger when there is a new mail coming in. When l refresh the Notes Client, l can see the new mail in the inbox, but somehow the agent did not get trigger. Is there any setting that l must do, or some exception rules on this particular form of triggering that l am not aware of? Right now, l have to open up Designer, highlight the agent, and force it to run.

Any suggestion would be very much appreciated.

Question by:mikeckt

Expert Comment

ID: 6163621
check the field $MachineName in the agent properties (from the list of agents). This field has to be set to the server its running on. If it's not correct create a new agent and just copy-paste the code...
LVL 24

Expert Comment

ID: 6163969
Is this agent run on server or client ???

Do you see any errors ???

Secondly, Do you use any UI functions or objects ???

Read this article. As this helped another person with same kind of question:


Accepted Solution

tgebruik earned 25 total points
ID: 6164564
When you've designed a great agent, what do you do when it won't run?

Follow this link and solve it!!!

Free Tool: Postgres Monitoring System

A PHP and Perl based system to collect and display usage statistics from PostgreSQL databases.

One of a set of tools we are providing to everyone as a way of saying thank you for being a part of the community.


Assisted Solution

by:Jean Marie Geeraerts
Jean Marie Geeraerts earned 25 total points
ID: 6166658
If the client is running on the server you should check the following settings in notes.ini of your server :

Make sure they are all set to 0 in notes.ini to trigger your agent directly after the respective events occur on your server.
The same is valid for an agent running in the client I guess.

Also check if you're running your agent on the server if you have sufficient access to run restricted/unrestricted agents on the server. You can verify this in the server's document on the Security tab.
Under Agent Restrictions, your name or a group you belong to should be entered under Run Restricted LotusScript/Java agents and Run unrestricted LotusScript/Java agents.

Author Comment

ID: 6176298

Thxs for the info.

First, the mail agent run on the server, and it does not have any UI objects or functions. To test the agent is running properly, l initially set it to run manually from the Action menu. When l execute the agent, no error message show up on the screen. Infact, the appropriate record is generated in my Information Collection Notes Database. But when l changed the agent to execute on the arrival of new mail, the agent never seems to get trigger.

Secondly, the field $MachineName in the agent properties is confirmed set to the server of which the agent reside. l have also set the necessary access right in the server document for the necessary personels and groups to  run the restricted/unrestricted LotusScript/Java agents.

l also tried the following parameters in server's notes.ini, but still no result.


Is there a spelling mistake in the parameters "AMGR_NEWMAILAGENTMINITERVAL" and "AMGR_NEWMAILEVENTDALY"? In any case, l have tried setting "AMGR_NEWMAILAGENTMININTERVAL" and "AMGR_NEWMAILEVENTDELAY", and in both cases, nothing happened. By the way, is there any documents on all these agent parameters? Where l can find information on agent parameters?

l have yet to try out using the Agent Manager debugging tool, but should there be any further suggestions would be very much appreciated.

Thxs in advance.

Expert Comment

by:Jean Marie Geeraerts
ID: 6176379
Yep, sorry it should be :

You can set these values by createing a configuration document in the Domino Directory using the Administration client. You can select the values to set from a list.

Open the correct server in the Administration client, select the Configuration tab and then select Server, Configurations in the left pane.
If there is no existing configuration document, click Add Configuration, otherwise just edit the existing document for your server.
In the NOTES.INI Settings tab, click on the Set/Modify Parameters button (only visible when you're editing the document).
In the dialog box, click on the arrow next to the Item field to open a selection list, select the value to set enter the value in the Value field and click on the Next button. If you've set all parameters this way, click on OK.
Save the configuration document and restart the server to have the changes take effect immediately or wait until the changes take effect (the time this takes varies depending on your server configuration).
This way you're sure there are no spelling error.

In effect, what these parameters do is make sure your agent starts immediately when an event occurs and not wait for 5 minutes or half an hour before executing.

Have you also checked if you have sufficient access to execute restricted/unrestricted agents ?

Expert Comment

by:Jean Marie Geeraerts
ID: 6176390
Oops, just reread your comment and looks like you've covered what I suggested. (I was a bit too quick to respond, guess it's a monday thing).
Documentation on NOTES.INI-settings is very difficult to find, best resource is to browse the Notes Gold Forum on

Expert Comment

by:Jean Marie Geeraerts
ID: 6176404
Also, found a link on to a document about Troubleshooting agent problems, maybe this can help you too :

(Sorry, to post this in three comments, but as I said, it's a Monday thing)

Expert Comment

ID: 6178767

To jerrith!!!

I think it's really a monday thing seeing you pointing to the same web site I suggested to solve this problem.. :-))

Expert Comment

by:Jean Marie Geeraerts
ID: 6180133
It happens ;-)
I guess I used the same searchstring on and found the same results, huh ?
LVL 63

Expert Comment

ID: 10412380
No comment has been added lately (983 days), so it's time to clean up this TA.
I will leave a recommendation in the Cleanup topic area for this question:

RECOMMENDATION: split points between tgebruik http:#6164564 and jerrith http:#6166658

Please leave any comments here within next four days.

-- Please DO NOT accept this comment as an answer ! --


EE Cleanup Volunteer

Featured Post

Free Tool: ZipGrep

ZipGrep is a utility that can list and search zip (.war, .ear, .jar, etc) archives for text patterns, without the need to extract the archive's contents.

One of a set of tools we're offering as a way to say thank you for being a part of the community.

Question has a verified solution.

If you are experiencing a similar issue, please ask a related question

Suggested Solutions

For users on the Lotus Notes 8 Standard client, this article provides information on checking the Java Heap size and adjusting it to half of your system RAM in attempt to get the Lotus Notes 8.x Standard client to run faster.  I've had to exercise t…
You’ve got a lotus Domino web server, and you have been told that “leverage browser caching” is a must do. This means that we have to tell the browser everywhere in the web to use cache. In other words, we set (and send) an expiration date in the HT…
Two types of users will appreciate AOMEI Backupper Pro: 1 - Those with PCIe drives (and haven't found cloning software that works on them). 2 - Those who want a fast clone of their boot drive (no re-boots needed) and it can clone your drive wh…

821 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question