Manage Learn to apply best practices and optimize your operations.

Useful Tip To Debug Server Based Agents

This is a programming tip which could help you in debugging server-based agents.

It is often hard to find out what is wrong with an agent that fails to run on schedule on a server but runs when you start them manually. This little script writes all the properties of the agent in the NotesLog.

Just put the code in to of your agent, save the agent, and wait till something pops up in the NotesLog.

Sub Initialize

Dim session As New NotesSession
Dim db As NotesDatabase
Dim theAgent As NotesAgent
Dim agentString As String
Set db = session.CurrentDatabase

Set theAgent = session.CurrentAgent

agentString = db.Title
Print "NotesDatabase.Title properity: " & agentString

agentString = theAgent.Name
Print "NotesAgent.Name properity: " & agentString

agentString = session.EffectiveUserName
Print "NotesSession.EffectiveUserName properity: " &

If session.IsOnServer Then
Print "NotesSession.IsOnServer properity is True"
Print "NotesSession.IsOnServer properity is False"
End If

agentString = session.UserName
Print "NotesSession.UserName properity: " & agentString

If theAgent.IsEnabled Then
Print "NotesAgent.IsEnabled properity is True"
Print "NotesAgent.IsEnabled properity is False"
End If

If theAgent.IsPublic Then
Print "NotesAgent.IsPublic properity is True"
Print "NotesAgent.IsPublic properity is False"
End If

agentString = theAgent.Owner

Print "NotesAgent.Owner properity: " & agentString

End Sub

This was last published in November 2000

Dig Deeper on Lotus Notes Domino Administration Tools

Start the conversation

Send me notifications when other members comment.

By submitting you agree to receive email from TechTarget and its partners. If you reside outside of the United States, you consent to having your personal data transferred to and processed in the United States. Privacy

Please create a username to comment.




  • iSeries tutorials's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...