策略编程语言用户编程手册.doc

H:\精品资料\建筑精品网原稿ok（删除公文）\建筑精品网5未上传百度
《图标》DTS2.0 策略编程语言 用户编程手册

Author : DTS研发部门 Version　2.08

Revision History
Date
Version
Description
Author
Approver
/11/19
2.00
Initial version.
Aaron.Peng

/3/16
2.0.1
增加3.3.3.3.5 内部修正命令
3.5.2.2     注册要收听的价格
3.5.2.5 查找价格
更新3.5.4.2 _OnEventOrderResponse回 调
Jack.shi
Peter.cao
/4/2
2.0.2
更新3.5.3.3_OnEventPosition回调
Jack.shi
Peter.cao
/5/27
2.0.3
更新2.1.3的3.API接口关键字
2.3.1.1 nil类型和逻辑判断,针对于指针变量作了说明
增加3.3.3.2.3 DTSMicroTime
3.3.3.3.4 发送Order( 下单、 撤单) 命令,增加了单个Order下单的说明
更新3.3.3.3.5内部修正命令
更新3.5.2.5查找价格
更新3.5.4.2 _OnEventOrderResponse回调
更新3.5.5.1 DTSMessageRecordAccess类型
3.6系统工具函数,增加3.6.5～3.6.10部分
xuebin.li
Peter.cao
/6/20
2.0.4
增加批量撤单接口3.3.3.3.3, 3.3.3.3.6
Yousong.Zhang
Peter.cao
/6/30
2.0.5
增加matlab的接口说明3.7, 增加简单加密的说明3.6.9, 3.6.10。
Jack.shi
Peter.cao
/8/10
2.0.6
增加市场逐笔行情信息 3.5.3
6.1修改ClosePriceInputFlag的说明
增加DTSQUEUEPRICE FIELD一览 6.2
Lin.gong
Jack.shi
/9/15
2.0.7
增加2.3.1.2 sys_find的说明
更新3.7的matlab图只显示半个
6.1增加ETFIOPV说明, 修改VWAPEVEPrice说明
更新6.3 DTSNewOrderAccess field 一览
更新6.4 DTSCancelOrderAccess field 一览
xiang.shu
Jack.shi
/9/19
2.0.8
增加PriceCondition的说明
Jack.shi

目录
REVISION HISTORY II
1. DTS策略编程语言简介 1
1.1 DTS策略编程平台及其原理 1
1.2 策略在系统平台上的生命周期和运行过程 2
1.2.1 策略生命周期 2
1.2.2 系统通讯和Event 3
1.2.2.1 事件定义 3
1.2.2.2 输入输出事件 3
1.2.2.3 Buffer flag 3
1.2.2.4 事件回调 3
1.2.3 策略参数和参数变化回调 4
1.2.4 运行策略 4
2. DTS SCRIPT编程基础 7
2.1 DTS Script基本语法格式 7
2.1.1 语言字符要求 7
2.1.2 程序注释 7
2.1.3 关键字 8
2.1.4 特殊字符的表示 11
2.2 变量及变量的作用域 11
2.2.1 全局变量及其作用域 11
2.2.2 局部变量( local) 及其作用域 12
2.2.3 同名的全局变量和局部变量的作用原则 12
2.3 类型 12
2.3.1 变量内部的类型 12
2.3.1.1 nil类型和逻辑判断 12
2.3.1.2 string类型及针对string的操作 12
2.3.1.3 数值类型及内建的数值计算函数 14
2.3.1.4 table类型 15
2.3.2 支持的各类型间的自动转换 15
2.3.3 显式转换类型 15
2.3.4 类型转换时的注意事项 16
2.3.5 sys_format函数 16
2.4 函数 18
2.4.1 函数定义 18
2.4.2 函数调用 19
2.4.3 对函数的限制 19
2.4.4 pcall 函数调用 19
2.5 运算符 20
2.5.1 逻辑运算符 20
2.5.2 算术运算符 20
2.5.3 字符串连接运算 20
2.5.4 赋值运算符 20
2.5.5 比较运算符 21
2.5.6 元运算符 21
2.5.7 运算符优先级 21
2.6 程序控制流程 21
2.6.1 顺序结构 21
2.6.2 If条件语句 21
2.6.3 do 块 22
2.6.4 while循环语句 22
2.6.5 repeat循环语句 22
2.6.6 一般for循环语句 22
2.6.7 用于遍历表的for循环语句( generic for) 23
2.6.8 return和break语句 23
2.7 基本容器table 24
2.7.1 table的基本概念 24
2.7.2 创立和初始化一个table 24
2.7.3 table下标的使用 24
2.7.4 table的”.”运算符 25
2.7.5 顺序存储元素和按key索引元素 25
2.7.6 table的insert操作 25
2.7.7 table的长度 25
2.7.8 table的遍历 26
2.7.8.1 全遍历( pairs) 26
2.7.8.2 自然数序遍历( ipairs) 26
2.7.9 table的sort算法( 仅对自然数序table有效) 26
2.8 参考Lua的基本语法 27
2.8.1 参考部分Lua的语法和Lua的参考资料 27
2.8.2 与Lua的重要不同 27
3. DTS API 27
3.1 DTS API简介 27
3.2 事件处理 27
3.2.1 详细的事件定义和事件属性设置 27
3.2.2 事件注册( Client) 28
3.2.3 事件回调详解 29
3.2.4 策略参数事件及其回调 29
3.2.5 事件内容设置和发送事件 30
3.2.6 事件存盘和读取保存事件( DynamicData) 30
3.3 DTS API 变量类型 31
3.3.1 用户定义的事件类型 31
3.3.2 策略参数类型( DTSParameter) 32
3.3.3 DTS系统类型 32
3.3.3.1 用于和一般Script逻辑交换信息的内部类型 32
3.3.3.2 时间类型 32
3.3.3.2.1 DTSDate 32
3.3.3.2.2 DTSTime 32
3.3.3.2.3 DTSMicroTime 33
3.3.3.3 用于下单和撤单的类型 33
3.3.3.3.1 DTSNewOrderAccess 33
3.3.3.3.2 DTSCancelOrderAccess 33
3.3.3.3.3 DTSBasket容器 33
3.3.3.3.4 发送Order( 下单、 撤单) 命令 34
3.3.3.3.5 内部修正命令 35
3.3.3.3.6 批量撤单接口 39
3.3.4 其它系统类型 39
3.4 存取数据库信息( StaticData) 39
3.4.1 从数据库取数据( _GetCommonData) 40
3.4.2 更新数据( _UpdateCommonData) 40
3.5 固化系统回调事件 41
3.5.1 Timer 41
3.5.1.1 启动/停止一个Timer 41
3.5.1.2 _OnEventTimer回调 41
3.5.2 收听市场价格 41
3.5.2.1 DTSPrice类型 41
3.5.2.2 注册要收听的Price 41
3.5.2.3 _OnEventPrice回调 42
3.5.2.4 停止收听价格 42
3.5.2.5 查找价格 42
3.5.3 收听市场逐笔行情价格 43
3.5.3.1 DTSQueuePrice类型 43
3.5.3.2 注册要收听的Price 46
3.5.3.3 _OnEventQueuePrice回调 46
3.5.3.4 停止收听分笔行情价格 46
3.5.3.5 查找分笔行情价格 47
3.5.4 监视仓位变化 47
3.5.4.1 DTSPosition类型 47
3.5.4.2 注册要监听的Position 47
3.5.4.3 _OnEventPosition回调 48
3.5.4.4 停止收听Position 48
3.5.5 监听下单回复 48
3.5.5.1 DTSExecution类型 48
3.5.5.2 _OnEventOrderResponse回调 49
3.5.6 监听成交信息 50
3.5.6.1 DTSMessageRecordAccess类型 50
3.5.6.2 选择需要监听的成交信息 50
3.5.6.3 _OnEventExecution回调 50
3.6 系统工具函数 51
3.6.1 取得策略信息 51
3.6.2 取得运行信息 51
3.6.3 取得用户信息 51
3.6.4 取得环境信息 51
3.6.5 取得错误详细描述 51
3.6.6 取得下单状态 51
3.6.7 取得第一条交易流水信息 51
3.6.8 生成全局唯一序列号 51
3.6.9 字符串加密 51
3.6.10 字符串解密 51
3.6.11 停止服务 52
3.6.12 写log的函数 52
3.7 MATLAB支持 52
3.7.1 启动MATLAB engine 52
3.7.2 判断MATLAB engine是否启动 52
3.7.3 设置MATLAB变量 53
3.7.4 获取MATLAB变量 53
3.8 一个完整的例子 53
4. 完整的语法规则 55
5. LUAEDITOR 55
5.1 DTS Lua Editor简介 55
5.2 LuaEditor功能介绍 57
5.2.1 增加一个新策略 57
5.2.2 语法检查 59
5.2.3 提交 59
5.2.4 发布 60
5.2.5 策略管理 61
5.3 LuaEditor使用技巧 62
5.3.1 LuaEditor对DTSScript语法关键字和符号能自己编辑颜色 62
5.3.2 语法错误的提示 62
6. 附录 63
6.1 DTSPrice field一览 63
6.2 DTSQueuePrice field一览 65
6.3 DTSNewOrderAccess field 一览 65
6.4 DTSCancelOrderAccess field 一览 67
6.5 参考资料 68

1. DTS策略编程语言简介
DTS系统策略编程语言是针对DTS程式化套利系统编写套利策略的策略编程语言, 提供灵活的, 具有一般性的编程语言接口, 能够为DTS系统编写高效的策略服务程序。
DTS策略编程语言综合了Lua和基于C++的DTS系统API接口, 最终将脚本翻译成C++服务器程序编译执行, 具有灵活高效的特点。
DTS策略编程语言由基本DTSScript和DTS系统API 两部分组成, DTSScript提供了基本用户编程逻辑的编写接口, DTSAPI提供了Server编程框架和用户策略逻辑对DTS后台系统数据的访问和使用接口。
本手册讨论这种语言的基本组成, 语法特点和具体使用方法, 同时介绍DTS客户端系统附带的LuaEditor的基本功能和使用技巧。
1.1 DTS策略编程平台及其原理
DTS策略编程平台主要由 DTSClient 下带的 DTS Script Editor( Lua Editor) 为客户端, 配合Strategy Control Server ( SCS) 为服务器端组成。用户编写的策略经过Client端 自带的Event打包解包库( EventCommunicator) , 打包成事件( Event) 发送给SCS, 由SCS内的Script Translator( L2C) 翻译成C++源代码后由GNU编译成策略服务器程序( SS) 。启动时, 由客户端发送启动Event给SCS控制启动SS, 并告知客户端SS端口及ip地址, 由客户端直接Socket链接SS获取策略服务; 停止时, 也由客户端发送停止Event给SCS控制结束SS服务。由于SS是直接编译运行的, 因此拥有效率高的特点; 同时每个客户有自己的策略服务器, 故每个服务器程序负载不会很重, 因此又有稳定, 快速的优点。

1.2 策略在系统平台上的生命周期和运行过程
1.2.1 策略生命周期
要完整地编写一个能用的策略服务器, 需要以下几个步骤:
1. 在Script Editor中编写完整的策略脚本。
2. 语法检查经过。
3. 提交SVN( 经过SCS) 成功。
4. 发布成功( 编译成功) 。

当策略被发布成功后, 用户能够在自己的策略管理界面上看到相应的策略; 用户能够选择加载需要的策略版本, 而且运行此策略; 策略一旦运行, 就开始提供既定的服务直到用户停止此策略。

策略的生命周期:

1.2.2 系统通讯和Event
DTS系统内部各个组成部件间的通讯都是建立在事件( Event) 处理上的, SCS, Client及SS之间信息的互换都是经过Event来完成的。
所有的Event都是统一格式存放的, 由包含在Client和Server端程序中的EventCommunicatorLib进行编码/解码。我们能够把Event看作是能够自定义字段的Message。
1.2.2.1 事件定义
所有用户事件都是能够在脚本中定义的。
以下例程定义了一个最简单的事件,

_DefineEventObject TestEvent _AS _Output
_DefFld("TestField",_String ,12);
_End

这个Event被定义为包含一个名叫”TestField”的字段, 字段类型为String类型, 长度为12。
事件定义和处理被做为一种DTSAPI的特性将在第3章 节中详细介绍。
1.2.2.2 输入输出事件
做为策略编程语言, DTSScript写好的脚本最终会被编译成策略服务器程序( SS) ; 相对SS来说是输入的Event被认为是输入事件, 例如Client向SS传送的参数能够被认为是一个In事件; 相反的, SS发送出去的事件被认为是Out事件, 如上面的例程就是定义了一个Out事件, 填写完整这个TestEvent后, SS能够创立一个Out事件的实例而且经过API将这个实例发送给所有监听这个事件的客户端( 可能是DTSClient端或者另外一个SS) 。
1.2.2.3 Buffer flag
由于系统中所有的通讯都被认为是事件处理, 也就是说所有的Server, Client和Server之间都是基于一方发送Out事件, 一方接收事件并触发回调来达到交换信息的目的, 这样, 为了能够使不同时间连接上来的客户端能够收到完整的Event流, Event被设计成带有一个Buffer标志, Buffer Flag一共有3种值, 0代表没有Buffer, 即后来连接上来的Client不会接收到连接上来之前Server已经发送过的Event; 1代表list类型的Buffer, 即后来连接上来的Client能够收到符合条件的自Server启动以来发送过的所有这种类型的Event, 而且是按事件顺序排列的; 2代表map类型的Event, 即后来连接上来的Client能够收到所有以某个字段为Key的Server已经发送过的Event, 重复Key的Event只保留最新的一个。
有了这2种buffer, 像诸如HDS( Historical Data Sever) 这种需要保留历史数据的服务器也能够用策略来描述了。
1.2.2.4 事件回调
对于接收别的Server或Client发送的事件一方的Server或Client, 只需要知道接收的是来自哪里的什么Event就能够了:
_RegisterEventObject(PortfolioID="P 0901", StrageyID=" 0901",EventID="TbtPEvent",condition="IssueCode#issueCode1,issueCode2,issueCode3")
使用_RegisterEventObject命令能够注册与什么策略服务器连接, 并取得什么Event。
当连接建立后, 每当那个策略服务器向外发送既定的Event, 接收方就会收到一条Event的回调:
_OnEventDefined(TbtPEvent evt)
… --用户逻辑
_End
收到Event回调后, 接收方就经过_OnEventDefined接口回调函数执行既定的用户逻辑。

1.2.3 策略参数和参数变化回调
在DTS2.0系统中, 所有的系统间交互都是经过Event完成的, 因此策略服务器的输入参数实际上也是一种特殊的Event。
输入参数Event做为一种特殊Event, 被设计为是同时拥有Input和OutPut属性的Event, 做为Input Event( 客户端向SS发送参数值) , 其Buffer Flag为0, SS只需要最新的参数; 而做为Output Event ( SS返回给客户端的Ack) , 其Buffer Flag为2, Key是一个永远为1的值, 这样能够保留最新一个Ack也能被Client收到, 防止Client重启后参数不同步的情况。
所有定义的参数都会在策略服务器中对应一个同名同类型的全局变量, 脚本中能够直接使用这些参数, 同时当参数值变化时, Client端发送来的参数变化也会被同步到这些全局变量中。
能够经过_DefineStrategyParameters关键字定义一组策略Server的参数, 并经过_OnEventParameterChanged(DTSParameter parameter) 回调来处理从客户端发送过来的参数变化:
_DefineStrategyParameters
_String issueCode1
_String issueCode2
_String issueCode3
_Number factor1
_Number factor2
_Number factor3
_Number constant
_String periodType
_String periodCount
_End

_OnEventParameterChanged(DTSParameter parameter)
… --用户处理逻辑
_End
1.2.4 运行策略
当策略被发布好以后, DTSClient中的策略管理页面也就有了相应的策略列表:

在需要启动此策略的模型中添加此策略:

启动策略:

停止策略:

2. DTS Script编程基础

2.1 DTS Script基本语法格式
2.1.1 语言字符要求
DTS Script中的名字( 变量名, 函数名, Table的字段名等标识符) 能够由任意字母, 数字和下划线组成, 可是不能以数字开头, 由于DTS API( 将在第3章详细介绍) 关键字以”_”开头, 因此应尽量避免使用”_”做为名称的起始符号, 以避免和系统关键字相互冲突。

DTS Script 是严格区分大小写的, 比如Text和text是不同的变量名, 能够用来代表不同的2个变量。

DTS Script中的字符串能够是以一对单引号( ’) 引起或者一对双引号( ”) 引起的一串字符, 内容里能够支持任意字符, 包括中文, 系统传输和翻译中不会改变字符的编码方式, 可是为了终端显示和避免编码解码方式不同带来的麻烦, 建议统一使用utf-8编码方式( 注意不要使用带signal的UTF-8编码, 头标记会被认为是非法字符) 。

对于‘_’开头的函数, 一般认为是系统保留的函数名, 建议尽量避免使用。

对于”DTS”开头的词, 一般认为是系统API数据类型, 请不要使用其命名一般变量和函数等。

名字, 函数调用和关键字, 算符等之间以空白分隔, 空白能够是任意的空白, 不限数量和种类, 包括 空格( ' ') , TAB( '\t') , 分割符( '\f') 和分行/回车( '\r\n', '\r', '\n') 。

DTS Script各个段( 声明, 结构, 语句等) 间能够以分号( ';') 分隔, 也能够以上述的空白分隔。可是有一种情况必须用分号分隔:
local a -- 1
b = ”b” -- 2
_String str = b --3
由于DTS API允许定义带类型限定( 如上例第3行, 限定str为_String类型) 的变量, 而某些自定义类型名也可能使用名字( Identifier) , 因此对上例中1, 2行中的a和b中的a, Script翻译器不能确定其是b的类型限定名还是一个变量定义, 因此这种情况下, a b间必须加一个分号分隔2个语句:
local a ; -- 1
b = ”b” -- 2
_String str = b --3

DTS Script支持各种数字表述方式, 包括整数, 负数( -) , 小数( 带小数点’.’) , 16进制数( 0x) 和科学计数法表示的数值:
3 3.0 3.1416 314.16e-2 0.31416E1 0xff 0x56

2.1.2 程序注释
DTS Script采用Lua的程序注释形式, 分为行注释和块注释2种:
DTS Script使用’--‘ 来表示行注释, 例如:
a = 'alo\n123\"' -- Assign ‘alo\n123\"’to a
DTS Script 采用 ’--[[‘ ‘]]’ 对来表示块注释, 例如:
--[[ DTS Script Comment
CopyRight DragonSoft]]

2.1.3 关键字
DTS Script 关键字分为一般关键字, 运算符和系统API关键字3部分。

关键字不能当作名字( 标识符) 使用。拥有系统给定的含义。

DTS Script 一般关键字有:
关键字
含义
关键字
含义
关键字
含义
关键字
含义
and
逻辑与
break
跳出循环
do
块开始
else
非条件
end
块结束
false
布尔假
for
For循环
function
函数声明
in
Table in
local
本地声明
nil
空
not
逻辑否
repeat
Repeat
return
返回
then
Then
true
真
while
While
elseif
else if
if
条件语句
or
逻辑或
until
Repeat

注意:
1. nil 表示DTS Script的空, 与NULL意义相近但不是NULL。
2. elseif 为连写的else if, 和其它语言不同, 不能写成分开的else if。

DTS Script 运算符和关键符号:
关键符号
含义
关键符号
含义
关键符号
含义
HUGE_VAL
最大数
+
加号
-
减号
*
乘号
/
除号
%
取余
^
乘方
=
赋值
==
等于
～=
不等于
<=
小于等于
>=
大于等于
>
大于
<
小于
(
小括号左
)
小括号右
[
方括号左
]
方括号右
{
大括号左
}
大括号右
;
分号
,
逗号
.
点号
..
字符串连接
…
不定参

DTS API 关键字:
1. DTS 开头的标识符:
DTS 开头的标识符表示DTS系统内部类型, 不能做为名字( 标识符) 使用, 例如:
DTSBasket basket = _CreateBasket()
其中DTSBasket表示basket 是一个DTSBasket类型的变量, 与一般类型( 不带类型定义的变量) 不同, 每种DTS系统内部类型的实例都拥有自己特有的方法和构造方式, 这部分请参见第3章和第6章。

2. sys_ 开头的函数名:
sys_ 开头的函数都是系统内建函数, 也就是系统内部提供的已经写好的函数, 有自己的用法和功能。如: sys_format(”%f”, 3.14)输出一个STRING型的”3.14”; 这部分函数会在以后的各节中一一列举其形式和功能。

3. API 接口关键字
类型关键字:
关键字
对应类型
关键字
对应类型
关键字
对应类型
_Boolean
bool
_Int
int
_Decimal
BDecimal
_BigInteger
BBigInteger
_String
BString
_Double
double
事件字段类型:
关键字
对应类型
关键字
对应类型
_Boolean
int
_Number
double
_String
BString
_Meta
char*

事件类型关键字:
关键字
事件类型
关键字
事件类型
_Input
对SS来说为输入事件
_Output
对SS来说为输出事件

事件时间Key类型:
关键字
含义
关键字
含义
关键字
含义
_EventYearType
按年
_EventMonthType
按月
_EventWeekType
按周
_EventDayType
按日
_EventMinuteType
按分
_EventOtherType
其它

文件索引类型关键字:
关键字
含义
关键字
含义
关键字
含义
_DataYearType
按年
_DataMonthType
按月
_DataWeekType
按周
_DataDayType
按日
_DataOtherType
其它

数据库操作辨识符:
关键字
含义
关键字
含义
关键字
含义
_Insert
插入
_Modify
修改
_Delete
删除

DTS API 中的其它关键字:
_DefineEventObject 定义一个事件。
_AS 定义事件类型( in、 out) 。
_End 回调段结束符。
_DefKeyField 定义事件主键。
_DefFld 定义事件字段。
_SetBufferedFlag 定义事件Buffer Flag。
_GetBufferedFlag 得到事件Buffer Flag。
_SetDataType 设置事件数据类型。
_GetDataType 得到事件数据类型。
_SetDataInterval 设置事件数据发送间隔。
_GetDataInterval 得到事件数据发送间隔。
_SetTimeKey 设置事件时间键。
_GetTimeKey 得到事件事件键。
_SetFld 设置事件字段值。
_GetFld 得到事件字段值。
_CreateEventObject 创立一个事件实例。
_CreateDynamicData 创立一个动态数据。
_GetFileType 得到文件类型。
_SaveData 保存至文件。
_Clear 清空数据。
_GetDynamicData 得到保存的动态数据, 和OnDynamicData为同步回调。
_OnDynamicData 得到动态数据的回调。
_GetCommonData 获取静态数据, 和OnCommonData为同步回调。
_OnCommonData 得到静态数据的回调。
_UpdateCommonData 更新、 插入、 删除静态数据。
_DefineStrategyParameters 定义策略服务器参数。
_OnEventParameterChanged 策略服务器参数变化回调。
_RegisterEventObject 注册事件。
_OnEventDefined 事件回调。
_EventName 事件回调名字标识。
_EventID 事件ID标识。
_OnEventTimer 定时器回调。
_EndTime 定时器终止事件标识。
_Interval 定时器时间间隔标识。
_TimerName 定时器名字标识。
_OnEventPrice 价格回调。
_PriceName 价格函数名字标识。
_IssueCode 证券号码标识。
_MarketCode 市场标识。
_OnEventPosition 仓位变化回调。
_OnEventExecution 成交回调。
_OnEventOrderResponse 下单回复回调。
_RegisterExecution 注册监听成交。
_SendToClients 发送事件给客户端( 监听者) 。
_Stop 停止策略服务。
_RegisterPrice 注册监听价格。
_StopPrice 停止监听单个价格。
_StopAllPrice 停止监听所有价格。
_RegisterPosition 注册监听仓位变化。
_StopPosition 停止监听仓位变化。
_StartTimer 启动定时器。
_StartTime 定时开始时间标识。
_MaxNumber 定时器最大跳数标识。
_StopTimer 停止定时器。
_createPortfolioOrders 得到模型下所有Order的Basket。
_SendOrders 发送Order( 下单、 撤单等) 。
_CancelOrders 撤单( 已废止, 现在使用_SendOrders撤单) 。
_GetPortfolioID 取得模型ID。
_GetStrategyVersion 取得策略版本号。
_GetStrategyID 取得策略号。
_GetPortfolio 取得模型数据。
_GetDealerID 取得用户ID。
_GetPortfolioContent 取得模型信息。
_GetFileRoot 取得动态数据文件存放的根目录。
_GetHostname 取得主机名。
_GetServicePort 取得服务端口。
_GetProcessID 取得服务进程号。
_GetWorkstationNo 取得服务器号。
_GetStartTime 取得服务开始事件。
_CreateBasket 创立一个篮子( basket) 。
_CreateBasketCancelBasket 创立一个篮子撤单的篮子( basket) 。
_CreateNewOrder 创立一个空的NewOrder, ( 下单用) 。
_CreateCancelOrder 创立一个空的CancelOrder, ( 撤单用) 。
_CreateManualNewAccept 创立一个ManualNewAccept, ( 无参数时表示创立一个空容 器, 有参数时表示创立一个用于补委托的内部修正命令) 。
_CreateManualNewReject 创立一个ManualNewAccept, ( 撤消委托用)
_CreateManualExecution 创立一个ManualExecution, ( 无参数时表示创立一个空容 器, 有参数时表示创立一个用于补成交的内部修正命令) 。
_CreateCancelExecution 创立一个ManualExecution, ( 撤消成交用) 。
_CreateGlobalUniqueKey 生成一个全局唯一序列号。
_CreateAESEncrypt 对字符串进行加密。
_CreateAESDecrypt 对字符串进行解密。
_DestroyBasket 销毁一个Basket。
_WriteAplLog 写入APL log。
_WriteErrorLog 写入Error log。
_GetNowTime 取得当前系统时间( 精确到秒) 。
_GetNowMicroTime 取得当前系统时间( 精确到微秒) 。
_GetNowDate 取得当前系统日期。
_onSubmitStatusChange 能够下单状态回调。
_GetShmOrderDetail 根据内部委托号取得对应下单状态。
_GetFirstShmMessage 根据内部委托号取得对应下单的第一条交易流水信息。
_GetLastError 取得最近一次错误的详细描述。

API关键字代表的函数和回调的用法和作用将在第3章做详细介绍。

注意: 因为最终将会被翻译成C++编译执行, 因此所有C++的关键字都是DTS Script的隐式关键字, 不能够被做为名字( 标识符) 使用, 如 int, long, string, double, default, continue, switch等等。

2.1.4 特殊字符的表示
DTS Script中String下的一些控制字符和被用作标识符而不能使用的字符的表示, 和其它语言一样, 使用’\’做为转义符, 例如:
‘\’’ 表示 ‘ 。
‘\”’ 表示 ” 。
‘\\’ 表示 \ 。
‘\n’ ‘\r’ ‘\r\n’表示回车, ‘\t’ 表示TAB等。

2.2 变量及变量的作用域
变量分为全局变量和局部变量, 有不同的作用域和定义方式。

2.2.1 全局变量及其作用域
在任何地方定义一个一般变量, 这个一般变量都会被认为是一个全局变量, 例如:
a = 1
if a == 1 then
b = 2
else
b = 1
end
这里a 和 b都是全局变量, 即使出了if块, b依然有效。如果在end后将b记入log, log中将