In general, upgrading TSENTRY from one version to another requires the following steps:

• Stop any running TSENTRY processes

• Backup existing TSENTRY files

• Install new version of TSENTRY

  • For versions 2.29 and below, copy new \tpriNtRt\ directory over existing directory

  • For versions 3.00 and above, run the install wizard

• Rebuild all application processes, screens, and the data dictionary

In some cases, however, additional changes are required; these are listed below by version.  In some cases some steps must be taken before performing the above instructions, so please read below before continuing.  If upgrading across more than one version (e.g. v1.4 to 2.0), steps for intermediate versions must also be performed.

The major TSENTRY versions reflect support for the various versions of the Microsoft Visual Studio compiler:

Changes:

• Automatically set Windows timer resolution for tasks with rep rates less than 50 ms (TSEN-20)

• Added a ValidatingClick event to SelectButton, CmdButton, LinkLabel, and Shape (TSEN-22)

• Added deployment of OPC library and Client+Server applications (for x86 only)

• Updated RTX64 4.0 à → 4.1

Changes:

• Added TstartMgr utility

• Fixed Tsecurity installer to no longer create a local account named LOCALSYSTEM

Changes:

• Added overload to TPRI.Process.GetState(..) in TPRI.NtRtControl.dll to specify application name

• Fixed converting legacy trend data files

• Removed support for v1.70 and older trend data files

• Enable graphics double-buffering for LevelDisplay HMI control

• Fixed 64-bit issue in ControlLogix producer/consumer library

Changes:

• Updated versioning to 4 digits (Major.Minor.Build.Rev)

Changes:

• Added support for RTX64 4.0

• Updated tpriProcMgr tracking of active processes

• Created new wrapper methods in tpriNtRtEx.dll

  • tpriCreateProcess

  • tpriOpenProcess

  • tpriGetExitCodeProcess

  • tpriCloseHandle

  • tpriTerminateProcess

• Added various enhancements to the data dictionary & GsmPifBld:

  • Added support for bool types

  • Added support for bitfields

  • Added support for embedded structures

• Added various enhancements to the GsmCsBld utility:

  • Added support for bool types & bitfields

  • Added helper methods to every structure class:

    • Allocate()

    • Zero()

    • Copy(..)

  • Added FromHexString(..) extension for strings

• Added new tpriTimer functions:

  • Act*Timer(..)

  • Exp*Timer(..)

Changes:

• Fixed variable entry on TriggerMgr screens

Changes:

• Fixed trending structures size for compatibility between 32-bit and 64-bit library versions

• Added Cryptor class to NtRtControl

• Made various changes in the GsmCsBld utility:

  • Add IEnumerable<T> interface to array classes

  • Add comments to generated C# code using data dictionary variable descriptions

  • Add GSM boolean extension methods

• Made various changes to GePlc driver:

  • Retry logic for handling errors during sending data

  • Additional debug log messages

  • Do not explicitly set socket to non-blocking

  • Set initial connection port pseudo-randomly

• Added logging of Tsentry uptime

• Increased limit of files paths used in sysProcs.ini file

Changes:

• Added GsmCsBld utility

• Exposed various methods in TPRI.NtRtControl.dll required for C# Tsentry tasks:

  • TPRI.Process.Create()\

  • TPRI.Process.PrIni(..)

  • TPRI.Process.PrWait()

  • TPRI.Process.GetState()

  • TPRI.Process.SetDispStatus(..)

  • TPRI.Process.Destroy()

  • TPRI.GsmDDCom.Create()

  • TPRI.GsmDDCom.MapGsm(..)

  • TPRI.GsmDDCom.Destroy()

• Added support for Tsentry restart request

• Added DelayBool utility function

• Added 'Localizable' attribute to the text properties of various HMI controls

• Added ability to update Texplore titlebar text

Changes:

• Added support for VS2017 & 64-bit

• Made various changes in the TPRI.NtRtControl assembly:

  • Fixed Debug::LogMsg(..) to properly support custom message queues

  • Added GsmDDCom::GetVarPtr(..) method

• Changed Tsecurity authentication to call LogonUser(..) using LOGON32_LOGON_NETWORK instead of LOGON32_LOGON_INTERACTIVE

• Fixed LogData(..) to properly handle buffer as binary data instead of a text string

• Fixed ProbeSvr to prevent data corruption resulting from network delays and/or time skew

• Removed DbgHelp.lib from Tsentry installation (now included on all Windows platforms)

Changes:

• Added support for VS2015 & RTX2016

• Made various changes to the Texplore application:

  • Fixed download of Texplore assemblies from host to prevent conflict if Texplore is already running with an older version of the assemblies

  • Fixed sequencing to return to ‘Connect’ screen if unable to start an HMI application

  • Fixed initialization of window positions from .ini file when automatically connecting via command line parameters

  • Fixed initialization of window size and position for normal, maximized, and kiosk modes

  • Disabled popup message if exception while saving Texplore settings to .xml file

  • Added option to specify different computer (from HMI host) for retrieving probe data

• Made various changes to the ProbeX control/screen:

  • Allowed paste of a textual list of variable names

  • Fixed flickering/delay when adding or removing a large number of variables from the list

  • Fixed corruption of grid data when loading a very large probeset

  • Fixed display of 0’th element of array in graph

  • Fixed cut/copy/paste shortcut keys when editing variable names & values

  • Fixed left-justify of all text in cells

• Made various changes to the TPRI.Debug class in the TPRI.NtRtControl assembly:

  • Fixed crash if calling Initialize(..) while Tsentry is not running

  • Added overloaded Initialize(..) function to support usage in processes that are not included in the sysVars.ini file

• Added TPRI.GsmDDCom.SetVariable(..) method in the TPRI.NtRtControl assembly

• Added auto-validation of min/max to TPRI.HMI.Controls.TextBox

• Fixed TPRI.HMI.Controls.ComboBox auto-submit logic so that new value is only sent to host after the selection change is committed

• Fixed TPRI.HMI.Controls.StateList to support use of control on sub-panels instead of only on forms

• Fixed TPRI.HMI.Controls.DataSetLoader to ignore the mouse wheel when the dropdown list is collapsed

• Fixed TPRI.HMI.Controls.LogMsg control so that it automatically reconnects if LogMsgName is changed at runtime

• Fixed TPRI.HMI.Controls.StaticArrayGraph2D control so that data at x=0 is properly displayed

• Added TPRI.HMI.Controls.DBViewer control

• Removed deprecated controls and dependencies from the TPRI.Core assembly

• Updated ComponentOne version to v2.6.20073.357

• Made various changes to the ProbeSvr process:

  • Converted connection handling from dedicated threads to a thread pool

  • Fixed TCP/IP listen logic so that all pending connections are accepted at once instead of once per loop of the main thread

  • Fixed memory leak when handling requests for array or string variables

  • Added delay before retry if error opening listen socket

• Fixed printing of Unicode text when displaying current NtRtSvc configuration parameters

• Made various changes to the tpriGsmDDCom library:

  • Fixed getVarArrDimCnt(..) and getVarArrDim(..) to support complex types like array typedef’s

  • Fixed formatting of 64-bit integers when converting to a string

• Added support for message number, object name, and user to the LogMsg(..) function library

• Fixed concurrency issue when calling LogMsg(..) from multiple threads

• Fixed tpriGsmOpcItem::ReadGsmOpcItem(..) so that value is only written back to global common if quality is ‘good’

• Updated tpriVmic driver so that latest VMIC 5565 drivers are used in Win32 mode

• Made various changes to the Tsentry and Tsecurity installers:

  • Fixed created shortcuts so that they have working folders configured correctly

  • Added silent installation command line switch (/S)

• Fixed tpriProc::Create(..) so that the C runtime error report mode is set properly when compiling applications in debug mode vs. the release version of tpriNtRt.lib

• Change RDCHANDLE typedef used by tpriRdc classes from unsigned to signed in order to support legacy code setting the value to -1

• Fixed logging of stack trace information after crash (bug introduced with conversion to Unicode)

• Fixed parsing of historical trend trigger files with headers larger than 16 kB

Changes:

• Initial release for VS2013

• Modified installer to deploy Release-mode versions of all executables and libraries

• Rebuilt all executables and libraries for Unicode instead of MBCS

• Changed all projects to use CRT and MFC as shared DLLs instead of static libraries

Upgrade  Upgrade Instructions:

• Modify any application Visual Studio project properties to use CRT and MFC as shared DLLs instead of static libraries:

  • Configuration Properties à → General à → Use of MFC:
    Use Standard Windows Libraries if not using MFC
    Use MFC in a Shared DLL if using MFC

  • Configuration Properties à → C/C++ à → Code Generation à → Runtime Library:
    Multi-threaded DLL (/MD) for Release builds
    Multi-threaded Debug DLL (/MDd) for Debug builds

Changes:

• Made various changes to the Texplore application:

  • Moved Texplore.exe.config file from same folder as Texplore.exe to user-specific folder

  • Fixed restore of minimized/maximized window state when application is stopped & restarted

  • Added automatic retry of host connection after error

  • Fixed display of new & old windows when spawning a new instance of the executable

  • Automatically download all sub-folders and files when downloading application to client workstation

• Removed user interface window from TrendSrv process

• Fixed cleanup of socket handles in tpriCleip class

Upgrade Instructions:

• Remove any Texplore.exe.config file from the folder(s) used to download Texplore & the associated HMI DLLs to client workstations (these folder are typically %TSENTRY_SYSDIR%\%TSENTRY_SYSNAME%\HmiConfig\*\Texplore.exe.config) since these Texplore.exe.config files are no longer used and if corrupted can cause problems for the application

Changes:

• Added functions to convert TrendSets to ProbeSets and vice-versa and added popup menu links to TrendCtrl and ProbeX TPRI.HMI.Controls classes

• Fixed logic asking user to save changes to ProbeSet/TrendSet/TriggerDef to first check if user has privileges to save file

• Fixed internal screen history tracking logic in Texplore when screen change is cancelled

• Fixed initialization of internal pointers within TPRI.Trending.TrendSet classes

• Added logic to TPRI.HMI.Controls.TrendCom to automatically resize internal buffers for extremely large TrendSets

• Optimized grid repainting when performing multiple row operations in the TPRI.HMI.Controls.ProbeX control

• Added GetLogMsgList(..) method to the TPRI.NtRtInfo.INtRtInfo interface and host/client classes

• Added popup menu items to the TPRI.HMI.Controls.LogMsg control to support the download and display of old log files

• Made numerous changes to the TPRI.HMI.Controls.TrendCtrl control:

  • Changed logic for default variable label to use shortest possible unique string instead of fully qualified variable name

  • Fixed axis min/max/pct editor control to automatically place focus in axis minimum cell rather than leaving active edit on axis label cell

  • Modified popup menu to display current trend source as part of text for “Change Trend Source” menu item

• Modified initialization TPRI.HMI.Forms.TrendSrcSelectForm to automatically highlight last selected trend source

• Modified NtRtMgr process and TPRI.NtRtCmd.ShutdownSystem(..) HMI function to support completely shutting down or rebooting the host system

• Made various changes to the GsmPifBld process:

  • Added support for header file-based variable descriptions stored in the sysStruct.ini file for use by the data dictionary

  • Fixed processing of comments within compiler directives

  • Added support for #if defined, #if !defined, and #if !XXX compiler directives

  • Added deadlock detection to prevent process from entering infinite loop

• Made various changes to the tpriGsmDDCom class:

  • Added & modified numerous functions to add support for header file-based variable descriptions

  • Increased size of memory allocated for data dictionary global common

  • Added static parseValue(..) functions to each varDef-derived class

  • Fixed internal data dictionary lookup function to properly indicate when a structure or variable property is not defined

  • Changed varDef::getDefaultFormat(..)  to return simplified formatting strings

  • Changed formatting for double-precision floating point variable return by varDef::getDefaultFormat(..)  to explicitly request 16 digits of precision

  • Fixed parsing of sysVars.ini file to truncate variable descriptions longer than the maximum allowed string length rather than generating an error

• Fixed parsing of long command line parameters from sysProcs.ini in the tpriProcMgr class

• Made various changes to the VarIniChk application

  • Added code to automatically populate variable descriptions using new data dictionary functions that extract comments from header files

  • Corrected default formatting string for 64-bit integers to “%I64d”

  • Changed default formatting string for single (4-byte) floating point variables to “%g”

  • Changed default formatting string for double (8-byte) floating point variables to “%.16g”

• Fixed tpriIniFile::extractIniString(..) to prevent accessing outside of original string when called repeatedly processing a single buffer

• Modified tpriXmlFile::WriteNodeStruct(..) to support outputting structure entries directly under the root XML node

• Made numerous changes to probe system components:

  • Modified client-side message processing to prevent deadlocks when both client and server have large amounts of data to transmit

  • Fixed client-side mutual exclusion bug that could cause application to crash while processing variable updates from host

  • Modified tpriProbeSrcVar class to add support for locally-allocated variable data and updated internals of ProbeSvr process to support these variables

  • Optimized memory allocation and functions for internal variable collections

  • Added SendTimeout parameter to sysProbe.ini initialization file for ProbeSvr process

• Made numerous changes to historical trending components:

  • Fixed playback routines so that variables recorded at different rates are properly synchronized in time when displayed in TrendX

  • Fixed data collection so that variables are saved to the historical trending file at the requested sampling period

  • Fixed timestamps of real-time data buffered to disk-based circular files

  • Fixed timestamps of recorded data so that they are not skewed by the extra invalid points added to the end of the file to fill the final 8-point block

  • Fixed routines that convert binary historical trend file to text so that invalid data points at the end of the buffer are omitted from the output text file

  • Fixed TriggerConditionList and TriggerTrendList to properly configure trend source for first variable when adding multiple variables with different trend sources from data dictionary

• Made numerous changes to various Tsecurity components:

  • Added support for named privileges defined in the ASCF’s

  • Added GetPrivileges(..) and GetAppPrivileges(..) functions to the TPRI.Tsecurity.ITsecurity interface

  • Added Connect(..), GetPrivileges(..), and GetAppPrivileges(..) functions to the TPRI.Tsecurity.Client class

  • Added TPRI.Tsecurity.Controls.PrivilegePropertyEditor class for use in selecting required privilege levels in properties of numerous HMI controls

  • Added storage of full user names in ASCF’s

  • Added user access report generation in the ASCFEditor application

  • Added HostName, Initialized, and Connected properties to the TPRI.Tsecurity.Client class

  • Added NotConnected to the list of TPRI.Tsecurity.ErrorCode enumerated values

  • Modified ASCFEditor to automatically fill in user name and domain based on current Windows login credentials

• Replaced old VB6 function calls with official .NET equivalents in various sections of code

Changes:

• Fixed TPRI.HMI.Controls.TrendCom control to force IPv4 connection to host system

• Fixed unhandled exception when deleting last axis in TPRI.HMI.Controls.TrendCtrl control

• Changed display of date/time in trend source selection form to use 24-hour display of time rather than 12-hour with AM/PM

• Added DefaultSource property to numerous TPRI.HMI.Controls and TPRI.HMI.Forms trending-related classes

• Fixed popup message question in numerous TPRI.HMI.Controls classes when expansion of data dictionary name would produce too many new entries

• Fixed display of [+/-] tree expansion icon for array variables in TPRI.HMI.Controls.ProbeX control after disconnecting and reconnecting to host

• Changed all TPRI.DataDictionary.VariableNamePrefix known prefix constants from single characters to strings

• Disabled display of historical trends when selecting trend source in TPRI.HMI.Controls.TriggerConditionList and TriggerTrendList controls

• Made various changes to the NtRtMgr HMI screen:

  • Added additional debugging information for unhandled exception during updates

  • Changed display of system name to disable interpreting ‘&’ characters as a mnemonic

• Made various changes to the Texplore application:

  • Added support for dynamically-created IProber objects added to collection of HMI application variables

  • Fixed auto-update functionality so that automatic updates will continue work after disconnecting from an HMI application

• Modified tpriTimer routines so that absolute timer values can be referenced between machines using the wall clock at the time of system startup

• Fixed memory leak in tpriTrigFile class

• Fixed possible string buffer overrun while saving list of active triggers in tpriTrigTrend class

• Change routines used to convert historical trend files to ASCII to format dates using 4-digit year

• Made various changes to the tpriCleanDir function:

  • Added support for environment strings in directory name

  • Added support for multiple filters delimited by the ‘|’ character

• Added new tpriCleanDirThread function

• Made various changes to the tpriGsmDDCom class:

  • Changed default formatting of double-precision floating point variables use 16 digits of precision

  • Replaced sscanf(..) calls in restoreList(..) with type-specific string-parsing functions

Changes:

• Made various fixes to the TrendFileMgr screen:

  • Fixed conversion to .csv functionality to properly process files in local folder

  • Added code to delete temporary files after conversion

  • Fixed file list to remove folder and file extension when displaying files from local folder

  • Fixed file list to retain highlighting of selected item even when control does not have focus

  • Fixed anchoring of file list object so screen displays properly at large screen resolutions

• Made various fixes to the TPRI.HMI.Controls.HistoricalTrendList:

  • Modified AvailableSources property to remove from designer & properties window

  • Deprecated SelectedSource property

Changes:

• Added new classes to the TPRI.DataDictionary namespace:

  • DataDictVariable

  • DataDictVariableCollection

• Made various changes to the TPRI.DataDictionary.TranslateVariableEventArgs class:

  • Added InitialDict and TranslatedDict properties

  • Added new constructor and marked old version as obsolete

• Added Variables As DataDictVariableCollection property to both the TPRI.HMI.Forms.DataDictForm and TPRI.HMI.Controls.DDVarSelect classes and updated dependent classes to take advantage of additional variable source (dictionary) information

• Added TrendSetChanged events to both TPRI.HMI.Controls.TrendCtrl and TrendGraph controls

• Changed BackColor property of TPRI.HMI.Controls.TextSelectBox and DDVarSelect controls to default to ambient value instead of White

• Made various changes to the TPRI.HMI.Controls.TriggerScalarList control:

  • Marked the DataDictNames property as obsolete

  • Force data dictionary form to use “TsentryGsm” data dictionary

• Fixed initialization of TPRI.HMI.Controls.TriggerEditor class to force File Tag entry field to use “TsentryGsm” data dictionary

• Added TrendSourceChanged event to TPRI.HMI.Controls.TrendCtrl control

• Made various changes to the TPRI.HMI.Controls.StaticArrayGraph3D control:

  • Added support for 3D surface contour plots

  • Added numerous new properties

• Made various changes to certain StringCollection-type properties in numerous TPRI.HMI.Controls classes:

  • Changed property designer serialization to save content rather than using resource files

  • Added property editor attribute to use standard .NET StringCollectionEditor

  • Added checks for setting property value to Nothing and instead reset to empty collection

• Made various changes to the tpriGsmDDCom::fmtVar(..) function:

  • Added check to confirm variable is scalar before formatting value

  • Added cross-check between variable type and variable formatting type

• Fixed handling of shutdown options in NtRtMgr process to prevent application exception when shutting system down via Texplore with the console GUI disabled

Changes:

• Made various changes to the NtRtInfo service and TPRI.NtRtInfo.INtRtInfo class:

  • Renamed WriteFile(..) overload with NtRtFileInfo parameter to WriteFile2(..)

  • Replaced GetFileSystemInfos(..) methods with new GetFileInfos(..) method

• Made various changes to the TPRI.NtRtInfo.Client class:

  • Deprecated GetFileSystemInfos(..) in lieu of new GetFileInfos(..)

  • Updated WriteFile(..) overload to call WriteFile2(..) interface method

• Modified Probe client objects to increase stale data timeout from 1 second to 3 seconds

   Upgrade Instructions:

• Update all Texplore client workstations with the current version of Texplore as the latest NtRtInfo service is not backwards compatible with older clients in terms of automatically downloading the latest screens

Changes:

• Made various changes to the TPRI.HMI.Controls.Prober class:

  • Implemented IAdjustableDataSource interface

  • Added new EnableAdjustDataSources property

  • Modified ProberName property to return class name if located on a form

• Made various changes to the TPRI.HMI.Controls.StaticArrayProber class:

  • Implemented IAdjustableDataSource interface

  • Renamed MinInterval property to RequestDelayInterval

  • Added RequestDelayCount property

  • Added attributes to all designer properties so that the designer code for the parent object is correctly updated when a property value is changed

• Removed IAdjustableDataSource interface from TPRI.HMI.Controls.StaticArrayGraphBase class

• Made various changes to the TPRI.HMI.Controls.StaticArrayGraph2D class:

  • Changed internal graph object from standard to scientific graph

  • Fixed X-axis labels when ArrayStep is set to a value other than zero

  • Fixed cleanup of graph display when array data is reset

  • Added Autoscale option to right-click popup menu

  • Added numerous properties to support graph configuration in designer

• Made various changes to the TPRI.HMI.Controls.StaticArrayGraph3D class:

  • Added Autoscale option to right-click popup menu

  • Added numerous properties to support graph configuration in designer

• Made various changes to the TPRI.HMI.Controls.StaticArrayGraphContour class:

  • Added code to hide null data values

  • Added maximize and customization items to popup menu

  • Added numerous properties to support graph configuration in designer

• Made various changes to the TPRI.HMI.Controls.ProbeGraph class:

  • Changed internal graph object from standard to scientific graph

  • Added support for automatically retrieving x-axis labels via new XPosProbeSource property

  • Added support for multiple plotted arrays with new AttachProber(..) method

  • Added code to automatically redraw the graph when changing the GridLineControl property

  • Removed IAdjustableDataSource interface (now directly handled by Prober)

• Updated TPRI.HMI.Controls.ProbeGraphButton control for changes to underlying ProbeGraph

• Made various changes to the TPRI.HMI.Controls.TrendCtrl class:

  • Added support for cut/copy/paste/delete of variables and axes

  • Fixed bugs in “Set Current Scaling as Original Scaling” functionality

  • Fixed bugs in auto-scale functionality

  • Automatically use last trend source when adding new variables

  • Added support for showing metadata for historical trends

  • Set graph font size to large

  • Fixed grid initialization to correctly use ColumnWidths property values

  • Updated trend variable color selector user interface

  • Added fixes to internal forms to prevent loss of focus when editing trendset

• Made various changes to the TPRI.HMI.Controls.TrendGraph class:

  • Change class inheritance from SplitContainter to UserControl

  • Added DefaultValue attributes to numerous properties

• Added Initialized property to the TPRI.HMI.Controls.DataSetLoader control

• Made various changes to the TPRI.HMI.Controls.ActiveGrid control

  • Modified initialization sequencing so that GridSetLoader is only initialized once

  • Added support for multiple data source adjustment functions

  • Added Grid property to expose reference to internal grid object

• Modified default values for TPRI.HMI.Controls.Shape ShapeFill and ShapeBorder properties to prevent Empty colors from appearing in designer code

• Added new TPRI.DataDictionary.ExpandOptions enumerated type to the TPRI.Core.dll assembly and replaced ExpandArray properties in various classes with new ExpandOptions properties

• Made various changes to the TPRI.HMI.Forms.TreeDataDict class:

  • Added new IsString(..) function

  • Enhanced variable expansion functionality to improve flexibility

• Made various changes to the TPRI.HMI.Forms.VariableNamePrefix class:

  • Removed PrefixType enumerated type (users should use shared constant values)

  • Changed calling parameters to AddPrefix(..) method

• Made various changes to the TPRI.HMI.Forms.DataDictForm class:

  • Optimized internal functions to improve performance when working with large data dictionaries and historical trend files

  • Modified data dictionary search functionality to allow dots and brackets in search strings

  • Fixed internal logic to prevent variable expansion if multiple variables are not allowed

  • Changed list of available data dictionaries to use sortable multi-column display

• Modified TPRI.HMI.Forms.TrendSrcSelectForm to use sortable multi-column display for list of historical trend files

• Made various changes to the TPRI.NtRtInfo classes:

  • Added new GetHistTrendMetaData(..) functions

  • Added new GetUtcTime(..) functions

• Added new control classes to the TPRI.HMI.Controls namespace in the TPRI.Core.dll assembly:

  • ProberCollection

• Added new TPRI.Trending.TriggerFile class to the TPRI.NtRtNET.dll assembly

• Modified TPRI.HMI.Controls.ArraySelector MinIndex and MaxIndex properties to automatically adjust Index if outside new min/max

• Added new global function TPRI.HMI.Controls.FormatValue(..)

• Modified TPRI.HMI.Application.Explorer.AdjustVariableIndex(..) function to check for forward slashes in the variable name and ignore all characters preceding the slash

• Added new TPRI.HMI.Application.Explorer.AdjustDataSourceDelegateCollection class to the TPRI.Core.dll assembly

• Removed TPRI.HMI.Forms.TrendInsDelForm class from TPRI.Core.dll assembly

• Added BadValue to the TPRI.Probe.ErrorCode enumerated type

• Made various changes to the TPRI.Probe.ProbeMgr class:

  • Fixed WriteProbe(..) method to properly set returned request status

  • Fixed WriteProbe(..) to set return status to BadValue if unable to convert variable value

• Modified NtRtMgr screen to support small display sizes

• Fixed NtRtProcEd screen to support extremely long file names

• Made various changes to the ProbeX screen:

  • Fixed stack overflow exception when highlighting large number of array variables in grid

• Made various changes to the Texplore application:

  • Fixed Texplore.AdjustDataSources(..) function to find all objects implementing the IAdjustableDataSource interface (instead of only finding child controls controls)

  • Fixed auto-download functions to prevent exception if %APPDATA% environment variable does not exist

  • Updated ‘Tools’ toolbar icon

• Modified NtRtInfo and Tsecurity service installers to support running as LocalSystem, LocalService, or NetworkService accounts

• Modified NtRtSvc service to support installation for LocalSystem user

• Made various changes to the historical trending functionality:

  • Added support naming historical trend files using variable values from global common

  • Added support for recording scalar variable values

  • Added [MetaData] section to historical trend data files

  • Added ability to drag-and-drop rows in various grids of historical trigger editor screen

  • Increased maximum number of triggers from 100 to 1000

• Fixed string overrun exception in TrendSrv process

• Fixed tpriXmlFile::ReadNodeStruct(..) to properly validate child node data

• Added new tpriVmic::getMemAddr() function

• Made various changes to the tpriGsmDDCom class:

  • Added new fmtVar(..) function

  • Fixed restoreList(..) function to properly restore single-byte variables

• Updated version of Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package included with installer

• Updated various procedures & scripts to support installation on Windows XP Embedded

   Upgrade Instructions:

• Install the Visual Studio 2005 Service Pack 1 ATL Security Update onto the application development system per Microsoft KB971090 (http://www.microsoft.com/downloads/en/details.aspx?familyid=7c8729dc-06a2-4538-a90d-ff9464dc0197&displaylang=en )

Changes:

• Modified TPRI.Tscreen.TscreenMgr class so that SDI forms are completely docked to the MDIClient and use the AutoScroll and AutoScrollMinimumSize properties instead of manually trying to resize the form and enable/disable scroll bars

• Modified TPRI.Tscreen.TscreenInfo class to use the form’s MinimumSize property if configured before defaulting to the form’s initial size when determining the minimum size for scroll bars

• Made various changes to the TPRI.NtRtInfo.INtRtInfo interface and the TPRI.NtRtInfo.Host and Client classes:

  • Replaced WriteFileOptions class with NtRtFileInfo class

  • Deprecated existing GetFileSystemInfos(..) method and replaced with new method using NtRtFileInfo class (all calls to original GetFileSystemInfos(..) now return ‘NotSupported’)

• Fixed various TPRI.Trending.TrendSet classes to properly set variable references to parent axes when serializing from form designer code

• Modified internal storage of trend variable data in the TPRI.HMI.Controls.TrendCtrl class to improve performance and reliability

Changes:

• Made various changes to Texplore

  • Fixed login panel to auto-display current user domain even if domain is not in list

  • Added display of variable dictionary (source) to list of returned variables

  • Added functions to automatically show/hide and resize various items for narrow displays

  • Force application to run in 32-bit mode even on 64-bit systems (required for run-time compatibility with TPRI.NtRtNet.dll assembly on 64-bit systems)

• Changed type of TPRI.Tscreen.ActivateInfo.Argument property from String to Object

• Made numerous changes to the TrendX screen and related controls to improve ease-of-use

• Made numerous changes to the TriggerMgr screen and related controls to improve ease-of-use

• Made various changes to the ProbeX screen:

  • Fixed display of tree expand/collapse icon after host disconnect/reconnect

• Changed background color on all standard Tsentry screens to black

• Added new control classes to the TPRI.HMI.Controls namespace in the TPRI.Core.dll assembly:

  • ColorPicker

  • StaticArrayGraphBase

  • StaticArrayGraph3D

  • StaticArrayGraphContour

• Changed TPRI.HMI.Controls.StaticArrayProber from Control to Component to be consistent with standard Prober object

• Modified TPRI.HMI.Controls.StaticArrayGraph2D to inherit from StaticArrayGraphBase

• Fixed TPRI.HMI.Controls.Prober to completely disconnect from probe manager when requested

• Changed TPRI.Probe.ProbeMgrBase to call DisconnectProbes(..) on IProber objects passing Nothing for the probe manager reference when trying to disconnect permanently from an IProber

• Changed TPRI.Tscreen.TscreenMgr to call Form.Dispose when trying to remove screen from memory

• Added BarWidths and BarWidthsProber properties to the TPRI.HMI.Controls.BarGraph class

• Added CounterRotate property to the TPRI.HMI.Controls.LevelDisplay control

• Modified TPRI.HMI.Controls.ActiveGrid to use BackColor property to set grid background color

• Made various changes to the TPRI.HMI.Forms.DataDictForm form

  • Fixed handling of double-click on variable to add variable to list rather than replacing list

  • Added display of variable dictionary (source) to list of returned variables

  • Added ExpandArray property

  • Added TranslateVariable event

• Made various changes to the TPRI.NtRtInfo.INtRtInfo interface and the TPRI.NtRtInfo.Host and Client classes:

  • Added new DirectoryExists(..) functions

  • Added new CreateDirectory(..) functions

  • Added new DeleteFile(..) functions

  • Added new MoveFile(..) functions

  • Added new SharedFolderExists(..) functions

  • Added overloaded WriteFile(..) functions to support additional write options

  • Added new ParseSharedFolder(..) function to TPRI.NtRtInfo.Client class

• Fixed numerous TPRI.HMI.Controls classes to remove links to external object when disposed in order to eliminate event handlers from preventing garbage collection of in-memory objects

• Fixed TPRI.HMI.Forms.TrendSrcSelect to enable use of the historical trend Filter function

• Made various changes to the TrendTrig process & libraries:

  • Added support for configurable sampling periods for trended variables

  • Added code to set minimum values for pre- and post-trigger trend times to 1 second to prevent trigger data collection restarts due to jitter in non-real-time data collection

• Made various changes to the tpriXmlFile library:

  • Added ReadTableStruct(..) and WriteTableStruct(..) functions

  • Added support for environment variables in file names

  • Optimized various functions to improve processing speed

• Changed tpriIniFile class to use local buffers for calls to tpriEnvStr(..) instead of relying on the shared/static buffer inside of tpriEnvStr(..)

• • Fixed handling of compiler directives that use backslashes to span multiple lines

• • Fixed handling of #pragma once directives to use case-insensitive comparison of file names

• Fixed crash during initialization of GsmExpSvr process

• Added support for custom probe source DLLs to the ProbeSvr process

• Made several additions to the tpriNtRt library:

• • Added tpriAppThread application thread class

• • Added StartTimer(), ElapUTimer(..), ElapMTimer(..) and ElapSTimer(..) functions

• • Added tpriProbeSrcVar class to support custom probe sources

• • Added tpriXmlFile class to support reading/writing XML files w/ data dictionary

• Made various changes to the tpriGsmDDCom class in the tpriNtRt library:

• • Added additional overloaded mapGsm(..) function

• • Added structDef::getChild(..) function

• • Added structDef::getTypeStruct(..) function

• • Added varDef::getSize(..) function

• • Fixed getVarXxxPtr(..) functions to return correct size for strings

• Added new GetDiagInfo(..), GetConnectInfo(..), and GetStatementInfo(..) functions to the tpriDbio class in the tpriNtRt library

• Modified tpriIniFile::extractIniString(..) to replace all \” tokens in the output string with a single double-quotes character

• Added code to tpriProcMgr class in the VS2008-version of the tpriNtRt library to force processor affinity to prevent issues related to high-speed clocks for different CPU cores drifting apart on hypervisor systems

• Added tpriEgd GE EGD PLC driver class to the tpriPio library

• Made various changes to the tpriVmic class in the tpriPio library:

• • Fixed bytes-per-second calculation to support different variable refresh rates

• • Fixed board initialization to detect actual memory size from board registers

• • Added getNodeID() and getMemSize() functions

• Removed function declaration of non-existent tpriRdcSer::xmitMsg(..) function from header file to prevent compile & link errors

• Fixed tpriTrendSrc::setTrendData(..) function to keep the memory buffer in sync with the disk buffer when the memory buffer rolls over due to a long delay in data collection

• Made various changes to the tpriTrendTrig class:

• • Decreased in-memory trend times and increased on-disk trend times for requested variables

• • Add protection against corrupted trigger files

• Added VarIniChk utility process to list global common variables not present in a sysVars.ini file

• Added VarIniSort utility process to alphabetically sort variables in the sysVars.ini file

• Fixed ProbeSvr process to properly handle requests for variable min/max/init values

• Fixed TrendMgr process to properly store all in-memory trend data when shutting down

• Made various changes to support changing local Tsentry user password:

• • Added additional command line parameters to the NtRtSvc service process

• • Added ChangeTsentryPassword.cmd script

• • Modified CreateTsentryUser.cmd, CreateUser.vbs, and ConfigureTsecurity.cmd scripts

• Added InstallNtRtSvc.cmd script for installing main Tsentry service

• Made various changes to the TPRI.HMI.Controls.Shape and ActiveShape control:

• • Integrated codebase together so that ActiveShape inherits from Shape

• • Fixed Value property so that object is only updated & repainted if the value has changed

• • Fixed painting routines to prevent double paint calls while shape is blinking

• • Fixed blinking so that it remains consistent (if possible) when value has changed

• Fixed TPRI.DataDictionary.VariableNamePrefix.StartOf(..) function to properly validate inputs

• Made various changes to the TPRI.HMI.Controls.BarGraph class:

• • Added drawing of vertical axis ticks and labels to the TPRI.HMI.Controls.BarGraph control

• • Fixed various probe source properties to automatically request data for new variable

• • Added checks to prevent exceptions if multi-dimensional array is returned from host

• • Added BackBarProber and FrontBarProber properties

• Modified TPRI.HMI.Controls.TrendAxisList to set the default axis label as the axis number

• Modified TPRI.HMI.Controls.TrendPlayback to inherit BackColor and ForeColor from container

• Made various changes to the TPRI.HMI.Controls.TrendCtrl control

• • Fixed TrendInit(..) method to run without releasing CPU

• • Implemented IAdjustableDataSource interface

• Added ColumnWidths property to TPRI.HMI.Controls.LogMsg control

• Added new control classes to the TPRI.HMI.Controls namespace in the TPRI.Core.dll assembly:

• • ActiveGrid

• • ArraySelector

• • BarGraphCollection

• • BlockDrawingBase

• • GridSetLoader

• • Label

• • LabelCollection

• • LevelDisplay

• • Line

• • MinMaxCutoff

• • MinMaxLimit

• • Multiplier

• • NumericUpDown

• • NumericUpDown2

• • ProbeGraph

• • ProbeGraphButton

• • Prober

• • ProbeX

• • SelectButton

• • StateList

• • StaticArrayProber

• • StaticArrayGraph2D

• • SummingJunction

• • Toggler

• • TrendGraph

• Added new TPRI.Grid.GridSet class to the TPRI.Core.dll assembly

• Added new TPRI.HMI.Forms.ProbeGraphForm class to the TPRI.Core.dll assembly

• Added C1.Win.C1FlexGrid.2.dll assembly to distributed files

• Made various changes to the TPRI.HMI.Controls.TextBox control:

• • Added AutoSubmit property

• • Added WriteValue property

• • Added EnableSAK property

• • Added VisibleSAK property

• • Changed SendBatchUpdates method to use internal probe manager reference is none is passed to the function

• Made various changes to the TPRI.HMI.Controls.ComboBox control:

• • Added AutoSubmit property

• • Added EnableSAK property

• • Added VisibleSAK property

• • Changed SendBatchUpdates method to use internal probe manager reference if none is passed to the function

• Made various changes to the TPRI.HMI.Controls.DataSetLoader control:

• • Added SaveSAK property

• • Added DeleteSAK property

• • Changed DataSetName property to be configurable at design time

• • Added DataSetNameChanged event

• • Modified Initialize(..) function to automatically load DataSetName file if defined

• • Added code to reset modified flag when user chooses not to save changes

• • Fixed data set load sequence so that requested data set is still loaded after user saves unsaved changes to the previous data set

• Changed TPRI.HMI.Controls.TriggerDefLoader class so that trigger name is set when the data set name is changed instead of when the file is written to disk

• Made various changes to the TPRI.HMI.Controls.CmdButton control

• • Added SendBatchUpdates property

• • Added CancelBatchUpdates property

• • Added EnableSAK property

• • Added VisibleSAK property

• Made various changes to the TPRI.HMI.Controls.LinkLabel control:

• • Added EnableSAK property

• • Added VisibleSAK property

• Made various changes to the TPRI.HMI.Controls.ToggleButton control

• • Added EnableSAK property

• • Added VisibleSAK property

• Made numerous changes to the TPRI.HMI.Forms.DataDictForm form to support selection of multiple variables at once

• Added new VariableNames property to the TPRI.HMI.Controls.DDVarSelect control

• Made various changes to the TrendX screen & support classes:

• • Updated Gigasoft libraries to pegrp32d.dll v6.0.0.74

• • Increased the maximum number of trend axes from 6 to 16

• • Added ability to identify/highlight specific trend variables in graph

• • Added support for automatically scaling axes in trend graph

• • Added ability to clip variables to associated axis in multi-axis trends

• • Enhanced validation of graph width and sampling period in trend setup screen

• • Fixed determination of the number of significant digits used for the display of trend times

• • Fixed unhandled exception when setting AxisMin and AxisMax without any axes defined

• • Changed TrendX.UpdateTrendSet() from a private to a protected function

• Made various changes to the ProbeX screen:

• • Added support for graphing scalar and 1-dimensional arrays to the screen

• • Added hotkeys for new variable, edit variable, edit new variable, and delete variable

• • Fixed initialization of format style when changing a comment to a variable

• Fixed NtRtProcEd screen so that requested process is always selected by default

• Made various changes to the Texplore screen browser:

• • Added support for automatic download & update of application files from host system

• • Added support for running in kiosk mode

• • Added display of date/time to title bar

• • Added print screen support

• • Fixed delayed updates of newly added Probe variables in situations where the specific variable had already been requested

• Added GetFileSystemInfos(..) function to TPRI.NtRtInfo.INtRtInfo interface and TPRI.NtRtInfo.Host and Client classes

• Fixed TPRI.DatabaseIO.DBIOServer and DBIOClient classes so that .NET remoting security is not required

• Added global FindKnownColor(..) function to the TPRI.Core.dll

• Optimized display update & repaint code in numerous HMI components to minimize CPU overhead and associated flicker when updating display

• Added property description and category attributes in numerous HMI components

• • Fixed handling of array indices that are specified with arithmetic operations that result in fractional values

• • Fixed handling of closing braces when parsing functions defined in header files

• Made various changes to the NtRtMgr process:

• • Changed handling of delayed startup aborts to skip handling of GuiOptions .ini file parameter

• • Fixed error handling on startup to prevent conditions where main display is not shown

• • Fixed processing of sysProcs.ini file to support long command line parameter strings

• Made various fixes to the tpriGsmDDCom class:

• • Changed PERSIST_APPENDONLY value to properly represent a single unique bit

• • Changed PERSIST_FLAGMASK to add future support for additional flags

• • Added testMinMax(..) function for validating value against known min/max values

• • Added additional error logging

• Fixed TrendMgr bug causing trend data to be improperly buffered to disk files

• Modified TrendTrig so that temporary historical trend buffer files are closed in between read/write operations rather than continuously holding files open

• Fixed tpriIniFile::setKeyValue(..) to properly place key entry after section name when saving to a completely new section

• Added SAFE_DELETE(..) and SAFE_DELETE_ARRAY(..) macros to tpriUtilMacs.h

• Modified VmicDrv to read/write variables to reflective memory at individually specified frequencies

• Added SetTsentrySystem.cmd and SetEnvVariable.vbs scripts to the distributed procedures

• Fixed TsentryConfig.cmd script to forcibly uninstall the NtRtInfo service before reinstalling in order to support changes to the installation directory

• Modified TsentryConfig.cmd script to write results to disk log file (%TSENTRY_SYSDIR%\%TSENTRY_SYSNAME%\logs\TsentryInstall.log)

• Cleaned up TSENTRY and Tsecurity command-line scripts

• Modified TSENTRY installer to support runtime-only installations

   Upgrade Instructions:

• Modify any VMIC configuration files to specify the refresh period (in milliseconds) for each variable as shown in the example below:

# ------------------------------------------------------------------------
# Variable definitions
# ------------------------------------------------------------------------

[VarDef]
#VariableName             #Read/Write  #Offset  #RefreshPeriod(ms)  #RemoteType
MyWriteStruct.MyWriteVar  W            0x1000   20
MyReadStruct.MyReadVar    R            0x2000   100                 VT_I2

• • Fixed internal logic to properly allow saving of new historical trend trigger definitions

• • Added checks to prevent trigger names that start or end with whitespace

• • Modified error reporting during validation to eliminate duplicate error messages

• Made various changes to the TrendX screen Trend Setup form and underlying controls:

• • Fixed logic for inserting a new axis to properly insert before the clicked item

• • Added code to automatically add an empty variable when creating a new axis

• • Fixed validation of axis percentages to prevent unhandled exception

• • Fixed copying and pasting of trend variables within the variable list

• • Fixed unhandled exception when trying to copy an axis node within the variable list

• • Added more details to warning message when trying to define a graph with too many points

• Added support to ProbeX screen for use of up/down arrow buttons while editing a variable value

• Fixed Probe client to eliminate unnecessary expansions of the receive buffer size

• Made various changes to the TPRI.HMI.Controls.TrendCtrl class:

• • Changed AxisMinBox and AxisMaxBox property types from TextBox to Control

• • Moved internal code from InitializeDefaultTrendGraph(..) method to TrendLib module

• • Fixed InitializeDefaultTrendGraph(..) to set the graph Desk color so that it matches the parent’s BackColor rather than forcing Navy

• Made various changes to the TPRI.HMI.Controls.DataSetLoader class:

• • Changed file list retrieval error handling to display message in combo box rather than as a popup message

• • Added code to automatically resize dropdown box if dropdown text is wider than the control

• • Added code to validate file names before saving

• Made various fixes to the TPRI.HMI.Controls.BarGraph class:

• • Fixed processing of bar data arrays to prevent array index exceptions

• • Fixed handling of changes to BarCount value while displaying data

• • Fixed sizing of bars so that border will always be visible

• • Fixed handling of control background color

• • Modified BarLabels property to be editable via the designer

• • Added BarLabelsStartIndex property for auto-numbering bars

• • Changed BoundaryInfo.TextBox property type from TextBox to Control

• • Added window titles to all popup error messages

• Made various changes to the TPRI.HMI.Controls.ToggleButton class:

• • Added ValidatingClick event to provide mechanism to cancel button clicks

• • Removed default value from BackColor property serialization and added code to initialize value as KnownColor.Control

• • Removed nuisance message in design mode when setting BackColor

• Removed default value from TPRI.HMI.Controls.TextBox BackColor property

• Completely reworked the TPRI.HMI.Controls.CoverageBar class for use under VB.NET

• Added numerous control property description and category attributes

• Fixed tpriIniFile class to replace environment variables in the file name before saving the file

• Fixed tpriTrendTrig class to support trigger definitions whose names contain spaces when restoring the active triggers following a system restart

• Added additional error logging to VmicDrv when unable to map physical memory

• Made various fixes to the GsmPifBld process:

• • Added code to ignore 'signed' specifier

• • Enhanced error messages processing #define statements

• Reset all WINVER and _WIN32_WINNT preprocessor defines in internal Tsentry Visual Studio projects to 0x0500 for continued support of the Windows 2000 operating system

• • Added new TextChangeLog parameter to [General] section of .ini file to support configuration of text-based logging of variable changes received from client connections

• • Renamed existing LogMsgQueue parameter in [General] section of .ini file to BinaryChangeLog (the original LogMsgQueue parameter name is still supported)

• • Added support for text-based change logging of signed and unsigned 8-byte integer values

• • Fixed text-based change logging of unsigned 2- and 4- byte integer values

• Fixed Probe client so that it will properly process multiple incoming messages in a single pass

• Added new TPRI.Process class to TPRI.NtRtNET assembly

• Fixed IOComp licensing in Texplore so child screens do not display licensing dialog

• Made various changes to the TPRI.Tsecurity.TsecurityAD class:

• • Modified authentication routine to explicitly close all network connections before each authentication attempt

• • Fixed logging of messages to the event log

   Upgrade Instructions:

• Modify the ProbeSvr .ini file (typically sysProbe.ini in the \pif\ folder) as follows:

• • Rename the LogMsgQueue parameter in the [General] section to BinaryChangeLog

• • Add the new TextChangeLog parameter to the [General] section to specify the appropriate LogMsg queue if text-based logging of variable changes is desired

• • A sample [General] section for this file is shown below:

#--------------------------------------------------------------
# General probe parameters
#--------------------------------------------------------------

[General]
# Specify the local host to which the ProbeSvr server socket should bind,
# or leave blank to bind the socket without specifying a local host.
LocalHost=192.168.0.1

# Specify the LogMsg queue for text-based variable change logging,
# or leave blank to disable text-based change logging.
TextChangeLog=LogMsg

# Specify the LogMsg queue for binary variable change logging,
# or leave blank to disable binary change logging.
BinaryChangeLog=ProbeLog

• • Added getNextKey(..) and cleanFile(..) functions

• • Modified success return value of createSection(..) and insertChars(..) to indicate number of characters inserted rather than always zero

• • Modified deleteLine(..) to return negative value if characters cannot be removed from file

• • Optimized internal buffer allocation to improve performance when writing data to file

• • Optimized cleanSection(..) function to improve speed

• Made various changes to the tpriGsmDDCom class:

• • Added support for default variable formatting strings if one is not provided in the .ini file

• • Added saveAllStructs(..) and restoreList(..) functions

• • Added varDef::getDefaultFormat(..) static functions

• • Modified varDef::fmtValEx(..) function to provide multiple static overloads that support default as well as custom formatting strings

• Modified TSENTRY installer so that Hard-Real Time installation option will not be presented if not supported by a specific version of TSENTRY

• Modified TSENTRY and Texplore installers to use Microsoft Visual C++ 2005 Redistributable Package (x86) rather than manually installing required Visual C++ assemblies onto target system

   Upgrade Instructions:

• Modify any applications that employ custom .NET Remoting components in addition to Tsecurity, DBIO, or NtRtInfo so that the custom .NET Remoting channels are registered with the enableSecurity flag set to False (reversing the change required by TSENTRY v4.11.00 and v4.12.00)

• If installing over a previous version of TSENTRY, modify the Tsecurity.exe.config file to replace the first line of the file:

<?xml version="1.0" encoding="Windows-1252"?>

with:

<?xml version="1.0"?>

• • Changed internal processing of data and boundaries so that comparisons are made in the native format of the host data rather than forcing conversion to floating point

• • Changed type of Value property from Single to Object

• • Changed type of ActiveShapeSetup.BoundMax property from Single to Object

• • Deprecated tLocked property in favor of new Locked property

• • Added DisplayMode property

• • Added LiveValueChanged event when data from host is updated

• • Fixed code to correctly fire ValueChanged event when value is changed

• Made various fixes to the TPRI.HMI.Controls.LimitDisplay class:

• • Deprecated ShowUpperLimit and ShowLowerLimit properties in favor of new UpperLimitVisible and LowerLimitVisible properties

• • Added ValueTextBox, UpperLimitTextBox, and LowerLimitTextBox properties to allow full customization of text boxes

• • Fixed resize/layout handling to correctly position textboxes within control and to account for the control border

• Added shadowed Enabled property to the TPRI.HMI.Controls.ToggleButton class to support disabling the control completely regardless of whether or not it is receiving live data

• Removed TPRI.Tsecurity.Controls.AutoCompleteComboBox class as the AutoComplete functionality is now provided directly by the System.Windows.Forms.ComboBox class

• Made various fixes to the TPRI.Tsecurity.TsecurityDomainsList class (and the Tsecurity service):

• • Fixed the FindDomains(..) functions to correctly interpret ‘types’ parameter

• • Fixed memory leak and potential crash while enumerating the list of trusted domains

• • Redesigned text display to directly draw text rather than implementing a text box child control

• • Removed LabelControl property

• • Fixed drawing code to properly draw background for non-rectangle shapes

• • Fixed drawing code to properly draw right and bottom borders when border width is set to 1

• • Changed default blink period from 0 to 1000 ms

• • Fixed internal Click handling to correctly generate event regardless of where on the control the mouse is clicked

• • Deprecated tValue property in favor of new Value property

• • Deprecated tNumTextLines property

• • Added LiveValue property

• • Modified internal processing of probe updates to use common code with other controls

• Made various fixes to the TPRI.HMI.Controls.ActiveShapeSetup class:

• • Modified Converter class to provide more meaningful information when converting to a string

• • Modified Font property to inherit value from parent ActiveShape control

• • Fixed Font property so that the designer properly serializes value to form source code

• Made various fixes to the TPRI.HMI.Controls.TextBox class:

• • Added code to set focus to the TextBox and select all text if there is an error converting text to the appropriate value type while trying to send batch updates

• • Added code to automatically switch to EditActive mode if Text is modified while live

• • Modified internal processing of probe updates to use common code with other controls

• Made various fixes to the TPRI.HMI.Controls.ComboBox class:

• • Added LiveValue property and renamed ValueChanged event to LiveValueChanged

• • Added code to set focus to the ComboBox and select all text if there is an error converting text to the appropriate value type while trying to send batch updates

• • Added logic to hide drop-down when ComboBox is put into ReadOnly mode

• • Fixed Items property editor form to force serialization of object when list of Items is changed

• • Modified internal processing of probe updates to use common code with other controls

• Made various fixes to the TPRI.HMI.Controls.ToggleButton class:

• • Added LiveValue property and LiveValueChanged event

• • Added InvalidVariableType to ToggleButtonDisplayMode enumeration & added logic to set DisplayMode to this value when the live variable value cannot be converted to an integer type

• • Modified internal processing of probe updates to use common code with other controls

• Modified Converter class for TPRI.Shape.ShapeBorder class to provide more meaningful information when converting to a string

• Modified Converter class for TPRI.Shape.ShapeFill class to provide more meaningful information when converting to a string

• Modified signatures of events generated by the ActiveShapeCollection, CmdButtonCollection, ComboBoxCollection, ShapeCollection, TextBoxCollection, ToggleButtonCollection, and TrendVarSelectCollection classes in the TPRI.HMI.Controls namespace to change the ‘sender’ parameter from ByRef to ByVal in order to be consistent with .NET coding standards

• Added TPRI.HMI.Application.Explorer.AdjustVariableIndex(..) function

• Reworked NtRtProcEd screen to support new HMI control objects

• Modified GsmPifBld process to ignore ‘volatile’ variable specifier

• Fixed various calls to vsnprintf_s(..) and snprintf_s(..) throughout code to prevent buffer overrun exceptions by forcing truncation of the output strings if the output buffer is too small

• • Added functionality to display variable names as tool tips for probe-enabled objects

• • Added functionality to display error messages using an ErrorProvider

• • Added functionality to programmatically adjust all data sources

• • Added screen name to application window title to help discriminate between multiple instances of the application pointed at different screens

• • Modified popup window when double-clicking screen title to display screen parameters along with class and assembly information

• Added checks to TPRI.Probe.ProbeClientVar class to return an error if attempting to write an updated variable value that cannot be converted to the original variable type

• Fixed TPRI.Probe.ProbeMgrBase class to prevent internal corruption when an IProber with only probe changes the variable name associated with a given tag

• Made various fixes to the TPRI.HMI.Controls.ActiveShapeSetup class:

• • Set default property values for all properties

• • Changed type converter to remove conversion to and from strings

• Added TPRI.HMI.Controls.ActiveShapeSetupCollection class

• Made various fixes to the TPRI.HMI.Controls.ActiveShape class:

• • Added ActiveSetup collection property and deprecated ActiveShapeSetup array property

• • Changed designer serialization to save individual properties rather than as a full array

• • Fixed Click handler of internal label control to call OnClick(..) method rather than raising the click event directly

• • Added LinkedScreen and LinkedScreenArguments properties to automatically navigate to other screens when the object is clicked

• • Fixed various ActiveSetup and DisconnectSetup properties to correctly update display when the property values are changed

• • Fixed internal logic for DisplayMode when ProbeSource is set to an empty string

• • Fixed requesting of probe variables to handle cases where probe is already active

• • Changed error reporting to implement the IErrorIndicator interface rather than message boxes

• Made various fixes to the TPRI.HMI.Controls.TextBox class:

• • Removed design-time message box warning of the use of the BackColor property

• • Modified display logic to correctly draw control while in design mode

• • Added LiveValue and LiveText properties

• • Fixed internal logic for DisplayMode when ProbeSource is set to an empty string

• • Fixed CancelBatchUpdates(..) to process only if an update is pending

• • Changed error reporting to implement the IErrorIndicator interface rather than message boxes

• Made various fixes to the TPRI.HMI.Controls.ComboBox class:

• • Modified class to inherit directly from System.Windows.Forms.ComboBox

• • Renamed various properties for new naming convention

• • Fixed internal logic for DisplayMode when ProbeSource is set to an empty string

• • Changed error reporting to implement the IErrorIndicator interface rather than message boxes

• Made various fixes to the TPRI.HMI.Controls.ToggleButton class:

• • Fixed requesting of probe variables to handle cases where probe is already active

• • Changed error reporting to implement the IErrorIndicator interface rather than message boxes

• Made various fixes to the TPRI.HMI.Controls.BarGraph class:

• • Changed error reporting to implement the IErrorIndicator interface rather than message boxes

• Added TPRI.HMI.Forms.ComboBoxItemsEditorForm and TPRI.HMI.Controls.ComboBoxItemsPropertyEditor classes to support new ComboBox class

• Removed events from TPRI.HMI.Controls.ComboBoxCollection class

• Fixed internal logic for TPRI.HMI.Controls.ToggleButton.DisplayMode when ProbeSource is set to an empty string

• Added TPRI.HMI.Controls.LimitDisplay classes

• Made numerous changes to the TPRI.Shape.ShapeBorder, TPRI.Shape.ShapeFill, and TPRI.HMI.Controls.Shape classes in order to improve serialization in the designer

• Fixed TPRI.HMI.Controls.TrendCom class to prevent error if passed an invalid host name

• Added TPRI.HMI.Application.Explorer.FindSubControls(..) utility function

• Made various changes to ProbeX screen:

• • Fixed automatic expansion of arrays and structures in to support cases where only one variable is produced from the expansion

• • Added logic to enable highlighting of cells whose variable name is an empty string

• Changed NtRtInfo service Host and Client classes to use a pure TCP channel rather than an HTTP channel in order to support encryption and security

• Enabled security & encryption for all .NET Remoting connections

• Replaced various deprecated .NET functions in code with new .NET functions

• Modified tpriCleip class to increase maximum allowed size of file name and host name strings

• Changed RTSS builds of TrendGsm and MillSim to use the fast floating point model (/fp:fast) for improved real-time performance

• Upgraded Glacial Components GlacialTreeList to v2.5.1.22512

• Upgraded Glacial Components GlacialListView to v2.1.0.22283

   Upgrade Instructions:

• Modify any applications that employ custom .NET Remoting components in addition to Tsecurity, DBIO, or NtRtInfo so that the custom .NET Remoting channels are registered with the enableSecurity flag set to True (see the MSDN documentation for the ChannelServices.RegisterChannel(..) method)

• • Added new standard TSENTRY process ProbeSvr

• • Added tpriProbeChange class to the tpriNtRt libraries

• • Added numerous classes to TPRI.Core.dll assembly

• • Modified Texplore to communicate with ProbeSvr rather than GsmOpcSvr for the exchange of global shared memory variable data

• • Modified all screen control objects to use new IProber interface

• Added LogData(..) global functions to logging binary data to LogMsg queues

• Modified various internal functions to support LogData(..) functionality

• Increased size of LogMsg message buffer size from 256 bytes to 512 bytes

• Modified tpriLogMsg class and sysLogs.ini file format to support LogMsg queues that do not generate files on disk

• Fixed DumpHex(..) functions to send logs to requested queues rather than always only to default “LogMsg” queue

• Made various fixes to the tpriCryptor class:

• • Fixed Win32 encryption function calls to use machine keysets and named containers

• • Modified EncryptString(..) and DecryptString(..) functions to format error string as output when an error occurs

• Changed LogMsg for receive data timeout in tpriRdc class from DBERR to DBSEQ

• Fixed tpriDbio::ExecSql(..) to dynamically allocate local buffer for SQL statement to prevent buffer overruns

• Rewrote tpriEnvStr(..) function to eliminate buffer size and reentrancy issues

• Fixed GsmPifBld process to delay replacement of a matched #define string that falls at the end of the read buffer until more data has been read from the file

• Added EncryptString(..) and DecryptString(..) functions to the TPRI.Cryptor class

• Made various fixes to the TPRI.NtRtInfo.Client class:

• • Modified.WriteFile(..) function to allow writing empty (size = 0) files

• • Fixed Connect(..) function to correctly handle exceptions generated when registering a .NET Remoting channel that has already been registered

• • Fixed Connect(..) function to clean up properly after an exception while registering the .NET Remoting channel

• • Added code to clear cached data when disconnecting from host

• Modified TPRI.NtRtInfo.Host.GetTrendSourceList(..) function to return the list of real-time trends even if unable to retrieve the list of historical trends

• Fixed TPRI.DataDictionary.TreeDataDict to prevent unhandled exception if an empty variable is added to a ProbeX ProbeSet

• Updated TPRI.HMI.Controls.DataSetLoader GUI to make it more intuitive for users

• Made various fixes to the TPRI.HMI.Controls.TextBox class:

• • Modified class to inherit directly from System.Windows.Forms.TextBox

• • Renamed various properties for new naming convention

• Made various fixes to the TPRI.HMI.Controls.ActiveShape class:

• • Renamed various properties for new naming convention

• • Replaced TPRI.HMI.BaseControl.OnActiveUpdate event with new ValueChanged event

• Made various fixes to the TPRI.HMI.Controls.CoverageBar class:

• • Changed LeftEdge, LeftData, RightData, and RightEdge readonly properties to read/write

• • Renamed various properties for new naming convention

• • Removed ErrorTerminate event

• Made various fixes to the TPRI.HMI.Controls.ToggleButton class:

• • Modified class to inherit directly from System.Windows.Forms.Button

• • Replaced TPRI.HMI.BaseControl.OnActiveUpdate event with new ValueChanged event

• • Renamed various properties for new naming convention

• Fixed TPRI.HMI.Controls.TrendAxisList to prevent unhandled exception if internal timer to check axis percents runs before a trend set has been defined

• Changed TPRI.HMI.Controls.TrendCom, TrendCtrl, TrendPlayback, TriggerEditor, and TriggerStatusList classes to inherit from System.Windows.Forms.UserControl rather than TPRI.HMI.Controls.BaseControl

• Removed TPRI.HMI.Controls.BaseControl and TPRI.HMI.Controls.OpcMgr classes

• Fixed tracking of the internal ‘modified’ flag in the TPRI.HMI.Controls.ProbeSetLoader, TrendSetLoader, and TriggerDefLoader classes

• Added Changed event to the TPRI.HMI.Controls.TriggerEditor class

• Modified ProbeX, TrendX, and TriggerMgr screens to ask the user to save unsaved changes when leaving the screen

• Made various fixes to the ProbeX screen:

• • Fixed handling of invalid variables when sending data back to host

• • Added removal of previous ProbeSet’s variables when changing to a new ProbeSet

• • Allowed reordering of columns in variable display

• • Added code to check if a string specified for the variable name is illegal and, if so, format the displayed line as a comment

• • Fixed the changing of a variable name to remove variable from the list of probes before adding a new probe

• • Fixed text color for highlighted items when list loses focus

• • Added code to add a single empty variable by default to any new ProbeSet

• • Added ‘Set Values’, ‘Revert to Live Values’, and ‘Set Formats’ menu items for modifying multiple variables simultaneously

• Modified TrendX screen so that new TrendSets will be created by default with a single axis containing a single empty variable

• Modified TriggerMgr screen so that new trigger definitions will be created by default with a single empty condition and a single empty trend

• Modified TPRI.Trending.TriggerDef class to initialize MaxTrendTime to 3600 seconds by default

• Modified TPRI.HMI.Forms.TrendSetupForm class to display an error message to the user if unable to retrieve the list of available trend sources from the host system

• Added design-time support for data dictionary window when selecting variable name for control properties such as TextBox.ProbeSource and modified various TPRI.HMI.Controls classes to use this object for design-time selection of variable names

• Removed pauses from installation scripts so that installer now runs to completion without periodically requiring key presses to continue

• Made various fixes to the Tsentry development and release environment:

• • Moved all source code into single solution and configured project dependencies

• • Changed all VB.NET projects to output to \bin\Debug\ and \bin\Release\ rather than just \bin\

• • Updated all scripts to reflect new project folder locations

   Upgrade Instructions:

• Modify application screens to replace obsolete OPC interfaces for host data with the new Probe interfaces and classes as follows:

• • Remove references to TPRI.OpcCom.dll assembly

• • Implement the TPRI.Probe.IProber interface if direct access to host variable data is required

• Modify sysProcs.ini file to add the ProbeSvr host process

• If custom logging of variable changes made through the ProbeSvr process is desired:

• • Modify the sysLogs.ini file to add a specialized LogMsg queue such as ProbeLog for probe variables changes:

#--------------------------------------------------------------
# LogMsg Initialization File
#--------------------------------------------------------------

[General]
# LogMsg file directory
LogMsgDir=%TSENTRY_SYSDIR%\%TSENTRY_SYSNAME%\Logs

[Queues]
ProbeLog       *

- Create and configure sysProbe.ini configuration file for the ProbeSvr process and specify the new LogMsg added above:

#--------------------------------------------------------------
# ProbeSvr Initialization File
#--------------------------------------------------------------

#--------------------------------------------------------------
# General probe parameters
#--------------------------------------------------------------

[General]
# Specify the LogMsg queue for variable change logging
LogMsgQueue=ProbeLog

• • Added code to check changed variable names to see if they are structures or ill-defined arrays and offer to automatically add variables for all structure sub-variables and array indices

• • Fixed naming of array elements when parent variable does not have enough empty array indices

• • Added popup menu items to expand and collapse all nodes

• Modified TPRI.HMI.Forms.DataDictForm so that array indices will be kept if possible when changing from one variable to another in the tree

• Fixed tpriGsmDDCom::getVarArrDim(..) function to correctly find array dimension for variable names corresponding to multi-dimensional arrays with only partially filled array indices

• Fixed TsecurityCfg application to correctly process changes to various user lists

• Fixed Texplore login screen to display language-specific labels & buttons

• Added additional exception handling to Tsecurity service functions that search for available domains

• • Fixed connection logic to prevent unhandled exception if the Tsecurity service is not running

• • Added code to display hourglass cursors during connection & authentication

• Fixed TPRI.HMI.Application.LoginMgr.LoginNotRequired(..) function to correctly set internal property values to prevent subsequent security timeouts

• Added TestSAK(..) function to TPRI.Tsecurity.LoginSession class

• Made various fixes to the TPRI.HMI.Controls.ActiveShape class:

• • Added code to check for changes to underlying ActiveShapeSetup configurations and automatically update display accordingly

• • Optimize painting routines to speed processing

• Made various internal modifications to TPRI.Shape classes to support above ActiveShape changes

• Made various fixes to the TPRI.HMI.Forms.DataDictForm class:

• • Fixed initial display of form to prevent warning message if previous search string fails to find any results

• • Added code to clear the search results any time the current data dictionary is changed to prevent accidental selection of a variable name not actually available in the current dictionary

• • Fixed initial display of form to prevent changing original value of variable when it cannot be found in the data dictionary tree

• Fixed TPRI.HMI.Screens.ProbeX screen to properly check user’s SAK for various privileges

• Made various changes to the TPRI.NtRtCommand.NtRtCmd class:

• • Changed subroutines to integer functions returning NtRtInfo.ErrorCode values

• • Added message box display to user to indicate errors writing files to host

• Made various fixes to the TPRI.Tscreen.TscreenMgr class:

• • Modified MaxBackgroundTime property so that setting property to a value of TimeSpan.MaxValue disables automatic disposal of the screen while in the background

• • Optimized routines to resize child forms to reduce total number of form layouts required

• Made various changes to the TPRI.DatabaseIO.DBIOHost class:

• • Added overridable property ConnectionString to allow derived classes to customize the specification of the database connection string

• • Added Shutdown() function to forcibly reset the database service connection

• • Added code to periodically clean up the database query cache

• Added overridable properties ServerName, PortNumber, and HostType to the TPRI.DatabaseIO.DBIOServer class to allow derived classes to customize the specification of the various connection parameters

• Made various changes to the TPRI.DatabaseIO.DBIOClient class:

• • Added public Shutdown() function to allow for destruction of communications channel

• • Added code to trap exceptions while unregistering .NET remoting channel

• Modified tpriGsmDDCom class to add additional error handling while formatting global common variable values with formatting strings listed in sysVars.ini

• Modified tpriProc class to move initialization of crash & invalid parameter handlers from Create(..) function to the class constructor to support special case uses of class

• Fixed restoration of TRENDCOM buffers in tpriTrendMgr to eliminate incorrect error messages

• • Fixed display of focus rectangle

• • Fixed default value of BorderStyle property so that setting the value to BorderStyle.None will force it to be written to the source code

• Modified TPRI.HMI.Forms.DataDictForm to remember and restore previous variable name and search string

• Fixed TPRI.HMI.Controls.TriggerConditionList and TPRI.HMI.Controls.TriggerTrendList to properly update display after change to cell values

• Numerous changes to trending HMI components to internally store times as integers rather than floating point numbers

• Made various fixes to the TPRI.HMI.Controls.TrendPlayback class:

• • Renamed various events to conform to .NET naming conventions

• • Fixed handling of End Time checkbox clicks to properly update displayed check state

• • Added attributes to numerous properties to prevent display in properties window and serialization in the designer

• • Added attributes to numerous properties to prevent display in properties window

• • Modified PlaybackMode property to be read-only (mode is set via SetPlaybackMode(..))

• Made various fixes to the TPRI.HMI.Controls.TrendCtrl class:

• • Renamed various events to conform to .NET naming conventions

• • Added DataUpdatedEventArgs class and changed parameters to DataUpdated event

• • Renamed updData(..) function to UpdateData(..)

• • Modified display of times to automatically determine number of significant digits to display

• • Fixed display of Delta Time to correctly show values greater than 60 seconds

• • Fixed display of Delta values when data is not available for one of the cursors

• • Modified graph initialization so that the time between the first and last points displayed in the graph is exactly the specified width

• • Added code to automatically force graph width to be an integral multiple of sampling period

• • Added attributes to numerous properties to prevent display in properties window

• Renamed TPRI.Trending.PB_1SECPERSEC constant to PB_REGULATESPEED

• Fixed TPRI.Trending.TrendSetConverter classes to prevent exception when loading empty TrendSet

• Fixed TPRI.Trending.TriggerDef and TPRI.HMI.Controls.TriggerStatusList classes to properly read and write trigger save times in various disk files

• Fixed TPRI.HMI.Screens.TriggerMgr screen to correctly lock down Activate and Deactivate buttons based on user’s security level

• Modified tpriLogMsg class to allow shared read operations when opening log files

• Modified tpriIniFile::extractIniFileString(..) to return an error if a quote-delimited string is not immediately followed by a whitespace character

• Added RemXTimer(..) functions to tpriTimer libraries

• Added dynamic trend time and dynamic trend timeout variables to TRENDCOM global common

• Made various changes to tpriTrendSrv class:

• • Fixed processing of trend data requests to correctly interpret a relative start time paired with an absolute end time that comes before the latest recorded data

• • Modified requests for dynamic trend variables to allow data storage on disk and to use sysTrend.ini file variable to specify trend storage time

• Modified tpriTrendMgr to parse both dynamic trend time and dynamic trend timeout variables from sysTrend.ini file into TRENDCOM global common

• Fixed tpriGsmDDCom data dictionary initialization to remove check and warning message during parsing of variable formatting string as error detection is now in tpriIniFile::extractIniFileString(..)

• Fixed parsing of __int64 variable init/min/max values during data dictionary initialization

• Added error messages to tpriProc::shutdownMgr(..) if invalid mode passed to function

• Changed shutdown request processing in NtRtMgr to use InitiateSystemShutdownEx(..)rather than ExitWindowsEx(..)to shutdown and/or reboot the system

• Made various changes to GsmPifBld process:

• • Fixed parsing of union variables that explicitly specify the ‘union’ keyword

• • Fixed parsing of C-style comments that are broken across multiple header file reads

• • Fixed parsing of multi-line C-style comments started on the same line as a compiler directive

• Made various changes to NtRtSvc process:

• • Added support for '$'-enclosed environment variables in installation strings to allow specifying environment variables in the registry entries

• • Modified installer to update binary path and command line parameters if service is already installed

• • Modified installer to specify .\Tsentry user for service

• • Added additional event log messages and error code returned to user if service fails to start

• • Added additional configuration feedback when displaying installation information

• Updated components to support Ardence RTX 7.0

   Upgrade Instructions:

• Modify project properties for all RTSS versions of all processes as follows:

• • Remove the “/QIfist” flag from the C/C++ → Command Line setting

• • Set Manifest Tool → Input and Output → Embed Manifest to No

• • Fixed Paste operation in to properly update underlying ProbeSet object

• • Fixed handling of escape key to revert a modified probe variable to its unmodified value

• Added Debug versions of static link libraries tpriNtRtAppd.lib and tpriNtRtNETd.lib to TSENTRY distribution files

• • Moved NtRtCmd processing code directly into NtRtMgr process itself

• • Changed scope of parseGrpdef(..), parseProdef(..), and parseTrapCrash(..) from private to public

• Modified macros in tpriUtilMacs.h to surround all function arguments with parentheses to prevent unexpected results when calling functions as part of a larger expression

• Fixed Release versions of tpriNtRtApp.lib and tpriNtRtNET.lib to correctly use 32-bit time functions rather than new 64-bit time functions

• Made various changes to the NtRtMgr process:

• • Added code to optionally delay TSENTRY startup and display a countdown timer to allow console user time to cancel startup

• • Fixed shutdown option processing to correct potential multithreading pitfalls

• Made various changes to the NtRtSvc process:

• • Added numerous logs during service installation

• • Added ‘-installdefault’ command line option to simplify service installation

• Fixed non-RTX version of tpriCreateSharedMemory(..) to properly set the last error code to ERROR_ALREADY_EXISTS when shared memory already exists

• Fixed TPRI.HMI.Controls.ActiveShape to force text and shape to be visible when changing from an blinking state to a non-blinking state

• Modified TPRI.HMI.Controls.TextBox so that text will not be automatically reset when OPC disconnects if the tDataSource member is an empty string

• Added TPRI.Trending.TrendMgrStatus enumeration

• Added Status property to TPRI.HMI.Controls.TrendCom class

• Added TPRI.Trending.ProbeMgrStatus enumeration

• Added Status property to TPRI.HMI.Controls.TrendCom class

• Made various changes to the TPRI.HMI.Controls.TrendVarList class:

• • Fixed processing of Label cell changes to correctly update the Label, not the Variable

• Fixed the Trend Setup form on the TrendX screen to update the trend sources displayed on the Trend Variable list when the Set All Variables button is clicked

• Changed the data dictionary form so that it is not displayed in the Windows taskbar

• Created new TPRI.HMI.Controls.TextSelectBox class as base class for text box with a [*] button to display popup selection box and completely reworked DDVarSelect and TrendSrcSelect classes to inherit from this parent class

• Made various changes to the TPRI.HMI.Controls.OpcMgr class:

• • Added public RestartComm() method

• • Modified trapped exception handling during data updates so that error message boxes are generated only one at a time

• Fixed TPRI.HMI.Screens.ProbeX screen to properly display elements of multi-dimensional arrays

• Fixed TPRI.HMI.Screens.TrendFileMgr screen to use correct shared folder name for historical trend data files

• Added TPRI.NtRtCommand namespace and ShutdownOptions, AppShutdownOption, and AppShutdownOptionCollection classes as well as AppShutdownOptionType and AppShutdownOptionFunction enumerated types to that namespace

• Modified TPRI.NtRtInfo.INtRtInfo interface and TPRI.NtRtInfo.Client and TPRI.NtRtInfo.Host classes to add GetShutdownOptions(..) functions

• Added Shutdown button and code to send request to host to TPRI.HMI.Screens.NtRtMgr form

• Fixed TPRI.HMI.Application.TsecurityMgr so that Accessed events raised by secured objects only reset the expiration time if the object is not yet expired

• Made various changes to the Texplore application:

• • Added code to save size and position of window and restore on restart

• • Added code to save most recently used host and application names and restore on restart

• • Added indicators for OPC and Trend communications

• • Fixed window sequencing when Tsecurity host cannot be reached during login

• • Added code to handle Enter key presses from domain combo box on login screen

• • Disabled Change Password button for functionality not yet completed

• • Added default icon for application

• Added code to TPRI.Tscreen.TscreenMgr to detect when the parent container is closing and disable auto-navigation that is normally processed when the active form is closed

• Added additional error handling to TPRI.Tscreen.TscreenInfo to trap exceptions during creation of custom application screens

• Added icons to Tsecurity and TsecurityCfg processes

• Updated code base to use various secure CRT functions under VS2005

   Upgrade Instructions:

• Update the \tpriNtRt\bin\NtRtInfo.exe.config file to add a <SharedFile> key with the name set to SysIni and Path set to the system.ini file, as in the following:

<SharedFile>
   <Name>SysIni</Name>
   <Path>%TSENTRY_SYSDIR%\%TSENTRY_SYSNAME%\pif\%TSENTRY_SYSNAME%.ini</Path>
</SharedFile>

• Update the sys.ini file to configure a DelayStartupTime parameter in the [AppParams] section, if desired

• • Visual Studio .NET 2003 and Visual Studio 6.0 are no longer supported in any way by versions of  TSENTRY v4.00.00 or greater

• Moved HMI environment from Internet Explorer to Tsentry Screen Explorer (Texplore)

• Removed following portions of TSENTRY:

• • TSENTRY and application \wwwroot\ folders no longer required or created by installation

• • TSENTRY \Modules\ folder is no longer supported of created by installation

• • All application file shares (DataSet, Trigger, NtRtCmd, etc.) no longer required as the NtRtInfo service now provides enhanced functionality

• • Local tpriHmi user no longer required or created by installation

• • tpriPublisher no longer required or included with installation

• • tpriTrigText application removed in favor of standard TSENTRY screen TrendFileMgr

• • Removed all HMI-related assemblies in favor of classes exposed by TPRI.Core.dll

• • Removed Probe, ProbeA, and ProbeV screens in favor of ProbeX

• Several standard TSENTRY functions are temporarily excluded from this release, including:

• • tpriNtRtAdmin application not included with release

• • Custom HMI screens not yet explicitly supported

• Added links to ASCFEditor and TsecurityCfg application to both TSENTRY and Tsecurity installers

• Updated Workstation Configuration document in TsentryHelp to support Texplore installation

• Integrated classes from TPRI.Cryptor assembly into TPRI.NtRtNET assembly

• Updated all scripts to require and use the .NET Framework v2.0 rather than v1.1

• Moved .NET components from tpriNtRt.lib into separate tpriNtRtNET.lib library

• Removed CreateShares.cmd, ExportDataDict.cmd, InstallFiles.cmd, InstallIISCustom.cmd, InstallIISCustomFiles.cmd, and InstallIISCustomSite.cmd scripts

• Added TPRI.HMI.Application.AppVariableCollection class

• Made various changes to the TPRI.HMI.Application.AppConfig class:

• • Added HmiConfigSharedFolder constant field

• • Added CurrentCulture, CurrentLanguage, and Title properties

• • Changed AppVariables property from StringDictionary to AppVariableCollection

• Removed LoadStringDictionary(..) function from TPRI.HMI.Application.AppLib module

• Added TPRI.HMI.Application.Explorer namespace, including ITexplore interface and FindExplorer(..) function

• Added LinkLabel class to TPRI.HMI.Controls namespace

• Added TPRI.HMI.Application.TsecurableObject class

• Moved login-releated portions of TPRI.HMI.Application.TsecurityMgr into new LoginMgr class and reworked TsecurityMgr to better manage security session

• Moved shape-related enumerated types and classes into TPRI.Shape class

• Renamed TPRI.Shape.Shapes enumerated type to TPRI.Shape.ShapeTypes

• Updated TPRI.HMI.Controls.ActiveShape and TPRI.HMI.Controls.BarGraph classes to work with new TPRI.Shape namespace

• Made various changes to the TPRI.HMI.Controls.CmdButton class:

• • Modified class so as to inherit directly from System.Windows.Forms.Button

• • Deprecated tURL property and replaced with LinkedScreen property

• • Deprecated tText property in favor of standard Text property

• • Removed unnecessary ButtonControl property

• Changed pMgr internal variable of TPRI.HMI.Controls.BaseControl class from generic Object type to TPRI.HMI.Controls.OpcMgr

• Made various changes to the TPRI.HMI.Controls.CmdButtonCollection class:

• • Added CmdButtonCollectionEventArgs subclass

• • Modified Click event signature to pass reference to CmdButtonCollectionEventArgs object

• • Added IndexOf(..) function

• Made various changes to the TPRI.HMI.Controls.DDVarSelect class:

• • Completely reworked class so as to inherit directly from System.Windows.Forms.Button

• • Removed various old class events exposed directly by System.Windows.Forms.Button

• Remove all events from TPRI.HMI.Controls.DDVarSelectCollection class

• Made various changes to the TPRI.HMI.Controls.OpcMgr class:

• • Completely reworked class to support switching between screens in Texplore

• • Added StopComm() and Reset() methods

• • Changed existing parameter to StartComm(..) to pass by value and added additional parameter to point to the root control to search for active objects

• Made various changes to the TPRI.HMI.Controls.TrendCom class:

• • Completely reworked class to support switching between screens in Texplore

• • Changed existing parameter to StartComm(..) to pass by value and added additional parameter to point to the root control to search for active objects

• • Added StopComm() method

• Removed TPRI.HMI.Screens.BaseScreen class

• Implemented internals of TPRI.NtRtInfo.Host.GetHmiConfig(..) function

• Added TPRI.DatabaseIO namespace and classes

   Upgrade Instructions:

• Before installing the new version of Tsentry:

• • Uninstall previous version of Tsentry via Control Panel→Add/Remove Programs

• • Uninstall previous version of Tsentry HMI via Control→Add/Remove Programs

• • Download and install .NET Framework v2.0 from Microsoft

• • Remove \tsentry\ and custom application virtual web shares from IIS

• • Copy the existing %TSENTRY_SYSDIR%\tpriNtRt\wwwroot\web.config file into %TSENTRY_SYSDIR%\%TSENTRY_SYSNAME%\HmiConfig\ or equivalent folder and rename as TsentryHmi.xml

• • Copy the existing web.config file from any custom application virtual web shares into %TSENTRY_SYSDIR%\%TSENTRY_SYSNAME%\HmiConfig\ or equivalent folder and rename as <Application>.xml, where <Application> matches the name of the old virtual web share

• • Remove the folders used as the virtual web shares for any custom HMI applications (typically only %TSENTRY_SYSDIR%\%TSENTRY_SYSNAME%\wwwroot\)

• • Using Windows explorer perform the following to %TSENTRY_SYSDIR%\tpriNtRt\

• • • Remove the \Apps\ subfolder

• • • Remove all files from the \bin\ subfolder except NtRtInfo.exe.config

• • • Remove the \Modules\ subfolder

• • • Remove the \wwwroot\ subfolder

• After installing the new version of TSENTRY:

• • Remove any post-build operations that copy data dictionary files to web shares from data dictionary project settings in application development environment (web shares no longer exist)

• • Moved initialization of crash handler from PrIni(..) to Create() in order to support processes not listed in sysProcs.ini file

• • Modified Create() function to disable popup message boxes for ASSERTs

• • Changed destructor so that process state is left as tpriProcStopping rather than resetting to tpriProcStopped (NtRtMgr/tpriProcMgr will reset the value when process exits)

• Made various changes to the tpriProcMgr class:

• • Modified function that checks if processes are still alive to withhold log message indicating that process is no longer alive if process state is tpriProcStopping (due to above change to tpriProc destructor)

• • Modified function to adjust the internal clock drift rates to disable RTX clock tracking if RTX is not installed on the system (prevents error message on non-RTX systems)

• Fixed AddXTimer(..) function prototypes in tpriTimer.h

• Changed LogMsg(..) so that displayed process name is taken from sysProcs.ini file or executable file name rather than first passed function name

• Fixed logging of memory buffer rollovers in TrendMgr to log correct memory buffer size

• Changed calling parameters to tpriGsmDDCom::varDef::fmtXXX(..) functions to include size of destination buffer

• Removed try/catch from tpriGsmDDCom::varDef::fmtXXX(..) in tpriNtRt.RTSS.lib library

• Removed tpriLogMsg::fileLogMsgs(..) function from tpriNtRt.RTSS.lib library

• Fixed tpriGetClockTime(..) function to correctly use RTX timer for Win32 processes on an RTX system so that absolute timer values are consistent between Win32 and RTSS processes

• Fixed non-RTX version of tpriCreateSharedMemory(..) to properly set the last error code before function returns

• Increased size of error message buffer in tpriSvrSock constructor to prevent buffer overruns

• Made various changes to the GsmPifBld process:

• • Added support for use of sizeof(..) in array bounds

• • Added support for mixed hexadecimal and decimal math in array bounds

• Reorganized code in main(..) function of NtRtSvc to clean up sequencing

• Fixed Tsecurity installer to include Interop.ADSecurity.dll in \bin\ folder

• Fixed TPRI.Tsecurity.Client class so that internal .NET remoting channel is properly disposed

• Made various changes to the TPRI.Tsecurity.LoginSession class:

• • Added Copy(..), CopyTo(..), CreateCopy(), and UpdateExpiration(..) methods

• • Added Expired, Timed, ExpireTime, and AllowedAcces properties

• • Removed UsingDefaultSAK property

• • Changed name of ResetLogin() function to Logout()

• • Changed name of SessionTimeout property to Timeout

• Changed default property values in TPRI.Tsecurity.TsecuritySettings class from shared properties to simple public constants

• Modified TPRI.Tsecurity.Host class so that user information will not be removed from the cache if authentication fails because the network is unreachable

• Fixed HMI security functions in SecurityDef module to properly treat SAK as a 64-bit integer

• Changed securityLevel parameter on all SecurityScreen(..) functions to a 64-bit integer

• Upgraded Glacial Components to GlacialListview v2.0.3.2204  and GlacialTreeList v2.3.2.21597

• Fixed TPRI.DataDictionary.TreeDataDict class to properly create, track, and destroy references to the tpriGsmDDCom classes

• Made various changes to the TPRI.HMI.Application.AppConfig class:

• • Changed initial value of TsecurityHost property from MachineName to an empty string

• • Changed initial value of TsecurityPort property from hardcoded 8080 to TsecuritySettings.DefaultPortNumber

• • Fixed parsing of TsecurityPort from config file to force default value if exception occurs

• Fixed TPRI.HMI.Application.ScreenConfig class to properly load ClassName from XML file

• Made various changes to the TPRI.HMI.Application.ScreenConfigCollection class:

• • Implemented ISerializable interface and added constructor for serialization

• • Removed unnecessary ScreenConfigs property

• Added BarGraph, ComboBox, ComboBoxCollection, CoverageBar, and LogMsg classes to TPRI.HMI.Controls namespace

• Made various changes to the TPRI.HMI.Controls.DDVarSelect class:

• • Modified DataDictNames property set method to automatically choose first data dictionary name as current data dictionary if none has already been chosen

• • Added InitialDataDictDisplay property

• • Added ShowDataDict() method

• Added check to TPRI.HMI.Controls.OpcMgr to verify valid internal references before processing data updates to eliminate potential null reference exception

• Added Remove(..) method to TPRI.HMI.Controls.TextBoxCollection class (shadowed Remove(..) base class function) to unhook event handlers when removing items from collection

• Completely reworked all trend-related classes in TPRI.HMI.Controls namespace to use GlacialControls lists and trees rather than TelePro-developed objects

• Removed TrendVarListBase, TrendingVarListBase, TrendingVarDateTimeList, ListViewEditor, and OwnerDrawnListView from TPRI.HMI.Controls namespace

• Fixed TPRI.HMI.Controls.TriggerStatusList.ColumnWidths property set method to validate inputs

• Made various changes to the TPRI.HMI.Forms.DataDictForm class:

• • Added several checks for valid data to prevent null reference exceptions

• • Added Enter key handler for variable name box to process like an Accept button press

• Changed name of TPRI.HMI.Forms.QueryContinueForm.Continue property to Result in order to avoid conflict with known keyword ‘Continue’

• Implemented ISerializable interface and added constructor for serialization to TPRI.Languages.LanguageTable class

• Made various changes to the TPRI.Languages.LanguageTable class:

• • Implemented ISerializable interface and added constructor for serialization

• • Added FindPhrase(..) method

• Renamed the TPRI.NtRtInfo.INtRtInfo.GetAppConfig(..) function to GetHmiConfig(..) and added additional security-related parameters

• Made various changes to the TPRI.NtRtInfo.Host class:

• • Added DefaultPort constant field

• • Changed GetAppConfig function to GetHmiConfig to conform to updated INtRtInfo interface

• • Fixed GetSharedFilePath(..) function to catch illegal attempts to access parent directories of shared folders

• Changed ServiceName of NtRtInfo service from Service1 to NtRtInfo

• Fixed TPRI.Probe.ProbeSet class to properly read/write Format string from/to ProbeSet files

• Added Tag property to TPRI.Trending.TrendSet class and completely reworked helper classes

• Changed name of TPRI.Trending.TriggerDef.Operator property to Comparator in order to avoid conflict with known keyword ‘Operator’

• Made various changes to TPRI.HMI.Screens.ProbeX class

• • Changed text in popup menu items to read ‘Variable’ rather than ‘Probe’

• • Added ‘Edit Variable’ popup menu item

• • Fixed display position of popup menu to correspond with mouse position