呼び出し接続機能トレース・メッセージ

呼び出し接続機能 (CAF) を使用して、Db2® に接続するアプリケーションを作成するアプリケーション・プログラマーは、メッセージを表示するかどうかを選択することができます。 CAF 実行中に DSNTRACE ddname が割り振られると、メッセージが表示されます。

プログラム固有のプログラミング・インターフェース情報の開始

次の表は、以下の情報について説明しています。
  • メッセージ番号 (DSNAnnna)
  • メッセージが書き込まれる原因となった CSECT の名前
  • 現在実行されているタスクの TCB アドレス
  • 各メッセージに固有の一連の系列およびトークンの説明
メッセージ・テキスト 説明
DSNACA00 TCB=address ENTERED DSNACA00 ACTION=action R1=address CABPTR=address CABFLAG1=flag1 CABFLAG2=flag2

呼び出し接続機能は、'action' 機能を実行するための呼び出し接続機能要求を受け取りました。 パラメーター・リストは、ロケーション 'address' から開始されます。 CABPTR は、呼び出し接続機能制御ブロック (CAB) のロケーションを指定します。 CABFLAG1 および CABFLAG2 は、現在のフラグ・バイトです。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address LEAVE DSNACA00 CABFLAG1=flag1 CABFLAG2=flag2 CABPTR=address

呼び出し接続機能は、呼び出し接続機能要求が完了した後にこのメッセージを発行します。 CABFLAG1 および CABFLAG2 はフラグ・バイトで、CABPTR は、呼び出し接続機能制御ブロックのロケーションを指定します。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address CONNECT REQUEST SSID=ssid SECBP=ecb address TECBP=ecb address RIBW=address

呼び出し接続機能は、示されたパラメーター値が指定された CONNECT 要求を受け取りました。 SSID はサブシステム ID、SECBP は Db2 開始 ECB アドレス、TECBP は Db2 終了 ECB アドレス、RIBW はフルワードのアドレスで、CONNECT の完了後にリリース情報ブロック (RIB) のアドレスが含まれるように設定されます。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address DISCONNECT REQUEST

呼び出し接続機能は、示された TCB に対する DISCONNECT 要求を受け取りました。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address OPEN REQUEST SSID=ssid PLAN=plan name

呼び出し接続機能は、示された SSID 値および PLAN 値が指定された OPEN 要求を受け取りました。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address CLOSE REQUEST TRMOP=terminate option

呼び出し接続機能は、示された終了オプションが指定された CLOSE 要求を受け取りました。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address BEFORE function ====================

呼び出し接続機能は、Db2 に対する 'function' 要求の前にこのメッセージを発行します。 これが、処理のために制御を Db2 に受け渡す前に実行された最後の呼び出し接続機能アクションです。 これが、異常終了前の最後の呼び出し接続機能メッセージである場合、異常終了は、呼び出し接続機能コードではなく Db2 コードで発生したとほぼ確実に考えられます。

このメッセージは、次のモジュールによって出されます: DSNACA00、DSNACA70

DSNACA00 TCB=address AFTER function ====================

呼び出し接続機能は、Db2 が 'function' 要求の後に制御を返したときにこのメッセージを発行します。

このメッセージは、次のモジュールによって出されます: DSNACA00、DSNACA70

csectname TCB=address FRBP=address RAL=data RALE=data FVLE=data PARM=data PCNT=data

このメッセージとメッセージ DSNA814I には、Db2 に対する呼び出しの前または後の FRB 制御ブロックのコンテンツが表示されます。

このメッセージは、次のモジュールによって出されます: DSNACA00、DSNACA70

csectname TCB=address RC1=retcode RC2=reascode FBACK=feedback RHPC=data QUAL=data RSV1=data

このメッセージとメッセージ DSNA813I には、Db2 に対する呼び出しの前または後の FRB 制御ブロックのコンテンツが表示されます。

このメッセージは、次のモジュールによって出されます: DSNACA00、DSNACA70

DSNACA70 TCB=address FDBKEIB=EIB-address SSID=ssid GATT=group-attach-name GRPN=group-name MBRN=member-name SGATT=subgroup-name

このメッセージには、環境情報制御ブロック (EIB) のアドレスおよびコンテンツが表示されます。 Db2 は、EIB アドレスが 0 ではない場合にこのメッセージを生成します。

DSNACA00 TCB=address IMPLICIT CONNECTION REQUEST

呼び出し接続機能は、Db2 接続を確立する前に SQL 要求を受け取りました。 その結果、デフォルトのアプリケーション・プラン名と (CONNECT が発行されなかった場合は) Db2 サブシステム ID を使用して、Db2 への暗黙接続が確立されます。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address TRANSLATE REQUEST SQLCA=address CABFRC1=retcode CABFRC2=reascode FRBRHPC=frbrhpc

呼び出し接続機能は、TRANSLATE 要求を受け取りました。 このメッセージは、SQLCODE フィールドが設定される SQLCA のロケーション、および変換される戻りコードを識別します。 FRBRHPC がゼロの場合は、変換は実行されません。

DSNACA00 TCB=address CAF READY FOR NEW CONNECTION SERVICE REQUESTS

このメッセージは、前の Db2 接続が終了し、特定のクリーンアップ処理が発生し、呼び出し接続機能が追加の接続要求を処理する準備ができていることを示します。

このメッセージは、モジュール DSNACA70 によって出され、戻りコード (R15) 4 およびコード (R0) 00C10824 が付随します。

DSNACA70 TCB=address CABSSID=ssid CABREL=release CABDECPP=address EIBPARM=EIB-address

このメッセージは、呼び出し接続機能のメイン・ロード・モジュール DSNACAF によってリンク・エディットされた DSNHDECP の現行値をリストします。 これらの値は、暗黙接続要求に対するデフォルトとして使用されます。

DSNACA00 TCB=address BEFORE VALIDITY CHECKING THE type ECB AT ADDRESS location

このトレース・メッセージは、'location' によって識別されたアドレスにアクセス可能かどうかを判別するために、'type' ECB (始動またはシャットダウン) のチェックが間もなく行われることを示します。 0C4 異常終了がこのメッセージの直後に発生した場合、CONNECT 要求に対して無効な ECB アドレスが渡されました。

DSNACA00 TCB=address AFTER VALIDITY CHECKING THE ECB WHICH CONTAINS 'data'

このトレース・メッセージは、示された ECB がアドレス可能であり、示されたデータ値が含まれていることを示します。このメッセージの出現は、渡された ECB アドレスが有効であることを保証するものではありません。予備テストに合格しただけです。Db2 の知識なしにこの ECB を削除すると、ECB が無効なものになります。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address RIB ADDRESS=ribaddr RIBPTR ADDR=ribptr

このトレース・メッセージは、既存の Db2 サブシステム ID に対して接続を試みた後に、Db2 リリース情報ブロック (ribaddr) のアドレス、および RIB (ribptr) を指すフルワードのアドレスをリストします。

このメッセージは、次のモジュールによって出されます: DSNACA70。

DSNACA00 TCB=address R1(FRB)=frbaddr SQLDSECT(FRBPARM)=dsectaddr RDI=rdiaddr SQLCA=sqlcaaddr CABFLAG2=flag2

このトレース・メッセージは、FRB、SQLDSECT、RDI、および SQLCA のアドレスをリストします。 DSNACA00 の呼び出し元 (言語インターフェース (DSNALI)) の AMODE を学習するには、CABFLAG2 フラグ・バイトが便利です。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA00 TCB=address SQLCODE=sqlcode CABFLAG1=flag1 CABFLAG2=flag2

このトレース・メッセージは、SQLCODE と 2 つの接続フラグ・バイトをリストします。

このメッセージは、次のモジュールによって出されます: DSNACA00。

DSNACA70 RELEASE LEVELS NOT COMPATIBLE. CAF=release_level, DB2=release_level

呼び出し接続機能 (CAF) は、Db2 との間でリリース・レベルが非互換であることを検出しました。 CAF コードおよび Db2 サブシステムのロード・モジュールの現行のリリース・レベルが、3 つの数字のストリングとして示されています。3 つの数字は、それぞれ以下の項目を示します。

  • バージョン
  • リリース
  • モディフィケーション・レベル

Db2 サブシステムへの接続が、正常に行われません。 戻りコード 8 および理由コード 00C10831 が、呼び出し元のアプリケーション・プログラムに返されます。

JCL または TSO ログオン手順を使用して CAF を呼び出した場合、JOBLIB 割り振りおよび STEPLIB 割り振りで適切な Db2 ライブラリーが定義されていることを確認してください。 システム・プログラマーによって提供された手順を使用して CAF を呼び出した場合は、システム・プログラマーに確認してください。

問題を判別できない場合は、DSNTRACE DD データ・セットを定義して CAF 実行をトレースすることができます。

両方のリリース・レベル (CAF と Db2) で共存がサポートされていることを確認してください。共存がサポートされている場合は、下位レベルのリリースで、現行の上位レベル・リリースと共存するために必要な、適切な SPE レベル・コードがサポートされていることを確認してください。

プログラム固有のプログラミング・インターフェース情報の終了