民生银行BＳT数据通信服务器程序设计说明书
一． | 设计概要 |
该服务器程序主要完成的功能为：
主要作为数据通信数据转发系统;在UNIX平台上开启一个TCＰ/ＩＰ协议的服务器端程序，通过ＳOＣKＥＴ接口接收到BＳT的WＥBSERＶER转发的BSＴ交易请求包时有子进程完成与主机的通信；子进程将请求包按照民生银行提供的MAPFＩLE(交易数据格式）进行数据重组,形成主机请求包,并与银行通信服务器(ＥLIＮK）建立sockeｔ连接，发送请求包，并接收主机响应包。最后将响应包按照ＭＡPＦＩＬE输出格式解包并发送给ＷEBSEＲVEＲ.
另外要完成申请终端工作密钥，交易时与银行加密机进行密钥交换的工作。具体说明在后面章节说明。
二． | 目录说明 |
$HOME/inclｕdｅ／所有的头文件，包括银行接口的.
$ＨOME/ｌib／ ＄HＯME/bin/ | 所有的库文件。 运行目录.运行文件名为‘servｅr’，运行。／r 为后台运行。 |
＄HＯME/eｔc/mａpｆilｅ银行数据接口定义文件。
＄HOME／eｔc／sysｃfｇ所有的配置文件。
ﻬ三详细程序设计及流程说明
3。１主程序模块框图
启动应用
初始化应用 1．读配置表BstServ.cfg 2．初始化MAP结构
申请初始工作密钥 3．初始化包头配置结构
主进程
有连接申请？
子进程
接收CLIENT数据
是RQK 交易？ | Y | 从加密机申请密钥 |
N
调用DoWithHost与主机
通信
返回响应数据包
关闭SOCKET
释放MAP结构
退出子进程
说明:
（１）配置表BsｔServ。cfg中定义了与WEBSEＲVＥR的SOCKＥT连接的PＯRＴ,与ELＩNK连接的IＰ地址和POＲT端口。
（２）初始化MAＰ结构是将银行的主机接口数据格式定义文件(ＭAPFILＥ文件）全部用动态链表实现,以便提高访问速度。有关说明在后面章节。
（3)初始化包头配置结构,是将MAPFIＬE定义的报文头的配置表载入到全局变量Sys_Head中，也为了提高访问速度。具体配置见后面章节.
（4)将子进程中的ＭAP结构链表释放，防止占用内存.
ﻬ
3.2主机通信模块框图（DｏWithHosｔ(）函数)
功能:打主机包—>发送—>接收－〉解包—〉组返回响应包
开始 | 初始化POOL 结构 | PackHostData() |
查找链表中相应交易结点
与ELINK建立连接
按Sys_Head组交易包头
调用PackHostData()组包 | 有PAPSWD？ | Y | 与加密机交换 |
PINBLOCK |
N
按输入MAP组交易数据发送主机数据包
将POOL转换为主机报文
释放POOL结构，返回
接收主机数据包
初始化POOL 结构 | PackResponseData() |
调用PackResponseData解包
将主机响应包转为POOL
关闭SOCKET（与ELINK） | 打印POOL 到屏幕 | Y | 根据POOL 组返回拒 |
返回数据包长度 | 主机拒绝包？ | 绝包 | |
N |
根据输出MAP组返回数据包
FORM 单元？ | Y | 调用UnpackForm() |
解释FORM 单元 |
N
释放POOL结构
返回下传数据包长度
３。３MＡPFILE动态链表结构
MAＰFＩＬＥ链表的结构定义在ｌｔaｂlｅ．ｈ中，如下:
#dｅfineＴMAPｓtｒuｃtT_Map
＃defｉneＴＩNＤEＸstruｃtＴ＿Index
stｒuｃtT_Ｍaｐ｛
ｃｈaｒTnａme［16];
ﻩint Ｔｌen；
ﻩcharTtｙpe[1；］
strucｔＴ_Ｍａp＊nexｔ;
}Ｔ_Map；
stｒuｃｔＴ＿Index｛
ﻩcharTcode［５；］
ｃhaｒinｑｎaｍｅ[16］；
ﻩｃｈarreqname［１6;]
charendaddｒ［10];
ﻩｓtrｕctT_Map ＊inq；
sｔructＴ_Mａp＊ｒeｑ;
ﻩstｒuｃtT_Indeｘ*next;
｝T_Iｎdex；
每个交易对应一个T_Index结点,节点的Ｔcｏdｅ为交易码；每个交易的结点中存放的信息有：交易码、输入ＭAP文件名、输出MＡＰ文件名、交易目的地址、输入MAP链表的头指针和输出ＭAP链表的头指针。
输入、输出MＡP链表中分别储存了相应MAPＦIＬＥ的前三个字段,以便打包、解包时使用.
目前数据长度（inｔＴlen)与数据类型（cｈarTtype［1］）暂时没有用到，保留以后使用。即，交易输入、输出时的交易数据（除交易包头外）的长度是变长的。
3。4加密、验密方式的说明
在服务器程序启动时,先向主机申请工作密钥，即发送936７交易;返回的PinKｅy保存在SＥRＶＥR端。
BST启动应用时先向SERVER发送ＲＱK1交易包申请终端使用密钥；SERVEＲ接收到RQK1交易时调用T_gｔ_worｋing_ｋey()函数向加密机申请，并将其返回给BSＴ。
BST做交易时,要将密钥(ＷorkiｎgＫey）和PinBｌoｃｋ上送至SERVＥR，SERVER要调用T_tr_ｐin_ａnsi_aｎsi（）函数与加密机交换PinBｌock，然后放在PAPＳWD字段上送。
更改密码交易的旧密码字段也同样要加密，密钥同上。
注意：如果PSPWＫD=１或者2时，SＥRVER会对PＡPＳWD和ＰAOLWＤ进行ＰINBLＯCＫ的交换；如果PSPWKD＝0或者没有该DDU字段时，认为不做PINBLOＣK交换，SEＲVER会将BST上送来的密码字段原样送主机。
三． | 与WEBSEＲＶER 通信数据包格式说明 |
４．1ＢＳT上送包格式
设备号 | 交易码 | 密钥 | 保留字段 | 交易包头部分 | 交易数据部分 |
5bｙｔe | ４byte | １6byｔe | 25 个字符零 | 用｜分隔，数据域定长 | 用|分隔,数据域变长 |
前5０个字节为与WＥBＳEＲVＥR的约定报文头。
其中，交易包头部分的定义在./sysｃfg／下，由三个配置文件定义：
ｓysｔem_ｈead．ｃfg
cｍｔran_heａd.cfg
ｔran_ｈead.cｆg具体内容请看配置文件。
该部分中的数据域的顺序和据域的长度必须完全符合上述三个文件的定义，不能少送所有的域.对ＢＳＴ设备端不知道的数据（如交易目的地址）,用同样长度的空格代替,其值由SER
ＶER自己处理（为方便对交易包头的处理，将这三个文件组合成Head_Vaｌue.cfg，具体说
明见后面章节）。
交易数据部分的定义为相应的MＡPFIＬＥ，如15１0交易的输入ＭＡＰFILE为(O１５１0０）. 该部分数据域的的顺序必须符合该MＡPFIＬE的定义，长度可以是变长,用‘｜’进行分隔即可。无数据域不添值，但要用‘｜’分隔的空域。
注意：加密后的PINBLＯCK(密码和新密码均是)为十六位，存放在相应的数据域中。
申请密钥交易数据包:
设备号 | 交易码 | 密钥 |
5byte | RＱK1 或ｒqk１ | 字符０ 16+25byｔe |
4.2返回数据包格式
SＥRVER对主机返回的数据包先转为POOL结构，再从该结构中按输出ＭAPFＩLE(如O151０1)的定义将数据用‘｜’分隔组成字符串下传。
４.2．1下传交易错误包
设备号 | 交易码 | 错误码 | 具体错误码 | 保留字段 |
5ｂytｅ | 4byte | 3０00 | 如30０1 | ２3 bytea |
下送包的约定报文头为40BYTE。
错误码为３000,与主机通信中有错误；文档最后有待扩充错误码表.
注意:如果上送的数据包小于50BYTE,对上送不进行解释,返回的设备号和交易码均返回为零，返回包如下：
B０31０５aaaaａaａaaaａaａaaaａａaaaaａ
4。2。2下传RQＫ失败错误包
设备号 | 交易码 | 错误码 | 保留字段 |
５ＢYＴE | ４ＢYＴE | 2０00 | 27 ｂyｔe‘0' |
4。２.3下传RＱＫ正确包
设备号 | 交易码 | 错误码 | 保留字段 | Wｏrkinｇ—ｋeｙ |
5BＹTE | 4BYＴE | 0000 | 2７ｂｙｔe ‘０' | ｜｜ |
Workiｎg—keｙ为16位。
４。2。4下传主机拒绝包
设备号 | 交易码 | 错误码 | 保留字段 | ｜ERRＮＯ| | ERRIＤ｜ | EＲ |
5BYTE | 4BYTE | 1000 | 2７byte 0 | 主机错误码 | 主机错误IＤ | 主机错误描述 |
后三个字段由.／ｓyscfｇ/ERR00０文件定义,为主机返回的错误信息。SERVER用‘|’分隔变长数据。
4。2.5下传主机正确数据包
设备号 | 交易码 | 错误码 | 保留字段 | 输出MAＰ域 | 输出ＭAP 域 |
５bytｅ | ４bｙｔe | 0０00 | ２７byｔe 0 | 用|分隔，数据域变长 | 当前记录数|记录字段数｜记录……| |
ＦＯRＭ域的格式为:
ＦOＲM 文件名 | 当前笔数 | 记录字段数 | 所有记录数据 |
F1583| | ０01２| | 0０14| | 记录1｜记录2|…｜(字段间也有竖线) |
说明：
PACＯＵＴ是该交易的总笔数，FORM域内的为当前笔数;
FORM域的栏位数不下传,此处下传的是每条记录的字段数.
如果ＦOＲM域的后面有DDU数据，那么将DDU数据解在FＯRM前面。FORM数据总是放在DＤU数据之后.
1４０９补登交易的FORM数据中有打印控制字符，起始打印行数和打印控制字符（列数＋字体．..）,均为一个字节的十六进制值。所以总字节数为(1+1）＊字段数。在程序中，列数和字体号均不下传,只有起始打印行数下传，所以140９交易的下传包为：
FＯRM | 当前笔数 | 记录字段数 | 打印起始行 | 所有记录数据 |
名 | | | | |
F１583｜ | ０012| | 0０14| | 0010| | 记录1｜记录2|…｜(字段间也有竖线） |
4.2．6下传FORＭ无明细数据包
设备号 | 交易码 | 错误码 | 保留字段 | DDＵ数据 |
5BYTＥ | ４BＹＴE | ４00０ | ２７ bytｅ ‘0’ | 用｜分隔,数据域变长 |
四． | 相关配置文件说明 |
为了方便,配置文件也放在“。/sysｃfg/”目录下.
5。1ＢstServ.cｆg
该文件中配置了SEＲVER的初始化参数:
SＥRＶPORT=20０1定义与WEBSEＲVER的SOCKEＴ的端口 HOSＴIP= 197。0。３．2１定义ＥLINK(主机接口）的IP地址
HOSＴPORT= ６999 定义了ＥLIＮK的端口
［ＧEＴ＿ＫEY]
PAＴＥＬＲ=069６00０1不同分行的机构号的设置；申请主密钥时使用。
PAＰＳWD＝888888８８机构密码
［ＦORM_NO]
F1583= 1０ 定义了相应的FORM对象MAＰ文件中的字段数5.2heａd_vaｌuｅ．ｃfg
该文件定义了交易包头数据部分的字段及其赋值类型，
sｙsSADDRﻩ4ﻩ0＃源地址,
sysＤＡDDＲﻩ４ﻩCﻩ＃目的地址，c表示由交易码查询确定
ｓysRSRVDﻩ1ﻩ0#系统保留位
ｓysEFＬAGﻩ1ﻩ０ﻩ＃信息结束标志，默认为１
ｓｙｓSEＱNUMﻩ2ﻩ0ﻩ＃报文序号，暂不使用,默认值为0
sysMACFLAGﻩﻩ1ﻩ0 ＃校验标志,是否需MＡC校验或其他校验sysMACVＡLUEﻩ８ﻩ0ﻩ＃校验值
PDWSNO ﻩ5ﻩＲﻩ＃交易发起终端号.r表示由BST的数据中获得
PDCTNO ﻩＰDSBNＯ | ４N | ＃城市代码。n 表示添空格 | |||
４ﻩRﻩ＃银行机构代码 | |||||
４ | 0 | ＃交易序号 | |||
2 | 0ﻩ＃系统偏移1 | ＃PDTＲLＮ 2ﻩ | |||
2 | 0 | #系统偏移2 | |||
PDAＵUS | 8 | 0ﻩ#授权柜员 |
PDAUPS 8ﻩ0ﻩ#授权密码
说明：第一列为交易包头部分应有的字段，不能少;
第二列为该字段的长度,上送的字段长度必须与该定义一致;
第三列为字段赋值类型：
0 :由ＳＥRＶＥR端为该字段赋值为０x0０的串；
N :由ＳＥRVＥＲ端为该字段赋值为空格字符串;
R ：SEＲVER端从上送请求包中相应的域中取值;
C ：SＥＲVER端根据tｉｎdex。cｆg中每个交易的目的地址字段的定义来填写目的地址。
该表可以使解释上送请求包的数据时更加灵活。
‘#’后面是注释
５。３tｉndｅx。cfｇ
该文件是创建交易MAP链表结构的配置文件，它定义了四个字段：
交易码,交易输入MAＰFILＥ文件名，交易输出MAPFＩLE文件名，该交易上送主机的目的地址。例如:
＃交易码输入MAＰ输出MAＰ目的地址
158３ Ｏ１583０O1583１ﻩ00０0０0００
1４01ﻩＯ1４0１0ﻩO１4011ﻩ00000000
1482ﻩO１4８２１ﻩＯ148２2 000０0000
1483 O１4831Ｏ１483２000０0０0０
1485 Ｏ１４8５1 Ｏ14852０000000０
目的地址为字符串表示的四字节的十六进制值.程序会将其转为十六进制。
5.４关于ＦTP相关文件的配置
目前FTP下传文件是由ＥLIＮK方向BＳTSERVEＲ传送,使用的用户为:
USER:sｏt:cmｂcsot
Path：/ｕsr／ｓｏt
在bsｔsrｖ用户下有后台程序定时将下传的文件导入数据库的ｓｈell程序。内容如下：文件:bｓtsｒvcrｏn
#ｔhisjobis load iｎｆｏ dａtaｂａse.
10３*＊＊/uｓｒ/bsｔsrv/data/infｏ．sh
文件：infｏ．ｓｈ
＃！/bin/sh
INＦＯＲMＩXDIR＝/usｒ/informix
INFORMIXSERＶＥＲ=dbsｅrver
eｘｐoｒtINFORMIXDIR INFOＲMＩXSERVＥR
PAＴH＝$INFOＲMIＸDIR／bin
exｐorｔPATＨ
／ｕsr／bsｔsrv/ｄata/ｉnfo。sｑl
文件：info。sqｌ
isql<<--！
ﻩdatabaｓｅbst＿ｄａtabase；
deletefromgｄrkａ；
loadｆrom"／usr/sｏt"insert iｎtogｄrka;
ｄeｌeｔefrｏmgdrtａ；
loadｆrｏm"／usr/ｓoｔ"inserｔintｏｇdｒta;
ﻩdｅlｅtefｒomgdsbａ;
loadｆrｏm"/uｓr／ｓoｔ＂iｎserｔintogdｓbａ;
ﻩdeleｔefｒomｇｄxra；
loａdfrom "/ｕsr/soｔ”iｎｓeｒtｉntoｇdｘrａ；
!
五． TRACE文件说明
1．Traｃe文件在‘./Tｒace／'目录下。Traｃｅ文件按设备号区分,每个设备对应自己的Ｔrace文件。如，设备B0０01的Trace文件名为：B000１。LOG。字母’Ｂ’表示不同设备类型；Trace文件中记录了通信数据,包括:
WEBSERVEＲ上送的请求包，用‘BST–> SＥＲVEＲ’表示。
ＳERＶＥR发送给主机的数据包,用‘SERＶＥR–＞HＯSＴ’表示。
主机返回的数据包,用‘HOＳＴ–〉SＥRＶER’表示。
ＳERVＥR返回给ＷＥBSEＲＶER的数据包,用‘SERVＥR–〉ＢST'表示。
Trace数据有两种形式：ＡSＣIＩ形式和十六进制。
BstSｅrｖ。LＯG为服务程序初始化的LOG文件，记录所载入的参数.B9９9９。LOG 为服务程序向主机申请密钥的LＯG文件。
Ｌog 为后台运行程序时屏幕输出的重定向文件。
2.Ｔｒace文件的备份放在/usr／ｗeｂｓrv／log/目录下，以当天日期为目录，每次备份会自动替换上月同日期的目录。即备份只有一个月以内的。Wｅbsｒv用户下有后台进程每天自动进行TRＡCE的备份与删除工作。
Wｅbsrvcron：
0０２＊ ＊*／ｕsr/ｗebsrｖ/bin／backlog．sh〉aa。ｌog
backlｏg.sｈ:
＃backlog copyrightｂyJiａngHuaｍing
#ＴhisｓhellｃａnｂacｋupTｒaceｄireｔoryｆoｒＢSTCOMM-SERＶER,whichorderｂydate of mｏnth.
＃2001/09／16
＃querysｙstｅmdatｅ
datｅ+％d>a。log
readＤate〈a．log
＃defiｎevarｉablｅ
LogPａth=/loｇ/
TrａceName=Tｒａｃe
BackＮame＝＄HOME＄{LｏgＰath}${TｒaceName}＄｛Ｄａte}
＃deｌeteolｄｂａｃｋup ＄HＯME
ｌs$ＨOＭE＄｛LogＰａtｈ｝＞ａ．ｌog
ｉfｇｒｅp＄｛ＴraceName}${Date}a.log 〉b．ｌog2〉＆1
theｎ
ｒm-r＄{BackNaｍｅ}
fi
cp-r ${TracｅNamｅ}＄｛BackNamｅ}
rma.log
rmb．ｌｏg
#ｃrｅatenewTｒaｃｅdiｒeｃtｏryａnｄlｏg $｛TracｅNaｍe}
rm＊．ＬOG
cp／dｅv/nｕll./log
六． | 可能扩充的错误码表 |
３001：连接ELINＫ失败
300２: 向主机发送失败
3003:读超时/失败
３10０：没有该交易的定义
3１０1: ｈｅａd＿value．cｆg配置有错误
３102:上送数据少于ＭAP定义
3１０３：交换PIＮBLOCＫ失败
３104：上送包数据转换错误(PacｋEucpSendＳｔr)
3105：请求包长度错误
310６： PAPWＫＤ密码校验方式不正确，该值必须是０,1，2其中之一.
311０: 主机响应包转换错误（ＵnpａｃkEｕcpReｃvStr）
3111：解释FOＲM数据出错
３1１2：接收FORM数据错误
311３:FORM数据超出8K字节
七． | 新加银证通交易接口 |
证通交易使用与长天不同的通信接口及通信数据报文。所以需要定义新的与WＥＢSERVEＲ的交易接口，但尽量保持原有风格。
7.1BST上送银证通包格式
设备号 | 交易码 | 密钥 | 交易子码 | 保留字段 | 交易数据部分 |
5ｂyte | 4bytｅ | 16bytｅ | 8byte | １７个字符零 | 用|分隔，数据域变长 |
B000１ | YZＴT | ＊*＊…＊＊* | | 000…000 | |
7.２下传交易错误包
设备号 | 交易码 | 错误码 | 具体错误码 | 交易子码 | 保留字段 |
5ｂyte | 4byte | 3０00 | 如32００ | 8bｙte | 15bytea |
| | | | | |
下送包的约定报文头为４0ＢYＴE。
银证通交易的错误码从３２0０—3２99。
7。３下传主机拒绝包
设备号 | 交易码 | 错误码 | 交易子码 | 保留字段 | |EＲRＮO｜ | ERRＩD| | ＥRRTＥXT| |
5ＢYTE | ４BYTE | 1000 | 8byｔｅ | １９byｔe ０ | 主机错误码 | 主机错误ＩD | 主机错误描述 |
| | | | | | | |
后三个字段由。/syｓｃｆg/ERR0０0文件定义,为主机返回的错误信息。SEＲVＥR用‘｜’分隔变长数据。
７.4下传主机正确数据包
设备号 | 交易码 | 错误码 | 交易子码 | 保留字段 | 输出MAＰ域 | 输出ＭＡP 域 |
5bytｅ | 4ｂyte | 0000 | ８byｔｅ | １9bｙte0 | 用｜分隔,数据域变长 | 当前记录数|记录字段数|记录……| |
| | | | | | |
ＦＯRM域的格式为：
FORM 文件名 | 当前笔数 | 记录字段数 | 所有记录数据 |
F1583｜ | 001２| | 00１4| | 记录1｜记录2|…｜(字段间也有竖线） |
说明:
PACＯUT是该交易的总笔数,FORM域内的为当前笔数;FORM域的栏位数不下传，此处下传的是每条记录的字段数。
如果ＦORM域的后面有DDU数据,那么将DDＵ数据解在FORＭ前面。ＦORM数据总是放在DDU数据之后.
14０９补登交易的ＦORM数据中有打印控制字符，起始打印行数和打印控制字符（列数+字体.．.),均为一个字节的十六进制值。所以总字节数为（1+1)＊字段数。在程序中,列数和字体号均不下传，只有起始打印行数下传，所以１４0９交易的下传包为：
FORＭ名 | 当前笔数 | 记录字段数 | 打印起始行 | 所有记录数据 |
F1583｜ | ０012｜ | 00１4| | 0010｜ | 记录1｜记录２｜…｜（字段间也有竖线) |
7.5下传FOＲＭ无明细数据包
设备号 | 交易码 | 错误码 | 保留字段 | ＤDＵ数据 |
5BＹＴE | 4ＢYTＥ | 4000 | 27 byte ‘0’ | 用｜分隔，数据域变长 |
新加错误码:
3２01ｃanｎotcｏｎnecｔmｉｄd
32０2loｇinｆａilｅd
３204seｎdto midd ｅrroｒ
3210sockeｔｉｎdeｘerroｒ,rｅｓuｌtｔｙpe！=ｓ/m
321１上送数据少于MAP定义
八． 新加开放基金交易接口变更2002-４－16
开放基金交易接口仍然走ＥＬＩＮＫ接口，与原来的接口基本一致，只要设置不同的目的地址，增加相应的交易配置文件即可.
须变更的地方是:开放基金接口中没有了密码校验方式的字段（pwkｄ）,而原来的接口处理时要根据该标志来确定是否要与加密机进行ＰＩNBLOCK交换。所以为了与原来的接口处理相一致，必须在开放基金的接口中增加密码校验标志位.具体方式如下：
ＷEBSERVER上送的开放基金的交易报文中，包头部分中的保留字段的最后一位作为密码校验标志；‘1’表示要进行校验，须交换PＩNBＬOＣK;其他的值均默认为不做ＰＩNＢLOCK交换，送‘0’。
开放基金之外的交易仍按原来的处理，即该位仍作为保留字段送空格即可。