Release Notes for the PI NovaTech D/3 (GSETID3) Interface ================================================================================ PI-IN-GSE-D3DB-NTI ================================================================================ General Notes: The Novatech D/3 interface allows the user to retrieve data from the D/3 DCS system. ================================================================================ ________________________________________________________________________________ Note: The following files are distributed with this release of OSIsoft’s Universal Interface (UniInt): Files installed to %PIHOME%\Interfaces\UniInt\ UniInt Interface User Manual.doc => User manual for UniInt UniInt4x Release Notes.doc => Release notes for UniInt UniInt Interface Message Logging.docx => New PI Message Logging information PIMessage.bat => Script to extract PI Message log message to a file. PIMessage_ReleaseNotes.txt => ReleaseNotes for PIMessage.bat *****NOTICE**********NOTICE**********NOTICE**********NOTICE**********NOTICE***** * * * Interfaces based on UniInt version 4.5.0.x and later will now log all * * messages to the PI message log instead of PIPC.log. Interfaces based on * * earlier versions of UniInt will still write their messages to the PIPC.log * * file.The PIPC.log file was a text file and could be viewed using an * * application like Notepad. The new messages which are written to the PI * * message log can only be viewed using the pigetmsg utility. This utility is * * installed along with the PINet Manager and the PI Message Subsystem and can * * be found in the PIPC\adm folder on a PI Interface (PINs) node or the PI\adm * * folder on a PI Server Node. The format of the messages will differ slightly * * depending on which version of the PINet Manager and PI Message Subsystem * * have been installed on the interface node. See the UniInt Interface Message * * Logging.docx file for more information. * * * *****NOTICE**********NOTICE**********NOTICE**********NOTICE**********NOTICE***** ________________________________________________________________________________ -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= SETUP Requirements -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Before Installing the PI Novatech D/3 (GSETID3) Interface Installation of an OSIsoft product relies on the presence of operating system components such as the Microsoft .NET Framework. OSIsoft product setup kits check for needed prerequisite software during installation. If not found, the installation will stop and the user will be prompted to install prerequisites. OSIsoft Prerequisite setup kits are available for three target operating system environments regardless of whether a 32 or 64 bit application will be installed: · Online: Recommended for installation on a computer connected to the Internet. Portions of this kit connect to Microsoft sites and download Microsoft .NET components for the operating system on which it is run. · Standalone: Recommended for installation on a computer that can not connect to Microsoft downloads or if such connection is not desirable. This kit does not connect to download sites, but is much larger. · Legacy: For older operating systems or product distributions that do not require the .NET Framework 3.5. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= ================================================================================ Current Version: Interface 4.31.5.66 UniInt 4.5.2.0 Last Official Release - Version 4.31.2.17 ================================================================================ Self Extracting Exe Includes: PI Novatech D/3 Interface ICU Control 4.30.0.0 PI GenericNames DLL 1.2.26.0 PI SDK 1.3.8.388 (including PI API 1.6.1.17) PI Buffer Subsystem 3.4.375.84 ================================================================================ Revision History ________________________________________________________________________________ ================================================================================ Version 4.31.5.66 (7/14/2011) BPayne/MMoore UniInt: 4.5.2.0 ================================================================================ UniInt Changes: --------------- PLI# 24589OSI8, 24540OSI8 This interface was built against a new version of UniInt 4.5.2.0. For detailed information regarding changes please see the PLI numbers listed above in the "UniInt4x Release Notes.pdf" file located in the PIPC\Interfaces\UniInt\ directory. Bug Fixes: ---------- PLI# 21906OSI8 Fixed a memory leak caused by the interface flipping from primary to secondary mode when using Phase 1 UniInt failover. PLI# 21915OSI8 Fixed an issue where the interface would crash on a system where tags are deleted from the D3 DBA. PLI# 22350OSI8 Fixed an issue where the interface would have stale tags after tag edits on the D3 DBA. ________________________________________________________________________________ ================================================================================ Version 4.31.2.17 (1/30/2009) BPayne UniInt: 4.4.3.0 ================================================================================ Bug Fixes: ---------- PLI# 18190OSI8 Fixed an issue where the interface was not properly setting the device status for health tags. PLI# 18785OSI8 Added UniInt phase II failover. ________________________________________________________________________________ ================================================================================ Version 4.30.1.15 (12/14/2007) BPayne UniInt: 4.3.2.3 ================================================================================ Enhancement: ------------ PLI# 16093OSI8 Support Device Status Tags The Novatech GSE D/3 Interface is built with UniInt 4.3.2.3. New functionality has been added to support health tags. The Health tag with the point attribute Exdesc = [UI_DEVSTAT], is used to represent the status of the source device. The following events can be written into this tag: a) "1 | Starting" - the interface is starting. b) "Good" - the interface is properly communicating and reading data from the Novatech D/3 DBA. c) The following event represents a failure to communicate with the Novatech D/3 DBA (the system is not running): "3 | 1 device(s) in error | Interface is not Connected" d) "4 | Intf Shutdown" - the interface is stopped. Please refer to the UniInt Interface User Manual for more information on how to configure health points. Bug Fix: -------- PLI# 15928OSI8 Fixed an issue where the interface could not be run with the GSE D3 Sequential DBA. ________________________________________________________________________________ ================================================================================ Version 4.30.0.12 (7/11/2006) BPayne UniInt: 4.2.3 ================================================================================ Enhancements: ------------- PLI# 10669OSI8 Compile and link with UniInt files to support UniInt based failover. UniInt provides support for a hot failover configuration which results in a no data loss solution for bi-directional data transfer between the PI Server and the Data Source given a single point of failure in the system architecture. Note: ----- The only version of this interface that was tested was against the D/3 12.1 continuous database. Please contact OSIsoft Inc., before using this interface with other versions or the D/3 sequential database. ________________________________________________________________________________ ================================================================================ Version 4.29.0.0 (6/3/2003) CGoodell ================================================================================ Added executables for 10.01 and 11.02 for Windows. No source code changes were made to the interface except for using the include files from GSE for the specific versions. ________________________________________________________________________________ ================================================================================ Version 4.27 (4/23/2002) BPayne ================================================================================ Enhancements: ------------- String output Fixes: ------ Fixed memory leak that was limiting number of tags that the interface could add. ________________________________________________________________________________ ================================================================================ Version 4.26 (4/1/2002) CGoodell ================================================================================ Create separate executables for running against a version 10.0 and a 10.2 D3 system. The filename for the executable for version 10.0 is tid3.exe and for running against D3 version 10.2 the executable is tid3_10_2.exe. No changes were made to the source code of the interface; instead the include files and the libraries from GSE to which the interface connects are different. (This is similar to what is done for the VMS versions of the interface.) This version also allows the user to output strings to the D3. ________________________________________________________________________________ ================================================================================ Version 4.25 (11/6/2001) CGoodell ================================================================================ Clear istat for string tags before each get_vseq call -- When it was not cleared, an error in one string was propagated to all other string tags and never recovered. ________________________________________________________________________________ ================================================================================ Version 4.22 (5/29/2001) CGoodell ================================================================================ Affected VMS only fixed typo where currval was set to UNIINT_BAD_INPUT initialize istat before calling check_float_value. ________________________________________________________________________________ ================================================================================ Version 4.21 (4/19/2001) CGoodell ================================================================================ Check_float_value should only be used on Alpha VMS so version 4.20 did not work on VAX. ________________________________________________________________________________ ================================================================================ Version 4.10 (9/12/2000) CGoodell ================================================================================ Fix check_float_value change call to check_float_value. ________________________________________________________________________________ ================================================================================ Version 4.7 (7/25/2000) CGoodell ================================================================================ Send DIN output with devcmd instead of plf. ________________________________________________________________________________ ================================================================================ Version 4.6 (7/12/2000) CGoodell ================================================================================ Added /DB=20 to print digital output values ________________________________________________________________________________ ================================================================================ Version 4.5 (3/27/2000) CGoodell ================================================================================ Changed debug to tid3_debug. Added sequence status errors if debug == 11 and limit debug printout. ________________________________________________________________________________ ================================================================================ Version 4.3 (3/27/2000) CGoodell ================================================================================ Add /DB=11 for printing indices to track NaN errors. ________________________________________________________________________________ ================================================================================ Version 4.0 CGoodell ================================================================================ 9-Sep-1999 Port to NT for D3 version 10.0. 13-Sep-1999 Changed location2 from short to long. Changed scan_class from short to long. Added ifdef around vms-specific code. 21-Sep-1999 Use UniInt 3.x which will handle strings.Don't use inteltovax on NT. 22-Sep-1999 Use set_lock_ast on NT instead of get_share_lock. 28-Sep-1999 Need pfnDevUniintOptions = dev_uniint_options.NT _toupper does NOT work; switched to toupper. 8-Oct-1999 Only exit when KStime = 0 /KS on command line. ________________________________________________________________________________ ================================================================================ Version 3.24 (7/19/1999) CGoodell ================================================================================ Add status & retry_time to GLF structure Add wait time to /KS switch (/KS=n where n is minutes to delay) If /KS or /KS=0, then exit for ANY GLF error Don't immediately retry a GLF call after ________________________________________________________________________________ ================================================================================ Version 3.23 (7/8/1999) CGoodell ================================================================================ /KS didn't work as hoped; the errors returned are not -69 Added kill for any error in from GLF call. This only affects continuous database points. ________________________________________________________________________________ ================================================================================ Version 3.22 (6/11/1999) GMatzen ================================================================================ Add the /KS command line argument to allow user to bypass recovery from -69 errors from GLF call. This only affects continuous database points. ________________________________________________________________________________ ================================================================================ Version 3.21 (5/19/1999) CGoodell ================================================================================ dev_hardware_init was still requiring a processname for /hw. get_source_tag now uppercases the blkno so searches are NOT case sensitive. ________________________________________________________________________________ ================================================================================ Version 3.20 ================================================================================ Added the /val=# command-line parameter and -1 to -3 in location 2 to control what to do when an output tag has a digital state PI value. ________________________________________________________________________________ ================================================================================ Version 3.19 ================================================================================ Release with object files. Continuous float tags do not need their output values converted to Intel float. ________________________________________________________________________________ ================================================================================ Version 3.18 ================================================================================ When /hw causes a D3 shutdown to stop the interface, no digital state will get written to input tags. ________________________________________________________________________________ ================================================================================ Version 3.13 ================================================================================ Check DFLG (not ALMCT) for DEV_. ________________________________________________________________________________ ================================================================================ Version 3.12 ================================================================================ Fixed checking of ALMCT bits. ________________________________________________________________________________ ================================================================================ Version 3.09 ================================================================================ IO_TIMEOUT for all tags in recovered list. ________________________________________________________________________________ ================================================================================ Version 3.08 ================================================================================ If a tag has been removed from scanning because of a -69, try to add that tag back in a few times. ________________________________________________________________________________ ================================================================================ Version 3.02 ================================================================================ Added /bl command line parameter to have NULL strings be blank default is to leave them NULL. ________________________________________________________________________________ ================================================================================ Version 3.0 ================================================================================ Recover from GLF -69 errors by rebuilding lists. ________________________________________________________________________________ ================================================================================ Version 2.08 ================================================================================ Default field separator to a comma. Default temp file name to pitid3tempfile.txt. Always use a temp file. ________________________________________________________________________________ ================================================================================ Version 2.07 ================================================================================ Added /fs command line parameter to define field separator for batch files. ________________________________________________________________________________ ================================================================================ Version 2.06 ================================================================================ Fixed bug in outputting PI float to D3 float. ________________________________________________________________________________ ================================================================================ Version 2.00 ================================================================================ If GLF errors, make incremental calls in an attempt to isolate bad tag. ________________________________________________________________________________ ================================================================================ Version 1.15 (7/8/1999) CGoodell ================================================================================ Version 1.15 If dirty zero found, set digital state to BAD INPUT. ________________________________________________________________________________ ================================================================================ Version 1.13 ================================================================================ Check for on/off status of timers: flip bit when on. Refuse (not failure) tag not for this node so no message goes to pimesslog.txt. Take care of alpha dirty zero that was causing some floating point values to crash the interface. ________________________________________________________________________________ ================================================================================ Version 1.08 ================================================================================ Fix memory leak in dev_remove_tag: the leak was causing the interface to crash when tags were deleted. Don't halt if string file can't be opened. If file error,write tagname, string, and timestamp to pimesslog.txt. ________________________________________________________________________________ ================================================================================ Version 1.07 ================================================================================ Added exception reporting for strings. Added the /temp command line parameter. ________________________________________________________________________________ ================================================================================ Version 1.06 ================================================================================ Added recipe variable and string support. To process strings, the batch file interface is used on the PI 3 home node to read files which need to be FTPed from the PINet node. ________________________________________________________________________________ ================================================================================ Version 1.04 ================================================================================ Remove limit of 1024 for number of digital states.This is necessary when connected to a PI 3 home node. ________________________________________________________________________________ ================================================================================ Files installed by Interface: -------------------------------------------------------------------------------- Directory: %PIHOME%\Interfaces\TID3\ -------------------------------------------------------------------------------- TID3.exe Interface Executable TID3.pdb Interface Debug File TID3.bat_new Sample startup command file PI_GSETID3.docx Interface manual PI_GSETID3_ReleaseNotes.txt Release notes; this file PI.MDL.txt Sample D/3 SABL program for configuring failover control tags UniInt_Failover_Sample_PI_Tags.xls Interface specific version of the failover PI tags. UniInt_Failover_DigitalSet_UFO_State.csv Digital state set for PI failover state tags. Total number of files: 8 ================================================================================ ________________________________________________________________________________ Please report any issues to OSIsoft technical support. OSIsoft, LLC. 777 Davis St., Suite 250 San Leandro, CA 94577-0427 USA www.osisoft.com ________________________________________________________________________________