Installation and Release Notes

Version 4.4.174.00
October 3, 2011

This document contains important information about the Vistasource RTW 4.4 release. Please read these release notes before installing RTW.

The following list provides an overview of new or updated features in Vistasource RTW, Version 4.4 since the Vistasource RTW 4.3 release:

• Enhanced status window provides detailed information about the status of RTW and the installed engine(s).
• Menu option License Management now launches vslic.exe for online licensing.
• Documentation and online help now available in wiki format via RTW and web browser.

The following list provides an overview of new or updated features in Vistasource RTW, Version 4.3 since the Vistasource RealTime for Windows 4.0.1 release:

• In RTW RMDS (RFA), the RFA Configuration Editor now offers an interface for editing RFA configuration files, in addition to the Windows registry.
• In RTW RMDS (RFA), the RFA Configuration Editor now displays warnings when there are unsaved changes.
• RTW RMDS (RFA) is upgraded to latest RFA libraries, RFA C++ API 7.
• RTW RMDS (SFC) is upgraded to latest SFC API libraries, SFC C++ 4.6 (L1).
• New wrapper functions are available for easier formula input.
• New menu option License Management added to run LMtools for licensing tasks.
• Minor release number now added to Help About window.
• LMUTIL.EXE now supplied.
• Engine-specific User Guides now available replacing separate RTW User and RTW Administration guides.
• New RTW RMDS (RFA) engine using the Reuters Foundation API (RFA).
• Easy migration steps from Thomson Reuters PowerPlus Pro to RTW RMDS (RFA).
• New RTW Netfeed engine for subscribing to Marketfeed data via the Netfeed System as provided by Datacode Inc.
• New user interface for Microsoft Excel 2007 and 2010 with the Vistasource ribbon.
• New comprehensive configuration editor for setting configuration options for RTW and the RTW engines via a tabbed dialog.
• Updated Online help, RTW User, RTW Administration and RTW COM Interface Guides.

Additionally, the following list provides an overview of added or updated features since the RealTime for Windows 3.5 release:

• MS Excel 2007 is now fully supported. (7005016)
• RTW COM Server is now Digitally Signed. (7005025)
• Real-time data is provided using Excel's RTD function which is available in MS Excel 2002 or later. The Vistasource RTS function has been removed.
• The Vistasource “helper functions” (ATTRS, INDICATOR, etc) have been removed.
• Support of SFC API 4.5.1 L3 for RMDS Engine which fixes the following SFC issues:
  
  Previously, RV Connection disconnected when DACS connection is down. In this release, RV connection will no longer be disconnected and the user can continue to subscribe (bad line break) data using the existing user profile until DACS connection is recovered. After that, the user's permission will be re-checked by SFC. Furthermore, new configuration parameters, stopSubscriptionWhenDACSDowns and stopPublicationWhenDACSDowns, are provided to stop subscribing from or publishing any data to TIC/RTIC when DACS connection is down. The default value for both new configurations is False, i.e. when DACS connection is down, applications are still able to subscribe or publish the data, which is the same behavior like previous version (4.4.4). Otherwise, changing the configuration to True, SFC will have the same behavior like previous versions (4.5, 4.4.5). (SR 1- 1503778370) (sfc1905)(7004323)
  
  SFC publisher no longer crashes when it publishes an additional partial field for the second time using the indicateSync(), indicateResyncComplete() or indicateUpdateComplete() method. (SR#1-1623414144) (sfc1923)(7004731)

• RTW Wrapper function RTS_{engine} no longer causes MS Excel 2007 to hang when using cell references. (7005706)
  
• Upgraded lmtools.exe and lmgrd.exe to support running the license server as a service on 64-bit Windows 7. (7005312)
  
• RTW RMDS RFA engine now includes better error handling in cases of RFA misconfiguration. (7005701)
  
• In RTW RMDS RFA, when using a flat file in the RFA Config editor, a change to an existing named component (connection, data dictionary, service, service group, or session) now correctly updates the component. (7005702)
  

• The 'rt' and 'rtinsert' commands now support passing fields as a range. (7005528)
• In versions of Excel prior to 2007, the Vistasource menu item mnemonic has been fixed to allow for proper keyboard navigation. (7005530)
• The Rtconfig Editor no longer appends unnecessary WebData entries to the rtconfig file when the RTW WebData engine is not installed. In addition, RTW will no longer crash if there are more than the maximum allowed WebData entries in the rtconfig file. (7005540, 7005541)
• When the rtDateTimeAsString option is set to zero (0), date/time fields will now correctly display in the Record Info dialog box. (7005601)
• When the rtDateTimeAsString option is set to zero (0), July dates will now be correctly interpreted. (7005599)
• When the rtDateTimeAsString option is set to zero (0), the RTW RMDS (SFC) engine no longer crashes on certain date fields. (7005659)

• Date now displays correctly in numeric format, when “rtDateTimeAsString” is set to 0 (Zero). (7005457)
• Fixed memory leak in RTW wrapper function PARSE_DATA. (7005463)
• Fixed issue when adding fields to an existing record while using the RTW RMDS (SFC) Engine with TIB Implementation. (7004630)

Microsoft Windows XP, Vista or Windows 7, and Microsoft Excel 2002 or higher (32-bit). If using Microsoft Excel 2010, the 32-bit version must be installed. If using Microsoft Excel 2007, SP2 must be installed. If using Microsoft Excel 2003, SP3 must be installed.

Approximately 60 MB of available hard disk space for a full install with all engines. Installing a single engine requires up to 30 MB of disk space.

This product was compiled with the following Data Provider Libraries:

RTW RMDS (RFA) and (SFC) Engines: Prior to using the RTW RMDS (RFA) or (SFC) engines, you must have all the required DDS (Data Distribution System) software licensed and installed on the client for proper DDS connectivity before installing Vistasource RTW.

RTW Bloomberg Engine: Prior to using the RTW Bloomberg engine, you must have all the required DDS (Data Distribution System) software licensed and installed on the client for proper DDS connectivity before installing Vistasource RTW.

RTW Netfeed Engine: Prior to using the RTW WebData engine, you must have a login into the Netfeed DDS (Data Distribution System) by Datacode, Inc. You can purchase a Marketfeed Data Subscription at http://www.marketfeed.com

RTW WebData Engine: Prior to using the RTW WebData engine, you must have access to a web-based data source that supports the downloading of data in CSV format over the Internet, e.g. Yahoo Finance Service(R).

RTW Pre-Recorded Playback Engine: Does not require any DDS (Data Distribution System) software installed.

The following installation instructions assume that Microsoft Excel is installed and that your data distribution system connectivity is set up before proceeding with the Vistasource RTW installation.

The RTW product is available as a self-extracting package (.exe) or an archive file (.zip). To install the product on Windows XP, Vista and Windows 7, follow these steps:

To install the product using an .exe file

1. By default, the product can be downloaded as an .exe file. The .exe file is a self-extracting package. After downloading the .exe file, simply run the executable. Select Yes to continue.
2. The InstallShield Wizard dialog will appear with a Welcome screen, click Next to continue.
3. Read the License agreement, select Yes to continue.
4. Select a destination location for the software. By default the destination folder will be: C:\Program Files\Vistasource\RTW\4.4 Click Next to continue.
5. On the Select Components screen, choose to install Vistasource RTW and the samples as well as any licensed RTW engine for your installation, click Next for the installation to proceed.
6. The installer will install the necessary files according to your choices in step 5 and then display a final screen. This screen will provide the option to review the product release notes.
7. Click Finish to complete the installation.

To install the product using a .zip file:

1. If you download the .zip file, unzip the archive file and save its content to a user-defined directory. Browse to the directory where the archive files were extracted and select SETUP.EXE.
2. The InstallShield Wizard dialog will appear with a Welcome screen, click Next to continue.
3. Read the License agreement, select Yes to continue.
4. Select a destination location for the software. By default the destination folder will be: C:\Program Files\Vistasource\RTW\4.4. Click Next to continue.
5. On the Select Components screen, choose to install Vistasource RTW and the samples as well as any licensed RTW engine for your installation, click Next for the installation to proceed.
6. The installer will install the necessary files according to your choices in step 5 and then display a final screen. This screen will provide the option to review the product release notes.
7. Click Finish to complete the installation.

When upgrading from RTW 4.2 to RTW 4.3 or higher and installing the RTW RMDS (RFA) engine, references to RFA libraries in the RFA configuration file must be updated to version 7, which is the RFA version used by RTW 4.3 and higher. Please see Configuration in the RTW RMDS (RFA) guide for more information about migration. (7005521)

When configuring the RTW RMDS (RFA) engine, please note that Vistasource provides two RFA sample files, a sample registry file called RFA-example.reg and a sample flat file called RFA-example.cfg. These files contain various settings typical for both SSL and TIB infrastructures. Depending on your specific configuration, you may need to edit these files. Please see Configuration in the RTW RMDS (RFA) guide for more details on how to edit these files. (7005451)

When configuring the RTW RMDS (SFC) engine, please note that Vistasource provides a sample file called sfcapi.conf in the installation directory. This file contains various settings typical for both SSL and TIB infrastructures. Depending on your specific configuration, you may need to merge this sfcapi.conf file with an already existing file on your system. Please see Configuration in the RTW RMDS (SFC) guide for more details on how to edit these files. Furthermore, we strongly recommend that you consult the Reuters manual for more information regarding the Reuters file sslapi.cnf. (5013420 and 5013402)

When using the RFA Configuration Editor with flat files, the Message Box parameters are saved to the registry, not the flat file (as per RFA rules). (7005646)

In the Vistasource RTW Installer, if you toggle everything off, the required space is still listed at 716k. This is not a bug, but a feature of InstallShield, which keeps track of all the files that must be installed to enable maintenance setups and uninstallation. Even if all application components are de-selected, the size of this file is still displayed. (5012145)

If you uninstall any third-party software that provides an RTD server, you may need to run the Microsoft Excel install program again and select Repair, otherwise RTW will not function properly. (7005162)

Vistasource RTW installs only for the current user. If other users log into the same machine and want to use RTW, they will need to install our Add-Ins manually. (7005292)

For PARSE_DATA to work properly, the “Decimal separator” in Microsoft Excel needs to be set to “.” (period), and the “Thousands separator” needs to be set to “,” (comma). (7005212)

When choosing to use array formulas in the Quick Quote or Quote Wizard, the orientation “vertical” is not available. (7005283)

The maximum number of Services available in the “Service” control in the dialog boxes is set to 64 for the Reuters and custom engines. (7005293)

For the RTW RMDS (SFC) Engine, when creating an ipcroute file using an ASCII text editor with one line: triarch_sink.sinklib:<your machine>:<your server>, make sure that you hit Return after <your server>, so that you have two lines, otherwise the SSL connection will be refused. (5012624)

Bloomberg bulk data is currently not supported for return strings greater than 255 characters. (7005187)

When using Quote Table as an array function, the selected fields must be valid, otherwise the whole quote table fills in as #VALUE (all engines). (5012845)

When running the License Manager on Windows 2003, the license server may not start, giving the error: System Error: 10035 “WinSock: Operation would block” In addition, attempts to access the System Settings tab in LMTOOLS would cause the utility to crash. The cause of the issue was related to the DEP feature in Windows 2003, which prevents the applications from functioning correctly. By adding all FLEXlm executables (lmgrd.exe, lmtools.exe, lmutil.exe, and the license daemon vistasrc.exe) to the DEP exception list, the problem was resolved. To do this:

1. Click Start, then right-click on My Computer and choose Properties.
2. Click the Advanced tab.
3. Under the Performance section, click the Settings button.
4. Click the Data Execution Prevention tab.
5. Click the Add… button and browse to each of the applications, adding all of them to the list.

Other causes of the Winsock 10035 error may be related to ports being blocked by the system firewall, or an incorrect license file (server name/host ID do not match). (7005113)

If the RTW Netfeed engine is not configured for automatic login, the engine will fail when it is stopped and restarted. To configure the engine for automatic login, either set the user name and password on the Netfeed tab of the RTW Rtconfig Editor dialog, or manually set the “nf_User” and “nf_Password” options in the rtconfig file. See Configuration in the RTW Netfeed guide for more information. (7005306)

When migrating from Reuters PowerPlus Pro to RTW RMDS RFA, you need to do one of the following steps: Add a line in the RFA-sample.cfg file: \Sessions\RTWSession\connectionList = “Connection_XTRA_SSLED”, or alternatively, edit the RMDS (RFA) default session in the rtconfig file: rmds2_DefaultSession:XtraSession. For more information regarding migration, see Configuration in the RTW RMDS (RFA) guide. (7005378)

When configuring RTW RMDS RFA, the serverList value cannot be empty. If empty or improperly set, an “RFA Internal Failure” error will occur. See Configuration in the RTW RMDS (RFA) guide for more information. (7005380, 7005383)

When using RTW RMDS RFA engine with SASS3, the SubscriberRV, PublisherRV and ContributerRV settings must have a value if they exist in the registry or in the flat file for RMDS RFA configuration. (7005468)

The Favorites dialog box should re-sort file when user closes this dialog box. Currently it only re-sorts file when user clicks UPDATE button. (7005288)

Excel Spreadsheet stops update when in VBA design mode. If the breakpoint is in a macro which is called by DDE, then the update will stop. A work around exists by unloading the add-in and reloading them during the same session or exit MS Excel and restart. (7005289)

In RTW RMDS (SFC and RFA), the Favorites dialog box has the Field List button grayed out. (7005290)

In the RTW RMDS (SFC and RFA) Quote Wizard dialog box, Step 4, the Record selection is gray, because RMDS does not list all FIDs for a specific Record. (7005284)

If you publish and subscribe in a sheet, change the Update Rate to 30 sec (or any other value), and then change the data value for publishing, the software waits 30 seconds (or other selected value) while publish cell displays #N/A before it published and the cell changes to OK. (7005291)