Bloomberg BBU

Download Bloomberg BBU

Post on 04-Mar-2015




82 download

Embed Size (px)


<p>BLOOMBERG BASIC PORTFOLIO UPLOADER - BBU Upload File SpecificationDOCS 2050932</p> <p>March 2011 </p> <p>1 </p> <p>Table of Contents </p> <p>ALPHA OVERVIEW BBU Overview BASIC UPLOAD Interactive and Scheduled Uploads (while logged in) File Description Data Requirements Step 1: Minimum Inputs Step 2: Set Your User Defaults Step 3: Begin Basic Upload Step 4: Upload your File Step 5: Click to Map Step 6: Spreadsheet Selection Step 7: File-level Mapping Step 8: Column Mapping Step 9: Map unknown security identifiers Step 10: Override Defaults Step 11: Check for Errors and Schedule Step 12: Schedule Basic Uploads MANAGING YOUR MAPPINGS___________ ___ BLOOMBERG SECURITY (FILE ENCRYPTION) FTP UPLOADS FREQUENTLY ASKED QUESTIONS (FAQs): Appendix 1: Column Mapping Definitions Appendix 2: Security Identifier Types Appendix 3: Ticker Formatting Equity Ticker US and Canadian Listed Equity and Equity Index Option Tickers Physical Index and Commodity Option Ticker Index and Commodity Future Ticker Cash Foreign Exchange Ticker Appendix 4: Additional Supporting Documentation</p> <p>3 4 5 5 5 7 7 9 9 10 10 11 12 12 14 15 16 17 19 19 20 23 25 26 26 26 27 28 28 28 29</p> <p>2 </p> <p>ALPHA OVERVIEWALPHA is Bloombergs Portfolio Analytics and Risk solution that offers an enhanced series of customizable tools for the desktop plus a new suit of products and services uniquely designed for a company-wide enterprise. In a world where your companys performance depends on the ability to manage complexity and consistently out-think the market, Bloomberg ALPHA Desktop, and ALPHA Enterprise support portfolio managers and senior management with a series of new and enhanced tools for portfolio analytics and risk. ALPHA Desktop is the single user version of ALPHA that is part of the BLOOMBERG PROFESSIONAL service. ALPHA Enterprise was built from the ground up, extending the capabilities of ALPHA Desktop to include Enterprise Management tools and sophisticated Enterprise reporting.</p> <p>3 </p> <p>BBU OVERVIEWThe Bloomberg Uploader function (BBU) enables you to: Interactively upload portfolio data to the Bloomberg terminal from your desktop Schedule basic uploads of portfolio data from your desktop Schedule uploads of portfolio data via FTP over the internet or over a private leased line (see DOCS 2055407 for more information on FTP account setup)</p> <p>The type of portfolio data BBU supports includes portfolio positions (current and historical), custom prices, custom benchmarks, and custom classifications. Input files can either conform to a specific format recognized by BBU, or users can take advantage of some basic mapping tools to instruct BBU on the layout and interpretation of their files. Once uploaded, portfolios can be viewed in any of the Bloomberg ALPHA functions for further definition and analysis. The remainder of this document will explain the process for uploading portfolio positions. Please see DOCS 2050935 for examples of uploading custom benchmarks, and DOCS 2050958 for examples of uploading custom classifications. ALPHA Desktop users can schedule the upload of a maximum of 50 portfolios per day (that is one scheduled upload file per portfolio, up to 50, or one file containing 50 portfolios). Any additional portfolios would have to be uploaded interactively. Users that need to schedule more than 50 portfolio uploads per day would need to subscribe to the ALPHA Enterprise service.</p> <p>4 </p> <p>BASIC UPLOAD Interactive and Scheduled Uploads (while logged in)File DescriptionThe position file to be uploaded can be either a Microsoft Excel file (.xls or .xlsx) or an ASCII text file. Users typically set up a one-time mapping of the columns of data in their file so that BBU knows the delimiter to use as a data separator, which columns of data to import, and what those respective columns represent. If the portfolio name is not supplied, it defaults to the name of the uploaded file. One import file can contain positions for multiple portfolios. In addition, one import file can contain positions for multiple historical dates. You only need to load historical positions if you are interested in using ALPHAs performance-based analytics, such as HFA for historical fund analysis, or BBAT for return attribution. If you do choose to backfill history on a portfolio, note that you only need to upload those dates for which there is a change in your positions. ALPHA analytics will carry forward previously set positions if none are explicitly set on a given date. For those who maintain portfolios on an ongoing basis, todays positions can be added to an existing portfolio.</p> <p>Data RequirementsThe minimum fields required to create a portfolio are the Portfolio Name, Base Currency and Asset Class Type (Balanced, Equity, Fixed Income or Fund of Funds), along with a listing of the positions: Security Identifier (e.g. Ticker, CUSIP, ISIN) and position size expressed as either a Weight (Fixed or Drifting) or Quantity (e.g. shares, par amount). Total Valuation for the portfolio is required when weights are entered. Optional position-level fields include: 1) (Additional) Security Identifier A position file can contain multiple Security Identifier columns. They will be read left to right and the first match against the Bloomberg database is the one used to load the position. This kind of waterfall logic is useful for mixed portfolios that might contain CUSIP for US holdings but ISIN for non-US, or Tickers for equity vs. CUSIP/ISIN for fixed income holdings. 2) Date The date associated with the position. The date format is driven by your User Defaults setting (see Step 2 below), and can be changed as part of the mapping process. If no date is supplied, the mapping rules will allow you to make a default assumption, typically set to Today (see Step 9 below for other options). 3) Market Price A client-supplied price to be used in valuing the position. 4) Exchange Bloomberg 2 character exchange code, defaults to composite exchange code of the owner of the portfolio. Alternatively, you can supply a custom exchange code string in this column and set up a mapping to the Bloomberg codes (an exchange code configuration screen will appear as part of the mapping process if you include this column).</p> <p>5 </p> <p>5) Cost Price and Cost FX Rate The current day acquisition price and exchange rate. These are used to calculate intra-day performance in the PRT function. They are not used in performance-related functions that span a longer time period, such as BBAT and HFA.</p> <p>In the following sections, we provide a step-by-step guide to the process of uploading your portfolios to the Bloomberg terminal. This includes setting some general user defaults, setting filespecific mapping instructions, and scheduling recurring uploads once the mapping rules are set.</p> <p>6 </p> <p>Step 1: Review your portfolio positions file for minimum required inputsFigure 1 Sample Position File</p> <p>With BBU, it is easy to upload a position file from an accounting package, custodian, or an Excel Spreadsheet. Figure 1 above shows a sample spreadsheet with holdings for two portfolios: Global Fund and Tech Fund. Global Fund contains positions for two dates, April 30, 2010 and May 28, 2010; the second portfolio, Tech Fund, has positions for June 1, 2010. For each of your holdings, you must supply these minimum fields: Security ID (e.g. CUSIP, ISIN, SEDOL, ticker) Quantity (e.g. original face amount for mortgage-related bonds, current face for nonmortgages, # shares for stocks), Portfolio Name (the upload file name becomes the portfolio name if not supplied)</p> <p>Since this example includes historical positions, we also have a field indicating the Date of the position. (See Step 2 below for rules regarding Date formats.) Note that you do not have to provide column headings, or put the columns in any particular order. The column definitions will be identified by the mapping process. For global stock portfolios, if you supply ticker you must also provide the Exchange Code (see Appendix 3: Ticker Formatting). It is recommended that you use CUSIP, ISIN, or SEDOL rather than ticker as these are more accurate (e.g., COP is both the ISO currency code for the Columbian Peso and the equity ticker for ConocoPhillips. To distinguish the two, you need to supply the Bloomberg Yellow Key.) If you use CUSIP, ISIN, or SEDOL, you must include the check digit.</p> <p>7 </p> <p>Step 2: Set Your User DefaultsFigure 2 Set Defaults</p> <p>The first time you run BBU you must enter some default settings that will apply to each of your portfolio uploads. You can change these defaults at any time by clicking on the 3) User Defaults link at the top left of the screen. You can also override these defaults when setting up a specific file mapping. Doing so will not affect your default settings. The default setting choices are: Date Format - Choose the date format used in your position file:o o o MM/DD/YYYY or MM/DD/YY DD/MM/YYYY or DD/MM/YY YYYY/MM/DD or YYYYMMDD or YY/MM/DD</p> <p>Number Format - Choose the number format used in your position file:o o nnn,nnn.dd nnn.nnn,dd</p> <p>Currency - Choose the base currency of portfolio. Asset Class - Choose the asset class of the portfolio:o o o o Balanced Fixed Income Equity Fund of Funds</p> <p>The Asset Class setting is used by ALPHA analytics and risk functions. Bypass Blank Quantity - Choose YES to bypass any holding with a blank quantity, or NO and produce an error for any holding with a blank quantity. Remember, uploads will fail with more than 2,000 errors, or when the file contains more than 50% errors. Divide cash and bond positions by 1000 - Choose YES to divide your cash and bond positions by 1,000 or NO to process your cash and bond positions exactly as they appear in the upload file. 8 </p> <p> Select 1) OK to save your defaults and continue the upload process.</p> <p>9 </p> <p>Step 3: Begin Basic Upload</p> <p>Figure 3 Basic Upload</p> <p>Step 3 of the process is to pull your position file into the Bloomberg terminal so it can be processed by BBU. Begin by selecting 1) Basic Upload. This brings you to the file chooser screen, as shown in Figure 4 below.</p> <p>Step 4: Upload your file</p> <p>Figure 4 Find your Holdings File</p> <p>You can search for your position file by navigating through the folders on your computer, or you can drag and drop the file from your computer/desktop into the middle of this screen. Once youve selected your file, select 1) Upload to begin processing.</p> <p>10 </p> <p>Step 5: Click to Map Figure 5 Map your Holdings File</p> <p>After selecting 1) Upload, BBU will read your file. This step may take anywhere from several seconds to several minutes depending on the size of the file. After BBU has read the file, you will see either Click to Map or Fail under the Status Column, select Click to Map. (Fail indicates we could not read the file, typically because the file name is misspelled or the file is not in the specified directory when doing scheduled uploads.)</p> <p>Step 6: Spreadsheet Selection (for multi-sheet Excel workbooks)Figure 6a Choose the sheet with your data</p> <p>If your file is an Excel workbook with multiple sheets, the next step is to select which sheet youd like to import. Choose the name of the sheet from the dropdown list as shown in Figure 6a. If you choose the first sheet in the list, then you can click 1) Next and continue to Step 7.</p> <p>If you choose a sheet other than the default, then you will get a pop-up message (Figure 6b) indicating that your selected sheet will be converted. Just click 1) Close, the chosen Excel 11 </p> <p> sheet will be converted to text and then you can Click to Map that sheet.</p> <p>Figure 6b</p> <p>Step 7: File-level MappingFigure 7 Set file-level attributes</p> <p>In this step you specify some general information about how to process the file. Using Figure 7 as a guide, work from the top of the screen down. First, select Portfolio from the Upload To dropdown list. Then, if youve previously mapped a file consistent with the format of the current file, you can select the name of that mapping from the Use Existing Mapping drop-down list and skip the remaining inputs by selecting 2) Next at the bottom of the screen.</p> <p>If this is a new mapping, leave this entry blank and choose your file delimiter. Next, indicate at what line to start the upload (e.g., if the first line is a header you want to skip, enter 2 in this field). And finally indicate which lines to ignore (e.g. comment lines that begin with #). Click 2) Next to continue to the next step.</p> <p>12 </p> <p>Step 8: Column MappingFigure 8 Map columns</p> <p>In this step you are mapping the columns of data in your file so that BBU knows which columns of data to import and what those respective columns represent.</p> <p>First choose the kind of security identifiers you will be supplying by selecting from the Security Identifier Type drop down list. The default (and most common) choice is: ISIN/CUSIP/SEDOL/Equity Ticker/Any ID with Yellow Key. If you are uploading security identifiers that are not of these types (e.g. Mortgage Pool Number), either select the appropriate value from the drop down or add a column to your file enabling BBU to recognize your security identifier (see Appendix 2 for a complete listing of Security Identifier Types). Then, use the pull downs over the columns of data to associate the column with the data it contains. In this example, the file contains columns for Security ID, Quantity, Portfolio Name and Historical Date. After youve mapped the columns, select 2) Next at the bottom of the screen to go to the next step. If you have already uploaded your portfolio and have entered this screen by editing your mapping, you may click on Show Error Lines to display any holdings from your portfolio file that were not processed, and the reason why the holding could not be processed.</p> <p>13 </p> <p>Step 9: Map unknown security identifiersFigure 9 Security Mappings</p> <p>This step allows you to create a mapping from your custom security identifiers to ones recognized by Bloomberg.</p> <p>The most common example is cash. The portfolio in Figure 1 contains a clients ticker for US Dollars and Japanese Yen. However, the cash identifier recognized by Bloomberg is ISO currency code followed by the keyword Curncy. In Figure 9 above, on the left panel of the screen, we set the mapping so that these cash positions are not excluded. Another common problem is security identifiers containing characters that need to be replaced by other characters. This arises, for example, when clients use their own conventions for separating stock tickers from exchange codes. If a clients identifier uses a . to separate a ticker from the exchange (e.g., MQF.BO), then the Replace panel on the right of Figure 9 above may be used to replace all occurrences of . with +, the separator used by Bloomberg (e.g., MQF+BO). Any security level mappings you set in this screen are applied after the file is uploaded, and are NOT made to your original Excel or text file. These mappings will be remembered and re-applied each...</p>