【正文】 datTime （讀）歷史數(shù)據(jù)值的時間，歷史數(shù)據(jù)值的時間有三種方法表示： 絕對時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”，表示取某一確定時間的歷史數(shù)據(jù)值； 相對時間，時間格式為“DDHH:MM:SS”，意義為“天時：分：秒”表示取歷史數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時間向前減去所表示相對時間的那一時刻的歷史數(shù)據(jù)值。 dat) GetHisTagInt函數(shù)取歷史數(shù)據(jù)視圖中的一個整型數(shù)據(jù)。（注：歷史數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時間是在視圖建立時確定的，與取數(shù)據(jù)的時間無關(guān)。參 數(shù)viewID （讀）歷史數(shù)據(jù)視圖標(biāo)識。dat （寫）TAG點(diǎn)統(tǒng)計數(shù)據(jù)值。參 數(shù)viewID （讀）日統(tǒng)計數(shù)據(jù)視圖標(biāo)識。minTime （寫）最小值出現(xiàn)的時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”。tagName （讀）視圖中的一個TAG點(diǎn)名稱，字符串指針。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明在上述取日視圖統(tǒng)計數(shù)據(jù)的時間表示法中，如果取統(tǒng)計數(shù)據(jù)的時間選擇NULL，表示取視圖建立那一個天0小時到視圖建立那一時刻之間的實時數(shù)據(jù)最大值和最大值出現(xiàn)的時間，與取數(shù)據(jù)的時間無關(guān)；用相對時間表示時，相對時間中小時、分鐘和秒將被截掉，如“18:15:20”將被作為“10:0:0”處理，即取建立視圖的前一天0小時起一天內(nèi)的實時數(shù)據(jù)最大值和最大值出現(xiàn)的時間。因為僅有PV值保存統(tǒng)計數(shù)據(jù)，這里也可寫成： 點(diǎn)名.PV。GetDayStaTagMax long GetDayStaTagMax(long viewID, char* tagName, char* datTime, doubleamp。datTime （讀）要取的統(tǒng)計數(shù)據(jù)值的時間，時間有三種方法表示： 絕對時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”，表示取這一確定時刻所在日的實時數(shù)據(jù)平均值； 相對時間，時間格式為“DDHH:MM:SS”，意義為“天時：分：秒”表示取時統(tǒng)計數(shù)據(jù)視圖中數(shù)據(jù)結(jié)束時間向前減去所表示相對時間的那一時刻所在日的實時數(shù)據(jù)平均值。 dat)GetDayStaTagAverage函數(shù)取日統(tǒng)計數(shù)據(jù)視圖中一個TAG點(diǎn)的某一天實時數(shù)據(jù)的平均值。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。sTime （寫）數(shù)據(jù)的更新時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”。GetDataTagUpdateTime函數(shù)讀實時數(shù)據(jù)視圖中數(shù)據(jù)的更新時間。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。length （讀) TAG點(diǎn)參數(shù)字符型數(shù)據(jù)值長度。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。tagName （讀) 視圖中的一個TAG點(diǎn)參數(shù)的名稱，字符串指針。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失??；注：（函數(shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetDataTagReal long GetDataTagReal(long viewID, char* tagName, doubleamp。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。tagName （讀) 視圖中的一個TAG點(diǎn)參數(shù)的名稱，字符串指針。格式為： 點(diǎn)名.參數(shù)名.細(xì)目名。sTime （寫）數(shù)據(jù)的提交時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”?？赡艿臓顟B(tài)值及 其意義如下： Data_Success 1 數(shù)據(jù)成功提交 Data_NotChange 2 成功提交與前一值相同的數(shù)據(jù) Data_SourceError 5 由于數(shù)據(jù)源錯誤提交失敗 Data_UserLevelError 6 由于用戶級別錯誤提交失敗 Data_TagStateError 7 由于點(diǎn)狀態(tài)錯誤提交失敗 Data_ReadOnly 8 由于數(shù)據(jù)源只讀提交失敗 Data_HighLimit 9 發(fā)生超高限錯誤提交失敗 Data_LowLimit 10 發(fā)生超低限錯誤提交失敗 Data_OutputDisable 21 由于輸出禁止發(fā)生輸出失?。〝?shù)據(jù)寫入數(shù)據(jù) 庫但不能向外設(shè)輸出） Data_OutputHighLimit 22 由于輸出超高限發(fā)生輸出失敗（數(shù)據(jù)寫入數(shù) 據(jù)庫但不能向外設(shè)輸出） Data_OutputLowLimit 23 由于輸出超低限發(fā)生輸出失?。〝?shù)據(jù)寫入數(shù) 據(jù)庫但不能向外設(shè)輸出） Data_OutputModeError 25 由于輸出方式錯誤發(fā)生輸出失敗（數(shù)據(jù)寫入 數(shù)據(jù)庫但不能向外設(shè)輸出） Data_OutputStateError 26 由于輸出狀態(tài)錯誤發(fā)生輸出失?。〝?shù)據(jù)寫入 數(shù)據(jù)庫但不能向外設(shè)輸出）返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）GetDataTagCommitTime long GetDataTagCommitTime(long viewID, char* tagName, char* sTime) GetDataTagCommitTime函數(shù)讀實時數(shù)據(jù)視圖中數(shù)據(jù)的提交時間。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。tagName （讀) 視圖中的一個TAG點(diǎn)參數(shù)的名稱，字符串指針。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。sTime （寫）數(shù)據(jù)的修改時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。dataDesc （讀) 視圖中存在的TAG點(diǎn)參數(shù)名稱。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。dataID （讀) TAG點(diǎn)參數(shù)數(shù)據(jù)標(biāo)識。如果某個用戶被設(shè)成允許回送現(xiàn)場設(shè)備狀態(tài)，則它所建的每個視圖缺省情況下均被設(shè)成允許回送現(xiàn)場設(shè)備狀態(tài)，此時進(jìn)行視圖提交的話就會將數(shù)據(jù)回送到下位機(jī)（或現(xiàn)場設(shè)備）。這時候也可以把具體某一個視圖設(shè)成禁止回送現(xiàn)場設(shè)備狀態(tài)。參 數(shù)viewID （讀）數(shù)據(jù)視圖標(biāo)識。如果僅寫TAG點(diǎn)名稱，取這個TAG點(diǎn)所有參數(shù)發(fā)生的所有事件；如果寫成： TAG點(diǎn)名稱.參數(shù)名稱，取指定TAG點(diǎn)指定參數(shù)發(fā)生的所有事件。 viewID, char* database, char* tagDesc, long viewAttr, long count)CreateTagEventView函數(shù)建立單點(diǎn)事件記錄視圖。因為僅有PV值有報警數(shù)據(jù)，這里也可寫成： 點(diǎn)名.PV。 viewID, char* database, char* tagName, long viewAttr, long count)CreateTagAlarmView函數(shù)建立單點(diǎn)報警記錄視圖。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）說 明時統(tǒng)計數(shù)據(jù)是作為一種歷史數(shù)據(jù)保存的，到每小時的60分鐘結(jié)束時保存這個小時的時統(tǒng)計數(shù)據(jù)。因為僅有PV值保存統(tǒng)計數(shù)據(jù)，這里也可寫成： 點(diǎn)名.PV。database (讀) 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。count (讀) 視圖中每個點(diǎn)的數(shù)據(jù)個數(shù)。因為僅有PV值保存歷史數(shù)據(jù)，這里也可寫成： 點(diǎn)名.PV。database (讀) 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。count (讀) 視圖中記錄個數(shù)。database （讀） 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。在上述視圖統(tǒng)計數(shù)據(jù)結(jié)束時間表示法中，用絕對時間表示時，小時、分鐘和秒沒有意義，函數(shù)執(zhí)行時小時、分鐘和秒將被截掉，如“1997:7:309:24:12”，作為“1997:7:300:0:0”處理；用當(dāng)前時間表示時，最后一個數(shù)據(jù)是當(dāng)前日到當(dāng)前時間的統(tǒng)計數(shù)據(jù)，如果統(tǒng)計數(shù)據(jù)結(jié)束時間選擇NULL，當(dāng)前時間是1998年3月5日8時25分36秒，日統(tǒng)計數(shù)據(jù)視圖中最后一個數(shù)據(jù)是從1998年3月5日到1998年3月5日8時25分36秒的統(tǒng)計數(shù)據(jù)；用相對時間表示時，相對時間中小時、分鐘和秒將被截掉，如“19:8:20”將被作為“10:0:0”處理，即日統(tǒng)計數(shù)據(jù)視圖中最后一個數(shù)據(jù)是當(dāng)日前一天的數(shù)據(jù)。endTime (讀) 視圖統(tǒng)計數(shù)據(jù)結(jié)束時間，視圖數(shù)據(jù)結(jié)束時間有三種方法表示： 絕對時間，時間格式為“YYYY:MM:DDHH:MM:SS”，意義為“年：月：日時：分：秒”，表示視圖數(shù)據(jù)結(jié)束時間為某一確定時間； 當(dāng)前時間，用NULL時表示； 相對時間，時間格式為“DDHH:MM:SS”，意義為“天時：分：秒”表示視圖數(shù)據(jù)結(jié)束時間為當(dāng)前時間向前減去所表示的相對時間。dataDesc (讀) 視圖數(shù)據(jù)TAG點(diǎn)描述表，字符串?dāng)?shù)組指針。CreateDayStaView函數(shù)建立日統(tǒng)計數(shù)據(jù)視圖。count (讀) 點(diǎn)參數(shù)描述表中點(diǎn)參數(shù)個數(shù)。database (讀) 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。count (讀) 視圖報警中記錄個數(shù)。database （讀） 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。參 數(shù)viewID （讀）實時數(shù)據(jù)視圖標(biāo)識。 // , , } TIME_DESC 。參 數(shù)sTime （讀）ASCII時間字符串。 // , , } TIME_DESC 。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）AsciiTime long AsciiTime(TIME_DESC* bTime, char* sTime)AsciiTime函數(shù)將二進(jìn)制時間轉(zhuǎn)換成ASCII時間。tagName （讀）TAG點(diǎn)名稱數(shù)組，字符串?dāng)?shù)組指針。unit （讀） 單元號，0表示確認(rèn)所有單元TAG點(diǎn)報警。 第二部分 用戶編程接口（API）成員函數(shù)AckAlarm long AckAlarm(char* database, long area, long unit, long attr) 。用戶程序中如果要調(diào)用API，必須在程序中用include包含這兩個頭文件。連接命令如下：$clink 用戶程序程序名clink是編程環(huán)境中提供的一個命令，它完成用戶的C++程序與連接庫的自動連接。三、OPEN VMS操作系統(tǒng)C++編程環(huán)境中調(diào)用API在Alpha計算機(jī)OPEN VMS操作系統(tǒng)C++編程環(huán)境中，實時數(shù)據(jù)平臺提供了兩個頭文件和三個目標(biāo)模塊庫。用戶建立了CUserApi類的實例以后，就可以直接調(diào)用CUserApi類的成員函數(shù)實時數(shù)據(jù)平臺中的數(shù)據(jù)庫。C++語言用戶接口函數(shù)全部放在CUserApi類中，作為CUserApi類的成員函數(shù)。返回值的意義見各個函數(shù)中的說明。用戶程序在編譯以后要與實時數(shù)據(jù)平臺提供的兩個目標(biāo)模塊庫連接。文件分別名稱為：，其中分別包含了函數(shù)定義和符號定義?；蛘叻旁赪indows的system下。area （讀） 區(qū)域號，0表示確認(rèn)所有區(qū)域TAG點(diǎn)報警。參 數(shù)database （讀） 數(shù)據(jù)庫名，單數(shù)據(jù)庫系統(tǒng)為NULL。attr （讀） 數(shù)據(jù)庫屬性，說明確認(rèn)哪種數(shù)據(jù)庫的點(diǎn)，用下列符號表示： RTDB_ATTR_STANDARD 標(biāo)準(zhǔn)數(shù)據(jù)庫（缺省值)； RTDB_ATTR_SIMULATE 仿真數(shù)據(jù)庫。 long flag 。返回值：指示函數(shù)執(zhí)行狀態(tài)：不小于1的整數(shù)值 函數(shù)執(zhí)行成功；小于1的整數(shù)值 函數(shù)執(zhí)行失?。蛔ⅲ海ê瘮?shù)執(zhí)行失敗原因可根據(jù)返回值參閱附錄A）BinaryTime long BinaryTime(char* sTime, TIME_DESC* bTime)BinaryTime函數(shù)將ASCII時間轉(zhuǎn)換成二進(jìn)制時間。 long flag 。Commit函數(shù)向?qū)崟r數(shù)據(jù)平臺提交實時數(shù)據(jù)視圖中的數(shù)據(jù)。參 數(shù)viewID （寫） 報警記錄視圖標(biāo)識。viewAttr （讀） 視圖屬性，用下列符號表示：VIEW_ATTR_STATIC 靜態(tài)視圖（缺省值)；VIEW_ATTR_ACTIVE 動態(tài)視圖；VIEW_ATTR_STANDARD 標(biāo)準(zhǔn)視圖，數(shù)據(jù)來自系統(tǒng)數(shù)據(jù)庫（缺