初期設定ファイルの構造

初期設定ファイルは、3 つのタイプのセクション (共通セクション、サブシステム・セクション、およびデータ・ソース・セクション) から構成されています。

スタンザとも呼ばれる 3 つのセクションは以下のように説明されています。
共通セクション
この初期化ファイルを使用するすべてのアプリケーションにとって グローバルなパラメーターを含みます。
サブシステム・セクション
そのサブシステムに固有なパラメーター値を含みます。
データ・ソース・セクション
そのデータ・ソースに接続されたときにのみ使用される パラメーター値を含みます。 ゼロまたはそれ以上のデータ・ソース・セクションを指定することができます。

それぞれのセクションは、大括弧で囲まれた構文 ID で示されています。

構文 ID は、リテラル 'common'、サブシステム ID、 またはデータ・ソース (ロケーション名) のいずれかです。例えば、次のとおりです。
[data-source-name]
これは、セクション・ヘッダー です。
パラメーターを設定するには、キーワードとその関連キーワード値を 次の形式で指定します。
KeywordName =keywordValue
  • それぞれのデータ・ソースごとに、すべてのキーワードとその関連値は、 データ・ソースのセクション・ヘッダーの下に配置する必要があります。
  • それぞれのセクションのキーワードの設定は、そのセクション・ヘッダーの データ・ソース名に対してのみ適用されます。
  • キーワードは大/小文字の区別はされませんが、 その値は、文字ベースのものであれば、大/小文字の区別をすることができます。
  • データ・ソース名が Db2® ODBC 初期化ファイル内で見つからない場合は、 これらのキーワードのデフォルト値が有効になります。
  • 新しい行の先頭位置にセミコロンを入れると、コメント行になります。
  • ブランク行も使用できます。1 つのキーワードに重複項目があると、最初の項目が使用されます (警告 は出ません)。
重要 : 初期化ファイルの以下の内容を 正確にすることによって、よくあるエラーを回避することができます。
  • 大括弧: 初期化ファイルの中の大括弧は、正しい EBCDIC 文字でなければなりません。 左大括弧には、16 進文字 X'AD' を使用する必要があります。 また右大括弧には、16 進文字 X'BD' を使用する必要があります。 これと異なる指定をすると、Db2 ODBC は大括弧であるとは認識しません。
  • シーケンス番号: 初期化ファイルはシーケンス番号を受け入れることができません。 シーケンス番号はすべて除去する必要があります。
以下のサンプルは、共通スタンザ、サブシステム・スタンザ、および 2 つの データ・ソース・スタンザを持つ Db2 ODBC 初期化ファイルです。
; This is a comment line...
; Example COMMON stanza
[COMMON]
MVSDEFAULTSSID=VB1A
CONNECTTYPE=2
; Example SUBSYSTEM stanza for VB1A subsystem
[V81A]
MVSATTACHTYPE=CAF
PLANNAME=DSNACLI
; Example DATA SOURCE stanza for STLEC1 data source
[STLEC1]
AUTOCOMMIT=0
; Example DATA SOURCE stanza for STLEC1B data source
[STLEC1B]
CURSORHOLD=0