Return to PSG Models documentation page

SSASIM input table BEN_DI

Contains highest level description of parameters that control calculation of aggregate annual benefits paid under DI program, consisting of several foreign keys pointing to rows in child tables, parameters specifying initial values and transition paths for disability incidence and recovery factors (which are among model's key stochastic variables --- see ASSUMP and its child tables), parameters specifying DI program administrative costs, and a parameter specifying relative mortality decline rates among DI beneficiaries. Each row specifies a different set of parameters.

Parent table is: RUN

Child table is: BEND_DI

Child table is: NBEN_DI

Child table is: ABEN_DI

Child table is: BDYN_DI

Go to SSASIM input parameters overview

SSASIM:   BEN_DI . id
Identifies id of DI benefit parameters specified on this row of table, so id value should be unique.

Valid values: 1 to 999999999 (nine digits), Integer

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . notes
Describes specification of table row in free-form note.

Valid values: any ASCII text (Note: do not copy and paste from a word processor because of the possibility of embedded non-ASCII characters.)

Source code: notes are not read by the model

SSASIM:   BEN_DI . bend_di_id
Specifies id of rows in BEND_DI child table that contain dynamic policy parameters for the DI program that are effective in various modes of SSASIM operation.

Valid values: 1 to 999999999 (nine digits), Integer

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . nben_di_id
Specifies id of rows in NBEN_DI child table that contain numbers of DI beneficiaries by age and gender at end of RUN.year_zero calendar year.

Valid values: 1 to 999999999 (nine digits), Integer

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . aben_di_id
Specifies id of rows in ABEN_DI child table that contain average monthly DI benefit by age and gender at end of RUN.year_zero calendar year.

Valid values: 1 to 999999999 (nine digits), Integer

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . bdyn_di_id
Specifies id of rows in BDYN_DI child table that specify dynamics (or time pattern) of changes in age-gender-specific transition probabilities on and off DI program, changes in age-gender-specific initial benefit levels relative to average earnings, etc. All these parameters affect only the CBA mode.

Valid values: 1 to 999999999 (nine digits), Integer

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . dif0
Specifies initial RUN.year_zero value of disability incidence factor (dif), which is one of model's stochastic variables whose future ultimate (or post-transition) values are determined by ASSUMP and child tables parameters (see above). Value of dif0 is expressed as the natural logarithm of the decimal factor. The simulated decimal factor for each simulation year is used to scale level of Markov transition probabilities on to DI program, which are age and gender specific and are assumed to be unchanging over time.

Valid values: any, Real

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . dif_kink
Specifies whether or not transition path from initial value of disability incidence factor to its ultimate, post-transition values has a single kink (or bend) point or is linear (without a kink).

Valid values: T (=1) or F (=0) (for true or false), Logical

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . dif_kvalue
Specifies dif kink point value if dif_kink is true. Value of dif_kvalue is expressed as the natural logarithm of the decimal factor at kink point. If kink point is assumed, the dif transition path is a linear interpolation from its initial year value to kink point value in every scenario. Scenario variation in transition path is restricted to years after dif_kyear (see below) as dif values are interpolated between dif_kvalue and ultimate value of dif, which is generated using ASSUMP and child tables parameters.

Valid values: any, Real

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . dif_kyear
Specifies simulation year of dif kink point value if dif_kink is true.

Valid values: 1 to ( RUN.num_years - 1 ), Integer

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . drf0
Specifies initial RUN.year_zero value of disability recovery factor (drf), which is one of model's stochastic variables whose future ultimate (or post-transition) values are determined by ASSUMP and child tables parameters (see above). Value of drf0 is expressed as the natural logarithm of the decimal factor. The simulated decimal factor for each simulation year is used to scale level of Markov transition probabilities off of DI program, which are age and gender specific and are assumed to be unchanging over time.

Valid values: any, Real

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . drf_kink
Specifies whether or not transition path from initial value of disability recovery factor to its ultimate, post-transition values has a single kink (or bend) point or is linear (without a kink).

Valid values: T (=1) or F (=0) (for true or false), Logical

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . drf_kvalue
Specifies drf kink point value if drf_kink is true. Value of drf_kvalue is expressed as the natural logarithm of the decimal factor at kink point. If kink point is assumed, the drf transition path is a linear interpolation from its initial year value to kink point value in every scenario. Scenario variation in transition path is restricted to years after drf_kyear (see below) as drf values are interpolated between drf_kvalue and ultimate value of drf, which is generated using ASSUMP and child tables parameters.

Valid values: any, Real

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . drf_kyear
Specifies simulation year of drf kink point value if drf_kink is true.

Valid values: 1 to ( RUN.num_years - 1 ), Integer

Source code: ben_di.h and ben_di.cpp

SSASIM:   BEN_DI . admrrx_f0
Specifies DI administrative and railroad interchange costs as a decimal fraction (not a percent) of total DI benefits paid in RUN.year_zero calendar year.

Valid values: 0.0 to 1.0, Real

Source code: ben_di.h, ben_di.cpp, ben.h, and ben.cpp

SSASIM:   BEN_DI . admrrx_con
Specifies constant term in administrative cost regression used to simulated future values of admrrx fraction, the initial year's value of which is defined by admrrx_f0. Search ben.cpp file for phrase admrrx to see details of regression specification and use of regression in simulating administrative costs for DI program.

Valid values: any, Real

Source code: ben_di.h, ben_di.cpp, ben.h, and ben.cpp

SSASIM:   BEN_DI . admrrx_inf
Specifies inflation-rate term in administrative cost regression used to simulated future values of admrrx fraction, the initial year's value of which is defined by admrrx_f0. Search ben.cpp file for phrase admrrx to see details of regression specification and use of regression in simulating administrative costs for DI program.

Valid values: any, Real

Source code: ben_di.h, ben_di.cpp, ben.h, and ben.cpp

SSASIM:   BEN_DI . mdr_frac
Specifies rate of mortality decline among DI beneficiaries as a decimal fraction (not a percent) of rate of mortality decline in whole population.

Valid values: 0.0 to 1.0, Real

Source code: ben_di.h and ben_di.cpp