PLI DB2 LUW ストアド プロシージャのデバッグ

PL/I DB2 LUW ストアド プロシージャは、デバッグできます。ただしデバッグは慎重に行う必要があります。処理への影響とセキュリティ上の問題から、DB2 LUW プロダクション サーバーの使用はお勧めできません。ストアド プロシージャをデバッグするには、VM イメージを使用する方法と、DB2 Express-C などのソフトウェアのシングル ユーザー バージョンを開発用ワークステーションで使用する方法があります。

ストアド プロシージャをデバッグする前に、次を行います。

• DB2 LUW ソフトウェアをインストールするとき、すべての DB2 プロセスを開始する ID としてのローカル システム アカウントを使用してソフトウェアをインストールしないでください。DB2ADMIN のデフォルト設定を使用してください。ローカル システム アカウントを使用すると、CodeWatch デバッガーは db2fmp プロセスを正しく接続しません。
• ストアド プロシージャ定義の外部名には必ず大文字を使用し、次のように定義します。

  CREATE PROCEDURE GETPRML
   (IN PROCNM CHAR(18) 
   ,IN SCHEMA CHAR(8)  
   ,INOUT OUTCODE INTEGER 
   ,INOUT PARMLST CHAR(26) 
   )
    LANGUAGE COBOL
    DETERMINISTIC
    READS SQL DATA
    NO DBINFO
    FENCED
    NOT THREADSAFE
    EXTERNAL NAME "GETPRML!GETPRML"  
    PARAMETER STYLE GENERAL  
    PROGRAM TYPE SUB
    RESULT SETS 0;

• PL/I プログラムの PROC 文では、EXTERNAL パラメーターを使用しないでください。使用する場合は、このコードを次のようにコメント アウトします。

  PROC(PROCNM, SCHEMA, OUTCODE, PARMLST); /* EXTERNAL('getprml'); */

• ストアド プロシーアをデバッグのためにビルドしてリンクします。コマンドは次のようになります。

  mfplx -sql db2 -optsql db=sample -deb -coffdebug -defext getprml.pli -c –ppsql

  SET LINK=-DEBUG

  cbllink /d /V /K getprml.obj db2api.lib mfplimd.lib systemsql.obj setupdeffiles.obj

• DLL、STB、PDB の各ファイルを \sqllib\function ディレクトリにコピーします。環境変数 LINK=-DEBUG を設定すると、STB ファイルが作成されます。
• ストアド プロシージャを実行してロードします。たとえば、ストアド プロシージャを呼び出す DB2 コマンドを使用します。
• Enterprise Developer コマンド プロンプト (32 ビット) を ADMINISTRATOR として開きます。
• CODEWATCH_SRCPATH および CODEWATCH_STBPATH の環境変数を、\sqllib\function ディレクトリに設定します。次に例を示します。

  set CODEWATCH_SRCPATH=C:\Program Files\IBM\SQLLIB\FUNCTION

  set CODEWATCH_STBPATH=C:\Program Files\IBM\SQLLIB\FUNCTION

• ストアド プロシージャをロードした DB2 LUW プロセスの PID を探します。db2fmp.exe を検索します。

  db2fmp.exe は 32 ビット バージョンであるため、64 ビット バージョンの DB2 LUW をインストールしている場合は探しやすくなります。

  ここで使用できるツールとしては PSLIST があり、www.sysinternals.com の PsTools のダウンロード ページから入手できます。次のコマンドを実行します。

  PSLIST DB2FMP

  64 ビットの DB2 LUW を使用している場合、実行結果は次のようになります。

  Name         Pid Pri Thd  Hnd   Priv       CPU Time    Elapsed Time
  db2fmp64    2240   8   9  211  16660    0:00:00.655     0:00:50.512
  db2fmp64    2240   8   9  211  16660    0:00:00.655     0:00:50.512
  db2fmp64    2056   8   4  143  10888    0:00:00.046     0:00:15.241
  db2fmp      2528   8   3  117  12172    0:00:00.140     0:00:15.163

  db2fmp に複数の PID が表示される場合はそれらを 1 つずつ実行して、どれがデバッグ対象のストアド プロシージャかを判定します。また CTF トレースを使用しても、どの PID が使用されているかを判定できます。

• Enterprise Developer 32 ビット コマンド プロンプトに java -jar <installation path>/cw_java.jar -pid nnnn を入力します。ここで、nnnn は PID 番号です。たとえば上記の最後に表示されている PID を使用すると、コマンドは次のようになります。

  java –jar <installation path>/cw_java.jar –pid 2528

  [CodeWatch] ウィンドウが表示されます。

• [Actions] メニューから [Shared Library] を選択し、デバッグするストアド プロシージャの .dll 名を入力し、[OK] をクリックします。次に例を示します。

  

• Env ドロップダウンにストアド プロシージャの proc 名を入力して、ソース シンボルをロードします。次に例を示します。

  

• デバッガーを停止する行にブレークポイントを設定します。これを行うには、行番号をダブル クリックします。たとえば、行 15 をダブル クリックすると、行 15 で実行が停止します。

  

• [CodeWatch] ウィンドウで、[Continue] () をクリックして再びストアド プロシージャが呼び出されるまで待ちます。
• 別のプロセスで再びストアド プロシージャを呼び出します。
• [CodeWatch] デバッグ ウィンドウに戻ります。正しいプロセスに接続している場合は、設定した行のブレークポイントでデバッガーが停止します。

  これでデバッグのタスクを実行し、コード内の変数とステップ実行を検証できます。デバッグから戻った後、ストアド プロシージャ呼び出しの結果を呼び出しプロセスで利用できます。