@@12W03501.GIF;图2 ODBC体系结构@@
下面我们详细介绍各层的功能。
1. 应用程序层(Application)
使用ODBC接口的应用程序可执行以下任务：
①请求与数据源的连接和会话(SQLConnect)；
②向数据源发送SQL请求(SQLExecDirct或SQLExecute)；
③对SQL请求的结果定义存储区和数据格式；
④请求结果；
⑤处理错误；
⑥如果需要，把结果返回给用户；
⑦对事务进行控制，请求执行或回退操作(SQLTransact)；
⑧终止对数据源的连接(SQLDisconnect)。
2. 驱动程序管理器(Driver Manager)
由微软提供的驱动程序管理器是带有输入库的动态连接库ODBC.DLL，其主要目的是装入驱动程序，此外还执行以下工作:
①处理几个ODBC初始化调用；
②为每一个驱动程序提供ODBC函数入口点；
③为ODBC调用提供参数和次序验证。
3. 驱动程序(Driver)
驱动程序是实现ODBC函数和数据源交互的DLL，当应用程序调用SQL Connect或者SQLDriver Connect函数时，驱动程序管理器装入相应的驱动程序，它对来自应用程序的ODBC函数调用进行应答，按照其要求执行以下任务:
①建立与数据源的连接；
②向数据源提交请求；
③在应用程序需求时，转换数据格式；
④返回结果给应用程序；
⑤将运行错误格式化为标准代码返回；
⑥在需要时说明和处理光标。
以上这些功能都是对应用程序层功能的具体实现。驱动程序的配置方式可以划分为以下两种。
(1)单层次(single-tier) 这种方式下，驱动程序要处理ODBC调用SQL语句，并直接操纵数据库，因此具有数据存取功能。这种配置最常见的是同一台微机之上异种数据库通过ODBC存取，如在Powerbuilder中存取XBase、Excel、Paradox等数据文件,如图3所示。@@12W03502.GIF;图3 一层配置示意图@@
(2)多层次(multiple-tier) 这种配置中驱动程序仅仅处理ODBC调用，而将SQL语句交给服务器执行，然后返回结果。这种情况往往是应用程序、驱动程序管理器、驱动程序驻留在客户机端，而数据源和数据存取功能放在服务器端。譬如用Foxpro或Excel存取SQL Server或Oracle上的数据,如图4所示。
@@12W03503.GIF;图4 二层配置示意图@@
有时在以上两者之间加上网关以解决[本文由网站www.gwdq.com公文大全www.gwdq.cn收集整理]通信协议的转换等问题，这时驱动程序要将请求先传送给网关，如访问DEC RDB和IBM AS/400时的配置,如图5所示。
@@12W03504.GIF;图5 三层配置示意图@@
4. 数据源
数据源由用户想要存取的数据和它相关的操作系统、DBMS及网络环境组成。
四、一致性级别
从应用程序观点来看，最理想的情况是每个数据源和驱动程序都支持同一套ODBC函数调用和SQL语句。但是由于形形色色的DBMS在实现上有很大的差异，它们所依赖的系统和环境也各不相同，在对ODBC支持的程度上就不一致。一致性级别(Conformance Levels)建立了对众多功能的标准划分，为应用程序和驱动程序提供帮助和选择的依据。它划定了驱动程序所支持的ODBC函数和SQL语句的范围，我们可以用SQLGetInfo、SQLGetFunctions、SQLTypeInfo三个函数获知驱动程序所支持的功能集。ODBC从API和SQL语法两方面划分级别。
1. API的一致性
ODBC将函数调用划分为三级。
(1)核心API 它包括了与SAG的CLI相匹配的基本功能，包括：分配与释放环境、连接及语句句柄；连接到数据源；准备并执行SQL语句或立即执行SQL语句；为SQL语句和结果列中的参数分配存储器；从结果中检索数据，检索结果的信息；提交和撤消事务处理；检索错误信息。
(2)一级API 它包括了核心API的全部功能，比如用特定驱动程序的对话框连接到数据源；设置和查询语句值和连接选项；送部分或全部参数值；检索部分和全部结果；检索目录信息；检索关于驱动程序和数据源的信息。
(3)二级API 其功能包括核心和一级API的全部功能；浏览可获得的连接和可获得的数据源列表；发送参数值数组，检索结果数组；检索参数个数及参数描述；应用可卷动的光标；检索SQL语句和本机表格；检索各种目录信息；调用转换DLL。
2. SQL语法的一致性级别
从SQL方面可划分为最小的SQL语法、核心SQL语法和扩展SQL语法三个等级。
五、ODBC的应用与前景
ODBC的出现给用户描绘了一个诱人的前景，即网络中的Windows用户可以方便地访问各种数据库。现在，在微软推出的许多产品中都提供了ODBC支持，如Visal Basic 3.0、Visal C1.5、Excel 5.0、Word 6.0、FoxPro、Access等。同时其他一些应用软件和开发工具也提供了对ODBC的支持。因此用户只要安装不同的ODBC驱动程序，就可存取相应的数据库产品，而不管用户使用何种前台应用软件，也不管后台是何种数据库，这个存取的
本文来自: 公文大全(www.gwdq.com) 详细出处参考：http://www.gwdq.com/lwzx/jsj/jsjll/146960_2.html
过程是一致的。
但是由于ODBC产生的时间还不长，其应用也同时存在着一些问题。首先，它的层次比较多，表现在性能上比专有的API要慢，这是其标准化和开发性所带来的必要的代价；其次，由于ODBC规定了三个层次的一致性级别，应用程序与驱动程序之间的匹配就会出现一些问题和矛盾，比如某些驱动程序支持的级别比较低，而应用程序要求的比较高；再者，由于不同的驱动程序为不同的开发商所开发，测试工作不能统一，而现有的开发和测试工具并不很完善；同时，在非SQL的数据库系统上的应用也存在一些问题。
微软公司将ODBC作为一项很重要的技术，它已承诺进一步改进ODBC技术，为驱动程序开发者提供更先进的开发和测试工具，还将交付系统管理和监控工具，它还将与DBMS厂商和第三方厂商建立更密切的合作，以期使驱动程序支持更高级别的一致性，并在规范化方面有所完善。目前，ODBC已为数据库供应商组织内部所认可，同时为众多应用软件厂商和第三方开发商所使用，相信随着SQL的推广和规范，用户和开发商会更加依赖于这一技术
本文来自: 公文大全(www.gwdq.com) 详细出处参考：http://www.gwdq.com/lwzx/jsj/jsjll/146960_3.html

       cc -o len len.o -q64 -L/home/sqllib/lib64 -ldb2

len.o:len.c

       cc -c -g -q64 -I/home/sqllib/include/ len.c

clean:

       rm -f *.o

SQLAllocStmt() 分配新的语句句柄并将其与连接句柄指定的连接相关联。对于在任何一个时候可以分配的语句句柄数目没有已定义的限制。

在调用此函数之前，必须调用 SQLConnect()。

必须在 SQLBindParam()、SQLPrepare()、SQLExecute()、SQLExecDirect() 或任何其它将语句句柄作为其中一个输入自变量的函数之前调用此函数。

语法

SQLRETURN SQLAllocStmt (SQLHDBC    hdbc,
SQLHSTMT   *phstmt);

函数自变量

表 12. SQLAllocStmt 自变量

数据类型	自变量	使用	描述
SQLHDBC	hdbc	输入	连接句柄
SQLHSTMT *	phstmt	输出	指向语句句柄的指针

用法

DB2 UDB CLI 使用每个语句句柄来使所有描述符、结果值、游标信息和状态信息与已处理的 SQL 语句相关联。虽然每个 SQL 语句都必须要有语句句柄，但可以将句柄重新用于不同的语句。

对此函数的调用要求 hdbc 引用活动的数据库连接。

要执行定位型更新或删除，应用程序必须将不同的语句句柄用于 SELECT 语句和 UPDATE 或 DELETE 语句。

如果指向语句句柄的输入指针（phstmt）指向由先前的 SQLAllocStmt() 调用分配的有效语句句柄，则此调用的结果是覆盖原始值。这是应用程序编程错误，DB2 UDB CLI 不检测此错误。

返回码

• SQL_SUCCESS
• SQL_ERROR
• SQL_INVALID_HANDLE

如果返回 SQL_ERROR，则 phstmt 自变量设置为 SQL_NULL_HSTMT。应用程序应使用同一个 hdbc 来调用 SQLError() 并将 hstmt 自变量设置为 SQL_NULL_HSTMT。

诊断

表 13. SQLAllocStmt SQLSTATE

SQLSTATE	描述	说明
08003	连接未打开	hdbc 自变量指定的连接尚未打开。必须成功地为驱动程序建立连接（并且该连接必须已打开）才能分配 hstmt。
40003 *	未知语句是否完成	在函数完成处理之前，CLI 与数据源之间的通信链路发生故障。
58004	系统错误	不可恢复的系统错误。
HY001	内存分配失败	驱动程序无法分配支持此函数的执行或完成所必需的内存。
HY009	自变量值无效	phstmt 是空指针
HY013 *	内存管理问题	驱动程序无法访问支持此函数的执行或完成所必需的内存。

示例

请参考 SQLFetch()（示例）。

用途

SQLAllocEnv() 分配环境句柄和相关联的资源。

应用程序必须在 SQLAllocConnect() 或任何其它 DB2 UDB CLI 函数之前调用此函数。在以后所有需要环境句柄作为输入的函数调用中，都传送 henv 值。

语法

SQLRETURN SQLAllocEnv (SQLHENV    *phenv);

函数自变量

表 8. SQLAllocEnv 自变量

数据类型	自变量	使用	描述
SQLHENV *	phenv	输出	指向环境句柄的指针

用法

对于每个应用程序，在任何一个时候都只能有一个活动环境。以后任何对 SQLAllocEnv() 的调用将返回现有的环境句柄。

缺省情况下，对 SQLFreeEnv() 所作的第一个成功调用将释放与该句柄相关联的资源。无论成功地调用了多少次 SQLAllocEnv()，都会发生这种情况。如果环境属性 SQL_ATTR_ENVHNDL_COUNTER 设置为 SQL_TRUE，则在释放与句柄相关联的资源之前，必须为每次成功的 SQLAllocEnv() 调用来调用 SQLFreeEnv()。

要确保所有的 DB2 UDB CLI 资源都保持活动状态，调用 SQLAllocEnv() 的程序不应终止或离开堆栈。否则，应用程序将丢失打开的游标、语句句柄和其它已分配的资源。

返回码

• SQL_SUCCESS
• SQL_ERROR

如果返回 SQL_ERROR，并且 phenv 等于 SQL_NULL_HENV，则由于没有句柄可以与附加的诊断信息相关联，所以不能调用 SQLError()。

如果返回码是 SQL_ERROR，并且指向环境句柄的指针不等于 SQL_NULL_HENV，则该句柄是受限句柄。这表示该句柄只能在 SQLError() 的调用中使用以获取更多的错误信息，或者用于 SQLFreeEnv() 的调用。

诊断

表 9. SQLAllocEnv SQLSTATE

SQLSTATE	描述	说明
58004	系统错误	不可恢复的系统错误。

示例

有关代码示例的信息，参见代码不保证声明信息。

/*******************************************************
** file = basiccon.c
**    - demonstrate basic connection to two datasources.
**    - error handling  ignored for simplicity
**
**  Functions used:
**
**    SQLAllocConnect  SQLDisconnect
**    SQLAllocEnv      SQLFreeConnect
**    SQLConnect       SQLFreeEnv
**
**
********************************************************/
#include <stdio.h>
#include <stdlib.h>
#include "sqlcli.h"
int
connect(SQLHENV henv,
SQLHDBC * hdbc);
#define MAX_DSN_LENGTH    18
#define MAX_UID_LENGTH    10
#define MAX_PWD_LENGTH    10
#define MAX_CONNECTIONS   5
int
main()
{
SQLHENV         henv;
SQLHDBC         hdbc[MAX_CONNECTIONS];
/* allocate an environment handle   */
SQLAllocEnv(&henv);
/* Connect to first data source */
connect(henv, &hdbc[0];);
/* Connect to second data source */
connect(henv, &hdbc[1];);
/*********   Start Processing Step  *************************/
/* allocate statement handle, execute statement, etc.       */
/*********   End Processing Step  ***************************/
printf("\nDisconnecting .....\n");
SQLFreeConnect(hdbc[0]);    /* free first connection handle  */
SQLFreeConnect(hdbc[1]);    /* free second connection handle */
SQLFreeEnv(henv);           /* free environment handle       */
return (SQL_SUCCESS);
}
/********************************************************************
**   connect - Prompt for connect options and connect              **
********************************************************************/
int
connect(SQLHENV henv,
SQLHDBC * hdbc)
{
SQLRETURN       rc;
SQLCHAR         server[MAX_DSN_LENGTH + 1], uid[MAX_UID_LENGTH + 1],
pwd[MAX_PWD_LENGTH
+ 1];
SQLCHAR         buffer[255];
SQLSMALLINT     outlen;
printf("Enter Server Name:\n");
gets((char *) server);
printf("Enter User Name:\n");
gets((char *) uid);
printf("Enter Password Name:\n");
gets((char *) pwd);
SQLAllocConnect(henv, hdbc);/* allocate a connection handle     */
rc = SQLConnect(*hdbc, server, SQL_NTS, uid, SQL_NTS, pwd, SQL_NTS);
if (rc != SQL_SUCCESS) {
printf("Error while connecting to database\n");
return (SQL_ERROR);
} else {
printf("Successful Connect\n");
return (SQL_SUCCESS);
}
}

参考

• SQLAllocConnect — 分配连接句柄
• SQLFreeEnv — 释放环境句柄
• SQLAllocStmt — 分配语句句柄

SQLAllocHandle() 分配任何类型的句柄。

语法

SQLRETURN SQLAllocHandle (SQLSMALLINT htype,
SQLINTEGER ihandle,
SQLINTEGER *handle);

函数自变量

表 10. SQLAllocHandle 自变量

数据类型	自变量	使用	描述
SQLSMALLINT	htype	输入	要分配的句柄的类型。必须是 SQL_HANDLE_ENV、SQL_HANDLE_DBC、SQL_HANDLE_DESC 或 SQL_HANDLE_STMT。
SQLINTEGER	ihandle	输入	描述在其中分配新句柄的上下文的句柄；然而，如果 htype 是 SQL_HANDLE_ENV，则这是 SQL_NULL_HANDLE。
SQLINTEGER *	handle	输出	指向句柄的指针

用法

此函数组合了函数 SQLAllocEnv()、SQLAllocConnect() 和 SQLAllocStmt()。

如果 htype 是 SQL_HANDLE_ENV，则 ihandle 必须是 SQL_NULL_HANDLE。如果 htype 是 SQL_HANDLE_DBC，则 ihandle 必须是有效的环境句柄。如果 htype 是 SQL_HANDLE_DESC 或 SQL_HANDLE_STMT，则 ihandle 必须是有效的连接句柄。

返回码

• SQL_SUCCESS
• SQL_ERROR
• SQL_INVALID_HANDLE

SQLSetConnectAttr() 设置特定连接的连接属性。

语法

SQLRETURN SQLSetConnectAttr  (SQLHDBC     hdbc,
SQLINTEGER  fAttr,
SQLPOINTER  vParam,
SQLINTEGER  sLen);

函数自变量

表 146. SQLSetConnectAttr 自变量

数据类型	自变量	使用	描述
SQLHDBC	hdbc	输入	连接句柄
SQLINTEGER	fAttr	输入	要设置的连接属性，有关更多信息，请参考表 147。
SQLPOINTER	vParam	输入	与 fAttr 相关联的值。根据选项的不同，这可以是指向 32 位整数值的指针，也可以是字符串。
SQLINTEGER	sLen	输入	如果输入值是字符串的话，此自变量就是它的长度；否则不使用此自变量。

用法

通过 SQLSetConnectAttr() 设置的所有连接和语句选项都将持续到调用 SQLFreeConnect() 或下次调用 SQLSetConnectAttr() 时为止。

通过 vParam 设置的信息的格式取决于所指定的 fAttr。选项信息可以是 32 位整数，也可以是指向以空终止的字符串的指针。

表 147. 连接选项

fAttr	内容
SQL_ATTR_AUTOCOMMIT	32 位的值，它设置连接的落实行为。可能的值列示如下： SQL_TRUE — 在执行 SQL 语句时自动落实每个 SQL 语句。 SQL_FALSE — 不自动落实 SQL 语句。如果在具有落实控制的环境下运行，则必须使用 SQLEndTran() 或 SQLTransact() 来显式地落实或回滚更改。
SQL_ATTR_COMMIT 或 SQL_TXN_ISOLATION	32 位的值，它设置 hdbc 所引用的当前连接的事务隔离级别。DB2 UDB CLI 接受下列值，但每个服务器都可能只支持这些隔离级别的其中某一些： SQL_TXN_NO_COMMIT — 未使用落实控制。 SQL_TXN_READ_UNCOMMITTED — 脏读取、不可重复读取和幻象读取是有可能的。 SQL_TXN_READ_COMMITTED — 脏读取是不可能的。不可重复读取和幻象读取是有可能的。 SQL_TXN_REPEATABLE_READ — 脏读取和不可重复读取是不可能的。幻象读取是有可能的。 SQL_TXN_SERIALIZABLE — 事务是可序列化的。脏读取、不可重复读取和幻象都是不可能的。 在 IBM 术语中： SQL_TXN_READ_UNCOMMITTED 是指“未落实的读取”； SQL_TXN_READ_COMMITTED 是指“游标稳定性”； SQL_TXN_REPEATABLE_READ 是指“读取稳定性”； SQL_TXN_SERIALIZABLE 是指“可重复读取”。 有关“隔离级别”的详细说明，请参考 IBM SQL Reference。 应该在调用 SQLConnect() 之前设置 SQL_ATTR_COMMIT 属性。如果在建立连接之后更改了值，并且该连接是与远程数据源的连接，则在下一次对连接句柄成功调用 SQLConnect() 之前，此更改不会生效。
SQL_ATTR_DATE_FMT	32 位的整数值，这个值可以是： SQL_FMT_ISO — 使用“国际标准化组织”（ISO）日期格式 yyyy-mm-dd。这是缺省值。 SQL_FMT_USA — 使用美国日期格式 mm/dd/yyyy。 SQL_FMT_EUR — 使用欧洲日期格式 dd.mm.yyyy。 SQL_FMT_JIS — 使用“日本工业标准”日期格式 yyyy-mm-dd。 SQL_FMT_MDY — 使用日期格式 mm/dd/yyyy。 SQL_FMT_DMY — 使用日期格式 dd/mm/yyyy。 SQL_FMT_YMD — 使用日期格式 yy/mm/dd。 SQL_FMT_JUL — 使用儒略日期格式 yy/ddd。 SQL_FMT_JOB — 使用作业缺省值。
SQL_ATTR_DATE_SEP	32 位的整数值，这个值可以是： SQL_SEP_SLASH — 使用斜杠（/）作为日期分隔符。这是缺省值。 SQL_SEP_DASH — 使用破折号（-）作为日期分隔符。 SQL_SEP_PERIOD — 使用句点（.）作为日期分隔符。 SQL_SEP_COMMA — 使用逗号（,）作为日期分隔符。 SQL_SEP_BLANK — 使用空格作为日期分隔符。 SQL_SEP_JOB — 使用作业缺省值。
SQL_ATTR_DBC_DEFAULT_LIB	一个字符值，这个值指示将用于解析未限定文件引用的缺省库。如果连接正在使用系统命名方式，则此项无效。
SQL_ATTR_DBC_SYS_NAMING	32 位的整数值，这个值可以是： SQL_TRUE — DB2 UDB CLI 使用 iSeries 系统命名方式。使用斜杠（/）定界符来限定文件。使用作业的库列表来解析未限定的文件。 SQL_FALSE — DB2 UDB CLI 使用缺省命名方式，即 SQL 命名。使用句点（.）定界符来限定文件。使用缺省库或当前用户标识来解析未限定的文件。
SQL_ATTR_DECIMAL_SEP	32 位的整数值，这个值可以是： SQL_SEP_PERIOD — 使用句点（.）作为小数分隔符。这是缺省值。 SQL_SEP_COMMA — 使用逗号（,）作为日期分隔符。 SQL_SEP_JOB — 使用作业缺省值。
SQL_ATTR_EXTENDED_COL_INFO	32 位的整数值，这个值可以是： SQL_TRUE — 可以在 SQLColAttributes() 上使用对此连接句柄分配的语句句柄来检索扩展的列信息，如“基本表”、“基本模式”、“基本列”和“标号”。 SQL_FALSE — 不能在 SQLColAttributes() 函数上使用对此连接句柄分配的语句句柄来检索扩展的列信息。这是缺省值。
SQL_ATTR_TIME_FMT	32 位的整数值，这个值可以是： SQL_FMT_ISO — 使用“国际标准化组织”（ISO）时间格式 hh.mm.ss。这是缺省值。 SQL_FMT_USA — 使用美国时间格式 hh:mmxx，其中 xx 是 AM 或 PM。 SQL_FMT_EUR — 使用欧洲时间格式 hh.mm.ss。 SQL_FMT_JIS — 使用“日本工业标准”时间格式 hh:mm:ss。 SQL_FMT_HMS — 使用 hh:mm:ss 格式。
SQL_ATTR_TIME_SEP	32 位的整数值，这个值可以是： SQL_SEP_COLON — 使用冒号（:）作为时间分隔符。这是缺省值。 SQL_SEP_PERIOD — 使用句点（.）作为时间分隔符。 SQL_SEP_COMMA — 使用逗号（,）作为时间分隔符。 SQL_SEP_BLANK — 使用空格作为时间分隔符。 SQL_SEP_JOB — 使用作业缺省值。
SQL_SAVEPOINT_NAME	一个字符值，它指示 SQLEndTran() 要对函数 SQL_SAVEPOINT_NAME_ROLLBACK 或 SQL_SAVEPOINT_NAME_RELEASE 使用的保存点名称。
SQL_2ND_LEVEL_TEXT	32 位的整数值，这个值可以是： SQL_TRUE — 通过调用 SQLError() 获取的错误文本将包含关于错误的完整文本描述。 SQL_FALSE — 通过调用 SQLError() 获取的错误文本将只包含关于错误的第一个级别的描述。这是缺省值。

返回码

• SQL_SUCCESS
• SQL_SUCCESS_WITH_INFO
• SQL_ERROR
• SQL_INVALID_HANDLE

诊断

表 148. SQLSetConnectAttr SQLSTATE

SQLSTATE	描述	说明
HY001	内存分配失败	驱动程序无法分配支持此函数的执行或完成所必需的内存。
HY009	自变量值无效	给定 fAttr 值，对自变量 vParam 指定了无效的值。 指定了无效的 fAttr 值。