SOP通讯报文规则20020917.doc

1、联想集团有限公司SOP 通讯格式规则1.概述通讯数据包由公共信息部分、交易数据部分公共信息部分包括系统信息头和交易公共信息头。交易数据部分包括交易数据头（可选） 、业务数据和系统控制命令。业务数据部分又包括数据单元、表格和对象。业务数据部分可以插入系统控制命令。1.1 系统信息头部分是与系统相关的，包括目标服务代码、数据源代码、长度等系统信息，由系统配置文件（数据库表，下同）指定，每字段的个数、顺序、长度固定。1.2 交易公共信息头部分是跟同一数据包中所包含的所有交易相关的信息，包括交易的终端，交易柜员，机构等信息，组织方式同系统信息头的格式。1.3 交易数据头部分包括交易代码，交易模式，前台

2、流水号,授权柜员等信息，组织方式同系统信息头的格式。1.4 业务数据部分 由长度+数据组成，长度用一个字节的二进制数表示，数据全部转换成字符串传送，字符串的最大长度由系统的 BYTE_MAX_LEN 宏定义指定（在本系统里，我们定义 BYTE_MAX_LEN 为 250（ 0xFA） ） ，大于该长度的部分系统保留作为控制命令用。如果数据单元的长度超过BYTE_MAX_LEN，则分段发送， 0xFF 作为超长数据的标志。例如要传768 字节数据，由于系统定义 BYTE_MAX_LEN 为 250，则该数据段为0xFF+250 字符 +0xFF+250 字符+0xFF+250 字符+0x12+1

3、8 字符；如要传 250字节数据时，则该数据段为 0xFA+250 字符。控制命令部分。在业务数据中，可以穿插控制命令，其格式为：控制字符标志+控制字符串长度+控制字符串。控制字符标志由系统保留的 BYTE_MAX_LEN0xFF 之间的字符标识，在本系统中系统保留字符为 0xFB，0xFC，0xFD，0xFE，目前仅使用 0XFE 作为打印相关的控制命令标识符。整个通讯数据包的组成示意图如下：公共信息 交易数据交易头 业务数据系统信息头交易公共信息头交易数据头数据单元数据单元数据单元表格单元对象单元。 。 。控制命令码可以穿插在业务数据之间，如单元与单元之间，表格内部数据项之间，以及对象内数

4、据项之间联想集团有限公司下面将分几个部分详细描述整个系统的通讯格式。2.单元定义2.1 数据单元（TRANFLD）数据单元 TRANFLD 是 COP 和 SOP 中代表特定内容的基本数据项，一般对应一个应用数据定义，在 SOP 平台中采用可自解包的通讯格式。数据单元通讯格式如下：可选 机构名 可选金额 可选 266 字节数据 。 。 。属性 0X5“A 网点” 属性 0X “123.45” 属性 0xFF250 字节 0X1016 字节每一个数据单元在通讯格式中用两个部分表示长度+内容。内容部分都以字符串方式传输，截掉前导和后续的空格，以减少冗余数据的传输。长度以一个字节的 16 进制数表示

5、，可表示的最大长度为 250（0XFA）字节，若数据单元长度超过 250 字节，则采用分解传送的方式，以 0XFF 表示数据单元超长，如上图中 266 字节数据单元。长度定义中 0XFB0xFE 保留，作为控制命令使用，见控制命令描述。属性是可选项，可以包括多种属性，目前仅支持打印属性。对于一般数据单元不需要定义，对于其它对象一般需要定义相应属性。打印属性定义格式如下：打印行 打印列 打印模式 0， 本系统中，要求 Y=250 & X=250。打印模式的具体含义见打印模式定义。打印: row col mode0xfe 0x01 0x0c2.2 表格单元（FORM）表格单元 FORM 是指 CO

6、P 和 SOP 平台中由格式相同的多条记录组成的复合数据单元，其中每一条记录的数据又由多个数据单元组成。表格在通讯格式中以表格名+记录条数+多条记录数据组成，每一条记录又由多个数据单元（表示方法同数据单元）表示。表格单元的通讯格式如下：表格名 记录条数栏位个数可选项 记录 01 记录 020X3 “F01” 0X20X3打印属性或其它0X3“ABC” 0X2借 0x “1234.99” 0X4“李明” 0X2贷 0x5“20.00”联想集团有限公司表格名长度表格名称见下表 姓名项 借贷标志项金额项 姓名项 借贷标志项金额项属性是可选项，在一般数据单元的定义中不使用。在本系统中，记录条数不得大于

7、 250 个。如果记录条数可能大于 250 条，必须采用文件传输的方式解决这一问题。表格的打印属性定义如下：起始行号 打印列 模式 打印列 模式 。 。 。 打印列 n 模式 nY X1 M1 X2 M2 Xn Mn模式 M1Mn 为数字代码，含义同数据单元中的说明。其它属性定义可以根据扩展对象的属性进行定义。打印：换页：0xfe 0x1 0x0c换行： 0xfe 0x1 0x0a2.3 对象单元COP/SOP 的对象代表一个具有特定属性的复合数据单元，是 COP/SOP 系统实现后台驱动前台的基础。对象描述中必须包括对象名，其它属性如字段排列顺序等可在外部静态定义。对象的组成元素可以包括数据

8、单元和表格单元等系统支持的各类单元。在 COP/SOP 系统中，对象的类型可以根据需求进行扩展和定义，目前支持的对象类型包括 窗口对象 、 打印对象 等。对象一般由对象名+数据单元( 可选项)+表格单元(可选项)组成。一个包含数据单元和表格单元的窗口对象的通讯格式如下：对象名 对象内容0X5 “OBJ01” 数据单元数据单元。 。 。 表格单元 01 数据单元。 。 。窗口对象 的对象内容中不包含数据单元和表格单元的可选属性，如行、列、模式等信息。打印对象 由对象名+打印属性数据单元( 可选项)+表格名称记录条数栏位数打印属性格数据(可选项 )打印控制命令码（可选项）组成。打印控制命令码见打印

9、控制命令码介绍。打印对象：row + col + mode 2.4 控制命令码控制命令码可以穿插在数据单元之间，也可以穿插在表格单元的数据项之间。COP/SOP 系统中保留了XFB0XFE 之间的取值作为控制命令标志用。目前仅使用控制命令标志 0XFE，作为打印控制命令码传输标志。联想集团有限公司控制命令标志 控制命令长度 N 位控制序列0XFE 0xN 0x14。 。 。在这里有一个换页打印的问题，本系统定义了 0xFE 为系统控制命令标志，换页符为0x0c。因此，如果需要换页打印，该换页控制命令串为 0xFE+0x01+0x0c；该串可以置于打印对象的数据单元或表格单元之前（如 0xFE+

10、0x01+0x0c+TRANFLD 或 FORM） ，也可以置于 FORM 数据中某一条记录之前（如 FORM 的第 n-1 条记录 +0xFE+0x01+0x0c+FORM 的第 n 条记录） ，其它地方一概予以忽略。3 输入信息格式输入输出是相对后台主机而言的。输入信息是指客户端发向后台主机的信息。输入信息包由系统信息头、交易公共头、交易数据头、业务数据组成。其中系统信息头、交易公共头和交易数据头采用结构化的数据格式；业务数据采用长度加字符串的传输方式，在本系统中，除二进制数据外，其他数据都转换成字符串类型进行传输。输入信息包的格式如下：公共信息 交易数据 1 交易数据 2 。 。系统信息

11、头交易公共头交易数据头数据单元数据单元表格单元。 。 。 交易数据头数据单元数据单元。 。输入信息格式中不允许存在对象单元和控制命令码，业务数据由数据单元和表格单元组成。数据单元和表格单元的传输格式见单元定义。下面将介绍系统信息头、交易公共头、交易数据头三个部分的数据格式。3.1 系统信息头系统信息头的格式如下：（23bytes）数据包长度 （SHJBCD） unsigned short /转换成网络格式目标地址 (YNDIZH) unsigned char(4) /二进制方式存储源地址 (MBIODZ) unsigned char(4) /二进制方式存储系统保留位 (BOLIUW) unsi

12、gned char(1) /二进制方式存储信息结束标志(XXJSBZ) unsigned char(1) /二进制方式存储报文序号 (SJBSXH) unsigned short /转换成网络格式校验标志 (JIOYBZ) unsigned char(1) /二进制方式存储校验值 (JIOYNZ) unsigned char(8) /二进制方式存储联想集团有限公司字段说明信息长度：表示整个数据包的长度，包括本数据项所占用的字节数。目标地址：目标服务器的地址，以代码表示，包含目标服务器，服务端口等信息。具体表示方法见附录。源地址：交易发起端地址，以代码表示，包含源设备，服务端口等信息。具体表示方

13、法见附录。系统保留位：暂不使用。默认设置为信息结束标志：为适应多包数据通讯保留，默认设置为报文序号：为了防止报文恶意重发设置，暂不使用，默认值为校验标志：是否需要 MAC 或其它校验校验值： 校验算法生成的数据项3.2 交易公共头公共交易头格式如下：(21bytes)终端号 ZHNGDH char(5) String /字符串方式存储城市代码 CHSHDM char(4) String机构代码 YNGYJG char(4) String交易柜员 JIO1GY char(8) String字段说明终端号：交易发起端终端号，省略 TTY，如 21a 表示终端 tty21a。城市代码：暂不使用，设置

14、为空格机构代码：银行机构代码。交易柜员：交易柜员代码。3.3 交易数据头交易数据头格式如下：(45bytes)交易代码 JIAOYM char(4) /String交易子码 JIOYZM char(2) /String交易模式 JIOYMS char(1) /String交易序号 JIOYXH int /int联想集团有限公司本交易包长度 COMMLN unsigned short /系统偏移 1 PNYIL1 unsigned short /0xFFFF 为无效系统偏移 2 PNYIL2 unsigned short /0xFFFF 为无效前台流水号 QTAILS char(12)授权柜员

15、SHOQGY char(8) /String授权密码 SHOQMM unsigned char(8) / 二进制方式传输字段说明交易子码： 判断某个复合交易中的子交易码, 暂不用。交易模式: 暂不用交易序号：主要为组合交易使用，是前台带到后台的组合交易序号 (cop 用)。系统偏移：记录加密字段的偏移位置4 输出信息格式输出信息是指后台交易完成后返回给前台的通讯数据，由系统信息头、交易公共头、返回业务数据组成。输出信息包的格式如下：公共信息 业务数据系统信息头交易公共头对象 1 对象 2 。 。 。 对象 n4.1 系统信息头系统信息头同输入信息格式。4.2 交易公共头交易公共头的数据格式如下

16、：(41bytes)交易代码 JIAOYM unsigned char(4)联动交易码 LDJYDM unsigned char(4)交易日期 JIOYRQ char(8)交易时间 JIOYSJ integer柜员流水号 GUIYLS char(12)出错交易序号 CWJYXH short错误代号 PTCWDH char(7) /成功返回 AAAAAAA，其他返回错误代码字段描述交易代码： 输入数据中的第一个交易代码。联想集团有限公司交易时间： 用整数表示，如：9:45:10 为整数 94510。柜员流水号：财务交易产生，包含八位柜员号及六位顺序号信息。出错交易序号：出错交易的交易序号，是由前

17、台生成并传输到后台的。错误代号： 前三位为错误类型，后 4 位为错误代码。4.3 业务数据部分对于业务数据部分，采用对象传输方式，不允许直接传输单独的数据单元或表格单元。4.3.1 错误信息对象在错误情况下，此处为错误描述对象，其格式如下例：错误信息对象名 错误信息0X6 “ERR000” 0X02 错误号长度 错误代码长度 错误信息0x06+ERR000 +0x02 +-1 +0x07+errid(ETL0001)+错误信息的长度+errmsg4.3.2 正常交易对象交易状态正常情况下，数据格式如下：业务数据对象 对象 。 。 。 对象 N5.附录：打印模式定义打印模式 字符代码 含义0（默

18、认） S4c1 宋体，正常字，15CPI，6LPI1 S4c1 宋体，正常字，15CPI，6LPI2 S4C1 宋体，正常字，10CPI，6LPI3 S4c2 宋体，正常字，15CPI，8LPI4 S4C2 宋体，正常字，10CPI，8LPI5 S4c3 宋体，正常字，15CPI，10LPI6 S4C3 宋体，正常字，10CPI，10LPI7 S4c4 宋体，正常字，15CPI，12LPI8 S4C4 宋体，正常字，10CPI，12LPI9 S4c5 宋体，正常字，15CPI，4LPI10 S4C5 宋体，正常字，10CPI，4LPI11 S3c1 宋体，倍高字，15CPI，6LPI12 S3

19、C1 宋体，倍高字，10CPI，6LPI联想集团有限公司13 S3c2 宋体，倍高字，15CPI，8LPI14 S3C2 宋体，倍高字，10CPI，8LPI15 S3c3 宋体，倍高字，15CPI，10LPI16 S3C3 宋体，倍高字，10CPI，10LPI17 S3c4 宋体，倍高字，15CPI，12LPI18 S3C4 宋体，倍高字，10CPI，12LPI19 S3c5 宋体，倍高字，15CPI，4LPI20 S3C5 宋体，倍高字，10CPI，4LPI21 S2c1 宋体，倍宽字，15CPI，6LPI22 S2C1 宋体，倍宽字，10CPI，6LPI23 S2c2 宋体，倍宽字，15C

20、PI，8LPI24 S2C2 宋体，倍宽字，10CPI，8LPI25 S2c3 宋体，倍宽字，15CPI，10LPI26 S2C3 宋体，倍宽字，10CPI，10LPI27 S2c4 宋体，倍宽字，15CPI，12LPI28 S2C4 宋体，倍宽字，10CPI，12LPI29 S2c5 宋体，倍宽字，15CPI，4LPI30 S2C5 宋体，倍宽字，10CPI，4LPI31 S1c1 宋体，倍宽倍高字，15CPI，6LPI32 S1C1 宋体，倍宽倍高字，10CPI，6LPI33 S1c2 宋体，倍宽倍高字，15CPI，8LPI34 S1C2 宋体，倍宽倍高字，10CPI，8LPI35 S1c3 宋体，倍宽倍高字，15CPI，10LPI36 S1C3 宋体，倍宽倍高字，10CPI，10LPI37 S1c4 宋体，倍宽倍高字，15CPI，12LPI38 S1C4 宋体，倍宽倍高字，10CPI，12LPI39 S1c5 宋体，倍宽倍高字，15CPI，4LPI40 S1C5 宋体，倍宽倍高字，10CPI，4LPI