大前置平台用户手册

1、上海浦东发展银行 大前置平台用户手册 联想集团 it 服务事业群 金融事业部 目目 录录 第一章第一章 概述概述6 1.1 编写目的编写目的7 1.2 文档概述文档概述7 1.3 术语说明术语说明7 第二章第二章 大前置平台简介大前置平台简介9 2.1 平台组成平台组成9 2.2 技术架构技术架构10 2.3 架构组成架构组成10 2.4 功能模块组成功能模块组成11 2.4.1 通讯网关11 2.4.2 应用路由12 2.4.3 报文解析13 2.4.4 流程控制14 2.4.5 监控管理15 2.5 浦发银行的实现架构浦发银行的实现架构16 第三章第三章 大前置平台安装说明大前置平台安装说

2、明17 3.1 操作系统核心参数配置操作系统核心参数配置17 3.2 数据库安装数据库安装17 3.3 tuxedo安装安装17 3.3.1 tuxedo的配置文件示例17 3.3.2 tuxedo的域配置文件示例21 3.4 大前置大前置 unix平台安装平台安装22 3.4.1 平台运行环境安装22 3.4.2 平台数据库安装23 3.5 大前置大前置 windows管理监控台安装管理监控台安装23 3.5.1 软件安装23 3.5.2 数据库参数配置23 3.6 双机热备安装双机热备安装26 第四章第四章 大前置平台的管理大前置平台的管理27 4.1 大前置平台在大前置平台在 unix下

3、的管理下的管理27 4.1.1 大前置系统的启动27 4.1.2 unix下的监控台27 4.1.3 ipp 平台的启动27 4.1.4 ipp 平台的关闭28 4.1.5 模块组的启动/关闭28 4.1.6 查看模块组信息28 4.1.7 查看进程信息28 4.1.8 重新装载数据库表数据28 4.1.9 重新装载网关的配置参数29 4.1.10 其它ipm命令29 4.2 大前置平台在大前置平台在 windows下的管理下的管理29 4.2.1 概述29 4.2.2 用户管理29 4.2.3 ipp 系统31 4.2.4 警告信息33 4.2.5 监控项目33 第五章第五章 大前置平台在大

4、前置平台在 windows 下的开发下的开发38 5.1 概述概述38 5.1.1 用户管理38 5.1.2 功能38 5.2 主屏幕主屏幕38 5.2.1 ipp 系统连接39 5.2.2 业务开发40 5.3 参数文件配置参数文件配置40 5.3.1 参数文件基本概念40 5.3.2 模板定义41 5.3.3 参数文件的配置44 5.4 交易配置交易配置46 5.4.1 基本操作：47 5.4.2 原子交易配置47 5.4.3 外部交易配置49 5.4.4 内部交易配置50 5.5 报文转换脚本报文转换脚本53 5.6 通用参数表配置通用参数表配置54 5.6.1 表格式文件的定义54 5

5、.6.2 维护表列表55 5.6.3 参数表维护56 5.7 设置应用系统设置应用系统57 第六章第六章 大前置平台在大前置平台在 unix 下的开发下的开发58 6.1 目录结构目录结构58 6.1.1 ippsrc目录59 6.1.2 src目录59 6.1.3 bin目录59 6.1.4 include目录59 6.1.5 lib目录59 6.1.6 etc目录60 6.1.7 table目录60 6.1.8 cop目录60 6.1.9 data目录60 6.1.10 log目录61 6.2 ipp 系统的开发系统的开发61 6.2.1 子系统开发61 6.2.2 本地构件的开发62 6

6、.3 数据库开发数据库开发69 6.3.1 建议规范69 6.3.2 生成工具69 6.3.3 生成函数说明74 6.3.4 程序框架生成工具75 6.4 ipp 常用函数常用函数77 6.4.1 数据存储池常用函数77 6.4.2 tpu常用函数77 6.4.3 日志常用函数79 6.4.3 xml 常用函数80 6.4.4 数据库常用函数84 6.4.5 时间处理常用函数85 6.4.6 字符串处理常用函数87 6.5 流程配置中的条件表达式流程配置中的条件表达式88 6.6 pool 池中常用的系统变量池中常用的系统变量89 6.7 报文转换模块说明报文转换模块说明90 6.7.1 转换

7、标准配置命令说明90 6.7.2 脚本说明94 6.7.3 运行环境96 6.7.4 示例96 6.8 备份和恢复工具备份和恢复工具99 6.8.1 备份工具ippbackup99 6.8.2 恢复工具ipprestore101 6.9 ipp 平台的一些约定平台的一些约定103 6.9.1 几个固定网关103 6.9.2 其它约定104 附件附件 1 对表格的操作对表格的操作105 附件附件 2 sop 报文报文 api107 附件附件 3 文件传输工具文件传输工具108 附件附件 4 c 语言编程规范语言编程规范108 第一章第一章 概述概述 银行系统的大集中包括帐务大集中和渠道大集中。

8、帐务大集中实现了帐务数据和后台交易的整合，集中体现在综合业务系统。 综合业务系统实现了数据存储和处理集中，将储蓄、卡、对公、贷款、清算、 本外币等等统一形成一个完整的大会计处理系统，全行一本帐，面向服务的设 计和实现了综合柜员制。帐务大集中也可以认为主要是业务的整合。 渠道大集中实现了业务渠道和客户服务的整合，集中体现在大前置系统。 大前置系统集中可以实现高柜、低柜、自助设备、银联金卡、电话银行、网络 银行、自助查询终端等服务渠道的前置业务逻辑，同时也可以作为银证通、开 放式基金、个人外汇买卖、非贸系统、代收费等中间业务或外围业务的前置系 统。渠道大集中的大集中也可以认为主要是技术平台的整合。

9、 帐务大集中和渠道大集中是缺一不可的整体。银行提供的不仅仅是会计帐 务，还有多样化的服务。没有渠道大集中只有帐务大集中是不完整的。这样的 大集中可能会出现不同的业务会有不同的服务手段，甚至柜员有多套操作界面。 如果通过电话和查询终端发送对帐单的邮件或者通过网银发送指定号码的传真 都将是一件不太容易实现的服务。同样，没有帐务大集中只有渠道大集中，渠 道大集中的意义也将失去了很多。这样的大集中客户的帐务信息是不完整的。 通过渠道实现卡折的资金划转、对公到对私、异地的查询、本外币的处理技术 上都是很麻烦的，往往渠道提供的服务是需要大打折扣的。 所以，集中处理与服务渠道多样化是完整的统一 随着服务手段

10、的多样化的发展，分行特色业务的开展，业务的时间性要求 也越来越高，规范管理的加强，业务平台和技术平台的规范化，通过业务渠道 的整合，得到了一个统一的技术平台、业务平台、管理平台、接入平台的大前 置。 大前置是所有前端的后台，又是所有后端的前台。所以有时候我们也叫它 “中台” 。大前置是统一的交易接口和多样化的门户接口之间的桥梁。 1.1 编写目的编写目的 全面介绍上海浦东发展银行大前置平台的网络结构、运行机制、安装指南 以及操作说明。操作手册的编写主要有以下几个目的： 为系统的安装维护提供指导性文件； 为系统以后对于新业务的开发提供指南； 客户培训的教材，帮助客户掌握系统的操作和维护； 作为项

11、目成果的一部分，产品的说明书； 1.2 文档概述文档概述 本文档的主要内容涉及系统的大前置产品介绍、大前置平台的体系结构、 大前置平台的安装指南、大前置平台的操作说明几部分。其中，操作说明是本 文档的核心内容。 本文档是依据 iso9000 管理规范，严格遵守联想公司的有关文档编写要 求，结合浦发银行维护人员的实际特点完成的； 本文档所采用的编写工具为：microsoft word 2000 for windows 98/2000 本文档所适用的对象是浦发银行的相关业务人员、项目双方的开发人员 和系统维护人员。 1.3 术语说明术语说明 ipp综合前置平台(integrative pre-op

12、eration platform) cop客户端开发平台(counter operation platform) sop服务端开发平台(server operation platform) cas核心业务系统(corebanking account system) sga共享全局区(shared global memory) sda交易数据区(session data area) dp数据存储池(data pool) ctm参照表内存镜像（cost table mirror） dcb数据高速缓存（data cache buffer） mat内存分配表(memory allocate table

13、) ort对象登记表（object regist table） pmq进程消息队列（process message queue） psb进程状态块（process status block） 第二章第二章 大前置平台简介大前置平台简介 2.1 平台组成平台组成 平平台台核核心心 网 上 银 行 平平台台核核心心服服务务层层 应应用用层层平平台台层层 其 它 中 间 业 务 通通讯讯核核心心业业务务核核心心 其其他他应应用用 系系统统备备份份 统统计计接接口口 安安全全接接口口 自 助 银 行 金 卡 / 银 联 个 人 外 汇 买 卖 银 证 转 帐 图：ipp开发平台组成 平台核心层提供最底

14、层的基本内核，包括：内存管理、进程管理、系统调度、日志、 监控核心、脚本语言虚拟机等。 服务层是平台核心层向外提供服务的层面，表现为一系列的构件、api 和模板。 在底下两层的基础上，开发出包含业务核心和通讯核心的开发平台。 在开发平台上开发各种前置系统。 2.2 技术架构技术架构 网关1 网关4 网关3 网关2 网关n 接入 系统1 接入 系统4 接入 系统3 接入 系统2 接入 系统n i ip pp p 图：大前置技术架构分析 应用路由 业务核心 大前置系统通过对应的通讯网关和各个接入系统相联。一般一个接入系统有一个对应 的网关相联。应用路由负责各个网关之间的通讯。从应用路由的角度来讲，

15、ipp 的业务核 心也是一个网关，只是不负责对外通讯，只负责内部的业务处理。 2.3 架构组成架构组成 ipp 分为基础服务环境、管理服务、通讯网关、业务处理核心、应用服务、监控服务 等组成部分。 基础服务环境包括内存管理、xml 解析、公共构件、进程管理、日志服务、开发工具 等。 管理服务包括安全管理、系统配置管理、操作员管理、系统管理、本地业务参数管理、 业务报表等。 通讯网关负责原始报文的传递，通讯协议的转换，通讯联接的管理。 应用路由负责各个网关和业务核心的之间的通讯。 业务处理核心是各个外围系统的前置业务处理逻辑。在 ipp 上的业务处理核心可以成 为一个真正的业务处理运行环境。 统

16、一的监控平台包括监控和报警平台。 management services ipp kernel monitor services base service environment gateway ark(应用路由核心 ) guiweb monitor agent server 通讯连接的管理 通讯协议的转换 安全 管理 业务 报表 操作员管理 系统配置 管理 本地业务 参数管理 cvt(报文转化控件) 原始报文的传递 tpu(事务处理单元) 交易 异常 处理 app services 中间业务 . 自助银行 图:ipp组成 shmxmlutilproclogmontools monitor a

17、larm information collection 系统操作 2.4 功能模块组成功能模块组成 本节讨论各个主要的功能模块。 对于大前置系统来讲，主要的功能是通讯网关、应用路由、报文解析、流 程控制。 2.4.1 通讯网关通讯网关 通讯网关负责和其他系统的通讯。银行应用系统都要求通讯传输是实时的， 交易报文不能及时到达，一般认为通讯失败。 网关需要支持多种通讯机制、多种中间件和通讯协议。常见的中间件有 tuxedo、cics、mq 等，通讯协议有 tcp/ip、sna、rmi/iiop、x.25 等。 常见的通讯方式有长连接、短连接、收发同链路、收发不同链路，金卡走 x.25 时用三进三出

18、，还有其他系统会有特殊会话协议。 通讯网关按照网关的位置分类，可分为外联网关、内联网关、插槽网关。 外联网关是和外系统联接的通讯网关，内联网关是由多个大前置系统之间通讯 的服务网关，插槽网关是为插件服务的网关。 通讯网关按照服务方式分类，可分为服务器网关、客户机网关、互为 client/server。服务器网关是被动通讯网关，由其他系统发出交易，服务器网关 收到报文处理。客户机网关是主动通讯网关，由它发起报文通知其他系统接收。 有的应用希望通讯的两个系统互为客户机/服务器网关。 用户是通过配置文件来定义网关的工作的。网关配置文件通常包括网关名 称、网关通讯地址(ip 地址)、网关入口队列名、网

19、络协议、协议参数 1、协议参 数 2、协议参数 3、协议参数 4、通信超时、子进程个数初始值、子进程极限、 最大允许连接数、acl 列表名等信息。一些特殊的会话机制需要定制会话的模 式。 对外通讯的报文需要统一加密，一般也是由通讯网关处理。 2.4.2 应用路由应用路由 应用路由是系统内部通讯的交换器，负责网关和网关之间、网关和应用核 心之间的通讯。应用路由采用分段配置，也就是说，应用路由负责将一个收到 的消息报文发送到能够到达目的地的下一个节点；下一个节点再将这个消息报 文发送到能够到达目的地的下下一个节点，直至到达目的地。 根据网关的性质不同，应用路由分为服务端路由和客户端路由。服务端路

20、由负责从收到的原始报文中抽取出路由的关键数据（交易码、交易子码） ，然后 根据这些关键数据把报文转发到客户端网关；客户端路由负责根据路由的关键 数据（交易码、交易子码） ，把交易报文发送到对应的下一个节点。 ipp 提供灵活的路由设置，并能高效的处理内部数据交换。使用了应用路由， 服务渠道可以不需要关注后台服务的分布情况，应用服务分布的调整也不需要 改变业务系统。 2.4.3 报文解析报文解析 报文解析是 ipp平台中和外部（主机、网银、第三方等）进行数据交易的模 块。报文解析在 ipp平台中是一个相对比较独立的模块，它和 ipp平台中其他模 块的接口主要是数据池（pool 池） 。报文拆包时

21、，报文解析模块按照报文格式 的定义，把报文内容拆解到 pool 池中；报文打包时，报文解析模块按照报文 格式的定义，从 pool 池中提取报文中需要的数据项，打成外部格式的报文。 由于 ipp平台是一个开放式的系统，需要和不同地方的不同外部打交道，报 文格式非常复杂。其中，报文格式可能是任何一种系统的内部格式（如 cop， 具有复杂的配置和描述方法） ，也可能是一些简单的格式（如结构，分隔符） ， 因此，不能简单的强制用一种方法去转换报文。本系统的报文解析模块可以根 据不同的报文类型调用不同的转换函数，系统提供一个通用的转换函数，以后 可以通过编写另外的转换控件实现功能的扩展。 为了处理复杂的

22、报文情况，报文解析模块采用配置加脚本的方式处理报文 的解析。由于绝大多数报文的格式都可以通过配置描述出来，因此，报文转换 格式以配置为主，而对于某些配置难以描述数据项或通过判断才能选择打包解 包办法的情况下采用脚本进行处理，如果非常复杂，可以采用 c 语言编程来处 理。 报文解析中的脚本模块是一个高效、易于使用的解释语言模块。脚本采用 c 的语法，支持绝大部分的标准 c 语法，同时可以使用定义的方法把 c 的库函 数加入到脚本中，以丰富脚本的功能。脚本的解释器是 ipp平台内嵌的，运行 脚本时，脚本解释器首先把脚本翻译成伪码，再由虚拟机运行伪码，以完成脚 本需实现的功能。 报文解析模块目前能处

23、理以下格式的报文： a.定长结构报文的处理（支持各种对齐方式,和整形的表示方法） b. 分隔符报文的处理 c.某个域可以是从当前字节一直到报文结尾（不定长） d. llv，lllv 形式 e.tlv 形式（tag length value,value 中可以嵌套 tlv） f.cop 等固定模式，可能已经存在特有报文的打包、拆包的库 g. 8583,类 8583 报文的解析（要提供解决办法） h. 内部嵌套报文（可以拆分内部报文，也可以把内部嵌套报文作为一个整 体） i.组合报文（一个大的报文有多个小报文组成） j.ascii，ebcdic，unicode 等的转换 k. xml 格式的报文

24、l.其他未知格式 2.4.4 流程控制流程控制 流程控制是 ipp平台中处理业务逻辑的主要部分。它主要是面向交易的，当 收到一个原始的交易请求时，流程控制模块根据交易的配置，把原始交易分解 为一个个更为细小的原子交易，这些原子交易可以是主机交易，可以是第三方 的交易，也可以是本地的一个交易构件，通过对这些原子交易的组合，完成一 个原始的交易请求所需要完成的所有业务处理逻辑。 流程控制支持同步和异步两种控制模式。异步控制指，当步骤中发出交易 请求之后，挂起此交易的流程，转而处理下一笔交易，当原有交易的应答回来 之后，可以在挂起点继续交易的流程。通过异步处理的模式，可以节省流程控 制模块等待主机或

25、第三方应答的时间，让有限的资源（流程控制进程）得到充 分的应用。 流程控制基本上使用共享内存进行操作。交易的主要配置信息在系统启动 时，均被载入了共享内存中，也就是说，在平台这一层，ipp平台基本上不需要 和数据库系统进行交互，保证了流程控制进程的高效运转。同时，共享内存中 的配置信息带有版本控制功能，当配置改变时，可以重新载入配置，让新的交 易请求按照新的配置运行，而已有的、未运行完的交易仍按照当时的配置继续 运行。 流程控制的配置在 windows 下的管理台上完成，大体上可以分为三部分： 外部交易配置、内部交易配置、原子交易配置。外部交易配置包括外部交易码 到内部交易码的转换、外部交易子

26、码的解析；内部交易配置包括内部交易的步 骤配置等；原子交易配置包括交易中的参数、报文接口、冲正等配置。 流程控制的程序开发在 unix 上完成。程序的开发工作主要是交易的构件， 当交易无法通过平台配置出来时，就需要为此交易编写单独的构件，构件采用 动态连接库的方式被调用及运行。由于流程控制本身是采用动态连接库的方式 链接的，因此，平台使用的绝大部分函数均可以被交易的构件调用。 2.4.5 监控管理监控管理 ipp平台提供统一的监控平台。 监控的信息有系统信息、数据库信息、平台信息、应用信息、外部设备。 系统信息 硬盘、cpu、内存 数据库信息 数据库表空间使用比例、数据库连接情况、数据库锁使用

27、 平台信息 各个进程的状态、队列水线、进程异常 应用信息 网关状态、链路状态、流量、交易量、交易异常 外部设备 系统挂接的外部设备的种类、状态 2.5 浦发银行的实现架构浦发银行的实现架构 电话 银行 柜面 服务 器 低柜pc 其它 外挂 系统 总行大前置 网络银行 个人外汇买卖 金卡总中心 新旧系统通兑 本地金卡 当地人行 银证转帐 代收费 同城清算 自助 银行 前置 总行主机 a分行 大前置 c分行大前置b分行大前置大前置管理机 银证通 人行 财政 金卡 移动 其他外系统 总行 分行 支行外系统 图：大前置构架的大集中系统 总行主机集中处理后台交易和帐务数据。 总行主机与总行大前置、各个分

28、行的大前置相联。 总行大前置负责总行的外围业务，并与对应的第三方联系。例如网络银行、 个人外汇买卖、金卡总中心的银联系统、新老系统通兑、全行的银证通、基金 服务器、swift 等。 分行大前置负责本地的的外围业务和本地的渠道，以及分行的特色业务。 分行大前置首先是分行主机，不过没有了帐务数据。它是分行系统联接总行的 唯一通道。 总行大前置还有另外一个工作，它是分行系统之间业务数据通讯的通道。 因为分行和分行一般不能直接联接，总行大前置成了它们通讯的桥。 第三章第三章 大前置平台安装说明大前置平台安装说明 3.1 操作系统核心参数配置操作系统核心参数配置 3.2 数据库安装数据库安装 请参照数据

29、库安装手册 。 3.3 tuxedo 安装安装 请参照tuxedo 安装手册 。 3.3.1 tuxedo 的配置文件示例的配置文件示例 *resources ipckey123456 masteripp_a00000 #uid200 #gid50 perm0666 maxaccessers200 maxaclgroups 16384 maxgtt100 domainidspdb_a00000 maxgroups 100 maxnetgroups 8 maxmachines256 maxqueues 100 maxdrt0 maxrft0 maxrtdata 4 maxservers 100

30、maxservices100 maxconv1 modelshm ldbaln cmtretcomplete maxbuftype 16 maxbufstype32 scanunit10 sanityscan 6 dbblwait2 bblquery30 blocktime6 notifydipin system_access fastpath usignalsigusr2 *machines ipp1lmid=ipp_a00000 tuxconfig=/usr/ipp/etc/tuxconfig tuxdir=/bea/tuxedo8.0 appdir=/usr/ipp/ippsrc/bin

31、 ulogpfx=/usr/ipp/log/ulog tlogname=tlog tlogsize=100 maxwsclients=100 cmplimit=maxlong,maxlong netload=0 spincount=0 maxaclcache=100 *groups sysgrp lmid=ipp_a00000grpno=1 tmscount=3 appgrp lmid=ipp_a00000grpno=2 tmscount=3 *netgroups *servers dmadm srvgrp=sysgrpsrvid=1 clopt=-a rqperm=0666 replyq=n

32、rpperm=0666 min=1 max=1conv=n system_access=fastpath maxgen=6grace=3600restart=y gwadm srvgrp=sysgrpsrvid=2 clopt=-a rqperm=0666 replyq=nrpperm=0666 min=1 max=1conv=n system_access=fastpath maxgen=6grace=3600restart=y gwtdomainsrvgrp=sysgrpsrvid=3 clopt=-a -t rqperm=0666 replyq=nrpperm=0666 min=1 ma

33、x=1conv=n system_access=fastpath maxgen=6grace=3600restart=y jrepsvr srvgrp=sysgrpsrvid=4 clopt=-a - -w -p /usr/ipp/etc/jrepository rqperm=0666 replyq=nrpperm=0666 min=1 max=1conv=n system_access=fastpath maxgen=6grace=3600restart=y jslsrvgrp=sysgrpsrvid=5 clopt=-a -t - -i 600 -n /ipp1:4300 -d /dev/

34、tcp -m 10 -m 20 rqperm=0666 replyq=nrpperm=0666 min=1 max=1conv=n system_access=fastpath maxgen=6grace=3600restart=y wsl srvgrp=sysgrpsrvid=6 clopt=-a -t - -i 600 -n /ipp1:4100 -d /dev/tcp -m 20 -m 30 rqperm=0666 replyq=nrpperm=0666 min=1 max=1conv=n system_access=fastpath maxgen=6grace=3600restart=

35、y tgsrv srvgrp=appgrp sequence=100 srvid=1 clopt=-a -s ippsrv - 前台 tuxedo 网关 400 0 50 rqperm=0666 replyq=nrpperm=0666 min=5 max=20conv=n system_access=fastpath maxgen=11grace=3600restart=y tgsrv srvgrp=appgrp sequence=101 srvid=50 clopt=-a -s ippsrv_fr:ippsrv - 前台网关(加密) 410 0 1 rqperm=0666 replyq=nr

36、pperm=0666 min=10max=30 conv=n system_access=fastpath maxgen=11grace=3600restart=y *services ippsrv load=50prio=50 buftype=all trantime=100 autotran=n ippsrv_fr load=50prio=50 buftype=all trantime=100 autotran=n runserver load=50prio=50 buftype=all trantime=100 autotran=n *routing 3.3.2 tuxedo 的域配置文

37、件示例的域配置文件示例 *dm_local_domains lapp gwgrp=sysgrp type=tdomain domainid=spdb_a00000 dmtlogdev=/usr/ipp/log/dmtlog *dm_remote_domains rapp0 type=tdomain domainid=cbs_00000000 rapp1 type=tdomain domainid=bankserverapp *dm_tdomain lapp nwaddr=/7:4200 nwdevice=/dev/tcp rapp0 nwaddr=/4:52

38、00 nwdevice=/dev/tcp rapp1 nwaddr=/1:4200 nwdevice=/dev/tcp *dm_local_services ippsrv *dm_remote_services runserver rdom=rapp0 3.4 大前置大前置 unix 平台安装平台安装 3.4.1 平台运行环境安装平台运行环境安装 1、建立用户建立用户 1）以 root 用户身份登录，用 sam 命令建立 ipp 用户帐号 2）将 ipp 用户加入到 informix 组和 tuxedo 组中 3）若 ipp 用户的根目录不是/usr/ipp，则在/usr 目

39、录下建立一个链接文件， 指向 ipp 用户的根目录：ln s ipp 2、安装产品安装产品 将 ipp 平台产品安装光碟 mount 到你的操作系统中。 将 ipp 平台运行程序拷贝到你的安装目录。 使用 tar 将运行程序展开。 3、修改运行环境修改运行环境 以 ipp 用户登录 1）查看 src/profile 中的和 informix 相关的环境变量 informixdir、onconfig、informixserver 是否和安装 informix 数据库时的定义一致 2）查看 src/tux.env 中的环境变量 tuxdir 是否和 tuxedo 的安装路径一致 3）修改.prof

40、ile . src/profile 3.4.2 平台数据库安装平台数据库安装 以 ipp 用户登录 1）运行 dbaccess 创建 ipp 数据库，日志方式选用 buffered_log 2）进入 ippsrc/table 目录，运行 genipp.sh all y，出现提示： this operation will recreate table, continue(y/n): 回答 y，回车，将创建所有 ipp 平台的表。 3.5 大前置大前置 windows 管理监控台安装管理监控台安装 3.5.1 软件安装软件安装 运行环境是 windows 2000。 安装部分包括 ipp 监控管理

41、的安装和 informix client 安装。 ipp 监控管理的安装步骤如下： 解开 ippcfg.zip 文件到 ippcfg 目录 导入注册表（b.reg）信息 imformix client 安装完成后，需要进行 odbc 数据源的设置。 3.5.2 数据库参数配置数据库参数配置 window2000 下 odbc 配置: 首先安装 informix 客户端。 安装完成后，进入控制面板管理工具 双击数据源（odbc） 系统 dsn 屏幕 点击“添加”按钮 按“完成”按钮完成添加。 回到管理界面，按“配置”按钮进行配置。 配置 odbc 的名字 连接设置 配置完成后，按”apply p

42、getstr(,acztemp,sizeof(acztemp); pttest-if1=atoi(acztemp); /* 字段2 */ pttest-aczf20=0; pgetstr(,pttest-aczf2,test_f2+1); /* 字段3 */ acztemp0=0; pgetstr(,acztemp,sizeof(acztemp); pttest-df3=atof(acztemp); /* 字段4 */ acztemp0=0; pgetstr(,acztemp,sizeof(acztemp); pttest-df4=atof(acztemp); /* sdfsd */ ptte

43、st-aczdsfd0=0; pgetstr(,pttest-aczdsfd,test_dsfd+1); 6.4 ipp 常用函数常用函数 6.4.1 数据存储池常用函数数据存储池常用函数 数据存储池常用函数 函数说明功能说明参数说明 所在的 头文件 int pputstr( char *c_pczname, char *c_pczval ) 向 pool 池中放 入一个字符串 数据 c_pczname：在 pool 池中的存 储名字 c_pczval：字符串值 返回：0成功，-1失败 pool.h int pgetstr( char *c_pczname, char *c_pczbuf, i

44、nt c_ibuflen ) 从 pool 池中取 出一字符串数 据 c_pczname：在 pool 池中的存 储名字 c_pczbuf：取出的字符串值 c_ibuflen：c_pczbuf 的长度 返回： 0（pool_not_found） 无此变量， -1失败 0字符串长度 pool.h int pputmem( char *c_pczname, void *c_pval, int c_ivallen ) 向 pool 池中放 入一数据项 c_pczname：在 pool 池中的存 储名字 c_pval：数据项的指针 c_ivallen：数据项的长度 返回：0成功，-1失败 pool.h

45、 int pgetmem( char *c_pczname, void *c_pbuf, int c_ibuflen ) 从 pool 池中取 出一数据项 c_pczname：在 pool 池中的存 储名字 c_pczbuf：取出的字符串值 c_ibuflen：c_pczbuf 的长度 返回： 0（pool_not_found） 无此变量， -1失败 0字符串长度 pool.h int pool_setputsuff( char *c_pczsuff ) 设置 put 数据 时的数据名称 后缀 c_pczsuff：后缀字符串 返回：successpool.h int pool_setgetsu

46、ff( char *c_pczsuff ) 设置 get 数据 时的数据名称 后缀 c_pczsuff：后缀字符串 返回：successpool.h 6.4.2 tpu 常用函数常用函数 tpu 常用函数 函数说明功能说明参数说明 所在的 头文件 int tpu_setret( char *c_pczretcode, char *c_pczretmsg, . ) 设置返回信息 c_pczretcode：返回码 c_pczretmsg：返回信息 返回：successtpu.h int tpu_seterr( char *c_pczfile, int c_iline, char *c_pczerr

47、code, . ) 设置错误信息 c_pczfile：错误所在的原代码 文件名 c_iline：错误所在的行号 c_pczerrcode：错误信息 返回：success tpu.h int flc_runattr_com( tptattr *c_ptptattr ) 执行原子交易 的通讯构件 c_ptptattr：原子交易配置表结 构 返回：0成功 -1失败 tpu.h void tpl_splitpara( char *c_pczpara, char *c_apczparaname, char *c_apczparaval, int c_imaxparanum, int *c_piparan

48、um ) 把参数字符串 分成参数名数 组和参数值数 组（参数格式： 参数 1参数 值 1；参数 2 参数值 2；。 。 。 ） c_pczpara：参数字符串 c_apczparaname：参数名数组 c_apczparaval：参数值数组 c_imaxparanum：最大参数个 数 c_piparanum：参数个数 tpulib.h void tpl_splitbychar( char *c_pczstr, char c_cchar, char *c_pczstr1, char *c_pczstr2 ) 把一个字符串 根据某个分隔 符拆分成两个 字符串 c_pczstr：被拆分字符串 c_c

49、char：分隔符 c_pczstr1：字符串 1 c_pczstr2：字符串 2 tpulib.h void tpl_splittoarrbycha r( char *c_pczstr, char c_cchar, char *c_apczstr, int c_imaxnum, int *c_pinum ) 把一个字符串 根据分隔符拆 分成字符串数 组 c_pczstr：被拆分字符串 c_cchar：分隔符 c_apczstr：字符串数组 c_imaxnum：最大字符串个数 c_pinum：字符串个数tpulib.h long tpl_getserialno( char *c_pcztype,

50、 char *c_pczdate ) 得到当前流水 号 c_pcztype：流水类型 c_pczdate：日期 返回：=0：流水号 -1：失败 tpulib.h char *tpl_getdate( char *c_pczformat ) 取当前时间 c_pczformat：时间格式字符串 （yyyymmdd，yyyy-mm- dd，hhmmss，hh:mm:ss，hhm mssmmm，hh:mm:ss:mmm，y yyymmddhhmmss，yyyy-mm- dd hh:mm:ss，yyy-mm-dd hh:mm:ss:mmm） 返回：时间字符串 tpulib.h int tpl_strcm

51、pns( char *c_s1, char *c_s2 ) 不分大小写的 字符串比较 c_s1：字符串 1 c_s2：字符串 2 返回：1：字符串 1字符串 2 -1：字符串 1字符串 2 0：字符串 1字符串 2 tpulib.h double tpl_round( double c_dval, int c_iscale ) 四舍五入 c_dval：四舍五入前数值 c_iscale：精度 返回：四舍五入后数值 tpulib.h long tpl_caldiffdate( char *c_pcztype, char *c_pczdate1, char *c_pczdate2 ) 计算两个日期

52、之间的差 c_pcztype：类型 （day，mon，year） c_pczdate1：起始日期 c_pczdate2：结束日期 返回：pczdate2pczdate1 的 值 tpulib.h void tpl_caldatefrom( char *c_pcztype, char *c_pczdate1, long c_ldiff, char *c_pczdate2 ) 计算一个日期 相隔 n 日（年， 月）之后的日 期 c_pcztype：间隔类型 c_pczdate1：日期 1 c_ldiff：间隔值 c_pczdate2：日前 2tpulib.h char *tpl_home()取根目

53、录路径返回：根目录路径tpulib.h 6.4.3 日志常用函数日志常用函数 日志常用函数 函数说明功能说明参数说明 所在的 头文件 phtloginfo openhtlog( char *ident, int option, char *facility, char *profile ) 打开调试信息 ident：调试信息前的提示信息 option：固定为“0” facility：文件名 profile：配置文件 返回：日志信息结构 log.h int htlog( phtloginfo log, int priority, char *value ) 打印调试信息 log：opentlog

54、 时返回的结构 priority：调试级别，调试信息 用 1,运行信息用 4，出错信息 用 6 value：调试信息内容 log.h int htlogv( phtloginfo log, int priority, char *fmt, . ) 同上，参数个 数可变 同上 log.h int htdump( phtloginfo log, int priority, char *value, int len ) 打印调试信息 （16 进制） log：openlog 时返回的结构 priority：调试级别 value：调试信息 len：调试信息长度 log.h void closehtlog

55、( phtloginfo log ) 关闭调试信息 log：openhtlog 时返回的结 构log.h 6.4.3 xml 常用函数常用函数 xml 常用函数 函数说明功能说明参数说明 所在的 头文件 txmldoc * xml_create( char * c_pczfilename ) 构造 xml 结 构 c_pczfilename：文件名 返回：成功有效的 xmldoc 指针 失败null xml.h int xml_destroy( txmldoc *c_pstxmldoc ) 关闭释放 xmldoc 结构 c_pstxmldoc：xmldoc 结构 指针 返回：成功success

56、 失败其它 xml.h int xml_countelement( txmldoc * c_pstdoc, char *c_pczelementname, char * c_pczpath ) 计算 txmldoc 结 构中指定路径 下元素的数量 c_pstdoc：txmldoc 结构指 针 c_pczelementname：元素名 c_pczpath：路径 返回：元素的数量 xml.h int xml_getelementvalu e( txmldoc * c_pstdoc, char *c_pczelementname, int c_iindex, char * c_pczbuf, int

57、 c_imaxlen, char * c_pczdefault, char * c_pczpath ) 取元素的值 c_pstdoc：txmldoc 结构指 针 c_pczelementname：元素名 c_pczbuf：元素值 buf c_iindex：元素索引 c_imaxlen：最大长度 c_pczdefault：缺省值 c_pczpath：路径 返回：=0 长度 其它：失败 xml.h int xml_getelementvalu easint( txmldoc * c_pstdoc, char *c_pczelementname, int c_iindex, int * c_piva

58、lue, int c_idefault, char * c_pczpath ) 同上（整型）同上xml.h int xml_getelementvalu easint( txmldoc * c_pstdoc, char *c_pczelementname, int c_iindex, int * c_pivalue, int c_idefault, char * c_pczpath ) 同上（浮点型） 同上xml.h int xml_getattribvalue( txmldoc * c_pstdoc, char *c_pczelementname, int c_iindex, char *

59、c_pczattribname, char * c_pczbuf, int c_imaxlen, char * c_pczdefault, char * c_pczpath, int c_itag ) 从 txmldoc 结构中的指定 路径下获取元 素属性的值， 如果找不到对 应的属性的值， 则 itag1 的 情况下，找同 名的子元素的 值，否则返回 错误 同上xml.h int xml_getattribvaluea sint( txmldoc * c_pstdoc, char *c_pczelementname, int c_iindex, char * c_pczattribname,

60、 int * c_pivalue, int c_idefault, char * c_pczpath, int c_itag ) 同上（整型）同上xml.h int xml_getattribvaluea sfloat( txmldoc * c_pstdoc, char *c_pczelementname, int c_iindex, char * c_pczattribname, float * c_pfvalue, float c_fdefault, char * c_pczpath, int c_itag ) 同上（浮点型） 同上xml.h txmlelement * xml_xmlel