(QA) Db2 for i にACSからSQL実行した際のエラーを調べたい

ACSその他SQLインターフェースからSQL実行してエラーが発生した際、下記のようにエラー表示がされます。

今回のSQLの例ではDb2 for i のテーブルを作成しています。

SQL状態:38501
メッセージ:CPF7302 とあるので、DSPMSGDコマンドで、CPF7302を調べると、、

DSPMSGD RANGE(CPF7302) 

・・・この例では、CPF7302はエラーが出ましたよ、という最後のエスケープメッセージで、この前にエラーの原因メッセージがあるはずです。。

一番上の画像のようにACS SQLスクリプト実行画面などでは一瞥でそのメッセージを調べることが出来ない場合があります。

IBM i の外からのSQLを受け取って処理するサーバージョブ（デーモン）はQZDASOINITジョブ、このジョブログを調べればよい

というのがヒントになります。

上記例ではACSの一番下の行を見ると、、

このSQLを処理した、IBM i 側のジョブ名が分かります。例では 328469/QUSER/QZDASOINIT だと分かります。また、ユーザーID(ユーザープロフィール）GOMAから実行されたというのもわかります。

ジョブログを調べる方法①　超レガシー編

男は黙って WRKACTJOBコマンド な世代はこれでよいと思います。
QUSRWRKサブシステム下のQZDASOINITを探します。通常複数個のQZDASOTINI ジョブが上がってるはずなので一個一個シラミツブシます。

※WRKACTJOB -> QZDASOINITを探して -> OPT.5 でジョブ表示 -> 　から
ジョブ／ユーザー／番号　が一致する行を探します。

いずれ辿り着きますが、オールド感が漂いますね・・(^^;

ジョブログを調べる方法②（レガシーだけどもGUI編）

WRKACTJOBコマンドの代わりに Navigator for i はちょっとナイスなLooksです♪

Navigator for i からアクティブ・ジョブ -> ジョブ情報の処理 を選択します。

Navigator for i だとフィルターできるのが便利ですね。ジョブ名をQZDASOINITでフィルターします。

***・・・ですが、ジョブ番号がデフォルトだと表示されないので、表示に追加します。

表の右上のカラム数 をクリックして、ジョブ番号を探すと・・・

「数値」というがジョブ番号のようです。(^^;　数値を選んで、右側のボックスに移します。

ジョブ番号が表示されました。

上記から、ACS SQLスクリプト実行画面に表示されていたジョブ番号328469を探して、ジョブログを表示します。

右クリックして、ジョブ・ログを選択します。

ジョブログを見ると、ACSに表示のエラーCPF7302の前（Navigator for i画面上では１行下）にCPF5813 ファイルが既に存在している、というエラーが出ています。これがSQLのエラーだったようです。

※Navigator for i ではカラムごとにフィルター設定ができるので、例えば重大度や（メッセージの）タイプなどで絞り込むと判別がしやすいと思います。

ジョブログを調べる方法③（モダンにシュッとSQLで一発編）

・・コメント欄みていただけますと筆者も気が付かなかったことがお分かりいただけましょう‥(^^;
人間の思考が一番レガシーなんですね♪、心に刻み自分の思考モダナイゼーションにムチ打ちたいと思います♪

IBM i サービス：JOBLOG_INFO テーブル関数 を使用します。

ACS SQLスクリプト実行その他、IBM i接続してSQL投げられるインターフェースから、下記を実行します。

例1 : 基本形 QZDASOINITの該当ジョブのジョブログをすべて取得

※注：以下のサンプルはこれより上のサンプルとジョブ番号が変わっています。

SELECT * FROM TABLE(QSYS2.JOBLOG_INFO('328898/QUSER/QZDASOINIT'));

実行結果例はこちら、

このジョブが接続されてからのログ一式出力するので見づらいですね。
日付・時刻でフィルターでもいいですし、ここでは、重大度（SEVERITY) 20以上　＝　エラーとなるメッセージレベル以上　出フィルターします。

例2 : 応用形その1 該当するQZDASOINITジョブの重大度20以上を取得

SELECT * FROM TABLE(QSYS2.JOBLOG_INFO('328898/QUSER/QZDASOINIT')) WHERE SEVERITY >= 20 ;

実行結果例は...

行が絞られ大分見やすいですが、肝心のメッセージテキストははるか右スクロールの彼方のようです。

手元に（左に）呼び寄せます。

例3 : 応用形その2 該当するQZDASOINITジョブの重大度20以上を取得、必要なカラムに表示を絞る

SELECT MESSAGE_ID, MESSAGE_TYPE, MESSAGE_SUBTYPE, SEVERITY, MESSAGE_TEXT, MESSAGE_SECOND_LEVEL_TEXT 
FROM TABLE(QSYS2.JOBLOG_INFO('328898/QUSER/QZDASOINIT')) 
WHERE SEVERITY >= 20

実行結果は...

これなら一瞥できますね。
方法②と同じ結果が、SQL 1つでシュッと取得できました♪