4.4.6　デバッグをする

(a)　ブレークポイントを設定する

1. ブレークポイントを設定したい行にカーソルを移動させる。

   

2. ［デバッグ］−［ブレークポイントの設定］メニューを選択する。

   カーソルのある行にブレークポイントが設定されます。ブレークポイントは，行の左側にで表示されます。ジョブ定義スクリプトは，ブレークポイントを設定した行の先頭（実行前）まで実行して停止します。

   

(b)　一部のブレークポイントを解除する

1. ブレークポイントを解除したい行にカーソルを移動させる。

   

2. ［デバッグ］−［ブレークポイントの解除］メニューを選択する。

   カーソルのある行のブレークポイントが解除されます。

   

(c)　すべてのブレークポイントを解除する

1. ブレークポイントが設定されているジョブ定義スクリプトを表示する。

   

2. ［デバッグ］−［ブレークポイントをすべて解除］メニューを選択する。

   表示されているジョブ定義スクリプトファイルのブレークポイントがすべて解除されます。

   

注意事項

• 編集モードの場合は，任意の行にブレークポイントを設定できます。デバッグモードの場合，ブレークポイントを設定できるのは，実行対象となっているコマンド，またはステートメント単位に限られます。

• 実行できない行にブレークポイントが設定されている場合は，デバッグモード開始時に，エディタが自動的に下方向に適切な位置を検索して，そこにブレークポイントを設定します。

• ブレークポイントは，999個まで指定できます。

(a)　ブレークポイントまで実行する場合

1. ［デバッグ］−［ブレークポイントまで実行］メニューを選択する，またはツールバーの［ブレークポイントまで実行］ボタンをクリックする。

   JP1/Advanced Shellエディタがデバッグモードになり，デバッグが始まります。次に実行される行の左側には，実行する位置を示す記号（）が表示されます。コメント行やスペース行は無視されます。

   ブレークポイント（）を指定している行まで実行されると，実行が一時的に停止されます。

   

   ブレークポイントの設定方法については，「(1)　デバッグ実行時のブレークポイントを設定・解除する」を参照してください。

2. デバッグを中止したい場合は，［デバッグ］−［デバッグの中止］メニューを選択する，またはツールバーの［デバッグの中止］ボタンをクリックする。

   メニューを選択した時点で，デバッグが中止され，メッセージを出力して後処理をして終了します。プロセス終了前で停止しないでデバッグを終了します。エディタは編集モードに戻ります。

   

(b)　1行ずつ実行（関数の中もステップ実行）する場合

1. ［デバッグ］−［ステップイン］メニューを選択する，またはツールバーの［ステップイン］ボタンをクリックする。

   エディタがデバッグモードになり，デバッグが始まります。次に実行される行の左側には，実行する位置を示す記号（）が表示されます。コメント行やスペース行は無視されます。関数の中も1行ずつ実行します。ジョブ定義スクリプトの最後の行まで実行すると，デバッガのプロセスの終了を示す記号（）が表示されます。

   CUIとは異なって，外部スクリプトを実行する場合，外部スクリプトでは停止しないで，エディタで表示しているジョブ定義スクリプトの次のコマンドで停止します。

   

2. デバッグを中止したい場合は，［デバッグ］−［デバッグの中止］メニューを選択する，またはツールバーの［デバッグの中止］ボタンをクリックする。

   メニューを選択した時点で，デバッグが中止され，メッセージを出力して後処理をして終了します。なお，プロセス終了前で停止しないでデバッグを終了します。エディタは編集モードに戻ります。

   

(c)　1行ずつ実行（関数の中はステップ実行しない）する場合

1. ［デバッグ］−［ステップオーバー］メニューを選択する，またはツールバーの［ステップオーバー］ボタンをクリックする。

   エディタがデバッグモードになり，デバッグが始まります。次に実行される行の左側には，実行する位置を示す記号（）が表示されます。コメント行やスペース行は無視されます。ジョブ定義スクリプトの最後の行まで実行すると，デバッガのプロセスの終了を示す記号（）が表示されます。

   CUIとは異なって，外部スクリプトを実行する場合，外部スクリプトでは停止しないで，エディタで表示しているジョブ定義スクリプトの次のコマンドで停止します。

   

2. デバッグを中止したい場合は，［デバッグ］−［デバッグの中止］メニューを選択する，またはツールバーの［デバッグの中止］ボタンをクリックする。

   メニューを選択した時点で，デバッグが中止され，メッセージを出力して後処理をして終了します。なお，プロセス終了前で停止しないでデバッグを終了します。エディタは編集モードに戻ります。

   

(d)　関数の終わりまで実行する場合

1. ［デバッグ］−［ステップアウト］メニューを選択する，またはツールバーの［ステップアウト］ボタンをクリックする。

   エディタがデバッグモードになり，デバッグが始まります。次に実行される行の左側には，実行する位置を示す記号（）が表示されます。コメント行やスペース行は無視されます。ジョブ定義スクリプトの最後の行まで実行すると，デバッガのプロセスの終了を示す記号（）が表示されます。

   CUIとは異なって，関数に入っていない状態でも，ジョブ定義スクリプトの終わりまでジョブ定義スクリプトを実行します。ただし，関数をリターンするまでにブレークポイントがある場合は停止します。

   

2. 実行中のジョブ定義スクリプトを停止させたい場合は，［デバッグ］−［スクリプトの停止］メニューを選択する，またはツールバーの［スクリプトの停止］ボタンをクリックする。

   ［スクリプトの停止］ボタンをクリックしたときに実行していたコマンドはそのまま実行を続け，次のコマンドの実行に移る前に停止します。

3. デバッグを中止したい場合は，［デバッグ］−［デバッグの中止］メニューを選択する，またはツールバーの［デバッグの中止］ボタンをクリックする。

   メニューを選択した時点で，デバッグが中止され，メッセージを出力して後処理をして終了します。なお，プロセス終了前で停止しないでデバッグを終了します。エディタは編集モードに戻ります。

   

(e)　デバッグ実行時のエラーウィンドウ，ウォッチウィンドウおよびコンソール

• エラーウィンドウ

  デバッグで検出された解析エラーや実行エラーは，エラーウィンドウに表示されます。また，ウォッチウィンドウに追加されている変数の値は，実行停止時に更新されて，表示されます。

  エラーウィンドウについては，「4.7.4　エラーウィンドウ」を参照してください。

  

• ウォッチウィンドウ

  ウォッチウィンドウに表示される変数の値は，ジョブ定義スクリプト停止時に更新して表示されます。ウォッチウィンドウを表示したい場合は，ジョブ定義スクリプト停止中に［表示］−［ウォッチウィンドウを表示］メニューを選択する，またはツールバーの［ウォッチウィンドウを表示］ボタンをクリックしてください。このメニューは，ジョブ定義スクリプト停止中にだけ選択できます。また，ウォッチウィンドウで変数名をダブルクリックすると［値の更新］ダイアログボックスが表示されます。［値の更新］ダイアログボックスは，変数名の値を更新できます。

  ウォッチウィンドウについては，「4.7.6　ウォッチウィンドウ」を，［値の更新］ダイアログボックスの設定方法については，「4.7.8　値の更新ダイアログボックス」を参照してください。

  

• コンソール

  デバッグ実行時に標準出力，標準エラー出力およびジョブ実行ログ相当の情報はコンソールに表示されます。コンソールは，ジョブ定義スクリプトを実行するプロセスが動作している間は表示され，プロセスが終了すると閉じます。ジョブ定義スクリプト実行中はコンソールがアクティブになり，ジョブ定義スクリプト停止時にエディタがアクティブになります。