C プログラムを使用する方法

C プログラムを使用して DB2® で Z Abend Investigator を検証するには、データ・セット HFZVPDB2 のサンプル・ジョブ HFZ.SHFZSAM1 を編集し、実行依頼します。詳細については、サンプル・ジョブ内の説明を参照してください。

ジョブは、既にコンパイルされてリンク済みの ODBC C プログラムを実行します。このプログラムは、データ・セット HFZVPDB2 内のロード・モジュール HFZ.SHFZAUTH として提供されています。このプログラムは計画的にシステム異常終了コード S0C4 で異常終了します。

注:

この IVP は、DB2® ODBC IVP に基づいています。これは通常、メンバー DSNTEJ8 (JCL) および DSN8OIVP (C ソース・コード) として DB2® の DSN.SDSNSAMP データ・セット内にあります。この IVP は、DB2® との接続中に故意に異常終了するように変更されています。これにより、Z Abend Investigator が呼び出され、DB2® 情報のレポート・セクションが組み込まれます。Z Abend Investigator バージョンのソース・コードが、参考のために HFZVPDB2 サンプル・メンバーの末尾に用意されています。

TER(UATRACE) LE オプションの結果として、Z Abend Investigator は MVS™ 変更オプション/抑止ダンプ出口 HFZXDCAP から呼び出されます。

Z Abend Investigator に書き込まれた HFZREPRT レポートの概要セクションには、以下が含まれます。

Z Abend Investigator の日本語フィーチャーでは、Language(JPN) オプションが有効である場合、これは日本語になっているはずです。


A system abend 0C4 reason code X'4' occurred in module HFZVPDB2 program HFZVCDB2
at offset X'C74'.

A program-interruption code 0004 (Protection Exception) is associated with this
abend and indicates that:

  A protection exception occurred due to one of the following:

  - An attempt to access a protected storage location using an incorrect storage
    access key.

  - An attempt to store, in the access-register mode, by means of an access-list
    entry which has the fetch only bit set to one.

  - An attempt to store into the range 0-511 or 4096-4607 with low-address
    protection enabled.

  - An attempt to store into a protected page with DAT on.

The abend was caused by machine instruction 50000000 (STORE).

NOTE: Source code information for program HFZVCDB2 could not be presented
      because no compiler listing or side-file data sets were provided. The
      source line # from the GONUMBER option is 123 for offset X'C74'.

この IVP の実行により作成される完全なサンプル・レポートが、HFZ.SHFZDOC1 データ・セット内のメンバー HFZSRP04 として用意されています。

SYSPRINT に書き込まれるデータには、次のものがあります。

HFZVPDB2 INITIALIZATION
HFZVPDB2 SQLAllocEnv
HFZVPDB2-henv=1
HFZVPDB2 SQLAllocConnect
HFZVPDB2-hdbc=1
HFZVPDB2 SQLConnect
HFZVPDB2 successfully issued a SQLconnect
HFZVPDB2 SQLAllocStmt
HFZVPDB2 hstmt=1
HFZVPDB2 successfully issued a SQLAllocStmt
HFZVPDB2 SQLExecDirect
HFZVPDB2 sqlstmt=SELECT * FROM SYSIBM.SYSDUMMY1
HFZVPDB2 successfully issued a SQLExecDirect
HFZVPDB2 SQLFetch
HFZVPDB2 successfully issued a SQLFetch
HFZVPDB2 SQLTransact
HFZVPDB2 successfully issued a SQLTransact
HFZVPDB2 Abend S0C4 to invoke Z Abend Investigator...