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?

It's not best practice to write in the log.nsf, an application log is much better. See the OpenLog project at openntf: openntf.org/main.nsf/project.xsp?r=project/OpenLog/summary — Emmanuel Gleizer
@EmmanuelGleizer : Thanks for your prompt reply. I don't write the above error message in the log. That is default format written on the log by agentmanager when agent encounters error. How we can know the scheduled agent hand using lotusscript? — user3493803
My remark about application log was for "2017-03-28 09:39:42 AMgr: Agent ('GoSAP' in '\DomApps\GoSAP.nsf') error message: MQJE001: Completion Code '2', Reason '2033'." I search briefly how to get (programmatically ) the Agent log (but as in experts-exchange.com/questions/20531806/… it doesn't seems to be possible) — Emmanuel Gleizer
@EmmanuelGleizer: I got another idea of getting whether the agent run successfully or not using this notes.ini setting. www-01.ibm.com/support/docview.wss?uid=swg21228274 — user3493803
Yes this is a good idea, especially if you already parse the log.nsf, you will have all the searched information in one place. — Emmanuel Gleizer

Richard Schwartz Richard Schwartz · Accepted Answer · 2017-03-28T18:12:52

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.

How to get default log details of lotusscript agent

2 Answers