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: センス・コード固有の情報

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 センス・データと一緒に使用することで、問題を識別することができます。
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 エラー・コード
- 表 SYSIBM.LOCATIONS 内の列 LOCATION の値
- 表 SYSIBM.LOCATIONS 内の列 PORT の値
- ソケット呼び出し gethostbyname または getservbyname からの TCP/IP エラー・コード
TCP/IP および Db2 エラー・メッセージの例
次の図は、ローカル Db2 サブシステムがリモート Db2 サブシステムへの接続を試行したがリモート・システム上で DDF がダウンしていた場合に、z/OS® コンソール上で受け取るメッセージの例を示しています。
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 の値です。