How to get default log details of lotusscript agent

Question

I developed an notes application called "agent monitoring" which will trigger email daily when the schedule agent prints an error in the log.nsf file.

2017-03-28 09:39:42 AMgr: Agent ('GoSAP' in '\DomApps\GoSAP.nsf') error message: MQJE001: Completion Code '2', Reason '2033'.

I search for details using an "error message" regular expression string in the log and then send email.

Now I would like to handle when the agent hangs. I think it can be done if we get details from the default agent log as shown here.

Can somebody please guide me on how to achieve this?

Answer 1

The agent log can be accessed this way.

• For eaach database that you are interested in, set up a NotesNoteCollection with SelectAgents=true and call BuildCollection.
• Iterate through the collection with getFirstNoteId/getNextNoteId and get the agent notes via GetDocumentByID
• Use NotesDXLExporter with the agent note as input to generate XML, then parse the XML and read the <trigger type> and/or <agent name> data to determine if you care about the agent. If it's a scheduled agent that you want to monitor, then look at the <runlog> data.