CONNECT

提供されたユーザー名とパスワードを使用して特定のデータベースに接続します。

構文、書き方 1：

>>---EXEC SQL---CONNECT TO---.-------------.------------->
                             +-data_source-+ 

 >--.------------.------USER-.-------------------.-------->
    +-AS db_name-+           +-user-.-----------++
                                    +-.password-+ 

 >-.--------------------.-.-----------------------------.->
   +-WITH-.----.-PROMPT-+ +-RETURNING output_connection-+
          +-NO-+

 >------END-EXEC--------><

構文、書き方 2：

>>---EXEC SQL---CONNECT user--.------------------------.->
                              +-IDENTIFIED BY password-+
                              +-------'/'password------+ 

 >---.--------------.--------.--------------------.------->
     +--AT db_name--+        +--USING data_source-+

 >---.----------------------.----------------------------->
     +--WITH-.----.-PROMPT--+ 
             +-NO-+ 

 >---.-----------------------------.---END-EXEC---><
     +-RETURNING output_connection-+

構文、書き方 3：

>>----EXEC SQL---CONNECT WITH PROMPT-------------------->
  
 >---.------------------------------.---END-EXEC----><
     +-RETURNING output_connection -+

構文、書き方 4：

>>----EXEC SQL---CONNECT RESET-.--------.--END-EXEC-----><
                               +--name--+

構文、書き方 5：

>>----EXEC SQL--------CONNECT DSN input_connection------->

 >---.------------------------------.-------END-EXEC-----><
     +-RETURNING output_connection -+

構文、書き方 6：

>>----EXEC SQL---CONNECT USING input_connection---------->
 
 >-----.-------------.---.---------------------.---------->
       +--AS db_name-+   +--WITH-.----.-PROMPT-+
                                 +-NO-+

 >-----.------------------------------.------END-EXEC---->< 
       +--RETURNING output_connection-+

パラメーター：

`data_ source`	ODBC データストアの名前。ODBC データストアの場合、これは Microsoft ODBC データソースアドミニストレーターまたは HCOSS Manage Connections ツールで作成された DSN です。 `data_source` を省略した場合は、デフォルトの ODBC データソースが使用されます。データソースは、リテラルまたはホスト変数で指定できます。
`db_name`	接続の名前。接続名は最大 30 字で、英数字とファイル名に有効な任意の記号が使用できます。最初の文字は英字でなければなりません。接続名には、埋め込み SQL のキーワード、CURRENT、DEFAULT、ALL を使用しないでください。`db_name` を省略した場合は、DEFAULT が使用されます。d`b_name` は定数またはホスト変数で指定できます。 SQL Server に接続する歳、`db_name` は接続先のデータベースです。
`user`	指定したデータソースに有効なユーザー ID。
`password`	指定したユーザー ID に有効なパスワード。
`output_connection`	特定のデータースへの接続に使用される接続文字列として ODBC によって定義された PIC X(n) テキスト文字列。その後に、この文字列を CONNECT `USING 文の input_connection として指定できます。`
`input_connection`	データソースへの接続のために ODBC によって使用される接続情報を含む PIC X(n) テキスト文字列。テキスト列はリテラルまたはホスト変数で指定できます。
RESET	指定した接続をリセット (切断) します。
`name`	`name` には、CURRENT、DEFAULT または ALL を指定できます。

説明：

1 つの接続だけを使用する場合は、接続に名前を付ける必要はありません。複数の接続を使用する場合は、各接続に名前を指定する必要があります。接続名はプロセス内で共通です。名前の付いた接続は、別々にコンパイルされ、単一の実行可能モジュールにリンクしたプログラム間で共有できます。

CONNECT 文が正常に実行されると、すべてのデータベーストランザクションは、CONNECT RESET が最後に宣言されている場合以外は、現在の接続となります。別の接続を使用するには、SET CONNECTION 文を使用する必要があります。

ODBC ランタイムモジュールで、エントリの実行時または接続詳細の確認時にプロンプトが表示されるようにするには、CONNECT WITH PROMPT を使用します。

管理を簡素化するには、CONNECT DSN および CONNECT USING を使用します。

CONNECT TO、CONNECT、CONNECT WITH PROMPT、CONNECT DSN および CONNECT USING を使用すると、接続情報をアプリケーションに返すことができます。

注：

SQL コンパイラ指令の INIT オプションが使用されている場合は、実行時にデータベースへ暗黙的に接続されます。この場合は、明示的に CONNECT 文を実行する必要はありません。
ファイル DSN にパスワードを含めることはできません。