6.21.1 INSTALL CLIBの形式と規則
(1) 機能
外部Cストアドルーチンを実行するために,UAP実行マシンにある,外部Cストアドルーチンを実装した外部CライブラリファイルをHiRDBサーバに新規登録します。
(2) 形式
INSTALL CLIB {:埋込み変数|'文字列'}
(3) オペランド
(a) {:埋込み変数|'文字列'}
登録する外部Cライブラリファイルの名称を指定します。外部Cライブラリファイルの名称は,絶対パス名又は相対パス名で指定してください。
- :埋込み変数
-
外部Cライブラリファイルの名称をVARCHAR型の埋込み変数で指定します。
既定文字集合以外の文字集合は指定できません。
- '文字列'
-
外部Cライブラリファイルの名称を文字列定数で指定します。
(4) 共通規則
-
INSTALL CLIBを実行する前に,HiRDBサーバに接続しておく必要があります。
-
エラーコードはSQLCODEに返されます。
-
ほかのサーバマシンの外部Cライブラリファイルは指定できません。
-
ワイルドカードは使用できません。
-
既に同じ名称の外部Cライブラリファイルが登録されている場合,上書きはしないでエラーとします。
-
INSTALL CLIBは,トランザクションの開始前に実行してください。
-
外部Cライブラリファイルの登録先と同じプラットフォームで,外部Cライブラリファイルを作成してください。
(5) 使用例
外部Cライブラリファイル(c:\work\sampleproc.dll)を埋込み変数で指定して新規登録します。
EXEC SQL BEGIN DECLARE SECTION ; struct { short len ; char str[256] ; } filename ; EXEC SQL END DECLARE SECTION ; EXEC SQL CONNECT ; strcpy(filename.str,"c:\\work\\sampleproc.dll") ; filename.len = strlen(filename.str) ; EXEC SQL INSTALL CLIB :filename ;