Last revision: 02/14/2007
This document contains important information about WonderwareÒ InTouch 9.5 with SP1. Review this document for known issues in this version and changes to the InTouch documentation included on this CD.
Upgrading from a
Previous Version
Resolved Issues –
InTouch 9.5 with SP1
Known Issues – InTouch
9.5 with SP1
Known Restrictions for Limited Users – InTouch 9.5 with SP1
Known Issues – InTouch Documentation
The language switching features in InTouch have been changed in InTouch 9.5 SP1. For more information, see the Localizing Alarm and Tag Comments document (LanguageSwitching.pdf) in the C:\Program Files\Wonderware\InTouch folder.
To run InTouch, we recommend at least the following software and hardware configurations:
Software
Requirements
Microsoft® Windows® Server 2003 with Service Pack 1 or
Microsoft® Windows® Server 2003 R2 or
Microsoft® Windows® 2000 Server with Service Pack 4 or
Microsoft® Windows® 2000 Advanced Server with Service Pack 4 or
Microsoft® Windows XP Professional with Service Pack 2 or
Microsoft® Windows® XP
Tablet PC Edition
Hardware
Requirements
PC with 1.2 gigahertz (GHz) or faster processor
512 MB memory minimum, 1 gigabyte recommended
At least 4 gigabytes (GB) of available hard disk space
Super VGA (1024 × 768) or higher resolution video adapter and monitor
CD-ROM or DVD drive for installation
Keyboard and mouse or compatible pointing device
Microsoft Windows Server
2003 Support and Requirements:
Note: Windows Server 2003 Terminal Server does not allow two clients to login with the same user ID. Each Terminal Services session has to have a unique user ID to connect to the Windows Server 2003 Terminal Server.
InTouch 9.5 with SP1 can be installed on a system without an existing installed version of InTouch or it can be installed as an upgrade to a system that already has InTouch 8.0 or later.
When upgrading from InTouch 8.0, the installation procedure detects which components are already installed on your system and updates your system accordingly. Adding components or removing any existing installed components during the upgrade is not recommended.
Upgrading to InTouch 9.5 with SP1 may require a reboot if the Microsoft MDAC version currently installed on the system is not up to the prerequisite version level required. InTouch 9.5 with SP1 requires, as a minimum, MDAC 2.7 SP1 for Windows 2000 and Windows XP Professional, and MDAC 2.8 for Windows Server 2003. The MDAC version is automatically checked during the installation procedure.
If you are upgrading from InTouch 7.11 or prior to InTouch 9.5 with SP1, uninstall InTouch before you install the new version.
If InTouch 7.11 is installed on your system and you have Alarm DB Logger set to run as a service, change the service mode to manual before you uninstall InTouch and reboot your system. You must also ensure that this service is not running before you install InTouch 9.5 with SP1. Otherwise, the installation cannot update the files properly. If you uninstall InTouch 7.11 with Alarm DB Logger in automatic mode, the InTouch 9.5 with SP1 installation will not complete properly.
Install InTouch Terminal Services on a dedicated server. We strongly recommend that you do not install InTouch Terminal Services on any computer that also acts as a database server (such as IndustrialSQL Server), RAS server or PPTP server.
InTouch and InTouch Terminal Services are not supported and should not be installed on a system that is configured to be a domain controller. InTouch Terminal Services is designed to perform like Windows 2000 Professional at the end-user level: it does not assign top priority to critical domain-level processes. Installing InTouch Terminal Services on any of these servers can significantly degrade performance.
Important Note: If you must copy the whole InTouch CD to a folder on your hard drive first and then run the installation from this folder, the full path name of this folder should not have a blank space in it. This does not affect users installing InTouch directly from the CD.
The font size of internal windows for the
RecipeSelectRecipe() function in runtime and for the SQL Access Manager Bind
list and the Table template in development is too small to be read. L00055732: Unable to download or
update application on NAD client if source application includes SmartSymbol
templates and the client is logged on to windows as a Power User. L00056756: Translation
associated with text phrase is erased when the text in the original text object
is changed and exported again. L00060622: Using "%" in the
LogMessage() function can crash WindowViewer. The input field for the Analog and/or String user input
links can be resized with the mouse pointer when there is a setting in the
InTouch.ini file for Resizable InputLink in the [InTouch] section. The Resizable
InputLink setting must use a non-zero value for the resizable input field. After
the Input field is resized the first time, WindowViewer adds two more settings
in the InTouch.ini file, Resizable InputLink Width and Resizable InputLink
Height, for the width and height (in pixels) of the Input field dialog. You can
change these settings manually. Example:
The quality dot field of a Remote Reference IO Tag from a
Tag Server is not updated correctly and is stuck at 192.
L00054233: Opening windows and displaying remote reference
tag values degrades over time.
Remote references to Galaxy IO tags, using
IOSetRemoteReferences() to display .#VString and .#QString values degrade over a
period of time.
L00054252: Font size in
internal windows, the SQL Access Manager Bind list, and the Table template is
too small to read.
L00054614: Duplicate PhraseID for text objects in exported
language XML file
Duplicating an existing InTouch window containg text
objects resulting duplicated PhaseID in the exported language XML file.
L00054763: New setting in InTouch.ini setting to allow
.Quality to be set for Clamped Low or Clamped High state.
New setting
"SetQualityClamp=1" in the InTouch.ini file (in the Application directory) to
allow .Quality to be set for Clamped Low(85) or Clamped High(86) state. If
"SetQualityClamp=0" or if it is not present in InTouch.ini file then the
.Quality will not be clamped when the tag value is beyond its limits.
L00055088: In AlarmDBViewCtrl, ACK_RTN value is not correct
for Expanded Summary ACK Model alarm
If a tag is configured as an Expanded Summary ACK Model
alarm, the value field is not updated properly when the Alarm State changes to
ACK_RTN.
Note: The fix only applies to alarms newly
generated by InTouch 9.5 SP1.
If an InTouch application has
SmartSymbol templates (i.e. there are subfolders/files in the Symbol folder),
downloading the application to a Terminal Services session generates
an error dialog "NAD unable to download new application" and the info
message "NAD could not copy directory . . ." is logged.
L00056377: On dual-core PCs, AlarmMgr.exe
tries forever to connect to providers, even when InTouch View.exe is shut
down.
On multi-core or multi-processor PCs, during window
compilation of View.exe startup, AlarmMgr.exe attempts to make connections to
any alarm providers specified in AlarmViewerControl queries. If
a connection was successful, it remains open subscribing to
alarms. If the connection was not successful, AlarmMgr.exe keeps trying and
repeatedly writes "Attempting to Connect to Provider" messages to the
logger. AlarmMgr.exe does this even though there is no client (such as
View.exe's AlarmViewerControl) interested in the alarms.
Translation field of the text phrase is erased when the
text in the original text object is changed and exported again.
L00056879: Tooltips are not translated properly during the
Language switching process.
Duplicating an object that has the static text tooltip
configured results in the duplication of the phraseID, and the translation of
the tooltip is not working properly.
L00057173:
InTouch application with Access Names configured for Failover leaks
handles.
InTouch
application crashes after running for around 15 hours. This application contains
Access Names configured for Failover.
L00059184:
Tag count in an InTouch application is not matched with the tag license.
Tag count is not matched with
the tag license and an error message pops up when activating a remote tag
"Attempt to activate remote tags failed. Exceeded Maximum Number of Remote
Tags."
L00059228: AddPermission does not
work with both a Parent Domain and a Child Domain.
When there is a Parent Domain
and a Child Domain then AddPermission only works for the domain that the
computer is a member of (as seen in Control Panel/System).
L00060620: Switching between windows in an InTouch
application a few times, shut down WindowViewer, then View.exe crashed.
In an InTouch application
which connects to a galaxy, switching between InTouch windows a few times
then shutting down WindowViewer caused View.exe to crash.
WindowViewer crashes when using "%" in the LogMessage()
script function, e.g. LogMessage( "%Z" );
L00060624:
AlarmMgr.exe Process Affinity can not be configured through registry keys.
In a PC with more than one CPU
(Dual-core, Quad-core ...), the AlarmMgr.exe Process Affinity can be configured
as follows. (If there is no registry setting, AlarmMgr.exe uses all available
CPUs by default.)
HKEY_LOCAL_MACHINE:Software\Wonderware\AlarmManager
DWORD value CPUAffinityMask
is a bit value
of the CPU you want alarm manager to use.
Example for Dual-core:
1 = CPU0, Value 2 = CPU1, value 3 = CPU0 AND CPU1.
DWORD value CPUAffinityState
0 = default =
apply specified affinity mask, or else ALL CPUs if "CPUAffinityMask" is missing.
1 = apply
affinity to all available processors, regardless of the "CPUAffinityMask"
setting
2 =
don't do anything at all, let the OS decide what to do with the process (limited
testing is, it has affinity for all available processors).
L00060771: Implement Tag Comment and Alarm Comment Language
Switching in InTouch 9.5 SP1
Tag comment and Alarm comment can be localized
through language switching feature in InTouch 9.5 SP1.
L00061213: Remote Tags do not update when View is started
in InTouch TSE.
In an
InTouch TSE application, if there are I/O tags (ITag1, DTag1) and an access
name ("MyAccessName") that refers to the local machine, using View.exe as an
application name and Tagname as a topic name, the value display for the remote
reference MyAccessName:DTag1 or MyAccessName:ITag1 does not display properly
when View.exe starts.
L00061247: aaLogger.exe uses 100%
CPU.
Corrupted log file can
cause aaLogger.exe to run at 100% CPU.
L00061465: View.exe crashes if set as service and using
logoncurrentuser() script function with OS security.
View.exe crashes if it is set as a service and you
are using the logoncurrentuser() script function with OS security.
L00061995: The input field of a user input animation link
should be resizeable in size and font to fit high resolution screen
settings.
[InTouch]
Resizable InputLink = 1
Resizable
InputLink Width=300
Resizable InputLink
Height=50
If the alarm database contains old data records that are
not configured for language switching (which do not have the two-character
application ID) and new records configured for language switching (which are
prefixed with the two-character application ID), you can not use alarm comment
queries that use the operators <, <=, >, and >=.
During the Installation Wizard, a button becomes available to open the Installation Guide online help. The online help opens and then reports that the page cannot be found. Security patch 896358 from Microsoft prevents .chm files from opening from a remote location. For more information, see Microsoft’s website.
The WinXML Exporter in SuiteVoyager 2.5 is not compatible with application files created with InTouch 9.5. These are therefore not supported with SuiteVoyager 2.5 or earlier. Existing SuiteVoyager applications are not affected. Please refer to the Wonderware Technical Support website for an updated version of WinXML Exporter.
You may edit a SmartSymbol that includes placeholder tagnames or local tagnames using the Replace function. If an edit is made to an undefined tag, the replacement is not made.
If you create a SmartSymbol using foreign characters in the name, when you import that SmartSymbol into InTouch using English, the characters in the name are random ANSI characters.
Animation scripts in SmartSymbols get lost if there is a reference to a Quick Function and the function is not defined in the target application.
You cannot undo a string substitution of a text object embedded within a SmartSymbol if the string substitution is performed during a SmartSymbol Edit operation. To work around this limitation, cancel the SmartSymbol Edit operation and start over.
When you are using Language Switching, the caption on a SmartSymbol button is not translated if the SmartSymbol was edited and the changes committed. The workaround is to re-export and import the dictionaries.
To avoid resizing issues when replacing text, we recommend using substitute strings rather than the SmartSymbol properties.
After migrating applications developed in 9.0, you may see problems. These problems appear when you:
Additionally, you can see:
If any of these happens, do the following:
If a SmartSymbol size increases to more than 32 KB, you see this error.
If you export a language dictionary, do not export it to a folder that has another exported language dictionary. Always export your language dictionary to a folder by itself.
If you migrate the same AlarmSuite database two or more times, AlarmSuite History Migration duplicates the data and does not overwrite all the data. To avoid this, don’t migrate the same AlarmSuite database two or more times.
“Trying to assign to a read-only name" error message appears when converting an 8.0 application to 9.5. This error occurs because of the read-only tag ($False) introduced for the replacement of the read-write $AlarmLogging and other four obsolete system tags in InTouch 9.5. The $False tag is a discrete read-only tag so as to restrict the usage of this dummy tag.
Also, if the Window script uses $AlarmLogging expressions and tries to update the read-only $False tag, the entire script is removed from the Window script and the entire script code is logged in the SMC logger. This helps you modify the Window script with the correct code accordingly.
AlarmDBLogger skips the alarm records if the master record is not present in the database. AlarmDBLogger skips the sub state change alarm records if the master record (equivalent ALM record) is not present in the database.
This situation can occur if an Alarm Database Purge is performed while there are tags in an alarm state. Changes to the alarm state of these tags are not logged.
When NAD is used in a Terminal Server implementation, it is common for the NAD Master and the client copies of the InTouch application to reside on the same node. In this situation, it is unlikely that you are sharing the NAD Master folder.
If you are using Windows 2003, the NAD Master folder must be shared even if all files are on the same machine. Failure to do so results in a NAD failure to copy error when the client launches View.
In an InTouch TSE Console session, a Distributed Alarm Object or Alarm Viewer using a query configured in the Distributed Name Manager does not display alarms if a platform starts before WindowViewer. Standard queries like \\<NodeName>\InTouch!$System work in this scenario. Starting WindowViewer before the Platform also works.
Adding the following entry to the InTouch section of the Win.ini in the Windows folder before starting WindowViewer, makes the alarm query configured in Distributed Name manager work properly.
ApplicationDirectory=<Full Path to the current application>
This is a problem only in the Console session, not Terminal Server client sessions.
WindowMaker
Errors may be encountered when using the FastSwitch to open WindowMaker from View running an application that is logging historical data and is using some retentive tags, and is currently getting live updates.
If you change the color of text on a button object using the Text Color tool in WindowMaker, the default settings for button text in the WindowMaker configuration are not updated with the new color. For text-only objects, the default color is updated.
1. In an InTouch application, the following conditions lead to 100% CPU and the condition script will go to an infinite loop:
- An I/O discrete tag
(DTag1) refers to itself as an item name in an access name, e.g. MyAccess.
- A condition script resets
the discrete tag value to FALSE.
- A User Input link sets the discrete tag value to TRUE.
- A value display link
displays the discrete tag as a remote reference, e.g. MyAccess:DTag1
To work around this issue, the value
display link should be changed to DTag1.
2. A condition script will execute multiple times in the
following conditions:
- An I/O
discrete tag (DTag1) refers to another I/O discrete tag or memory discrete tag
as an item name in an access name, e.g. MyAccess.
- A condition script resets
the discrete tag value to FALSE.
- A User Input link sets the discrete tag value to TRUE.
It can take up to 3 minutes for a client to detect the loss of network connection and switch to backup.
This is a TCP/IP timing issue in Windows.
The Alarm Tree Viewer ActiveX Control is successfully
tested with an approximate maximum of 500 Alarm Groups. The maximum number of
Alarm Groups that can be displayed depends on various factors, including the
Alarm Providers used and the total length of the Alarm Group names returned.
When the maximum number of Alarm Groups in the Alarm Tree Viewer ActiveX Control
is exceeded, no Alarm Groups are shown, and the following statement is found in
the Log Viewer (in the System Management Console): “Failed to retrieve the alarm
groups from the alarm subsystem provider All Providers.”
Remote tag references are not supported in Recipe Manager.
If you are using the cross reference utility and you are
searching SQL, SPC, and Recipe at the same time, an error may occur if the
recipe file (recipe.csv) has more than 2048 characters in any one line.
L00025890: Some dialog boxes are not
modal
The following dialog boxes can lose focus and slip behind other windows:
- Windows to Close dialog box
- Change Password dialog box
- Configure user dialog box
- Open Window dialog box
- Close Window dialog box
- ODBC Data Source Administrator dialog box
Do not click on other applications or windows before closing these dialog boxes. If you do, you may need to restart View to correct the problem.
In the Shutdown dialog box, all the buttons are active for non-admin users if the script EnableDisableKeys(1,1,1) is executed. Click on EnableDisableKeys(0,0,0) button to reset the settings.
The other shortcut keys like Ctrl+Esc, Alt+Esc, WinKey+E and so on are disabled.
If the alarm database name contains double-byte characters, you cannot recreate tables using the Restore utility.
Do not reference an I/O tagname linked to an access name with DDE type communication from an Asynchronous Quick Function.
You can resize the object up to 9999 using the status bar.
You can resize the object further using the mouse.
If you are using the Windows XP theme, in InTouch when you open and close windows whose placement is based on calculations using $ObjVer and $ObjHor, you may experience positioning errors.
You cannot open an application in WindowMaker if the base path directory contains 114 or more characters. The default directory and the application directory together must be fewer than 114 characters.
On Windows 2000 only certain TrueType fonts work correctly. A simple work around is to use the fonts that work for those specific phrases in the Dictionary.
Japanese
|
Lucida Sans
Unicode |
Microsoft Sans
Serif |
MS Gothic |
MS Mincho |
|
MS PGothic |
MS PMincho |
MS UI Gothic |
NSimSun |
|
SimHei |
SimSun |
Tahoma |
|
Simplified Chinese
|
Microsoft Sans Serif |
NSimSun |
MS UI Gothic |
SimSun |
Tahoma |
When an AccessName is configured for the secondary node, the secondary configuration information is stored internally as another AccessName with the string _SEC appended to the AccessName's name. For example, if AB_HFPP is the AccessName for which the secondary node is configured, then two access names are created internally named AB_HFPP and AB_HFPP_SEC. If a new AccessName is also created with the name AB_HFPP_SEC, this AccessName will conflict with the already existing AB_HFPP_SEC file. The workaround for this is to modify either of the AccessNames so that their names should be different, such as AB_HFPP and AB_HFPP2.
Although InTouch 9.5 with SP1 can be run by Limited Users, certain features and operations will not be supported for Limited Users. We recommend that users who configure InTouch applications have Power User privileges. The following operations are not supported for Limited Users:
The following table describes changes to the documentation.
Item |
Location of Change |
Existing Documentation |
Change |
|
1 |
None at this time |
None at this time |
None at this time |
The InTouch documentation set is provided in PDF format (except the Installation Guide) and can be printed. Viewing these user's guides requires installation of Adobe's Acrobat Reader. This utility is not included on this CD, but you can download it for free from Adobe's website at the following web address:
www.adobe.com/products/acrobat/readstep2.html
After downloading the file from Adobe, you must run the executable to install it on your PC. Follow the typical installation routine. After installation, you can either start the Acrobat Reader and open a user's guide from the File menu or double-click a user's guide on the CD in Windows Explorer. The PDF files are located in the UserDocs folder in the CD root. The Installation Guide is located on the CD root.
Information included in these guides is provided in online Help, which can be opened using the Help menu options in each utility.