初期設定ファイルの構造
初期設定ファイルは、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