目的
この制御によって、ユーザーはデータベース接続プロパティ リストをキー=値ペアの形式で提供するために使用される文字列を指定できます。
有効なキー名の詳細については、CLIの参照マニュアルを参照してください。
このコマンドは、TDPを利用したCLIを使用するz/OS BTEQユーザーには使用できません。
構文
次のような場合に当てはまります。
- SET
- 任意選択のキーワードです。
- =
- 任意選択のキーワードです。
- properties_list
1つ以上のセミコロンで区切られたキー=値ペアを含みます。これらの値は二重引用符で囲まれていることもありますし、囲まれていないこともあります。指定されていない場合、CONNECTSTRINGの値はデフォルトの状態に戻ります。
使用方法に関する注意
(対話式とは反対の)バッチ モードの場合、BTEQは無効なCONNECTSTRINGコマンド構文に対して致命的なエラーを起こします。
コマンドを発行するには、すべてのデータベース セッションをログオフする必要があります。
複数コマンド命令内でコマンドを使用するには、リストを単一引用符で囲み、その後、2つの単一引用符を連続して使用し、内側の単一引用符を表します。文字列をCLIに渡す前に、BTEQはリストを囲む単一引用符を削除し、内側の2つの連続した単一引用符の各インスタンスを1つの単一引用符で置き換えます。BTEQが入力を正しく解釈できるようにするには、使用する単一引用符の数が全体で偶数でなければなりません。
二重引用符文字を含む値を指定するには、CLIが解析できる文字列をBTEQが提供できるように、次の引用符の規則を適用する必要があります。
- 二重引用符文字は埋め込む(つまり、値の最初または最後の文字以外の場所で使用する)ことができる。値を引用符で囲む必要はない。例: somekey=abc"def。
- 値の最初または最後の文字として二重引用符文字が使われている場合、値全体を二重引用符で囲み、埋め込まれた二重引用符をエスケープするため、二重引用符をもう1つ入力する必要がある。例: somekey="""abcdef"。
CONNECTSTRINGコマンドはSQLマクロでは使用できません。
例 - TLS sslmodeオプション
次の入力命令は、TLSのsslmodeオプションをオーバーライドする必要があることを示すために使用されているCONNECTSTRINGコマンドを示しています。
.connectstring sslmode=require
例 - 複数コマンド命令
次の入力命令は、最初のステップとしてCONNECTSTRINGコマンドを示し、その後、2番目のステップとしてSHOW CONTROLSコマンドを提供します。これらのステップは、バッチ モード出力で同じ結果ブロックを共有しますが、それぞれ個別に処理されます。
.connectstring 'sslmode=require'; .show controls connectstring;
例 - 複数行コマンド
次の入力命令は、2行を使用して提供されるCONNECTSTRINGコマンドです。最初の行の末尾にあるダッシュ文字が継続を示しています。
.connectstring 'sslmode=re- quire'