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

制限事項：本トピックは、Windows 環境 (ローカル開発) にのみ該当します。

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] デバッグウィンドウに戻ります。正しいプロセスに接続している場合は、設定した行のブレークポイントでデバッガーが停止します。
これでデバッグのタスクを実行し、コード内の変数とステップ実行を検証できます。デバッグから戻った後、ストアドプロシージャ呼び出しの結果を呼び出しプロセスで利用できます。

このトピックに関するフィードバックを送信

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

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