柜面操作平台COP应用手册.docVIP

联想联想 IT 咨询服务公司咨询服务公司 1 柜面操作平台柜面操作平台 COP 应用手册应用手册 编写人编写人: 刘世昌刘世昌 编写日期编写日期: 2002 年年 7 月月 联想联想 IT 咨询服务公司咨询服务公司 2 目录目录 第一章第一章 COP 平台介绍平台介绍4 1.1 概述.4 1.2 COP 平台的特点 4 1.3 平台体系结构 6 1.4 COP 平台工作原理 7 1.5 COP 平台各部分功能.9 预编译程序 .9 核心处理程序9 流程控制与运算模块10 窗体运行模块.10 数据库服务模块 .11 用户自定义模块 .11 设备驱动程序.11 第二章第二章 COP 平台配置平台配置.12 2.1 COP 平台结构 12 COP 平台结构图 .12 COP 的平台环境变量12 2.2 COP 组件说明 13 bin/ 子目录下的可执行文件 .13 device/ 子目录下存放的各种外设驱动命令码和字库. 13 dllib/ 子目录下存放的设备动态库文件14 config/ 子目录下存放的配置文件14 data/ 子目录存放资源定义和应用程序。 14 data/function/ 前台应用程序存放路径 .14 data/resource/ 前台资源文件存放路径 .15 2.3 COP 配置文件说明 .15 系统参数的配置 .15 copsys.cfg 的使用及配置方法 .15 comm.cfg 的使用及配置方法 .16 host_addr.cfg 的使用及配置方法 16 通讯头配置文件使用及配置方法 .16 copterm 终端模式配置 .17 map 文件配置.18 tft.conf 传输文件文件配置 .19 2.4COP 平台命令19 commsvr19 copc、nn .20 cop20 devload20 tftserver21 init_encrypt.21 2.5 利用 COP 解释执行一个小程序 .22 第三章第三章 交易编制说明交易编制说明 .23 3.1 交易编制基本步骤23 3.2 交易模板及交易驱动器 23 交易模板 23 交易头文件 head.h 25 联想联想 IT 咨询服务公司咨询服务公司 3 交易驱动器 31 3.3 前端新增交易步骤44 3.4 特殊交易的实现 .47 第四章第四章 COP 开发环境开发环境 .50 4.1COP 目录环境50 4.2 环境变量.51 4.3COP 命名规则53 窗口命名规则.53 窗口处理程序命名规则 53 数据域命名规则 .53 数据域处理程序命名规则 53 表格命名规则.54 表格处理程序命名规则 54 菜单命名规则.54 菜单过程命名规则 .55 列表命名规则.55 交易处理程序命名规则 55 键盘事件命名规则 .55 输出对象命名规则 .56 系统程序命名规则 .56 公共程序命名规则 .56 4.4COP 程序编写规范 56 程序规格书 56 修改说明 57 操作前端数据库 .57 程序编写风格.57 4.5COP 程序的编写 58 交易前处理的编写 .58 交易提交前处理的编写 58 数据域前处理的编写59 数据域后处理的编写60 窗口前处理的编写 .60 对象处理的编写 .61 公共程序编写.62 交易调度程序编写 .64 第五章第五章 COP 平台工具平台工具.65 5.1COP 平台工具环境 65 5.2TOOLS.CFG的使用及配置方法.65 5.3 集成开发工具COPTOOLS65 5.4 平台其他工具 .66 广播工具 66 版本更新工具.66 屏幕调整工具.67 传输文件工具.67 联想联想 IT 咨询服务公司咨询服务公司 4 第一章第一章 COP 平台介绍平台介绍 1.1 概述概述 COP 平台 UNIX 版本是一种金融业务系统客户端开发和运行平台。COP 平台是联想金 融业务综合业务系统的客户端应用平台，也可以做为其他业务系统的客户端平台，综合了 国内目前较为广泛使用的 OFP、ACE、CT 等的优点，在易用性、稳定性和通用性方面有更 大的优越性，是目前国内先进的金融行业开发工具产品。 COP 平台所使用的硬件和软件如下所示： 硬件平台 主机: 486 机型以上； 推荐使用 Pentium 166 以上机型。 内存: 8MB 以上； 推荐使用 16MB 以上内存。 硬盘: 280MB 以上； 推荐使用 540MB 以上硬盘。 软件平台 操作系统: SCO UNIX 3.2.4 或 5.0.4 或 5.0.5 数据库管理系统: INFORMIX 2.1 for SCO UNIX 以上版本 其他设备 以太网卡（支持 ScoUnix ） 终端服务器或多用户卡 字符终端 票据/存折打印机 密码键盘 磁卡读写器 编码印鉴 IC 卡读写器 1.2 COP 平台的特点平台的特点 COP 平台做为国内金融业务系统中先进的客户端平台，优势体现在很多方面： 采用业界标准的硬件平台和系统软件，Unix 平台支持 采用先进的三层体系结构，具有良好的可扩展性和适应性 本系统采用了先进的三层软件体系结构，分为应用层、核心处理层、服务层。 应用层定义应用逻辑，核心处理层根据应用逻辑实现系统功能，服务层提供复杂 的通讯、设备操作、数据库服务等。因为业务逻辑的实现只依赖于核心处理层，可以 联想联想 IT 咨询服务公司咨询服务公司 5 很容易的移植到其他操作系统平台上。 采用编译、解释技术，分离业务定义层和系统运行层 采用预编译技术，系统代码效率高，运行速度快。 采用解释执行的方式，隔离了业务定义层和系统层，业务应用开发人员只需要考 虑业务逻辑的实现，并不需要花大量精力去研究专业性极强的通讯驱动、设备驱动、 窗体操作等程序，大大减轻了应用开发人员的负担，缩短了开发周期；业务逻辑层和 系统层的有效分离，隔离了系统故障和应用错误，提高了系统稳定性；同时，这种模 式使业务逻辑的定义不依赖于操作系统和数据库等系统环境，易于移植和扩展。 层次化、面向对象的应用系统设计方法 客户端业务逻辑定制采用面向对象的开发方法，开发人员可根据金融业务的特点， 先创建各个对象，再编制针对每个对象的操作方法。面向对象的开发方法，使业务逻 辑的开发更加简单，且易于扩展、升级和维护。平台上的开发语言 COP，采用面向对 象语法格式，类同 JavaScipt 语言，学习和开发简单。 XML 文件驱动方式 客户端使用的所有对象都是通过定制 XML 文件的方式进行定义的，在通讯交互数 据及业务逻辑定义上，也引入了 XML 文件驱动方式，简明、高效，稳定性高，可移植 性好，扩展性强。 内嵌通讯中间件，支持多种协议、多种通讯方式，可靠性强、效率高 本系统的通讯和交易调度由专门的通讯中间件完成，支持各种通讯协议，如 LU0、LU6.2、TCP/IP 等，还可与第三方的产品结合，如 tuxedo、MQ、CICS 等， 提供强大的通讯功能。因为专门由通讯中间件完成通讯服务，通讯可靠性强、系统效 率高（可提供多次往返通讯） 。 通用的、具有良好开放性的外设支持 提供简单的语法，采用外挂独立模块完成各类外设的操作，支持目前流行的几乎 所有金融外设产品。包括磁卡读写器、密码键盘、存折/票据打印机、IC 卡机等。另 外，因为采用了外挂方式，代码量小而精炼，稳定性好，扩展性强， 必要时还可由厂 商/用户链接成熟的模块。 多种数据库支持 数据库调用采用了外部调用的方式， 提供统一的接口，支持多种数据库。 紧密结合金融业务特点，效率高、开发简单 为了突出行业应用，紧密结合了行业特点，如在信息格式的定义上，借鉴了金融 交易的信息格式，使业务逻辑实现更加容易（如各类联动交易） ，运行效率更高。 灵活严密的安全机制 在系统中，不但充分利用了操作系统的安全机制，还为柜员级用户提供了权限 profile，解决了传统的只能按级别授权的限制，可以按柜员的业务需要设置权限， 使权限控制更加严格和灵活。在数据传输加密中，采用三级密钥管理方式， 既可以采 用传统 DES 加密方式，也可以挂接硬件加密方式，使数据传输过程的安全性大大加强。 开放的用户扩展接口 在 COP 平台中，引入了公用参数区技术，不但可以与外部系统平滑连接，而且还 可以共享所有数据域的数据。 联想联想 IT 咨询服务公司咨询服务公司 6 1.3 平台体系结构平台体系结构 COP 采用了先进的三层结构体系，其与后台架构如下: 通讯 系统包括客户端和服务端，通讯层工作由通讯中间件完成。通讯中间件支持 TCP/IP 或 SNA 通讯协议， 采用消息传递的方式,也可以采用第三方提供的中间件产品,如 tuxedo、CICS、MQ 等;在数据传输时采用 DES 加密或硬件加密方法，保证了通讯的安全 稳定。采用这种 Client/Server 三层模式，既可保证海量交易时的运行效率，又具有良 好的通用性、可扩展性。 客户端 COP 平台 客户端 COP 平台采用了三层结构，最底层为操作系统（UNIX 或 Windows,目前版本 暂不支持 Windows） 、其上为数据库和通讯服务器，而核心业务运行平台是客户端系统的 核心部分。最上层为用户定义的业务逻辑，是通过本系统提供的业务定义格式编制的。 用户采用规定格式编制业务逻辑后，交给核心业务处理程序处理，核心业务处理程序 解释用户指令，并调用相应的运行模块，如数据库服务交给数据库服务器处理，通讯交给 通讯中间件处理，XML 资源处理交给 XML 解析器处理，算术运算则自行处理等。 服务端 服务端可以挂接不同的服务平台，这里以联想金融综合业务后台 SOP 为例说明，有关 SOP 平台的说明参见 SOP 平台说明文档。 服务端的软件实现采用了 Client/Server 三层结构，包括通讯调度模块、交易调度 模块、核心业务定义平台和用户交易处理等部分。 通讯调度程序负责处理数据通讯，它接受来自客户端的请求，将处理结果返回给客户 端。另外，通讯调度程序还负责文件传输及远程调用等工作。 交易调度模块接收来自通讯服务模块的数据，对数据进行分析和预处理，最后根据分 析结果，调用相应的交易处理程序。数据的重新组织、交易一致性保证等工作都是在交易 调度模块中完成的。 用户业务处理程序定义具体交易的实现，核心业务定义平台提供具体交易处理程序的 定义工具，并进行帐务处理、批处理等工作。 COP 平台 核心业务运行平台 关系型数据库 OS(UNIX) 通讯服务 器 数据库服务模块 用户业务定义程序 交易调度模块 核心业务定义平台 关系型数据库 OS(UNIX、OS/400) 通讯服务 模块 用户交易处理程序 TCP/IP、SNA 第三方中间件 SERVER 平台 联想联想 IT 咨询服务公司咨询服务公司 7 客户端 COP 平台硬件连接图如下所示： 网络 接口 PC-UNIX 486以上主机 字符终端视窗终端字符终端 密码 键盘 磁卡 读写器 密码 印鉴器 票据 打印机 密码 键盘 磁卡 读写器 密码 印鉴器 票据 打印机 OLTP SERVER AS/400 RS/6000 HP/9000 客户端连接图 1.4 COP 平台工作原理平台工作原理 客户端 COP 平台的工作原理如下图： 应用程序 (COP语言代码) 预编译器 copc 单元定义（ XML文件中） 、代码自动生成 开发工具 （coptools） 界面 控制 外设 接口 通讯接口（打 解包、通讯传 输） 外装模块 数据库嵌入 式操作 中间码 运行解释器 cop 通讯 服务器 外设服务器 （动态链接库） 由原理图可以看出，COP 的核心是预编译器和解释器，应用程序经过预编译器生成中 间码，解释器通过解释中间码完成前台交易。 联想联想 IT 咨询服务公司咨询服务公司 8 预编译器 预编译器对 COP 源程序进行语法检查，将 COP 应用源程序编译为一种中间码格式， 产生解释执行时所需的后缀式表达式代码、栈空间定位等为加快执行速度而生成的优化信 息和调试信息。中间码由运行解释器 cop 解释执行。 运行解释器 COP 解释器是用户的运行环境，它逐条地解释中间代码文件中的语句，实现窗口、菜 单等交互界面，与外设服务程序和通讯服务器之间的数据传输。 COP 应用程序 COP 应用程序是用户利用 COP 提供的类 JavaScript 语言 COP（内嵌 SQL）编写的 应用程序。每个单 COP 应用程序都会被编译成一个中间码程序，用于解释器的调用。 单元静态定义 COP 采用面向单元的思想。针对银行应用的特点，COP 内部设计了一些应用处理的基 本单位单元。如：窗口单元、菜单单元、选择列表单元等，还有数据输出输入的最小 单元：数据域。 这些单元定义都存储在 XML 文件中，可以用客户端通用开发环境或 COP 工具来制作， 可以脱离程序而在编码前先制作好，大大简化了应用程序的开发工作。 基本语句 COP 的基本语句是支撑平台的基本语法，提供基本的功能。 数据库操作 数据库操作嵌在 COP 平台中，支持标准的 SQL 语法，完成相应的数据库操作。 外装模块 COP 可以连接或者调用外部可执行模块，用户可非常方便地按自己的需求编写 C 语言 模块（如加密模块，特殊校验算法等） ，供 COP 应用程序调用。这样可以使 COP 和用户应 用的安全性隔离开来。 通讯原理 COP 使用通讯设备号来选择不同的通讯协议，COP 对通讯操作只用几个简单的标准语 句。这样，无论是 TCP/IP、TUXEDO、SNA LU0/LU6.2 还是 TOP END 的 REMOTECLIENT，所有这些协议和中间件对用户来说都是透明的。 应用程序只需修改一个通讯设备号，就可以平滑地从一种协议转到另一种协议上去， 并且应用程序可以同时支持多种协议、多个主机。 外设驱动原理 COP 区分常规外设与通用外设，常规外设包括：打印机、终端、密码键盘、磁条读写 器，对于常规外设使用特定函数操作； 而对于通用外设，本系统预留接口，使用设备号来唯一标识一个外部设备接口(PDP), 在对 PDP 操作之前, 必须执行打开设备语句来获得设备号, 以后使用该设备号来操作 PDP,在 操作完成后应关闭 PDP。打开 PDP 时必需指明设备类型号和设备子类型号，设备类型号是 系统预定义的。 COP 对通用外设使用统一的设备接口操作语句, 一般地对通用设备的操作包括 OPEN(打开), CONTROL(控制), READ(读),WRITE(写), CLOSE(关闭)。对于只读设 备，如打印设备, READ 是无效的,在 WRITE 之前应执行必要的 LOCATE(定位)语句。 联想联想 IT 咨询服务公司咨询服务公司 9 COP 对外设的驱动原理如下图所示： 解释器 外设接口 外设服务程序 打印机 动态联接 外设驱动原理图 磁条读写器密码键盘IC卡 驱动 1.5 COP 平台各部分功能平台各部分功能 预编译程序预编译程序 预编译器对业务逻辑定义进行语法检查，将业务逻辑定义编译为一种简单的中间码字 节流，产生核心处理程序所需的堆栈空间分配信息、算术逻辑运算表达式等。 预编译技术的采用，减少了运行时刻的错误，减轻了核心处理程序的负荷，大大提高 了系统运行的效率。 核心处理程序核心处理程序 核心处理程序读入和分析业务逻辑定义的中间码字节流，解释相应的功能定义，并调 业务逻辑定义文 件 字节流词法分析语法分析 语法错 误信息 词法错 误信息 联想联想 IT 咨询服务公司咨询服务公司 10 用各个子运行模块，操作相应的对象和资源。 从客户端平台的工作原理图可以看出，算术逻辑运算、窗体的运行、数据库服务、通 讯实现、设备操作等都是由核心处理程序调度，最后由各个子模块或服务程序完成的。 核心处理程序完全隔离了业务逻辑层和系统层，业务应用开发人员只需要考虑业务逻 辑的实现，并不需要花大量精力去研究专业性极强的通讯驱动、设备驱动、窗体操作等程 序，大大减轻了应用开发人员的负担，缩短了开发周期。 业务逻辑层和系统层的有效分离，隔离了系统故障和应用错误，提高了系统稳定性。 同时，这种模式使业务逻辑的定义不依赖于操作系统和数据库等系统环境，易于移植和扩 展。 关系型数据库 操作系统 底层通讯/设备驱动驱动 核心处理程序 业务逻辑定义 逻辑层次结构 流程控制与运算模块流程控制与运算模块 流程控制模块主要完成程序流程的控制，如循环、跳转、条件判断、子程序调用等功 能的实现。运算模块主要提供各类算术与逻辑运算功能。内部变量及堆栈的控制包含在此 模块中。 流程控制与运算模块是本系统的基本核心模块，是整个系统实现的关键。 窗体运行模块窗体运行模块 在本系统中，所有与界面有关的功能都在此模块中实现。窗体运行模块调入各类显示 对象，把其组织为可显示的内部对象，并按用户指令对其进行操作。如窗口（Window） 的运行、表格的操作， 以及数据域、菜单、列表框、显示框、对话框等对象的操作，都在 窗体运行模块中完成。 另外，窗体运行模块中引入了消息驱动机制， 不但统一了界面的风格，简化了对象定 义的过程，而且大大简化了对象的操作和运行，大大提高了应用开发效率。 联想联想 IT 咨询服务公司咨询服务公司 11 数据库服务模块数据库服务模块 数据库服务模块是用来操作本地数据库的，提供统一的 SQL 调用。本平台支持数据库 操作，可以在业务逻辑定义中直接操作数据库，用以保证关键业务中数据的安全性和一致 性。本平台采用了数据库指令外挂的方式，不依赖于特定的某一种数据库产品，可支持 Informix、Sybase、Oracle、UDB 等。 用户自定义模块用户自定义模块 在客户端，为了增强业务逻辑定义的灵活性和可扩展性，预留了用户自定义接口。用 户有特殊需要时，可提供相应的业务操作模块，链接到平台中，这样就直接可以在业务逻 辑文件中调用，既简便又高效。 另外，用户可以自行定义与外部系统的接口，通过外部程序对平台的公用参数区进行 操作，做到了 COP 与外部系统的无缝连接。 设备驱动程序设备驱动程序 COP 提供丰富的外设支持，外设驱动采用了外挂服务程序、独立执行的方式，其优点 是： 1) 设备操作与平台分离，设备错误不会造成系统中断或死机 2) 外设驱动完全独立，对于新出现的外设，只要根据厂家提供的指令集，改写 一下相应设备驱动部分即可，大大提高了系统开放性和可扩展性。 COP 可支持目前市场上流行的几乎所有外设类型。 以下是客户端平台可支持的部分外设类型： 密码键盘 实达、国光、新大陆、莱克、长城 磁卡读写器 AMC、莱克、长城、南天、国光 存折票据打印机 PR50、PR2、OKI53XX、IBM9068 密码印鉴 新国都 通讯服务程序 通讯服务是通过通讯中间件完成的，请参看通讯中间件部分。 联想联想 IT 咨询服务公司咨询服务公司 12 第二章第二章 COP 平台配置平台配置 COP 的安装是将嵌入在整个客户端系统的安装上的，只要将端末系统软件包（tar 格 式，包含 COP 系统）解开即可，其中内嵌了 tuxedo 中间件的客户端、informix2.0， 不需要另行安装；COP 解开后的系统结构可以参看以下描述。 2.1 COP 平台结构平台结构 COP 平台结构图平台结构图 COP 的平台环境变量的平台环境变量 (以 COP 用户安装为例，假定 COP 安装在/usr 目录下，$HOME=/usr/cop) 表 21 COP 系统环境变量 系统环境变量名称安装缺省值 COPCFG$HOME/config/copsys.cfg DBDATEY4MD DBNAMEcopdbs TERMvt100 INCDIR$HOME/data/include INFORMIXDIR$HOME/informix/ DBPATH$HOME/other/sql: $HOME/data/databse 联想联想 IT 咨询服务公司咨询服务公司 13 LANGenglish_us.8859 TUXDIR$HOME/tuxedo LD_LIBRARY_PATH$TUXDIR/lib:$HOME/dllib TFTCFG$HOME/config/tft.conf TFT_CLIENT_PRINTDIR$HOME/ftp FLDPATH$HOME/data/resource/field GRIDPATH$HOME/data/resource/grid MENUPATH$HOME/data/resource/menu LISTPATH$HOME/data/resource/list WINPATH$HOME/data/resource/window PATH$TUXDIR/bin:$HOME/bin:$PATH 2.2 COP 组件说明组件说明 bin/ 子目录下的可执行文件子目录下的可执行文件 cop COP 解释器 copc COP 源程序编译命令 copccCOP 编译器 nn简捷的编译命令 cpp 预编译器 commsvr 通讯服务器 getsql数据库执行语句编译程序 devload外设驱动装载、卸装、查看程序 xml_parseXML 解释器 init_encrypt密钥初始化工具 tftclient传输文件工具客户端 tftserver传输文件工具服务器端 broadcli广播工具客户端 broadsvr广播工具服务器端 device/ 子目录下存放的各种外设驱动命令码和字库子目录下存放的各种外设驱动命令码和字库. jcfont16.lib 16 点阵字库 jcfasc16.libASCII 码 16 点阵字库 jcfont24.lib 24 点阵字库 printer.drv打印机驱动命令码 keypad.drv密码键盘驱动命令码 magcard.drv磁条读写器驱动命令码 term.drv终端驱动命令码 dllib/ 子目录下存放的设备动态库文件子目录下存放的设备动态库文件 libdev_dyfunc.so设备动态函数库 联想联想 IT 咨询服务公司咨询服务公司 14 config/ 子目录下存放的配置文件子目录下存放的配置文件 copsys.cfg COP 平台的目录设置配置文件 comm.cfg 通讯配置文件 system_head.cfg 系统头配置文件 cmtran_head.cfg 交易公共头配置文件 tran_head.cfg 交易头配置文件 cmtran_rcv_head.cfg 交易接收公共头配置文件 host_addr.cfg主机地址配置（代码方式） tft.conf传输文件配置文件 copterm生成终端驱动文件的源文件 data/ 子目录存放资源定义和应用程序。子目录存放资源定义和应用程序。 database/数据库存放路径 down/后台下载数据存放路径 down/sock/交易通讯接口文件存放路径 function/应用程序存放路径 include/应用头文件存放路径 report/下载报表存放路径 resource/资源文件存放路径 tmpdata/平台临时数据存放路径 winlog/平台日志文件存放路径 data/function/ 前台应用程序存放路径前台应用程序存放路径 main/应用系统主程序存放路径 pulic/公共应用程序源代码存放路径 tran/交易前、交易后、提交前处理源代码存放路径 window/窗口前、窗口后事件源代码存放路径 menu/菜单动作源代码存放路径 grid/表格菜单动作源代码存放路径 field/数据域的域前域后动作源代码存放路径 key/窗口及 FORM 里定义的键盘事件源代码存放路径 object/后端返回对象处理源代码存放路径 print/后端返回打印对象处理源代码存放路径 jav/应用程序中间代码存放路径 data/resource/ 前台资源文件存放路径前台资源文件存放路径 field/FIELD 资源 XML 文件存放路径 grid/GRID 资源 XML 文件存放路径 menu/MENU 资源 XML 文件存放路径 list/LIST 资源 XML 文件存放路径 window/WINDOW 资源 XML 文件存放路径 联想联想 IT 咨询服务公司咨询服务公司 15 COP 平台在安装完成后，各路径默认是安装在上述目录下，如果有特殊需要而改变， 可以通过更改配置文件 copsys.cfg 文件和有关的目录环境变量设置来实现。 2.3 COP 配置文件说明配置文件说明 COP 的所有产品组件安装完毕后，用户接着必须对所有配置文件进行正确的设置和确 认，方可在重新登录后顺利的使用 COP 平台。 COP 的主要配置文件包括：copsys.cfg , comm.cfg ,下面让我们来详细的讲解 一下各配置文件的使用和配置方法。 系统参数的配置系统参数的配置 COP 平台的通讯用到 UNIX 系统的消息队列，所以修改系统参数以确保 COP 平台在通 讯时稳定成功。 以 root 用户登陆，执行/etc/conf/cf.d/configure，修改消息队列(message queue)的参数值，修改内容如下： MSGMAP8192 MSGSEG8192 MSGMAX20480 MSGMNB20480 copsys.cfg 的使用及配置方法的使用及配置方法 copsys.cfg 主要用来设置存放基于 COP 平台开发的应用系统的源代码和中间代码的 搜索路径，以及所需驱动程序和配置文件的搜索路径。 copsys.cfg 文件的具体内容如下（以将使用 COP 产品的应用系统存放在/usr/cop 目录下为例）: COMMFMTPATH /usr/cop/data/down/sock/存放通信格式文件的路径 FUNCPATH /usr/cop/data/function/jav/ 存放函数中间代码的路径 COMMCFGPATH /usr/cop/config/存放配置文件的路径 DEVCFGPATH /usr/cop/device/存放各驱动程序的路径 SAVEWINPATH /usr/cop/data/winlog/存放日志文件的路径 以上的资源路径程序员可以根据自己的想法修改，只要在 copsys.cfg 中修改相应的 配置即可。例如，如果程序员想要把函数的中间代码存放在自己建立的/usr/cop/new 下， 只要将 copsys.cfg 中 FUNCPATH 后面的路径设置为/usr/cop/new/就可以了，余者 类推。 为保持各应用系统的一致性，建议使用默认路径。 comm.cfg 的使用及配置方法的使用及配置方法 该配置文件在使用通讯服务器 commsvr 时使用，用来描述通讯号、通讯协议名称及 主机名称（或 IP 地址）和端口号的对应关系。 联想联想 IT 咨询服务公司咨询服务公司 16 安装后的内容为： 1TCP/IP674000主机 2TCP/IP674000 3BROADC 7000 其中，第一列为通讯号，是平台通讯对象的编号，第二列为通讯协议名称，可以为 TCP/IP 协议、TUXEDO 中间件等，当为 BROADC 时代表为广播工具使用通讯对象，第三 列为主机名或主机 IP 地址（如为主机名则/etc/hosts 内必须有此名的解析） ，第四列为 主机端口号，最后一列为说明，后台的主机必须用“主机”两字指明（为加密方式取通讯 密钥所用） 。 如果您想增加新的协议或主机，需要在 comm.cfg 文件中加入相应的一行。 例如，如果您想在 AS400 上用 TCPIP 协议，则需要如下描述： 4 TCPIP AS4006000 host_addr.cfg 的使用及配置方法的使用及配置方法 host_addr.cfg 为主机地址配置文件，用于通讯中通讯头数据的填写，现在没有用 到，为保留配置文件，使用下面默认值： -10650640 000000000 1000c0000 2000d0000 3000e0000 4000f0000 详见通讯格式符号地址定义说明 。 通讯头配置通讯头配置文件使用及配置方法文件使用及配置方法 通讯头配置是指通讯中所用到的配置文件，共有四个配置文件： system_head.cfg（系统头配置文件） 、cmtran_head.cfg（公共交易头配置文件） 、 tran_head.cfg（交易头配置文件） 、cmtran_rcv_head.cfg（交易接收公共头配置 文件） ，其字段可以删减调整等，但必须保持与后台一致。其格式为： fieldname len type scale align fillchar 其意义分别是： fieldname字段名称 len字段长度，为实际的存储长度,如整型为 4 type字段类型，n-short，N-integer，L-long， D-decimal，S-char，Q-date ， T-time，H-hex，B-CHN scale小数点后位数 align对齐方式，0-左对齐 1-右对齐 2-中对齐 3-无对齐 fillchar填充字符 各配置文件的字段意义如下： system_head.cfg sysLENGTH 0 I 0 0 0#信息长度unsigned short/转换成网络格式 sysSADDR4 H 0 0 0 #源地址unsigned char(4) /二进制方式存储 sysDADDR4 H 0 0 0#目标地址unsigned char(4) /二进制方式存储 sysRSRVD1 H 0 0 0#系统保留位 unsigned char(1) /二进制方式存储 联想联想 IT 咨询服务公司咨询服务公司 17 sysEFLAG1 S 0 0 0#信息结束标志 unsignedchar(1)/二进制方式存储 sysSEQNUM 0 I 0 0 0#报文序号unsigned short/转换成网络格式 sysMACFLAG 1 S 0 0 0 #校验标志unsigned char(1) /二进制方式存储 sysMACVALUE 8 H 0 0 0#校验值unsigned char(8) /二进制方式存储 cmtran_head.cfg FDZHNGDH5 S 0 0 0#终端号char(5)，String/字符串方式存储 FDCHSHDM4 S 0 0 0#城市代码char(4)，String/字符串方式存储 FDYNGYJG4 S 0 0 0#营业机构号 char(4)，String/字符串方式存储 FDJIO1GY8 S 0 0 0#交易柜员char(8)，String/字符串方式存储 tran_head.cfg FDJIAOYM4 S 0 0 0#交易代码char(4)，String/字符串方式存储 FDJIOYZM2 S 0 0 0#交易子码char(2)，String/字符串方式存储 FDJIOYMS1 S 0 0 0#交易模式char(1)，String/字符串方式存储 FDJIOYXH4 N 0 0 0#交易序号unsigned long/转换成网络格式 FDCOMMLN2 I 0 0 0 #本交易包长度 unsigned short /转换成网络格式 FD_COFF12 I 0 0 0#系统偏移 1 unsigned short/转换成网络格式 FD_COFF22 I 0 0 0#系统偏移 2 unsigned short/转换成网络格式 FDSHOQGY8 S 0 0 0#授权柜员char(8)，String/字符串方式存储 FDSHOQMM8 S 0 0 0#授权密码unsigned char(8) /二进制方式传输 cmtran_rcv_head.cfg FDJIAOYM4 S 0 0 0#交易代码char(4)，String/数字字符串 FDLDJYDM4 S 0 0 0#联动交易码 char(4)，String/数字字符串 FDJIOYRQ8 S 0 0 0#交易日char(8)，String/数字字符串 FDJIOYSJ4 N 0 0 0#交易时间unsigned long/转换成网络格式 FDGUIYL12 S 0 0 0 #柜员流水号 char(12)，String /字符串方式存储 FDCWJYXH2 I 0 0 0#出错交易序号 unsigned short /转换成网络格式 YYCWDM7 S 0 0 0#交易状态char(7)，String/出错代码：成功返 回 AAAAAAA，其他返回错误代码 copterm 终端模式配置终端模式配置 由于终端 vt100 仿真方式不支持翻页键，因此我们选用 vt220 方式为基础，加入了 一些个性键，用以完成对界面输入的控制； 在配置文件目录下，有一个源文件 copterm，其中定义了 F11F16 的键值，其中 F1F12 是键盘上的 F1F12 键，F13F16 是右侧副键盘的 NUM LOCK、/、*、-四个键。此外还包含上下翻页等键。 只要在超级用户下用命令 tic copterm 编译该源文件即可。 map 文件配置文件配置 通讯打包数据的配置，包括对象配置文件和 GRID 配置文件，其格式为： 联想联想 IT 咨询服务公司咨询服务公司 18 第一行指明该对象的输出方向，WINDOW 代表窗口，PRINTER 代表打印机，从第二行 起格式如下：（可以有任意行） FLD|GRD:name len type scale align fillchar turnmode string encrypt（对于 GRID，只能有 FIELD，配置文件名就是 GRID 的名字） ，具体字段的含义 由应用层定（都是由后台接口文件自动生成） 。 其意义分别是： FLD|GRD字段或表格标识，当为 GRD 时，后面只有 name 项 namefield 字段名称或表格 Grid 名称 len字段长度，为实际的存储长度,如整型为 4 type字段类型，n-short，N-integer，L-long， D-decimal，S-char，Q-date ， T-time，H-hex，B-CHN scale小数点后位数 align对齐方式，0-左对齐 1-右对齐 2-中对齐 3-无对齐 fillchar填充字符 turnmode转换模式，1-将传回的数据转为汉字金额 2-转换为列表中的内容 3-将数据转换为日期大写 4-为空不打印 5-不管为不为空都不打印 string如果要转换成列表内容,则指明列表名,否则为空(填 NULL) encrypt加密标志，1-加密，0-不加密 例如： O93132 WINDOW FLD:GUIYDH 8 S 0 0 0 0 NULL 0 FLD:GUIYXM 22 S 0 0 0 0 NULL 0 FLD:QISHRQ 8 Q 0 0 0 0 NULL 0 FLD:ZZHIRQ 8 Q 0 0 0 0 NULL 0 GRD:F931301 F931301 PRINTER FLD:HUOBDH 2 S 0 0 0 0 NULL 0 FLD:JIEDBZ 1 S 0 0 0 0 NULL 0 FLD:XJDFSE 13 D 2 0 0 0 NULL 0 FLD:XJDFBS 7 L 0 0 0 0 NULL 0 FLD:ZZDFSE 13 D 2 0 0 0 NULL 0 FLD:ZZDFBS 7 L 0 0 0 0 NULL 0 tft.conf 传输文件文件配置传输文件文件配置 有关传输文件文件工具的使用方法，详见 COP 平台工具手册 。因为在 COP 平台上， 有关打印等对象的传输，都是通过通讯服务器统一传输的，但对于批处理或传输大文件的 特殊要求时，要用到传输文件工具 TFT，这里对此配置文件进行简单说明。 传输文件的配置文件例子如下所示：（右面为加的说明） COMMTYPE # 工具使用协议 PROTOCOL=TCP # TCP 协议 联想联想 IT 咨询服务公司咨询服务公司 19 TCP # TCP 协议部分 MYIP=05 # 本机地址 TIMEOUT=100 # 传输文件超时时间 COMPRESSED=0 # 是否自动加缩（现保留） LEVEL=0 # 压缩级别（现保留） COMPRESSSIZE=5 # 压缩起始文件大小（现保留） TCPHostNum=3 # 远端 SERVER 数目 TCPHOST01 # 远端 SERVER1 信息内容 HOSTNO=0 # 主机号 IP=00 # 地址 PORT=7800 # 端口号 TCPHOST02 # 远端 SERVER2 信息内容 HOSTNO=1 # 主机号 IP=01 # 地址 PORT=8700 # 端口号 TCPHOST03 # 远端 SERVER3 信息内容 HOSTNO=2 # 主机号 IP=03 # 地址 PORT=7700 # 端口号 HOST # 本地 SERVER 信息 PORT=8800 # 端口号 上面的配置文件是在同一机器既有服务端又有客户端的情况，实际应用中只作服务端 时可省略对远端 SERVER 的配置，只作客户端时可省略对本地 SERVER 的配置。 配置文件中可用“#”或“/”作为对一行的注释，不过必须在一行的开始处。 2.4COP 平台命令平台命令 commsvr 在启动 COP 平台时，不管是开发环境还是运行环境，如果要与后台进行交易通讯，就 必须有通讯服务器的支持。commsvr 命令用于启动或关闭 COP 平台的通讯服务，命令格 式为： commsvr start|stop option 在 SHELL 提示符下输入 commsvr，不带参数运行，就会显示如上的命令用法提示。 Option 选项用于对通讯服务器的监控，可以为-d logname，如果只有-d，后面没有 logname，则生成的日志文件为/tmp/commsvr.log，否则生成日志为 logname 所指文 件名，文件名可以带路径名。 下面是 commsvr 常用的一些方法： 启动 COP 平台通讯服务 commsvr start 如果当前平台上没有通讯服务在运行，则返回到 SHELL 提示符表示通讯服务启动 联想联想 IT 咨询服务公司咨询服务公司 20 成功。如果平台上已经有通讯服务在运行，则显示： commsvr already runing PID=8798 关闭 COP 平台通讯服务 commsvr stop 一般显示为： Stop running commsvr , PID=11457 . Stop 1 running commsvr. 如果没有通讯服务在运行，则显示： commsvr stop : no running commsvr. 启动 COP 平台通讯服务，并打印日志文件 commsvr start d日志文件为/tmp/commsvr.log commsvr start d /tmp/aaa.log日志文件为/tmp/aaa.log copc、nn 对于 COP 平台的 COP 语言程序，要经过编译器编译成中间码，经过解释器解释运行。 Copc 是平台的编译命令，用法为： copc srcname 其中，srcname 是 COP 语言的应用程序（后缀.cop） ，copc 命令对应用程序用 UNIX 系统的 c 语言预处理器 cpp 对头文件进行预处理，并调用 copcc 对程序进行编译， 形成同名的中间码程序（后缀.jav） ，存放在平台配置所指定的中间码目录，默认为 $HOME/data/function/jav。 为方便程序员编译平台应用程序，平台提供命令 nn，此命令主要用于匹配编译，运行 此命令将编译当前目录下与命令后所带字符串相匹配的所有 COP 语言文件，如： nn 0001 将编译当前目录下所有名字中含有”0001”的 COP 文件。 cop cop 是 COP 平台的中间码程序解释器，用法为： cop proc_name option proc_name 是 COP 程序中间码的文件名，输入时不带后缀，只输入文件名。因为 copc 在编译时程序名与中间码文件名相同，所以 proc_name 实际上就是指 COP 应用程 序名。 option 选项用于对解释器进行细节调试时使用，一般开发人员不用。 devload 在 COP 平台上，对外设采用配置文件的方法，设置驱动库，对各种设备用外挂的方法， 平台调用时采用统一的接口，这样大大方便了外设的增加和修改，具有很大的可扩展性和 适应能力。Devload 用于开发调试时对外设的配置查询、修改和装入。其用法为： devload -k|-m|-p|-t type -d filename -o|-i filename -k-密码键盘 -m-磁条读写器 -p-打印机 -t-终端 type-设备类型号 -d-driver 联想联想 IT 咨询服务公司咨询服务公司 21 filename-驱动文件名 -o-unload,输出 -i-load,输入 filename-输入,输出的源文件 对开发时设备的调试，主要是查看应用中的设备号所对应的设备类型和设备安装时的 接口，并对接口或设备号进行修改，以适应现场的需要。下面以密码键盘为例进行说明 查看密码键盘类型号为 3 的设备 devload k 3 o pin3 上述命令将密码键盘驱动库中类型为 3 的配置内容输出到文件 pin3 中。打开文 件 pin3 可以看到此类型为 NianTianPk，密码键盘应接在辅口 1，假如现在要将密 码健盘接在辅口 2，可更改 pin3 文件，并用下面的装入命令使其生效。 装入密码键盘类型号为 3 的设备 devload k 3 i pin3 此命令将配置文件 pin3 的内容装到驱动设备号为 3 的位置。 如果新增加一种设备类型名，需要用到-d 选项。现在各金融外设基本都有仿真类型， COP 平台驱动库内类型已完全能适应，一般用到这项功能很少。 对增加设备和配置文件的具体操作一般对程序员是透明的，如需要了解详细内容请参 考COP 平台工具手册相关说明。 tftserver 因为在 C