同じエージェントに複数のユーザーが接続してデバッグできます。しかし、デバッグを制御できるのは、一度に 1 ユーザーのみです。2 番目のユーザーは同じエージェントに接続することで制御を取得できます。この機能は、エージェントのデバッグ中に同僚の支援が必要な場合などに便利です。接続してサーバーエージェントをデバッグしてもらえるよう同僚に依頼すると、同僚は物理的にユーザーと同じ場所にいなくても支援を提供できます。ただし、同僚がサーバーに接続し、デバッグを開始した後に元のユーザーがサーバーのデバッグを続行しようとすると、「別のユーザーがエージェントに接続し、制御権を得ています。追加デバッグを行うには、再度接続を試行してください」というエラーが返されます。

リモートデバッガを使用する前に、次のステップを行ってください。

1 サーバーのリモートデバッグを有効化する。

2 エージェントのリモートデバッグを有効化する。

3 リモートデバッガを開始する。

「スケジュールされた LotusScript エージェントをリモートでデバッグする」では、サーバーとエージェントでリモートデバッグを有効化した後のリモートデバッガの使用方法を定義します。

メモ リモートデバッグは Release 6 で新しく追加されたメソッドです。

サーバーのリモートデバッグを有効化する
1 サーバーを開始する前に、サーバーの notes.ini ファイルで次の値を ServerTasks= list: に追加します。

Rdebug

サーバーがすでに稼働している場合、サーバーコンソールに次のコマンドを入力してリモートデバッグタスクを開始します。

load rdebug

ヒント このフィールドを編集するには、サーバーへの管理アクセス権が必要です。

ヒント この値を -1 に設定すると、タスクは永遠に実行を続けます。

5 [ポート] - [インターネットポート] - [Remote Debug Manager] タブをチェックし、TCP/IP ポートステータスプロパティが有効に設定されていることを確認します。

6 エージェントの実行権を持つユーザーとして自分自身がサーバーの [セキュリティ] タブのリストに含まれていることを確認します。

7 サーバー文書を保存して閉じます。

エージェントのリモートデバッグを有効化する
1 [エージェント] インフォボックスの [基本] タブで、トリガーの [スケジュール] ラジオボタンを選択します。[スケジュール] をクリックします。

[エージェントのスケジュール] ダイアログボックスが表示されます。

3 Stop ステートメントを現在のエージェントの Initialize イベントコードの先頭に追加します。Stop ステートメントは次のように機能します。

• リモートデバッガタスクがサーバー上で動作していないか、または有効ではない場合、このステートメントは何も行いません。エージェントの性能は影響を受けません。
• リモートデバッガが動作していて有効である場合、サーバー文書の [サーバータスク] タブ - [Remote Debug Manager] タブで [待ちエージェントの開始時間] フィールドの値が指定されていれば、エージェントの実行をそこで指定された時間だけ一時停止します。これにより、エージェントの実行が始まる前に、リモートデバッガウィンドウでエージェントに接続する時間ができます。
• リモートデバッガウィンドウが開かれ、エージェントに接続済みである場合、Stop ステートメントはブレークポイントと同様に動作し、エージェントの実行を停止します。
ヒント エージェントコードの先頭に次のステートメントを追加して、エージェントが実行準備中であることをコンソールにブロードキャストできます。

Print "AgentName is about to start running****************"

リモートデバッガを開始する
1 デバッグが必要な特定のエージェントを実行するには、次のいずれかの操作を行います。

• [エージェント] インフォボックスの [基本] タブで [スケジュール] ボタンをクリックして、エージェントの実行頻度を高くします。[エージェントのスケジュール] ダイアログボックスで、[エージェントの実行間隔] の時間の値を 0 に、分の値を 5 に変更します。
• サーバーコンソールで次のコマンドを入力します。
tell amgr run databaseName.nsf 'agentName'

ヒント print および stop ステートメントを Initialize イベントの先頭に追加した場合には、エージェントが実行中であることがわかります。print ステートメントにより、エージェントの実行が開始したタイミングと、stop ステートメントによりその実行が遅延されたタイミングがコンソールに出力されます。

Domino Debugger 6 の Welcome ページが表示されます。

[デバッグ対象の選択] ダイアログボックスが表示されます。

サーバー上のデータベースの一覧が表示されます。

デバッグ対象のエージェントが現在実行中である場合には、[デバッグ対象] ボックスに表示されます。

(Options) イベントを含む [スクリプトデバッガ] ウィンドウが表示されます。

スクリプトペインにコードが表示されます。スクリプトの実行がすでに開始されている場合は、次に実行されるコード行を指す黄色の矢印が表示されます。

メモ ブレークポイントを設定するには、実行前に、改ページしたい行をハイライトし、[ファイル] - [ブレークポイントの設定と消去] を選択するか、[F9] キーを押します。

アクションボタン	説明
停止	エージェントコードの実行を、ループ内の行も含む、現在実行中の行で改ページします。デバッガは終了しません。[続行] をクリックして実行を再開できます。
継続	スクリプトペインでコードを実行し、改行が見つかったときのみ停止します。エラー以外の場合には、エージェントコードは最後まで実行されます。
ステップアウト	デバッガでサブプログラム内のコードが実行中の場合に、サブプログラムを終了して呼び出し元のステートメントに戻ります。サブプログラムを呼び出したステートメントが現在のエージェントコードにない場合には、次のブレークポイントに到達するか、エージェントコードが終了するまで実行を続けます。
ステップイン	一度に 1 行ずつステップ単位でコードを実行し、サブルーチンまたは関数に入ります。 メモ 一度に 1 行ずつステップ単位でスクリプトを実行する際に、このボタンを繰り返し使用します。
ステップオーバー	一度に 1 行ずつステップ単位でコードを実行し、sub や function コードが実行されてもサブルーチンまたは関数に入りません。
中止	リモートデバッグ中のサーバータスクを切断します。エージェントコードの実行は中止されます。

ユーザーインターフェース
LotusScript のデバッガの活用