Oracle のデータストアの構成ファイルの更新

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

  1. Enterprise Developer command promptを開きます。
  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:ora

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

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

  4. 必要なデータストアのそれぞれについて、次の手順を繰り返します。
    dbfhconfig -add -server:<server-name> -dsn:<dsn-name> -type:datastore -optio:<opts> [-bitism:<bit>] 
    -name:<dsname> -db:<existing-db> {-user:<user-name> -password:<password> | -connect:<connection-string>}

    <dsn-name> は、データストアを参照する MFDBFH 構成ファイル内の一意の名前です。<opts> は、入出力操作に適用される最適化です。<bit> は、データベース接続のビット体系です。<dsname> は、データストアの実際の名前です。接続の詳細については、-db (<existing-db> は、データストアを格納する既存のデータベース インスタンスの名前です。簡単にするために、tnsnames.ora 構成ファイルで識別エントリを指定することをお勧めします) を指定してから、-user および -password (<user-name> および <password> は、インスタンスの有効な資格情報です)、または -connect (<connection-string> は、データベース接続文字列です。データベース固有の構文については、「データベース接続文字列」を参照してください) を指定する必要があります。

    <opts> は、次のいずれかになります。
    オプション 説明
    all 使用可能なオプションごとに +<opt> を指定した場合と同様に、最適化がすべて適用されます。その後、-<opt> を使用して、特定のオプションを選択して無効にできます。
    none 最適化は適用されません。
    {+|-}oiseq 入力用に開かれた行順編成ファイルに対する最適化を有効 (+) または無効 (-) にします。
    {+|-}ooseq 出力用に開かれた行順編成ファイルに対する最適化を有効 (+) または無効 (-) にします。
    {+|-}oi 入力用に開かれた ESDS、KSDS、および RRDS ファイルに対する最適化を有効 (+) または無効 (-) にします。
    {+|-}oo 出力用に開かれた ESDS、KSDS、および RRDS ファイルに対する最適化を有効 (+) または無効 (-) にします。

構成ファイルの例

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

<datastores usevault="true">
 <server name="${TESTMFDBFH_DBINST_ORA}" type="oracle" access="oci">
    <dsn name="ORA.VSAM" type="datastore" dsname="VSAM" optio="none" dbname="DBFHTEST" connect="$$vault$$"/>
    <dsn name="ORA.JES" type="datastore" dsname="JES" optio="none" dbname="DBFHTEST" connect="$$vault$$"/>
    <dsn name="ORA.CAS.CROSSREGION" type="crossregion.cas" dbname="DBFHTEST" connect="$$vault$$"/>
    <dsn name="ORA.CAS.TESTDB" type="region.cas" region="TESTDB" dbname="DBFHTEST" connect="$$vault$$"/>
  </server>
</datastores>

次に、dbfhadmin コマンド ライン ユーティリティを使用してデータストア スクリプトを作成および実行する必要があります。その後、dbfhdeploy コマンド ライン ユーティリティを使用してファイルをデータストアに追加できます。