COMMUTATION

Required element:

The value of this element specifies the array should be indexed.

Dx12: Monthly Dx values

Dx: Yearly Dx values

Cx12: Yearly Cx values

Cx: Monthly Mx values

Mx12: Monthly Mx values

Mx: Yearly Mx values

Nx12: Monthly Nx values

Nx: Yearly Nx values

Required attribute:

This attribute defines the name of the MathVariable.

Required attribute:  

This attribute identifies type of the MathVariable. The Commutation MathVariable returns a single value from a specified commutation array. It's also used to recalculate all of the commutation functions, using the input fields indicated below.

Note: This MathVariable relies on the INDEX attribute to return a value from a commutation array.

Required attribute:

This attribute specifies which single index value in the array should be returned.

Note: Array indices start with 1, rather than 0.

Required attribute:  

Yes: The Commutation functions will be recalculated. This should be done any time there is a change to an input that should result in new commutation function values.

No: The Commutation functions will not be recalculated. This value should be used if the MathVariable is only indexing currently calculated commutation function arrays.

Required attribute:

The value of this attribute should be the starting age for the commutation calculations.

An INTEGER MathVariable may also be used to provide the value for this attribute, provided that it resolves to the desired value.

Required attribute:

01: The level death benefit option will be assumed.

02: The increasing death benefit option will be assumed.

A TEXT MathVariable may also be used to provide the value for this attribute, provided that it resolves to either "01" or "02."

Required attribute:

This attribute defines the interest rate. Its value should be 1 plus the monthly factor (i.e. 1.xxxx), regardless of the MODE used.

This value can be either a literal value or an DECIMAL MathVariable that resolves to the desired value.

Required attribute:

This attribute defines the ending age to be in the commutation function calculations. The ending age should be greater than the value of the AGE attribute, and must math the ending point of the SourceArray (the age at the end point of the array plus one year).

This value can be either an integer or an INTEGER MathVariable that resolves to the desired value.

Note: While the system will not error if the source array doesn't match the length of MATURITY minus AGE, it may produce unexpected results.

Required attribute:

This attribute contains an array of Q values that are to be used to calculate the commutation functions.

Note: While the system will not error if the source array doesn't match the length of MATURITY minus AGE, it may produce unexpected results.

This attribute specifies whether the commutation functions are to produce annual or monthly Q values in an annual array. The SOURCEARRAY of these Q values should match either the monthly or the annual values.

MONTHLY: The commutation functions should produce monthly values. This is the default behavior.

ANNUAL: The commutation functions should produce annual values. If ANNUAL is used, only annual commutation functions will be available.

A TEXT MathVariable may also be used to provide the value for this attribute, provided it resolves to "MONTHLY" or "ANNUAL."

Note: If a monthly value is used with the ANNUAL mode, the system will return "0."

Required attribute:

This attribute defines whether it is assumed that the claim will be paid at the beginning of the month, the end of the month or at any time during the month.

BEGIN: It is assumed that the claim will be paid at the beginning of the month.

END: It is assumed that the claim will be paid at the end of the month. This is the default behavior.

IPOC: It is assumed that the claim will be made at any point during the month.

A TEXT MathVariable may also be used to provide the value for this attribute, provided it resolves to "BEGIN," "END" or "IPOC."

This attribute is used to define the datatype of the MathVariable. For the COMMUTATION MathVariable, it must be set to "DECIMAL."