AS400のSQL0501を調べる|RPGのOPEN・FETCH・CLOSEと最初の失敗

SQL0501(SQLSTATE 24501)は、開いていないカーソルをFETCHやCLOSEで参照したときの診断です。まず同じ実行のログを時刻順に並べ、OPENが成功したか、どの操作から状態がずれたかを確認します。最初から開いていなかった場合と、開いた後に閉じた場合では調べる場所が違います。

呼出しの順序と状態を並べる

段階 成功時の扱い 失敗時に確認すること
OPEN 取得を開始できる 元の診断と対象SQLを保持する
FETCH 取得した行を処理する 終端と異常を区別する
CLOSE 開いた資源を閉じる 後片付けの診断で主原因を隠さない

IBMはFETCHを、カーソルの位置を使って行を取得する処理として説明しています。IBM:Retrieving a row using a cursor

処理の概念は次のようになります。実行用のRPGコードではありません。

OPENを実行する
  成功した場合だけFETCHへ進む
  OPEN失敗なら診断を保持して異常経路へ進む
FETCHする
  行あり → 処理して次の取得へ
  終端   → 正常な取得終了へ
  異常   → 部分処理の扱いを決める
この経路で開いているカーソルを後片付けする

終端は、すべての失敗と同じではない

対象0件が正常な仕様なら、最初から行がないことを異常にしません。一方、取得中の変換エラーなどを終端と同じ扱いにすると、途中までの結果を全件と誤認します。

出力CSVなら、取得した件数と正常終了した状態の両方が必要です。部分CSVの扱いとつなげて設計します。

SQLの診断は、後続処理の前に保存する

OPEN失敗後に別のSQLを実行すると、見ている診断が後続SQLのものになることがあります。調べる処理の直後に、SQLSTATEや必要な診断を対象操作と結び付けて記録します。

ログは「SQLエラー」だけでなく、OPEN・FETCH・CLOSEの区別、実行の識別、取得済み件数を持たせます。SQL文や値を無制限に出すのではなく、秘密や業務データを避けます。

前回の値を、今回の取得結果にしない

行を取得できなかった経路で、前回のホスト変数を処理していないかも確認します。初期化だけに頼らず、「今回取得に成功した」ことを処理の条件にします。

また、コミットや呼出し終了とカーソルの寿命は設定・方式により確認が必要です。同じ名前だから同じ寿命だと判断せず、実際の生成条件と呼出し経路を調べます。

SQL0501に関するIBMのメッセージ資料も、OPENの実施やカーソルが閉じられる条件を確認するよう案内しています。IBM:SQL messages and codes 利用中のリリースのメッセージ詳細と生成条件も確認します。

最初の失敗を見失う経路を、模擬ログで再現する

以下は自作の模擬ログです。実機のジョブログではなく、RPG・SQLの実行も未実施です。エラーを一律に無視する例ではなく、どの診断を主原因として保持するかを検討します。

例1:OPEN失敗の後でFETCHしてしまう

確認番号 T01
01 OPEN  : 失敗。元の理由を保存
02 FETCH : 未OPENのまま実行して追加の診断
03 CLOSE : 未OPENのまま実行して追加の診断

最後のCLOSEだけ直すと、OPEN失敗と無条件FETCHが残ります。改修後の期待は、OPEN失敗を取得の主原因として保持し、この経路で開いていないカーソルを無条件にFETCH・CLOSEしないことです。ほかの経路で開いた資源がある場合の後片付けまで省く、という意味ではありません。

模擬入力 期待する制御 利用者へ返す結果
OPEN失敗 取得へ進まず、元の診断を保持 取得失敗。0件正常とは区別
OPEN成功、最初のFETCHが終端 正常な取得終了へ進む 正常0件
2行取得後、次のFETCHが異常 取得を打ち切り部分結果を識別 全件成功にしない
全件取得後、後片付けだけ失敗 取得結果と後片付けの失敗を両方保持 無条件の正常完了にしない

例2:連続呼出しで前回値を使わない

一回目は1行あり、二回目は0行という模擬応答にします。二回目の期待は「正常0件」で、一回目の値をもう一度CSVへ出さないことです。取得成功を条件に処理する箇所と、ホスト変数を使う箇所を対応づけて点検します。

実機試験へ進む場合は、単独の検証プログラムと自作データを使い、正常複数行・0行・安全に作れる失敗条件・連続呼出しを確認します。SQL0501の診断だけでOPEN失敗と決めず、CLOSQLCSRやコミット、呼出し境界で閉じた可能性も確認します。模擬ログで分岐を確認できても、実際のカーソル寿命を検証したことにはなりません。

関連する確認手順