PI數(shù)據(jù)庫文檔說明

PI-Buffer使用文檔APINodeBuffer（數(shù)據(jù)緩存）起到了如下作用：當API節(jié)點與PI主節(jié)點失去通訊連接（如網(wǎng)絡故障或PI服務器的起停與維護）時，在這期間的數(shù)據(jù)可以存入緩存文件中，當連接重新建立時把這些數(shù)據(jù)依次寫入PI服務器中，以此確保了數(shù)據(jù)的完整性，提高了系統(tǒng)可靠性。API－Buffer設有三級緩存，第一級和第二級設置在內(nèi)存之中，第三級設置在硬盤上（默認位置C:\ProgramFiles\PIPC\DAT\APIBUF.DATXE"APIBUF.DAT"），寫入緩存采用先入先出（FIFO），順序為由第一級向第三級逐級寫入。讀取緩存中的數(shù)據(jù)全部在第一級緩存上完成，在第三級緩存中的數(shù)據(jù)被讀出的過程中，數(shù)據(jù)首先被移至了第二級緩存，接著移至第一級緩存被讀走。當API－Buffer停止運行時系統(tǒng)會合并第一二三級緩存內(nèi)容至處于硬盤上的第三級緩存處，以備后用。API－Buffer的配置在接口機上完成，在安裝了PI－API的接口機上使用PI-Buffer僅需要修改相關配置文件無需進行其他任何安裝步驟。打開PIPC目錄下的DAT文件夾，找到piclient.ini文件（如安裝在C盤，則默認位置為C:\ProgramFiles\PIPC\DAT\piclient.ini），通過配置piclient.ini文件中[APIBUFFER]段的參數(shù)完成對buffer的基本設置，如部分參數(shù)在文件中沒有顯示請手動添加，相關參數(shù)設置如下：BUFFERING=1：Buffer的可用標識，置1可用0不可用；PAUSERATE=2：當緩存為空時Buffering向PI中寫數(shù)據(jù)的等待時間（秒）；RETRYRATE=120：當與PI服務器失去連接后嘗試連接服務器的等待時間（秒）；MAXFILESIZE=1000000：第三級緩存（硬盤上）的文件最大空間（B）；MAXTRANSFEROBJS=10000：Buffering向PI寫數(shù)據(jù)時每次最大的事件數(shù)；BUF1SIZE=100000：第一級緩存（內(nèi)存上）的文件最大空間（B）；BUF2SIZE=50000：第二級緩存（內(nèi)存上）的文件最大空間（B）；SENDRATE=100：緩存向PI寫數(shù)的時間間隔（ms）；打開pilogin.ini文件（默認位置C:\ProgramFiles\PIPC\DAT\pilogin.ini），配置PI服務器信息：[Services]PI1=PI[Defaults]HELPFILE=D:\PIPC\HELP\pilogin.hlpPIServer=192.168.20.100PI1USER=piadmin[PINODEIDENTIFIERS]PI1=192.168.20.100,20066,5450配置PI-BUFFERSERVER服務打開控制面板>管理工具>服務，右擊PI-BUFFERSERVER服務打開其屬性頁，在常規(guī)選項卡里選擇啟動類型為自動，如圖1所示；在登陸選項卡里配置登陸身份，輸入擁有管理員權限的用戶名和密碼，如圖2所示。配置完服務后使PI－Buffer具有了開機自啟動的能力。圖1圖2Buffering的手動起動及停止啟動：使用pistart.bat文件（默認位置為C:\ProgramFiles\PIPC\BIN\pistart.bat）停止：使用pistop.bat文件（默認位置為C:\ProgramFiles\PIPC\BIN\pistop.bat）Buffering狀態(tài)查看工具可以使用bufutil.exe查看當前的緩存狀態(tài)，bufutil.exe的默認位置為C:\ProgramFiles\PIPC\BIN\bufutil.exe。運行該程序后出現(xiàn)如圖3所示界面，在Enterchoice后分別輸如1、2、3可以分別進入第一、二、三級緩存的狀態(tài)信息界面；輸入4停止緩存服務并退出bufutil.exe；輸入5推出bufutil.exe。下面以第一級緩存為例說明所顯示的主要狀態(tài)信息，如圖4所示，Mode：顯示了當前的緩存使用模式，“Single”表示當前只使用了第一級主緩存；“DualMemory”表示使用了內(nèi)存中的第一二級緩存；“DualMemoryandFile”表示同時使用了內(nèi)存中的一二級緩存和硬盤上的第三級緩存。Serverstatus：顯示了當前與PI服務器的連接狀態(tài)。Size：第一級緩存的大小。Unprocessedentries：當前緩存中的數(shù)據(jù)量。圖3圖4附：啟動Buffer服務時應先停用接口機上所有與PI有關的程序，啟動Buffer服務后再將它們重新啟動。另附所有具有緩存功能的API函數(shù)：piar_putarcvaluesxpiar_putarcvaluexpiar_putvaluepisn_putsnapshotpisn_putsnapshotspisn_putsnapshotqpisn_putsnapshotqxpisn_putsnapshotsxpisn_putsnapshotxpisn_sendexceptionqpisn_sen