db_start_database 関数

unsigned int db_start_database( SQLCA * sqlca, char * parms );

parms NULL で終了された文字列で、KEYWORD=value 形式のパラメータ設定をセミコロンで区切ったリストが含まれています。次に例を示します。

"UID=DBA;PWD=sql;DBF=c:\\db\\mydatabase.db"

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

可能であれば、データベースは既存のサーバで起動します。そうでない場合は、新しいサーバを起動します。

データベースがすでに実行している場合、または正しく起動した場合、戻り値は true (0 以外) であり、SQLCODE には 0 が設定されます。エラー情報は SQLCA に返されます。

ユーザ ID とパスワードがパラメータに指定されても、それらは無視されます。

データベースの開始と停止に必要な権限は、サーバコマンドラインで -gd オプションを使用して設定します。