Академический Документы
Профессиональный Документы
Культура Документы
Release 7.2
IJKLM
Copyright
Information in this document is subject to change without notice. Companies, names
and data used in examples herein are fictitious unless otherwise noted.
Disclaimer
The use of this document and the Prophet software to which it applies are subject to
the terms and conditions of the Prophet licence agreement. Deloitte & Touche LLP
will not accept any liability whatsoever in relation to the use of this document if a
licence agreement applying to the party using the document has not already taken
effect.
Trademarks
Trademarks that are known and mentioned in this manual have been appropriately
capitalised. However, Deloitte & Touche LLP cannot vouch for the accuracy of the
information. Use of such terms in this manual should not be regarded as affecting the
validity of any trademark.
B&W Deloitte
B&W Deloitte is a division of Deloitte & Touche LLP. Principal place of business at
which a list of partners’ names is available: Stonecutter Court, 1 Stonecutter Street,
London EC4A 4TR. United Kingdom
Prophet Team
B&W Deloitte
Horizon House
28 Upper High Street
Epsom
Surrey
KT17 4RS
United Kingdom
Contents
Introduction..................................................................................................1
About this tutorial .......................................................................................... 1
Introduction
Pre-requisites
Although you can start this tutorial straight away it is recommended that to get
the most from this tutorial you first spend some time reading Chapters 3 and 4
of the Prophet User's Guide.
6. Further topics
In this lesson you learn about a number of further features of Prophet such
as Regenerate and Auto-Scan.
L E S S O N 1
In this lesson you will start Prophet and use it to set up a Prophet product to
carry out the calculations for an insurance product.
A surrender value of half the premiums paid, accrued with 5% interest p.a., is
payable in the first two years. After that, the surrender value is equal to the net
premium reserve using 100% of the mortality table AM80 Ultimate for the
Conventional product and GKM80 for the International product and an interest
rate of 5%.
Expenses Initial expenses are currently 160 per policy. Renewal expenses are currently 24 per
policy per annum and are expected to grow in accordance with the Consumer Price
Index (assumed to be 4% per annum).
Commission The office pays an initial commission as a percentage of the first year's premiums,
according to the following table. This is paid in full on inception with “clawback” if
the policy lapses before 2 years premiums have been paid in the case of the
Conventional product and 1 year in the case of the International product.
Commission rates for intermediate numbers of years are obtained by interpolation.
Renewal commission of 3% of premiums is paid after the first year.
5 10
10 25
15 35
20 - 30 40
Details of the product 5
Taxation For the Conventional product you will assume that the office is a mutual. Hence,
taxation will be on an "investment income minus expenses" basis with tax rates
assumed to continue at current levels, that is 20% on franked investment income
and 25% on other income less expenses.
Reserving The net premium method is used for reserving purposes, using 100% of the
mortality table AM80 Ultimate for the Conventional product and GKM80 for the
International product, and an interest rate of 3%. A Zillmer adjustment is not used.
The product will include a solvency margin. You will use the European solvency
margin requirements, namely 4% of the reserves and 0.3% of the sum at risk.
Mortality The current mortality experience is 85% of the mortality table AM80 Select for the
Experience Conventional product and 85% of the mortality table GKM80 for the International
product. This is expected to continue.
Lapses At present, lapse rates are as set out in the following table and this experience is
expected to continue:
≤1 10
≤3 7.5
thereafter 3
Future The company expects to earn 7% gross on equities (made up of 3% income and 4%
Investment growth) and 5% gross on fixed interest government stocks (all made up of income).
Earnings The product is backed 75% by equity type investments and 25% by fixed interest
type investments. 15% of the equity type investments are assumed to be realised
each year, with reinvestment into similar investments.
Discount Rates Future profits will be discounted at three different rates of 6%, 8% and 10% to put a
value on the business.
Projection Data The product will be run using policy data as at 31 December 2002.
6 Lesson 1 Setting up a simple product
To start Prophet you should click the Start button and point to Programs. You
should then select the Prophet 7.2 program group and then click on the Prophet
option. The Prophet logo screen appears for a few seconds and you are then
normally presented with the following dialog, although it may appear differently
or not at all depending on how user permissions have been set up for your
installation of Prophet:
Enter your name in the space provided. The user name can contain between one
and 24 characters. It identifies you to other users running Prophet if they attempt
to open a workspace you are currently using. You may also need to enter a
password.
You can now type the desired location or browse to it. It is recommended that
you use C:\PROTUTOR. Also, do not choose the option to Install Example Model
Office.
Click OK and after a short delay the Product Design view window will appear.
8 Lesson 1 Setting up a simple product
Product Design view appears similar to the following except that the entries will
initially be blank:
Take a look at the top line of buttons in Product Design view. They allow you to
set up and maintain the files and tables that will be used by your products:
• Model Point File: This file contains all the policy specific information, for
example the age at entry of the policyholder.
• Global File: This file contains information which is the same for every
product in that run, for example the consumer price index inflation rate.
• Parameter File(s): These files are used for the product specific information,
which is the same for all the policies of a particular product, for example the
annual renewal expense per policy for each product.
Product Design view 9
• Unit Prices File: This file contains the prices of all the units to which
products may be linked.
• Tables: This allows you to access all the other types of tables that may hold
information for the product. These include mortality, year dependent
mortality, generic and year index tables.
• Library: A library contains the variables and formulas necessary to profit test,
model or value a wide range of products.
Arrows on the Product Design view show how the information in the tables and
the library feed into the product. You can think of this view as being an active
flow diagram of the inputs and outputs from a product.
• Run: The Run button allows you to run the product to calculate the results for
each of the model points in the model point file.
• Diagram: This provides a schematic way of displaying the definition for each
variable in the product, including the relationships between different variables.
This tool is especially useful for debugging purposes. You can also use this
type of view while you are specifying the variables for a product.
The final row of buttons allow you to look at the results produced in a run and
how they were obtained or where it went wrong.
At the bottom of the window there are two sections which allow you to specify the
information needed for a run:
The buttons down the right hand side provide the following options:
• Open: allows you to amend an existing product (you can also use the Product
button to do this).
• New: allows you to create an entirely new product, table or model point file.
• Copy: allows you to create a new product based on an existing one. This is
useful if you need to create a new product which only has a few differences to
one that has already been created, although it is often better to enhance the
existing product in these circumstances and then to use a Same As product
(Same As products are described in the next section).
• Grouping: allows you to specify model point groupings for the product. This
aspect is covered in Lessons 11 and 12 of the Model Office Tutorial.
The product Name has to be six letters long. The first letter in the product name
refers to the library which is being used and cannot be changed. If you are using
the Conventional library, the first letter of the product must be a C. For the
International library the first letter must be I. For the rest of the Name, type
_ENDT. That is, the name is either C_ENDT or I_ENDT.
For Description, enter Tutorial Product. This gives a description to help you
identify the product.
Library allows you to select the library to be used for the product. It will have
been automatically set as soon as you entered the first letter of the product name.
Same As allows you to specify that a product is the same as another product. In
this case Prophet would carry out exactly the same calculations as for that other
product, but it uses its own model point file, its own name when accessing
parameter file(s) and produces its own results. Hence you do not need to specify
the calculation rules separately. You should not select this option for the tutorial
product.
Level Number allows you to specify the order of processing of products and
accumulations. You should retain the default of 10.
Apply strong t-limiting allows you to optimise the calculated time periods in
dynamic runs. You should not select this option for the tutorial product.
Use a separate calculation array for each model point allows you to specify that
each variable for each model point has its own array in memory. This option is
not available for the tutorial product.
The dialog shown above is for the Conventional product but the one for the
International product is similar.
The indicators define the broad outline of the product and are used to determine
which variables are brought into the product. This can be best explained with a
simple example:
The indicators therefore specify the broad scope of the product and limit the
variables provided to you to only those required for the product.
14 Lesson 1 Setting up a simple product
• In the right hand list all the indicators currently selected for this product are
shown together with their description. For a new product these are the
indicators that are selected by default.
• The middle list contains the indicators not currently selected for the product.
By highlighting an indicator and clicking on > you can select an indicator and
move it to the selected list on the right.
• The outline on the left displays a categorisation of the indicators. If you click
on one of those, for example "H-Product Types", only those indicators
associated with this category will be displayed.
• Each indicator has a code which starts with a letter followed by a 2 digit
number. The letter specifies the indicator category to which the indicator
belongs. It is these categories which are listed in the outline. The number
orders the indicators within each category.
• You can drag the horizontal scroll bars across to display these codes. You can
also drag the divider which separates the outline on the left and the middle
pane of available indicators.
• The bottom panel displays the actuarial documentation for the indicator or
indicator category which is currently selected. This explains the purpose of
each indicator and the features that it will cause to be included in the product.
• If you click Wizard in the bottom left corner an Indicator Selection Wizard is
displayed which makes it easier for you to see the documentation for each
indicator and to select the indicators that you require.
Indicator Description
ALWAYS Used to bring in variables that are required in every product, for
example the age at entry and policy term variables.
PROJ Used to project both business that is already in force and new
business. It brings into the product variables which define, for
example, the expired duration and currently declared bonus (if
the product is with-profit). If this indicator is not selected, then
these variables are not included and only new business can be
projected.
Selecting the indicators 15
Indicator Description
Selecting an For the tutorial product you should also select the SOLV_MARGIN indicator. To
additional select this indicator, go down to it in the Available Indicators list and double click
indicator on it.
A more convenient way is to click "Q - Solvency Margin" in the outline. Now only
the indicators associated with this category are shown, which in this case will only
be the SOLV_MARGIN indicator. If you click Wizard the Indicator Selection
Wizard will be displayed. You will be able to see how there is one step for each of
the indicator categories. You can select or deselect an indicator using the
appropriate checkbox. This makes it much easier to select the indicators you are
interested in. Click Finish to return to the Select Indicators dialog.
16 Lesson 1 Setting up a simple product
If you click "All Indicators" then all the indicators that are selected for this
product will be displayed in the right hand list. For more information on all of the
indicators, you should refer to the relevant chapter of the Conventional or
International Manual or to the actuarial documentation in the bottom pane.
In order to produce this list of input variables Prophet has scanned the library
and brought into the product all the input variables with default definitions that
match the indicators selected. Input variables are those which need to be defined
for each product. At a later stage, “core” variables will be added to the product to
complete the specification of the calculations. Core variables are not displayed
because their definitions apply across all products.
To explain the concept of input variables more clearly, it is useful to look at the
definitions of the variable MAT_BEN_PP (maturity benefit per policy). You should
click on the Library button in the bottom right corner. When the list of variables
in the library is displayed you should type the letters MAT in quick succession to
select MAT_BEN_PP.
Note: If the variables are not in alphabetical order click on the Name column first
to re-order them
18 Lesson 1 Setting up a simple product
You should then click on Swap View so that you can see all the details for the
variable on the screen at the same time. You will see that there are two definitions
(four for the International library). The definition that is brought into a product
depends on the combination of indicators selected.
If you take a look at your screen, you will see in the middle pane some of the
variables that have been selected for this product. All of these need to be looked at
and accepted or changed. This is the part where the product really gets defined.
Specifying the input variables 19
To look at the default definition for a variable just click on it and the definition
appears in the bottom pane. You can drag the divider up if it is not fully visible.
You can go up and down the list and define variables in any order. However, for
a new product it is sensible to define them in variable code order which is the
order in which they always appear when you first open a product. You can re-
order them by clicking on any of the column headings. To change the definition
of a variable, either select it and click Open or double click on it.
In the following sections you will specify the input variables within each of the
categories.
General First click on Open for the variable AGE_AT_ENTRY (age at entry). You will then
variables be presented with the following screen:
20 Lesson 1 Setting up a simple product
The default definition for AGE_AT_ENTRY is Model Point. This means that
when the product is run, Prophet will read the value to be used for this variable
from the model point file that you will set up for this product. This file will
contain lines to represent different policies. Each line may represent an individual
policy or it may represent a number of policies that have been grouped together.
You should accept this definition and move to the next variable in the product by
clicking Next. As part of this process Prophet checks the definition for any syntax
or similar errors.
The next variable is SEX (sex). This also has a default definition of Model Point
and can be accepted.
Note: You will often get pairs of variables structured like ANN_PREM_PP and
ANNUAL_PREM. The variable ANNUAL_PREM is a normally given a model point
definition which specifies the current or original premium whereas ANN_PREM_PP
is given a formula definition which can be used to specify how the premium varies
over time.
Specifying the input variables 21
Select Model Point and click OK. Click Next to move on to the next variable.
You should accept the default definitions for SUM_ASSD_PP (sum assured per
policy) and SUM_ASSURED (sum assured).
Variable Description
The default definition of this variable should be accepted - it will not be used by
this product.
Benefits You can accept the default definitions of the next two variables:
Variable Description
The default definition for SURR_VAL_PP (surrender value per policy) needs to be
amended to allow a surrender value of half the premiums paid accrued with
interest to be paid in the first two years.
22 Lesson 1 Setting up a simple product
that is the surrender value at the end of month t is equal to the surrender value at
the end of month (t-1) plus half the premium paid in month t, accrued with
interest.
The variable t (time) runs in months from 0 immediately prior to the issue of the
policy up to the end of the policy term.
This formula introduces some of the syntax available for formulas as well as some
"best practice" guidelines when entering formulas using Prophet:
• Although excess spaces in the formula are ignored, for readability you should
indent the code below IF and ELSE lines by two spaces.
To amend the formula type the changes directly into the formula. However,
instead of typing SURR_VAL_PP in full, you can also type SUR and then press
F3. Prophet will list all the variables that begin with SUR. Click on
SURR_VAL_PP and then on OK to select it. Press OK to accept the amended
formula and return you to the list of input variables.
Prophet will not accept the definition if there are any errors in the syntax or if it
contains any invalid variable names. However, this formula includes a deliberate
mistake in the logic so that later in the tutorial you can see how Prophet handles
such errors. Can you spot it now?
Click on SURR_NETPREM (surrender net premium). You can see in the bottom
pane that it has a formula definition which references SURR_ZILLMER
(surrender zillmer). If you look at the list of variables, you will see that the list
does not include SURR_ZILLMER at the moment. However, if you now click
Open to open the variable SURR_NETPREM and click OK to accept its default
definition, you will see that the variable SURR_ZILLMER has been brought into
the list of variables. This approach whereby Prophet expands the list of variables
as you accept definitions is adopted because, if you had wanted to change the
definition of SURR_NETPREM so that it did not use SURR_ZILLMER, that
variable would have not then been brought into the product. Such variables are
called Secondary Input variables. This functionality keeps the number of input
variables to a minimum.
Specifying the input variables 23
The interest rate at which the surrender value is calculated is 5%, so for the
variable SURR_INT_PC (surrender interest rate) click Open, type 5, delete the 0
and click OK. It would be better to define SURR_INT_PC as a parameter
definition but this allows you to practice amending a constant definition in this
tutorial.
Select the default definitions for the following variables by opening the first one
and then clicking on Next three times:
Variable Description
Reserving and The next variable is NET_PREMIUM (valuation annual net premium). Click Next to
solvency accept it.
The next variable is VAL_INT_PC. This is the interest rate at which the valuation
reserves are calculated. Accept the default definition of parameter by clicking
Next, since this will allow a number of products to be run using different interest
rates.
Variable Description
Interest rates The next five variables represent the components of the investment return.
Variable Description
The actual values that should be entered will be discussed in Lesson 2 when you
set up the model point files and tables. The values of these variables (which are
essentially interest rates) may change between groups of products. For instance,
non-profit and with-profit products will usually be backed by different mixes of
assets. You will amend these variables to refer to other variables which will read
the appropriate values from the global file.
One way to do this would be to open each variable, click Change Type and then
select Formula, enter the required variable name and click OK as with
SURR_VAL_PP. However, this is not necessary since the required formulas have
already been set up as "alternative definitions". Alternative definitions are
alternatives to the default definitions and have been set up in the libraries for a
number of variables where commonly used alternatives exist.
The following dialog is displayed for the Conventional product (a similar dialog is
displayed for the International product):
Specifying the input variables 25
You will then see a formula which refers to the variable NP_FII_PC (non-profit
franked income rate). Click OK to accept this.
NP_FII_PC is now the next variable in the list. It has a global definition by default,
which is what you require.
Repeat the process you have carried out for FII_PC for the other four
components of investment return, always selecting the "NON PROFIT" alternative
definition.
The next variable, DISC_A_PC, is the discount rate which is applied to the stream
of emerging profits. Accept the default definition of global by clicking Next. This
allows it to be given the same value for all of the products in your model office.
There are two more discount rates, DISC_B_PC and DISC_C_PC. You should
accept the default definition of global for each of these variables.
The variable SOLV_INT_PC is the interest rate on the solvency margin and
should be changed to a global definition.
Tax For the Conventional business product, you should also accept the global definitions
of each of the following variables:
Variable Description
For the Conventional business product, you should accept the default definitions
for:
Variable Description
For the International business product OTAX_PROF_PC is the tax rate applied to
profits. You should accept the default global definition.
Commission The first commission variable is IC_PAYBL_PP (initial commission payable per
policy). For the Conventional business product, you can accept the default
definition.
For the International business product, you need to amend the default definition
as it currently spreads initial commission payments over the first year, depending
on the frequency of premium payments. One way to do this would be to open the
variable and change the formula to make the commission payable on inception,
but it is quicker to make use of an "alternative definition" again. Click on Select
as you did before. Select the line beginning with "INDEMNITY COMMISSION
PAID MTH1" and click OK. You will see that this is a formula paying all initial
commission in the first month. Click OK to accept this.
You are now going to use the variable IC_RATE_PC to define the initial
commission rate. The following formula defines the percentage of annual
premium that is paid as initial commission:
IF POL_TERM_Y <= 10 THEN
3 * POL_TERM_Y - 5
ELSE IF POL_TERM_Y <= 15 THEN
2 * POL_TERM_Y + 5
ELSE IF POL_TERM_Y <= 20 THEN
POL_TERM_Y + 20
ELSE
40
To enter this formula, open the variable IC_RATE_PC, click Change Type, select
Formula and type the formula in. Note that you can use Cut, Copy and Paste in
the same way as in other Windows applications. Now click OK to accept the
formula. You should note that if there was anything wrong with the syntax of the
formula, Prophet would not accept it but would instead indicate an error and its
likely position.
Specifying the input variables 27
You have chosen this approach of using a formula to define initial commission
rates to demonstrate what can be done. A formula is only feasible if there is a
pattern in the values. In Lesson 5 you will see how these values can be entered in
a table to be read by the product.
International library users should use the alternative definition for IC_EARNL_PP
(initial commission earned on lapses per policy). To do this, choose Select, click
on the line beginning with "EARNED UNIFORMLY OVER N MONTHS" and click
Next.
Conventional library users can accept the default definition for IC_EARNL_PP.
Variable Description
IC_EARNL_PC The initial commission earnings rate for lapses. Only applies
to the International product.
IC_EARN_M The initial commission earnings period in months. Only
applies to the International product
IC_EARND_PP The initial commission earned on death per policy
IC_RECOV_PC The percentage of initial commission recovered on clawback
RC_PAYBL_PP The renewal commission payable per policy
Expenses The next variable in the list is INIT_EXP_PP, the initial expense per policy. You will
see that this is made up of three components: a fixed per policy expense, a
percentage of the sum assured and a percentage of the annual premium.
To model this product you are just using a fixed per policy expense. You should
accept the formula for INIT_EXP_PP using Next, and you will then be presented
with IE_FIXED (fixed initial expenses). Change the definition of this to a
parameter type. The defaults for the percentage of sum assured expenses and the
percentage of annual premium expenses are both 0, so accept these for IE_SA_PC
and IE_PREM_PC.
28 Lesson 1 Setting up a simple product
You should note that you could have deleted the two lines which refer to these
last two variables from the formula for INIT_EXP_PP in which case you would
not have had to define them as zero. This is a valid approach but it would make
the product less flexible if, in future, you want to allow for expenses as a
percentage of sum assured or annual premium.
You will see that the Conventional library formula for REN_EXP_PP (renewal
expenses per policy) is:
IF t >= RE_START_M AND t <= POL_TERM_M THEN
RE_FIXED_Y/12 * RE_INFL_ADJ(t-1)
ELSE
0
By looking at these formulas for REN_EXP_PP you will be able to see that the
variable RE_START_M is the month in which renewal expenses are first assumed
to be incurred. This will normally depend on how expenses are analysed in the
office. The formula is indicating that renewal expenses are incurred in each
month during the policy term in and after this "start month". Their amount
increases with inflation from the start of the projection period.
You should accept the default value of 2 for the variable RE_START_M, define
RE_FIXED_Y (fixed annual renewal expenses before inflation) as a parameter.
Accept the default definition of RE_INFLAT_PC (annual renewal expenses
inflation rate).
You should accept the default definitions for CPI_GTH_PC (Consumer Price
Index inflation rate) and RE_RESERV_PC (renewal expense as percentage of
reserve).
Specifying the input variables 29
Mortality The next variable is Q_EXP_PN which is the mortality used for the experience basis.
You are going to use the mortality table AM80 Select for the Conventional product
or GKM80 for the International product. Click Browse and then select the MORT
sub-folder in your Prophet system location. For example,
C:\Program Files\PROPH_72\MORT. This sub-folder contains all the standard
mortality tables supplied with Prophet. The following dialog will be displayed:
Go to "AM80" or "GKM80" as appropriate and click Open. Now you can accept
the definition.
Note that GKM80 is an ultimate table, but the Select/Ultimate setting can be left
unchanged as Prophet will ignore this setting for an ultimate table.
The next variable is Q_SURR_PN, the surrender mortality rate. You are going to
use the mortality table AM80 Ultimate for the Conventional product or GKM80
for the International product. Amend the default in the same way that you
changed Q_EXP_PN. Note that you can type in the name of the table directly, if
you know the filename.
You should accept the default definition for PROP_SURQ_PC, the percentage of
surrender mortality rates.
30 Lesson 1 Setting up a simple product
The default definition for the variable Q_VAL_PN (valuation mortality rates) also
needs to be changed to AM80 Ultimate for the Conventional product or GKM80
for the International product.
Decrements The next variable is ANN_LAPSE_PC, which is the percentage of policies that lapse
or surrender each year. You will notice from the formula as it stands that you are
allowed to enter different lapse rates in the first year; the second year; and then after
the second year. You want to amend the formula so that there are different lapse
rates in the first year; the second and third years; and after the third year. To do
this, go to the following line:
ELSE IF t <= 24 THEN
If you change the 24 to 36, then the line YR2_LAPSE_PC * YR2_LAPSE_SY will
apply during the second and the third years. Click Next when you have made this
change.
The following nine variables should have their default definitions accepted:
Variable Description
Initial values The next variable, DURATIONIF_M (duration in force in months) should have its
default definition accepted.
Saving the Click OK and the list of input variables you have defined will be displayed. Click
product Save to save all the variables and definitions for the product. You might get a
warning like this:
This means you did not accept all the variables. Do not click OK because the
default definitions will then be used for all these variables. Instead click Cancel to
return to the list of input variables. You can then locate the variables which still
have a status of "Not Defined" by clicking on the Status column header so that they
all appear at the end of the list of input variables.
The following dialog then asks you if you want to delete the existing results files
for your product:
You can leave this unchanged since this is a new product without any existing
results files. Click OK to save the product.
You are now back in Product Design view. You should use the drop down list box
below the Product button to select the product that you have just created.
32 Lesson 1 Setting up a simple product
Printing the Click the printer toolbar icon or select the Print option in the File menu. The
product Print Product Design dialog will be displayed as follows:
This dialog can be used to print virtually any aspect of the product. At this stage
you should just select the Indicators and Input Variables options and then click
OK. Compare your output with the appropriate version provided at the end of
this tutorial.
33
L E S S O N 2
In this lesson you are going to set up model point, parameter and global files for
the product you specified in the previous lesson.
• Setting up a structure 35
Introduction
Model point files contain the policy data that is used as a starting point for
Prophet's calculations. Each model point can represent an individual policy or a
group of policies. In the latter case each model point contains values that overall
represent a tranche of business. Model point files are normally set up using either
the Table Editor in Prophet or the Data Conversion System.
Parameter files contain values for all variables where the same value applies across
all the model points of each product, but for which different values can apply to
different products. A good example would be lapse rates, where different types of
product may have different lapse profiles.
Global files contain values for variables where the same value applies across all
products and model points in your model office. A typical example would be the
risk discount rate, which you would want to keep the same over the whole
company.
For more information about tables refer to Chapter 6 of the User's Guide.
Setting up a structure
Creating a Before you set up any tables you should create a structure. You do this by clicking
structure on New in the Structure section at the bottom left of the Product Design view:
The Products list contains the products which are to be included in the structure.
To add ptoducts to a structure you click Select Products above the Products list.
The Select Products dialog is displayed:
On the left a list of all the products which can be selected is displayed. The list on
the right will show which products you select for this structure. Select C_ENDT
and double click or use to select it.
To add the product to the Products List of the Structure click OK.
In addition, options on the Configuration tab can be left at their default settings
and so can be ignored at this stage.
Saving the Click OK in the Structure dialog to save it. You should now be back in Product Design
structure view. You should then select the structure you have just created in the drop down list
box in the Structure section.
Setting up the model point file 37
In the Table Name text box, using the default table location, enter the name of the
model point file as C_ENDT.RPT if you are using the Conventional library.
Alternatively, if you are using the International library, enter the model point file
name as I_ENDT.RPT.
For the Conventional product the New Table will then appear as follows:
After entering the name of the model point file do not click OK but instead, to
fill the columns with the names of the variables from a product click
Initialise. For the Conventional product the dialog appears as follows:
38 Lesson 2 Setting up model point files and tables
Click OK to open the Table Editor containing the empty model point file. All the
variables you defined as model points in your product are listed across the top as
you can see in the following screen:
Enter a suitable description in the Description field (for example Tutorial Model
Point File) and click OK.
Setting up the model point file 39
Sub-product The first column in the table is headed SPCODE. This is the sub-product code and
codes is used by Prophet when it accumulates the results. Prophet will automatically sum
the results for all of the model points with the same SPCODE. This could be used
for example to make a distinction between the different ways your business is
obtained, for example through direct writing and brokers. For model office work
you will normally set SPCODE to a number between 1 and 50 for in-force business,
and to a number between 51 and 9999 for new business. The model points must be
entered in ascending order of SPCODE in the model point file.
You are just going to run one model point through the product in this part of the
tutorial, and as it will be an in-force policy, enter 1 as the SPCODE for your
model point.
Values The values of some variables have fixed ranges. For example, the variable SEX can
only take the value of 0 (for male) or 1 (for female). In such cases you can choose
whether to display the values or their descriptions.
Note that the descriptions are specified for a variable using the Variable
Constraint feature. This feature allows you to specify a description for each value
that the variable can have. For more information see Variable Constraints in the
Prophet User's Guide or in Help.
Variable Description
AGE_AT_ENTRY This is the policyholder's age at the start of the policy. Set it
equal to 30.
SEX A value of 0 corresponds to a male life and a value of 1 to a
female life. Enter 0 here.
POL_TERM_Y This is the policy term in years. It should be set equal to 10.
ANNUAL_PREM This is the annualised premium payable. It should be set equal
to 840.
PREM_PAYBL_M This should be set equal to the policy term multiplied by 12 so
enter 120.
This is not really the recommended way, it is better to define it
as a formula in the product instead of a model point.
40 Lesson 2 Setting up model point files and tables
Variable Description
Note that when the cursor is in a column headed by a variable name, the
description of that variable is displayed in the bottom left of the screen.
Saving the file Click on Save. Click OK to accept the file name and location.
Printing the file You should also print the table out by clicking or using the Print option in the
File menu. Compare your output with the appropriate version provided at the end
of this tutorial.
The example used in this tutorial does not really emphasise the advantages of
using parameter files because you currently have only one product. In practice
you would normally have more than one product and so parameter files would be
used for variables whose values change across products.
Creating the To create the new parameter file you would normally click on the Parameter File(s)
parameter file button. However, to demonstrate a slightly different approach you should click New
in the Table section instead. The following dialog then appears:
You will then be presented with the following dialog which allows you to select
one or more products so that the file can be set up with the names of the variables
with a parameter definition in those products:
Values You will be presented with an empty parameter file with all the variables you defined
as parameters in your product across the top. You can now enter the values for these
variables.
Variable Description
IE_FIXED This is the fixed initial expenses and should be set equal to
160.
PROP_EXPQ_PC This is the percentage of the mortality table used for the
experience that you wish to use. It should be set equal to 85.
PROP_VALQ_PC This is the percentage of the valuation mortality table that you
wish to use. It should be set equal to 100.
RC_RATE_PC This is the renewal commission rate and should be set equal
to 3.
RE_FIXED_Y This is the current rate of fixed renewal expenses and should
be set equal to 24.
VAL_INT_PC This is the valuation interest rate used for calculating the
mathematical reserves. This should be set equal to 3.
YR1_LAPSE_PC This is the lapse rate assumed to apply for the first policy
year. It should be set equal to 10.
YR2_LAPSE_PC This is the lapse rate for the second and third policy years and
should be set equal to 7.5.
YR3_LAPSE_PC This is the lapse rate for the remaining duration of the policy
and should be set equal to 3.
Saving the file Click Properties and enter the description Tutorial Parameter File. Then click OK
followed by Save and the following dialog will be displayed:
Printing the You should also print the table out by clicking or using the Print option in the
file File menu. Compare your output with the appropriate version provided at the end of
this tutorial.
Properties Click the Global File button in Product Design view to set up a new global file. The
Properties dialog will then be displayed:
Enter a description such as Tutorial Global File and type 1 in the Run Numbers
box and click OK.
To include the variables with global definitions for your product, click Add in the
Variables section. Then select your product and click OK.
Setting up a global file 45
Table Conventional library users will be presented with the following screen (for the
worksheet International business product there will only be one tax variable in the first
column):
You will notice that the table contains one column headed RUN_01.
Values You can now enter the following values for the variables:
Variable Description
CPI_GTH_PC This is the annual Consumer Price Index inflation rate and
should be set equal to 4.
DISC_A_PC This is the discount rate that is applied to the stream of
emerging profits. It should be set equal to 8.
DISC_B_PC This is the discount rate that is applied to the stream of
emerging profits. It should be set equal to 6.
DISC_C_PC This is the discount rate that is applied to the stream of
emerging profits. It should be set equal to 10.
NP_FII_PC This is the annual percentage rate of franked investment
income earned on the investments. As explained in Lesson 1
this contract is 75% backed with equities which provide
franked investment income. These yield an average of 3%, so
2.25 (that is 0.75 * 3) should be entered here.
NP_RCGCHG_PC This is the annual percentage rate of realised chargeable gains
and 0 should be entered here. This is because the average
growth rate of equities (4%) is the same as the inflation rate
(4%) so it is reasonable to assume that all realised gains will
be relieved against indexation allowances.
NP_RCGUNC_PC This is the annual percentage rate of realised unchargeable
gains. As you are assuming that 15% of equities are realised
each year, 0.45 (that is 0.75 * 4 * 0.15) should be entered
here.
NP_UFII_PC This is the annual percentage rate of unfranked investment
income earned on the investments. This contract is 25%
backed with fixed interest government stocks which provide
unfranked investment income. On average these earn 5%, so
1.25 (that is 0.25 * 5) should be entered here.
NP_UNRCG_PC This is the annual percentage rate of unrealised gains. 2.55
(that is 0.75 * 4 * 0.85) should be entered here.
You should note that the sum of the above five components of investment return
equals 6.5%. This is equal to (0.75 * 7 + 0.25 * 5), the overall return specified in
Lesson 1.
Setting up a global file 47
For the Conventional library product, the following tax values need to be entered:
Variable Description
For the International library product only one tax value needs to be entered:
Variable Description
Variable Description
Saving the file Click Save to save the table. Accept the default location and change the name to
GLOBAL.FAC.
Print the table out by clicking or using the Print option in the File menu.
Compare your output with the appropriate version provided at the end of this
tutorial.
Making Further columns and rows can be added to your tables, as required. It is also possible
changes to make use of the Table Editor formulas to add or copy data, rather than entering
individual values. For more details, refer to the "Setting up tables" chapter in the User's
Guide.
48 Lesson 2 Setting up model point files and tables
49
L E S S O N 3
Now that you have created a product, its related model point, parameter and global
files and a structure in the previous two lessons, you are ready to:
• Set up a run
Click New in the Run Setting section. Select the "Calculation Run" option and
then click OK to display the following dialog:
Enter a name of Tutorial Run Setting in the Name field at the top of the dialog.
Then complete each of the items in the tabs as described in the following sections.
Setting up a run setting 51
The Start Date is used to specify the start date of the model office projection.
The projection for the current run is to be based at 31 December 2002 so the
date should be changed to 31 December 2002.
The Future Accumulation Period is the number of years of projected results that
will be included in the results files produced by Prophet. The actual calculations
are always made from the start of the policy until at least the end of the policy
term, to ensure that items such as the discounted value of future profits are
properly calculated.
You are projecting in-force policies with a ten year policy term and wish to be
able to view the results of all the calculations, so enter 10. If you were also
projecting new business policies, you would enter 11, rather than 10, because for
a 10 year policy, the maturity proceeds are paid out in the 1st month of the 11th
year. Thus, if the policy was issued in June 2002, the proceeds are paid out in
June 2012.
The Past Accumulation Period is the number of years of results prior to the start
date of the projection that will be included in the results files produced by
Prophet. It primarily enables you to produce output for checking historic asset
share calculations. Leave the default value of 0 for the Past Accumulation Period
unchanged.
The other sections in this tab are not needed in the run, so you can leave them as
they are. They are covered in the Model Office Tutorial.
52 Lesson 3 Setting up, running and reporting on a product
Advanced options
Additional options are available when you click Advanced in the Advanced area of
the Run Parameters tab. The Advanced Settings dialog is displayed similar to the
following:
For the tutorial accept the default settings. Click Cancel to return to the Run
Parameters tab.
Setting up a run setting 53
Tables tab
Click on the Tables tab of the Run Setting. The Tables tab appears similar to the
following:
• The location in which the model point files for the structure are held and their
file extension.
• The locations and names of the global, parameter and prices files.
• The location and name of the sales file which contains assumptions about
future new business volumes.
Unless you specify the complete location including the drive letter, any location you
enter is taken relative to the workspace location.
The default location for the model point files is MPFILES, which means that, if you
have installed the tutorial on the C: drive and in the location PROTUTOR, then the
model point files will be read from C:\PROTUTOR\MPFILES. The default location
for all the other files is the TABLES location and is handled similarly.
The tutorial will use the default locations and names. As you will not be using a unit
prices file or a sales file you should ensure that these entries are blank.
54 Lesson 3 Setting up, running and reporting on a product
Results tab
This tab enables you to specify what kind of output is to be generated in the run and
the format(s) in which it is to be produced. It appears as follows:
Results Files These options allow you to choose the type of results files that will be produced in
Prophet's own results file format:
Item Description
Projection / NB Profile These results contain projected results for each month
of the future and past accumulation periods.
Valuation These results contain the values calculated at the start
of the projection period split by maturity year or
current age.
Accumulation Results This option produces and retains the results generated
by accumulations.
Intermediate Dynamic This option produces and retains the intermediate
results generated in dynamic runs.
Product Total Options in this area allow you to specify which Product Total Results files can be
Results Files suppressed. This can improve run times and reduce unnecessary disk space as
(00) unwanted results files are not created.
Accept the default setting to create results files for both sub-product codes and
product totals.
Variables in This option allows you to choose the variables to be retained in the results. Variables
Results Files which are defined as or evaluate to constant values are always included in the results
files. This includes all variables defined using either global or parameter definitions.
In addition, the values for the first model point of each sub-product code are
included for all variables defined as model point. You can choose one of the
following options:
Item Description
Select All so that you can inspect the values of all the variables in your product.
Text Results These are basically the same as Results Files, except that the results are in a text format
Files instead of in Prophet's own results format. These results can be used in other
applications.
Individual This option allows you to specify whether output files are to be generated which
Model Point contain a line of results for each model point. If selected, individual model point
Results Files results will be produced in Prophet’s model point file format.
56 Lesson 3 Setting up, running and reporting on a product
These files will contain the values at the projection start date (that is at t =
DUR_M) for each of the variables which have their Individual MP Output
property checked (see the "Variable Properties" section in the "Libraries" chapter
of the User's Guide for information about the properties of variables).
Error Control This option allows you to specify the maximum number of errors allowed before
Prophet terminates the calculations for a particular product and the maximum
number of warnings before termination of an accumulation. The default is zero
which means that the calculations for a product will be terminated if or when the
first error occurs. If you enter 10, a product will only be terminated when the 11th
error occurs. If you select the No Limit options, Prophet will continue the
calculations irrespective of the number of errors that occur.
The model point file you are using for this product contains only one model point
so you will only want results if no errors occur. Accept the default entries of zero
for both fields.
Stochastic Options in this area relate to stochastic runs and are only available if Stochastic is
selected in the Run Setting. In this tutorial the product is not being run either
dynamically or stochastically so the Dynamic and Stochastic options are not
selected.
Setting up a run setting 57
Saving the run Click on OK to save the run setting. Then select the run setting you have just
setting created in the Run Setting drop down box.
58 Lesson 3 Setting up, running and reporting on a product
Prophet first carries out various checks such as ensuring that all the model point
files exist for the products included in the run and that the global and parameter
files specified in the structure exist. If not a warning will be produced.
• It recognises that you are running a new product and carries out the variable
sequencing, code generation and compiling processes needed to generate an
executable program.
• Prophet carries out the calculations for the model points and creates a file of
the sub-product results for the required variables over the specified period of
accumulation.
• The run messages which appear on the screen to show how the run is
progressing are also written to a run log file.
However, in this case, Prophet will fail to complete step 2 because of the error you
introduced (deliberately) when setting up the product. The following dialog is
displayed:
Identifying why a run has failed 59
The run log first lists the structure and run setting details followed by the dates
and times of the products and accumulations in the run. This is followed by the
details of the product generation and execution. In this case it can be seen that an
error has been detected in the variable SURR_VAL_PP at time period 0. The error
message reads:
ERROR PCR002 Time Index Error - Attempt to read outside of results
array
This is an indication that an invalid time period has been referred to.
To look at and correct the variable in question, use the Select button in the
bottom left corner to go to the Workspace Window. When the Product Design
view is displayed click on Product. The product variables window will then be
displayed. Go to SURR_VAL_PP.
60 Lesson 3 Setting up, running and reporting on a product
Taking a look at SURR_VAL_PP, you can see that the first part of the formula
refers to itself at time (t-1). It is a "recursive" formula which is necessarily
evaluated by starting at t = 0 and moving forward one month at a time. However,
at time period 0 (when the error occurred) this formula will reference the value at
t = -1. As t can only take positive values, this term has caused the error. This can
be rectified by opening the variable and replacing the first line with:
IF t = 0 THEN
0
ELSE IF t <= 23 THEN
Click OK and then save your product. The product can now be re-run by clicking
on Run.
Look at the run log again after the run is complete by selecting it using the Select
button and then clicking the toolbar button to update it. You should now see
that the product has been run successfully. Then close the run log window by
clicking on Close.
Viewing results produced in a run 61
• Run Number should be 1, because this is the only run number you have run
so far.
• Results Type can be used to choose which type of results you want to view:
Projection
New Business Profile
Valuation - Maturity Year
Valuation - Current Age
Unit Numbers
At the top left you see the Run Number, the Sub-Product and Type that you
selected together with the name of your product. If you want to change one of
these selections, you just use the appropriate drop down list and make a selection.
The results on the screen will change straight away.
Variable In the Variable Group section there are Category and Name options. Using the drop
Groups down list next to Category you will see a number of variable group categories and
three additional options. The three additional options allow you to select All
Variables, Cumulative Variables or Key Output Variables.
Viewing results produced in a run 63
Each variable group category contains a number of variable groups which allow
you to report on a particular aspect of the results. The standard workspace
includes a number of variable groups which are listed in the Name drop down list.
If you select a variable group category the drop down list next to Name is opened
so you can select the required one.
If you want to create a new variable group or to change an existing one, you can
do this by selecting the Variable Groups option in the Workspace menu.
Conventional library users should select the A10 - Revenue Account / Profit Test
variable group and International library users should select
A11 - International Rev Acct / Profit Test.
Time Periods To specify the Time Periods for which the results are displayed, click on the Time
Periods button. The following dialog will then be displayed:
Start Position allows you to display the results from the start of the results or
from a specified start year.
64 Lesson 3 Setting up, running and reporting on a product
Format allows you to display the results in Company Year or Policy Year format:
• Company Year displays the time periods in the form Dec 2002, 4Q2002,
2H2002, 2002 and 2002-2006. It is more appropriate when you are using
Prophet for model office work.
• Policy Year displays the time periods in the form M12, Q4, H2, Y1, Y1-Y5. It
is more appropriate for product development work.
You can choose to display your results Monthly, Quarterly, Half-Yearly, Annually
and/or 5-Yearly for a specified number of years. If for example you choose 2 for
monthly, then monthly values will be displayed for 2 years. You can also choose
to display a summary of the results for each year by checking the Show Annual
Summary box.
Item Do this
Results The remaining body of the results window displays the results. It is divided into
three tabbed sections:
• Audit information
You can change the format for the display of the results using the options in the
Format menu.
You can also choose to display either the variables or the time periods as the
columns. To switch between them click on the Swap button in the corner of the
grid of values. For the tutorial, set the display so that the variables are in columns
and the time periods are in rows.
Viewing results produced in a run 65
Copying If you want to copy results, for example to Microsoft Excel or Word, you can use
Results Copy in the Edit menu to copy a selected range of cells or Copy Grid in the Edit
menu to copy the entire grid of values including the top and left borders to the
Windows clipboard.
Printing To print the results choose Print in the File menu. The following dialog is displayed:
results
Select the "Grid Values", "Constant Values" and "Audit Information" options and
then click OK to print the results. Check and compare the printed results with
those at the end of the tutorial.
L E S S O N 4
This lesson describes the main approach that you should adopt to check the
calculations and, if required, to modify them.
Introduction
Diagram view allows you to view all the variables and formulas in a product, the
dependencies between the variables and their values.
• See how some of the changes you need to make to the product should be
implemented.
The main Diagram view window 69
• Variable dependencies
• Variable definition
• Results values
You can adjust the size of any pane by dragging its borders. You can also expand
the panes to the whole width of the screen by clicking on the small black arrow to
Variable dependencies
The centre pane of the top section shows the direct relationships between the
current variable (MATH_RES_IF) and other variables in the product. Clicking on
any variable in this pane will make that variable the current one. The current
variable is also displayed in the second drop-down menu in the toolbar at the top
of the screen.
You can make any variable in the product the current one by selecting it in the
Variable drop-down menu. If you type in the first few letters of its name in quick
succession, the first variable starting with those letters will be highlighted.
The left hand pane of the top section enables a tree view to be displayed of the
variables on which the current variable depends. Any variable with a plus sign
next to it may be clicked to expand the tree.
The right hand pane of the top section enables a tree view to be displayed of the
variables that depend on the current variable. Any variable with a plus sign next to
it may be clicked to expand the tree.
Variable definition
The middle section displays the name, description, type, variable code and
definition of the current variable. For non time-dependent variables the value is
also displayed in this section. In the case of model point variables and other non
time-dependent variables that have values that vary from model point to model
point the value for the first model point of the current sub-product is displayed.
If you move the mouse pointer over any variable in the top section, Diagram view
will display information about that variable instead of the current one.
Results values
The three panes in the bottom section show the values of time-dependent
variables in your product. The centre pane shows the values of the current
variable. The left pane shows the values of the variables on which the current
variable depends. The right pane shows the values of the variables that depend on
the current variable.
The main Diagram view window 71
Options
There are a number of options in Diagram view which enable you to change the
way in which the information is displayed:
• If you select Font, Number or Time Periods in the Format menu you are able
to change the font, number format and time periods used to display the
results.
• If you select Suppress Zeros in the Format menu you are able to suppress
variables which have zero values.
• If you select Options in the Tools menu and then the Diagram tab you can
specify which types of variables are highlighted and in which colours. You can
also specify whether the three results panes should be synchronised or
whether you can scroll each one independently.
• You can move backwards and forwards through a history of the variables that
you have selected as the current variable using the and toolbar buttons.
• You can change the product and the results which are displayed using the
drop down list boxes at the top of the window.
• You can print out the Diagram view screen using the Print toolbar button or
the Print option in the File menu.
• You can click on the Chart Window button to diplay the results graphically.
Note: You should now spend some time moving through the variables in the
product you have created, exploring the dependencies between them, and using
some of the options available to you.
72 Lesson 4 Reporting on dependencies in Diagram view
• Valuation Interest Rate - you will amend the product to use different
valuation interest rates depending on the valuation series to which each model
point belongs.
• Mortality Experience - you will use the variable SEX to assign different
mortality rates to males and females.
Diagram view can help you clarify exactly which variables should be changed to
make these two enhancements.
Mortality experience
Referring to the product listing you produced earlier, you will see the input
variables for mortality in the section headed K-Mortality. You wish to change the
experience mortality to depend on sex. From the product listing, you can see that
the variable to be changed is Q_EXP_PN. Make Q_EXP_PN the current variable.
The dependencies of Q_EXP_PN are now displayed and you can see that the
mortality rates on the experience basis are only used in the variable Q_EXP. This
means that amending Q_EXP_PN will have no wider, unintended effects.
Using Diagram view to identify how to change the product 73
There are already variables set up in the library to distinguish between male and
female mortality experience. These are:
Q_EXP_MALE KA11
Q_EXP_FEMALE KA12
The best way to make the change is to define Q_EXP_PN as a formula which
picks out the correct mortality table dependent on the policyholder's sex using
these two variables. This will be done in the next lesson.
L E S S O N 5
This lesson explains how you can extend the calculations in Prophet to meet your
particular requirements by implementing the changes outlined in the previous
lesson.
Option Description
Open Displays a list of the existing definitions for the selected variable.
New Allows you to create a new variable.
Delete Allows you to delete the selected variable.
Copy Allows you to create a new variable based on the selected variable.
Properties Allows you to look at and change the properties of the selected
variable.
Enter the name as VALN_SERIES. Then enter the description as Valuation Series.
Leave the Type as Number.
The other items in the Variables Properties dialog are described in the following
sections.
• Balance Sheet means the annual values for this variable will be the values in
the last month of the year (for example Mathematical Reserve In Force).
Constraints
You can specify the values that a variable can have by setting up a constraint
condition in the Constraints section of the Variable Properties dialog. The
constraint that you specify is then used to validate the values that you enter for
the variable in the Table Editor.
The constraints that can be specified for the variable can be one of the following:
Leave this entry blank as we will not be applying any contsraints to the variable.
Also, as the remaining workspace level properties are beyond the scope of this
tutorial you should not select any of them.
• Input variables are used to define the specific calculations you want to make
for each of your products. When you specify a new product, Prophet presents
you with a list of input variables to be defined, based on the indicators you
select.
• Core variables contain the calculations which do not vary by product. Prophet
automatically includes the appropriate core variables with their appropriate
definition, based on the indicators you select for that product.
Adding a new variable to the library 79
Variable Code is a four character code which controls the order in which the
input variables are presented to you when setting up a product. It consists of two
letters followed by two digits. Any number of variables can be given the same
variable code but it is better to give them different codes so that they appear in the
order you want. The natural place for VALN_SERIES to appear would be just
after VAL_INT_PC (the valuation interest rate). If you click Browse and search
through the variables you will see that the variable code for VAL_INT_PC is FA10.
Thus you should give VALN_SERIES a variable code of FA11. This can be done
by double clicking on VAL_INT_PC. You will then be returned to the Variable
Properties dialog where you see that FA11 has been entered for the variable code.
Below the variable code you will also see the descriptions for the F and FA
variable categories.
Variable definitions
You should now click OK to go to the variable definitions window where you can
create and amend the definitions for the variable. For an existing variable you can
choose one of the definitions that already exist for the variable and change it or
create a new one. In this case the list is empty since you have just created a new
variable. Click New so that you can create a definition for this new variable.
First you have to select the type of definition you want to create. This is done in
the following dialog:
This screen looks similar to the variable screen you saw when specifying the
product 18. The difference is the bottom part of the screen headed Indicator
Expression. Here you can specify the indicator or the specific combination of
indicators that would bring this variable into a product. More about this topic can
be found in the "Libraries" chapter of the Prophet User’s Guide. In this case you
do not want to use this option so just click OK. This means that the variable will
only be brought into the product when it is referred to by another input variable.
You are returned to the definitions window but instead of it being empty you can
see the definition you have created, which means that you have finished creating
the variable. The next step is to change your product to use this variable. Close
this window and the library variables window, which brings you back to the
Product Design view.
Updating the product 81
Mortality experience
To open the product, click on Product. The following dialog is displayed:
You should normally select Yes when this dialog is displayed. Prophet will then
scan all the input variables in the library to check if any need to be added or
removed from the product. This ensures that your product reflects the changes
you have made to variables in the library. In this case clicking Yes or No has the
same effect since your new variable has a blank indicator expression and hence
will not be brought into the product until it is referred to by another variable.
However, select Yes anyway.
In the outline on the left choose "K - Mortality" and select Q_EXP_PN. You could
now edit this variable in the same manner as you did when you first set up the
product by clicking Open.
82 Lesson 5 Updating libraries and products
However, you can also edit the product using Diagram view. Therefore select the
toolbar button and the following screen will be displayed:
Open the variable Q_EXP_PN using the Open button and select Change Type and
then Formula.
The ERROR function in the last line of this formula will cause the run to
terminate if an invalid value has been entered for the variable SEX (and if the run
has been set up to fail at the first error). The text inside the quotation marks will
appear in the run log. Note that there is a similar function called WARNING. This
function allows the run to continue but produces a warning message in the run
log.
Type in the above formula and click Next to accept it. You are now presented
with the default definition for Q_EXP_MALE.
Updating the product 83
For the Conventional business product amend the Table Name to AM80. Click
Next to accept this. For the variable Q_EXP_FEMALE you should enter the table as
AF80 for the Conventional product and click OK to go back to the Diagram view
window.
The dependencies view for Q_EXP_PN will have been updated to show the new
dependencies as follows:
Using the new formula, both male and female mortality tables are loaded into
memory at the start of a run and the appropriate values (based on age at entry)
are then read into the Q_EXP_MALE and Q_EXP_FEMALE variables. However,
only one of these variables will be used as the experience mortality for any one
model point, depending on the value of the variable SEX.
84 Lesson 5 Updating libraries and products
You will now enhance the formula for Q_EXP_PN to demonstrate the use of the
function READ_MORT_TABLE. It uses only one variable (SEX) rather than three
(SEX, Q_EXP_MALE and Q_EXP_FEMALE). The function READ_MORT_TABLE
has the same parameters as those that must be specified if a variable is defined as
a mortality table. These are the name of the mortality table, the age at entry
variable, select or ultimate setting and age rating. The formula which should be
entered for Q_EXP_PN is:
IF SEX = 0 THEN
READ_MORT_TABLE("AM80", AGE_AT_ENTRY, "S", 0)
ELSE IF SEX = 1 THEN
READ_MORT_TABLE("AF80", AGE_AT_ENTRY, "S", 0)
ELSE
ERROR("Invalid value entered for variable SEX")
Note: International library users should use GKM80 and GKF80 respectively
instead of AM80 and AF80.
If after entering THEN in this formula you select the Function Wizard using Shift
F3 or by clicking the button on the toolbar, the following dialog is displayed:
Updating the product 85
Select the Read function category and then READ_MORT_TABLE. Click Next
and then enter the arguments required for the function. When you have done this
click Finish and the function will be entered into the formula. Then continue
entering the formula. Remember that F3 can be used to enter variable names into
the formulas.
Note: You can switch back and forth between Diagram view and the original list
of variables using the and toolbar buttons and the buttons to the right of
the Select button. This can be useful because you can then use the outline to help
you select the variable you want to look at. Prophet remembers which variable is
the selected one when you move between the views in this way.
When you do this you will see that the list of variables now includes the core
variables as well as the input variables. However, you cannot edit the core variables
from either of the views. This can only be done from within the library.
There are certain things that you can do in Diagram view that you cannot do when
the list of variables is displayed, such as running the product or opening the table
for a definition.
86 Lesson 5 Updating libraries and products
Valuation series
You have set up the variable VALN_SERIES in the library with a default definition
of model point. You will now amend the product so that if this variable takes the
value 0, the policy forms part of the old series, and if it takes the value 1 it will
form part of the new series.
To do this, you need to change the variable VAL_INT_PC. Select it using the drop
down list of variable names and click Open. Select Change Type followed by
Formula. The following formula needs to be entered:
IF VALN_SERIES = 0 THEN
2.75
ELSE IF VALN_SERIES = 1 THEN
3.0
ELSE
ERROR("Invalid value entered for variable VALN_SERIES")
You are presented with the Generic Table Definition screen which appears as
follows:
Table/Variable This is the name of the table which Prophet uses when finding the required values
Name for the variable. You can select whether to specify the table name directly or read it
from another variable. Since we only need to use one table, leave Table Name
selected. The table has not been created yet, but you will call it INIT_COM, so enter
INIT_COM.
Time You can choose either Monthly or Annually. Select Annually so that the table is only
Allocation accessed once a year. In fact it will only be accessed once for each model point
because the value for this variable does not vary with time. Prophet allows for this
automatically.
Treat Missing Accept the default so that if a value is missing from the table Prophet treats that as
Value as Error an error rather than using a value of zero.
You can either type in the name or use either the drop down list box or the Insert
Variable button to select the name from a list. The main differences between the
two lists are:
88 Lesson 5 Updating libraries and products
1. The drop down list box includes special names such as VAR_NAME and
PROD_NAME which can only be used as index variables. These aren't
included in the Insert Variable list because they are not true variables.
2. The Insert Variable list shows the descriptions for each variable whereas the
drop down list box only shows the names.
Index Variable 2
Set this to VAR_NAME. Prophet will then use the values in the column headed
IC_RATE_PC in the generic table because this is the name of the current variable.
where the terms inside the brackets correspond to the entries "Table Name",
"Treat Missing Value as Error", "1st Index Variable" and "2nd Index Variable".
The first two arguments are text strings and require double quotes. VAR_NAME
also needs to be in double quotes because it is not the name of an actual variable.
Updating the product 89
Note: If for the Index Variable arguments you wish to use the values calculated for
particular variables rather than the names themselves they should not be entered in
double quotes.
For more information about the use of Prophet’s READ functions, refer to the
Help within Prophet.
Enter the description Tutorial Initial Commission Rates. Enter a value of 2 for
the Number of Index Variables.
Enter 26 in the Number of Data Rows field and 1 in the Number of Data
Columns field. Accept Table Format for the Layout. Click on OK and you will be
presented with an empty table of the required size.
90 Lesson 5 Updating libraries and products
Enter POL_TERM_Y as the header of the first column. Enter IC_RATE_PC as the
header of the second column. The width of the columns can be altered by
dragging the right hand edge of the column within the grey border area, or by
pressing F9 to refresh the table.
The table of commission rates set out at the start of Lesson 1 covers policy terms
of between 5 and 30 years, so you should enter all possible values in the first
column. You will have to enter the required terms in years (5 through to 30). In
the second column, enter the commission rates that correspond to each premium
paying term, interpolating where necessary.
Click Close to close this new table. Save the product, selecting the option to delete
the existing results files as you are not going to use them again and return to
Product Design view.
Choosing a scenario which shows the effects of product changes 91
Open the table C_ENDT.RPT by clicking on the Model Point File button. Then use
the Update button in the Variables section to add the VALN_SERIES variable to the
model point file. Click OK to accept the default settings for the dialog which
appears. Create a second model point by right clicking and selecting Add Row.
Then copy the values for the first model point to the second model point and enter
the following values:
SPCODE 1 2
AGE_AT_ENTRY 30 30
SEX 0 1
POL_TERM_Y 10 10
ANNUAL_PREM 170 160
PREM_PAYBL_M 120 120
PREM_FREQ 1 1
SUM_ASSURED 2000 2000
DURATIONIF_M 79 79
INIT_POLS_IF 1 1
VALN_SERIES 0 0
The first model point represents a policy for a male, and the second represents a
policy for a female. Note that the lower annual premium for females reflects the
lower expected mortality rates.
92 Lesson 5 Updating libraries and products
Use Save As from the File menu to change the file name to C_ENDT.002.
SPCODE 3
AGE_AT_ENTRY 30
SEX 0
POL_TERM_Y 10
ANNUAL_PREM 170
PREM_PAYBL_M 120
PREM_FREQ 1
SUM_ASSURED 2000
DURATIONIF_M 79
INIT_POLS_IF 1
VALN_SERIES 1
Once you have saved and closed this new model point file, the product is ready to
be re-run by clicking on the Run button.
This message indicates that a variable is missing from the model point file that is
being read. This has occurred because the model point file extension in the Tables
tab in the Tutorial run setting was not changed from .RPT to .002 before the
product was run.
It is good practice to look at the run log every time a product is run. However, if
you had gone straight to Results, the product C_ENDT would not have been
available for selection, as there are no results to report on.
To change the model point file extension, open the Tutorial run setting and
amend the File Extension for Model Point Files to 002 on the Tables tab. You
should now re-run the product and report on the results. You can see the effect of
the changes that were made by comparing the results for sub-product codes 1, 2
and 3.
94 Lesson 5 Updating libraries and products
95
L E S S O N 6
Further topics
In this lesson you will learn about some further aspects of Prophet, which should
help in your general understanding and use of the system.
• Conclusion 99
96 Lesson 6 Further topics
Regeneration of products
The regeneration option forces Prophet to regenerate the code for one or more
products, when they are included in the next calculation run. Regeneration
should be used in the following cases:
• If you have made changes in the library which only affect core variables, those
changes will only be reflected in the products when they are next regenerated.
Using the Regenerate option means that you do not have to re-scan each of
the products concerned. However, you will still need to do this if any of the
library changes affect input variables.
• If you have copied libraries and products between PCs but have not copied the
compiled product executable files.
• If a new release of Prophet has been issued which requires the code to be
regenerated before certain new features are available.
After selecting Regenerate in the Tools menu the following dialog will be
displayed:
If you wish, you can elect to delete any existing results files for the products being
regenerated.
98 Lesson 6 Further topics
• To bring a new input variable into the products, where the default definition is
the required one for each product.
If you select Auto-Scan in the Tools menu, the following dialog will be displayed:
Conclusion
You have now completed the "Introduction to Prophet Tutorial" and should be
ready to tackle some real tasks using Prophet.
• Accumulations
• Summary library
• Reports
• Queries
• Work through the tutorial in the Data Conversion System and Viewer User's
Guide.
• Use Help
Help contains context sensitive information for all the system features of
Prophet
• Experiment with the system and the calculations you can set up
100 Lesson 6 Further topics
101
This section contains listings and results printouts for the C_ENDT product
which you should have produced as you went through the tutorial using the
Conventional library. These will help you understand and identify any mistakes
you may have made and includes:
• Results 112
102 Conventional product input files & results
Product listing
Product Details
Volume: Workspace: C:\PROTUTOR
Name: C_ENDT Description: Tutorial Product
Selected Indicators
Name Description Code
A - General
ALWAYS Items Always Required A10
D - Configuration
PROJ Projection of Existing Business D10
H - Product Types
REG_PREM Regular Premium Product H10
ENDOWMENT Endowment Product H20
I - Additional Benefits
SURR_VALUES Surrender Values Required I10
O - Tax
OTAX_ON_I_E Office Tax : I Minus E O20
P - Valuation / Reserving
ONE_VALBASIS One Val Basis - Basic, Bonus, PUPs P10
Q - Solvency Margin
SOLV_MARGIN Solvency Margin Required Q10
U - Profitability
DISC_PROFITS Discounted Profit Values Required U10
Input Variables
Name Description Defn Type Code
A - General
__________________________________________________________________
E - Benefits
__________________________________________________________________
F - Reserving / Solvency / Accruals Method
__________________________________________________________________
G - Interest Rates
__________________________________________________________________
H - Tax
__________________________________________________________________
I - Commission
Index Variables
1: POL_TERM_Y
2: VAR_NAME
__________________________________________________________________
J - Expenses
__________________________________________________________________
K - Mortality
__________________________________________________________________
N - Initial Values
DURATIONIF_M Dur I/F Mths at Start of Proj Period Model Point NA10
INIT_POLS_IF Initial Number of Policies In Force Model Point NA15
Row SPCODE AGE_AT_ENTRY SEX POL_TERM_Y ANNUAL_PREM PREM_PAYBL_M PREM_FREQ SUM_ASSURED DURATIONIF_M INIT_POLS_IF
0001 30 0 10 840 120 12 10000 7 1
Parameter file
Table Listing Standard Workspace 12/09/2003
File Name: C:\PROTUTOR\TABLES\PARAMET.FAC
PROD_NAME IE_FIXED PROP_EXPQ_PC PROP_VALQ_PC RC_RATE_PC RE_FIXED_Y VAL_INT_PC YR1_LAPSE_PC YR2_LAPSE_PC YR3_LAPSE_PC
C_ENDT 160 85 100 3 24 3 10 7.5 3
Conventional product input files & results
Global file
VAR_NAME RUN_01
CPI_GTH_PC 4
DISC_A_PC 8
DISC_B_PC 6
DISC_C_PC 10
NP_FII_PC 2.25
NP_RCGCHG_PC 0
NP_RCGUNC_PC 0.45
NP_UFII_PC 1.25
NP_UNRCG_PC 2.55
OTAX_FII_PC 20
OTAX_RCHG_PC 25
OTAX_UFII_PC 25
SOLV_INT_PC 5
Results
Results Report: Results Standard Workspace 12/09/2003
C:\PROTUTOR\RUN_01\C_ENDT.RES 12/09/2003 11:01:38 Start Date: 31/12/2002
Run Number: 1 - Standard Assumptions Product: C_ENDT - Tutorial Product
Results Type: All Sub-Product: All
Audit Information
Run_Identifier 3
Description Total Office Taxable Office Non Death Benefit Surrender Maturity Total Gross Total Increase in Life Fund Tax Profit before
Premium Income and Taxable Gains Outgo Benefit Outgo Benefit Outgo Commission Gross Statutory Reserve Solvency
Income Gains Expenses Margin
Name PREM_INC O_TAXBL_INC O_UNCHG_GAIN DEATH_OUTGO SURR_OUTGO MAT_OUTGO TOT_COMM TOT_EXP INC_MATH_RES LIFEFUND_TAX PROFIT
Code WA20 WD30 WD31 WE10 WE20 WE40 WF95 WG20 WH10 WJ65 WK10
Dec 2002 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00
Jan 2003 0.00 3.84 3.29 0.11 3.23 0.00 0.00 2.00 -0.50 0.34 1.97
Feb 2003 0.00 3.84 3.29 0.11 3.23 0.00 0.00 2.00 -0.51 0.34 1.97
Mar 2003 0.00 3.84 3.29 0.11 3.24 0.00 0.00 2.00 -0.52 0.34 1.97
Conventional product input files & results
Apr 2003 0.00 3.84 3.29 0.11 3.24 0.00 0.00 2.00 -0.53 0.33 1.97
May 2003 0.00 3.83 3.29 0.11 3.25 0.00 0.00 2.01 -0.54 0.33 1.97
Jun 2003 167.81 4.29 3.68 0.12 3.63 0.00 5.03 2.01 158.93 0.25 5.81
Jul 2003 0.00 4.28 3.67 0.12 3.64 0.00 0.00 2.01 -0.50 0.43 2.26
Aug 2003 0.00 4.28 3.67 0.11 3.64 0.00 0.00 2.01 -0.51 0.43 2.26
Sep 2003 0.00 4.28 3.67 0.11 3.65 0.00 0.00 2.01 -0.52 0.43 2.26
Oct 2003 0.00 4.28 3.67 0.11 3.65 0.00 0.00 2.01 -0.52 0.43 2.26
Nov 2003 0.00 4.28 3.67 0.11 3.66 0.00 0.00 2.01 -0.53 0.43 2.26
Dec 2003 0.00 4.28 3.67 0.11 3.66 0.00 0.00 2.01 -0.54 0.43 2.26
2003 167.81 49.16 42.14 1.33 41.72 0.00 5.03 24.09 153.21 4.51 29.22
2004 162.66 54.26 46.51 1.42 46.99 0.00 4.88 24.28 147.75 5.40 32.72
2005 157.66 59.18 50.73 1.53 52.22 0.00 4.73 24.48 142.43 6.25 35.93
2006 0.00 25.46 21.83 0.65 22.78 1797.62 0.00 10.26 -1800.94 2.46 14.46
2007 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 -0.52 0.52
2008 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 -0.52 0.52
2009 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 -0.52 0.52
2010 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 -0.34 0.34
2011 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 -0.17 0.17
2012 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00
2003 76.84
2004 49.11
2005 15.82
2006 1.78
2007 1.38
2008 0.95
2009 0.48
2010 0.16
2011 0.00
2012 0.00
This section contains listings and results printouts for the I_ENDT product which
you should have produced as you went through the tutorial using the International
library. These will help you understand and identify any mistakes you may have
made and includes:
• Results 127
118 International product input files & results
Product listing
Product Details
Volume: Workspace: C:\PROTUTOR
Name: I_ENDT Description: Tutorial Product
Selected Indicators
Name Description Code
A - General
ALWAYS Items Always Required A10
D - Configuration
PROJ Projection of Existing Business D10
H - Product Types
REG_PREM Regular Premium Product H10
ENDOWMENT Endowment Product H20
I - Additional Benefits
SURR_VALUES Surrender Values Required I10
O - Tax
OTAX_ON_PROF Office Tax : Tax on Profits O20
P - Valuation / Reserving
ONE_VALBASIS One Valn Basis - Basic, Bonus, PUPs P10
Q - Solvency Margin
SOLV_MARGIN Solvency Margin Required Q10
U - Profitability
DISC_PROFITS Discounted Profit Values Required U10
Input Variables
Name Description Defn Type Code
A - General
__________________________________________________________________
E - Benefits
__________________________________________________________________
F - Reserving / Solvency
__________________________________________________________________
G - Interest Rates
__________________________________________________________________
H - Tax
__________________________________________________________________
J - Expenses
__________________________________________________________________
K - Mortality
__________________________________________________________________
N - Initial Values
DURATIONIF_M Dur I/F Mths at Start of Proj Period Model Point NA10
INIT_POLS_IF Initial Number of Policies In Force Model Point NA15
Row SPCODE AGE_AT_ENTRY SEX POL_TERM_Y ANNUAL_PREM PREM_PAYBL_M PREM_FREQ SUM_ASSURED DURATIONIF_M INIT_POLS_IF
0001 30 0 10 840 120 12 10000 7 1
International product input files & results
PROD_NAME IE_FIXED PROP_EXPQ_PC PROP_VALQ_PC RC_RATE_PC RE_FIXED_Y VAL_INT_PC YR1_LAPSE_PC YR2_LAPSE_PC YR3_LAPSE_PC
I_ENDT 160 85 100 3 24 3 10 7.5 3
Global file
Table Listing Standard Workspace 12/09/2003
File Name: C:\PROTUTOR\TABLES\GLOBAL.FAC
VAR_NAME RUN_01
CPI_GTH_PC 4
DISC_A_PC 8
DISC_B_PC 6
DISC_C_PC 10
NP_FII_PC 2.25
NP_RCGCHG_PC 0
NP_RCGUNC_PC 0.45
NP_UFII_PC 1.25
NP_UNRCG_PC 2.55
OTAX_PROF_PC 33
SOLV_INT_PC 5
International product input files & results
Audit Information
Run_Identifier 5
Description Total Office Taxable Office Non Death Benefit Surrender Maturity Total Gross Total Increase in Life Fund Tax Profit before
Premium Income and Taxable Gains Outgo Benefit Outgo Benefit Outgo Commission Gross Statutory Reserve Solvency
Income Gains Expenses Margin
Name PREM_INC O_TAXBL_INC O_UNCHG_GAIN DEATH_OUTGO SURR_OUTGO MAT_OUTGO TOT_COMM TOT_EXP INC_MATH_RES LIFEFUND_TAX PROFIT
Code WA20 WD30 WD31 WE10 WE20 WE40 WF95 WG20 WH10 WJ65 WK10
Dec 2002 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00
Jan 2003 70.00 3.20 2.74 0.89 5.08 0.00 -0.61 2.00 58.31 3.39 6.88
Feb 2003 69.38 3.36 2.88 0.88 6.20 0.00 -0.45 1.99 57.33 3.20 6.49
Mar 2003 68.77 3.52 3.02 0.87 7.48 0.00 -0.30 1.98 56.35 2.95 5.98
Apr 2003 68.16 3.68 3.15 0.87 8.95 0.00 -0.15 1.97 55.39 2.63 5.34
May 2003 67.56 3.83 3.28 0.86 10.64 0.00 0.00 1.96 54.44 2.24 4.54
Jun 2003 66.96 3.98 3.41 0.86 9.33 0.00 2.01 1.94 57.22 0.99 2.00
Jul 2003 66.52 4.14 3.55 0.86 11.01 0.00 2.00 1.94 56.54 0.62 1.26
Aug 2003 66.09 4.30 3.68 0.85 12.94 0.00 1.98 1.93 55.86 0.17 0.34
Sep 2003 65.65 4.46 3.82 0.85 15.18 0.00 1.97 1.93 55.18 -0.39 -0.78
Oct 2003 65.22 4.61 3.95 0.84 17.75 0.00 1.96 1.92 54.51 -1.05 -2.14
Nov 2003 64.79 4.76 4.08 0.83 20.72 0.00 1.94 1.91 53.85 -1.85 -3.76
Dec 2003 64.37 4.92 4.21 0.83 24.14 0.00 1.93 1.91 53.19 -2.81 -5.70
2003 803.49 48.75 41.78 10.29 149.40 0.00 12.27 23.37 668.17 10.07 20.44
2004 745.28 70.70 60.60 9.71 181.56 0.00 22.36 22.54 657.77 -5.73 -11.63
2005 718.50 93.50 80.14 9.61 67.89 0.00 21.55 22.61 669.34 33.38 67.76
2006 696.15 115.85 99.30 9.67 89.07 0.00 20.88 22.78 647.60 40.03 81.27
2007 674.46 137.48 117.84 9.85 110.02 0.00 20.23 22.95 626.39 46.31 94.02
2008 653.40 158.39 135.76 10.14 130.74 0.00 19.60 23.12 605.68 52.23 106.04
2009 632.94 178.61 153.09 10.55 151.24 0.00 18.99 23.30 585.46 57.79 117.33
2010 613.06 198.15 169.84 11.07 171.53 0.00 18.39 23.47 565.71 62.99 127.89
2011 593.73 217.03 186.02 11.70 191.63 0.00 17.81 23.64 546.41 67.85 137.75
2012 241.81 95.85 82.15 4.94 85.73 6853.43 7.25 9.90 -6631.99 29.88 60.66
2003 523.54
2004 579.21
2005 555.41
2006 515.71
2007 459.61
2008 386.57
2009 295.99
2010 187.21
2011 59.50
2012 0.00