DDF エラー・メッセージ

分散要求は、いくつかの理由で正常に実行されない可能性があります。

  • ローカル DDF が開始されません。
  • リモート DDF が開始されません (リモート・システムが Db2® である場合)。
  • リモート・システムが開始されません。
  • VTAM® LU がアクティブではありません。
  • VTAM パス・エラーが発生しました。
  • VTAM 障害が発生しました。
  • セッションまたは会話の障害が発生しました。
  • Db2 コミュニケーション・データベース項目が誤っています。
  • セキュリティー障害が発生しました。
  • TCP/IP 障害が発生しました。

DDF のリソース使用不可メッセージ

分散環境における一部のエラーでは、Db2 ユーザーまたはアプリケーションは、以下を受け取ります。

     SQLCODE -904; RESOURCE UNAVAILABLE

SQLCA では、ユーザーに Db2 理由コード、使用できないリソースのタイプを示すコード、およびリソース名が返されます。 分散データ機能の理由コードは、'00D3' から始まります。

分散環境におけるエラーの RESOURCE TYPES は、以下のとおりです。

  • 00001000 DDF
  • 00001001 システム会話
  • 00001002 エージェント会話
  • 00001003 CNOS 処理
  • 00001004 コミュニケーション・データベース
  • 00001005 データベース・アクセス・エージェント
  • 00001007 TCP/IP ドメイン・ネーム
  • 00001008 TCP/IP サービス名

VTAM リソース情報

VTAM 接続の場合、RESOURCE NAME には、以下のものがあります。

  • LU 名
  • VTAM ログオン・モード名
  • VTAM 戻りコード
  • SNA センス・データ。

Db2 エラー・メッセージには、以下の 4 つの VTAM 戻りコードが表示されます。

  • RTNCD: VTAM 1 次戻りコード
  • FDBK2: VTAM 2 次戻りコード
  • RCPRI: APPC 1 次戻りコード
  • RCSEC: APPC 2 次戻りコード

SNA センス・データは、長さが 4 バイトで、以下から構成されます。

  • バイト 0 + 1: センス・コード: カテゴリー (バイト 0) と修飾子 (バイト 1)
  • バイト 2 + 3: センス・コード固有の情報
図 1. SNA センス・データ
図の説明の始め。この図は、センス・データのバイト 0 とバイト 1 を示しています。バイト 0 はカテゴリーで、バイト 1 は修飾子です。
図の説明の終わり。

SNA センス・データのカテゴリーには、以下のものがあります。

  • X'00': ユーザー・センス・データのみ (LU 6.2 はなし)
  • X'08': 要求拒否
  • X'10': 要求エラー
  • X'20': 状態エラー
  • X'40': 要求ヘッダー (RH) 使用エラー
  • X'80': パス・エラー

RTNCD に '00' が含まれており、FDBK2 に '0B' が含まれている場合、要求された VTAM 関数が正常に完了しておらず、RCPRI および RCSEC を分析する必要があります。 SNA センス・データと一緒に使用することで、問題を識別することができます。

図 2. VTAM 環境における Db2 DDF エラー・メッセージ -- リソースが使用不可
  CNOS processing for LU 'LUDBD1' (which is DB2 system 'SYDNEY') and VTAM logon
  mode 'SYSTOSYS' was unsuccessful.  The VTAM return codes must be analyzed:
   --------------------------------------------------------------------------------
   SELECT * FROM SYDNEY.SYSIBM.SYSCOLUMNS;
   --------------------------------------------------------------------------------
   DSNT408I SQLCODE = -904, ERROR:  UNSUCCESSFUL EXECUTION CAUSED BY AN
            UNAVAILABLE RESOURCE. REASON 00D31029, TYPE OF RESOURCE 00001003, AND
            RESOURCE NAME LUDBD1.SYSTOSYS.00.0B.0008.0001.08570003
   DSNT415I SQLERRP = DSNLXCNV SQL PROCEDURE DETECTING ERROR
   DSNT416I SQLERRD = 900  0  0  0  0  0 SQL DIAGNOSTIC INFORMATION
   DSNT416I SQLERRD = X'FFFFFC7C'  X'00000000'  X'00000000'  X'00000000'
            X'00000000'  X'00000000' SQL DIAGNOSTIC INFORMATION
   ----------------------------------------------------------------------------------
   DSNE618I ROLLBACK PERFORMED, SQLCODE IS 0
   DSNE616I STATEMENT EXECUTION WAS SUCCESSFUL, SQLCODE IS 0
   --------------------------------------------------------------------------------
    The DB2 error message is shown below:
   DSNT408I SQLCODE = -904, ERROR:  UNSUCCESSFUL EXECUTION CAUSED BY AN
            UNAVAILABLE RESOURCE. REASON 00D31029, TYPE OF RESOURCE 00001003,AND
            RESOURCE NAME LUDBD1.SYSTOSYS.00.0B.0008.0001.08570003
  SQLCODE -904, RESOURCE UNAVAILABLE, tells that the SQL statement
  could not be executed, because a specific resource was not available at the
    time the statement was executed:
           +------------------------------------------------------------+
   DSNT408I|SQLCODE = -904, ERROR:  UNSUCCESSFUL EXECUTION CAUSED BY AN |
           |                     +--------------------------------------+
           |UNAVAILABLE RESOURCE.|
           +---------------------+
    DB2 reason code X'00D31029' tells that the requested VTAM function to allocate
    a conversation failed (VTAM returned a non-zero return code):
           +---------------+
           |REASON 00D31029|
           +---------------+
    Code '00001003' defines the resource type of 'CNOS processing':
           +-------------------------+
           |TYPE OF RESOURCE 00001003|
           +-------------------------+
    Because the VTAM function to perform CNOS processing failed,
    the specific resource name must be analyzed.
    The combination of RTNCD/FDBK2 '00/0B' tells that the VTAM function
    was unsuccessful and the APPC codes should be analyzed.
    The combination of RCPRI/RCSEC '0008/0001' tells that a conversation
    cannot be allocated.  The SNA SENSE field '08570003' tells that the
    SSCP-SLU session is not active.
    In other words, DDF of 'SYDNEY' is not active.
           +------------------------------------------------------+
           |RESOURCE NAME LUDBD1.SYSTOSYS.00.0B.0008.0001.08570003|
           +------------------------------------------------------+
                            |       |      |  |   |    |      |
                            |       |      |  |   |    |      |
    LUNAME <----------------+       |      |  |   |    |      |
    Logon Mode Name <---------------+      |  |   |    |      |
    RTNCD (VTAM primary return code) <-----+  |   |    |      |
    FDBK2 (VTAM secondary return code) <------+   |    |      |
    RCPRI (APPC primary return code) <------------+    |      |
    RCSEC (APPC secondary return code) <---------------+      |
    SENSE (SNA sense code) <----------------------------------+

TCP/IP リソース情報

TCP/IP 接続の場合、RESOURCE NAME には、以下のものがあります。
  • 表 SYSIBM.IPNAMES 内の列 LINKNAME の値
  • 表 SYSIBM.IPNAMES 内の列 IPADDR の値
  • ソケット呼び出し gethostbyname または getservbyname からの TCP/IP エラー・コード
リソースが TCP/IP ドメイン・ネームである場合、あるいは
  • 表 SYSIBM.LOCATIONS 内の列 LOCATION の値
  • 表 SYSIBM.LOCATIONS 内の列 PORT の値
  • ソケット呼び出し gethostbyname または getservbyname からの TCP/IP エラー・コード
リソースが TCP/IP サービス名である場合。

TCP/IP および Db2 エラー・メッセージの例

次の図は、ローカル Db2 サブシステムがリモート Db2 サブシステムへの接続を試行したがリモート・システム上で DDF がダウンしていた場合に、z/OS® コンソール上で受け取るメッセージの例を示しています。

図 3. z/OS コンソール上の Db2 および TCP/IP エラー・メッセージの分析
 DSNL511I ? DSNLIENO TCP/IP CONVERSATION FAILED
            TO LOCATION STLEC1B
            IPADDR=9.112.126.120 PORT=447
            SOCKET=CONNECT RETURN CODE=1128 REASON CODE=12F80291

メッセージ DSNL511I は、TCP/IP CONNECT ソケット呼び出しが失敗したことを示します。 CONNECT 呼び出しは、ローカル Db2 のソケットとリモート Db2 のソケットの間の接続を確立します。 IPADDR 値および PORT 値は、リモート Db2 の値です。