Welcome to Citect for Windows Version 5.40

For Microsoft Windows 98, Windows NT4.0, and Windows 2000.

What's New

See the What's New in the Online Help system for details of new features for this version.

For a detailed listing of problems that have been fixed in this release, see Relnotes.doc (found in the Citect 'bin' directory).

What's in this Document

Upgrading Issues

· Long File Names

· Remote I/O Devices

· Alarm Server Compatibility

· Trend Server Compatibility

· Modifying Citect.ini

· Updating your Protection Key

· Trend system special values of -32001 & -32002 have been superseded.

Known Problems

· The ActiveX 'DB Grid Control' is not compatible with Graphics Builder

Upgrading Issues

· Long File Names

Citect Version 5.40 has the ability to take advantage of long file names and long directory names. The Citect help contains details on the limitations on naming lengths and allowed characters.

Long file name compatibility can be disabled with the Citect.ini setting.

[General]

LongFileName=0

If you want to disable long file name compatibility set the parameter before starting Citect Explorer for the first time. DO NOT alter this parameter if Citect is installed to a directory that uses long file names. (eg C:\Program Files)

· Alarm Server Compatibility

Where possible Citect Version 5.40 has been designed for compatibility with previous versions of Citect, in order to support staggered upgrading. Some areas of communication have been disabled where maintaining compatibility has not been possible. Specifically, Version 5.40 Display Clients are not compatible with Version 5.21 or earlier Alarm Servers.

· Trend Server Compatibility

Where possible Citect Version 5.40 has been designed for compatibility with previous versions of Citect, in order to support staggered upgrading.

Version 5.40 Trend Servers are compatible with Version 5.30 or earlier I/O Servers.

However, some areas of communication have been disabled where maintaining compatibility has not been possible. Specifically:

- Version 5.40 Trend Servers are not compatible with Version 5.30 or earlier Display clients.

- Version 5.40 Display Clients are not compatible with Version 5.30 or earlier Trend Servers.

- Version 5.40 Trend Servers are not compatible with Version 5.30 or earlier Trend Servers for redundancy purposes.

- Version 5.40 Trend Servers can use Version 5.30 or earlier history files.

· Modifying Citect.ini

The Citect Version 5.40 installation program will modify an existing Citect.ini file, instead of completely overwriting it. When Citect Version 5.40 is installed, any existing [DATA] and [USER] paths will remain unchanged.

Users upgrading projects are advised to check the [DATA] and [USER] paths after the installation.

· Updating your Protection Key

Citect requires an update to the Protection Key used for Citect licensing. Upon starting Citect Runtime for the first time, you will be presented with a series of dialogs regarding the updating of your key. To update your Citect Protection Key, an Authorisation Code is required. To obtain this Authorisation Code, you should visit www.cit.com.au <http://www.cit.com.au>.

You can update your Citect Protection Key at any time by running the “Citect Key Update” utility. This utility can be run by selecting the “Citect Key Update” menu item from the Help menu in Citect Explorer, or by executing the zipped program in the KeyUpdat directory of the Citect Version 5.40 CD.

· Trend system special values of -32001 & -32002 have been superseded.

The Trend system prior to Citect Version 5.31 was using the values of –32001 and –32002 to denote special meaning in the Trend System’s storage of the trend data. Specifically, -32001 was used to denote “Invalid” values and –32002 was used to denote “Gated” values.

These special values are no longer used, and any Cicode that uses them should be modified to use the new Cicode functions that supersede them. Specifically, these Cicode functions are:

TrnIsValidValue()

TrnGetGatedValue()

TrnGetInvalidValue()

Please see the online help for a full description of these functions.

The Following Known Problems Exist with this Version

· The ActiveX 'DB Grid Control' is not compatible with Graphics Builder

After you insert the ActiveX control 'DB Grid Control' (filename DBGRID32.OCX) into a page in Graphics Builder, you will receive error messages or faults accessing some of the tabs on the 'Appearance' properties page.

The ActiveX control 'DB Grid Control' (filename DBGRID32.OCX) works in a manner that is not compatible with Citect Graphics Builder. You should use an alternative control such as 'Microsoft DataGrid Control, Version 6.0' (filename MSDATAGRD.OCX) in your application.

Attachments