Fficial: Depending On The Product, A Breakdown Can Be Added (Example: One Line Per Leg, One Line Per Currency)
Fficial: Depending On The Product, A Breakdown Can Be Added (Example: One Line Per Leg, One Line Per Currency)
V ER SI ON 1 6 .0
April 2018 - First Edition
1 . OF F I CI AL P & L OV E RV I E W
Official PL is the P&L solution Calypso provides for cross–asset P&L computation, attribution and reporting. Official
P&L has been developed in order to address our clients' business drivers in terms of: cross asset coverage, front to
back comprehension, front office and risk decision support, performance, reporting and audit capabilities.
Official P&L computes P&L measures by book and different granular levels as follows:
• OTC trades: Trade by trade, before and after settlement
• Position-based products: Product positions computed by the Liquidation engine
• FX trades: Trade by trade, before and after settlement, or by position
Depending on the product, a breakdown can be added (example: one line per leg, one line per currency)
Within the P&L computation Official P&L provides also the following features:
• Cost of funding computation: Occurs at trade level based on a theoretical overnight funding rate, or at P&L Unit
level based on actual funding rates.
• Base FX translation: Following methodologies are available:
– Converting P&L measures in base using end FX rates
– Converting start P&L measures using start FX rates, and end P&L measures using end FX rates
– Converting P&L in base measures using historical FX rates
• Crystallization: Represents a year-end process theoretically converting all P&L earned during the year into an
actual asset in base currency.
• FX Sell-off: Allows sweeping the P&L from a trading book to a FX sell-off book.
P&L Measures
P&L measures are computed by comparing a set of P&L marks between the start dates and the end date of the report
period. P&L marks are computed within the P&L process by several product calculators and stored in the data base on
a daily basis. When P&L is run at the end of the day, as marks have been saved previously, we will be able to compute
daily, monthly, yearly as well as the inception to date P&L.
The Official P&L report computes mainly the following P&L measures:
• P&L: Total P&L of a trade
P&L can be further broken down into Unrealized P&L and Realized P&L.
• Realized P&L: P&L that has been realized. Amounts are certain and are not sensitive to time and market
conditions anymore.
The realized part of the total P&L is broken down into Realized MTM P&L + Realized Accrual P&L + Realized
Accretion P&L + Realized Other P&L:
– Realized MTM P&L: P&L from buying and selling (liquidation), pay-down, settling/realizing MTM fees
(Premium, termination, etc.)
– Realized Accrual P&L: P&L from coupon/interest payments, liquidation of a trade with accrual.
– Realized Accretion P&L: P&L from liquidating a bond which has an accreted value.
– Realized Other P&L: P&L from Fees that have settled
* You can also show the fees in the other buckets as needed - Please refer to Calypso Official P&L Setup
Requirement guide for details.
• Unrealized P&L: P&L that could be generated according to the market conditions and current position
The unrealized part of the total P&L is broken down into Unrealized MTM P&L + Unrealized Accrual P&L +
Unrealized Accretion P&L + Unrealized Other P&L:
– Unrealized MTM P&L: P&L from price and quote movements without liquidation, PV of MTM Fees,
change in NPV due to moving a day
– Unrealized Accrual P&L: P&L from future coupon/interest cashflows that have not yet been paid
– Unrealized Accretion P&L: P&L from amortization towards
– Unrealized Other P&L: P&L from Fees that have not yet settled
* You can also show the fees in the other buckets as needed - Please refer to Calypso Official P&L Setup
Requirement guide for details.
P&L can also be split into Risk Value and Settled Cash
• Risk Value: Market, position and time sensitive component of the P&L
Risk Value is broken down into Asset Value and Unsettled Cash
– Asset Value: Intrinsic value of the asset consistent with the P&L methodology
– Unsettled Cash: Sum of all discounted cashflows that are part of the P&L, but not part of the Asset Value or
Settled Cash
• Settled Cash: Sum of all settled cashflows
P&L Explained
The Official P&L can also run with the P&L Explained feature to provide P&L attribution to individual effects.
Please refer to Official P&L – P&L Explain documentation for more details.
General Process
Before you run the Official P&L report for the first time, you need to review the setup requirements.
You also need to initialize the system for Official P&L processes and functions.
Configuring P&L methodology, P&L config and defining Official P&L parameters are the preliminary steps of the P&L
process.
The recommended chain for running the Official P&L on a daily basis (between D and D+1) is the following:
Step 1 - Close market data and save them with a cutoff date and time as of day D, say 5PM.
Step 2 - Run End of Day P&L process with an as of date D, say 6PM.
* If required, after Step 2, review market data for maintenance (roll futures, change underlying, etc.) and re-mark
curves as of day D, 6PM or before. This will generate a Start Pricing Env Change effect that will be computed the next
day.
Step 3 - OPTIONAL - Generate Greeks with an as of date D+1, morning.
Contents
2 . OF F I CI AL P & L R E P O RT
2.1 C ONFIGURATION
The Official P&L parameters are configured through the Analysis Designer. You can bring up the Analysis Designer
from one of the following windows:
• Click Risk in the Calypso Navigator, and select the analysis type OfficialPL then click ... next to the field "Analysis
Param Set".
• From the Calypso Navigator, navigate to Configuration > Reporting & Risk > Analysis Designer .
Right-click an OfficialPL folder in Analysis Designer, and choose "New Analysis" to add a parameter configuration for
the Official P&L report. You will be prompted to enter a configuration name.
» Enter information into the fields as applicable. The fields are described below.
» Click Save .
Or click Save As to save a new P&L Methodology Configuration.
You can add new rows as needed as more products are added to your trade filter.
Fields Details
Field Description
Desk Select a desk (Desk book attribute), or ANY for all desks.
The Desk book attribute is defined with the checkbox “Selected attribute is the P&L
Methodology Driver" in the Book Attribute window by default. You could change it to
another attribute before you run any P&L process.
[NOTE: Only one attribute can have this checkbox checked, and once it is chosen it
cannot be modified as marks, methodology configurations and Official P&L configuration
would need to be modified as well]
Book Select a book, or ANY for all books.
Product Select a product type.
[NOTE: You need to configure a P&L methodology for each product in your trade filter. If
there is no P&L methodology available for the product type, you must select None (this
will allow mark creation for the product type, with 0 for all the P&L measures)]
[NOTE: If you are performing sell-off, you need a P&L methodology for the
SimpleTransfer product]
Field Description
Methodology Select the methodology to be used for the selected product.
Methodologies provided out-of-the box:
• AmortizedCost - Only accrual amounts are shown in the P&L
When FX Swap trades are processed with the AmortizedCost methodology, two
synthetic cash trades (one for each currency) are created, and the P&L is
computed on these trades. This only applies if "FX By Positions" is not set to true.
• AmortizedValue
• Cash
• FTP - Fund Transfer Pricing
• FairValue
• Transfer - For SimpleTransfer and SubscripRedemp.
Depending on the methodology, the P&L measures are computed differently.
» Enter information into the fields as applicable. The fields are described below.
[NOTE: Empty fields outlined in red are mandatory and need to be filled before saving]
» Click Save .
8 Official P&L
[NOTE: Once a P&L Configuration is used in a set of Official P&L parameters, it cannot be modified, except for the
Trade Attributes]
Fields Details
Field Description
Name Displays the P&L Configuration name.
The name is entered upon saving.
Type Select Official, Unofficial or Intraday.
Official
An Official configuration allows performing FX translation, Cost of Funding and
Crystallization.
There should be only one Official configuration for a given set of books as the processes
for sell-off and cost of funding create trades, and these trades should be created only
once.
Unofficial
The goal of Unofficial configurations is to handle Flash P&L at different end times during
the day.
Intraday
You can also select Intraday to view P&L for the day.
[NOTE: For Intraday configurations, the pricing environment cannot be selected. The
report uses the pricing environment specified in the Calculation Server configuration]
Valuation Time Enter the valuation time of the P&L results in HH:MM:SS (24 hour) format.
Timezone Select the time zone of the valuation time.
[NOTE: The timezone must be the same as the timezone of the pricing environment and
the trade filter (if specified)]
Field Description
Include Back-dated When checked, trades are loaded by their trade date, independently of the entered date.
Trades and Corrections The system loads the current version of the trade and determines if the trade date is on
or before the valuation date. If so, the trade is included in the report. If the trade date is
after the valuation date, the trade is not included.
Example: A back-dated trade is entered on 25/10 and the trade date is set to 20/10. If
the valuation date is 22/10, the trade is loaded even though the trade did not exist in the
system on 22/10, because the trade date is before the valuation date.
When not checked, the system loads the trades as of the valuation date and time. The
system rolls back the trade audit to the valuation date. The trade described in the
example above would not be included in the report as the entered date is after the
valuation date.
[NOTE: This only applies to the inactive trades of the current year. Inactive trades of
previous years are always aggregated]
P&L Methodology This field is mandatory. Select the P&L Methodology Configuration to be used to compute
Configuration the P&L results.
Field Description
• Trade - Cost of Funding effects will appear on the trade P&L lines in the P&L report.
Crystallization Level Only appears for Official configurations.
Select the level at which P&L is crystallized:
• None - There is no crystallization.
• Book - Crystallization is aggregated at book level. Crystallization effects will appear
on a separate P&L line in the P&L report.
• Trade - Crystallization effects will appear on the trade P&L lines in the P&L report.
Crystallization is an end-of-the-year process that involves converting the P&L earned
throughout the year into an asset and moving it to retained earnings on the balance
sheet. This is equivalent to selling the entire portfolio (at market value) and immediately
repurchasing it (at the same market value). Any P&L realized through this process is
converted to base currency and moved to the balance sheet. This is reflected in the
P&L report.
Crystallization Measures Select the P&L measures to be crystallized.
Cost of Funding on Crys- Check to compute Cost of Funding on crystallized P&L.
tallized P&L
FX Translation Only appears for Official configurations.
When checked, FX translation P&L is included in the base P&L measures. All starting
measures are converted to the base currency using the starting FX rate, and all ending
measures are converted to the base currency using the ending FX rate.
FX translation can also be performed using historical rates, see below.
When unchecked, the base P&L does not include FX translation P&L - All P&L measures
are converted to the base currency using the ending FX rate.
FX Sell Off Measures Only appears if FX Translation is checked.
Select the P&L measures to be sold off. You can select Realized P&L and/or Unrealized
P&L.
The sell-off process is described in details below.
FX Translation using Only appears if FX Translation is checked.
Historical Rates Select the P&L measures for which FX translation should be done using historical FX
rates.
For these measures, the FX translation is computed iteratively using the rates of each
historical date, not just the starting FX rate and the ending FX rate.
[NOTE: Any P&L measure that is configured to use historical FX rates for base
conversion, is automatically excluded from the sell-off process]
Investment PL Only applies to Asset Management and only enabled if the environment property ASSET_
MANAGEMENT=true.
When checked, enables the computation of Inception To Date (ITD) Investment P&L
measures.
2. 1. 3 OF F IC IA L P& L PA R A MET ER S
Finally, define the Official P&L parameters:
Parameters Details
Parameters Description
Daily P&L Only Check “Daily Only” to compute only Daily and Inception-to-date (ITD) P&L.
Uncheck to compute Daily, MTD, YTD, and ITD P&L.
• Daily - P&L between the previous business day and the valuation date.
• MTD - Month-to-date, P&L between the last business day of the previous month and
the valuation date.
• YTD - Year-to-date, P&L between the last business day of the previous year and the
valuation date.
• ITD - Inception-to-date, P&L between the inception date and the valuation date.
The valuation date is the valuation date of the scheduled task EOD_OFFICIALPL: Execution
Date - Valuation Date Offset.
* The system always ensures that there is at least one business day for each P&L run. For
example if the valuation date falls on a weekend or holiday, the system goes back to the
prior business day, then using that date computes daily, month to date, and year to date
P&L.
Explain P&L Select to add the P&L attribute of the daily P&L:
• N/A - No P&L explain.
• Cumulative - Compute market data effects cumulatively.
• Independent - Computes market data effects independently.
• Independent With Greeks - Computes market data effects by Greeks/Taylor Series and
compares to Independent P&L explain.
2. 2. 1 C OST OF FU N D IN G
The Cost of Funding computes the actual or theoretical funding of the long and short cash positions based on funding
rates. Calculations are based on settled cash. Cost of Funding is its own category in P&L and can occur at trade level
based on a theoretical overnight funding rate, or at book level based on actual funding rates.
Trade level Cost of Funding is theoretical and based on the pricer measure CUMULATIVE_CASH. The rate is taken
from the Funding Rate configuration (Configuration > Definitions > Funding Rates ), which should be set up with
overnight index per currency.
Trade Level Cost of Funding appears as a column in the P&L report provided Cost of Funding P&L Measures were
selected during P&L Configuration:
Cost of Funding formula, used for trade level computation is the following:
• Cost of Funding [@D] = Cost of Funding [@D-1] + 1-dayCostofFunding [@D]
• 1-dayCostofFunding [@D] = Interest [start=D-1; end = D; notional=(CUMULATIVE_CASH[D-1] + Cost of
Funding [D-1] )]
Before performing a position rollover, you must define the position rollover configuration using Navigator
> Configuration > Automated Operations > Position Rollover. For more information on how to define a position
rollover, please refer to Calypso FX Position Rollover documentation.
To perform a position rollover, you can navigate to Trade Lifecycle > Rollover > Position Rollover from the Calypso
Navigator, or use the scheduled task POSITION_ROLLOVER.
For the scheduled task, make sure to include your trade filter under "Trade Filter" in the Common Attributes.
The rollover process creates loans or deposits against the balances held by the desk. These loans or deposits are
Structured Flows trades with the subtype "Funding" or "FXFunding". The Rate is the breakeven rate for the given
overnight Structured Flows trade.
You can also manually create these loans and deposits by creating a new Structured Flows trade and adding the trade
attribute "FundingType" with the value as either "Funding" or "FXFunding". This automatically sets the trade subtype
to "Funding" or "FXFunding" upon save.
14 Official P&L
The interest charged on these loans and deposits, whether created through the spot rollover process or manually, is
the Cost of Funding. Cost of Funding is computed by the EOD_OFFICIALPL scheduled task and appears in the P&L
report as a new line under the P&L Type "Cost of Funding":
2. 2. 2 C R YST A L L IZ A T ION
Crystallization allows for P&L earned throughout the year to be captured and theoretically converted into an asset,
then moved to retained earnings on the balance sheet. The P&L is locked in (crystallized) at the start of the year,
therefore the ITD P&L is always equal to the YTD P&L. There is no P&L on the Crystallization other than FX translation
on the trade currency conversion. P&L can be crystallized trade by trade or at book level depending of the choice in
the P&L configuration.
When P&L is generated using crystallized P&L at book level, it appears in the P&L report as a new line under the
P&L Type "Crystallized P&L".
When P&L is generated using crystallized P&L at trade level, crystallized columns are added to the report.
When the scheduled task is run with the Run type "Run P&L Adjustments", the crystallized marks are regenerated. If
adjustments are made on the original marks, this is how they're applied to the crystallized process. This only works
at the year end and will update the crystallized mark based on any changes made at the original trade level marks.
Cost of Funding on Crystallized P&L is computed by the EOD_OFFICIALPL scheduled task, only if:
• "Cost of Funding on Crystallized PL" is checked in the P&L Configuration.
It appears in the P&L report under the P&L Type "Cost of Funding for Crystallized P&L":
2. 2. 3 P & L S EL L -OF F
The sell-off process allows sweeping the FX base translation exposure from a “trading” book to a “sell off” book.
The FX sell-off process runs daily within the scheduled task EOD_OFFICIALPL and creates simple transfer trades to
offset the base translation exposure.
The sell-off process is triggered by a P&L Configuration where FX Sell Off measures are defined and the start/end
sell-off P&L Measures are selected:
The sell-off book is set for each trading book in the book attribute "FX Selloff Book":
16 Official P&L
The sell-off process is based on the sell-off currency and sell-off value:
• For rate and credit books, the sell-off currency is the currency of the trade/leg (currency of the mark).
• For forex books (FX By Positions = true), there is a P&L currency pair populated and available on any trade. The
sell-off currency is the P&L display currency of the currency pair. If there is no currency pair, the sell-off
currency is the currency of the mark.
• For each mark generated from a trade, the sell-off value is the ITD P&L converted into sell-off currency.
Process Details
The example below illustrates a simple sell-off process.
Process is run on a book having 4 trades (2 FX Positions):
Setup:
• Trading book = CP_SIMPLE_TC_SELLOFF_BOOK1 (FX By Positions = true)
• FX Selloff Book = CP_SIMPLE_TC_SELLOFF_BOOKA
• Base currency = AUD (defined in PL Config, Pricing Env)
The sell-off process creates corresponding sell off / sell back trades per groups of marks of the trading book,
aggregated by sell-off currency.
Day D
Mark report examples:
For the only mark (trade id 167947) having sell-off currency EUR, the following trades are created:
• In the trading book: sell-off trade (trade id 168031) to offset the EUR sell-off value (EUR ITD P&L) of 119 534,04
• In the sell-off book: linked mirror sell-off trade (trade id 168032)
• In the trading book: sell-back trade (trade id 168033) to bring back the AUD P&L of 177534,70
• In the sell-off book: linked mirror sell back trade (trade id 168034)
Note that no sell-off value is computed on the sell back trade.
For the marks having sell off currency USD, the following trades are created:
• In the trading book: sell off trade (trade id 168027) to offset the USD sell-off value (USD ITD P&L) of -14,99
• In the sell-off book: linked mirror sell-off trade (trade id 168028)
• In the trading book: sell-back trade (trade id 168029) to bring back the AUD P&L of 21,42
• In the sell-off book: linked mirror sell back trade (trade id 168030)
Note that some of the marks having a sell-off currency in USD have a P&L currency in EUR; this happens because the
P&L display currency of the currency pair set on the mark (EUR/USD) is USD. Note also that the currency of the sell-
off values is the sell-off currency (here USD) , whereas the currency of the P&L measures is the P&L currency (here
EUR).
For the marks having sell-off currency AUD (base currency), no sell-off/ sell-back trades are created.
Day D+1
Mark report examples:
18 Official P&L
For the marks (swap trade id 167947 and previous day sell off trade id 168031) having sell-off currency EUR, the
following trades are created:
• In the trading book: sell-off trade (trade id 168438) to offset the total EUR sell-off value (EUR ITD P&L) of 1.22
• In the sell-off book: linked mirror sell off trade id 168439
• In the trading book: sell-back trade (trade id 168440) to bring back the AUD P&L of 1.83
• In the sell-off book: linked mirror sell back trade (trade id 168441)
For the marks having sell-off currency USD, the following trades are created:
• In the trading book: sell-off trade (trade id 168434) to offset the USD sell-off value (USD ITD P&L) of 95.98
• In the sell-off book: linked mirror sell-off trade (trade id 168435)
• In the trading book: sell-back trade (trade id 168436) to bring back the AUD P&L of 119.95
• In the sell-off book: linked mirror sell-back trade (trade id 168437)
For the marks having sell-off currency AUD (base currency), no sell-off/ sell-back trades are created.
2. 2. 4 B A SE FX TR A N SL A T ION
Base FX translation is driven by the P&L Configuration:
2.3 E OD P ROCE S S
The Official P&L is an end-of-day process. It is run exclusively by the scheduled task EOD_OFFICIALPL, which
computes the marks and generates a report that is saved to the database. The saved report can be viewed in the
Calypso Workstation.
2. 3. 1 R U N N IN G EOD OF F IC IA L P& L
You can configure the scheduled task EOD_OFFICIALPL using Configuration > Scheduled Tasks (menu action
scheduling.ScheduledTaskListWindow), and add a task of type EOD_OFFICIALPL.
The scheduled task carries out the following functions:
• Computes P&L marks and saves P&L marks to the database
• Generates the Official P&L report and saves it to the database (including P&L explain if requested)
• Performs FX sell-off, fX translation, cost of funding computation, and crystallization if applicable
[NOTE: The pricing environment, valuation time and timezone are taken from the Official P&L parameters regardless
of the values specified in the scheduled task]
Task Attributes:
• Official P&L Parameters - Select the Official P&L parameters.
Refer to the Calypso Installation Guide for details on setting up distributed processing, and read-only Data
Servers.
To verify Official P&L calculators for multiple trades, you can also use the Official P&L troubleshooting tool.
These three modes can be configured by using a “Corrections Trade filter” in the scheduled task and by setting to
true/ false the “Correct Error Trades Only” option.
The scheduled task produces meaningful logs about the trade ids / marks that have been effectively corrected and
the mark's “Enter date” is updated.
Refer to the Calypso Installation Guide for details on setting up distributed processing.
• Correct Error Trades Only - Only applies when a Corrections Trade Filter is selected. If true, the scheduled task
will only correct trades with error marks in the Corrections Trade Filter, otherwise it will correct all the marks in
the Corrections Trade Filter.
If crystallization is turned on, the scheduled task OFFICIALPLCORRECTIONS will create crystallized marks if
needed.
Once you the scheduled task OFFICIALPLCORRECTIONS, you need to re-run the scheduled task
EOD_OFFICIALPL with the option "Run P&L Adjustments" to regenerate the Official P&L report
with the corrected marks.
Example
Official P&L Report run with bond quote = "100.35".
P&L Marks:
Then you re-run the Official P&L report with option "Run P&L Adjustments" so that the corrected marks are used.
Official P&L report:
» Enter search criteria as needed and click to load the corresponding P&L marks.
The number of loaded P&L marks is limited by the Access Permissions attribute "Max.OfficialPLMark", and
defaults to 1000.
24 Official P&L
[NOTE: The P&L marks are stored by P&L Configuration - If you modify the P&L Configuration of a given set of Official
P&L parameters, you need to re-run the scheduled task EOD_OFFICIALPL to store the P&L marks for the new
configuration]
» You can configure the display as needed, and save the display as a template.
» In case there is an error (Status = Error), you can right-click the P&L mark and choose "Show Error" to display
the error details.
» You can right-click a P&L mark, and choose “Enter Mark Adjustment” to adjust it.
Enter the adjustment amount in the Adjustment field, and enter an adjustment comment, then click Adjust. The
status of the P&L mark moves to "Adjusted".
You can only adjust P&L marks in P&L currency. The corresponding base P&L marks will be recomputed
accordingly.
For an already adjusted P&L mark, you can remove the adjustment. The status of the P&L mark moves to
"Adjustment Removed".
Once you adjust the marks, you need to re-run the scheduled task EOD_OFFICIALPL with the
option "Run P&L Adjustments" to regenerate the Official P&L report.
» You can right-click P&L marks in status "Adjusted" and "Adjustment Removed", and choose "Audit Report" to
view the details of the adjustment.
» Select the Official P&L parameters, Trade Filter and Pricing Env you used to run the report.
» Click Add, then click Save to save the Calculation Server configuration.
In the "Report Collection" panel on the left-hand side, select the root level or any existing folder, and click to add a
new saved report.
You will be prompted to give it a name, and select the report source.
26 Official P&L
You can select columns, filter the results, sort the results, and set coloring rules as needed.
For the Official P&L report, you can define a Simple view, or a Hierarchy view.
The Hierarchy view will be displayed as follows with a navigation bar:
You can expand / collapse the various levels using the navigation bar.
You can choose Help > Calypso Workstation Help for complete details on using the Calypso Workstation.
You can also choose > Configure Report Plan on the right-hand side to configure the layout.
For a Hierarchy view, you can choose > Show Detail to display the trades of an aggregation level.
[NOTE: If you configure drilldown reports on the Official P&L report, they will only provide the P&L bucketing, not
details on P&L attribution - To explain the P&L, please run the Official P&L report with the "Explain P&L" option]
Column Description
P&L Type Type of trade:
• Trading - Captured trade.
• FX Sell-off - Trade resulting from a sell-off.
• Inactive Trade - A trade is considered inactive on a given day if the following
conditions are met
– There was no change in the value of the trade today.
– The value of the trade is not expected to change in the future.
When a trade/position becomes inactive, its P&L is not reported on a separate line
item (this always happens for previous year's inactive trades, and is configurable
from the P&L Configuration for the current year's inactive trades). The P&L is
merged with other inactive trades and reported on a summary line in the report.
One summary line is reported for every book and currency.
[NOTE: Inactive trades are trades that are not loaded and priced; their marks are copied
over from one day to another]
P&L Methodology P&L methodology used to compute the P&L.
P&L Product Type Trade's or position's product type subject to P&L.
Subtype In the case of a Structured Product trade, it is the product type of the underlying
product.
Extended Type
Start End Measures Each P&L measure is associated with a P&L mark, and P&L is computed as the difference
between two P&L marks:
• Measure [END] implies the measure of the P&L mark at the P&L reporting date
• Measure [DLY] implies the measure of the P&L mark at the end of the previous
business day
• Measure [MTD] implies the measure of the P&L mark at the last business day of
previous fiscal month
• Measure [YTD] implies the measure of the P&L mark at the last business day of
previous fiscal year
Column Description
"Follow the Product" Measures
P&L = Realized P&L + Unrealized P&L
• Realized P&L: P&L that has been realized. Amounts are certain and are not
sensitive to time and market conditions anymore.
The realized part of the total P&L is broken down into Realized MTM P&L + Realized
Accrual P&L + Realized Accretion P&L + Realized Other P&L:
– Realized MTM P&L: P&L from buying and selling (liquidation), pay-down,
settling/realizing MTM fees (Premium, termination, etc.)
– Realized Accrual P&L: P&L from coupon/interest payments, liquidation of
a trade with accrual.
– Realized Accretion P&L: P&L from liquidating a bond which has an
accreted value.
– Realized Other P&L: P&L from Fees that have settled
* You can also show the fees in the other buckets as needed - Please refer to
Calypso Official P&L Setup Requirement guide for details.
• Unrealized P&L: P&L that could be generated according to the market conditions
and current position
The unrealized part of the total P&L is broken down into Unrealized MTM P&L +
Unrealized Accrual P&L + Unrealized Accretion P&L + Unrealized Other P&L:
– Unrealized MTM P&L: P&L from price and quote movements without
liquidation, PV of MTM Fees, change in NPV due to moving a day
– Unrealized Accrual P&L: P&L from future coupon/interest cashflows that
have not yet been paid
– Unrealized Accretion P&L: P&L from amortization towards
– Unrealized Other P&L: P&L from Fees that have not yet settled
* You can also show the fees in the other buckets as needed - Please refer to
Calypso Official P&L Setup Requirement guide for details.
"Follow the Cash" Measures
P&L = Risk Value + Settled Cash
• Risk Value: Market, position and time sensitive component of the P&L
Risk Value is broken down into Asset Value and Unsettled Cash
– Asset Value: Intrinsic value of the asset consistent with the P&L methodology
– Unsettled Cash: Sum of all discounted cashflows that are part of the P&L, but
not part of the Asset Value or Settled Cash
• Settled Cash: Sum of all settled cashflows
30 Official P&L
Column Description
Other Measures
• CUMULATIVE_CASH: Sum of flows on the trade which generate transfers.
• CA_COST: Cost.
Refer to Calypso Pricer Measures documentation for details per Product Class.
• CA_NOTIONAL: Notional.
Refer to Calypso Pricer Measures documentation for details per Product Class.
• CA_PV: Net present value ignoring all fees and upfront costs.
• Cost of Funding: Funding charge on Cumulative Cash.
• Cost of Funding for Crystallized: Cost of funding of crystallized P&L mark.
• FX Rate to Base: FX Rate which is used to convert trade CCY flows into P&L
reporting currency.
• Unrealized Crystallized: Crystallized unrealized P&L mark.
Deprecated Measures
• Settled Proceeds: All settled mark to market/accrual fees and trade cash flows.
• Unsettled Proceeds: Any known fee/payments that are due but not settled.
Investment Measures
The following P&L measures can only be displayed in the Asset Management reports:
Investment P&L, Realized Investment P&L, Unrealized Investment P&L, Realized Capital
P&L, Realized Cross P&L, Realized FX P&L, Unrealized Capital P&L, Unrealized Cross P&L,
Unrealized FX P&L, Funding Balance, Funding Average FX.
Common Attributes
• Select a trade filter.
Task Attributes
• Run Type - Select the following run type to export the columns defined in the attribute "Columns To Export" or
the columns defined in a header file.
– "Run P&L Report Export" - This mode uses the attribute "Columns to Export" to export the corresponding
columns, and ignores the attribute "Header File Name".
– "Run P&L Report Export Using Header File" - This mode uses the attribute "Header File Name" to export the
columns defined in the header file, and ignores the attribute "Columns to Export".
– "Generate Header File Only" – This mode generates a header file containing all the columns from the most
recently saved Official P&L report.
The header file has the following format: one column per row.
Example:
32 Official P&L
Task Attributes
• P&L Scheduled Task id - The ID of the Official P&L scheduled task (EOD_OFFICIALPL) that was used to generate
the marks. This is a mandatory field.
• Header File Name - Enter the name of the header file that contains the columns to be displayed in the report.
If the path is not specified for the header file, it is retrieved by default from <user home>/Calypso.
• Output Format - Select the output format of the generated report: HTML, EXCEL, CSV, TXT.
• Export File Name - Enter the file name of the generated report.
If the path is not specified for the file, it is saved by default in <user home>/Calypso.
• Append Timestamp to File Name - Select one of the following options:
– "No Timestamp".
– "Date and Time" - Append the file name with the valuation date and time (format YYYYMMDDTHHMMSS).
– "Date Only" - Append the file name with the valuation date (format YYYYMMDD).
– "Legacy Format" - Append the file name with the valuation date (format DD-MM-YYYY).
Example
34 Official P&L
When you run the Official P&L with P&L Explain, you can choose between Cumulative, Independent, or Independent
With Greeks:
The difference between the methods only applies to the Market Data Effect.
– Trading Activity is defined as an action on the trade that is related to trade administration, such as
booking a new trade, or amending or canceling an existing trade. Trade Lifecycle is defined as an action
that is business related, such as a Termination or an Exercise.
– Known Events are events that are not driven by market decisions. They are either predetermined actions,
such as corporate actions on Fixed income, or corrections that are assumed to have an impact from the
start of the trade, such as cancellations or amendments. This means they are processed with valuation of
the trade with Market Data as of previous day. Example: Allocation, Amend, Backdated, Cancel, Expiry,
Rollover, Settlement
• Unknown Trading Activity and Lifecycle Events Effect:
– Trading Activity effect and Trade Lifecycle effect cover the P&L component attributed to known trade
events and unknown trade events.
– Trading Activity is defined as an action on the trade that is related to trade administration, such as
booking a new trade, or amending or canceling an existing trade. Trade Lifecycle is defined as an action
that is business related, such as a Termination or an Exercise.
– Unknown Events are decisions that are driven by the market, so they will take the valuation using the
market data as of current day. Example: New Trade, Allocation, Amend, Backdated, Cancel, Expiry,
Rollover, Settlement
• FX Translation Effect - It is only computed when “FX Translation” is checked in the P&L Config.
FX Translation Effect= P&L [DLY] Base – (P&L [DLY] * FX[VD]) = P&L [DLY] Base - P&L (Base)
• Residual Effect - Any other changes between marks and actual valuation that cannot be explained by other
effects. A non-zero value usually indicates an issue.
Please refer to the Calypso System Guide for details on setting up distributed processing.
• "Grid: Trades per job" - You can enter the number of trades per job if using Dispatcher.
To verify the Greeks, you can use the Live PL Greeks Admin report.
You can also verify the results using the Sensitivity report.
You can also run the scheduled task PL_GREEKS_INPUT for Sensitivity reports using the Calypso Data Grid.
Please refer to Calypso Data Grid for Risk Reports documentation for details.
The Greeks should be run EOD for the next day morning, so the Valuation time should be set correspondingly.
The recommended chain for running the Official P&L on a daily basis (between D & D+1) is the following:
Step 1 - Mark market data and save them with a cutoff date and time as of day D, say 5PM.
Step 2 - Run End of Day P&L process with an as of date D, say 6PM.
* If required, after Step 2, review market data for maintenance (roll futures, change underlying, etc) and re-mark
curves as of day D, 6PM or before. This will generate a Start Pricing Env Change effect that will be computed the next
day.
Step 3 - EOD D, generate Greeks with an as of date D+1, morning.
» From the left-hand side, you can select which information you want to review: Select "PL Attribution" for the
summary view, or select a specific effect.
» From the right-hand side, you can drill down into the details of a given effect.
» For trade-related effects, when you select an effect in the P&L Explain report, you can drill-down to the trades.
This only applies to Rate Reset, Termination, and Back-Dated trades. When a user selects a detailed view for one
of these three effects from the bottom PL Explained panel within CWS, they can drilldown into a sorted view of
the exact trade IDs that make up that effect. This is especially important for trading activity and trading lifecycle
effects, as these effects are more reliant on the users input and configuration. This feature therefore gives end
users the ability to pinpoint exactly which trades are causing issues within their P&L
You can then select a market data item from the right-hand side to breakdown the P&L at the underlying level.
When selecting Greeks Explain detailed view from the left panel, essentially the detailed breakdown of the market
data effects by Greeks, the user can pick and choose which columns to show based on the effect that they are
reviewing. In general, these columns will give the user information on the market data quote for the underlying
before and after, the change in the relevant unit for the underlying, the delta (or Vega in the case of volatilities) in
both risk and PL currency, and finally the Greeks P&L as a result of the change in market data multiplied by the
relevant risk factor quote in three possible currencies( amount of currencies shown depends on the effect) : the risk
currency, the PL currency, and the base PE currency.
which can be simplified to just the change in quotes by a simple difference (i.e. end 1.2 start 1.1 vol change is
.1 ), FX effect will show the change in PIPS, and an equity effect will show the change as a relative percentage.
• Essentially all the effects except for volatility will use the delta as the first order derivative, the gamma as second
order derivatives, while the vol effect will use Vega.
• Based on the effect shown, the way the market data and underlyings are represented in the view may be
different. This can be seen by looking at the left hand side of the right (detailed view) panel in the Greeks
Explain, as this shows how the view is constructed. The key differences in the construction of the view can be
seen in the credit and vol effects. Both the credit and vol views are aggregated at the top level by the tenor,
meaning that each tenor will be shown with its own separate box displaying the columns, so for instance if there
is a 6 month and 1 year tenor, there will be two separate boxes in the view that contain the same columns but
represent the Greeks P&L for that specific tenor. This is illustrated in the credit and vol effect screenshots below.
You can click the down arrow next to the Values field to select the columns to be displayed: start and end quotes,
start and end quote adjustments, Delta, P&L, Base P&L.
You can click the down arrow next to the Market Data Item field to filter the market data to be displayed.
An export functionality is available, allowing to export all the Greeks views with the same display as CWS.
Results Details
The P&L Explain by Greeks report leverages the risk framework to produce first and second order Greeks.
The columns of the P&L Greeks report are described below.
[NOTE: Risk Currency (Risk CCY) - Risk measure sensitivities are expressed in “market data currency.” This is
performed regardless of the product and based on the currency of the market data from which the underlying comes
from. For example, a EUR/USD cross-currency swap will show EUR curve risk in EUR and USD curve risk in USD]
Columns Description
Change Change in market data quote from the start of day to the end of day.
Change = (q2 - q1) / (qs - q0)
The following notations are used in the formulas:
• q0 – unshifted quote (usually q1)
• qs – shifted quote
• q1 – market quote before (Start)
• q2 – market quote after (End)
[NOTE: Due to the scaling of the shift, each market data quote’s calculated daily
“Change” is displayed in the relevant unit for all underlyings (e.g. Bps, Vol)]
Delta Change in NPV for a standard shift amount applied to underlying instrument quotes,
specific to the type of market data.
Delta (PL CCY) = Risk Value (shifted) – Risk Value (unshifted)
*Risk Value here is computed directly in PL Ccy
Delta (Risk CCY) = Risk Value (shifted) – Risk Value (unshifted)
*Risk Value here is computed directly in Risk Ccy
Columns Description
Vega Change in NPV for a standard shift amount applied to the underlying instrument quotes
of a Volatility Surface.
Vega (PL CCY) = Risk Value (volatility shifted) – Risk Value (volatility unshifted)
*Risk Value here is computed directly in PL Ccy
Vega (Risk CCY) = Risk Value (volatility shifted) – Risk Value (volatility unshifted)
*Risk Value here is computed directly in Risk Ccy
2. 5. 5 D ISPL A YIN G ER R OR S
The column "P&L Explain Error Count” indicates the number of errors if any.
Error messages can be displayed using the popup menu item “Show PLX Error Information”. Error messages are
displayed in the Errors Info panel.
44 Official P&L
Step 2 - Run the Official P&L report using these Official P&L parameters on the previous day as previously described:
saved report computed using the scheduled task EOD_OFFICIALPL.
[NOTE: For Intraday configurations, the pricing environment cannot be selected. The report uses the pricing
environment specified in the Calculation Server configuration]
Step 4 - Configure Official P&L parameters that use both P&L configurations.
[NOTE: The trade filter selected here can be a subset of the trade filter used to run the Official P&L report and
following the same restrictions: books and position spec only]
In the Incremental/Grid Configuration panel, you can set the Analysis Run Frequency (update frequency).
» You can click to refresh the results if you have the access permission OnDemandMktDataRefresh.
Sample results from the previous day - These are saved results from the "Official" report:
The Intraday P&L report computes the P&L measures previously described.
Additionally, the following P&L decomposition is available:
• Mark Adjustment P&L: This measure shows the impact of manual mark adjustments. It is the difference
between the sum of today’s marks and marks adjustments, and the sum of the marks of the previous day.
• Overnight P&L: This measure requires pricing the trades and positions by changing the valuation date to
today, and taking into account rolled and regenerated curves but not their reset; this is the “Overnight
Valuation”. Market data and trade/position version are taken as of the start date.
Overnight P&L is the difference between the “Overnight Valuation” and the marks of the previous day.
• Trading P&L: Only applies if the version number of the trades and positions has changed since the previous
day.
This measure requires pricing the trades and positions by changing the valuation date to today. This is the
“Trade Valuation”. Market data are taken as of the valuation date, and trade/position version is taken as of the
start date.
Trading P&L is the difference between the “Trade Valuation” and the “Current Valuation”.
• Market Data P&L: P&L - Overnight P&L – Trading P&L.
2. 7. 1 A R C H IVIN G A N D PU R GE PR OC ESS
The Archiving and Purge process is used to archive / purge marks and purge Greeks from P&L marks tables for a
given P&L Configuration.
You can use the scheduled task OFFICIALPLARCHIVEMARKS to archive marks and purge Greeks, and the Clean-up
Database window to purge and archive marks.
You can configure the scheduled tasks using Configuration > Scheduled Tasks (menu action
scheduling.ScheduledTaskListWindow), and add a task of type OFFICIALPLARCHIVEMARKS.
[NOTE: The trade filter must be the same the trade filter used for the scheduled task EOD_OFFICIALPL]
You can also use the Official P&L tab in the Clean-up Database window to archive / purge marks.
48 Official P&L
From the Calypso Navigator, navigate to Utilities > Maintenance > Monitoring > Clean-up > Clean-up Database to
bring up the Clean-up Database window.
Please refer to Calypso Utilities Menu documentation for details on the Clean-up Database window.
The Official P&L Analysis report displays all trades that fit the criteria defined. The columns are calculator measures
or trade attributes.
* There is no post processing measures computed in this report (CoF, Crystalization, etc.).
» You can add or remove columns as needed, and build your own template.
For verification, you can compare the results to that of the Official P&L report:
50 Official P&L
Or, you can compare the results to that of a single trade in the trade window:
» Enter a start and end date as needed, and click Load to load the scheduled task's runs.
» Select a run, and click View to view the computed Greeks as in the example below.
The table below describes the recommended settings for configuring specific risk types to match the P&L Explain by
Greeks results.
Risk Type Recommended Settings
Rate Curves Compute the risk for 1bp absolute shift of curve underlyings, separately, sequentially,
single-sided, without exploding the trades into sub trades (or legs), and with
generating dependents to include basis.
Rate Volatility Compute the risk for a 1 vol shift of each Rate volatility surface underlying. All will be
shifted separately, sequentially, single-sided, and without exploding into sub trades (or
legs). The full market data dependency tree should be regenerated after each
perturbation.
[NOTE: A shift of 1 vol means 1% absolute for lognormal vols, and 1bp for normal vols
FX Spot Compute the risk for 1 pip shift of FX spot quote, separately, single-sided, without
exploding the trades into sub trades (or legs), without exploding the triangulated pairs,
and without generating the whole market data dependency tree.
FX Curves Compute the risk for a 1 point absolute shift of FX Forward curve underlyings,
separately, sequentially, single-sided, without exploding the trades into sub trades (or
legs), and with generating dependents to include basis.
54 Official P&L
FX Volatility One of the following sensitivities will be run depending on the construction of the
volatility surface.
ATM
Compute the risk for a 1 vol shift of each FX volatility surface ATM underlying. All will be
shifted separately, sequentially, single-sided, while generating the whole market data
dependency tree, and without exploding into sub trades (or legs).
Equity Compute the risk for 1% relative shift of equity or equity index spot quote, separately,
single-sided, without exploding the trades into sub trades (or legs) and without
generating the whole market data dependency tree.
56 Official P&L
Equity Volatility Compute the risk for a 1 vol shift of each equity volatility surface underlying, separately,
sequentially, single-sided, while generating the whole market data dependency tree,
and without exploding into sub trades (or legs).
Credit Compute the risk for 1bp absolute shift of curve underlyings, separately, sequentially,
single-sided, without exploding the trades into sub trades (or legs), and without
generating the whole market data dependency tree.
Credit Volatility Compute the risk for a 1 vol shift of each credit volatility surface underlying, separately,
sequentially, single-sided, while generating the whole market data dependency tree,
and without exploding into sub trades (or legs).
Commodity Compute the risk for 1% relative shift of curve underlyings, separately, sequentially,
single-sided, without exploding the trades into sub trades (or legs), and without
generating the whole market data dependency tree.
58 Official P&L
Commodity Volatility Compute the risk for a 1 vol shift of each commodity volatility surface underlying,
separately, sequentially, single-sided, while generating the whole market data
dependency tree, and without exploding into sub trades (or legs).
Inflation Compute the risk for 1% relative shift of curve underlyings, separately, sequentially,
single-sided, without exploding the trades into sub trades (or legs), and without
generating the whole market data dependency tree.
Recovery Rate Compute the risk for 1% absolute shift of the recovery rate, separately, single-sided,
without exploding the trades into sub trades (or legs), and without generating the
whole market data dependency tree.
You can view the Sensitivity report using the Calypso Workstation to compare the results to the Official P&L Explain by
Greeks report.
[NOTE: There may be differences between the risk produced by Sensitivity and Official P&L Explain by Greeks. This is
because Greeks are computed using the P&L calculator, following a defined P&L methodology (so level can be
different also), and looks at the changes in the bucket Risk Value while Sensitivity looks at the differences in NPV]
60 Official P&L