advent apx instructions - telemet america · with advent apx using telemet software with advent apx...

Telemet America | 1-800-368-2078 | [email protected]

Telemet Integration

with Advent APX Using Telemet software with Advent APX

Executive Summary

If you use Advent APX for your portfolio accounting, this document is for you.

The Telemet Orion Integrated Investment Management platform is a single

solution. It provides ‘one stop’ for real-time and historic market data, news, research, and portfolio analysis. For 30 years Telemet has focused

on offering the ‘buy-side’ top notch investment information.

One of the many benefits of Telemet Orion is data integration. This

document leads you step-by-step through the process of taking data from Telemet Orion into Advent APX. The data update your Advent APX price

files, dividend files and security information files.

Using Telemet Orion saves fees and time as well as lowering your workload in the process.

Telemet Orion conveniently shows up-to-the minute unrealized gains and

losses on your client portfolios. You can seamlessly load any or all of the portfolios from Advent APX into Telemet Orion. This document shows you

how.

Further, and most importantly, Telemet Orion offers true, transaction-

based, time-weighted reports in by loading the transactions from Advent APX into Telemet Orion. It’s all in this document.

Read on!

Telemet America | 1-800-368-2078 | [email protected] 2

Table of Contents Integration with Advent APX Overview ............................................................................ 3

Working with APX Price Files .................................................................................................. 4

Working with APX Dividend Files ........................................................................................ 8

Working with APX Security Information File ....................................................... 12

Working with a APX Transactions file ......................................................................... 14

Appendix 1 – Price File Options Button ......................................................................... 17

Appendix 2 – Cash Dividend to Trade Blotter Options Button .................... 18

Appendix 3 – Security Information File Options Button ................................... 19


Integration with Advent APX Overview

If Advent APX is the software used for Portfolio Accounting, Telemet software can work with APX files to do the following functions:

1) Update APX price files* 2) Update APX dividend files* 3) Update APX security information files* 4) Gain access to current portfolio holdings* & **

5) Gain access to transactions based Holdings & Multi-Style Attribution portfolio information**

* using Televista APX

** using Telemet Orion

Initial Televista APX Setup Use the following link for Televista APX installation instructions: http://www.taquote.com/support/instruct.html

Once Televista APX has been installed, 2 setup steps for Televista APX are described below:

- APX Connection: When Televista APX is first opened the screen below will appear. To configure the APX Connection, click ‘OK’ on the message, then enter your APX connection information:

SQL Server Name: Enter the name of the APX server. Login ID: Enter the login ID for the APX server. “sa”, which equals System Administrator, is the required Login ID.

Password: Enter the password for the APX server.

Enter your APX server information then click “Apply”


- Connection: Televista must be connected to a Telemet server to use Televista APX to update APX files. To connect Televista APX to a Telemet server a valid Registration Number & User ID must be entered.

The initial Televista setup is complete!

Working with APX Price Files

The process of updating your APX price file(s) using Televista APX involves 3 easy steps:

1) Export a price file from APX into a csv file. 2) Update the prices on the exported price file using Televista APX. 3) Import the price file back into Advent APX.

� 2 items to Note: o The Advent APX input/output folder is the network location where

Advent APX exports/imports files from. The example input/output folder in this report is \\vam-apxapps\APX$\exp\.

o All instructions may be scripted & scheduled using the Advent APX or Microsoft Windows Scheduler; however the manual process is shown.

Click the “Connection” tab, then enter your Televista Registration Number & User ID, then

click “Apply”

Note: If you do not have a Registration Number

& User ID contact Telemet Client Services


[Using the APX Import / Export Utility] Select: File > Export > Using Advent Data Format:

On the “Objects” line enter the price file date you need to price with a “pri” extension added as shown below. Click Run. The APX script will enter the current date.pri.

When complete, you will get a message showing the export was successful, and you have the option to view a log file. The price file is now saved in the Output Folder

(\\vam-apxapps\APX$\exp\). The price file format should look like the screen shot below:


� Note: If the price file does not have the format shown (6 fields, separated by 5 commas, with the security type in the first field and the ticker in the second

field), the next step - using Televista APX - will not work properly. The Price file “Options” button can be used to modify the file format. Refer to Appendix 1 on pages 16 – 17 for more information.

Now the exported price file is ready to be updated by Using Televista APX. -Open Televista APX then click on the “Update Data” tab to get the screen shown below:

Click on the “Select Price File” button to get the screen shown below:

-“Select a File” to choose any price file from any location. The default location can be set in the Price file “Options” button – refer to Appendix 1 on

pages 16 -17. -“Current Day” will update today’s price file -“Previous Day” will update yesterday’s price file

This is the price file options button that can be used

to adjust the default price file settings. Refer to

Appendix 1 on pages 16 – 17 for more information.


• A schedule to automatically update price files can also be setup to automate the process. Click on the Clock icon to setup a schedule.

o Televista APX must be running during all schedules. There is no “catch-up” schedule if a scheduled item is missed.

After Televista APX updates the price file, the file will now look like this:

Import the file back into APX using the Import/Export Utility again by using the following method: Select: File>Import>Using Advent Data Format

The input folder is \\vam-apxapps\APX$\exp\… (The script enters the current date.pri) – click “Run”


When complete, you will get a message that the import was successful, and you have the option to view a log file. Now prices are populated in APX:

Working with APX Dividend Files The process of updating your APX dividend file is similar to updating the APX price file and utilizes Televista APX with 3 easy steps:

1) Export a security information (sec.inf) file from APX into a .csv file. 2) Televista APX will create a .trn file, which is based on a exported sec.inf

file. 3) Import the .trn file into Advent APX.



o All instructions below may be scripted & scheduled using the Advent

APX or Microsoft Windows Scheduler, however the manual process is shown:

[Using the APX Import / Export Utility] Select: File > Export > Using Advent

Data Format


Export the APX Security Information by keying in the filename “sec.inf”. The export folder example shown below is \\vam-apxapps\APX$\exp\:

When the “sec.inf” export file is complete, you will get a message that it was successful, and you have an option to view a log file. The sec.inf file is now saved in your output folder (\\vam-apxapps\APX$\exp\ for this example) and should look like

the screen shot below if opened with Microsoft notepad:

It is best to have the process done daily after all trading activity is finished, so that any new securities bought during the day are included in this file.

*Note: The prior day’s file is always overridden, since the filename is not like price files (i.e. date-sensitive).

Now the exported sec.inf file can be used as the source to update dividends (create a .trn file) by Using Televista APX.


-Open Televista APX then click on the “Update Data” tab to get the screen shown below:

Click on the “Cash Dividend to Trade Blotter…” button to get the following window:

-Set your “Query Date by” to the method you use to recognize dividends:

o X-Date o Pay Date

o Record Date -Set the start & end dates -Choose how you would like the dividends to be accrued

-Choose the Cash & Dividend accounts • A schedule to automatically update the .trn file can also be setup to

automate the process. Click on the Clock icon to setup a schedule. o Televista APX must be on during all schedules. There is no

“catch-up” schedule if a scheduled item is missed.


After choosing the correct settings, click “OK” and the .trn file will be updated - the results look like the following:

[Using the APX Import / Export Utility] Select: File > Import > Using Advent Data Format to get the following window:

Note: Dividend file Options are described in Appendix 2 – on pages 17 – 18. -Choose the settings, and then click “Run” to populate the APX Trade blotter:


Working with APX Security Information File The process of updating your APX security information file is similar to updating the APX price files and utilizes Televista APX with 3 easy steps:

4) Export a security information (sec.inf) file from APX into a .csv file.

5) Use Televista APX to update the security information on the exported sec.inf file.

6) Import the sec.inf file back into Advent APX.



o All instructions below may be scripted & scheduled using the Advent APX or Microsoft Windows Scheduler, however the manual process is

shown:

[Using the APX Import / Export Utility] Select: File > Export > Using Advent Data Format

Export the APX Security Information by keying in the filename “sec.inf”. The export folder example shown below is \\vam-apxapps\APX$\exp\:


When the “sec.inf” export file is complete, you will get a message that it was successful, and you have an option to view a log file. The sec.inf file is now

saved in your output folder (\\vam-apxapps\APX$\exp\ for this example) and should look like the screen shot below if opened with Microsoft notepad:

It is best to have the process done daily after all trading activity is finished,

so that any new securities bought during the day are included in this file. *Note: The prior day’s file is always overridden, since the filename is not like price files (date-sensitive).

Now the exported sec.inf file can be updated by Using Televista APX. -Open Televista APX then click on the “Update Data” tab to get the screen

shown below:

� Click on the “Update Security Information” button to get the following window:


- Click “OK” to update the Security Information (sec.inf) file.

� If this is the first time you have used Televista APX, Telemet suggests

viewing the updated sec.inf file with Microsoft notepad before importing the sec.inf back into Advent APX.

Note: Security Information file Options are described in Appendix 2 – on pages 18 –

19.

Working with a APX Transactions file The steps below can be used to create an APX Transactions file for all accounts, which then can be used for 2 purposes within Telemet Orion:

1) View current holdings based information for each portfolio.

2) View transactions based Multi-Style Attribution data for portfolios.



o All instructions below may be scripted & scheduled using the Advent

APX or Microsoft Windows Scheduler, however the manual process is shown:

To manually create the required Advent APX transactions file, do the following steps:

1) Create a Advent APX Report Writer Pro report* using the following definitions: a. *Note: Telemet Client Services has a file with the fields listed that is

available upon request and will save a substantial amount of time. Please contact Telemet Client Services for more information.


2) Change the Report Writer Pro � Export Options to “Comma Separated

Output”:

3) Run the report using @master to capture all activity in active portfolios. The Output Filename dictates that this CSV file will be saved as [Output Filename]

in your Advent APX exp folder (\\vam-apxapps\APX$\exp\test.txt in the example on the next page).

Manager


**If you receive the following message, choose “Yes” to overwrite the file:

4) When the report is completed, you should see the following screen:


The file format should look like the following (using Microsoft Notepad):

The file is now ready to be used within Telemet Orion. Details of how to setup and access your APX portfolios in Telemet Orion are described on a separate document describing “Portfolio Links”. Telemet Client Services can provide the Portfolio Links

information – 1-800-368-2078 or [email protected].

Appendix 1 – Price File Options Button

The Price file “Options” screen is shown below:

If needed, click on the Price file “Options”

button to modify the price file settings.


Year Format of Price File Name: - 2 digit: use if the .pri file name is in the following format:

mmddyy.pri - 4 digit: use if the .pri file name is in the following format:

mmddyyyy.pri Price File Format:

0 = column 1, 1 = column 2, 2 = column 3, ECT. - Number of Total Fields: The default format is 6 fields, which means

you will see 5 commas if you open the price file with Microsoft Notepad.

- Security Type Field Index: What is the location of the Security Type column? The default is 0, which means column 1 when viewed with Microsoft Notepad.

- Symbol Field Index: What is the location of the Symbol Field column? The default is 1, which means column 2 when viewed with Microsoft Notepad.

- Price Field Index: What is the location of the Price Field column? The

default is 2, which means column 3 when viewed with Microsoft Notepad.

Delimiter:

Comma: This is the default setting and should be used if the .pri file is a csv (Comma Separated Variable) file. Tab: This should be used if the .pri file is tab delimited (i.e. each field is separated by a tab).

Price File Path: This is the path where price files (once out of APX) are located. In the example above there is a folder named “Advent APX Files” on the desktop.

Appendix 2 – Cash Dividend to Trade Blotter Options

Button


The Cash Dividend to Trade Blotter “Options” button is shown below:

Security Information File (CSV Format): Enter the location (path) where your Security Information File (sec.inf) is located. Dividend Output File (CSV Format): Enter the location (path) where you want the Dividend Output file (topost.trn) file to be located.

Appendix 3 – Security Information File Options Button


The Security Information “Options” button is shown below:

- Security Information File: Set the location (path) of the Security

Information File (sec.inf). - Field Delimiter: Is your file Tab or Comma delimited? - Field Selection for Security Information Updating: Televista APX can

be used to update the following 4 fields:

o CUSIP o Name o Dividend Payment Date o Dividend Rate

advent apx instructions - telemet america · with advent apx using telemet software with advent apx...

Documents