服务器系统sentow,Mercury系统指令集.doc

Mercury系统指令集

Mercury系统指令集

版本 1.0k， 2002年9月2日

作者：吴亦瓯目录

I.综述4

a)基本格式4

b)公用键4

1)发送必选键4

2)返回必选键4

3)可选键5

II.指令集详述6

a)初始化6

1)ClientReg6

2)ClientUnReg6

3)ClientConnect7

4)ClientDisconnect7

b)查询静态信息7

5)QueryGKDB7

6)GetSysInfo8

7)QueryAdapter8

8)QueryDataWin9

9)QueryHistoryData10

10)QueryUserAuth12

11)QueryUserDeviceAuth12

12)QueryUserHostGroupAuth13

13)QueryDevCompatible13

14)QueryHostGroup16

15)QueryHubInfo16

16)TrapDataWin17

17)ComplexQueryPosition17

c)向设备发送指令18

18)RequestPosition18

19)CancelPosition19

20)SendControl20

21)SendMessage29

22)SendRawMessage31

d)查询指令执行状态33

23)KeepAlive33

24)GetSessionStatus33

25)GetDevStatus33

e)设备回应指令34

26)SystemReport34

27)PositionResponse34

28)Alarming40

29)MessageArrive41

30)DevConfirm42

31)RawMessageArrive43

f)客户端对系统通知指令43

32)AlarmConfirm43

g)系统维护指令44

33)GetDebugInfo44

34)ResetMCCL44

35)SetAdapterConn45

h)Apollo指令45

36)AQueryHost45

37)AQueryDevice45

38)AQueryPosition46

综述

本指令集用于定义Mercury系统的功能表实现，并用于规定客户端对服务器的调用格式，以及服务器向客户端返回数据的格式。

基本格式

本指令集采用格式化字符串和结束符组成。

指令名，参数名大小写敏感。

每条指令结束，必须有结束符。结束符为：##

字符串中由“键-值对”和分隔符组成。

“键-值对”格式如下：

Key:=Value

其中，Key为任意键名，应符合.net变量名规则。Value为字符串，可以包括字母和字符，但不可以包括 | , ; ，因为这些字符是本指令集的分隔符。键和值之间，用“:=”连接。

分隔符有4级。分别为：&& | , ;

&&用来分割“键-值对”。

| , ; 作为值中的分割符，可用于表示比较复杂的值。

Value的空值为空字符串：“”。(注意：构造指令字符串时，不要加上双引号，一般来讲，等号后为空。)

公用键

以下键因为使用的指令较多，在此集中说明。

发送必选键

所有指令，都应该包含以下键：

ActID

本指令的指令代码。

CID

发出本指令的客户端代码。

SID

本指令的流水号。除了ClientReg外，所有指令都应该由客户端指定SID.

返回必选键

ActID: 对应发送指令的ActID。

SID: 用于与发送指令对应。

Successed: T|F，表示指令是否成功执行。

ErrCode: 如果未成功，错误代码。

ErrDesc: 如果未成功，错误的描述。

可选键

SIM

接受指令的通信设备ID。可为空。

HostName

接受指令的通信设备的宿主名(例如车牌号)。当SIM为空时，此参数有效，否则以SIM为准。

RValue

发送端期望原封不动返回的值。可用于对指令的判别处理。

说明：如无特殊说明在所有需要给出SIM的指令，都可以替代性的给出HostName。但这些指令中，不应二者都不给出。

指令集详述

以下各指令中，如无特殊说明，都应包括 I (b)中规定的必选键，并按其规定使用。

初始化

ClientReg

指令定义：

本指令用于客户端向中心注册。所有客户端在发起请求前，都必须向中心注册，并得到中心的认证，才能继续执行操作。

发送参数表：

CID: 空值

SID: 空值

UID: 用户登录名

PWD: 用户口令

ChannelType: 客户端与服务器的通信通道类型