Notes für Linux: LotusScript Remote Debugger

Wie in jeder Programmiersprache treten auch bei der LotusScript- Programmierung Fehler auf. Zu deren Suche und Analyse steht Ihnen mit dem Debugger ein leistungsfähiges Werkzeug zur Verfügung. Seit der Version 6 ermöglicht der Remote Debugger auch das Debugging von serverbasierten LotusScript-Agenten.

Der Debugger ist bei der lokalen LotusScript-Programmierung ein unentbehrliches Werkzeug. Er bietet folgende Möglichkeiten:

  • die schrittweise Abarbeitung des Programmcodes,

  • die zeitweise Unterbrechung der Abarbeitung,

  • im Bedarfsfall das Überspringen von Routinen und Unterprogrammen,

  • das Setzen von Haltepunkten,

  • die Einsicht in die aktuellen Werte der Variablen,

  • die Kontrolle von Programmausgaben,

  • das Nachvollziehen aufgerufener Routinen und Unterprogramme,

  • die Änderung der aktuellen Werte von Variablen zur Beeinflussung der Programmausführung und der Herbeiführung gewünschter Situationen,

  • das Beenden des Debuggings mit der Option, den Debugger sofort zu schließen.

Bis zur Version 5 konnten Sie nur lokalen LotusScript- Programmcode debuggen. Trat der Fehler bei der Ausführung eines serverbasierten Agenten auf, blieb Ihnen nur eine mühevolle Suche von Hand im Programmcode oder der Versuch, die Funktion des Agenten in einem lokalen Szenario nachzuvollziehen.

Seit der Version 6 steht mit der Prozedur des Remote Debugging eine Lösung für derartige Situationen zur Verfügung. Nach dem einmaligen Einrichten des Remote Debugger auf dem Domino Server können Sie serverbasierte Agenten in ihrer echten Umgebung testen.

Führen Sie folgende Schritte aus, um mit dem Remote Debugger LotusScript-Agenten auf dem Server zu testen:

1.Starten Sie den benötigte Server-Task, und richten Sie den Anschluss des Servers ein.

2. Richten Sie den Agenten für das Remote Debugging ein.

3. Starten Sie Ihren Agenten, und greifen Sie auf ihn zu.

Nach der Konfiguration kann jeder, der ausreichende Rechte in der Zugriffskontrollliste der Datenbank, die
den Agenten enthält, und das Recht,zur Ausführung von LotusScript-Agenten auf dem Server besitzt, das Remote Debugging durchführen.

Serverkonfiguration

Für die Ausführung des Remote Debugging wird der Server-Task RDEBUG benötigt. Bevor dieser gestartet werden kann, muss er aktiviert werden. Im Serverdokument des Servers, auf dem der Agent laufen soll, gehen Sie dazu auf folgende Weise vor:

  1. Öffnen Sie den Administrator-Client und wechseln Sie auf das Register Configuration.

  2. Wählen Sie dort in der Ansicht Server/All Server Documents das zu bearbeitende Serverdokument.

  3. Öffnen Sie es im Bearbeitungsmodus, und wechseln Sie auf das Register Server Tasks. Es verfügt über das Unterregister Remote Debug Manager (Bild 1).

  4. Auf diesem wählen Sie im Feld Allow remote debugging on this server den Eintrag Enabled.

Bild 1: Die Einstellungen zum Remote-Debugger.
Bild 1: Die Einstellungen zum Remote-Debugger.

Anschließend können Sie in den Feldern Turnoff Server Debug after und Agent Wait at StartTime weitere Einstellungen für den Task vornehmen. Der erste Wert bestimmt, nach welcher Zeitspanne der Server-Task deaktiviert wird. Bei der Wahl von -1 läuft der Task permanent. Eine Deaktivierung erfolgt in diesem Fall nicht. Der zweite Wert ist für den Start des Remote Debugging wichtig. Nach dem Start des Agenten müssen Sie diesen über ein Dialogfenster einfangen (dazu später mehr). Die Ihnen dabei zur Verfügung stehende Zeitspanne bestimmen Sie mit dem Wert Agent Wait at StartTime.