Db2 のリージョン データベースおよびリージョン間データベースの構成ファイルの更新

ここでは、構成ファイルを作成または更新して、1 つ以上のリージョン データベースおよび 1 つのリージョン間データベースのエントリを追加する手順を示します。

構成ファイルを作成または更新する場合は、dbfhconfig コマンド ライン ユーティリティを使用する必要があります。

  1. Enterprise Developer command promptを開きます。
    注: Windows では、使用する ODBC データ ソースと同じビット体系のコマンド プロンプトを使用する必要があります。
  2. MFDBFH_CONFIG 環境変数を設定して、作成または更新する構成ファイルの場所を指定します。
    set MFDBFH_CONFIG=<location-and-name-of-file>

    この変数を設定しない場合、MFDBFH.cfg という名前のファイルが現在のディレクトリにあると見なされます。

    注: データストアの操作に使用するストアド プロシージャを指す MFDBFH_SCRIPT_DIR 環境変数も必要ですが、この変数は Enterprise Developer command promptを使用する場合はすでに暗黙的に設定されています。
  3. 接続するデータベース サーバー インスタンスを追加します。
    dbfhconfig -add -server:<server-name> -provider:db2

    <server-name> は、データベース サーバー インスタンスの名前です。localhost:<port> のエントリも有効で、デフォルトでマシン名になります。Db2 データストアで構成ファイルをすでに更新している場合、このエントリはすでに存在するため、このことを通知するメッセージが表示され、次の手順にスキップできます。

    次に、インスタンス内の必要なデータベースを指定します。

  4. 必要なリージョン データベースのそれぞれについて、次の手順を繰り返します。
    dbfhconfig -add -server:<server-name> -dsn:<dsn-name> [-db:<existing-db>] -type:region -name:<region-name> -feature:<options> [-user:<user-name>] [-password:<password>] [-connect:<connection-string>]

    <dsn-name> は、リージョン データベースの ODBC データ ソースであるか、ODBC データ ソースの代わりに接続文字列を使用する場合は、データストアを参照する Db2 構成内の一意の名前です。<existing-db> (オプション) は、データストアを格納する既存のデータベースの名前です。このオプションを省略すると、新しいデータベースが作成されます。<region-name> は、エンタープライズ サーバー リージョンの名前です。<opts> は、入出力操作に適用される最適化です。<user-name> および <password> は、インスタンスの有効な資格情報です。接続文字列を使用する場合は、これらの要素を指定する必要はありません。<connection-string> は、ODBC データ ソースを使用せずにデータベース接続を確立する場合のデータベース接続文字列です。データベース固有の構文については、「データベース接続文字列」を参照してください。

    <opts> には次のうちの 1 つまたは複数を使用できます。
    • all - リージョンの使用可能なすべての機能を有効にします (デフォルト)。
    • none - リージョンのすべての機能を無効にします。
    • [+|-]reslocking - データベース リソース ロックを有効/無効にします。
  5. 次に、単一のリージョン間データベースへの参照を追加します。
    dbfhconfig -add -server:<server-name> -dsn:<dsn-name> -type:crossregion [-user:<user-name>] [-password:<password>] [-connect:<connection-string>]  
    <dsn-name> は、リージョン間データベースの ODBC データ ソースであるか、ODBC データ ソースの代わりに接続文字列を使用する場合は、データストアを参照する Db2 構成内の一意の名前です。

構成ファイルの例

次の構成ファイルには、データストア、リージョン データベース、およびリージョン間データベースが含まれており、直接接続の構文が使用されています。このデータベースへの接続を確立するにはログイン資格情報が必要であるため、Secrets Vault も有効になっています。詳細については、「Micro Focus データベース ファイル ハンドラーの Secrets Vault の構成」を参照してください。

<datastores usevault="true">
   <server name="localhost:50000" type="db2" access="odbc">
      <dsn name="DB2.VSAM" type="datastore" dsname="VSAM" optio="none +ooseq" dbname="MYMFFILS" connect="$$vault$$"/>
      <dsn name="DB2.SEQ" type="datastore" dsname="VSAM" optio="none +ooseq" bitism:"32" userid="db2admin" password="$$vault$$"/>
      <dsn name="DB2.ESDEMO" type="region.cas" region="ESDEMO" feature="all" dbname="MYMFFILS" connect="$$vault$$"/>
      <dsn name="DB2.CROSSREGION" type="crossregion.cas" dsname="$XREGN$" dbname="MYMFFILS" connect="$$vault$$"/>
   </server>
</datastores>
次に、dbfhadmin コマンド ライン ユーティリティを使用して、リージョン データベースおよびリージョン間データベースを作成する必要があります。