Global Equity Analytics Technical Reference

Global Equity Analytics��

Installation and Technical Reference

Version 2.2

Last Update: 29th Oct 2007

Revised By: Paulo Marques, Rich Pascoe, Arun Rajasekhar

Merrill Lynch Global Equity Analytics

Installation and Technical Reference of 19

Copyright and Trademarks © 2006 Merrill Lynch. All Rights Reserved. Merrill Lynch and the Bull symbol are the registered trademarks of, and MLX and MLXPAL are service marks or registered service marks of Merrill Lynch & Co., Inc. Adobe Acrobat is a registered trademark of Adobe Systems Incorporated in the United States and/or other countries. Bloomberg is a registered trademark of Bloomberg L.P. Microsoft, Windows, Windows NT, Microsoft Office, Jet, ActiveX and Internet Explorer are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. ChartFX is a registered trademark of SoftwareFX, Inc. NAG and the NAG logo are registered trademarks of The Numerical Algorithms Group Ltd. SharpGrid and ActiveBar are registered trademarks of Data Dynamics, Ltd. UltraToolBars is a registered trademark of Infragistics, Inc. VSPrint and VSReport are either registered trademarks or trademarks of ComponentOne LLC. Mapping software derived from copyrighted works of SmartMoney © 2003 SmartMoney. All Rights Reserved. All other trademarks and service marks cited within this document are the property of their respective owners. Installation and use of the MLXPAL application is governed by the agreements provided with or contained within the application. You are responsible for obtaining your Bloomberg API feed, as well as all required third party hardware and software. Merrill Lynch shall not be responsible for any loss or damage caused by any non-Merrill Lynch hardware or software.



Table of Contents ABOUT THIS DOCUMENT.............................................................................................................................................. 4 1 SYSTEM REQUIREMENTS .................................................................................................................................... 5

1.1 Hardware Configuration................................................................................................................................... 5 1.1.1 Minimum Specification ................................................................................................................................ 5 1.1.2 Recommended Specification ....................................................................................................................... 5

1.2 Software Configuration .................................................................................................................................... 5 1.2.1 Minimum Specification ................................................................................................................................ 5 1.2.2 Recommended Specification ....................................................................................................................... 5

1.3 File Locations .................................................................................................................................................. 6 1.4 Merrill Lynch Files ........................................................................................................................................... 6 1.5 Third Party Software Components ................................................................................................................... 6 1.6 Windows Installer Merge Modules ................................................................................................................... 7 1.7 Registry Entries............................................................................................................................................... 7 1.8 Start Menu Entries........................................................................................................................................... 7

2 DOWNLOADING THE GLOBAL EQUITY ANALYTICS SET-UP KIT ...................................................................... 8 3 INSTALLING THE GLOBAL EQUITY ANALYTICS SOFTWARE...........................................................................12 4 VERIFYING GLOBAL EQUITY ANALYTICS..........................................................................................................16

4.1 Verifying Installation .......................................................................................................................................16 4.2 Verifying Offline Mode Invocation ...................................................................................................................16 4.3 Verifying Online Mode Invocation ...................................................................................................................17

5 .....................................................................................................................................................................................17 6 SOFTWARE UPDATES .........................................................................................................................................17 7 SUPPORT..............................................................................................................................................................17 8 COMMON INSTALLATION PROBLEMS AND SIMPLE SOLUTIONS....................................................................18

8.1 Need to remove MDAC from the InstallShield Package For Repackaging Purposes?......................................18 8.2 Problems logging into MLX (http://www.mlx.ml.com )?....................................................................................18 8.3 Starting Global Equity Analytics in Online mode generates a “Connection not verified” Message ....................18 8.4 Global Equity Analytics does not receive data from Bloomberg .......................................................................18 8.5 The “Open With” or “File Download” dialog appears when attempting to launch the Merrill Lynch Market Impact

Model document .........................................................................................................................................................18 8.6 Installing Windows Scripting Host 5.6. ............................................................................................................19 8.7 Cannot connect to a text file database through connection manager ...............................................................19



About This Document This document provides hardware and software specification information and technical guidelines for installing and running Global Equity Analytics up to version 2.2. The information in this document covers the following functions:

• Hardware and software requirements for installing Global Equity Analytics • Details of Merrill Lynch and Third Party software installed by Global Equity Analytics • Downloading the Global Equity Analytics set-up from MLX • Installing the Global Equity Analytics software • Verifying a successful application startup and connection to the Bloomberg� API • Obtaining software updates and support • Solving common installation problems



1 System Requirements Global Equity Analytics will run on many personal computer configurations. The following is a list of the minimum and recommended specifications.

1.1 HARDWARE CONFIGURATION

1.1.1 Minimum Specification • Pentium� II 400 MHz processor • 512 MB RAM • 80Mb of free disk space for Global Equity Analytics • Network interface card supporting TCP/IP [To get Bloomberg data] • Monitor Resolution Minimum of 256 Colors

1.1.2 Recommended Specification • Dual Pentium 4 2GHz processors or faster • 1 GB RAM or more • 80Mb of free disk space for Global Equity Analytics • Network interface card supporting TCP/IP [To get Bloomberg data] • Monitor Resolution Minimum of 65536 Colors

1.2 SOFTWARE CONFIGURATION

1.2.1 Minimum Specification • Windows NT� 4.0 with Service Pack 6a installed • TCP/IP Network Services enabled • Open Bloomberg API • Internet Explorer� 4 SP2 • Adobe Acrobat Reader� 4

[Only the Reader is required – other acrobat functionality is not required by GEA] [For viewing online documentation and to export reports to PDF]

• Windows� Scripting Host 5.5 (A requirement for Windows NT 4.0 only, see section 8.8 for details) • A user with administrative privileges is required to run the installation program.

1.2.2 Recommended Specification • Windows XP with Service Pack 1 or later • TCP/IP Network Services enabled • Open Bloomberg API • Internet Explorer 6 • Adobe Acrobat Reader� 6 • Microsoft Office� • Microsoft Jet 4.0



1.3 FILE LOCATIONS • All files are installed to ‘C:\Program Files\Merrill Lynch\Global Equity Analytics’

1.4 MERRILL LYNCH FILES Component Version Notes

AnalyticsEngine.dll 2.2.0.4 GEA version 2.2, build #4

BBFieldManager.dll 2.2.0.4 GEA version 2.2, build #4

ConnectionManager.dll 2.2.0.4 GEA version 2.2, build #4

DataObjects.dll 2.2.0.4 GEA version 2.2, build #4

EncryptionTool.dll 1.0.0.1 Encryption for registry entries

GEA.chm 1.0.0 Compressed HTML help

GEA.exe 2.2.0.4 GEA version 2.2, build #4

MLStatusBar.ocx 1.0.0.0 Status Bar control

Reports.xml 02 November 2005 Template for reports

Sm.j_ 11 Apr 2002 Heatmap support file

Utility.dll 2.2.0.4 GEA version 2.2, build #4

1.5 THIRD PARTY SOFTWARE COMPONENTS Component Version Description Files Installed

(Version) Vendor

ActiveBar 2.0 ActiveBar Control Actbar2.ocx (v 2.5.0.65) Data Dynamics http://www.datadynamics.com

Chart FX Client Server 5.0 Chart FX Client Server ActiveX Control

Chart FX Data Provider

Dockable Tools Library

Cfx4032.ocx (v5.0.9.0)

Cfx4Data.dll (v1.0.11.0)

SfxBar.dll (1.0.20.0)

Software FX, Inc.

http://www.softwarefx.com

NAG Libraries Mark 20 Mathematical Library for use in Portfolio Optimization

Dformd.dll DLL20DT.dll DLL20DTS.dll Libguide40.dll Mkl_def.dll Mkl_support.dll (v6.1 – 683)

The Numerical Algorithms Group

http://www.nag.co.uk

Rich Text 6.0.88.4 Rich Text ActiveX� control richtx32.ocx (6.0.88.4)

Microsoft Corporation

http://www.microsoft.com

SharpGrid 2.0 Data Dynamics SharpGrid Control (OLEDB)

Sg20o.ocx Data Dynamics

http://www.datadynamics.com

UltraToolBars 5.0 ActiveToolBars Plus Control IGToolBars50.ocx (v5.0.1.2)

Infragistics, Inc.

http://www.infragistics.com

VSPrint, VSReport & VSPdf

7.0 Printer ActiveX control

Reporting ActiveX control

PDF Generation control

VSPrint7.ocx (v7.0.0.93)

VSRpt7.ocx (v7.0.0.91)

VSPDF.ocx

(v7.0.0.93)

ComponentOne LLC

http://www.componentone.com



1.6 WINDOWS INSTALLER MERGE MODULES Merge modules contain all of the logic and files needed to install distinct pieces of functionality. The set-up program checks for the existence of the following modules and installs them unless a more up to date version is found: Name File Version CMDialog ActiveX Control DLL COMDLG32.MSM 6.0.84.18 Microsoft Common Controls 2 ActiveX Control DLL MSCOMCT2.MSM 6.0.88.4 Microsoft Component Category Manager Library COMCAT.MSM 4.71.1460.1 Microsoft Data Access Components 2.7 MDAC.MSM 2.70.7713.2 Microsoft OLE 2.40 for Windows NT(TM) and Windows 95(TM) Operating Systems OLEAUT32.MSM 2.40.4275.1 TABCTL32 OLE Control DLL TABCTL32.MSM 6.0.88.4 Visual Basic Virtual Machine MSVBVM60.MSM 6.0.88.42 Windows Common Controls ActiveX Control DLL MSCOMCTL.MSM 6.0.88.12 Microsoft Standard Data Formatting Object DLL MSSTDFMT.MSM 6.0.88.4

1.7 REGISTRY ENTRIES • HKLM\Software\Classes\.gep and its subkeys are created at installation • HKLM\Software\Classes\.gew and its subkeys are created at installation • HKLM\Software\Classes\GEA.Portfolio and its subkeys are created at installation • HKLM\Software\Classes\GEA.Workspace and its subkeys are created at installation • HKCU\Software\Merrill Lynch\GEA\GridViews and its subkeys are created at installation • HKCU\Software\Merrill Lynch\GEA\Hash its subkeys are created at installation • HKCU\Software\Merrill Lynch\GEA\Heirarchy and it’s subkeys are created at installation • HKCU\Software\Merrill Lynch\GEA\FieldManager and its subkeys are created at runtime • HKCU\Software\Merrill Lynch\GEA\Preferences and its subkeys are created at runtime • HKCU\Software\Merrill Lynch\GEA\RecentPortfolios and its subkeys are created at runtime • HKCU\Software\Merrill Lynch\GEA\ RecentWorkspaces and its subkeys are created at runtime • HKCU\Software\Merrill Lynch\Connection Manager\Connections and its subkeys are created at runtime • HKCU\Software\Merrill Lynch\CompositesIndices and its subkeys are created at runtime If the Global Prime Brokerage custom option is chosen during installation, then the following 2 registry entries will also be created: • HKCU\Software\Merrill Lynch\Connection Manager\Connections\RTPL_All • HKCU\Software\Merrill Lynch\Connection Manager\Connections\RTPL_Separate

1.8 START MENU ENTRIES • A Folder called ‘Merrill Lynch’ is created under Start � Programs. In that folder, 2 shortcuts are created

o ‘Global Equity Analytics’ is created that points to ‘C:\Program Files\Merrill Lynch\Global Equity Analytics\GEA.exe’

o ‘Global Equity Analytics Help’ is created that points to ‘C:\Program Files\Merrill Lynch\Global Equity Analytics\GEA.chm’



2 Downloading the Global Equity Analytics Set-up Kit The set-up kit for Global Equity Analytics can be found in the download section of the Portfolio Trading application on the Merrill Lynch MLX website, (http://www.mlx.ml.com/). After logging in, access the Global Equity Markets homepage from the Markets menu, and then the Portfolio Trading product. This will require a login to MLX that is permissioned for both MLXPAL and the PALPTA download. If problems are encountered, see Section 8 for potential solutions.

� To access the download section, click on the link to the left named ‘Portfolio/Automated Trading’ under Products.



� Click on the link to the left named ‘GEA Download’ under GEA Application.



� To download the set-up kit, click the link named Global Equity Analytics Setup Kit from the list of Files:

� The File Download window should then appear. Click the ‘Save’ button to continue.



� When prompted for a location, select a directory such as c:\temp\. Press Save to continue.

� The download should then proceed.

� The set-up kit for Global Equity Analytics will then be downloaded and can be installed by following the steps in the next section.



3 Installing the Global Equity Analytics software

� Note that the downloaded installer program GEAsetup.ex_ has an extension of .ex_ This must be renamed to .exe before continuing.

� A user with administrative privileges is required to run the installation program.

� Open the Global Equity Analytics set-up kit that you just downloaded (GEASetup.exe). This will launch the InstallShield Wizard. The InstallShield Wizard checks for the presence and version of Windows Installer. If requirements are met, the installation will proceed to the next step.

Note: If Windows Installer is not present or not up to date, the latest version must be installed and the system must be restarted. Please follow the instructions displayed on the message window to accomplish this task. When completed re-run GEA setup program.

� The Wizard now checks for the presence of required system components and version. If requirements are met the installation will proceed to the next step.

Note: If required system components are not present or not up to date they must be installed and the system must be restarted. Please follow the instructions displayed on the message window to accomplish this task. When completed re-run GEA setup program.

� Once your system has restarted, log back in and start Setup process and the InstallShield Wizard will proceed to the next step. The Welcome panel appears. Click Next to continue.



� If you have a prior version of GEA installed on the computer, please skip over the next two steps.

� The Global Equity Analytics License Agreement panel appears. Please read the license agreement. If you accept the terms of the license agreement, select ‘I accept the terms in the license agreement’. Click Next to continue.

� The Customer Information panel appears. Select ‘All Users’. Click Next to continue.



If this is a brand New installation then the Setup Type panel shown below appears.

� Select ‘Complete’. Click Next to continue.

If this is an Upgrade installation (to a later version) then the Program Maintenance panel shown below appears.

� Select ‘Remove’. Click Next to continue. Click Remove on the following screen to uninstall the older version. Once done click Finish and re-run the GEA setup program.



� The final setup panel appears. Click Install to begin the installation of the application.

� The Finish panel appears. Click Finish to complete the installation.

� If a message box appears prompting you to Restart your system you can either choose now (Click Yes) or later (Click

No). After restarting your system you have successfully installed Global Equity Analytics.



4 Verifying Global Equity Analytics

4.1 VERIFYING INSTALLATION

� If the Finish Panel appears (see previous page) and a Start Menu shortcut is created (see Section 2.6) then Global Equity Analytics is successfully installed. Otherwise, please contact your Merrill Lynch Sales Representative for assistance with the installation.

4.2 VERIFYING OFFLINE MODE INVOCATION

� Launch Global Equity Analytics from the Start Menu. The opening form displayed below should appear, allowing you to choose a Connection Mode. Offline mode allows the user to utilize persisted data to use much of the functionality of Global Equity Analytics without a connection to a market data source. Online mode requires a market data connection to provide real-time analytics.

�

Select the Offline radio button and click the Accept button to accept the Terms and Conditions. If the following screen is seen with the status bar showing “Offline” then invocation of Offline mode is successful.

.



4.3 VERIFYING ONLINE MODE INVOCATION

� Launch Global Equity Analytics from the Start Menu. The opening form should appear.

� Select the Online radio button and click the Accept button to accept the Terms and Conditions. The status bar will display “Verifying Connection”:

� If this text disappears and the status bar displays “Online” (as seen below) then invocation of Online mode is successful.

.

5

6 Software Updates Updates to Global Equity Analytics software and documentation will be made available for download from the Portfolio Trading homepage on the MLX website, (http://www.mlx.ml.com). After logging in, access the Global Equity Markets homepage from the Markets menu, and then the Portfolio Trading product.

7 Support For all issues with the Global Equity Analytics software please contact your Merrill Lynch Sales Representative. Contact details can be found on the Portfolio Trading homepage on Merrill Lynch’s MLX website, (http://www.mlx.ml.com). After logging in, access the Global Equity Markets homepage from the Markets menu, and then the Portfolio Trading product.



8 Common Installation Problems and Simple Solutions If the common remedies below do not solve the encountered problem, please see section 6 of this document for instructions on how to contact Merrill Lynch for support.

8.1 NEED TO REMOVE MDAC FROM THE INSTALLSHIELD PACKAGE FOR REPACKAGING PURPOSES?

Solution: 1. On the Setup Type screen, choose the Custom option. For the MDAC 2.7 feature, select “This

feature will not be available”. Click Next and continue the installation. Please note that GEA may not function properly without MDAC 2.5 or later.

8.2 PROBLEMS LOGGING INTO MLX (HTTP://WWW.MLX.ML.COM )?

Solution: 1. An MLX username and password are required. If these are not available contact your Merrill Lynch

Sales Representative to get setup. (see Section 7 above). 2. The MLX username needs to be permissioned for both MLXPAL and the PALPTA download

applications. 3. If problems persist, contact MLX Client Services by clicking on the link ‘Contact Us’ at the top of the

screen and following the instructions. 4. The link to the ‘Contact Us’ page is http://www.mlx.ml.com/public/bin/ContactUs_JQPublic.asp.

8.3 STARTING GLOBAL EQUITY ANALYTICS IN ONLINE MODE GENERATES A “CONNECTION NOT VERIFIED” MESSAGE

Solution:

1. Check for installation of Bloomberg API. Use the Bloomberg Terminal command UPGR to do this. If the API is not installed or is an old version, contact a Bloomberg representative to get the most up to date version.

2. If the problem persists the Bloomberg API dll’s may require re-registering using regsvr32. The dll’s in question are blpdatax.dll and bbfieldtable.dll and they should reside in the ‘\blp\api\activex’ directory.

3. Reinstalling the Bloomberg API will also re-register the API dll’s. 4. If a connection still cannot be verified, try closing the application and stopping the Bloomberg engine

(\blp\api\bbstop.exe). Restarting GEA will restart the engine.

8.4 GLOBAL EQUITY ANALYTICS DOES NOT RECEIVE DATA FROM BLOOMBERG

Solution: 1. There may be a problem with the Bloomberg API. Check the installed version of the API (see above,

section 7.4) and upgrade if necessary. 2. If data is still not being received into Global Equity Analytics check for general availability of

Bloomberg data via the Bloomberg API. This can be done by using the APIDemo tool (in the Bloomberg folder on the Start Menu) or using the Excel addin. If there is a general problem this must be resolved first.

8.5 THE “OPEN WITH” OR “FILE DOWNLOAD” DIALOG APPEARS WHEN ATTEMPTING TO LAUNCH THE MERRILL LYNCH MARKET IMPACT MODEL DOCUMENT

Solution:

1. Install Adobe Acrobat Reader version 4 (or above) and try again.



8.6 INSTALLING WINDOWS SCRIPTING HOST 5.6.

Solution: 1. For Windows NT 4.0 and Windows 98, download scr56en.exe from Microsoft by clicking here:

http://download.microsoft.com/download/4/c/9/4c9e63f1-617f-4c6d-8faf-c2868f670c1c/scr56en.exe

8.7 CANNOT CONNECT TO A TEXT FILE DATABASE THROUGH CONNECTION MANAGER Solution:

1. The Microsoft Text Driver is required to use a text file database in GEA, and is a component of the Microsoft Jet Driver package. If the text driver is missing or not installed on your PC, then Jet can be downloaded and installed from the Microsoft website at http://msdn.microsoft.com/data/downloads/updates/default.aspx#jet. Please contact your technical support center to determine which version of Microsoft Jet is appropriate for your system.

Global Equity Analytics Technical Reference

Documents

Transcript of Global Equity Analytics Technical Reference