SMPP协议V3.3(中文版)1.doc

YD T xxx xxxx 900 1800MHz TDMA 数字蜂窝移动通信网 扩展短消息实体到短消息中心 的接口协议规范 900 1800MHz TDMA Digital Cellulor Mobile Telecommunication Protocol Specification for the interface of Extended Short Message Entities ESMEs to Short Message Service Centres SMSCs 19xx xx xx 发布 19xx xx xx 实施 中 华 人 民 共 和 国 信 息 产 业 部 发 布 1 目目 录录 前前 言言 6 1 适用范围适用范围 1 2 引用标准引用标准 2 3 符号和缩略语符号和缩略语 3 4 系统网络结构示例系统网络结构示例 3 5 协议总述协议总述 5 5 1 协议功能 6 5 2 SMPP 协议兼容性 7 5 3 向下兼容性 7 5 4 ESME 与 SMSC 的直接和间接连接方式 8 5 5 对 PHASE2 的支持 9 6 协议规格说明协议规格说明 9 6 1 ESME 到 SMSC 的消息 10 6 2 SMSC 到 ESME 的消息 12 6 3 消息流 14 6 4 消息列表 14 6 5 消息语法 17 附录附录 A 命令标志数值定义 命令标志数值定义 72 附录附录 B 扩展的命令标志数值定义 扩展的命令标志数值定义 76 前前 言言 1 适用范围适用范围 2 引用标准引用标准 3 符号和缩略语符号和缩略语 4 系统网络结构示例系统网络结构示例 5 协议总述协议总述 5 1 协议功能 5 2 SMPP 协议兼容性 5 3 向下兼容性 5 4 SMSC 和 ESME 连接绑定后的消息流图示例 5 5 ESME 与 SMSC 的直接和间接连接方式 5 6 对 PHASE2 的支持 6 协议规格说明协议规格说明 2 6 1 ESME 到 SMSC 的消息 6 2 SMSC 到 ESME 的消息 6 3 消息流 6 4 消息列表 6 5 消息语法 附录附录 A 命令标志数值定义 命令标志数值定义 附录附录 B 本协议在 本协议在 SMPP 上的扩充上的扩充 3 前前 言言 随着短消息业务在移动通信网上的广泛开展 运营商可以利用短消息平台向用户提供丰 富的增值业务 短消息中心 SMSC 可以与人工台 自动台 WEB Server E mail Server WAP 网关等各种非 PLMN 网的扩展短消息实体 ESME 配合工作 从而为移动用户 提供丰富多采的功能 在 SMSC 与 ESME 间采用标准的协议接口 有助于实现其他厂家的 ESME 的接入 为运营者集成第三方产品 发展短消息新业务提供方便 本规范主要是参考了 ETSI 相关的技术规定 GSM 03 39 v5 0 0 以及有关厂家的技术 规范 并根据我国网络的实际业务和功能需要而制定的 本规范的内容主要针对扩展短消 息实体与短消息中心的通信协议 本规范是在 GSM03 39 推荐的 SMPP 协议的基础上 经过扩展而成 它包含了 GSM 03 39 v5 0 0 中 SMPP 协议的所有内容 能支持 GSM 的 PHASE2 的业务 另外还包括了可选的短消 息用户管理的功能 本规范面向现有的短消息业务 兼容 ETSI GSM 规范 03 39 v5 0 0 中的 SMPP 协议 以后对于新业务 如 WAP 业务 的支持 可做相应修改 GSM 03 39 v5 0 0 协议 中错误状态和短消息状态没有定义具体的值 本规范对错误状态值和短消息状态值给与明确定 义 附录A为本规范的协议命令标志的数值定义 附录B为本规范扩展协议的命令标志的数值定义 本标准由信息产业部科技司提出并归口 本标准起草单位 信息产业部电信传输研究所 深圳市华为技术有限公司 本标准主要起草人 赵军 吴俊 惠明宇 中华人民共和国通信行业标准中华人民共和国通信行业标准 900 1800MHz TDMA 数字蜂窝移动通信网 扩展短消息实体到短消息中心的接口协议规范 900 1800MHz TDMA Digital Cellulor Mobile Telecommunication Network Protocol Specification for the interface of Extended Short Message Entities ESMEs to Short Message Service Centres SMSCs YD T XXX XXXX 1 适适用用范范围围 本规范规定了 900 1800MHz TDMA 数字蜂窝移动通信网扩展短消息实体与短消息中心 的通信协议的技术细节 本规范主要适用于 900 1800MHz TDMA 数字蜂窝移动通信网扩展短消息实体和短消息中 心 为短消息中心 接入扩展短消息实体提供技术依据 2 引引用用标标准准 下列标准包括的条文 通过在本规范中引用而构成为本规范的条文 本规范出版时 所示 版本均为有效 所有标准都会被修订 使用本规范的各方应探讨使用下列标准最新版本的可能 性 ETSI GSM 规范 03 38 5 2 0 欧洲数字蜂窝通信系统 字符和特定语言信息 ETSI GSM 规范 03 39 5 0 0 欧洲数字蜂窝通信系统 短消息中心和短消息实体间连 接的接口协议 ETSI GSM 规范 03 40 7 2 0 欧洲数字蜂窝通信系统 点对点短消息业务技术实现 ETSI GSM 规范 03 47 5 0 0 欧洲数字蜂窝通信系统 短消息中心与移动交换中心间互 联协议栈举例 3 符符号号和和缩缩略略语语 ESME AgentExternal Short Message Entity Agent 扩展短消息实体代理 ESMEExternal Short Message Entity 扩展短消息实体 PLMNPublic Land Mobile Network 公共陆地移动网 SMSCShort Message Service Center 短消息中心 SMPPShort Message Peer to Peer 短消息点对点协议 扩展短消息实体到短消息中心的接口协议规范 1 SS Secretary System 秘书台 AS Auto System 自动台 4 系系统统网网络络结结构构 示示例例 图 1 SMSC 和 ESME 通过交换网络连接的短消息系统网络图 SMSC 指短消息中心 ESME 在本规范中指的是通过本规范规定的协议与 SMSC 通信 请求特定的短消息服务的 功能实体 SS 指人工话务接入并受理短消息服务请求的系统 AS 指利用交互式语音技术受理短消息服务请求的系统 SS 秘书台 和 AS 自动台 是典型的 ESME SMSC 和 ESME 之间的传输网络可以是基于 X 25 或 TCP IP 5 协协议议总总述述 本规范规定了 SMSC 和 ESME 之间通信的数据格式 本规范是在 GSM 03 39 v5 0 0 中的 SMPP 协议的基础上 经过扩展而成 它包含了 SMPP 协议的内容 能支持 GSM 的 PHASE2 的业务 另外还包括了可选的短消息用户管理协议 扩展短消息实体到短消息中心的接口协议规范 2 5 1 协议功能协议功能 通过本规范 ESME 比如 AS SS 寻呼台 语音邮箱系统 能连接 BIND 或断连 UNBIND SMSC 提交 SUBMIT 替换 REPLACE 取消 CANCEL 查询 QUERY 短消息 SMSC 能下发 DELIVERY 短消息到 ESME 此规范包含以下两部分 1 ESME 到 SMSC 的消息 2 SMSC 到 ESME 的消息 协议又可分为短消息业务部分和用户管理部分 其中用户管理部分只适用于 SMSC 有用 户数据库支持的情况 与短消息业务部分相独立 在实现上是可选部分 5 2 SMPP 协议兼容性协议兼容性 本规范兼容 ETSI GSM 规范 03 39 5 0 0 中的 SMPP 协议 但不保证兼容以后的 SMPP 协议 本规范将 SMPP 协议没有明确定义的错误值和短消息状态值明确定义 5 3 向下兼容性向下兼容性 由协议版本号指示协议版本 ESME 和 SMSC 之间根据不同的版本号进行处理 图 2 是在 ESME 和 SMSC 之间进行连接时版本处理会话的示意图 说明高版本 ESME 与低版本 SMSC 之间连接的会话过程 括号中的数字是版本号 本规范的此版本的版本号为 1 SMSC 给回的 响应消息中 Status 参数如果为 0 表示其 SMSC 同意 ESME 提出的版本号 如果不为 0 指 示 SMSC 自己的版本号 参见消息体参数 interface version BIND 版本号 2 BIND RESP 状态 1 失败 BIND 版本号 1 BIND RESP 状态 0 成功 ESMESMSC 扩展短消息实体到短消息中心的接口协议规范 3 图 2 不同版本间的 ESME 和 SMSC 之间连接会话示意图 5 4 ESME 与与 SMSC 的直接和间接连接方式的直接和间接连接方式 ESME 可以与 SMSC 直接或者间接相连 直接相连时通过本规范确定的协议与 SMSC 通 信 间接相连时 通过 ESME Agent 与 SMSC 相连 ESME Agent 为 ESME 与 SMSC 之间的连 接代理 ESME Agent 与 SMSC 间协议要求是本规范确定的协议 ESME 和 ESME Agent 之间 可以是自定义的协议 也可以是本协议 采用 ESME Agent 间接相连方式 对接入 SMSC 的 ESME 提供了分类管理的便利 也提供了接入使用非本协议的 ESME 的一种方式 见图 3 图 3 ESME 与 SMSC 的直接和间接连接方式图 5 5 对对 PHASE2 的支持的支持 本规范支持 ETSI GSM3 40 7 2 0 中有关 PHASE2 的规定 支持有头结构的 PHASEII 短 消息 6 协协议议规规格格说说明明 6 1 ESME 到到 SMSC 的消息的消息 ESME 到 SMSC 的消息 如 提交 查询 删除短消息等请求 ESME 必须以 TRANSMITTER 类型连接到 SMSC 扩展短消息实体到短消息中心的接口协议规范 4 图 4 描述了一个典型的 TRANSMITTER 类型的请求应答的示例 TRANSMITTER 类型的 ESME 是以 BIND TRANCESMITTER 连接到 SMSC 的 ESME 此类型的 ESME 向 SMSC 发起 提交短消息 查询短消息状态 删除短消息等请求 SMSC 返回请求的应答 ESME 和 SMSC 之间的请求应答消息可以是阻塞方式也可以是异步方式的 所以 ESME 可能在 SMSC 没有应答的情况下 发起多个请求到 SMSC SMSC 应该按照收到的请求顺序 给 EMSE 回响应 但是 ESME 必须能够处理没有按顺 序的响应 图 4 TRANSMITTER 类型的 EMSE 和 SMSC 的消息序列示例 6 2 SMSC 到到 ESME 的消息的消息 SMSC 到 ESME 的消息 如 SMSC 转发短消息到 ESME ESME 必须以 RECEIVER 类 型连接到 SMSC 图 5 描述了一个典型的 RECEIVER 类型的 ESME 和 SMSC 之间的消息序列的示例 RECEIVER 类型的 ESME 是以 BIND RECEIVER 连接到 SMSC 的 ESME SMSC 向此类 ESME 转发短消息 ESME 向 SMSC 回应答 ESME 和 SMSC 之间的请求应答消息可以是阻塞方式也可以是异步方式的 所以 SMSC 可能在 ESME 没有回应答的情况下 发送发起多个 deliver sm 请求到 ESME 扩展短消息实体到短消息中心的接口协议规范 5 ESME 应该按照收到的请求顺序 给 SMSC 返回响应 但是 SMSC 必须能够处理没有按 顺序回的响应 图 5 RECEIVER 类型的 EMSE 和 SMSC 的消息序列示例 6 3 消息流消息流 本规范中规定的所有协议 不管是从 ESME 到 SMSC 还是从 SMSC 到 ESME 的消 息 接收到请求的一方 都必须给请求方回一个应答消息 acknowledge 6 4 消息列表消息列表 6 4 1 ESME 到到 SMSC 的消息的消息 表 1 ESME 到 SMSC 的消息 命令描述 bind receiverESME要求以接收者身份连接到SMSC bind transmitterESME要求以发送者身份连接到SMSC UnbindESME要求断开连接到SMSC submit smESME提交短消息到SMSC 以便SMSC下发此短消息到指定的移动台 扩展短消息实体到短消息中心的接口协议规范 6 deliver sm respdeliver sm的响应 query smESME查询以前所提交的短消息的状态 cancel smESME要求取消以前所提交的某条短消息 replace smESME要求替换以前所提交的某条短消息 enquire link询问与SMSC的连接情况 generic nak表示消息头有错误的响应 replace sm exESME要求替换以前所提交的某条短消息的扩展命令 它比replace sm增 加了数据编码格式字段 add sub增加用户 del sub删除用户 mod sub修改用户 enquire sub查询用户的信息 6 4 2 SMSC 到到 ESME 的消息的消息 表 2 SMSC 到 ESME 的消息 命令描述 bind receiver respbind receiver的响应 status表示连接成功与否 bind transmitter respbind transmitter的响应 status表示连接成功与否 unbind respunbind的响应 status表示断开连接成功与否 submit sm respsubmit sm的响应 status表明提交短消息是否成功 deliver smSMSC下发短消息到ESME query sm respquery sm的响应 status表明此次询问是否成功 其它内容返回查询到的短 消息信息 cancel sm respcancel sm的响应 Status表明取消短消息是否成功 replace sm respreplace sm的响应 status表明此次替换是否成功 enquire link respEnquire link的响应 generic nak表示消息头有错误的响应 replace sm ex respreplace sm ex的响应 status表明此次替换是否成功 add sub respadd sub的响应 status表明此次增加用户是否成功 del sub respdel sub的响应 status表明此次删除用户是否成功 mod sub respmod sub的响应 status表明此次修改用户是否成功 扩展短消息实体到短消息中心的接口协议规范 7 enquire sub respenquire sub的响应 status表明此次询问是否成功 其它内容返回查询到 的用户信息 6 5 消息语法消息语法 在以下语法说明中 遵从以下规则 A 未使用的字段 依据类型必须设置为 0 或 NULL B 消息由消息头和消息体组成 C 状态 Command status 的定义如表 3 所示 表 3 状态定义 错误代码描述 E SUCCESS 0X00000000 成功 E OTHERERR 0X00000001 其他错误 0X00000002 0X0000000F保留给SMSC厂商定义错误 E MSGLENERR 0X00000010 消息长度错误 E CMDLENERR 0X00000011 命令长度错误 E INVLDCMDID 0X00000012 消息ID无效 E NORIGHT 0X00000013 没有执行此命令的权限 0X00000014 0X0000001F保留 E INVLDSYSTEMID 0X00000020 无效的SYSTEMID E INVLDPASSWORD 0X00000021 无效的密码 E INVLDSYSTEMTYPE 0X00000022 无效的SYSTEMTYPE 0X00000023 0X0000003F保留 E ADDRERR 0X00000040 地址错误 E MOEXCEED 0X00000041 超过最大提交数 E MTEXCEED 0X00000042 超过最大下发数 E INVLDUSER 0X00000043 无效的用户 E INVLDDATAFMT 0X00000044 无效的数据格式 E CREATEMSGFAILURE 0X00000045 创建消息失败 E INVLDMSGID 0X00000046 无效的短消息ID E DATABASEFAILURE 0X00000047 数据库失败 E CANCELMSGFAILURE 0X00000048 取消消息失败 E MSGSTATEERR 0X00000049 短消息状态错误 扩展短消息实体到短消息中心的接口协议规范 8 E REPLACEMSGFAILURE 0X0000004A 替换消息失败 E INVLDRPLADDR 0X0000004B 替换消息源地址错误 0X0000004C 0X0000005F保留 E INVLDORGTON 0X00000060 无效的源地址TON E INVLDORGNPI 0X00000061 无效的源地址NPI E ORGADDRERR 0X00000062 源地址错误 E INVLDDESTTON 0X00000063 无效的目的地址TON E INVLDDESTNPI 0X00000064 无效的目的地址NPI E DESTADDRERR 0X00000065 目的地址错误 E INVLDSCHEDULE 0X00000066 无效的定时时间 E INVLDEXPIRE 0X00000067 无效的超时时间 E INVLDESM 0X00000068 无效的ESM CALSS E INVLDUDLEN 0X00000069 无效的UDLEN E INVLDPRI 0X0000006A 无效的PRI E INVLDRDF 0X0000006B 无效的Registered delivery flag E INVLDRPF 0X0000006C 无效的Replace if present flag 0X0000006D 0X0000007F保留 用户管理部分 可选 E USERALREADYEXIST 0X00000080 指定用户已经存在 E CREATEUSERERR 0X00000081 创建用户失败 E USERIDERR 0X00000082 用户ID错误 E USERNOTEXIST 0X00000083 指定用户不存在 0X00000084 0X0000008F保留 0X00000090 0X00000FFF保留给SMSC厂商定义错误 其他保留 D 在类型中 可能用到以下定义 1 integer 一定字节数所组成的整数 高位在前 低位在后 例 如 1 字节 BYTE 2 字节 WORD 4 字节 DWORD 6 字节等等 2 C String 以 NULL 结束的 ASCII 字符串 扩展短消息实体到短消息中心的接口协议规范 9 3 C DecString 以 NULL 结束的 ASCII 字符串 它由一系列的 10 进制字符 组成 0 9 4 C OctetString 由任意 8 位字节组成数据流串 5 C HexString 以 NULL 结束的 ASCII 字符串 它由一系列的 16 进制字符组 成 0 9 A a F f 6 C UnicodeString 以 NULL 结束的 Unicode 编码的字符串 7 C StringTime 表示时间的字符串 它为以下格式 YYMMDDhhmmsstnnp 长度定为 17 个字节或 1 个字节 最后一个字节值必须为 NULL 1 个字节表示 使用缺省的时间定义 由短消息中心实现时具体设置 17 个字节的具体格式 如下 YY 年份的最后2位 00 99 MM 月份 01 12 DD 日 01 31 Hh 小时 00 23 Mm 分 00 59 Ss 秒 00 59 T 十分之一秒 0 9 Nn 与UTC Universal Time Constant 时间超前或落后 的差距 00 48 p 时间超前于UTC time p 时间落后于 UTC time 对于千年问题 采用时间窗口的方法来解决 具体方法为 YY 90 解释为 19YY 否则解 释为 20YY 6 5 1 消息头语法消息头语法 表 4 短消息头语法 字段长度 字节 类型描述 Command Length4integer消息包的长度 包括此字段 Command ID4integer这个字段表明此条短消息的类型 例如 ESME SUB SM表示此消息为ESME向 SMSC提交短消息 具体数值定义见附录 A Command status4integer此字段表示一个命令的成功与失败 如 扩展短消息实体到短消息中心的接口协议规范 10 失败 指示引起失败的错误类型等信息 它在请求中必须设为0 Sequence No4integer此字段表示消息的序列号 它由ESME产 生 它是消息和它的应答之间的对应标 志 它的数值在0到0XFFFFFFFF间必须保 证严格单调的递增 当达到0XFFFFFFFF 时 从0开始下一循环 Optional Message Body 可变混合此字段表示短消息的消息体部分 具体 定义见6 5 2 6 5 2 消息体语法消息体语法 6 5 2 1 BIND RECEIVER 命令命令 此命令在扩展短消息实体和短消息中心之间产生虚连接 该连接支持所有的协议命令 BIND RECEIVER 语法语法 消息头中的 Command ID 是 bind receiver 表 5 BIND RECEIVER 语法 字段长度 字节 类型描述 system id最大 16C String接口ID password最大 9C String密码 system type最大 13C String接口类型 interface version1integer接口版本号 ton1integer保留 应设置为0 npi1integer保留 应设置为0 address range最大 41C DecString保留 应设置为NULL BIND RECEIVER RESP 语法语法 消息头中的 Command ID 是 bind receiver resp 表 6 BIND RECEIVER RESP 语法 字段大小 字节 类型描述 System id最大 16C String接口ID 状态取值范围 E SUCCESS E OTHERERR 扩展短消息实体到短消息中心的接口协议规范 11 E CMDLENERR E NORIGHT E INVLDSYSTEMID E INVLDPASSWORD E INVLDSYSTEMTYPE E INVLDIFVER 6 5 2 2 BIND TRANSMITTER 命令命令 它在扩展短消息实体和短消息中心之间产生虚连接 该连接支持除下发短消息 deliver sm deliver sm resp 以外的所有协议命令 BIND TRANSMITTER 语法语法 此命令和 BIND RECEIVER 的语法一样 只是在消息头里的 Command ID 为 bind transmitter BIND TRANSMITTER RESP 语法语法 此命令和 BIND RECEIVER RESP 的语法一样 只是在消息头里的 Command ID 为 bind transmitter resp 状态取值范围 同 BIND RECEIVER RESP 6 5 2 3 UNBIND 命令命令 此命令用于断开 ESME 和 SMSC 之间的连接 UNBIND 语法语法 此消息只有消息头 没有消息体 消息头中的 Command ID 是 unbind UNBIND RESP 语法语法 此消息只有消息头 没有消息体 消息头中的 Command ID 是 unbind resp 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT 1 6 5 2 4 SUBMIT SM 命令命令 此命令用于 ESME 提交短消息到 SMSC 以便 SMSC 把此短消息发给特定的移动台 扩展短消息实体到短消息中心的接口协议规范 12 SUBMIT SM 语法语法 消息头中的 Command ID 是 submit sm 表 7 SUBMIT SM 语法 字段长度 字节 类型描述 service type最大6C OctetString保留 必须设为0 source address ton1integer源地址编码类型 source address npi1integer源地址编码方案 source address最大21C DecString源地址 dest address ton1integer目的地址编码类型 dest address npi1integer目的地址编码方案 destination address最大21C DecString目的地址 esm class1integer短消息类型 protocol ID1integerGSM协议类型 priority flag1integer优先级 schedule delivery time最大17C StringTime计划下发短消息的时间 validity peroid最大17C StringTime短消息的最后有效期限 registered delivery flag1integer注册短消息标志 replace if present flag1integer替换短消息标志 data coding1integer数据编码方案 sm default msg id1integer预定义短消息ID sm length1integer短消息的长度 short message text最大161可变短消息数据内容 SUBMIT SM RESP 语法语法 消息头中的 Command ID 是 submit sm resp 表 8 SUBMIT SM RESP 语法 字段长度 字节 类型描述 扩展短消息实体到短消息中心的接口协议规范 13 Message id最大9C HexString短消息ID 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT E ADDRERR E MOEXCEED E MTEXCEED E INVLDUSER E INVLDDATAFMT E CREATEMSGFAILURE E INVLDORGTON E INVLDORGNPI E ORGADDRERR E INVLDDESTTON E INVLDDESTNPI E DESTADDRERR E INVLDSCHEDULE E INVLDEXPIRE E INVLDESM E INVLDUDLEN E INVLDPRI E INVLDRDF E INVLDRPF 6 5 2 5 DELIVER SM 命令命令 此命令由 SMSC 产生 SMSC 通过此命令发送短消息到目的 ESME 它也可用于发送转发 状态报告 DELIVERY RECEIPT 消息 DELIVER SM 语法语法 它的语法和 SUBMIT SM 的语法消息体是相同的 只是在消息头中的 Command ID 是 deliver sm DELIVER SM RESP 语法语法 扩展短消息实体到短消息中心的接口协议规范 14 它的语法和 SUBMIT SM RESP 的语法消息体是一样的 只是在消息头中的 Command ID 是 deliver sm resp 1 6 5 2 6 QUERY SM 命令命令 此命令用于 ESME 向 SMSC 查询以前所提交的短消息的状态 QUERY SM 语法语法 消息头中的 Command ID 是 query sm 表 9 QUERY SM 语法 字段长度 字节 类型描述 Message id最大9C HexString短消息ID Ton1Integer地址编码类型 Npi1Integer地址编码方案 Address最大21C DecString地址 QUERY SM RESP 语法语法 消息头中的 Command ID 是 query sm resp 表 10 QUERY SM RESP 语法 字段长度 字节 类型描述 Message id 最大9 C HexString 短消息ID final date最大 17C StringTime短消息生命周期终止时间 Message status1Integer短消息当前的状态 GSM code1IntegerGSM 错误码 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT E ADDRERR E INVLDMSGID E DATABASEFAILURE E INVLDORGTON E INVLDORGNPI 扩展短消息实体到短消息中心的接口协议规范 15 E ORGADDRERR 6 5 2 7 CANCEL SM 命令命令 此命令用于取消 ESME 以前所提交的短消息 此命令能取消指定短消息 ID 的短消息 也 可取消等待下发的由 CANCEL SM 所确定的源地址和目的址的所有短消息 此时 message id 为 NULL CANCEL SM 语法语法 消息头中的 Command ID 是 cancel sm 表 11 CANCEL SM 语法 字段长度 字节 类型描述 service type最大6C OctetString 保留 必须设为NULL message id最大 9C HexString 短消息ID 设置为NULL时 表示取消所有源编码地址 和目标编码地址与下述地 址相同的短消息 source address ton1Integer源地址编码类型 source address npi1Integer源地址编码方案 source address最大21C DecString源地址 dest address ton1Integer目的地址编码类型 dest address npi1Integer目的地址编码方案 destination address最大21C DecString目的地址 CANCLE SM RESP 语法语法 此命令只有消息头 没有消息体 消息头中的 Command ID 是 cancel sm resp 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT E ADDRERR E INVLDMSGID E DATABASEFAILURE E CANCELMSGFAILURE 扩展短消息实体到短消息中心的接口协议规范 16 E MSGSTATEERR E INVLDORGTON E INVLDORGNPI E ORGADDRERR E INVLDDESTTON E INVLDDESTNPI E DESTADDRERR 6 5 2 8 REPLACE SM 命令命令 此命令用于 ESME 替换以前所提交的短消息 此命令中所确定的源地址必须与提交短消息 时的源地址相同 消息头中的 Command ID 是 replace sm REPLACE SM 语法语法 表 12 REPLACE SM 语法 字段长度 字节 类型描述 message id 最大 9C HexString 短消息的ID source address ton1Integer源地址编码类型 source address npi1Integer源地址编码方案 source address最大21C DecString源地址 schedule delivery time最大17C StringTime计划下发短消息的时间 validity peroid最大17C StringTime短消息的最后生存期限 registered delivery flag1integer注册短消息标志 sm default msg id1integer预定义短消息ID sm length1integer短消息数据的长度 short message text最大161可变短消息数据内容 REPLACE SM RESP 语法语法 此命令只有消息头 没有消息体 消息头中的 Command ID 是 replace sm resp 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT 扩展短消息实体到短消息中心的接口协议规范 17 E ADDRERR E INVLDMSGID E REPLACEMSGFAILURE E MSGSTATEERR E INVLDDATAFMT E CREATEMSGFAILURE E INVLDORGTON E INVLDORGNPI E ORGADDRERR E INVLDSCHEDULE E INVLDEXPIRE E INVLDESM E INVLDUDLEN E INVLDRDF 6 5 2 9 ENQUIRE LINK 命令命令 此命令用于 ESME 确认和 SMSC 之间的连接 ESME 发送一条 ENQUIRE LINK 命令 SMSC 响应一条 ENQUIRE LINK ACK 命令 表示 ESME 和 SMSC 之间的连接存在 ENQUIRE LINK 语法语法 此命令只有消息头 没有消息体 消息头中的 Command ID 是 enquire link ENQUIRE LINK RESP 语法语法 此命令只有消息头 没有消息体 消息头中的 Command ID 是 enquire link resp 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT 6 5 2 10 GENERIC NAK 命令命令 此命令用于当接收消息头有错误的时候的响应 该响应只能由收到请求方发出 GENERIC NAK 语法语法 此命令只有消息头 没有消息体 消息头中的 Command ID 是 generic nak 扩展短消息实体到短消息中心的接口协议规范 18 状态取值范围 E SUCCESS E OTHERERR E MSGLENERR E CMDLENERR E NORIGHT E INVLDCMDID 6 5 2 11 REPLACE SM EX 命令命令 此命令用于扩展 REPLACE SM 命令 它完成的功能与 REPLACE SM 相同 但增加了字 段 data coding 符合 Phase2 规范 REPLACE SM EX 语法语法 消息头中的 Command ID 是 replace sm ex 表 13 REPLACE SM EX 语法 字段长度 字节 类型描述 message id 最大 9C HexString 短消息的ID source address ton1integer源地址编码类型 source address npi1integer源地址编码方案 source address最大21C DecString源地址 esm class1integer短消息类型 schedule delivery time最大17C StringTime计划下发短消息的时间 validity peroid最大17C StringTime短消息的最后生存期限 registered delivery flag1integer注册短消息标志 data coding1integer数据编码方案 sm default msg id1integer预定义短消息ID sm length1integer短消息长度 short message最大161可变短消息内容 REPLACE SM EX RESP 语法语法 此命令只有消息头 没有消息体 消息头中的 Command ID 是 replace sm ex resp 状态取值范围 E SUCCESS E OTHERERR 扩展短消息实体到短消息中心的接口协议规范 19 E CMDLENERR E NORIGHT E ADDRERR E INVLDMSGID E REPLACEMSGFAILURE E MSGSTATEERR E INVLDDATAFMT E CREATEMSGFAILURE E INVLDORGTON E INVLDORGNPI E ORGADDRERR E INVLDSCHEDULE E INVLDEXPIRE E INVLDESM E INVLDUDLEN E INVLDRDF E INVLDESM 6 5 2 12 ADD SUB 命令命令 此命令用于在 SMSC 数据库中增加一个用户 ADD SUB 语法语法 消息头中的 Command ID 是 add sub 表 14 ADD SUB 语法 字段长度 字节 类型描述 sub ID最大21C DecString用户ID 同address sub name最大21C String用户名 sub address最大42C String用户通信地址 MS type1integer手机类型 ton1integer地址编码类型 npi1integer地址编码方案 SM allowed1integer是否提供短消息 OCOS1integer保留 扩展短消息实体到短消息中心的接口协议规范 20 TCOS1integer保留 password最大9C String密码 ADD SUB RESP 语法语法 此命令只有消息头 没有消息体 消息头中的 Command ID 是 add sub resp 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT E USERALREADYEXIST E CREATEUSERERR E USERIDERR 6 5 2 13 DEL SUB 命令命令 此命令用于删除一个用户 DEL SUB 语法语法 消息头中的 Command ID 是 del sub 表 14 DEL SUB RESP 语法 字段长度 字节 类型描述 ton1Integer地址编码类型 npi1Integer地址编码方案 sub ID最大 21C DecString用户 ID 同 address DEL SUB RESP 语法语法 此命令只有消息头 没有消息体 消息头中的 Command ID 是 del sub resp 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT E USERIDERR E USERNOTEXIST 扩展短消息实体到短消息中心的接口协议规范 21 6 5 2 14 MOD SUB 命令命令 此命令用于修改用户信息 MOD SUB 语法语法 此命令的数据结构与 ADD SUB 的结构一致 只是 Command ID 为 mod sub MOD SUB RESP 语法语法 此命令的数据结构与 ADD SUB RESP 的结构一致 只是 Command ID 为 mod sub resp 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT E USERIDERR E USERNOTEXIST 6 5 2 15 ENQUIRE SUB 命令命令 此命令用于查询用户的详细信息 ENQUIRE SUB 语法语法 消息头中的 Command ID 是 enquire sub 表 15 ENQUIRE SUB 语法 字段长度 字节 类型描述 Ton1Integer地址编码类型 Npi1Integer地址编码方案 sub ID最大21C DecString用户ID 同address ENQUIRE SUB RESP 语法语法 消息头中的 Command ID 是 enquire sub resp 表 16 ENQUIRE SUB RESP 语法 字段长度 字节 类型描述 sub ID最大 21C DecString用户ID 同 address 扩展短消息实体到短消息中心的接口协议规范 22 sub name最大 21C String用户名 sub address最大 42C String用户通信地址 MS type1integer手机类型 Ton1integer地址编码类型 Npi1integer地址编码方案 SM allowed1integer是否提供短消息 OCOS1integer保留 TCOS1integer保留 Password最大 9C String密码 reg datetime最大17C StringTime用户注册时间 状态取值范围 E SUCCESS E OTHERERR E CMDLENERR E NORIGHT E USERIDERR E USERNOTEXIST 6 5 3 消息体参数说明消息体参数说明 address 地址号码 address range 地址范围 data coding 数据编码方案 详见 GSM 03 40 1 9 2 3 10 dest address npi 目的地址编码方案 同 npi 扩展短消息实体到短消息中心的接口协议规范 23 dest address ton 目的地址编码类型 同 ton destination address 目的地址 同 address esm class 短消息类型 Bit 76543210 Flag ReservedUDHIReservedDelivery RCPT Reserved 其中 UDHI 为 1 表示短消息内容中有头结构 为 0 表示没有头结构 Delivery RCPT 为 1 表示是此条短消息是状态报告 0 表示为正常的下发短消息 此位只 对 DELIVER SM 有效 其他为保留 如果有头结构 short message text 为以下格式 BYTE UDHL 信息元素的结构集合所用的字节数 Information Element struct Information Element 若干信息元素的结构集合 其占用的字节数目由 UDHL 指示 SM 短消息内容 其中 Information Element struct 的结构如下 BYTE Information Eleme