Notes für Linux: LotusScript Remote Debugger

Remote Debugging ausführen

Für die Ausführung und Überwachung von serverbasierten Agenten ist der Agent-Manager zuständig. Dahinter verbirgt sich der Server-Task AMGR. Für seine Steuerung stehen verschiedene Befehle zur Verfügung (Tabelle 1). So ist auch der Start eines Agenten über einen Konsolenbefehl des Agent-Managers möglich. Geben Sie dazu auf der Serverkonsole den Befehl

tell amgr run "<NameDerDatenbank>" '<NameDesAgenten>'

ein. Achten Sie dabei auf die Anführungszeichen.

Tabelle 1: Die Steuerungsbefehle für den Agent-Manager.

Befehl

Aktion

tell amgr -?

Dieser Befehl zeigt eine Hilfe zu den verschiedenen Konsolenbefehlen des Agent-Managers an.

tell amgr cancel
<NameDerDatenbank>
<NameDesAgenten>

Der Befehl bricht die Ausführung des geplanten Agenten ab. Der Name des Agenten und der Datenbank, in welcher er sich befindet, werden als Parameter angegeben.

tell amgr debug

Die Debug-Einstellungen des Agent-Managers werden in der Datei notes.ini festgelegt. Alternativ können Sie diese Einstellungen auch über die Serverkonsole vornehmen. Mögliche Parameter sind unter anderem:
p – Agentenleistungsstatistiken werden ausgegeben.
r – Berichten über die Agentenausführungen werden ausgegeben.
r – Ausgabe von Zeitplanungsinformationen

tell amgr run
<NameDerDatenbank>
<NameDesAgenten>

Der Befehl startet den angegebenen Agenten.

tell amgr pause

Für zeitgesteuerte Agenten können Sie mit diesem Befehl die Zeitplanung außer Kraft setzen.

tell amgr quit

Der Befehl beendet die Ausführung des Agent-Managers auf dem Server.

tell amgr resume

Zur Reaktivierung der Zeitplanung der Agenten nutzen Sie diesen Befehl.

tell amgr schedule

Dieser Befehl erzeugt einen Bericht, welcher die Namen aller für den aktuellen Tag geplanten Agenten enthält. Weiterhin werden der Auslösetyp, die Uhrzeit für die Ausführung und die Datenbank angegeben, in welcher die einzelnen Agenten laufen. Die auszuführenden Agenten werden in so genannte Warteschlangen unterteilt. Dabei werden ausführbare Agenten (Kennzeichen E), zur Ausführung geplante Agenten (S) und Ereignissensitive Agenten, die auf das Eintreten des Ereignisses warten (V) unterschieden. Mögliche Auslösertypen sind: Ausführung des Agenten ist geplant (S), Agent wird von neuer Mail ausgelöst (M) und Agent wird durch das Erstellen und Ändern von Dokumenten ausgelöst (U).

tell amgr status

Zur Ausgabe der Einstellungen des Agent-Managers im Serverdokument sowie der aktuellen Warteschlangen verwenden Sie diesen Befehl.