Microsoft SQL Server のデータストアの構成ファイルの更新

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

Visual COBOL コマンドプロンプトを開きます。

注: Windows では、使用する ODBC データソースと同じビット体系のコマンドプロンプトを使用する必要があります。
MFDBFH_CONFIG 環境変数を設定して、作成または更新する構成ファイルの場所を指定します。
```
set MFDBFH_CONFIG=<location-and-name-of-file>
```
この変数を設定しない場合、MFDBFH.cfg という名前のファイルが現在のディレクトリにあると見なされます。

注: データストアの操作に使用するストアドプロシージャをポイントする MFDBFH_SCRIPT_DIR 環境変数も必要ですが、この変数は Visual COBOL コマンドプロンプトを使用する場合はすでに暗黙的に設定されています。
接続するデータベースサーバーインスタンスを追加します。
```
dbfhconfig -add -server:<server-name> -provider:ss
```
<server-name> は、データベースサーバーインスタンスの名前です。(local) または localhost のエントリも有効で、デフォルトでマシン名になります。

次に、インスタンス内のデータベースを指定する必要があります。
最初に、master データベースへの参照を作成する必要があります。これは、MSSQL に付属のプライマリ構成データベースです。
注: すでにデータベースサーバーインスタンスの <server> 要素が存在している場合は、この参照はすでに存在しているはずです。
```
dbfhconfig -add -server:<server-name> -dsn:<name> -type:database -name:master [-connect:<connection-string>]
```
<name> は、master データベースの ODBC データソースに指定する名前 (この場合、後で使用するため、名前をメモしておいてください)、または接続文字列を使用する場合にはデータベースを参照するサーバー構成内の一意の名前です。<connection-string> は、ODBC データソースを使用せずにデータベース接続を確立する場合のデータベース接続文字列です。データベース固有の構文については、「データベース接続文字列」を参照してください。

必要なデータストアのそれぞれについて、次の手順を繰り返します。

dbfhconfig -add -server:<server-name> -dsn:<name> -type:datastore [-db:<existing-db>] [odbcdsn:<dsn-name>] -optio:<opts> -name:<dsname> [-connect:<connection-string>]

<name> は、データストアの ODBC データソースに指定する名前 (この場合、後で使用するため、名前をメモしておいてください)、または接続文字列を使用する場合にはデータストアを参照するサーバー構成内の一意の名前です。<existing-db> は、データストアを格納する既存のデータベースの名前です。このオプションを省略すると、データストアが独自のデータベースに格納されていると見なされます。<dsn-name> は、共有データベース接続として使用されるデータソースの名前です (ODBC データソースを使用し、単一の物理データベースを使用する場合)。詳細については、「データベース接続」を参照してください。<opts> は、入出力操作に適用される最適化です。<dsname> は、データストアの実際の名前です (データソースプロパティで構成)。

<opts> は、次のいずれかになります。

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

構成ファイルの例

構成ファイルは、各コマンドの後に書き込まれます。次の構成ファイルには、2 つのデータストアが含まれています。これらはそれぞれインスタンス内の独自のデータベースに格納されます (dbname 属性に従って名前が付けられます)。MSSQL サーバーインスタンスも Windows 認証を使用するように構成されているため、userid および password 属性は省略しています。

<datastores usevault="false">
   <server name="(local)" type="sqlserver" access="odbc">
      <dsn name="SS.MYMASTER" type="database" dbname="master"/>
      <dsn name="SS.VSAM" type="datastore" dsname="VSAM" dbname="VSAM"/>
      <dsn name="SS.SEQ" type="datastore" dsname="SEQ" dbname="SEQ" optio="all -ooseq"/>

   </server>
</datastores>

次に、データベース構成ファイルで接続文字列を使用していない場合は、構成したデータベースごとにデータソースを作成する必要があります。接続文字列を使用している場合は、データソースの作成をスキップし、dbfhdeploy コマンドラインユーティリティを使用してファイルをデータストアにアップロードできます。