C中的sqlca.h

#if !(defined(SQLCODE) || defined(SQLCADE))

#include "sqlsystm.h"                     

#if (defined(DB2OS2) || defined(DB2NT)) #pragma pack(4) #elif (defined(DB2WIN)) #pragma pack(2) #elif (defined(DB2MAC)) #if (defined(DB2PPC)) #pragma align 4 #elif (defined(DB268K)) #pragma align 2 #endif #elif (defined(DB2HP) || defined(DB2SNI))

#elif (defined(DB2SUN) && defined(__xlC__)) #pragma options align=natural #elif (defined(DB2AIX) && defined(__64BIT__)) #pragma options align=natural #elif (defined(DB2AIX)) #pragma options align=power #endif

SQL_STRUCTURE  sqlca {    _SQLOLDCHAR    sqlcaid[8];              sqlint32       sqlcabc;              #ifdef DB2_SQL92E    sqlint32       sqlcade;              #else    sqlint32       sqlcode;              #endif    short          sqlerrml;                _SQLOLDCHAR    sqlerrmc[70];        

   _SQLOLDCHAR    sqlerrp[8];          

   sqlint32       sqlerrd[6];              _SQLOLDCHAR    sqlwarn[11];         

#ifdef DB2_SQL92E    _SQLOLDCHAR    sqlstat[5];           #else    _SQLOLDCHAR    sqlstate[5];          #endif

};

#ifdef DB2_SQL92E #define   SQLCADE        sqlca.sqlcade #else #define   SQLCODE        sqlca.sqlcode #endif #define   SQLWARN0       sqlca.sqlwarn[0] #define   SQLWARN1       sqlca.sqlwarn[1] #define   SQLWARN2       sqlca.sqlwarn[2] #define   SQLWARN3       sqlca.sqlwarn[3] #define   SQLWARN4       sqlca.sqlwarn[4] #define   SQLWARN5       sqlca.sqlwarn[5] #define   SQLWARN6       sqlca.sqlwarn[6] #define   SQLWARN7       sqlca.sqlwarn[7] #define   SQLWARN8       sqlca.sqlwarn[8] #define   SQLWARN9       sqlca.sqlwarn[9] #define   SQLWARNA       sqlca.sqlwarn[10]

#define   SQL_CMP_NA_ERRORS       1 #define   SQL_CMP_ROWS_AFFECTED   2 #define   SQL_CMP_STMTS_COMPLETED 3 #define   SQL_CMP_REF_INT_ROWS    4

#define   SQL_CONNECT_DB_APP2DB_CONVFACTOR     0 #define   SQL_CONNECT_DB_DB2APP_CONVFACTOR     1 #define   SQL_CONNECT_DB_UPDATEABILITY_IN_UOW  2 #define   SQL_CONNECT_DB_COMMIT_TYPE           3

#define   SQL_DB_UPDATEABLE                    1 #define   SQL_DB_READ_ONLY                     2

#define   SQL_DB_ONE_PHASE_COMMIT              1 #define   SQL_DB_ONE_PHASE_READ_ONLY           2 #define   SQL_DB_TWO_PHASE_COMMIT              3

#if (defined(DB2OS2) || defined(DB2NT) || defined(DB2WIN)) #pragma pack() #elif (defined(DB2MAC)) #pragma align #elif (defined(DB2HP) || defined(DB2SNI))

#elif (defined(DB2AIX) || (defined(DB2SUN) && defined(__xlC__))) #pragma options align=reset #endif

#endif

SQLCA（SQL Communication Access）

SQLCA是一个存储区域，将统计和错误从应用程序传递到数据库服务器再传回应用程序的每个数据库请求会使用它。SQLCA 用作应用程序到数据库的通信链接的句柄。它会被传递到需要与数据库服务器进行通信的所有数据库库函数中。它会在所有嵌入式 SQL 语句上被隐式传递。 　　全局 SQLCA 变量在接口库中定义。预处理器会为全局 SQLCA 变量生成外部引用，并且会为该变量的指针生成外部引用。该外部引用名为 sqlca，类型为 SQLCA。指针名为 sqlcaptr。实际的全局变量在导入库中声明。 　　SQLCA 由 sqlca.h 头文件定义，该文件包括在安装目录的 h 子目录中。

　　SQLCA 字段

　　SQLCA 中的字段具有以下含义：

　　*sqlcaid8 字节字符字段，包含作为 SQLCA 结构标识的字符串 SQLCA。在您查看内存内容时，该字段可帮助进行调试。

　　*sqlcabc包含 SQLCA 结构的长度（136 字节）的长型整数。

　　*sqlcode数据库在请求上检测到错误时，指定错误代码的长整数。错误代码的定义可在头文件 sqlerr.h 中找到。成功操作的错误代码是 0（零），正数表示警告，负数表示错误。

　　有关错误代码的完整列表，请参见 ASA 错误消息。

　　*sqlerrmlsqlerrmc 字段中信息的长度。

　　*sqlerrmc要插入到错误消息中的零个或多个字符串。某些错误消息包含一个或多个占位字符串（%1、%2、...），这些占位字符串可替换为此字段中的字符串。

　　例如，如果生成未找到表错误，则 sqlerrmc 包含表名，该表名要插入到错误消息中的适当位置。

　　有关错误消息的完整列表，请参见 ASA 错误消息。

　　*sqlerrp保留。

　　*sqlerrd长整数的实用程序数组。

　　*sqlwarn保留。

　　*sqlstateSQLSTATE 状态值。除了以前标准中的 SQLCODE 值外，ANSI SQL 标准 (SQL-92) 还定义了 SQL 语句的一种新类型的返回值。SQLSTATE 值始终是一个由五个字符组成且以空值终止的字符串，它分为双字符类（前两个字符）和三字符子类。每个字符都可以是从 0 到 9 的数字或从 A 到 Z 的大写字母字符。

　　以 0 到 4 或 A 到 H 开头的任何类或子类都是由 SQL 标准定义的，其它类和子类则是各实现自行定义的。SQLSTATE 值 '00000' 表示还没有错误或警告。

　　有关更多的 SQLSTATE 值，请参见 ASA 错误消息。

　　sqlerror 数组

　　sqlerror 字段数组具有以下元素。

　　*[b]sqlerrd[1] (SQLIOCOUNT)[/b] 完成命令所需的实际输入/输出操作数。

　　数据库执行每个命令之前不会清零。在执行一个命令序列之前，您的程序可以将此变量设置为零。在最后一个命令执行之后，此数字是整个命令序列的输入/输出操作的总数。

　　*[b]sqlerrd[2] (SQLCOUNT)[/b] 此字段的值取决于要执行的语句。

　　o INSERT、UPDATE、PUT 和 DELETE 语句受语句影响的行数。

　　在游标 OPEN 上，该字段由游标中的实际行数（大于或等于 0 的值）或它的估计数（绝对值是估计数的负数）填充。如果数据库服务器不统计该值即可计算出行数，则该值就是实际行数。也可以使用 ROW_COUNT 选项，将数据库配置为始终返回实际的行数。

　　o FETCH 游标语句如果返回 SQLE_NOTFOUND 警告，则填充 SQLCOUNT 字段。它包含 FETCH RELATIVE 或 FETCH ABSOLUTE 语句超出可能的游标位置（游标可以位于某一行上、第一行之前或最后一行之后）范围之外的行数。在宽读取的情况下，SQLCOUNT 是实际读取的行数，它小于或等于请求的行数。在宽读取过程中，不 设置 SQLE_NOTFOUND。

　　有关宽读取的详细信息，请参见一次读取多个行。

　　如果未找到行但位置有效，则值为 0，例如，当定位在游标的最后一行上时执行 FETCH RELATIVE 1。如果所尝试的读取超出了游标的末尾，则为正值；如果所尝试的读取位于游标开头的前面，则为负值。

　　oGET DATA 语句SQLCOUNT 字段保存值的实际长度。

　　oDESCRIBE 语句在用于说明可能具有多个结果集的过程的 WITH VARIABLE RESULT 子句中，SQLCOUNT 设置为以下值之一：

　　+0 结果集可能会有变化：在每个 OPEN 语句之后应再次说明过程调用。

　　+1 结果集是固定的。不需要再次进行说明。

　　在出现语法错误 SQLE_SYNTAX_ERROR 的情况下，此字段包含命令字符串内检测到错误的大致字符位置。

　　*[b]sqlerrd[3] (SQLIOESTIMATE)[/b] 完成命令所需的输入/输出操作的估计数。在 OPEN 或 EXPLAIN 命令上将给此字段赋一个值。

　　========================================================================================

　　可引用 SQLCA 测试特定错误代码。当数据库请求有错误时，sqlcode 和 sqlstate 字段包含错误代码。某些 C 宏是为引用 sqlcode 字段、sqlstate 字段和某些其它字段而定义的。

　　=======================================================================

　　如果一个 SQL 语句发生了错误，那么 sqlca.sqlcode 将是非零值。　　如果 sqlca.sqlcode 小于 0 那么就是发生了某种严重的错误，象数据库定义与查询定义不一致等．　　如果大于 0 则是通常的错误，象表不包括所要求的行等．　　sqlca.sqlcode == 0，成功　　sqlca.sqlcode == -1 失败（获取具体失败信息：messagebox('',"出错信息:"+sqlca.SQLErrText) ）--PB里的操作方法　　可能发生的错误列表：　　-12, Out of memory in line %d. 　　通常不出现这个错误。这是你的虚拟内存耗尽的标志。 　　-200, Unsupported type %s on line %d. 　　通常不出现这个错误．这表明预编译器生成了一些库（函数）不认得的东西．可能你运行的预编译器和当前库不兼容． 　　-201, Too many arguments line %d. 　　这意味着 Postgres 返回了比我们的匹配变量更多的参数．可能你漏了几个INTO :var1,:var2-列表里的宿主变量． 　　-202, Too few arguments line %d. 　　这意味着 Postgres 返回了比我们的对应宿主变量要少的参数．可能你多输入了几个INTO :var1,:var2-列表里的宿主变量． 　　-203, Too many matches line %d. 　　着意味着查询返回了多个行，但你声明的变量不是数组．你执行的 SELECT 可能不是唯一的． 　　-204, Not correctly formatted int type: %s line %d. 　　着意味着宿主变量是一个 int 类型并且 Postgres 数据库里的字段是另一种类型，包含着一个不能转换成一个 int 类型的数值．库（函数）使用 strtol 做此类转换． 　　-205, Not correctly formatted unsigned type: %s line %d. 　　着意味着宿主变量是一个 unsigned int（无符号整数）类型而Postgres 数据库里的字段是另外一种类型并且包含一个不能转换成unsigned int 的数值．库（函数）使用 strtoul 做这类转换． 　　-206, Not correctly formatted floating point type: %s line %d. 　　着意味着宿主变量是一个 float （浮点）类型而 Postgres 数据库里的字段是另外一种类型并且包含一个不能转换成 float 的数值．库（函数）使用 strtod 做这类转换． 　　-207, Unable to convert %s to bool on line %d. 　　这意味着宿主变量是一个 bool （布尔）类型，而 Postgres 数据库里的字段值既不是 't' 也不是 'f'。 　　-208, Empty query line %d. 　　Postgres 返回 PGRES_EMPTY_QUERY，可能的原因是该查询实际上是空的。 　　-220, No such connection %s in line %d. 　　程序试图访问一个不存在的联接。 　　-221, Not connected in line %d. 　　程序试图访问一个存在的，但是没有打开的联接。 　　-230, Invalid statement name %s in line %d. 　　你试图使用的语句还没准备好。 　　-400, Postgres error: %s line %d. 　　某种 Postgres 错误。该消息包含来自 Postgres 后端的信息。 　　-401, Error in transaction processing line %d. 　　Postgres 给我们的信号，表明我们无法开始，提交或者回卷该事务。 　　-402, connect: could not open database %s. 　　与数据库的联接无法工作。 　　sqlca.sqlcode == 100, Data not found line %d. 　　这是一个"正常的"错误，告诉你你正在查询的东西找不到或者我们已经越过了游标的范围。

　　=======================================================================

何时使用多个 SQLCA

如果多个线程使用同一 SQLCA，上下文切换会导致多个线程同时使用该 SQLCA。每个线程都必须具有它自己的 SQLCA。当 DLL 使用嵌入式 SQL 且被应用程序中的多个线程调用时，也会发生这种情况。

　　* 动态链接库和共享库DLL 只有一个数据段。数据库服务器在处理一个应用程序发出的请求时，也可能会优先处理另一个应用程序向该数据库服务器发出的请求。如果您的 DLL 使用全局 SQLCA，则这两个应用程序会同时使用它。每个 Windows 应用程序都必须具有它自己的 SQLCA。

　　* 具有一个数据段的 DLL可以将 DLL 创建为只有一个数据段，或者对于每个应用程序有一个数据段。如果您的 DLL 只有一个数据段，则无法使用全局 SQLCA，其原因与 DLL 无法使用全局 SQLCA 的原因相同。每个应用程序必须具有它自己的 SQLCA。

　　=======================================================================

　　#ifndef POSTGRES_SQLCA_H

　　#define POSTGRES_SQLCA_H

　　#ifndef DLLIMPORT

　　#ifdef __CYGWIN__

　　#define DLLIMPORT __declspec (dllimport)

　　#else

　　#define DLLIMPORT

　　#endif

　　#endif

　　#define SQLERRMC_LEN 70

　　#ifdef __cplusplus

　　extern "C"{

　　#endif

　　struct sqlca

　　{

　　char sqlcaid[8];

　　long sqlabc;

　　long sqlcode;

　　struct

　　{

　　int sqlerrml;

　　char sqlerrmc[SQLERRMC_LEN];

　　} sqlerrm;

　　char sqlerrp[8];

　　long sqlerrd[6];

　　 char sqlwarn[8];

　　char sqlext[8];

　　};

　　extern DLLIMPORT struct sqlca sqlca;

　　#ifdef __cplusplus

　　}

　　#endif

　　#endif

SQLCA 字段　　SQLCA 中的字段具有以下含义：　　*sqlcaid8 字节字符字段，包含作为 SQLCA 结构标识的字符串 SQLCA。在您查看内存内容时，该字段可帮助进行调试。　　*sqlcabc包含 SQLCA 结构的长度（136 字节）的长型整数。　　*sqlcode数据库在请求上检测到错误时，指定错误代码的长整数。错误代码的定义可在头文件 sqlerr.h 中找到。成功操作的错误代码是 0（零），正数表示警告，负数表示错误。　　有关错误代码的完整列表，请参见 ASA 错误消息。　　*sqlerrmlsqlerrmc 字段中信息的长度。　　*sqlerrmc要插入到错误消息中的零个或多个字符串。某些错误消息包含一个或多个占位字符串（%1、%2、...），这些占位字符串可替换为此字段中的字符串。　　例如，如果生成未找到表错误，则 sqlerrmc 包含表名，该表名要插入到错误消息中的适当位置。　　有关错误消息的完整列表，请参见 ASA 错误消息。　　*sqlerrp保留。　　*sqlerrd长整数的实用程序数组。　　*sqlwarn保留。　　*sqlstateSQLSTATE 状态值。除了以前标准中的 SQLCODE 值外，ANSI SQL 标准 (SQL-92) 还定义了 SQL 语句的一种新类型的返回值。SQLSTATE 值始终是一个由五个字符组成且以空值终止的字符串，它分为双字符类（前两个字符）和三字符子类。每个字符都可以是从 0 到 9 的数字或从 A 到 Z 的大写字母字符。　　以 0 到 4 或 A 到 H 开头的任何类或子类都是由 SQL 标准定义的，其它类和子类则是各实现自行定义的。SQLSTATE 值 '00000' 表示还没有错误或警告。　　有关更多的 SQLSTATE 值，请参见 ASA 错误消息。　　sqlerror 数组　　sqlerror 字段数组具有以下元素。　　*[b]sqlerrd[1] (SQLIOCOUNT)[/b] 完成命令所需的实际输入/输出操作数。　　数据库执行每个命令之前不会清零。在执行一个命令序列之前，您的程序可以将此变量设置为零。在最后一个命令执行之后，此数字是整个命令序列的输入/输出操作的总数。　　*[b]sqlerrd[2] (SQLCOUNT)[/b] 此字段的值取决于要执行的语句。　　o INSERT、UPDATE、PUT 和 DELETE 语句受语句影响的行数。　　在游标 OPEN 上，该字段由游标中的实际行数（大于或等于 0 的值）或它的估计数（绝对值是估计数的负数）填充。如果数据库服务器不统计该值即可计算出行数，则该值就是实际行数。也可以使用 ROW_COUNT 选项，将数据库配置为始终返回实际的行数。　　o FETCH 游标语句如果返回 SQLE_NOTFOUND 警告，则填充 SQLCOUNT 字段。它包含 FETCH RELATIVE 或 FETCH ABSOLUTE 语句超出可能的游标位置（游标可以位于某一行上、第一行之前或最后一行之后）范围之外的行数。在宽读取的情况下，SQLCOUNT 是实际读取的行数，它小于或等于请求的行数。在宽读取过程中，不 设置 SQLE_NOTFOUND。　　有关宽读取的详细信息，请参见一次读取多个行。　　如果未找到行但位置有效，则值为 0，例如，当定位在游标的最后一行上时执行 FETCH RELATIVE 1。如果所尝试的读取超出了游标的末尾，则为正值；如果所尝试的读取位于游标开头的前面，则为负值。　　oGET DATA 语句SQLCOUNT 字段保存值的实际长度。　　oDESCRIBE 语句在用于说明可能具有多个结果集的过程的 WITH VARIABLE RESULT 子句中，SQLCOUNT 设置为以下值之一：　　+0 结果集可能会有变化：在每个 OPEN 语句之后应再次说明过程调用。　　+1 结果集是固定的。不需要再次进行说明。　　在出现语法错误 SQLE_SYNTAX_ERROR 的情况下，此字段包含命令字符串内检测到错误的大致字符位置。　　*[b]sqlerrd[3] (SQLIOESTIMATE)[/b] 完成命令所需的输入/输出操作的估计数。在 OPEN 或 EXPLAIN 命令上将给此字段赋一个值。