境內(nèi)外幣支付系統(tǒng)直聯(lián)接口API使用手冊(cè).doc

境內(nèi)外幣支付系統(tǒng)直聯(lián)接口API使用手冊(cè) 附件一：境內(nèi)外幣支付系統(tǒng)直聯(lián)接口API使用手冊(cè)境內(nèi)外幣支付系統(tǒng)直聯(lián)接口API使用手冊(cè)V1.4中國(guó)人民銀行科技司二八年四月- 1 -境內(nèi)外幣支付系統(tǒng)直聯(lián)接口API使用手冊(cè) 目錄1編寫(xiě)目的42適用對(duì)象43支持平臺(tái)及中間件44使用說(shuō)明44.1外幣業(yè)務(wù)流程說(shuō)明44.2直聯(lián)行往帳發(fā)起流程說(shuō)明54.3往賬發(fā)送處理流程圖64.4直聯(lián)行來(lái)帳接收流程說(shuō)明64.5來(lái)賬接收（普通報(bào)文）流程圖74.6來(lái)賬接收（實(shí)時(shí)報(bào)文）流程84.7限定和約束85直聯(lián)接口API函數(shù)說(shuō)明（C語(yǔ)言版本）85.1API函數(shù)清單85.2API函數(shù)說(shuō)明95.2.1發(fā)送報(bào)文函數(shù)95.2.2接收?qǐng)?bào)文函數(shù)95.2.3提交事務(wù)函數(shù)105.2.4回滾事務(wù)函數(shù)105.2.5獲得錯(cuò)誤代碼及描述函數(shù)116安裝過(guò)程136.1安裝準(zhǔn)備136.2安裝步驟136.3安裝驗(yàn)證147開(kāi)發(fā)環(huán)境說(shuō)明157.1頭文件157.2編譯方法157.3makefile文件示例167.3.1AIX平臺(tái)的makefile167.3.2SUSE Linux平臺(tái)makefile178運(yùn)行環(huán)境說(shuō)明198.1目錄結(jié)構(gòu)198.2配置文件218.3環(huán)境變量218.4AIX平臺(tái)動(dòng)態(tài)庫(kù)文件228.4.1庫(kù)文件清單228.4.2操作步驟228.5SUSE Linux平臺(tái)228.5.1庫(kù)文件清單228.5.2操作步驟228.6簽名串文件*.dat生成過(guò)程23版本修改記錄：版本號(hào)完成日期簡(jiǎn)單描述1.02007-12-25C正式發(fā)布版。1.12008-1-9無(wú)修改。1.22008-1-29M6.3節(jié)安裝驗(yàn)證內(nèi)容更新。M8.1節(jié)目錄結(jié)構(gòu)內(nèi)容更新。A增加8.6節(jié)簽名串文件生成過(guò)程。1.32008-3-31M5.2.5獲取錯(cuò)誤代碼及描述函數(shù)的表格中增加錯(cuò)誤碼及描述：0243優(yōu)先級(jí)子塊錯(cuò)誤 和0242打開(kāi)PKIBANK文件錯(cuò)誤1.42008-4-18未修改說(shuō)明：C-創(chuàng)建；M-修改；A-增加；D-刪除；1 編寫(xiě)目的本文檔是境內(nèi)外幣支付系統(tǒng)與結(jié)算銀行賬戶處理系統(tǒng)接口規(guī)范和境內(nèi)外幣支付系統(tǒng)與商業(yè)銀行行內(nèi)系統(tǒng)接口規(guī)范的附件，主要描述了直聯(lián)接口API的使用方法。目的是指導(dǎo)結(jié)算銀行和商業(yè)銀行的開(kāi)發(fā)人員依據(jù)此手冊(cè)完成接入境內(nèi)外幣支付系統(tǒng)行內(nèi)部分的系統(tǒng)改造工作。本接口規(guī)范的期望讀者包括：結(jié)算銀行和商業(yè)銀行的技術(shù)開(kāi)發(fā)人員及其他相關(guān)人員。2 適用對(duì)象本接口API只適用于所有Q-Q直聯(lián)方式接入境內(nèi)外幣支付系統(tǒng)的直接（特許）參與者使用。3 支持平臺(tái)及中間件目前直聯(lián)接口API支持操作系統(tǒng)平臺(tái)為：1、64或32 bit AIX5.3。2、32 bit SUSE Linux9.0支持的中間件產(chǎn)品為：1、 MQ6.02、 TongLink/Q6.3說(shuō)明：AIX平臺(tái)的接口API 連接32 bit 中間件MQ庫(kù)。4 使用說(shuō)明為了方便Q-Q直聯(lián)方式接入的直接（特許）參與者發(fā)起和接收外幣支付系統(tǒng)業(yè)務(wù)報(bào)文，并為了提高系統(tǒng)安全性，特提供直聯(lián)接口API函數(shù)完成報(bào)文的發(fā)送和接收功能。該API完成了對(duì)操作消息中間件的封裝，并對(duì)報(bào)文進(jìn)行了初步的合法性檢查，且增加了報(bào)文的身份驗(yàn)證碼，由境內(nèi)外幣支付系統(tǒng)業(yè)務(wù)處理中心（FXCC）驗(yàn)證身份碼的合法性，對(duì)非通過(guò)接口API發(fā)送的往帳報(bào)文予以拒絕。直聯(lián)行通過(guò)消息中間件接入外幣支付系統(tǒng)的FXCC，直聯(lián)行通過(guò)調(diào)用API發(fā)起和接收外幣業(yè)務(wù)報(bào)文。4.1 外幣業(yè)務(wù)流程說(shuō)明假如直聯(lián)行A向直聯(lián)行B發(fā)起一筆境內(nèi)跨行貸記業(yè)務(wù)（FMT100）報(bào)文。如下圖所示：1、 A行發(fā)起：A行組織好業(yè)務(wù)報(bào)文，先調(diào)用加簽名函數(shù)生成簽名串附加在報(bào)文中的第六塊，再調(diào)用接口API發(fā)送報(bào)文函數(shù)對(duì)報(bào)文進(jìn)行合法性檢查、加身份驗(yàn)證碼并放入發(fā)送隊(duì)列，更加詳細(xì)的報(bào)文格式請(qǐng)參照境內(nèi)外幣支付系統(tǒng)報(bào)文格式標(biāo)準(zhǔn)。2、 FXCC驗(yàn)證：FXCC從隊(duì)列中得到A行發(fā)起的報(bào)文FMT100，進(jìn)行身份驗(yàn)證（校驗(yàn)第7塊：身份驗(yàn)證碼），驗(yàn)證失敗，直接丟棄報(bào)文，驗(yàn)證通過(guò)進(jìn)行后續(xù)業(yè)務(wù)處理并轉(zhuǎn)發(fā)該報(bào)文到報(bào)文接收行B行的接收隊(duì)列。3、 B行接收：B行調(diào)用API接收函數(shù)，從接收隊(duì)列得到報(bào)文串，并進(jìn)行身份驗(yàn)證（校驗(yàn)第7塊：身份驗(yàn)證碼），并返回行內(nèi)系統(tǒng)應(yīng)用驗(yàn)證結(jié)果，驗(yàn)證失敗則丟棄報(bào)文，驗(yàn)證成功的繼續(xù)調(diào)用核簽函數(shù)進(jìn)行核簽，根據(jù)核簽結(jié)果做后續(xù)處理。說(shuō)明：圖中黃色標(biāo)識(shí)模塊為接口API需要完成的工作。4.2 直聯(lián)行往帳發(fā)起流程說(shuō)明1、 發(fā)起方（發(fā)起行行內(nèi)系統(tǒng)）根據(jù)要求組織相應(yīng)報(bào)文串并加數(shù)字簽名后得到待發(fā)送的報(bào)文串（報(bào)文串包括：1:基本頭2:應(yīng)用頭3:用戶頭4:正文5:附加正文6:簽名）。2、 發(fā)起方調(diào)用API：發(fā)送報(bào)文函數(shù) CFXPS_SENDMSG(const char *pSendMsg);完成將待發(fā)送的報(bào)文進(jìn)行合法性檢查、加身份驗(yàn)證碼（添加身份驗(yàn)證碼后的報(bào)文串包括：1:基本頭2:應(yīng)用頭3:用戶頭4:正文5:附加正文6:簽名7:身份驗(yàn)證串）和放入發(fā)送隊(duì)列，根據(jù)返回碼做相應(yīng)處理：發(fā)送報(bào)文失敗轉(zhuǎn)4，并調(diào)用5獲取錯(cuò)誤碼，成功則轉(zhuǎn)3繼續(xù)處理。3、 發(fā)起方調(diào)用API：提交事務(wù)函數(shù) int CFXPS_COMMIT()提交交易；4、 發(fā)起方調(diào)用API：回滾事務(wù)函數(shù) int CFXPS_ROLLBACK()回滾交易。5、 發(fā)送方調(diào)用API：獲取錯(cuò)誤碼及錯(cuò)誤描述 char* STDCALL CFXPS_GETERRDESC();如果發(fā)送方在發(fā)送報(bào)文返回值不等于0（即發(fā)送失?。{(diào)用該函數(shù)獲取錯(cuò)誤碼及錯(cuò)誤描述，以便分析失敗的原因。4.3 往賬發(fā)送處理流程圖4.4 直聯(lián)行來(lái)帳接收流程說(shuō)明1、 接收方（接收行行內(nèi)系統(tǒng)）需要接收實(shí)時(shí)來(lái)帳報(bào)文時(shí)調(diào)用API：接收?qǐng)?bào)文函數(shù) long CFXPS_RECVMSG(int nMsgType, char *ppRecvMsg)從中間件順序取得一筆待接收的實(shí)時(shí)來(lái)賬報(bào)文（入?yún)MsgType=0時(shí)表示接收實(shí)時(shí)來(lái)賬），取報(bào)文成功并對(duì)報(bào)文進(jìn)行合法性檢查和身份驗(yàn)證通過(guò)，則返回接收?qǐng)?bào)文實(shí)際長(zhǎng)度（返回值）和接收?qǐng)?bào)文串的地址（ppRecvMsg）（返回報(bào)文結(jié)構(gòu)為1:基本頭2:應(yīng)用頭3:用戶頭4:正文5:附加正文6:簽名）并轉(zhuǎn)4，否則繼續(xù)。2、 接收方（接收行行內(nèi)系統(tǒng)）需要接收普通來(lái)帳報(bào)文時(shí)調(diào)用API：接收?qǐng)?bào)文函數(shù) long CFXPS_RECVMSG(int nMsgType, char *ppRecvMsg)從中間件順序取得一筆待接收的普通來(lái)賬報(bào)文（入?yún)MsgType=1時(shí)表示接收普通來(lái)賬），取報(bào)文成功并對(duì)報(bào)文進(jìn)行合法性檢查和身份驗(yàn)證通過(guò)，則返回接收?qǐng)?bào)文實(shí)際長(zhǎng)度和接收?qǐng)?bào)文串（ppRecvMsg）（1:基本頭2:應(yīng)用頭3:用戶頭4:正文5:附加正文6:簽名）并轉(zhuǎn)4，否則繼續(xù)。3、 如果接收?qǐng)?bào)文失?。ǚ祷刂敌∮?），則轉(zhuǎn)5，并調(diào)用6獲取錯(cuò)誤碼，依據(jù)錯(cuò)誤碼描述分析原因。再次調(diào)用API：接收?qǐng)?bào)文函數(shù) CFXPS_RECVMSG(int nMsgType, char *ppRecvMsg)從中間件重新取得該報(bào)文，成功則轉(zhuǎn)3繼續(xù)。4、 接收方調(diào)用API：提交事務(wù)函數(shù) int CFXPS_COMMIT()提交交易；5、 接收方調(diào)用API：回滾事務(wù)函數(shù) int CFXPS_ROLLBACK ()回滾交易。6、 接收方調(diào)用API：獲取錯(cuò)誤碼 char* CFXPS_GETERRDESC();如果接收方在接收?qǐng)?bào)文時(shí)返回值不等0，調(diào)用該函數(shù)獲取錯(cuò)誤碼詳細(xì)說(shuō)明，以便檢查失敗的原因。4.5 來(lái)賬接收（普通報(bào)文）流程圖4.6 來(lái)賬接收（實(shí)時(shí)報(bào)文）流程4.7 限定和約束1、 本API已經(jīng)封裝了中間件產(chǎn)品MQ和TLQ的操作函數(shù)，無(wú)需商業(yè)銀行直接操作MQ和TLQ。2、 發(fā)送或接收API報(bào)文大小有條件約束，報(bào)文的大小最大不能超過(guò)50M。對(duì)1M以下的報(bào)文系統(tǒng)直接處理，對(duì)于1M以上，50M以下的報(bào)文，采用了MQ/TLQ的系統(tǒng)分片功能自動(dòng)分片，默認(rèn)配置的分片大小為1M?？梢哉{(diào)用API直接進(jìn)行發(fā)送，由MQ/TLQ系統(tǒng)自身判斷超長(zhǎng)并自動(dòng)分片；接收方可以直接調(diào)用API進(jìn)行大報(bào)文的接收，API會(huì)返回拼裝好的大報(bào)文給行內(nèi)系統(tǒng)應(yīng)用。接收API函數(shù)內(nèi)部申請(qǐng)存儲(chǔ)區(qū)獲取到報(bào)文后，將存儲(chǔ)區(qū)的地址（char *ppRecvMsg）返回給商業(yè)銀行，商業(yè)銀行應(yīng)用可以直接讀取該存儲(chǔ)區(qū)的報(bào)文信息，但注意不能破壞此存儲(chǔ)區(qū)內(nèi)容。3、 目前支持的API為C語(yǔ)言編寫(xiě)的靜態(tài)庫(kù)(AIX)/和動(dòng)態(tài)庫(kù)(SUSE LINUX)。4、 本API支持多進(jìn)程調(diào)用，暫不支持多線程調(diào)用。5 直聯(lián)接口API函數(shù)說(shuō)明（C語(yǔ)言版本）5.1 API函數(shù)清單類別函數(shù)名稱業(yè)務(wù)功能觸發(fā)方式備注FXAPICFXPS_SENDMSG此函數(shù)完成商業(yè)銀行向FXCC發(fā)送往賬報(bào)文。直聯(lián)行調(diào)用CFXPS_RECVMSG此函數(shù)完成商業(yè)銀行從FXCC接收來(lái)賬報(bào)文。直聯(lián)行調(diào)用CFXPS_COMMIT此函數(shù)完成發(fā)送報(bào)文函數(shù)和接收?qǐng)?bào)文函數(shù)的提交。直聯(lián)行調(diào)用CFXPS_ROLLBACK此函數(shù)完成發(fā)送報(bào)文函數(shù)和接收?qǐng)?bào)文函數(shù)的回滾。直聯(lián)行調(diào)用CFXPS_GETERRDESC此函數(shù)獲取發(fā)送和接收?qǐng)?bào)文錯(cuò)誤碼及原因。直聯(lián)行調(diào)用說(shuō)明：5.2 API函數(shù)說(shuō)明5.2.1 發(fā)送報(bào)文函數(shù)【函數(shù)原型】 int CFXPS_SENDMSG(const char *pSendMsg);【函數(shù)功能】此函數(shù)完成商業(yè)銀行向FXCC發(fā)送往賬報(bào)文?！竞瘮?shù)參數(shù)】參數(shù)1：pSendMsg （輸入）-待發(fā)送的報(bào)文串?！痉祷刂嫡f(shuō)明】返回代碼描述0發(fā)送成功-1初始化API環(huán)境失敗-2創(chuàng)建日志文件失敗-3獲取報(bào)文輸入輸出標(biāo)識(shí)失敗-4報(bào)文合法性檢查失敗-5加編身份認(rèn)證碼失敗-6獲取報(bào)文的ID失敗-7寫(xiě)隊(duì)列操作失敗-8發(fā)送報(bào)文異常【返回碼表】 無(wú)，詳細(xì)錯(cuò)誤碼和錯(cuò)誤描述請(qǐng)立即調(diào)用CFXPS_GETERRDESC()函數(shù)獲取?！菊{(diào)用說(shuō)明】商業(yè)銀行應(yīng)用需要發(fā)送往帳報(bào)文時(shí)使用，對(duì)需要加數(shù)字簽名的報(bào)文應(yīng)該加好數(shù)字簽名后才調(diào)用此函數(shù)進(jìn)行發(fā)送。5.2.2 接收?qǐng)?bào)文函數(shù)【函數(shù)原型】long CFXPS_RECVMSG(int nMsgType, char *ppRecvMsg);【函數(shù)功能】此函數(shù)完成商業(yè)銀行從FXCC接收來(lái)賬報(bào)文?！竞瘮?shù)參數(shù)】： 參數(shù)1：nMsgType（輸入）- 0-實(shí)時(shí)報(bào)文，1-普通報(bào)文。參數(shù)2：ppRecvMsg（輸出）-輸出報(bào)文存放的存儲(chǔ)區(qū)的地址，定義為指針的指針?！痉祷刂嫡f(shuō)明】返回代碼描述0接收成功,返回接收到的報(bào)文長(zhǎng)度0無(wú)待接收?qǐng)?bào)文-1初始化API環(huán)境失敗-2創(chuàng)建日志文件失敗-3讀隊(duì)列操作失敗-4接收異?！痉祷卮a表】無(wú)，詳細(xì)錯(cuò)誤碼和錯(cuò)誤描述請(qǐng)立即調(diào)用CFXPS_GETERRDESC()函數(shù)獲取?！菊{(diào)用說(shuō)明】1、 商業(yè)銀行需要接收實(shí)時(shí)和普通來(lái)賬報(bào)文時(shí)使用該函數(shù)。2、 對(duì)實(shí)時(shí)報(bào)文和普通報(bào)文要分別調(diào)用此函數(shù)獲得。3、 此函數(shù)內(nèi)部申請(qǐng)存儲(chǔ)區(qū)并將獲取到的報(bào)文存入此存儲(chǔ)區(qū)，并將存儲(chǔ)區(qū)的地址（char *ppRecvMsg）返回給商業(yè)銀行，商業(yè)銀行應(yīng)用程序可以直接讀取該存儲(chǔ)區(qū)的報(bào)文信息，但注意不能破壞此存儲(chǔ)區(qū)內(nèi)容。5.2.3 提交事務(wù)函數(shù)【函數(shù)原型】int CFXPS_COMMIT();【函數(shù)功能】此函數(shù)完成發(fā)送報(bào)文函數(shù)和接收?qǐng)?bào)文函數(shù)的提交?！竞瘮?shù)參數(shù)】參數(shù)：無(wú)【返回值說(shuō)明】返回代碼描述0事務(wù)提交成功-1事務(wù)提交失敗【返回碼表】無(wú)【調(diào)用說(shuō)明】正常情況下應(yīng)返回成功，如果返回失敗，則是隊(duì)列管理器出現(xiàn)異常，請(qǐng)檢查MQ6.0/TLQ6.3運(yùn)行情況。5.2.4 回滾事務(wù)函數(shù)【函數(shù)原型】int CFXPS_ROLLBACK();【函數(shù)功能】此函數(shù)完成發(fā)送報(bào)文函數(shù)和接收?qǐng)?bào)文函數(shù)的提交?！竞瘮?shù)參數(shù)】 無(wú)【返回值說(shuō)明】返回代碼描述0事務(wù)回滾成功-1事務(wù)回滾失敗【返回碼表】無(wú)【調(diào)用說(shuō)明】正常情況下應(yīng)返回成功，如果返回失敗，則是隊(duì)列管理器出現(xiàn)異常，請(qǐng)檢查MQ6.0/TLQ運(yùn)行情況。5.2.5 獲得錯(cuò)誤代碼及描述函數(shù)【函數(shù)原型】char* CFXPS_GETERRDESC();【函數(shù)功能】此函數(shù)完成發(fā)送報(bào)文函數(shù)和接收?qǐng)?bào)文函數(shù)的返回值小于0時(shí)，調(diào)用該函數(shù)獲取錯(cuò)誤代碼及描述，根據(jù)錯(cuò)誤碼及描述分析原因。【函數(shù)參數(shù)】 無(wú)【返回值說(shuō)明】返回字符串的指針。【返回碼表】錯(cuò)誤代碼錯(cuò)誤描述0000成功0999失敗0101讀系統(tǒng)配置文件錯(cuò)誤0102參數(shù)隊(duì)列管理器名錯(cuò)誤0103參數(shù)隊(duì)列名錯(cuò)誤0104參數(shù)日志路徑名錯(cuò)誤0105參數(shù)日志級(jí)別錯(cuò)誤0106加載TAG文件錯(cuò)誤0107加載ITEM文件錯(cuò)誤0108加載VAL文件錯(cuò)誤0109創(chuàng)建日志目錄失敗0110無(wú)效報(bào)文0111發(fā)送報(bào)文超長(zhǎng)0112隊(duì)列管理器已斷開(kāi)或隊(duì)列已關(guān)閉0113打開(kāi)或關(guān)閉隊(duì)列錯(cuò)誤0114開(kāi)始事務(wù)錯(cuò)誤0115參數(shù)CFCA路徑名錯(cuò)誤0116核數(shù)字簽名錯(cuò)誤0117初始化環(huán)境拋出錯(cuò)誤0118發(fā)送報(bào)文拋出錯(cuò)誤0119接收?qǐng)?bào)文拋出錯(cuò)誤0120業(yè)務(wù)檢查報(bào)文拋出錯(cuò)誤0201缺少報(bào)文第1塊0202缺少報(bào)文第2塊0203缺少報(bào)文第3塊0212缺少報(bào)文第6塊0210缺少報(bào)文第7塊0204SWIF報(bào)文字符集檢查錯(cuò)誤0205發(fā)起行沒(méi)有權(quán)限發(fā)起該報(bào)文0206發(fā)送報(bào)文加編身份認(rèn)證錯(cuò)誤0207報(bào)文沒(méi)有包含認(rèn)證信息被自動(dòng)拒絕0208身份認(rèn)證核報(bào)文第七塊不一致0209接收?qǐng)?bào)文輸入?yún)?shù)錯(cuò)誤0211節(jié)點(diǎn)號(hào)碼與證書(shū)DN號(hào)碼不同0243優(yōu)先級(jí)子塊錯(cuò)誤0213轉(zhuǎn)匯業(yè)務(wù)子塊集錯(cuò)誤0214退匯業(yè)務(wù)子塊集錯(cuò)誤0215數(shù)字簽名證書(shū)非法0216報(bào)文的第三塊FMTCode與配置文件報(bào)文列表不一致0217報(bào)文的第二塊MTCode與配置文件報(bào)文列表不一致0218報(bào)文的第二塊輸入輸出標(biāo)識(shí)錯(cuò)誤0219計(jì)算發(fā)起行行號(hào)+任務(wù)號(hào)+消息序號(hào)錯(cuò)誤0220第五塊(附加正文塊)支付業(yè)務(wù)及結(jié)算業(yè)務(wù)子塊集錯(cuò)誤0221檢查FMT011報(bào)文明細(xì)清單錯(cuò)誤0222檢查FMT012報(bào)文明細(xì)清單錯(cuò)誤0223檢查FMT041報(bào)文明細(xì)清單錯(cuò)誤0224檢查FMT073報(bào)文明細(xì)清單錯(cuò)誤0225檢查FMT082報(bào)文明細(xì)清單錯(cuò)誤0226檢查FMT083報(bào)文明細(xì)清單錯(cuò)誤0227檢查FMT084報(bào)文明細(xì)清單錯(cuò)0228檢查FMT085報(bào)文明細(xì)清單錯(cuò)誤0229檢查FMT016報(bào)文明細(xì)清單錯(cuò)誤0230檢查FMT026報(bào)文明細(xì)清單錯(cuò)誤0231檢查FMT027報(bào)文明細(xì)清單錯(cuò)誤0232檢查FMT021報(bào)文明細(xì)清單錯(cuò)誤0233檢查FMT032報(bào)文明細(xì)清單錯(cuò)誤0234檢查FMT061報(bào)文明細(xì)清單錯(cuò)誤0235檢查FMT062報(bào)文明細(xì)清單錯(cuò)誤0236檢查FMT070報(bào)文明細(xì)清單錯(cuò)誤0237檢查FMT072報(bào)文明細(xì)清單錯(cuò)誤0238檢查FMT080報(bào)文明細(xì)清單錯(cuò)誤0239檢查FMT081報(bào)文明細(xì)清單錯(cuò)誤0240檢查FMT086報(bào)文明細(xì)清單錯(cuò)誤0241檢查FMT089報(bào)文明細(xì)清單錯(cuò)誤0242打開(kāi)PKIBANK文件錯(cuò)誤【調(diào)用說(shuō)明】此函數(shù)用于獲取詳細(xì)的操作錯(cuò)誤碼和錯(cuò)誤描述，應(yīng)該在調(diào)用以上四個(gè)函數(shù)的任何一個(gè)后，如出現(xiàn)錯(cuò)誤，應(yīng)立即調(diào)用此函數(shù)獲取詳細(xì)錯(cuò)誤碼和錯(cuò)誤描述。6 安裝過(guò)程6.1 安裝準(zhǔn)備提供安裝程序包，安裝文件如下：平臺(tái)文件名稱說(shuō)明AIXinstallSle.shSuSe平臺(tái)安裝執(zhí)行文件setupSle.tar SuSe平臺(tái)文件包SUSE LinuxinstallAIX.shAIX平臺(tái)安裝執(zhí)行文件setupAIX.tarAIX平臺(tái)文件包6.2 安裝步驟AIX平臺(tái)操作方法：1. 用普通用戶登錄系統(tǒng)2. 把安裝包中兩個(gè)文件：installAIX.sh（通過(guò)ASCII方式）和setupAIX.tar（通過(guò)BIN方式），通過(guò)FTP上傳到需要安裝的目錄，例如/fxapi目錄下。3. 增加文件installAIX.sh的執(zhí)行權(quán)限：$chmod +x installAIX.sh4. 執(zhí)行installSle.sh程序進(jìn)行開(kāi)始安裝. 具體操作如下：$./installAIX.shSUSE平臺(tái)操作方法：1. 用普通用戶登錄系統(tǒng)2. 把安裝包中兩個(gè)文件：installSle.sh（通過(guò)ASCII方式）和setupSle.tar（通過(guò)BIN方式），通過(guò)FTP上傳到需要安裝的目錄，例如/fxapi目錄下。3. 增加文件installSle.sh的執(zhí)行權(quán)限：$chmod +x installSle.sh4. 執(zhí)行installSle.sh程序進(jìn)行開(kāi)始安裝. 具體操作如下：$./installSle.sh6.3 安裝驗(yàn)證安裝完成后請(qǐng)檢查安裝目錄下的文件是否與如下列表中的文件清單相符：所屬節(jié)點(diǎn)名一級(jí)目錄文件清單說(shuō)明FXAPIfxapi.ini配置文件etcSWF.struSwif報(bào)文定義文件，二進(jìn)制格式，AIX5.3及SUSE Linux9.0平臺(tái)文件名字一致，但有平臺(tái)之分。TAG.struTAG碼定義文件，二進(jìn)制格式，AIX5.3及SUSE Linux9.0平臺(tái)文件名字一致，但有平臺(tái)之分。common.err錯(cuò)誤碼及描述文件，文本格式，AIX5.3及SUSE Linux9.0平臺(tái)通用。tagval.dat特定變量定義檢查文件，文本格式，AIX5.3及SUSE Linux9.0平臺(tái)通用。BJCNCNBJXXX.pfx證書(shū)文件cfca.p7b證書(shū)鏈文件cfca.crl證書(shū)注銷列表apiabout.txtAPI關(guān)于文件apiaboutAPI版本信息更新程序liblibcapi.soCFCA證書(shū)使用（AIX平臺(tái)）libcfcatoolkit.soCFCA證書(shū)使用（AIX平臺(tái)）libmqfxapi.aAPI基于MQ（AIX平臺(tái)）libtlqfxapi.aAPI 基于TLQ（AIX平臺(tái)）libcnccFXCCsle9.so報(bào)文處理（SuSE平臺(tái)）libmqFXCCsle9.soMQ使用（SuSE平臺(tái)）libtlqFXCCsle9.soTLQ使用（SuSE平臺(tái)）libcfcaFXCCsle9.soCFCA證書(shū)使用（SuSE平臺(tái)）libcfcatoolkit.soCFCA證書(shū)使用（SuSE平臺(tái)）libcapi.soCFCA證書(shū)使用（SuSE平臺(tái)）libmqfxapi.soAPI基于MQ（SuSE平臺(tái)）libtlqfxapi.soAPI 基于TLQ（SuSE平臺(tái)）includecfxpsapi.hpp頭文件7 開(kāi)發(fā)環(huán)境說(shuō)明7.1 頭文件cfxpsapi.hpp說(shuō)明：在開(kāi)發(fā)環(huán)境下，把這個(gè)頭文件拷貝到所在的開(kāi)發(fā)環(huán)境。7.2 編譯方法1 在使用靜態(tài)或動(dòng)態(tài)庫(kù)時(shí)，在用戶的工程中包含cfxpsapi.hpp的頭文件。2 在AIX平臺(tái)中，makefile 文件中要包含鏈接的靜態(tài)庫(kù)libmqfxapi.a（MQ使用）或libtlqfxapi.a（TLQ使用），以及動(dòng)態(tài)庫(kù)libcapi.so、libcfcatoolkit.so，同時(shí)要鏈接中間件(MQ或TLQ)庫(kù)；3 在SUSE Linux平臺(tái)中，makefile 文件中要包含鏈接的動(dòng)態(tài)庫(kù)（見(jiàn)下表格）同時(shí)要鏈接中間件(MQ或TLQ)庫(kù)。序號(hào)庫(kù)文件描述1libcnccFXCCsle9.so報(bào)文處理2libmqFXCCsle9.soMQ使用3libtlqFXCCsle9.soTLQ使用4libcfcaFXCCsle9.soCFCA證書(shū)使用5libcfcatoolkit.soCFCA證書(shū)使用6libcapi.soCFCA證書(shū)使用7.libmqfxapi.soAPI基于MQ8libtlqfxapi.soAPI 基于TLQ 7.3 makefile文件示例7.3.1 AIX平臺(tái)的makefilemakefile文件僅供參考。# Makefile for Common Library. Version 1.0 build 2007-09-10# # Copyright 2006-2007, CNCC/DC# 外幣清算系統(tǒng)公共庫(kù)編譯單元# # Custom defines#FXAPI_NAME = fxapiFXCC_HOME = /home/FXAPI/exampleFXCCPUB_HOME = $(FXCC_HOME)/libFXCC_INCS = -I$(FXCC_HOME)/include -I.FXCC_LIBMQS = -L$(FXCCPUB_HOME) -lmq$(FXAPI_NAME) -ldlFXCC_LIBTLQS = -L$(FXCCPUB_HOME) -ltlq$(FXAPI_NAME) -ldlCFCA_LIBS = /usr/lib/libcfcatoolkit.so# Compiler and Linker#CC = xlC_rCCS = /usr/vacpp/bin/makeC+SharedLib# IBM MQ#MQ_HOME =MQ_OPTS =MQ_INCS =MQ_LIBS = -lmqm_r# TongLink/Q#TLQ_HOME = /usr/tlq/TLQ63TLQ_OPTS =TLQ_INCS = -I$(TLQ_HOME)/inclTLQ_LIBS = /usr/lib/libtlqapi.so# PUBLIC rule for build all file#.SUFFIXES: .pc .sqC .ccs .cpp .C .o .ibmcpp .so.cpp.o:$(CC) $(FXCC_INCS) -c $# Where to find the sourceVPATH = .all: clean apitestclean:-rm *.oapitest: $(FXCC_HOME)/simain/apitest.o-rm $(FXCC_HOME)/simain/apitest$(CC) -o $(FXCC_HOME)/simain/$ apitest.o $(MQ_LIBS) $(FXCC_LIBMQS) $(CFCA_LIBS)#$(CC) -o $(FXCC_HOME)/simain/$ apitest.o $(TLQ_LIBS) $(FXCC_LIBTLQS) $(CFCA_LIBS) 7.3.2 SUSE Linux平臺(tái)makefilemakefile文件僅供參考。# Makefile for Common Library. Version 1.0 build 2007-09-10# # Copyright 2006-2007, CNCC/DC# 外幣清算系統(tǒng)公共庫(kù)編譯單元# # Custom defines#FXAPI_NAME = fxapiFXCC_HOME = /home/fxapi/exampleFXCCPUB_HOME = $(FXCC_HOME)/libFXCC_INCS = -I$(FXCC_HOME)/includeFXCC_LIBMQS = -L$(FXCCPUB_HOME) -lmq$(FXAPI_NAME) -lmqFXCCsle9 -lcfcaFXCCsle9 -lcnccFXCCsle9FXCC_LIBTLQS = -L$(FXCCPUB_HOME) -ltlq$(FXAPI_NAME) -ltlqFXCCsle9 -lcfcaFXCCsle9 -lcnccFXCCsle9CFCA_LIBS = /usr/lib/libcfcatoolkit.so# Compiler and Linker#CC = g+ -fPIC -Wall CCS = g+ -shared -Wall #CFCA_LIBS = /usr/lib/libcfcatoolkit.so /usr/lib/libcfca$(PUBLIB_APPNAME)$(PUBLIB_SYSNAME).so# IBM MQ#MQ_HOME =MQ_OPTS =MQ_INCS =MQ_LIBS = -lmqm_r# TongLink/Q#TLQ_HOME = /usr/tlq/TLQ63TLQ_OPTS =TLQ_INCS = -I$(TLQ_HOME)/inclTLQ_LIBS = /usr/lib/libtlqapi.so# PUBLIC rule for build all file#.SUFFIXES: .pc .sqC .ccs .cpp .C .o .ibmcpp .so.cpp.o:$(CC) $(FXCC_INCS) -c $# Where to find the sourceVPATH = .all: clean apitestclean:-rm *.oapitest: $(FXCC_HOME)/apitest/apitest.o-rm $(FXCC_HOME)/apitest/apitest$(CC) -o $(FXCC_HOME)/apitest/$ apitest.o $(MQ_LIBS) $(FXCC_LIBMQS) $(CFCA_LIBS)8 運(yùn)行環(huán)境說(shuō)明8.1 目錄結(jié)構(gòu)AIX與SUSE Linux平臺(tái)運(yùn)行目錄結(jié)構(gòu)相同。所屬節(jié)點(diǎn)名一級(jí)目錄文件清單說(shuō)明FXAPIfxapi.ini配置文件etcSWF.struSwif報(bào)文定義文件，二進(jìn)制格式，AIX5.3及SUSE Linux9.0平臺(tái)文件名字一致，但有平臺(tái)之分。TAG.struTAG碼定義文件，二進(jìn)制格式，AIX5.3及SUSE Linux9.0平臺(tái)文件名字一致，但有平臺(tái)之分。common.err錯(cuò)誤碼及描述文件，文本格式，AIX5.3及SUSE Linux9.0平臺(tái)通用。tagval.dat特定變量定義檢查文件，文本格式，AIX5.3及SUSE Linux9.0平臺(tái)通用。cfca.p7b證書(shū)鏈文件cfca.crl證書(shū)注銷列表apiabout.txtAPI關(guān)于文件apiaboutAPI版本信息更新程序8.2 配置文件配置文件為：fxapi.ini，其配置內(nèi)容如下：SystemMqServer = QMABC /*MQ管理器名字*/TLQProgramNo = 100/*TLQ程序號(hào)碼，根據(jù)TLQ安裝目錄配置文件TongUser.Conf修改*/SendRealQueue = TOFXCC_2/*發(fā)送實(shí)時(shí)隊(duì)列名字*/SendCommQueue = TOFXCC_1/*發(fā)送普通隊(duì)列名字*/RecvRealQueue = FROMFXCC_2/*接收實(shí)時(shí)隊(duì)列名字*/RecvCommQueue = FROMFXCC_1/*接收普通隊(duì)列名字*/PkiFmtList = 100&101&102&103&104&200&201&202&203&204&011&012&014&041&045&046&047&048&088&089LogLevel = 8NodeCode = BNKBCNBJXXX;/*本節(jié)點(diǎn)代碼，可根據(jù)自己代碼修改*/LogPath = $(FXAPIHOME)/logcommon.err = $(FXAPIHOME)/etc/common.errswfdef.dat = $(FXAPIHOME)/etc/SWF.strutagdef.dat = $(FXAPIHOME)/etc/TAG.strutagval.dat = $(FXAPIHOME)/etc/tagval.datpkibank.dat = $(FXAPIHOME)/etc/CFCAP7BFile = $(FXAPIHOME)/etc/cfca.p7bCFCACRLFile = $(FXAPIHOME)/etc/cfca.crlFMTandMTFMT=100;103|101;103|102;103|103;103|104;103|191;192|193;192|195;195|196;196|192;196|194;196|010;198|011;198|012;198|013;198|014;198|015;198|016;198|020;198|021;198|023;198|024;198|025;198|026;198|027;198|031;198|032;198|033;198|034;198|040;198|041;198|042;198|043;198|044;198|045;198|046;198|047;198|048;198|049;198|060;198|061;198|062;198|063;198|064;198|065;198|066;198|067;198|068;198|070;198|071;198|072;198|073;198|074;198|080;198|081;198|082;198|083;198|084;198|085;198|086;198|087;198|088;198|089;198|199;199|200;202|201;202|202;202|204;202|203;203|920;92