融海咨询informix_4gl教材第十九章SQLCA记录.doc

第十九章SQLCA记录本章介绍了SQLCA记录的结构及其在INFORMIX-4GL程序中的作用。SQLCA表示结构化查询语言通讯访问，是INFORMIX-4GL产品的预定义记录，它驻留内存用于与数据库通讯，反映SQL语句的执行状态。SQLCA记录包括：l l 最近执行语句的信息l l 报告可能或已发生的警告在程序中将会用到SQLCA的部分记录来检查错误情况。SQLCA是全局的预定义记录变量，由十个独立的变量组成。它不用DEFINF语句定义，是INFORMIX-4GL已定义好的。上图显示了SQLCA记录包括的变量。SQLCA包括10个变量，SQLERRM、SQLERRP和SQLERRD1此时用不到。其它的变量用于指定目的。SQLCA. SQLCODE：在SQL语句执行后赋值，它有三个可能的值：l l 零：表示SQL语句执行成功。l l 小于零：表示SQL语句执行有错。l l 等于100：表示SELECT语句没有找到满足条件的值。SQLCA. SQLERRD2：当往SERIAL字段插入零，INFORMIX-4GL自动按顺序分配下一个值，这个值就存在这个变量中。SQLCA的其它部分在INFORMIX-4GL程序中不太常用。注意INFORMIX-4GL中的保留字NOTFOUND即为值100，为使代码便于阅读，可以用这个保留字替换100。还有一个全局变量status，其值和SQLCA.SQLCODE相同。status与SQLCA.SQLCODE的不同点当SQL语句执行完后，status的值等于SQLCA.SQLCODE。但status反映的是INFORMIX-4GL语句执行成功还是失败，如打开Form显示等，若请求的Form不存在，status将为负值。应该用哪个？status看上去更好，它是短整型且不但包含与SQLCA.SQLCODE相同的信息，还包含其它信息。但是，如果你只对SQL语句执行结果感兴趣，最好用SQLCA.SQLCODE。SQLCA.SQLCODE的值是由数据库引擎返回的，而status只是一个全局变量，若要检查SQL语句执行是否成功，最好用SQLCA.SQLCODE。SQLWARN变量是执行SQL语句后设置的警告信息，是8字符字符串。若没测出问题则为空字符。SQLAWARN1：若有一到多个警告则设置为“W”。若此位为空，表示没有检测到警告信息。SQLAWARN2：若发生以下情况，SQLWARN2设为“W”：l l当数据被截断放到CHAR类型程序变量时l l当带事务对数据库操作时SQLAWARN3：当聚合函数在统计时包含NULL值时，其值设为“W”。SQLAWARN4：当发生以下情况时，其值设为“W”：l l在SELECT子句的选择项数同INTO子句中的程序变量数不同时，INFORMIX-4GL返回其中小值。l lDATABASE语句访问的是INFORMIX-OnLine数据库时。SQLAWARN5：当用从float到decimal的类型转换时，其值设为“W”。SQLAWARN6：当程序执行一个I