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 または ADO.NET データストアの名前。ODBC データストアの場合、これは Microsoft ODBC データソースアドミニストレーターADO.NET データストアの場合、これは Micro Focus ADO.NET Connection Editor または HCOSS Manage Connections ツールを使用して作成されたデータソース名です。 `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 を使用すると、接続情報をアプリケーションに返すことができます。

注：

CONNECT WITH PROMPT 構文は、SQL(DBMAN=ADO) でコンパイルされたアプリケーションでサポートされません。
SQL コンパイラ指令の INIT オプションが使用されている場合は、実行時にデータベースへ暗黙的に接続されます。この場合は、明示的に CONNECT 文を実行する必要はありません。
ファイル DSN にパスワードを含めることはできません。
ADO.NET ランタイムおよびフォーマット 6 を使用している場合は、factory=invariantnameを input_connection 仕様に追加する必要があります。不変の名前は、ADO.NET Connection Editor の [Add] ページで確認できます。

構文、書き方 1：

     MOVE 'servername' TO svr
     MOVE 'username.password' TO usr

     EXEC SQL
        CONNECT TO :svr USER :usr
     END-EXEC

構文、書き方 2：

     EXEC SQL
        CONNECT 'username.password' USING 'servername'
     END-EXEC

構文、書き方 3：

     EXEC SQL
        CONNECT WITH PROMPT
     END-EXEC

構文、書き方 4：

     EXEC SQL
        CONNECT RESET
     END-EXEC

構文、書き方 5：

    EXEC SQL
        CONNECT USING 'FileDSN=Oracle8;PWD=tiger'
     END-EXEC

上記の例は、File DSN を使用します。

構文、書き方 6：

 01  connectString               PIC X(72) value
                   'DRIVER={Microsoft Excel Driver (*.xls)};'
                   &'DBQ=c:\demo\demo.xls;'
                   &'DRIVERID=22'
                   .

 procedure division.

     EXEC SQL
         CONNECT USING :connectString
     END-EXEC

上記の例は、データソースを設定しないで Excel スプレッドシートに接続します。

 01  connString    string. 
 set connString    to  "Trusted_Connection=yes;Database=Northwind;server=localhost;factory=System.Data.SqlClient;" 
   

 procedure division.

     EXEC SQL 
         CONNECT USING :connString  
     END-EXEC

上記の例は、ADO.NET ランタイムの適切な構文を示しています。