sqlstart() 函数启动隐式的缺省连接。隐式的缺省连接可支持至缺省数据库服务器的一
个连接。(GBASEDBTSERVER 环境变量指定的)。
提示: 在仅使用一个连接的 6.0 版本之前,限制应用程序使用 sqlstart()。为了与这
些应用程序的较早版本相兼容,
GBase 8s ESQL/C 继续支持此函数。
对于 Version 6.0 和更
晚的应用程序,请使用 CONNECT 语句来建立至缺省数据库服务器的显示的连接。
语法
mint sqlstart();
用法
GBase 8s ESQL/C 为仅支持单个连接的 Version 6.0 之前的应用程序提供 sqlstart()
函数。在此上下文中,可能的 sqlstart() 使用如下:
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 950 -
您仅需证实缺省数据库服务器可用,但您不打算打开数据库。如果 sqlstart() 调用失
败,则您可检查返回状态来证实缺省数据库服务器不可用。
当应用程序在网络上运行时,
您需要加速 DATABASE 语句的执行。
当您将 sqlstart()
的调用放置在初始化例程中时,在用户开始与该应用程序交互之前,应用程序建立连接。
然后,DATABASE 语句可打开指定的数据库。
您不知道要访问的实际数据库的名称,
或您的应用程序计划创建数据库。
调用 sqlstart()
可建立隐式的缺省连接,且稍后应用程序可确定要访问或创建的数据库的名称。
如果您有一个 6.0 版本之前的应用程序,
处于任何其他原因,
其需要隐式的缺省连接,
则请使用 DATABASE 语句,而不是 sqlstart()。对于 6.0 版及其后来的应用程序,请使用
CONNECT 语句来建立数据库服务器连接。
当您调用 sqlstart() 函数时,
请确保该应用程序尚未建立任何连接,
隐式的或显式的。
当应用程序已建立了显式的连接时,sqlstart() 返回错误 -1811。如果建立了隐式的连接,
则 sqlstart() 返回错误 -1802。
在您建立显式的连接之前,您可多次调用此函数,只要在下一 sqlstart()
调用之前断开每一隐式的连接即可。
返回代码
0
sqlstart() 调用成功。
<0
sqlstart() 调用不成功。