【文章內(nèi)容簡介】 有返回參數(shù)說明的MML命令只能有SUC、ERR返回，而不能由ACK返回。（2）如果MML命令支持多組參數(shù)，則表示方法如下例：MOD PIN:CARDNO, PIN!。即以嘆號（!）來表示該命令支持多組參數(shù)并列。目前在對營業(yè)廳接口中還不支持多組參數(shù)的情況。（3）如果命令存在返回數(shù)據(jù)，則表示方法如下例：QRY ABBRV:CARDNO, ABBRVNOC RETURN PSTNNUMBER。即用RETURN來引導(dǎo)返回數(shù)據(jù)說明，返回數(shù)據(jù)說明同參數(shù)說明格式。有返回數(shù)據(jù)說明的MML命令可以分別有ACK、ERR返回，而不能有SUC返回。（4）如果返回數(shù)據(jù)支持多行記錄，則表示方法如下例：QRY ABBRV:CARDNO RETURN PSTNNUMBER!。即以嘆號（!）來表示該命令支持多行返回值。 MML命令范例（1）修改密碼：MOD PIN:CARDNO=N39。89860012345, PINNUMBER=N39。1234。（2）修改縮位撥號：MOD ABBRV:CARDNO=N39。89860012345678, ABBRNOC=D39。1, PSTNNUMBER=N39。07556812714。（3）增加用戶：ADD USER:USERNAME=張三,ADDRESS=西直門外大街12號, PHONE=N39。01087353345, IDNUMBER=N39。310602720808123,ZIPCODE=N39。102435。 MML返回命令規(guī)范 MML返回命令概述MML返回命令用于對MML命令的返回。在SMPAgent和營業(yè)系統(tǒng)之間的MML命令中，除了少數(shù)NOTIFY命令和注銷LGO命令之外，都是要求有返回。所有的返回命令都要遵循MML返回命令規(guī)范。TELLIN MML返回命令有三種：（1）操作成功，無返回數(shù)據(jù)——SUC命令（2）操作失敗，返回錯誤———ERR命令（3）操作成功，有返回數(shù)據(jù)——ACK命令以下分別對三種返回命令進行說明。 SUC命令 圖12 成功返回SUC命令返回只用于操作性質(zhì)的MML命令返回，表示操作命令成功執(zhí)行，并且無返回結(jié)果。SUC命令無參數(shù)。 ERR命令 1. ERR命令格式ERR命令只用于操作命令的返回，表示MML命令執(zhí)行過程中出現(xiàn)錯誤。ERR命令格式如下： 圖13 出錯返回參數(shù)塊格式如下： 圖14 參數(shù)塊SUC命令是通用的命令，用于服務(wù)器執(zhí)行MML操作過程中出現(xiàn)錯誤時向終端發(fā)送，表示操作出現(xiàn)錯誤，同時向終端返回錯誤信息。 2. 參數(shù)1——錯誤ID錯誤ID的格式是：錯誤編號由于可能分別來自SMPAgent、SMP、SCP以及DBMS，編號本身并不能保證不重復(fù)。作為營業(yè)系統(tǒng)，不應(yīng)針對特定的錯誤編號編寫出錯處理程序。3. 參數(shù)2——錯誤字符串錯誤字符串包含了對出錯情況的說明。由于錯誤的輸出可以是SMPAgent、SMP、SCP以及DBMS，錯誤字符串可能會出現(xiàn)不同的語言、格式等。錯誤字符串的最大長度為：20K。 4. ERR返回命令示例以下的例子為分別為SQL錯誤返回和接口命令參數(shù)錯誤返回：ERR:ERRID=D39。268,ERRTEXT=SQLERROR:Unique constraint ix_1034 violated.；ERR:ERRID=D39。12,ERRTEXT=AgentERROR:密碼值類型不合法，應(yīng)該為數(shù)字字符串； ACK命令 1. ACK命令格式ACK返回命令格式為：ACK返回命令由命令碼ACK和結(jié)果集組成，中間用冒號（:）分隔。如果返回信息中結(jié)果集為空（意味著查詢命令沒有得到符合查詢條件的結(jié)果），則冒號和結(jié)果集都為空，只保留命令碼ACK。 2. 結(jié)果集格式結(jié)果集中包含了命令的操作結(jié)果數(shù)據(jù)，操作結(jié)果數(shù)據(jù)的格式如下：結(jié)果集由返回結(jié)果組成，如果結(jié)果集中存在多行返回記錄（如查詢到多行記錄），則返回結(jié)果之間用感嘆號（！）分隔。返回記錄可以由多個值組成，之間用逗號（,）分隔。返回參數(shù)值格式同MML命令中的參數(shù)值。同理，參數(shù)值也存在三種數(shù)據(jù)類型：十進制數(shù)、數(shù)字字符串、字符串。在業(yè)務(wù)數(shù)據(jù)中基本上不存在數(shù)據(jù)null值的情況，但是如果查詢數(shù)據(jù)中某字段返回null值，則參數(shù)值返回將分別為： 數(shù)據(jù)類型為D39。，則null值表示為D39。 數(shù)據(jù)類型為N39。, 則null值表示為N39。 數(shù)據(jù)類型為，則null值表示為。每種數(shù)據(jù)類型的其他格式要求和轉(zhuǎn)義字符序列同MML命令中的參數(shù)值要求。如果得到返回值過多，以至產(chǎn)生的MML返回消息超過了消息協(xié)議規(guī)定的最大長度（64k），則系統(tǒng)將把超出的記錄丟棄，并在消息中注明實際結(jié)果集的記錄數(shù)和發(fā)送的記錄數(shù)。 3. 示例（1）查詢卡號縮位撥號ACKACK:ABBRNOC=N39。0,PSTNNUMBER=N39。07556812775! ABBRNOC=N39。1, PSTNNUMBER=N39。07556812714! ABBRNOC=N39。2, PSTNNUMBER=N39。07556812715! ABBRNOC=N39。3, PSTNNUMBER=N39。! ABBRNOC=N39。4, PSTNNUMBER=N39。! ABBRNOC=N39。5, PSTNNUMBER=N39。! ABBRNOC=N39。6, PSTNNUMBER=N39。! ABBRNOC=N39。7, PSTNNUMBER=N39。! ABBRNOC=N39。8, PSTNNUMBER=N39。! ABBRNOC=N39。9, PSTNNUMBER=N39。（2）查詢卡號余額ACK:ACCOUNTLEFT=D39。1260。（3）查詢限呼號碼（無限呼數(shù)據(jù)）ACK。3 協(xié)議規(guī)程 TELLIN MML消息結(jié)構(gòu)無論是營業(yè)系統(tǒng)發(fā)送給SMPAgent，還是由SMPAgent返回給營業(yè)系統(tǒng)的消息，都遵循下圖所示的消息結(jié)構(gòu)：每一條MML消息都是由下列7個部分組成：（1）消息開始標志：標志消息幀的起始。（2）消息長度 ：消息后續(xù)部分（不包括本身和消息開始標志）的長度。（3）消息頭 ：包含消息的發(fā)送、接收方信息以及請求的服務(wù)信息。（4）結(jié)果標識 ：包含ACK消息內(nèi)容是否完全的信息。（5）保留字 ：用于日后的擴展。（6）MML ：經(jīng)過加密的MML命令串。（7）MAC ：MML命令串的校驗碼。有關(guān)消息的編解碼、加解密和消息校驗的算法以華為公司提供的營業(yè)系統(tǒng)應(yīng)用開發(fā)接口（即BSAPI）的函數(shù)庫或接口代碼為準。 下面依次對這些部分進行描述： 消息開始標志消息開始標志是由4個字節(jié)（CHAR(4)）組成，用來標識一個消息幀的起始。消息開始標志的內(nèi)容是：\x1C\x1D\x1E\x1F。 消息長度消息長度的數(shù)據(jù)類型為2字節(jié)整數(shù)，取值范圍為：065000。消息長度表示了消息的后續(xù)部分的長度，包括：消息頭（26bytes）+結(jié)果標識（8bytes）+保留字（64bytes）+MML（n*8bytes）+MAC（16bytes）本字段采用網(wǎng)絡(luò)字節(jié)順序。 消息頭消息頭中包含消息發(fā)送、接收雙方信息以及MML服務(wù)相關(guān)的信息。消息頭由以下部分組成： 1. 源實體ID源實體ID的數(shù)據(jù)類型為四字節(jié)整數(shù)，取值范圍為0——2147483647。源實體ID表示了消息的發(fā)送方的標識。對于從營業(yè)系統(tǒng)發(fā)給SMPAgent的消息，源實體ID為分配給該營業(yè)系統(tǒng)的標識ID；對于從SMPAgent發(fā)送給營業(yè)系統(tǒng)的消息，源實體ID為SMPAgent的ID。本字段采用網(wǎng)絡(luò)字節(jié)順序。 2. 目的實體ID目的實體 ID的數(shù)據(jù)類型為