GET_CONFIG ストアード・プロシージャー
GET_CONFIG ストアード・プロシージャーは、データ・サーバー構成情報を取得します。
このデータ・サーバー構成情報には、以下の情報が含まれます。
- データ共用グループ情報
- Db2 サブシステム状況情報
- Db2 サブシステムパラメータ、DSNHDECPまたはユーザー指定のアプリケーションデフォルトモジュール、IFCID 106セクション5に記載されている パラメータ IRLM
- Db2 分散アクセス情報
- アクティブ・ログ・データ・セット情報
- Db2 の最後の再始動の時刻
- リソース限定機能情報
- Db2 サブシステム情報に接続済み
GET_CONFIG ストアード・プロシージャーは SBCS CCSID のみをサポートします。 つまり、すべてのデータ (入出力) は Unicode CCSID 367 でなければなりません。
カタカナ CCSID 290 のサポートは制限されています。 xml_input 文書で指定されるユーザー固有の情報 ( DB2 Data Sharing Group Membersのストリング入力など) には、有効な EBCDIC CCSID 37 文字のみが含まれている必要があり、これらの EBCDIC 文字は Unicode CCSID 367 で存在している必要があります。 同様に、Unicode CCSID 367 に変換されて xml_output 文書に書き込まれる要求情報には、有効な EBCDIC CCSID 37 文字のみが含まれている必要があり、これらの EBCDIC 文字は Unicode CCSID 367 に存在している必要があります。
環境
GET_CONFIG ストアード・プロシージャーは、WLM で確立されたストアード・プロシージャーのアドレス・スペースで実行されます。
許可
CALL ステートメントを実行するには、CALL ステートメントを含むパッケージまたはプランの所有者が、以下の特権または権限の 1 つ以上を持っている必要があります。
- GET_CONFIG ストアード・プロシージャーに対する EXECUTE 特権
- ストアード・プロシージャーの所有権
- 以下の権限のいずれか。
- システム DBADM
- SYSOPR
- SYSCTRL
- SYSADM
構文
スキーマは SYSPROC です。
オプションの説明
- MAJOR_VERSION
- 文書のメジャー・バージョンを示す タイプ INTEGER の入出力パラメーターです。 入力パラメーターの場合は、ストアード・プロシージャーのパラメーター (xml_input、xml_output、および xml_message) として渡される XML 文書でサポートするメジャー文書バージョンを示します。 ストアード・プロシージャーは指定したバージョンのすべての XML 文書を処理するか、バージョンが無効である場合はエラー (-20457) を戻します。
出力において、このパラメーターは、プロシージャーによってサポートされている最も高いメジャー文書バージョンを指定します。 サポートされる文書の最も高いバージョンを判別するには、この入力パラメーターおよびその他すべての必須パラメーターに NULL を指定します。 現在、サポートされている最大のメジャー・ドキュメント・バージョンは 2 です。 メジャー・ドキュメント・バージョン 1 もサポートされます。
XML 入力 パラメーターの XML 文書で Document Type Major Version キーが指定されている場合、そのキーの値は メジャー・バージョン パラメーターで指定されている値と等しくなければなりません。等しくないと、エラー (+ 20458) が発生します。
このパラメーターを使用するときには、minor_version パラメーターも使用します。 したがって、両方のパラメーターを一緒に指定する必要があります。 例えば、両方のパラメーターに NULL を指定するか、または両方のパラメーターに NULL 以外の値を指定する必要があります。
- MINOR_VERSION
- 文書のマイナー・バージョンを示すタイプ INTEGER の入出力パラメーターです。 入力パラメーターの場合は、ストアード・プロシージャーのパラメーター (xml_input、xml_output、および xml_message) として渡される XML 文書でサポートするマイナー文書バージョンを指定します。 ストアード・プロシージャーは指定したバージョンのすべての XML 文書を処理するか、バージョンが無効である場合はエラー (-20457) を戻します。
出力において、このパラメーターは、サポートされている最も高いメジャー・バージョンでサポートされている、最も高いマイナー文書バージョンを指します。 サポートされる文書の最も高いバージョンを判別するには、この入力パラメーターおよびその他すべての必須パラメーターに NULL を指定します。 現時点では、サポートされる唯一のマイナー文書バージョン (最大バージョン) は 0 です。
XML 入力 パラメーターの XML 文書で Document Type Minor Version キーが指定されている場合、そのキーの値は マイナー・バージョン パラメーターで指定されている値と等しくなければなりません。等しくないと、エラー (+ 20458) が発生します。
このパラメーターを使用するときには、major_version パラメーターも使用します。 したがって、両方のパラメーターを一緒に指定する必要があります。 例えば、両方のパラメーターに NULL を指定するか、または両方のパラメーターに NULL 以外の値を指定する必要があります。
- リクエストされたロケール
- ロケールを指定するタイプ VARCHAR(33) の入力パラメーターです。 指定した言語がサーバーでサポートされている場合は、変換された内容が xml_output および xml_message パラメーターに戻されます。 サポートされていなければ、内容はデフォルトの言語で戻されます。 ロケールから使用されるのは、言語 (および場合によっては地域情報) のみです。 ロケールは数字のフォーマット設定に使用されたり、文書エンコードに影響を与えたりすることはありません。 例えば、キー名は翻訳されません。 XML 出力および XML メッセージ文書の変換された部分は、Display Name、Display Unit、および Hintのみです。 該当する場合は値が各国語に翻訳されます。 要求される言語と、XML 出力文書で使用される言語を常に比較してください (XML出力文書の Document Locale エントリーを参照)。
現在、requested_locale でサポートされている値は en_US および NULL です。 NULL 値を指定した場合、結果は en_US を指定した場合と同じになります。
- xml_input
- ストアード・プロシージャーの入力値が記述されている UTF-8 の Data Server Configuration Input タイプの XML 入力文書を指定する、タイプ BLOB(2G) の入力パラメーターです。
XML 入力文書をストアード・プロシージャーに渡すには、major_version パラメーターに 2 を指定し、minor_version パラメーターに 0 (ゼロ) を指定する必要があります。
非データ共用システムの場合、バージョン 2.0 XML 入力文書の例は次のようになります。<plist version="1.0"> <?xml version="1.0" encoding="UTF-8" ?> <dict> <key>Document Type Name</key> <string>Data Server Configuration Input</string> <key>Document Type Major Version</key> <integer>2</integer> <key>Document Type Minor Version</key> <integer>0</integer> <key>Document Locale</key> <string>en_US</string> <key>Complete</key><false/> <key>Optional Parameters</key> <dict> <key>Include</key> <dict> <key>Value</key> <array> <string>DB2 Subsystem Status Information</string> <string>DB2 Subsystem Parameters</string> <string>DB2 Distributed Access Information</string> <string>Active Log Data Set Information</string> <string>Time of Last DB2 Restart</string> <string>Resource Limit Facility Information</string> <string>Connected DB2 Subsystem</string> </array> </dict> </dict> </dict> </plist>データ共用システムでは、バージョン 2.0 XML 入力文書のサンプルは次のようになります。<plist version="1.0"> <?xml version="1.0" encoding="UTF-8" ?> <dict> <key>Document Type Name</key> <string>Data Server Configuration Input</string> <key>Document Type Major Version</key> <integer>2</integer> <key>Document Type Minor Version</key> <integer>0</integer> <key>Document Locale</key> <string>en_US</string> <key>Complete</key><false/> <key>Optional Parameters</key> <dict> <key>Include</key> <dict> <key>Value</key> <array> <string>Common Data Sharing Group Information</string> <string>DB2 Subsystem Status Information</string> <string>DB2 Subsystem Parameters</string> <string>DB2 Distributed Access Information</string> <string>Active Log Data Set Information</string> <string>Time of Last DB2 Restart</string> <string>Resource Limit Facility Information</string> <string>Connected DB2 Subsystem</string> </array> </dict> <key>DB2 Data Sharing Group Members</key> <dict> <key>Value</key> <array> <string>DB2A</string> <string>DB2B</string> </array> </dict> </dict> </dict> </plist>XML 入力文書をストアード・プロシージャーに渡す場合は、Document Type Name キーを指定する必要があります。 非データ共用システムでは、Include パラメーターを指定する必要があります。 データ共用システムでは、少なくとも次のいずれかのパラメーターを指定する必要があります。- Include
- DB2 Data Sharing Group Members
XML 入力文書をストアード・プロシージャーに渡さない場合で、major_version パラメーターを 2、minor_version パラメーターを 0 (ゼロ) として指定した場合、ストアード・プロシージャーは、デフォルトで非データ共用システムの次のパラメーターをバージョン 2.0 XML 出力文書で返します。- DB2 Subsystem Status Information
- DB2 Subsystem Parameters
- DB2 Distributed Access Information
- Active Log Data Set Information
- Time of Last DB2 Restart
- Resource Limit Facility Information
- Connected DB2 Subsystem
バージョン 2.0 XML 入力文書をストアード・プロシージャーに渡した場合、ストアード・プロシージャーは、情報をバージョン 2.0 XML 出力文書で返します。 返される情報は、Include 配列および DB2 Data Sharing Group Members 配列 (該当する場合) で指定した内容に応じて異なります。 非データ共用システムの場合、Include 配列で指定されている項目が返されます。 データ共用システムの場合、次の情報が返されます。- Include パラメーターと DB2 Data Sharing Group Members パラメーターの両方が指定されている場合、DB2 Data Sharing Group Members 配列に指定されている各 Db2 メンバーの Include 配列に指定されている項目。
- Include パラメータのみが指定されている場合、データ共有グループ内の Db2 メンバーごとに Include 配列で指定されている項目。
- DB2 Data Sharing Group Members パラメーターのみが指定されている場合、DB2 Data Sharing Group Members 配列に指定されている各メンバーの Common Data Sharing Group Information および以下の項目。
- DB2 Subsystem Status Information
- DB2 Subsystem Parameters
- DB2 Distributed Access Information
- Active Log Data Set Information
- Time of Last DB2 Restart
- Resource Limit Facility Information
- Connected DB2 Subsystem
注： Include 配列で Common Data Sharing Group Information 項目が指定されている場合、この情報はデータ共有グループに対して1回のみ返されます。 この情報は、処理される Db2 のメンバーごとに繰り返し返されるものではありません。完全モード： 非データ共有システムでストアドプロシージャが完全モードで実行されている際に、 xml_outputパラメータによって返されるバージョン 2.0 のXML入力ドキュメントの例については、例のセクションの例4 を参照してください。 2人の Db2 メンバー、 DB2A および DB2B が参加するデータ共有システムで、ストアドプロシージャが完全モードで実行されている際に、 xml_outputパラメータによって返されるバージョン 2.0 のXML入力文書の例については、例5 を参照してください。
- xml_filter
- 有効な XPath 照会ストリングを指定する UTF-8 のタイプ BLOB(4K) の入力パラメーターです。 XML 出力文書から単一値を検索する場合、フィルターを使用します。 詳細については、 出力をフィルタリングするためのXPath式を参照してください。XML 出力文書から Data Server Product Version の値を選択する例を以下に示します。
キーの後に兄弟が指定されていないと、エラーが戻されます。/plist/dict/key[.='Data Server Product Version']/following-sibling::string[1] - xml_output
- Data Server Configuration Output タイプの完全な XML 出力文書 (UTF-8) を戻すタイプ BLOB(2G) の出力パラメーターです。 フィルターが指定されている場合、このパラメーターはストリング値を戻します。 ストアード・プロシージャーが完全な出力文書を戻すことができない場合 (例えば、処理エラーが発生して SQL 警告やエラーが出される場合など)、このパラメーターは NULL に設定されます。
xml_output パラメーターは、指定された major_version パラメーターと minor_version パラメーターに基づいて、バージョン 1.0 またはバージョン 2.0 の XML 出力文書を戻します。 バージョン 2.0 XML 出力文書の内容に関する情報については、xml_input パラメーターのオプションの説明を参照してください。
バージョン 1.0 のXML出力文書のサンプルについては、例のセクションの例1 を参照してください。
データ共有システム以外のバージョン 2.0 のXML出力文書のサンプルについては、 例6 を参照してください。
データ共有システムにおけるバージョン 2.0 のXML出力文書のサンプルについては、 例7 を参照してください。
- xml_メッセージ
- Data Server Message タイプの完全な XML 出力文書 (UTF-8) を戻すタイプ BLOB(64K) の出力パラメーターです。この XML 出力文書には、SQL 警告状態に関する詳細情報が記述されています。 この文書が戻されるのは、ストアード・プロシージャー呼び出しの結果 SQL 警告が発生し、追加情報が XML メッセージ出力文書に戻されていることが警告メッセージで示されている場合です。 追加情報が戻されることを警告メッセージが示していない場合は、このパラメーターは NULL に設定されます。
xml_message パラメーターは、指定された major_version パラメーターと minor_version パラメーターに基づいて、バージョン 1.0 またはバージョン 2.0 の XML メッセージ文書を戻します。
XMLメッセージ文書の例については、 例2 を参照してください。
データ共有システムで、GET_CONFIG ストアドプロシージャが 1 つ以上の Db2 メンバを処理している際に、 Db2 メンバの 1 つを処理中にエラーが発生した場合、ストアドプロシージャは、エラーの原因となっている Db2 メンバの名前を、XML メッセージ文書の DB2 Object キーの値として指定します。 Short Message Text キーの値は、指定された Db2 メンバーに適用されます。
次の例は、DB2 Object キーが示されているバージョン 2.0 XML メッセージ文書の一部を示しています。<key>Short Message Text</key> <dict> <key>Display Name</key> <string>Short Message Text</string> <key>Value</key> <string>DSNA6xxI DSNADMGC .....</string> <key>DB2 Object</key> <string>DB2B</string> <key>Hint</key> <string /> </dict>
例
- 例 1
- 以下の例は、データ共有メンバーの GET_CONFIG ストアード・プロシージャーのバージョン 1.0 XML 出力文書の一部を示しています。 非データ共用メンバーの場合、DB2 Distributed Access Information 項目内の一部の項目 (Resynchronization Domain、Alias List、Member IPv4 Address、Member IPv6 Address、および Location Server List) は含まれません。XML 出力文書に常に含まれる 2 つの主要なセクションは、Common Data Sharing Group InformationとDB2 Subsystem Specific Informationです。 次の例では、省略符号 (. . .) は、Display Name、Value、および Hint で構成されるディクショナリー・エントリーを表します。
<dict> <key>Display Name</key> <string>DDF Status</string> <key>Value</key> <string>STARTD</string> <key>Hint</key> <string /> </dict>
<?xml version="1.0" encoding="UTF-8"?> <plist version="1.0"> <dict> <key>Document Type Name</key> <string>Data Server Configuration Output</string> <key>Document Type Major Version</key> <integer>1</integer> <key>Document Type Minor Version</key> <integer>0</integer> <key>Data Server Product Name</key> <string>DSN</string> <key>Data Server Product Version</key> <string>13.1.5</string> <key>Data Server Major Version</key> <integer>13</integer> <key>Data Server Minor Version</key> <integer>1</integer> <key>Data Server Platform</key> <string>z/OS</string> <key>Document Locale</key> <string>en_US</string> <key>Common Data Sharing Group Information</key> <dict> <key>Display Name</key> <string>Common Data Sharing Group Information</string> <key>Data Sharing Group Name</key> ... <key>Data Sharing Group Catalog Level</key> ... <key>Data Sharing Group Current Function Level</key> ... <key>Data Sharing Group Highest Activated Function Level</key> ... <key>Data Sharing Group Highest Possible Function Level</key> ... <key>Data Sharing Group Protocol Level</key> ... <key>Data Sharing Group Attach Name</key> ... <key>Data Sharing Group Encryption Key Label</key> ... <key>Migration Readiness Status</key> ... <key>Migration Readiness Reason</key> ... <key>SCA Structure Size</key> ... <key>SCA Status</key> ... <key>SCA in Use</key> ... <key>LOCK1 Structure Size</key> ... <key>Number of Lock Entries</key> ... <key>Number of List Entries</key> ... <key>List Entries in Use</key> ... <key>Hint</key><string></string> </dict> <key>DB2 Subsystem Specific Information</key> <dict> <key>Display Name</key> <string>DB2 Subsystem Specific Information</string> <key>V91A</key> <dict> <key>Display Name</key> <string>V91A</string> <key>DB2 Subsystem Status Information</key> <dict> <key>Display Name</key> <string>DB2 Subsystem Status Information</string> <key>DB2 Member Identifier</key> ... <key>DB2 Member Name</key> ... <key>DB2 Command Prefix</key> ... <key>DB2 Status</key> ... <key>DB2 System Level</key> ... <key>System Name</key> ... <key>IRLM Subsystem Name</key> ... <key>IRLM Procedure Name</key> ... <key>Code Level</key> ... <key>SPE Apar</key> ... <key>Migration Eligible</key> ... <key>Hint</key> </dict> <key>DB2 Subsystem Parameters</key> <dict> <key>Display Name</key> <string>DB2 Subsystem Parameters</string> <key>DSNHDECP</key> <dict> <key>Display Name</key> <string>DSNHDECP</string> <key>AGCCSID</key> <dict> <key>Display Name</key> <string>AGCCSID</string> <key>Installation Panel Name</key> ... <key>Installation Panel Field Name</key> ... <key>Location on Installation Panel</key> ... <key>Subsystem Parameter Value</key> ... <key>Online Update</key> ... <key>Hint</key><string></string> </dict> --- This is only a fragment of the DSNHDECP parameters that are returned by the GET_CONFIG stored procedure. --- <key>Hint</key><string></string> </dict> --- This is only a fragment of the DB2 subsystem parameters that are returned by the GET_CONFIG stored procedure. --- <key>Hint</key><string></string> </dict> <key>DB2 Distributed Access Information</key> <dict> <key>Display Name</key> <string>DB2 Distributed Access Information</string> <key>DDF Status</key> ... <key>Location Name</key> ... <key>LU Name</key> ... <key>Generic LU Name</key> ... <key>TCP/IP Port</key> ... <key>Secure Port</key> ... <key>Resynchronization Port</key> ... <key>IP Name</key> ... <key>IPv4 Address</key> ... <key>IPv6 Address</key> ... <key>SQL Domain</key> ... <key>Resynchronization Domain</key> ... <key>Alias List</key> <dict> <key>Display Name</key> <string>Alias List</string> <key>1</key> <dict> <key>Display Name</key> <string>1</string> <key>Name</key> ... <key>Port</key> ... <key>Secure Port</key> ... <key>Hint</key><string /> </dict> <key>2</key> <dict> <key>Display Name</key> <string>2</string> <key>Name</key> ... <key>Port</key> ... <key>Secure Port</key> ... <key>Hint</key><string /> </dict> <key>Hint</key><string /> </dict> <key>Member IPv4 Address</key> ... <key>Member IPv6 Address</key> ... <key>DT - DDF Thread Value</key> ... <key>CONDBAT - Maximum Inbound Connections</key> ... <key>MDBAT - Maximum Concurrent Active DBATs</key> ... <key>ADBAT - Active DBATs</key> ... <key>QUEDBAT - Times that ADBAT Reached MDBAT Limit</key> ... <key>INADBAT - Inactive DBATs (Type 1)</key> ... <key>CONQUED - Queued Connections</key> ... <key>DSCDBAT - Pooled DBATs</key> ... <key>INACONN - Inactive Connections (Type 2)</key> ... <key>Location Server List</key> <dict> <key>Display Name</key> <string>Location Server List</string> <key>1</key> <dict> <key>Display Name</key> <string>1</string> <key>Weight</key> ... <key>IPv4 Address</key> ... <key>IPv6 Address</key> ... <key>Hint</key><string /> </dict> <key>2</key> <dict> <key>Display Name</key> <string>2</string> <key>Weight</key> ... <key>IPv4 Address</key> ... <key>IPv6 Address</key> ... <key>Hint</key><string /> </dict> <key>Hint</key><string></string> </dict> <key>Hint</key><string></string> </dict> <key>Active Log Data Set Information</key> <dict> <key>Display Name</key> <string>Active Log Data Set Information</string> <key>Active Log Copy 01</key> <dict> <key>Display Name</key> <string>Active Log Copy 01</string> <key>Data Set Name</key> ... <key>Data Set Volumes</key> <dict> <key>Display Name</key> <string>Data Set Volumes</string> <key>Value</key> <array> <string>CATLGJ</string> </array> <key>Hint</key><string></string> </dict> <key>Key Label</key> ... <key>Hint</key><string></string> </dict> <key>Active Log Copy 02</key> <dict> --- The format of this dictionary entry is the same as that of Active Log Copy 01. --- </dict> <key>Hint</key><string></string> </dict> <key>Time of Last DB2 Restart</key> ... <key>Resource Limit Facility Information</key> <dict> <key>Display Name</key> <string>Resource Limit Facility Information</string> <key>RLF Table Names</key> <dict> <key>Display Name</key> <string>RLF Table Names</string> <key>Value</key> <array> <string>SYSADM.DSNRLST01</string> </array> <key>Hint</key><string></string> </dict> <key>Hint</key><string></string> </dict> <key>Connected DB2 Subsystem</key> ... <key>Hint</key><string></string> </dict> <key>Hint</key><string></string> </dict> <key>Hint</key><string></string> </dict> </plist>
- 例 2
- 以下の例は、GET_CONFIG ストアード・プロシージャーのサンプル XML メッセージ文書を示しています。 XML 出力文書と同様に、SQL 警告状態の詳細情報がディクショナリー・エントリーにカプセル化されます。ディクショナリー・エントリーは、Display Name、Value、および Hint で構成されています。
<?xml version="1.0" encoding="UTF-8" ?> <plist version="1.0"> <dict> <key>Document Type Name</key><string>Data Server Message</string> <key>Document Type Major Version</key><integer>1</integer> <key>Document Type Minor Version</key><integer>0</integer> <key>Data Server Product Name</key><string>DSN</string> <key>Data Server Product Version</key><string>13.1.5</string> <key>Data Server Major Version</key><integer>13</integer> <key>Data Server Minor Version</key><integer>1</integer> <key>Data Server Platform</key><string>z/OS</string> <key>Document Locale</key><string>en_US</string> <key>Short Message Text</key> <dict> <key>Display Name</key><string>Short Message Text</string> <key>Value</key> <string>DSNA630I DSNADMGC A PARAMETER FORMAT OR CONTENT ERROR WAS FOUND. The XML input document must be empty or NULL.</string> <key>Hint</key><string /> </dict> </dict> </plist> - 例 3
- この例では、データサーバーの IP アドレスの値を照会する XPath を使用して、GET_CONFIG ストアドプロシージャを呼び出す単純な静的 Java™ プログラムを示します。 XPath はプログラムによりストリング・オブジェクトとして静的に作成され、その後 xml_filter パラメーターの入力として使用できるように BLOB に変換されます。 ストアード・プロシージャーの呼び出し後には、xml_output パラメーターにはストリングが 1 つのみ含まれており、XML 文書は含まれていません。 この出力は、xml_output.xml という名前のファイルとして GetConfDriver クラスと同じディレクトリーにマテリアライズされます。
//*************************************************************************** // Licensed Materials - Property of IBM // 5635-DB2 // (C) COPYRIGHT 1982, 2006 IBM Corp. All Rights Reserved. // // STATUS = Version 9 //*************************************************************************** // Source file name: GetConfDriver.java // // Sample: How to call SYSPROC.GET_CONFIG with a valid XPath to extract the // IP Address. // //The user runs the program by issuing: //java GetConfDriver <alias or //server/database> <userid> <password> // //The arguments are: //<alias> - DB2 subsystem alias for type 2 or //server/database for type 4 // connectivity //<userid> - user ID to connect as //<password> - password to connect with //*************************************************************************** import java.io.*; import java.sql.*; public class GetConfDriver { public static void main (String[] args) { Connection con = null; CallableStatement cstmt = null; String driver = "com.ibm.db2.jcc.DB2Driver"; String url = "jdbc:db2:"; String userid = null; String password = null; // Parse arguments if (args.length != 3) { System.err.println("Usage: GetConfDriver <alias or //server/database> <userid> <password>"); System.err.println("where <alias or //server/database> is DB2 subsystem alias or //server/database for type 4 connectivity"); System.err.println(" <userid> is user ID to connect as"); System.err.println(" <password> is password to connect with"); return; } url += args[0]; userid = args[1]; password = args[2]; try { byte[] xml_input; String str_xmlfilter = new String( "/plist/dict/key[.='DB2 Subsystem Specific Information']/following- sibling::dict[1]" + "/key[.='V91A']/following-sibling::dict[1]" + "/key[.='DB2 Distributed Access Information']/following-sibling::dict[1]" + "/key[.='IP Address']/following-sibling::dict[1]" + "/key[.='Value']/following-sibling::string[1]"); /* Convert XML_FILTER to byte array to pass as BLOB */ byte[] xml_filter = str_xmlfilter.getBytes("UTF-8"); // Load the DB2 Universal JDBC Driver Class.forName(driver); // Connect to database con = DriverManager.getConnection(url, userid, password); con.setAutoCommit(false); cstmt = con.prepareCall("CALL SYSPROC.GET_CONFIG(?,?,?,?,?,?,?)"); // Major / Minor Version / Requested Locale cstmt.setInt(1, 1); cstmt.setInt(2, 0); cstmt.setString(3, "en_US"); // No Input document cstmt.setObject(4, null, Types.BLOB); cstmt.setObject(5, xml_filter, Types.BLOB); // Output Parms cstmt.registerOutParameter(1, Types.INTEGER); cstmt.registerOutParameter(2, Types.INTEGER); cstmt.registerOutParameter(6, Types.BLOB); cstmt.registerOutParameter(7, Types.BLOB); cstmt.execute(); con.commit(); SQLWarning ctstmt_warning = cstmt.getWarnings(); if (ctstmt_warning != null) { System.out.println("SQL Warning: " + ctstmt_warning.getMessage()); } else { System.out.println("SQL Warning: None\r\n"); } System.out.println("Major Version returned " + cstmt.getInt(1) ); System.out.println("Minor Version returned " + cstmt.getInt(2) ); /* get output BLOBs */ Blob b_out = cstmt.getBlob(6); if(b_out != null) { int out_length = (int)b_out.length(); byte[] bxml_output = new byte[out_length]; /* open an inputstream on BLOB data */ InputStream instr_out = b_out.getBinaryStream(); /* copy from inputstream into byte array */ int out_len = instr_out.read(bxml_output, 0, out_length); /* write byte array into FileOutputStream */ FileOutputStream fxml_out = new FileOutputStream("xml_output.xml"); /* write byte array content into FileOutputStream */ fxml_out.write(bxml_output, 0, out_length ); //Close streams instr_out.close(); fxml_out.close(); } Blob b_msg = cstmt.getBlob(7); if(b_msg != null) { int msg_length = (int)b_msg.length(); byte[] bxml_message = new byte[msg_length]; /* open an inputstream on BLOB data */ InputStream instr_msg = b_msg.getBinaryStream(); /* copy from inputstream into byte array */ int msg_len = instr_msg.read(bxml_message, 0, msg_length); /* write byte array content into FileOutputStream */ FileOutputStream fxml_msg = new FileOutputStream(new File ("xml_message.xml")); fxml_msg.write(bxml_message, 0, msg_length); //Close streams instr_msg.close(); fxml_msg.close(); } } catch (SQLException sqle) { System.out.println("Error during CALL " + " SQLSTATE = " + sqle.getSQLState() + " SQLCODE = " + sqle.getErrorCode() + " : " + sqle.getMessage()); } catch (Exception e) { System.out.println("Internal Error " + e.toString()); } finally { if(cstmt != null) try { cstmt.close(); } catch ( SQLException sqle) { sqle.printStackTrace(); } if(con != null) try { con.close(); } catch ( SQLException sqle) { sqle.printStackTrace(); } } } } - 例 4
- 以下の例は、非データ共有システムでストアード・プロシージャーがコンプリート・モードで実行されている場合に、XML 出力 パラメーターによって返されるバージョン 2.0 XML 入力文書を示しています。
<plist version="1.0"> <?xml version="1.0" encoding="UTF-8" ?> <dict> <key>Document Type Name</key> <string>Data Server Configuration Input</string> <key>Document Type Major Version</key> <integer>2</integer> <key>Document Type Minor Version</key> <integer>0</integer> <key>Document Locale</key> <string>en_US</string> <key>Optional Parameters</key> <dict> <key>Display Name</key> <string>Optional Parameters</string> <key>Include</key> <dict> <key>Display Name</key> <string>Include</string> <key>Value</key> <array> <string>DB2 Subsystem Status Information</string> <string>DB2 Subsystem Parameters</string> <string>DB2 Distributed Access Information</string> <string>Active Log Data Set Information</string> <string>Time of Last DB2 Restart</string> <string>Resource Limit Facility Information</string> <string>Connected DB2 Subsystem</string> </array> <key>Hint</key><string /> </dict> <key>Hint</key><string /> </dict> </dict> </plist> - 例 5
- 以下の例は、2 つの Db2 メンバー DB2A および DB2B: を持つデータ共有システムでストアード・プロシージャーがコンプリート・モードで実行されている場合に、XML 出力 パラメーターによって返されるバージョン 2.0 XML 入力文書を示しています。
<plist version="1.0"> <?xml version="1.0" encoding="UTF-8" ?> <dict> <key>Document Type Name</key> <string>Data Server Configuration Input</string> <key>Document Type Major Version</key> <integer>2</integer> <key>Document Type Minor Version</key> <integer>0</integer> <key>Document Locale</key> <string>en_US</string> <key>Optional Parameters</key> <dict> <key>Display Name</key> <string>Optional Parameters</string> <key>Include</key> <dict> <key>Display Name</key> <string>Include</string> <key>Value</key> <array> <string>Common Data Sharing Group Information</string> <string>DB2 Subsystem Status Information</string> <string>DB2 Subsystem Parameters</string> <string>DB2 Distributed Access Information</string> <string>Active Log Data Set Information</string> <string>Time of Last DB2 Restart</string> <string>Resource Limit Facility Information</string> <string>Connected DB2 Subsystem</string> </array> <key>Hint</key><string /> </dict> <key>DB2 Data Sharing Group Members</key> <dict> <key>Display Name</key> <string>DB2 Data Sharing Group Members</string> <key>Value</key> <array> <string>DB2A</string> <string>DB2B</string> </array> <key>Hint</key><string /> </dict> <key>Hint</key><string /> </dict> </dict> </plist> - 例 6
- この例は、非データ共有システムにおける GET_CONFIG ストアード・プロシージャーのバージョン 2.0 XML 出力文書の一部を示しています。 XML 入力文書は、ストアード・プロシージャーに渡されません。 次の例で示すように、省略符号 (...) は、Display Name、Value、および Hint で構成されるディクショナリー・エントリーを表します。または、バージョン 1.0 XML 出力文書での対応するエントリーと同じエントリーを表します。
<dict> <key>Display Name</key> <string>DDF Status</string> <key>Value</key> <string>STARTD</string> <key>Hint</key> <string /> </dict><?xml version="1.0" encoding="UTF-8" ?> <plist version="1.0"> <dict> <key>Document Type Name</key> <string>Data Server Configuration Output</string> <key>Document Type Major Version</key> <integer>2</integer> <key>Document Type Minor Version</key> <integer>0</integer> <key>Data Server Product Name</key> <string>DSN</string> <key>Data Server Product Version</key> <string>13.1.5</string> <key>Data Server Major Version</key> <integer>13</integer> <key>Data Server Minor Version</key> <integer>1</integer> <key>Data Server Platform</key> <string>z/OS</string> <key>Document Locale</key> <string>en_US</string> <key>DB2 Subsystem Specific Information</key> <dict> <key>Display Name</key> <string>DB2 Subsystem Specific Information</string> <key>DB2A</key> <dict> <key>Display Name</key> <string>DB2A</string> <key>DB2 Subsystem Status Information</key> <dict> <key>Display Name</key> <string>DB2 Subsystem Status Information</string> <key>DB2 Member Identifier</key> ... <key>DB2 Member Name</key> ... <key>DB2 Command Prefix</key> ... <key>DB2 Status</key> ... <key>DB2 System Level</key> ... <key>System Name</key> ... <key>IRLM Subsystem Name</key> ... <key>IRLM Procedure Name</key> ... <key>Code Level</key> ... <key>SPE Apar</key> ... <key>Migration Eligible</key> ... <key>Migration Readiness Status</key> ... <key>Migration Readiness Reason</key> ... <key>Hint</key> ... </dict> <key>DB2 Subsystem Parameters</key> <dict>...</dict> <key>DB2 Distributed Access Information</key> <dict> <key>Display Name</key> <string>DB2 Distributed Access Information</string> <key>DDF Status</key> ... <key>Location Name</key> ... <key>LU Name</key> ... <key>Generic LU Name</key> ... <key>TCP/IP Port</key> ... <key>Secure Port</key> ... <key>Resynchronization Port</key> ... <key>IP Name</key> ... <key>IPv4 Address</key> ... <key>IPv6 Address</key> ... <key>SQL Domain</key> ... <key>DT - DDF Thread Value</key> ... <key>CONDBAT - Maximum Inbound Connections</key> ... <key>MDBAT - Maximum Concurrent Active DBATs</key> ... <key>ADBAT - Active DBATs</key> ... <key>QUEDBAT - Times that ADBAT Reached MDBAT Limit</key> ... <key>INADBAT - Inactive DBATs (Type 1)</key> ... <key>CONQUED - Queued Connections</key> ... <key>DSCDBAT - Pooled DBATs</key> ... <key>INACONN - Inactive Connections (Type 2)</key> ... <key>Hint</key><string></string> </dict> <key>Active Log Data Set Information</key> <dict>...</dict> <key>Time of Last DB2 Restart</key> <dict>...</dict> <key>Resource Limit Facility Information</key> <dict> <key>Display Name</key> <string>Resource Limit Facility Information</string> <key>RLF Status</key> <dict> <key>Display Name</key> <string>RLF Status</string> <key>Value</key><string>Active</string> <key>Hint</key><string /> </dict> <key>RLF Table Names</key> <dict> <key>Display Name</key> <string>RLF Table Names</string> <key>Value</key> <array> <string>SYSADM.DSNRLST01</string> </array> <key>Hint</key><string /> </dict> <key>Hint</key><string /> </dict> <key>Connected DB2 Subsystem</key> <dict>...</dict> <key>Hint</key><string /> </dict> <key>Hint</key><string /> </dict> </dict> </plist> - 例 7
- この例は、2 つの Db2 メンバー DB2A および DB2Bを持つデータ共有システムにおける GET_CONFIG ストアード・プロシージャーのバージョン 2.0 XML 出力文書の一部を示しています。 XML 入力文書は、ストアード・プロシージャーに渡されません。 次の例で示すように、省略符号 (...) は、Display Name、Value、および Hint で構成されるディクショナリー・エントリーを表します。または、バージョン 1.0 XML 出力文書での対応するエントリーと同じエントリーを表します。
<dict> <key>Display Name</key> <string>DDF Status</string> <key>Value</key> <string>STARTD</string> <key>Hint</key> <string /> </dict><?xml version="1.0" encoding="UTF-8" ?> <plist version="1.0"> <dict> <key>Document Type Name</key> <string>Data Server Configuration Output</string> <key>Document Type Major Version</key> <integer>2</integer> <key>Document Type Minor Version</key> <integer>0</integer> <key>Data Server Product Name</key> <string>DSN</string> <key>Data Server Product Version</key> <string>13.1.5</string> <key>Data Server Major Version</key> <integer>13</integer> <key>Data Server Minor Version</key> <integer>1</integer> <key>Data Server Platform</key> <string>z/OS</string> <key>Document Locale</key> <string>en_US</string> <key>Common Data Sharing Group Information</key> <dict> <key>Display Name</key> <string>Common Data Sharing Group Information</string> <key>Data Sharing Group Name</key> <dict>...</dict> <key>Data Sharing Group Catalog Level</key> <dict>...</dict> <key>Data Sharing Group Current Function Level</key> <dict>...</dict> <key>Data Sharing Group Highest Activated Function Level</key> <dict>...</dict> <key>Data Sharing Group Highest Possible Function Level</key> <dict>...</dict> <key>Data Sharing Group Protocol Level</key> <dict>...</dict> <key>Data Sharing Group Attach Name</key> <dict>...</dict> <key>Data Sharing Group Encryption Key Label</key> <dict>...</dict> <key>Migration Readiness Status</key> <dict>...</dict> <key>Migration Readiness Reason</key> <dict>...</dict> <key>SCA Structure Size</key> <dict>...</dict> <key>SCA Status</key> <dict>...</dict> <key>SCA in Use</key> <dict>...</dict> <key>LOCK1 Structure Size</key> <dict>...</dict> <key>Number of Lock Entries</key> <dict>...</dict> <key>Number of List Entries</key> <dict>...</dict> <key>List Entries in Use</key> <dict>...</dict> <key>Hint</key><string /> </dict> <key>DB2 Subsystem Specific Information</key> <dict> <key>Display Name</key> <string>DB2 Subsystem Specific Information</string> <key>DB2A</key> <dict> <key>Display Name</key> <string>DB2A</string> <key>DB2 Subsystem Status Information</key> <key>Display Name</key> <string>DB2 Subsystem Status Information</string> <key>DB2 Member Identifier</key> ... <key>DB2 Member Name</key> ... <key>DB2 Command Prefix</key> ... <key>DB2 Status</key> ... <key>DB2 System Level</key> ... <key>System Name</key> ... <key>IRLM Subsystem Name</key> ... <key>IRLM Procedure Name</key> ... <key>Code Level</key> ... <key>SPE Apar</key> ... <key>Migration Eligible</key> ... <key>Hint</key> ... <key>DB2 Subsystem Parameters</key> <dict>...</dict> <key>DB2 Distributed Access Information</key> <dict> <key>Display Name</key> <string>DB2 Distributed Access Information</string> <key>DDF Status</key> ... <key>Location Name</key> ... <key>LU Name</key> ... <key>Generic LU Name</key> ... <key>TCP/IP Port</key> ... <key>Secure Port</key> ... <key>Resynchronization Port</key> ... <key>IP Name</key> ... <key>IPv4 Address</key> ... <key>IPv6 Address</key> ... <key>SQL Domain</key> ... <key>Resynchronization Domain</key> ... <key>Alias List</key> <dict> <key>Display Name</key> <string>Alias List</string> <key>1</key> <dict> <key>Display Name</key> <string>1</string> <key>Name</key> ... <key>Port</key> ... <key>Secure Port</key> ... <key>Hint</key><string /> </dict> <key>2</key> <dict> <key>Display Name</key> <string>2</string> <key>Name</key> ... <key>Port</key> ... <key>Secure Port</key> ... <key>Hint</key><string /> </dict> <key>Hint</key><string /> </dict> <key>Member IPv4 Address</key> ... <key>Member IPv6 Address</key> ... <key>DT - DDF Thread Value</key> ... <key>CONDBAT - Maximum Inbound Connections</key> ... <key>MDBAT - Maximum Concurrent Active DBATs</key> ... <key>ADBAT - Active DBATs</key> ... <key>QUEDBAT - Times that ADBAT Reached MDBAT Limit</key> ... <key>INADBAT - Inactive DBATs (Type 1)</key> ... <key>CONQUED - Queued Connections</key> ... <key>DSCDBAT - Pooled DBATs</key> ... <key>INACONN - Inactive Connections (Type 2)</key> ... <key>Location Server List</key> <dict> <key>Display Name</key> <string>Location Server List</string> <key>1</key> <dict> <key>Display Name</key> <string>1</string> <key>Weight</key> ... <key>IPv4 Address</key> ... <key>IPv6 Address</key> ... <key>Hint</key><string /> </dict> <key>2</key> <dict> <key>Display Name</key> <string>1</string> <key>Weight</key> ... <key>IPv4 Address</key> ... <key>IPv6 Address</key> ... <key>Hint</key><string /> </dict> <key>Hint</key><string /> </dict> <key>Hint</key><string></string> </dict> <key>Active Log Data Set Information</key> <dict>...</dict> <key>Time of Last DB2 Restart</key> <dict>...</dict> <key>Resource Limit Facility Information</key> <dict> <key>Display Name</key> <string>Resource Limit Facility Information</string> <key>RLF Status</key> <dict> <key>Display Name</key> <string>RLF Status</string> <key>Value</key><string>Active</string> <key>Hint</key><string /> </dict> <key>RLF Table Names</key> <dict> <key>Display Name</key> <string>RLF Table Names</string> <key>Value</key> <array> <string>SYSADM.DSNRLST01</string> </array> <key>Hint</key><string /> </dict> <key>Hint</key><string /> </dict> <key>Connected DB2 Subsystem</key> <dict>...</dict> <key>Hint</key><string /> </dict> <key>DB2B</key> <dict> --- This dictionary entry describes the second DB2 member: DB2B. Its format is the same as that of member DB2A. --- </dict> <key>Hint</key><string /> </dict> </dict> </plist><key>Data Sharing Group Level</key> <dict> <key>Display Name</key> <string>Data Sharing Group Level</string><key>Value</key> <string>V13R1M500</string> <key>Hint</key><string/> </dict> <key>Data Sharing Group Current Function Level</key> <dict> <key>Display Name</key> <string>Data Sharing Group Current Function Level</string> <key>Value</key><string>V13R1M100</string> <key>Hint</key><string/> </dict> <key>Data Sharing Group Highest Activated Function Level</key> <dict> <key>Display Name</key> <string>Data Sharing Group Highest Activated Function Level</string> <key>Value</key><string>V13R1M100</string> <key>Hint</key><string/> </dict> <key>Data Sharing Group Highest Possible Function Level</key> <dict> <key>Display Name</key> <string>Data Sharing Group Highest Possible Function Level</string> <key>Value</key><string>V13R1M100</string> <key>Hint</key><string/> </dict>
