ESQL编程使用说明.doc

1、ESQL 编程使用说明 第一章 ESQL 介绍 本章对 ESQL 做一概括介绍,主要讨论怎么使用 ESQL、ESQL 的基本的概念和定义、ESQL程序的各个部分和 ESQL 程序中语句的类型. SQL 语言是非过程化语言,大部分语句的执行与其前面或后面的语句无关,而一些高级编程语言都是基于如循环,条件等结构的过程化语言,尽管 SQL 语言非常有力,但它却没有过程化能力.若把 SQL 语言嵌入到过程化的编程语言中,则利用这些结构,程序开发人员就能设计出更加灵活的应用系统,具有 SQL 语言和高级编程语言的良好特征,它将比单独使用 SQL 或 C语言具有更强的功能和灵活性. COBASE RDBM

2、S 提供两种工具在主语言中编程来存取 COBASE 数据库中的数据.即高级语言预编译程序接口(ESQL)和高级语言的函数调用接口(CCI).目前这些工具仅支持 C 语言. COBASE RDBMS 提供的 ESQL 工具把含有 SQL 语句的 C 程序转化为可存取和操纵COBASE 数据库中数据的 C 程序,作为一编译器,ESQL 把输入文件中的 EXEC SQL 语句在输出文件中转化为适当的 CCI 函数调用.输出文件则可以正常的 C 程序的方式被编译、连接和执行. 1.1 ESQL 中的基本概念 ESQL 中的基本概念主要有: 1.嵌入的 SQL 语句: 嵌入的 SQL 语句是指在应用程序

3、中使用的 SQL 语句.该应用程序称作宿主程序,书写该程序的语言称作宿主语言.嵌入的 SQL 语句与交互式 SQL 语句在语法上没有太大的差别,只是嵌入式 SQL 语句在个别语句上有所扩充.如嵌入式 SQL 中的 SELECT 语句增加了 INTO 子句,以便与宿主语言变量打交道.此外,嵌入式 SQL 为适合程序设计语言的要求,还增加了许多语句,如游标的定义、打开和关闭语句等等. 2.执行性 SQL 语句和说明性 SQL 语句: 嵌入的 SQL 语句主要有两种类型:执行性 SQL 语句和说明性 SQL 语句.执行性 SQL 语句可用来连接 COBASE,定义、查询和操纵 COBASE 数据库中

4、的数据,每一执行性语句真正对数据库进行操作 ,执行完成后,在 USERCA 中存放执行信息.说明性语句用来说明通讯域和SQL 语句中用到的变量. 说明性语句不生成执行代码,对 USERCA 不产生影响. 3.事务: 事务是逻辑上相关的一组 SQL 语句.COBASE 把它们视作一个单元.为了保持数据库的一 致性,一事务内的所有操作要么都做,要么都不做. 1.2 ESQL 程序的组成和运行 在 ESQL 程序 中嵌入的 SQL 语句以 EXEC 作为起始标识,语句的结束以“;“作为标识.在嵌入的 SQL 语句可以使用主语言(这时是 C 语言)的程序变量( 即主变量),这时主变量名前加冒号(作为标

5、志,以区别于字段名 . ESQL 程序包括两部分:程序首部和程序体 .程序首部定义变量,为 ESQL 程序做准备, 程序体包括各种 SQL 语句来操纵 COBASE 数据库中的数据. 编制并运行 ESQL 程序比单独使用纯 C 语言多一个预编译过程,通常具有以下几个步骤: 1.编辑 ESQL 程序(可利用编辑软件如 : EDLIN, WS 等进行编辑).程序保后缀为.ec. 2.使用 COBASE 的预编译器 ETE 对 ESQL 源程序进行预处理,该编译器将源程序中嵌入的SQL 语言翻译成标准 C 语言 ,产生一个 C 语言编译器能直接进 行编译的文件.其文件的扩展名为.cpp。该 cpp

6、文件可以和普通的 cpp 文件一样被放入一个工程中被 C+编译器编译，连接最后运行。 对 COBASE 的预编译器的使用的详细说明见第六章. 第二章 ESQL 程序的基本结构 ESQL 程序由两部分组成:程序首部和程序体 . 2.1 程序首部 每一个 ESQL 程序的开始,就是程序的首部,它包括以下三部分: 1.DECLARE 部分: 说明特殊的主变量,这些变量区别于纯 C 语言程序中的变量,COBASE 使用这些变量与程序之间相互作用. 2.INCLUDE USERCA 语句: 说明一个 SQL 语句的通讯域(USERCA),它提供了错误处理,其功能等价于代替 C 语言中的#INCLUDE

7、语句. 3.CONNECT 语句: 建立程序与 COBASE 之间的连接. 2.1.1DECLARE 部分:(描述部分) 在 DECLARE SECTION (描述部分),定义所有在 SQL 语句中用到的主变量,定义部分是以: EXEC SQL BEGIN DECLARE SECTION; 和 EXEC SQL END DECLARE SECTION; 开始和结束的. 在这两个语句中,只可以定义 SQL 语句中用到的主变量,每个预编译单元只允许一个BEGIN/END DECLARE SECTION (描述部分), 但是一个程序可以包含许多独立的预编译单元。若一个主变量或指示变量在 ESQL 程

8、序中的 SQL 语句中引用,但它没有在 描述部分中定义,则程序在预编译时就会出现错误信息. 在这两个语 句中可以定义的变量有六种类型:INT,SHORT,CHAR,FLOAT,NUMBER,DATE.其中 CHAR 型允许定义二维数组,其它类型只允许定义一维数组,不允许有指针类型 ,在此处变量可以赋值. 例如: EXEC SQL BEGIN DECLARE SECTION; int sno; char sname11; short snameid; EXEC SQL END DECLARE SECTION; (1)主变量: 就是用在 SQL 语句中的主语言变量.主要用于程序变量和数据库内部交换

9、数据之用,它们的数据类型必须是在主语言中描述部分里定义过的,而且它们的数据类型必须和 COBASE 数据库中已定义的表中的数据类型相匹配. 例如: SELECT 姓名, 等级 FROM 供应商 INTO :sname, :status WHERE 供应商号 =:sno; 该语句表示,从供应商表中在供应商号与主变量 sno 一致的地方选择供应商姓名和供应商等级,COBASE 把结果传送到主变量 sname,status 中. 主变量使用规则: 1.必须在描述部分明确定义. 2.必须使用与其定义相同的大小写格式. 3.在 SQL 语句中使用主变量时必须在主变量前写一个冒号“:“,在纯 C 语言 语

10、句中则不要在主变量前写冒号. 4.不能是 SQL 命令的保 留字. 5.在一条语句中只能使用一次. 2.1.2 SQL 通讯域 每个 COBASE 应用程序必须提供对错误 的处理,为了说明 SQL 通讯域(USERCA), 必须在每个 COBASE 预编译程序中写上: EXEC SQL INCLUDE USERCA; USERCA 是一结构 ,每一嵌入的执行性 SQL 语言的执行情况在其执行完成后写入 USERCA结构中的各变量中, 根据 USERCA 中的内容可以获得每一嵌入 SQL 语句执行后的信息,编制程序时就可以做适当的处理.对其的详细说明见第五章. 2.1.3 连接 COBASE 在

11、 存取 COBASE 数据之前,每一个预编译程序必须与 COBASE 连接.连接时,程序必须提供用户名和口令,由 COBASE 进行校验,若口令和用户名正确,方可登录 COBASE,获得使用权,否则,COBASE 拒绝登录,则程序就不能使用数据库.缺省的用户名为“cobase ”，口令为“cobase”。 连接 COBASE 的格式如下: EXEC SQL CONNECT :. CONNECT 语句必须是 ESQL 程序中第一条可执行的 SQL 语句. 2.2 程序体 程序体可以包含许多 SQL 语句,以查询或处理存储在 COBASE 数据库中的数据. 在应用程序中所包含的 SQL 语句,可以

12、查询或操纵存储在 COBASE 中的数据,这些语句叫 做数据操纵语言(DML), 应用程序体也可以包含 DDL 语句,用来建立或定义数据结构,如表、视图或索引.在用户程序中写入的任何有效的 SQL 语句都可以被执行，只需要把完整的SQL 语句按嵌入式的要求写入 C 语言的合适位置即可.嵌入在 C 语言中的 SQL 语句以EXEC SQL 开始,以“;“为结束标志.SQL 语句中可以嵌入主变量,主变量前应有“:“标志.如下面例子都 是嵌入式 SQL 语句: EXEC SQL UPDATE 供应商 SET 姓名=李 红 WHERE 供应商号 =S1; /* 把供应商号是 S1 的供应商姓名改为 李

13、 红*/ EXEC SQL INSERT INTO 供应商 (供应商号,姓名,等级,城市) VALUES(:sno,:sname,:status,:city); /* 根据宿主变量值插入供应商表中 */ EXEC SQL DELETE FROM 供应商 WHERE 等级 IS NULL; /*删除供应商等级是空值的供应商 */ 从上面例可以看出,静态的增,删,改语句与交互方式没有太大的差别,对于查询语句就没有那么简单,查询语句在下一章中介绍. 现用几个例题程序加以说明. 例题程序 1 (建立一表并向表中插入数据 ) /*= This is a sample program which incl

14、ude SQL sentence about CREATE ,INSERT a table. =*/ EXEC SQL BEGIN DECLARE SECTION ; CHAR sno10,sname10,city10; INT status; EXEC SQL END DECLARE SECTION ; EXEC SQL INCLUDE USERCA; main() int i; EXEC SQL CONNECT “cobase:cobase“ ; EXEC SQL CREATE TABLE S_TEST /* Create a table named S_TEST */ (SNO CHAR

15、 (9), SNAME CHAR (20), STATUS INT ,CITY CHAR(10); printf(“ create table success,insert?“); printf(“ 0 - no “); printf(“ 1 - yes “); printf(“ choice:“); scanf(“%d“, while(i) printf(“input sno:“); scanf(“%s“,sno); printf(“input sname:“); scanf(“%s“,sname); printf(“input status:“); scanf(“%d“, printf(“

16、input city:“); scanf(“%s“,city); EXEC SQL INSERT INTO S_TEST(SNO,SNAME,STATUS,CITY) VALUES (:sno,:sname,:status,:city); printf(“continue?“); printf(“ 0 -terminate “); printf(“ 1 -continue “); printf(“ choice:“); scanf(“%d“, EXEC SQL COMMIT; EXEC SQL DISCONNECT; /*log off database*/ exit(0); 例题程序 2 (

17、修改和删除表中的数据 ) /*= This is a sample program which include SQL sentence about UPDATE,DELETE a table. =*/ EXEC SQL BEGIN DECLARE SECTION ; CHAR sno10,sname10,city10; INT status; EXEC SQL END DECLARE SECTION ; EXEC SQL INCLUDE USERCA; main() int i; printf(“Now exec connect .“); EXEC SQL CONNECT “COBASE:C

18、OBASE“ ; printf(“ update?“); printf(“ 0 - no “); printf(“ 1 - yes “); printf(“ choice:“); scanf(“%d“, while(i) printf(“input sno:“); scanf(“%s“,sno); printf(“input sname:“); scanf(“%s“,sname); printf(“input status:“); scanf(“%d“, printf(“input city:“); scanf(“%s“,city); EXEC SQL UPDATE S_TEST SET sn

19、ame=:sname,city=:city ,status=:status WHERE sno=:sno; printf(“ continue?“); printf(“ 0 -no “); printf(“ 1 -yes “); printf(“ choice:“); scanf(“%d“, printf(“ delete?“); printf(“ 0 - no “); printf(“ 1 - yes “); printf(“ choice:“); scanf(“%d“, while(i) printf(“input sno:“); scanf(“%s“,sno); EXEC SQL DEL

20、ETE FROM S_TEST WHERE sno=:sno; printf(“ continue?“); printf(“ 0 -no “); printf(“ 1 -yes “); printf(“ chioce:“); scanf(“%d“, EXEC SQL COMMIT; EXEC SQL DISCONNECT; exit(0); 第三章 查 询 在 ESQL 程序中,查询可以分为两大类型:返回一行的查询和返回多行的查询.对于查询,我们不仅对其执行得成功与否感兴趣,其结果更为有用.多行查询要用到游标的概念,本章就介绍查询语句和游标的概念和使用. 3.1 SELECT 语句 SELEC

21、T 语句是用于完成查询功能的 SQL 语句,查询语句因为有返回的结果 ,故 ESQL 中的SELECT 语句比 SQL 的 SELECT 语句多一 INTO 子句,INTO 子句的主变量表对应于程序中主变量,用于存放查询返回的结果. SELECT 语句格式如下: EXEC SQL SELECT ,. INTO FROM ,. WHERE ; 其中:1.检索条件中允许有主变量和嵌套子查询语句 . 2.INTO 后的主变量可以是数组. 3.主变量前要用“:“标志. 执行该语句时,COBASE 找出表中满足检索条件的行,并把结果传送到 INTO 子句中所对应的主变量中.该语句的查询结果可以是一行或多

22、行.WHERE 后的主变量叫输入主变量,它提供了查询所需的信息.INTO 子句中的主变量叫输出主变量,它保存 SELECT 语句运行后的结果. 例题程序 3 (返回一行的查询 ) /*= This is a sample program which uses SELECT statement of Esql. It is an example of how to do queries that return one row. =*/ EXEC SQL BEGIN DECLARE SECTION ; INT status; CHAR sno10,sname10,city10,isno10; EX

23、EC SQL END DECLARE SECTION ; EXEC SQL INCLUDE USERCA; main() EXEC SQL CONNECT “cobase:cobase“ ; /* log into COBASE */ printf(“input the sno for update:“); scanf(“%s“,sno); EXEC SQL SELECT sno,sname,status,city INTO :sno , :sname ,:status,:city from S_TEST WHERE sno=:sno; printf(“sno: %s ;“,sno); pri

24、ntf(“sname: %s ;“,sname); printf(“status: %d ;“,status); printf(“city: %s ;“,city); EXEC SQL COMMIT; EXEC SQL DISCONNECT; exit(0); 例题程序 4 (返回多行的查询 ) /*= This is a sample program which uses SELECT statement of Esql. It is an example of how to do queries that return more than one row. =*/ EXEC SQL BEG

25、IN DECLARE SECTION ; INT status10; CHAR sno1010,sname1015,city1020,isno10; EXEC SQL END DECLARE SECTION ; EXEC SQL INCLUDE USERCA; main() int i; EXEC SQL CONNECT “cobase:cobase“ ; /* log into COBASE */ for(i=0;i CURSOR FOR FOR UPDATE; 其中:(1)SELECT 语句应不含 INTO 子句. (2)若无 FOR UPDATE 则无法 执行 UPDATE(定位) 和

26、DELETE(定位)语句. 定义游标的 DECLARE 语句必须出现在程序中对游标进行操作的所有语句之前, ESQL 不能引 用没有说明的游标,游标的定义范围是整个程序.程序中可包含多个 DECLARE 语 句,这些语句定义了不同的游标,并把游标与不同的查询联系在一起,所以在同一个程序中的两个DECLARE 语句中不能说明同一个游标名. 3.2.2 OPEN CURSOR 打开游标语句 ESQL 中 OPEN CURSOR 语句格式如下 : EXEC SQL OPEN ; OPEN 语句决定了满足查询的行的集合,游标处于打开状态,它的活动集就是满足 WHERE 子句条件的行的集合.这时,游标处

27、在活动集的第一行的 前面. 3.2.3 FETCH CURSOR 语句 ESQL 中的 FETCH CURSOR 语句读出活动集中的行,并把结果送到输出主变量,输出主变量是在相关的 FETCH 语句中定义的 .其 格式如下: EXEC SQL FETCH INTO ; 游标必须先定义,然后再打开,只有当游标处于打开状态时,才执行 FETCH 语句.在第一次运行 FETCH 时,游标从活动集的第一行前移到当前第一行 ,使这一行成为当前行.每次运行FETCH 时游标在活动集中向前移 ,把选出的结果送到主变量表中指定的输出主变量中. 如果游标活动集中是空的,或所有的行已经被取走,COBASE 就返回

28、一代码.(USERCA.SQLCODE=2000). 游标只可在活动集中向前移动,COBASE 无法取到已经用 FETCH 取过的行,要想再取这一行,就必须关闭游标,再重新打开它. 3.2.4 CLOSE CURSOR 关闭游标语句 当取完活动集中所有行后,必须关闭游标,以释放与该游标的关的资源.其格式如下: EXEC SQL CLOSE ; 例题程序 5 (使用游标的查询 ) /*= This is a sample program which uses Cursor.Include DECLARE, OPEN,FETCH and CLOSE cursor name. It is an ex

29、ample of how to do queries that return more than one row. =*/ EXEC SQL BEGIN DECLARE SECTION ; INT status; CHAR sno10,sname15,city20; EXEC SQL END DECLARE SECTION ; EXEC SQL INCLUDE USERCA; main() int i; printf(“Now exec connect .“); EXEC SQL CONNECT “cobase:cobase“ ; /* log into COBASE */ printf(“N

30、ow exec declare_open_fetch_close cursor .“); /* Declare statement name -“s1“ for INSERT statement */ EXEC SQL DECLARE cursor1 CURSOR FOR SELECT * FROM S_TEST; EXEC SQL OPEN cursor1 ; printf(“sno sname status cityn “); do EXEC SQL FETCH cursor1 INTO :sno,:sname,:status,:city ; If (userca.sqlcode=2000

31、) break; printf(“%8s %8s %8d %8s n“,sno,sname,status,city); getchar(); while(1); EXEC SQL CLOSE cursor1 ; EXEC SQL COMMIT; EXEC SQL DISCONNECT; 3.3 定位修改和删除语句 COBASE 支持 SQL 格式“ CURRENT OF CURSOR“.这条语句将指向一个游标中最新取出的行,以用于修改和删除操作.该语句必须在取操作之后使用 ,它等同于存储一个 ROWID,并使用它.其格式如下: (1) EXEC SQL UPDATE SET = | NULL

32、, = | NULL WHERE CURRENT OF ; (2) EXEC SQL UPDATE SET ( ) = ( ) WHERE CURRENT OF ; (3) EXEC SQL DELETE FROM WHERE CURRENT OF ; 这些语句执行在游标名的当前行下更新或修改.其中在值表达式或子查询中出现的主变量前应有“:“ 标志. 例题程序 6 (定位删除) /*= This is a sample program which uses DELETE STATEMENT at CURRENT Cursor. =*/ EXEC SQL BEGIN DECLARE SECTIO

33、N ; INT status; CHAR sno10,sname15,city20; EXEC SQL END DECLARE SECTION ; EXEC SQL INCLUDE USERCA; main() int i; printf(“Now exec connect .“); EXEC SQL CONNECT “COBASE:COBASE“ ; printf(“Now exec declare cursor .“); EXEC SQL DECLARE cursor1 CURSOR FOR SELECT sno,sname,status,city FROM S_TEST FOR UPDA

34、TE; printf(“Now exec open cursor .“); EXEC SQL OPEN cursor1; printf(“sno sname status cityn“); for(;) printf(“Now exec fetch cursor .n“); EXEC SQL FETCH cursor1 INTO :sno,:sname,:status,:city; if (userca.sqlcode=2000) break; printf(“%8s %8s %8d %8s n“,sno,sname,status,city); /Delete the first record

35、 that be fetched printf(“ delete current ?(0/1)“); scanf(“%d“, if (i=1) EXEC SQL DELETE FROM S_TEST WHERE CURRENT of cursor1; EXEC SQL CLOSE cursor1; EXEC SQL COMMIT; EXEC SQL DISCONNECT; 例题程序 7 (定位修改) /*= This is a sample program which uses UPDATE STATEMENT at CURRENT Cursor. =*/ EXEC SQL BEGIN DEC

36、LARE SECTION ; INT status; CHAR sno10,sname15,city20; EXEC SQL END DECLARE SECTION ; EXEC SQL INCLUDE USERCA; main() int i; strcpy(sno,“ttttt“); strcpy(sname,“ttttt“); strcpy(city,“ttttt“); status=1000; EXEC SQL CONNECT “cobase:cobase“ ; EXEC SQL DECLARE cursor1 CURSOR FOR SELECT SNO, SNAME, STATUS,

37、CITY FROM S_TEST FOR UPDATE; EXEC SQL OPEN cursor1; printf(“sno sname status cityn“); for(;) EXEC SQL FETCH cursor1 INTO :sno,:sname,:status,:city; if (userca.sqlcode=2000) break; printf(“%8s %8s %8d %8s n“,sno,sname,status,city); /* Delete the first record that be fetched */ printf(“ update current

38、 ?(0/1)“); scanf(“%d“, if (i=1) printf(“input sno=“); scanf(“%s“,sno); printf(“ninput sname=“); scanf(“%s“,sname); printf(“ninput status=“); scanf(“%d“, printf(“ninput city=“); scanf(“%s“,city); EXEC SQL UPDATE S_TEST SET sno=:sno,sname=:sname,status=:status,city=:city WHERE CURRENT of cursor1; EXEC

39、 SQL COMMIT; EXEC SQL CLOSE cursor1; EXEC SQL COMMIT; EXEC SQL DISCONNECT; 第四章 提交/回滚事务 本章定义一事务或叫逻辑工作单元.为了保证数据库的一致性,在 ESQL 程序中,程序开发人员可以控制事务是否提交或回滚.一事务通常可以理解为一个完整程序对数据库进行的所有操作.一个事务也可以理解为是一个逻 辑工作单元. 4.1 逻辑工作单元 一个逻辑工作单元是一组 SQL 语句和插入的主语言码的集合.COBASE 把它们作为一个整体来处理. 在逻辑工作单元这一级上,COBASE 保证了数据的一致性,这就意味着要么完成所有的操

40、作,要么每条语句都不执行. 如果在处理一个逻辑工作单元期间出现了系统或用户程序失败,那么 COBASE 就自动把数据恢复到该逻辑工作单元开始之前的状态,程序失败时,COBASE 检测完错误就恢复数据,若系统故障,COBASE 在重新启动时恢复数据. 当遇 到第一个可执行的 SQL 语句(除了 CONNECT)时,就隐含着一个逻辑工作单元的开始,COMMIT 和 ROLLBACK 语句结束一个逻辑工作单元.在 ESQL 程序中,说明语句并不开始一个逻辑单元. COMMIT 语句保证了当前逻辑单元上的所有操作都完整地提交给了数据库.ROLLBACK 语句取消对当逻辑工作单元所作的操作 ,把数据库恢

41、复到当前逻辑工作单元开始前的状态. 4.2 COMMIT 语句 该语句结束当前逻辑工作单元,把在逻辑工作单元期们的所有变化提 交给数据库 .其格式如下: EXEC SQL COMMIT; 在程序结束之前,应该明确地结束它的工作单元,否则,若程序成功结束后,COBASE 自动提交所有的变换,若程序非正常结束,就恢复到最近 没有提交的逻辑工作单元. COMMIT 语句不影响主变量的内容 或主程序的控制流. 每条 DDL 语句的执行 ,自动发出 COMMIT 操作,这就是说 ,DDL 语句跟在 DML 语句后面,那么以前的 DML 语句就自动提交组数据库 .一个 DDL 语句结束当前逻辑工作单元,释

42、放该程序拥有的所有锁. 4.3 ROLLBACK 语 句 该语句将数据库恢复到当前逻辑工作单元之前的状态,结束当前的逻辑工作单元.该语 句不影响主变量的内容或主程序的控制流.其格式如下: EXEC SQL ROLLBACK; 4.4 DISCONNECT 语句 当应用程序不再使用 COBASE 数据库时,应该使用 DISCONNECT 语句释放程序所有与COBASE 数据库有关的资源,并退出数据库,脱离 COBASE 环境.其格式如下: EXEC SQL DISCONNECT; 第 五 章 错误检测和恢复 本章我们介绍如何使用 USERCA 来进行错误检测和处理。 5.1 USERCA 的结构

43、 USERCA 是 ESQL 程序用来传送执行信息的结构,每执行完一条执行性 SQL 语句, COBASE都把执行信息写入 USERCA 中,对于说明性 SQL 语句,则无执行信息.谨慎的程序员应该在每一 SQL 语句执行完成后,检查 USERCA 结构中内容来确信语句的执行是否成功,并根据其中的信息作适当的处理.在 ESQL 中,USERCA 的结构如下: typedef struct char caid10; /* userca ID */ long calen; /* userca length */ long sqlcode; /* sql code */ long sqltype;

44、/* sql statement type */ int sqlerrmlen; /* sql error message length */ char sqlerrmtext80; /* sql error message text */ int sqlreturnflag; /* sql return flag(def or data) */ long sqlpl; /* sql process lines (per fetch st) */ long sqlcoml; /* sql communication lines (per com) */ long sqltotal; /* se

45、lect_total_lines */ char sqlwarn7; /* sql warnning flag */ short sqlstsave; /* sql_statement_save flag */ user_com_area; struct user_com_area userca; 该结构的各元素的意义描述如下: userca.caid 通讯区标识. userca.calen 通讯区长度 . userca.sqlcode 记录每一 SQL 语句执行完成情况.其取值如下: 0 表示执行成功. 2000 表示没有返回行或最后一行已取完. userca.sqltype SQL 语句的类型. userca.sqlerrmlen 执行 SQL 语句错误 信息的长度. userca.sqlerrmtext 执行 SQL 语句错误 信息的正文. userca.sqlreturnflag userca.sqlpl userca.sqlcoml uaseca.sqltotal userca.sqlwarn userca.sqlwarn0 警告检查位; userca.sqlwarn1 返回值截断警告; userca.s