sqc基础库使用手册范本

1、SqcLib 库接口定义新的sqc基础库采用C+封装，开发人员只需要从基础类 Db2Tools派生自 己的业务类。然后重载基础类的 busiLogic 方法，就可以完成自己业务逻辑处理。 具体的处理流程为：1、在基础类 Db2Tools 的 run 方法中完成对具体应用参数的解析。2、run 方法调用 busiLogic 方法，完成具体的业务逻辑3、busiLogic 方法中调用基础类的常用数据库访问方法，完成对数据库的操作。4、在基础类的数据库访问方法中，除完成指定的数据库操作外，同时完成日志 输出和相关事务控制。 日志的输出目录为 profile 文件中定义的 AGENTTRACEDIR

2、目录，如果没有定义，取默认路径 1 函数列表1.1 数据库类( Db2Tools)该类有两个主要功能：1、实现数据库访问2、完成对具体业务逻辑调用和事务控制connDb函数原形： int connDb(const char *m_para_conn) 用途：连接数据库参数： m_para_conn ：数据库名 dbname 返回： 1. 输入的数据库参数不对2. 密码参数环境变量设置错误3. 数据库连接失败0. 数据库连接成功busiLogic函数原形：int busiLogic(void)用途：业务逻辑入口参数：返回：run 函数原形：int run(int argc,char *argv)

3、用途：实例开始入口 参数： argc ：参数个数Argv ：参数数组 (通常取 main 函数入口参数) 返回： 0：成功，其它：失败db2RunstatTab函数原形： int db2RunstatTab(char *tabname,char *file,int line) 用途：对表做 runstats参数： tabname ：输入需要 runstats 的表名， schema.tabname 或者 tabname(schema 默 认为用户名 )返回： -1 ：失败0 ：成功 db2Insert 函数原形： int db2Insert(char *sqlstr,char *tabname

4、,char *file,int line) 用途：提交 insert 语句 参数：sqlstr： insert sql 语句file ：line ： 返回： -1 ：失败0 ：成功 db2Update 函数原形： int db2Update(char *sqlstr,char *tabname,char *file,int line) 用途：提交 update 语句 参数：sqlstr： update sql 语句file ：line ： 返回： -1 ：失败0 ：成功 db2Delete 函数原形： int db2Delete(char *sqlstr,char *tabname,char

5、*file,int line) 用途：提交 delete 语句 参数：sqlstr： delete sql 语句file ：line ： 返回： -1. 失败0. 成功 db2DropTab 函数原形： int db2DropTab(char *tabname,char *file,int line) 用途：删除表 参数：tabname ：需要删除的表名， schema.tabnamefile ：line ： 返回： -1 ：删除失败1 ：表不存在0 ：成功 db2DelAll 函数原形： int db2DelAll(char *tabname, char *file,int line) 用途

6、：清空该表中的全部数据参数：tab name :需要删除的表名，schema.tab namefile：line：返回： -1 ：删除失败1：表不存在0：成功db2CreTab 函数原形： int db2CreTab(char *sqlstr,char *tabname,char *file,int line) 用途：新建一表参数：返回： -1 ：建表失败1：表已经存在0：建表成功db2GrantTab 函数原形： int db2GrantTab(char *user,char *tabname,char *file,int line) 用途：表付权函数，只能付 select 权限，一次只能给

7、一个用户或者组付权 参数： 返回：dbRrefreshTab 函数原形： int dbRrefreshTab(char *tabname,char *file,int line) 用途：同步刷新表参数：返回：1.2 日期类( DateFormat )完成读日期的各种运算CdateFormat函数原形： CdateFormat (std:string pat) 用途：构造函数参数： pat ： 输入日期的格式getMonthRoll函数原形： string getMonthRoll(int interval) 用途：获得输入月份偏移 interval 后的月份参数：interval ：偏移量 返

8、回：返回 yyyymm 格式的日期getDateRoll函数原形：string getDateRoll(int intverval)用途：获得输入日期偏移 interval 后的日期 参数：interval ：偏移量返回：返回yyyymmdd格式的日期getYearRoll函数原形：string getYearRoll(int intverval)用途：获得输入年偏移 interval 后的年份 参数：interval返回：返回：偏移量yyyy 格式的日期setPattern 函数原形：int setPattern(std:string strFormat)用途：指定输入日期值的格式 (%Y%

9、m%d, %Y-%m-%d) 参数： strFormat ：输入的日期格式返回： -1 ：执行失败0 ：执行成功getPattern函数原形： string getPattern ( ) 用途：返回日期值的格式 参数： strTime ：输入的日期 返回： -1 ：执行失败0 ：执行成功dateParsing函数原形： int dateParsing(std:string strTime)用途：把表示时间的字符串 strTime 按 pattern 格式转换成 tm 结构的日期时间结构 参数： strTime ：输入的日期返回： -1 ：执行失败0 ：执行成功getLastDay函数原形： s

10、tring getLastDay () 用途： 返回指定月份的最后一天 参数：返回：返回yyyymmdd格式的日期getFirstDay函数原形： string getFirstDay()用途：返回指定月份的第一天 参数：返回：返回yyyymmdd格式的日期getQuater函数原形： string getQuater () 用途：返回当前月份所在的季度 参数：返回：季度( 1、2、3、4)1.3 日志类完成日志数据writeLogTracem_rwh,int line,char函 数 原 形 ： int writeLogTrace(char *m_proname,int m_ddh,int

11、m_cmdstatus,char *promptMsg1,char *promptMsg2,char *file,int *fpath)用途：写 ss 日志到指定目录下 参数：open_trace函数原形： int open_trace(char * tast_name)用途：打开 trace 文件参数： tast_name ：程序名返回：TRACE_FD会产生该全局变量，指向文件的指针1.4 控制表类synTab函数原形： int synTab(FILE *trace,char *sqlstr,char *tabname,char *file,int line)用途：向同步申请表中插入需要同步的表参数： trace ：日志文件句柄sqlstr ：同步 sql 语法tabname ：需要同步的