发布时间 : 星期二 文章MCGS系统内部函数参考手册更新完毕开始阅读a9bdabd9998fcc22bcd10dd7
数据对象操作函数
!AnswerAlm(DatName)
函数意义：应答数据对象DatName所产生的报警。如对应的数据对象没有报警产生或已经应答，则本函数无效。
返 回 值：数值型，=0为操作成功；<>0为操作失败。 参 数：DatName，数据对象名；
实 例：!AnswerAlm(电机温度)，应答数据对象“电机温度”所产生的报警。 !ChangeDataSave(Datname，n)
函数意义：改变数据对象Datname存盘的周期。 返 回 值：数值型，=0为操作成功；<>0为操作失败。 参 数：Datname，数据对象名； n，数值型，以秒表示的存盘间隔时间
实 例：ChangeDataSave(温度，5)， 温度的存盘间隔时间为5秒 !ChangeSaveDat(DatName，Num1，Num2)
函数意义：改变数据对象DatName所对应存盘数据的存盘间隔，把Num1小时以前的存盘数据（以当前时间为0点）的存盘间隔改为Num2秒。本操作只对组对象有效，对单个的数据对象无效。当DataName =空字符，或Num1=0或Num2=0时，本操作无效。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：DatName：数据对象名。
Num1：数值型时间量，单位：小时。本函数用Num1<0的一些数值来表示一些特殊意义的操作：
=-1 改变当天对应数据对象所有存盘数据的存盘间隔； =-2 改变昨天对应数据对象所有存盘数据的存盘间隔； =-3 改变本星期对应数据对象所有存盘数据的存盘间隔； =-4 改变上星期对应数据对象所有存盘数据的存盘间隔； =-5 改变本月对应数据对象所有存盘数据的存盘间隔； =-6 改变上个月对应数据对象所有存盘数据的存盘间隔； Num2：数值型时间量，新的存盘间隔，单位：秒。
实 例：! ChangeSaveDat(电机1， -2， 5)，把组对象“电机1”对应的存盘数据中昨天的存盘数据的存盘间隔改为5秒钟。 !CopySaveDat(Tdb,Sdb,TabName,TimeField,Flag ) 函数意义：拷贝数据库中数据表的数据
返 回 值：开关型，返回值=0：调用正常；返回值<>0：调用不正常。
5
参 数：Tdb，目标数据库名；Sdb，源数据库名；TabName，数据表名； TimeField，定义的时间字段名；Flag，拷贝方式，0：覆盖拷贝；1：添加拷贝。 实 例： ！CopySaveDat（Tdb，Sdb，TabName，TimeField，0），将数据库Sdb中表TabName中的数据拷贝到数据库Tdb中，表名仍是TabName，定义的时间字段为TimeField，拷贝方式为覆盖拷贝。 !DelAllSaveDat(DatName)
函数意义：删除数据对象DatName对应的所有存盘数据。 返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：DatName，数据对象名。
实 例：! DelAllSaveDat(电机温度) ，删除数据对象“电机温度”对应的所有存盘数据。
!DelAllAlmDat（DatName）
函数意义：删除数据对象DataName对应的所有报警存盘数据。注意，此函数不能用来删除组对象所对应的报警存盘数据。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：DatName：数据对象名；
实 例：！DelAllAlmDat（电机温度），删除数据对象“电机温度”对应的所有报警存盘数据
!DelAlmDat(DatName，Num)
函数意义：删除数据对象DataName对应的报警存储数据中最早Num小时内的报警存储数据，如Num<=0或DatName=空字符，则该函数无效。 返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：DatName：数据对象名； Num：数值型时间值，单位：小时。
实 例：! DelAlmDat(电机温度，1)，删除数据对象“电机温度”对应的报警存盘数据中最早1小时内的数据。 !DelSaveDat(DatName，Num)
函数意义：删除数据对象DataName对应的存盘数据中最早Num小时内的存盘数据，如Num<=0或DatName=空字符，则该函数无效。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：DatName：数据对象名； Num：数值型时间值，单位：小时。
实 例：! DelSaveDat(电机温度，12) ，删除数据对象“电机温度”对应的存盘数据中最早12小时内的数据。
6
!EnableAlm(name，n)
函数意义：打开/关闭数据对象的报警功能。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：name，变量名；
n，数值型，1表示打开报警，0表示关闭报警
实 例：!EnableAlm(电机温度，1)， 打开电机温度的报警功能 !EnableDataSave(name，n)
函数意义：打开/关闭数据对象的定时存盘功能。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：name，数据对象名；
n，数值型，1表示打开定时存盘，0表示关闭定时存盘 实 例：!EnableDataSave(温度，1)， 打开温度的定时存盘 !GetAlmValue(DatName，Value，Flag)
函数意义：读取数据对象DatName报警限值，只有在数据对象DatName的“允许进行报警处理”属性选项被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用Flag来标识读取何种报警限值。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：DatName：数据对象名。
Value：DataName的当前的报警限值，数值型。 Flag：数值型，标志要读取何种限值，具体意义如下： =1下下限报警值； =2 下限报警值； =3 上限报警值； =4 上上限报警值； =5 下偏差报警限值； =6 上偏差报警限值； =7 偏差报警基准值；
实 例：! GetAlmValue(电机温度， Value， 3)，读取数据对象“电机温度”的报警上限值，放入数值型数据对象Value中。 !GetEventDT(EvName)
函数意义：返回当前事件和上一次事件之间的时间差，单位为秒。 返 回 值：数值型。返回的时间差 参 数：EvName，事件变量名，事件型。
7
实 例：!GetEventDT(EvName)，取事件变量EvName当前事件和上一次事件之间的时间差，单位为秒。 !GetEventP(EvName)
函数意义：取到当前事件的附加说明字符串。 返 回 值：字符型。返回的附加说明字符串。 参 数：EvName，事件变量名，事件型。
实 例：!GetEventP(EvName) ，取事件型变量EvName的当前事件的附加说明字符串。
!GetEventT(EvName)
函数意义：取到当前事件产生的时间，以秒为单位，相对于1980年以来的秒数。如没有事件产生，返回-1。 返 回 值：数值型。
参 数：EvName，事件变量名，事件型。
实 例：!GetEventT(EvName)，取事件型变量EvName的当前事件产生时刻。 !MoveAlmDat(DatName，FileName，Num1，Num2，Flag)
函数意义：把数据对象DatName所对应的报警存盘信息中的第Num1小时到Num1+Num2小时内（以当前时间为0点）的报警存盘信息提取出来，转存到FileName所指定的数据库文件中（Access数据库）。当DatName=空字符，或FileName=空字符，或Num2<0时，本函数无效。删除数据对象DatName对应的所有报警存储数据。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：DatName：数据对象名。
FileName：新的报警存盘文件名(包括路径)，字符型。
Num1：数值型时间量，单位：小时。本函数用Num1<0的一些数值来表示一些特殊意义的操作（此时Num2无效）： =-1 转存当天的所有报警信息存盘数据； =-2 转存昨天的所有报警信息存盘数据； =-3 转存本星期的所有报警信息存盘数据； =-4 转存上星期的所有报警信息存盘数据； =-5 转存本月的所有报警信息存盘数据； =-6 转存上个月的所有报警信息存盘数据； Num2：数值型时间量，单位：小时。 Flag：转存标志，数值型。
8