SURVEYOFCONSUMERFINANCES EMPLOYER SPONSOREDPENSIONBEhrEFITPWS

Richard

T. Curtin

Survey Research University

Center

of Michigan

=‘ THE UNIVERSlTY

OF MICHIGAN,

1987

I

TABLE OF CONTENTS
Program Overview
1

. . . . . . . . . . . . . . . . . . . . . . . . . , . . . . . . . . . . . . . . . . . . . . . . . .

Program Execution Commands . . . . . . . . . . . . . . . . . . . . . . , . . . . . . . . . . . . . . . . . . .

2 6 6 9 10 16 17 17 17 23 23 23 24 24 25 25 26 26 27 27 28 28

Input Files

........................................................ ParticipantData ................................................... Creating Participant/plan Input Records ................................. Estimation Parameters ............................................. Pension Plans .................................................... Valid Ranges ....................................................

Output Files ....................................................... Data Files ...................................................... Data Base Utility Programs ............................................ Conversion to Person Records ........................................ Conversion to Household Records ...................................... Osiris Output Data File Creation ........................................ Dictionary Files .................................................. Source Files for Modification ..................... Examples of Command Files

; ...................

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Pascal Program Source Files ........................................... ................................................ PP4.0SourceCode Procedures Source Code ............................................ Utilities Source Code ............................................... Online Documentation Availability
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

*

to Non-MTS Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

LIST OF TABLES

Table 1. Participant Data . . . . . . . . . . . . . . . . . . . . . . , . . . . . . . . . . . . . . . . . . . . . . Table 2. Estimation Parameters
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7 10
18 19

Table 3. Valid Ranges for Input Parameter Settings . . . . . . . , . . . . . . . . . . . . . . . . . . Table 4. Valid Ranges for Participant Data Variables . . . . . . . . . . . . . . . . . . . . . . . . . Table 5. Output Data File for Entitlement Estimates Based on Actual Participant Data with Given Quit Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table 6. Output Data File for Entitlement Estimates Based on Simulated Participant Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table 7. Output Data File for Entitlement Estimates Based on Actual Participant Data Using All Potential Quit Dates . . . . . . . . . . . . . . . . . . . . . . . . , . . . . . . . . . . Table 8. OSIRIS Dictionary for Actual Participant Data Formatted as Person F&cords . Table 9. OSIRIS Dictionary for Actual Participant Data Formatted as Household Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21

22

22 29

31 3.5

Table 10. OSIRIS Dictionary for Simulated Data Formatted as Pension Plan Records . .

Au

...

PROGRAM OVERVIEW
This program is designed to estimate Survey of Consumer Finances, the pension entitlements held by respondents provisions obtained in the from

based on the plan formulas

and benefit

the linked sample of pension providers.

The pension program uses systems of equations to

represent each of the pension plans, including all benefit formulas and payment provisions. These equations, in turn, use as input the work and income histories of the respondents. When combined with assumptions needed for the estimation of the present value of future benefit flows, the program calculates subsequent analysis. Program users have complete control over the input data and estimation parameters, Estimates can be made for any set the appropriate pension entitlements, and prepares output data files for

providing the capability of a wide array of analytic strategies.

of respondent employment characteristics, whether based on the actual survey data or simulated profiles. The pension entitlements due from any one or from every pension plan can be calculated. The program provides estimates of all. types of retirement benefits-normal retirement, early The date of

retirement, late retirement, disability retirement, and surviving spouse benefits.

employment termination- which must be assumed for most participants since they were still working at the time of the survey-can be set or limited to any given age range or calendar dates.

In addition to estimates based on a single quit date, the program can also produce an estimate of the benefit amount due at every age from the time of the survey until the participant reaches the maximum quit age allowed,. These yearly estimates cover all types of retirement, disability and survivor benefits. This document describes the program, and defines all user commands and analysis options. Although this document has been tailored for users of the University of Michigan’ computer s system, all of the program commands and options would be identical if installed on ‘ another computer system.
.

Michigan’ computer system is easily accessible through the MIZRJT network, s The programs can then be used on

with local access in many cities, including Washington DC. MTS or downloaded to another computer installation.

2

PROGRAM EXECUTION

COMMANDS

The commands

required

to run the program

are just two: The first loads the Pascal plan formulas replicate and benefit

program and

object file SPFN:PPI.O, the second

which contains

the pension for each

requirements, desired.

gives the user defined

options

of the analysis

The user and the

defined variables behavioral entitlements. each replicate

include the income and work history

characteristics the present

of the participants, discounted

and economic assumptions

needed to estimate

value of pension

All of the user defined commands analysis desired. The program

and options are specified on a single input line for by issuing the following commands:

is executed

$RUN SPFN:PP4.0 RUNTYPE INDATA ( second replicate 1 ( third replicate )

INPARM

INPLAN

OUTDATA

OUTTAB

OUTERR

The file SPFN:PPI,O

holds the executable

Pascal

(JB) object

program.

All of the user specifies specify the type the data file

options are specified on the second, and subsequent of analysis cases, to be performed,

input lines.

The RUNTYPE and INPLAN process;

and the input files INDATA, plans

INPARM,

parameters,

and pension

to be used in the estimation estimates

The INPLAN

should only be specified when the program be excluded when the program estimates

are based on simulated participant and OUTERR.

data cases, data.

and must from file

are based on actual OU’ ITAB,

The output

the program is written contains the estimated

to the files OUTDATA, entitlement amounts formatted

The OUTDATA

in a format for printed

suitable output,

for input to analysis including table

programs. and a that, always

The OUTTAB summary

file has the results

headings,

of the input parameters. incorrect,

The OUTERR

file gives information problems.

on all calculations files must

while not necessarily

are flagged

for potential

The output

be defined by the user, following standard MTS file name conventions. The names used to designate be used. line. the various files are not unique: any permissible file name can

The program identifies the files by the order in which they are listed on each command on each line must be the RUNTYPE, followed by the fiie names which

The first entry

3
contain the input data (INDATA), the file containing the estimation assumptions (INPARM), the file containing the selected pension plans (INPLAN), the file to write the output data set

(OUTDATA), the output tables (OUTTAB), and estimation problems (OUTERR). The order of the listed files must be followed exactly, and no file name can be omitted from the list, except for INPLAN which is only allowed for analysis based on simulated data cases. Since replicate analyses will often be desired, for example to compare benefit entitlements under different assumptions about future economic conditions, one execution of the program will perform as many separate analyses as required. The commands can be entered directly from the terminal keyboard, or entered into a file which can then be $Sourced or submitted as a batch job. With keyboard entry, the $Endfile

command is required. When using a source file, the $Endfile command is not required if it would have been the last line in the file; if other commands follow (for example, to print the output), the $Endfile is required-it is needed by the program to signal the end of the input stream, and does

not terminate processing of the $Source file. The files SPFNINDATA, SPFN:INPARM, and SPFN:INPLAN file are provided: are the program supplied SPFN:INDATA.SCF, the

default input files. Two versions of the INDATA default file for actual SPFN:INDATA.SIM, SPFNINPLAN

participant data derived from the Survey of Consumer Finances, and the default file of simulated participant characteristics. The file

contains the pension plan IDS for all the pension plans included in the sample. Normally, users would generate

These files are supplied for easy startup and learning exercises.

their own versions of these files, so as to reset each of the data values and estimation parameters to the appropriate levels for the particular analysis desired. SPFN:INDATA.SCF, SPFN:INDATA.SIM, and SPFN:INPLAN The default files SPFN:INPARM, are permitted read access so that

users can duplicate these files. The user’ copy of the these file can then be edited to reflect the s desired changes in the input data, pension plans, or estimation parameters. The SCF data base

can be used to generate a new INDATA.SCF file, using OSIRIS, as described below. RUNTYPE is the only option that does not represent a file name, but rather a numeric code

I

4

which selects the type of analysis to be performed.

The values RUNTYPE can take are:

1.2 when the input is actual SCF respondent and spouse data, which is to be matched to the specific employer sponsored pension plans in which they participate, with all estimates based on an assumed quit date. 3.2 when the SCF respondent and spouse data is matched to the specific plans in which they participate, but no single quit date is assumed. Instead of one estimate, this program option produces the estimated pension entitlement that would accrue if the participant quit in 1983, or in any of the following years until reaching the maximum quit age set in the INPARM file. This output thus gives the profile over time of potential pension entitlements depending on the date of job termination.
4.2 when the input data is for simulated participant income and work histories.

For each set of simulated participant characteristics, the benefit entitlement that would be due under every pension plan included in the INPLAN file is calculated. This option requires an assumed quit date. is entered incorrectly, the program will produce a error message

If the RUNTYPE

indicating a “ bad version ID.” If the name of one or more of the input/output files does not exist, MTS will query for a replacement. .4n example of the execution of the program, estimating one replicate for each of the three RUNTSPES, and using the default input files is as follows: $RUN SPFN:PPI.O 1.2 SPFN:INDATA.SCF 3.2 SPFN:INDATA.SCF 4.2 SPFN:INDATA.SIM $ENDFILE

SPFN:INPARM OUTDATAl OU’ ITABl OUTERRl SPFN:INPARM OUTDATA OUTTAB OUTERRZ SPFN:INPARM SPFN:INPLAN OUTDATA OUTTABS OUTERRB

In the following example, the program is executed with two replicates, each using the same data file, but two separate input parameter files. The data are written to separate output files for later analysis. The input data used is the actual participant data matched with the pension plans The purpose of the two replicates would be the comparison of

in which they participate.

entitlements under the two different sets of input assumptions.

Of course, as many replicates as

desired inay be used, rather than just the two used in the following example: $RUN SPFN:PPI.O 1.2 SPFN:INDATA.SCF 1.2 SPFN:INDATA.SCF $ENDFILE

MYJNPARM 1 OUTDATA 1 OUTTABl MY.I.NPARM2 OUTDATAZ OUTTAB

OUTERRl OUTERRZ

When the same file is used as in the immediately prior replicate, the program can be signaled to use the same file by using an uLw instead of the file name. All of the flie names can

I
5

represent

temporary

files, and if any of the output below, two replicates

files are not wanted,

the file name

*dummy* by

can be used.

In the example

use the same input data file (a file created files, two different problems temporary

the user). two different the data output,

user defined input parameter file to write the table output.

files to store and the

one temporary

estimation

for both replicates,

“‘ dummy” file name to suppress

$RUN SPFN:PP4.0 1.2 MY.INDATA MY.INPARMl -0UTDATAl MY.INPARMP -0UTDATA2 1.2 SENDFILE Multiple starting data sets can be stored

*DUMMY* “DUMMY *

-0UTERRl *

in one file, with

the program

instructed

to read

data

at a specific line number. $CONTINUE

The MTS command WITH *DUMMY * will not work analysis

should be used to terminate for this purpose).

each data set listing within the file (note that $Endfile

An example

of the use of this option is shown below for the simulated but directs the program

which uses the same input data file for all the replicates, line ranges in the hle.

to read different subset of

Also note that the user file MY.PLAN

can constrain

any selected

the pension plans on which to base the simulated $RUN SPFN:PP4.0 4.2 MY.SIM(lOOl MY.INPARM 4.2 MY.SIM(ZOO) * * 4.2 MY.SIM(300) * * $ENDFILE If the commands are entered

data estimates.

MY.INPLAN OUTDATAZ OUTDATA

OUTDATAl l * * *

OUTTABl

OUTERRl

into files to be $Sourced

or run as batch jobs, other commands file ti the printer:

may follow, as shown in the following example, $RUN SPFN:PPQ.O 3.2 NEWDATA NEWPARM $ENDFILE $COPY -PRINT *PRINT* As can be seen from program: distinguish the above

which sends the OU’ ITAB

NEWOUTDA

-PRINT

NEWPROB

examples,

the actual

names

of the files do not matter that the program

to the uses to

it is the RUNTYPE and identify each file.

and the order

of the given

file names

6 INPUT PILES

Participant

Data
The program

INDATA represents the file name where participant input data is stored.

expects the input data to be in free format (data values separated by blanks), with one participant/plan combination per line. If a respondent was covered by more than one pension plan, the data should appear on two or more separate lines, each associated with its own unique pension plan ID. And since pension entitlements were recorded for both the respondent and the spouse, a single household record is often the basis of multiple input lines. For each the

respondent and the spouse, up to four pension plans were coded; thus one household could provide up to eight separate input records. The program treats each line in the INDATA file as a separate case, and will only calculate estimates for those cases included in this file. The number of cases included in the INDATA can be as few as one or as many as the full sample of participants. Any subset of participants, in any order. can be selected for inclusion in the INDATA file. The program option RUNTYPE determines the type and order of input data expected by the program. When the analysis uses the actual household data, the program expects each data line When

to begin with the IDS which identify the specific pension plan which covers the participant.

the program uses simulated participant data, these ID variables are not allowed since estimates are calculated for all pension plans listed in the INPLAN file. In addition to the data necessary to calculate pension entitlements, the input data file can also contain additional variables that will be added to the output data set. These “ pass through” variables can be entered in any format, but can not exceed 132 columns in total, counting blanks. This option facilitates the easy analysis of the output data file, since there is often no need to remerge the output data files with the original SCF data files. 1 The additional variables are is designated for actual ignore the

“ passed through” to the output data set only when the RUNTYPE household data with a given quit date (RUNTYPE presence of the “ pass through” data in the input files. 1.2).

The other RUNTYPEs

Each line in the INDATA file must list the input variables in a fixed order, separated by blanks. The required order and variable definitions are given in Table 1. The first three variables are optional, depending on the RUNTYPE specified. These linking IDS are needed when actual participant data are matched with the specific pension plans under which they are covered (RUNTSPE 1.2 or 3.21, but are not needed when simulated data is used (RUNTYPE 4.2). last variable listed is also optional, and is used to define the “ pass through” variables. The

Table

1

Participant Data (INDATA File)

Order Act Sim Var Name

Definition

1 2 3 4 _ : 7 8 9
10 11

12 13

HHIDX CODEID SEW SPOUSEBD SEX BIRTHD HIRED QUITD WKHRS WAGE WAGEG CRVOL PT

SCF household ID. Pension plan ID. ID of pension plan/provider. Birth date of spouse, if married. Sex of the participant. The participant’ date of birth. s The date the participant was hired. Date the participant terminates employment. Average annual paid work hours. Annual dollar amount of salary and wages. Differential wage growth rate. Voluntary contributions. Pass through variables.

The three IDS are from the Survey of Consumer Finances data file; the program will detect and reject any cases that do not have valid IDS. The HHIDX is the ID for the SCF household, with the digit “ X” appended to indicate the data record of the respondent (x= 11, or the spouse (X= 2). The CODEID is the ID of the pension plan under which the household participant is

covered. The SEQ# is the ID given to each unique plan/provider combination. The SPOUSEBD variable is defined as the marital status of the participant at the time of _

8

retirement. to zero;

If the participant if married, date the of birth,

is single at the time of retirement, should be set equal

this variable date

should be set equal of the spouse. HIRED, The and

variable date

to the birth are defined

participant’ s QUITD, fractions

of hire, and quit date are entered

as BIRTHD,

respectively. of years.

All date variables For example,

as real numbers,

using decimals

to indicate 1, 1983

April 1, 1965 would be entered

as 1965.25,

and July

would be entered for females. The WKHRS relevant horizon

as 1983.50.

The sex of the participant

was defined as one for males, and two

variable for pension

is defined as the average calculations. The

annual

number

of paid work hours over the WKHRS variable is in

major

impact

of the

determining of hours

the accrual

rate for service credit. This variable should be set to the average number
counting all paid vacation, holiday, and sick time.

worked

per year,

For a full time

worker, this would usually be 2,080 hours per year. The WAGE variable
is defined as the annual amount of salary and wages covered under the

pension plan as of the time of the survey if the participant final year of employment if the participant benefits.

was still employed, or wage level in the employment but had not yet

had already terminated

begun to receive retirement

From this base level, two separate income growth factors

are applied to calculate the level of WAGE over time. The first income growth factor is specified in the input parameter file. This parameter is defined as the overaIl average real rate of growth

in wages, and is applied to all participant data. The second income growth factor, specified in the input data file, is designed to capture differences in growth rates across population groups. The input variable WAGEG is defined as the deviation from the overall mean for specific participants; given their age, income and employment histories, and other factors. Since the WAGEG variable

can be constructed so as to sum to zero across all participants included in the analysis, the overall total rate of income growth can be fixed via the input parameter Ele. The CRVOL variable is defined as the amount of voluntary contributions made by the participant, expressed as a percentage of the participant’ annual wages. s pension plans do not include any provisions for voluntary contributions, Since the majority of

this variable equals zero

I
9

for most cases.

For participants that do make voluntary contributions, the CRVOL variable

defines the average yearly contribution rate over the time horizon used for pension calculations. For pension plans that require contributions from participants, the mandatory contribution rates are built into the pension program, and thus do not need to be specified in the input data file. The default input data file INDATA.SCF is based on certain assumptions concerning the

participants. First, the QUITD included is defined as the actual quit date if the participant had already terminated employment, and the respondent’ own estimate of when he/she would quit if s they were still employed at the time of the household survey. Although the default file includes

the expected QUITD, this information can be independently controlled via the input parameter file. Second, the SPOUSEBD and WKHRS variables use the respondent’ current marital status and s current work hours as estimates of future marital status and average work hours. Current

annual salary and wages were used to estimate WAGE if the participant was still employed, otherwise the annual wage in the final year of employment was used. The WAGEG variable was calculated from estimates of life time earnings profiles, and adjusted to reflect differences from the overall mean of 5.5%. The CRVOL variable used the current rate of voluntary contributions

reported by the respondent as an estimate of the average yearly contribution rate.

Creating

Padicipantlplan

Input Recoids

Osiris can also be used to create a new INDATA file from the Survey of Consumer Finances data set. The required co mmands and date transformations are included in the public use file This file can be copied, and edited to reflect any desired change in the

SPFN:OS.DATASCF.

definition of the input variabIes, or in the sample of cases included. If users prefer, other programs like SPSS, SAS, and MIDAS, can be used to create these participant/plan input records. If the subsequent analysis of the pension entitlement date will be done using one of these or some other software package, it would probably be more efficient to use the same software package to generate these input records. Any program that can output free

.

format data records, which can be done by most software packages, can be used to generate the participant/plan input data file.

10

Estimation

Pammeters

INPARM represents the name of the file which contains the user defined parameters needed in the estimation process. The parameter settings must be given in a fixed order on each line. Only the

Each line must start with the parameter settings and may be followed by a comment.

parameter settings on each line are read by the program, the rest of the line is ignored. The required contents of the INPARM file are shown in Table 2. Table 2 Estimation Parameters (INPARM File) Definition

Line

Name

Default

1 2 3
4 5

6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30

SURVEYD TODAYD CPIrate INTrate INCrate SSWB SSWBrate ss SSrate QAGErng QD.4TErng SSPUrt.0 s!SJurto SSPRrta SSJRrto SSPDrto SSJDrto SSSSrto BENMAX SSCUTS PROFCONl PROFCONP PROFCON3 NACONrate NAVOLrng NAMATCH ANNTYPE VESTYPE MRAGE PENTYPE

1983.50 1983.50 0.00 4.00 1.50 34700.00 1.50 5874.00 1.50 16 80 1925 2075 0.50 1.00 1.50 0.75 1.50 2.25 0.40 0.80 1.20 0.60 1.20 1.80 0.50 1.00 1.50 0.75 1.50 2.25 0.50 1.00 1.50 35000 90000 17350 34700 5.00 0.50 3.00 0.30 1.00 0.10 5.00 5.00 0.00 25.00 0.00 0.00 3.00 50.00 0.00 5.00 1.00 0.00

Date of survey observations Base date for present value calculations Annual inflation rate Real interest rate Real wage and salary growth rate SS wagebase (as of survey date) Real SS wagebase growth-rate SS benefit (base amount) Real SS benefit growth rate Quit age range (min, max) Quit date range (min, max) SS primary unreduced (min, mid, max) SS joint unreduced. @in, mid, max)

SS primary reduced (min. mid, max) SS joint Reduced (min, mid, max) SS primary disability (min, mid, max) SS joint disability (min, mid, max) SS surviving spouse (min, mid, max) Maximum benefits tage55, age65) SS wage cutoffs (min, max) Contributions (profits, forfeitures) Contributions (profits, forfeitures) Contributions (profits, forfeitures) NA contributions (other, mandatory) NA CRVOL range (min, max) a0 NA matching WMAN, MVOL) Annuity type I % of payment continued New vesting (1 =on/O=om / Yrs to vest
Plan maximum retirement (1 =on/O=off) Pension type (O=NRT/ERTNDT/L+RT,l=DRT,P=DST)

11

The fust two parameters are dates used to set the program’ time reference. The first date s is used to set the time frame for all input variables. This date defines the base period data values to which all growth factors are applied to estimate future trends. The second date defines the year on which to base the discounted present value calculations. For most purposes, both these dates should be set to equal the actual date of the SCF household survey (1983.5). If the date for

present value calculations is set to a date later than the survey date, this would result in estimates of the present value of entitlements for subsequent years. All growth factors are annual percentage rates of change, and are defined as the, average rate over the relevant horizon for pension calculations. Setting the nominal rate of inflation along with the real rates of change in the other variables, gives users the ability to set the overall level of nominal rates of change while preserving real growth rates. In setting these values, the most important consideration involves the comparative sixe of the selected real growth rates for wages and interest rates. The former rate is used KI increase amounts over time, while the latter is used to discount amounts back to the present. Although it is usually assumed that the former is lower that the latter, the selected size of the difference will have an important impact on the estimated results. All growth rates are entered as average annual percentage amounts-for growth rate of 3.5% is entered as 3.5. equal to the rate of tiation. example, an annual

A zero real rate of growth yields a nominal growth rate

Growth rates may be set to either positive, zero, or negative values

for the rate of inflation, income, and the Social Security wagebase and benefit amounts; the real interest rate, however, must be set to a value of greater than zero. This combination of optional settings allows the easy manipulation of the estimation assumptions, in a format that focuses the selection on both the nominal and real rates. As part of the program output, all the nominal rates are calculated and displayed in the file OUTTAB. The inflation rate is intended as a common yardstick for assessing changes in all dollar

values over time. The inflation rate selected represents the average rate of price increases over the entire relevant horizon for pension calculations. The real interest rate variable is defined as

the appropriate income

rate

of discount as the

to use in present annual Thus, increase all three

value

calculations. and are

The real growth wages received they

rate

of

is defined

average

in salaries variables

by plan signify

participants, general interest next

adjusted

for inflation.

similar

in that

concepts, rate.

and are not identified

with any specific price or wage index, or with a particular future time period is often needed-say .4 needlessly high nominal over the rate, as the

Since an estimate

for an extended should

10 to 50 years-these real growth

rates rates,

be chosen

carefully.

high inflation dollar values

holding constant estimation

will only result in needlessly

time period lengthens. options concerning the permissible quit age and date ranges are distinctive specified quit

The program parameters

in that they permit

the censoring

of the input data.

When the maximum

age is 65, the program no higher than 65.

will automatically

cause all pension

estimates

to be based on a quit age of later than age 65, the data a limit on the quit date of The

If any of the input data records be revised

include a QUITD Similarly,

record will automatically

to reflect this age limit.

1983.5 would cause all pension minimum QUITD quit age/date option

estimates

to be based on quitting to adjust

as of the date of the survey. data to restrict

can be used

the input

the minimum can if

to age 55, or age 62 for example: retires

The combined at a certain

use of minimums age or on a certain

and maximums date. For example,

adjust all quit dates so that everyone all participants set equal were assumed age. Or to retire

at age 65, both the age minimum entitlements were

and maximum as

would be though all

to this

if all ‘ pension

to be calculated the minimum

participants

terminated

employment

as of the date date.

of the survey, combinations

and maximum

dates .would be set equal can be selected program option to reflect

to the survey any desired

Various

of quit age and date ranges termination. This

restrictions in data

on the time of employment analysis since separate

allows greater differences

flexibility in quit dates.

input data

files are not

needed to analyze

The Social Security date of the survey, Social’ Security

variables

define the level of the wagebase raks of growth

and benefit amounts

levels as of the over time. income subject The to

as well as the real annual variable is defined

in these

wagebase

as the maximum

wage and salary

13

Social Security single person, “average” proportions

taxation. without

The benefit amount dependents, The retiring types

is defined as the Social Security

benefit payable warrant estimated

to a the as

at age 65, whose work and income history of Social Security benefits over time. types are then

.beneht

level.

other

of this base amount, sets of adjustments in pension

after being adjusted

for growth

Several benefits benefits versus what

are used to account provisions. First,

for the different the base amount

of Social Security for starting

included

plan

is adjusted refers

at age 62 rather unreduced the coding amount.

than at 65, what the pension The second terms adjustment the primary benefits

coding instrument

to as the reduced of a spouse, proportional In addition, all ”

is for the presence versus joint

or absence Other

instrument

amount.

adjustments benefit estimates

are used to estimate are adjusted

disability

and surviving

spouse benefits:

amounts

to reflect the middle,

differences

in work and income histories, benefit amounts.

giving separate Note that or absence for all of one

for the minimum,

and the maximum

types of Social Security dependent, namely

benefits,

the program

only takes account

of the presence

the spouse if married. setting for the differential or a reduction The maximum used for Social Security of 6.67% benefit per year. levels benefits beginning at age 62 the

The default

is 80% of the age 65 amount, benefit amount. was increased by 50%.

For married

participants, than

are set 50% higher

the base

and the minimum level, including

50% below the base.

Of course,

all of these proportions the distinctions.

can be reset to

any desired proportions, growth

1.0, which would neutralize of the benefit file. a setting benefit amounts

With any given set of

the dollar values

are determined

by the initial dollar value and

rate set in the INPARM The INPARM also includes

for the dollar levels used for determining amounts are used. The values chosen

whether

the

minimum, increase wagebase adjusted

midpoint,

or maximum

for the cutoffs

over time, according and the nominal wages to determine by setting

to to the value chosen for the real growth inflation rate. The adjusted groups value cutoffs

rate in the Social Security with the growth
This

are compared

in which of the three the minimum cutoff

the respondent

is included.

option

can be neutralized

to zero, and the maximum

to a number

14

larger than the highest QWAGE. This would have the effect of assigning everyone the “middle” level benefit. The program estimates the dollar value of Social Security benefits by using the base benefit, amount and real growth rates given in the input parameter The program selects the appropriate file, adjusted by a proportional factor.

proportional factor, whose value is specified in the INPARM

file, based on the pension plan provisions that govern the specific benefit formula being used, as well as the retirement age, income history, and marital status of the participants. BENMAX controls the maximum is entered benefit that the program will allow

The input parameter before truncation.

The maximum

in two steps, the first applies to the maximum
.

amount that can be received at age 55, the second applies to the maximum annual pension benefit that can be received at age 65. If the latter maximum interpoiated for retirement exceeds the former, the maximum is

ages between 55 and 65. Of course, both could be set to a very large

value to avoid the use of this truncation parameter. For defined contribution the input parameter pension plans that base contributions on measures of profitability, over the time

PROFCON can be used to set the average rate of contributions

period used for pension calculations. that is based on contributions

Since some pension plans incorporate more than one formula values can be assigned. Pension If a

linked to profits, three separate

plans with only one profit baz+ed contribution second profit based formula

formula would use the variable PROFCONl.

was included in the same plan, PROFCONZ would also be used.

Similarly, PROFCON3 would only be used for the third profit based formula included in any single pension plan. Each of the variables is defined in terms of the proportion of annual wages that represent. In addition, many defined contribution plans also provide for the from forfeitures rates can be

these contributions

allocation of forfeitures ta current plan participants. can be set in the INPARM tie.

The amount of contributions

As with the profit link contributions,

three separate

set, each defined in terms of the proportion of annual wages the contributions A few defined contribution amount of employer contributions. plans provided insufficient information

represent.

to determine the basis and

For these plans, the variable NACON can be used to set the

I

15

rate

of contributions contributions, contribution

expressed

as

a proportion

of annual

wages.

A few

other

plans

had

mandatory mandatory

but failed to specify had been discontinued contribution of annual the minimum variable

the required

contribution

rate-usually

because the For these plans,

at some distant

point in the past.

the unascertained

mandatory

rate can be set, using the second value on the NACON For plans did not specify maximum rates file. the permissible range of are are

line, defined as a proportion voluntary determined expressed contributions,

wages. and

of voluntary

contributions and maximums

by the NAVOLrng as proportions

in the INPARM Lastly,

The minimums

of annual

wages.

a few plans did not specify The matching rates

the rate at which can be set via the terms, with ddllar-

they would match NAMATCH for-dollar The calculates.

mandatory

or voluntary file.

contributions. The rates

variables

in the INPARM as 100.

are given in percentage

matching INPARM

expressed variable

ANNTYPE

selects

the

type

of pension are calculated annuities;

annuity

the

program

When ANNTYPE

is set to 1, all pension benefits are calculated as either as two-life

as single life annuities; to 3, the the

when set equal benefit annuities

to 2, all benefits are calculated given

and when set equal depending on whether are selected,

single or joint life annuities file. If joint annuity

participant variable death.

is married-as CONTPMT

in the INDATA

life annuities payment

gives the proportion calculations

of the initial

continued

after the first

All annuity

are based on yearly

survival

probabilities,

which are determined files. were collected, two

by the sex and birth date of the participant To allow additional formulas. options When for changes are provided. this variable in pension

and spouse given in the INDATA plan provisions VESTYPE since these data

The variable is set equal substitutes

in the INPARM

file controls

the vesting

to 0 the program a “clift” formula, of years

uses the original

plan provisions; variable.

when set equal to 1, the program The VESTYRS variable

defined by the VESTYRS occurs.

gives the number whether

until full vesting

The second option When the to 0, no

allows users to determine variable mandatory MRAGE

the plan specified mandatory provisions

retirement

age is used. set equal

is set equal

to 1 the plan

are used,

and when

retirement

age is used in the calculations.

16

The final parameter most instances determine

in the INPARM variable benefit

file selects

the type of pension

benefit

to calculate.

In to

the PENTYPE

should be set equal to 0, alIowing based on age, years this parameter variable quit date of service,

the plan provisions and so forth. of benefits

the type of retirement

For the under

special cases of disability those circumstances. retirement variable

and survivor

benefits,

allows estimation

When benefits,

the PENTYPE using the

is set equal as the date

to 1, the program of disablement. benefits,

calculates When the

disability PENTYPE

is set equal to 2, the program

calculates

survivor

using the quit date 3.2,

as the date of the death of the participant. since this RUNTYPE is designed to generate

The PENTYPE estimates

option does not affect RUNTYPE types. will ever be adequate this, the program subgroups

of all pension

It may well be true that no one set of input estimation all participants estimate participants subgroups ‘ :dummy* file. under all retirement included circumstance.

parameters

for will of

To accommodate file for each replicate, sets of input the

only those cases

in the INDATA

so that

can be identified can be defined

and matched same

to different

parameters. use of the

The multiple $continue with

in the

INDATA

file through

command.

And with the use of the “*n option, all the output the program estimates can be tailored

can be written

to a single all

In this fashion,

to the requirements on a case by case basis.

of almost

situations,

even the extreme

of defining the input parameters

Pension

Plaits is based on simulated data cases, file. the program will generate estimates includes under

When analysis every pension pension

plans listed in the INPLAN

The default

file SPFN:INPLAN

all of the Using both under one

plans included in the sample. and INPLAN

Any subset

of plans can be included

in this file.

the INDATA pension

files allows the user to limit estimates simulated participant histories

to just one participant

plan, to as many

as desired

under all of the plans included

in the study. The IDS included in the file INPLAN “9” in column are the CODEID and the SEQ#. Each line in the file in column 2. plans have

must begin with the number Separated by blanks,

1 and any unique four digit index starting follow. All defined benefit pension

the CODEID

and the SEQ#

17

CODEID

numbers

under

3000, defined contribution have IDS starting

plans have IDS numbered at 5000.

in the 3000s

and

plans that combine both features

Valid Ranges The program valid ranges of data, checks all input data and parameter settings for valid ranges. The check for

will only detect gross errors

in the input data. by many

The program to be extreme

allows for a wide range values. This check in no For example, the %

including

levels that would be thought or accuracy 100 years

way insures

the reasonableness often cover

of the input data and parameters.

valid date ranges flagged parametir range.

or more, and only values outside When the program recoded encounters

this extended data

period are value or

by the program setting,

as invalid.

an invalid

that value is automatically the program

to a default

value that lies within the valid file. The valid ranges

When this occurs,

notes this problem

in the OUTERB

for the the parameter data are given

settings 4.

are given in Table 3, and the valid ranges Both tables include the recoded values

for the input participant automatically

in Table

the program

assigns

to input data falling outside of the valid range.

OUTPUT FILES

Data Files

OUTDATA format, represents entitlement participates. and the

represents

the name

of the file where per line. from

the program As with

will write data

output

in free line

with one participant/plan the estimated pension

combination entitlements

the input The total

file, each

a single plan.

household

pension or spouse

is thus the sum of entitlements And for estimates must of household

due under all plans in which the respondent pension Two wealth holding, estimatis programs,

for the respondent described below, are

spouse

also be combined.

special

utility

provided

to convert

these records.

One program

aggregates

participantlplan

data into one record records. When using

per person,

the other program

aggregates

the participant/plan when the pension

data into household program

The output

data file is always

emptied

is invoked.

18

Table 3 Valid Ranges for Input Parameter Settings

Variables

r

_

Valid Range Minimum Maximum

Outside Range Program Recode Value

SURVEYD TODAYD CP1rat.e INTrate INCrate SSWB SSWBrate ss SSrate QAGE MIN QAGE MAX QDATE MIN QDATE MAX SSPUrto MIN SSPUrto MID SSPUrto MAX SSJUrto MIN SSJUrto MID SSJUrto MAX SSPRrto MIN SSPRrto MID SSPRrto MAX SSJRrto M.IN SSJRrto MID SSJRrto MAX SSPDrto MIN SSPDrto MlD SSPDrto MAX SSJDrto MM SSJDrto MID SSJDrto MAX ssssrto MIN SSSSrto MID SSSSrto MAX BENMAX 55 BENMAX 65 SSCUT MIN SSCUT MAX PROFVOLl FORTVOLl PROFVOLZ FORTVOLZ PROFVOL3

1980.00 1980.00 - 25.00 0.00 - 20.00 1.00 - 20.00 1.00 - 20.00 16.00 16.00 1925.00 1925.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00

2000.00 2000.00 25.00 20.00 20.00 60000.00 20.00 30000.00 20.00 80.00 80.00 2075.00 2075.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 5.00 500000.00 500000.00 500000.00 500000.00 30.00 10.00 30.00 10.00 30.00

1983.50 1983.50 0.00 1.00 0.00 1.00 0.00 1.00 0.00 16.00 80.00 1925.00 2075.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 . 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 500000.00 500000.00 0.00 500000.00 5.00 0.50 5.00 0.50 5.00

19

Table 3 (continued)

Valid Range Variables Minimum FORTVOLS NACON NAMAN NAVOLrng NAVOLmg NAMATCH NAMATCH ANNTYPE CONTPMT VESTYPE VESTYRS MRAGE PENTYPE
0.00

Maximum
10.00

Outside Range Program Recode Value
0.50 5.00 5.00 0.00 0.00 100.00 100.00

0.00 0.00

MIN MAX MAN VOL

0.00 0.00 0.00 0.00

1.00 0.00 0.00 0.00 0.00 0.00

30.00 30.00 30.00 30.00 200.00 200.00 3.00 100.00 1.00 25.00 1.00 2.00

3.00 50.00 0.00 5.00 0.00 0.00

Table 4

Valid Ranges for Participant

Data Variables

Variables

T
Minimum

Valid Range Maximum

r

Outside Range Program Recode Value

SPOUSEBD SEX BIRTHD ‘ HIRED

0.00

Qm

WAGE WAGEG CRVOL

1.00 1880.00 BIRTHD+ 16 HIRED 1.00 1.00 - 20.00 0.00

2000.00 2.00 1970.00 BIRTHD+65 BIRTHD + 80 2080.00 1000000.00 20.00 30.00

BIRTHD 1.00 1950.00 BI.RTHD+ 20 BIRTHD + 65 2080.00 1.00 0.00 0.00

replicates, one output data file for each replicate is usually desired.

If the output data from the

second or succeeding replicates should be appended to the end of the first data output file specified,

20

use the symbol y*n instead

of the file name. that are written based are on actual shown into the OUTDATA participant 5. data Note file are defined by the with these given output quit dates

The type and order of variables RUNTYPE (RUNTYPE represent contain simulated specified.
1.21, the

For

analyses

output

variables combination,

in Table

variables record will of

one participant/plan up to eight repetitions data (RUNTYPE

and that the combined variable set.

person or household variables

of this output

The output

from analyses

4.2) are given in Table 6. Since each run allows up to five simulated up to five times on each data output due at all possible 7. Note that, future unlike line. When the program 3.21, the

data cases, this basic set is repeated calculates output the pension entitlements

quit dates

(RUNTYPE data

variables

are as shown

in Table

the above output

sets written case in a file

one case per line, this data series of contiguous from this RUNTYPE lines.

set is written When printed,

in blocks, giving all the data the output

for a particular

will occupy one page per case. for the full sample

The output

is very large, especially in the OUTDATA and years),

when generated file are numeric. the variable retirement, and

of cases. variables for

,411 the data entries are coded in natural defined benefit plans

While most of the output

units (dollars is coded

that represents 2 for late

the type of pension retirement, benefits. 3 for For

1 for normal

early defined of 12

retirement, contribution

4 for vested plans,

deferred,

5 for disability, For those

6 for survivor plans that

the variable

is coded 7.

pension

had a combination retirement,

defined benefit and defined contribution for late retirement, benefits, 13 for late retirement,

provisions,

the code 11 was used for normal deferred, 15 for disability,

14 for vested formulas

16 for survivor for

and 19 if only the contribution benefit,

were used.

If the participant

did not qualify assigns

any type of retirement

this variable generates

was set equal to 9. The program errors in calculations

the missing

data code of - 1 to any plan that data and assumptions. OUTTAB summary headings represents the

when combined

with the input

name

of the output that were

file to which used in that for obtaining

the

program

will display

a

of the estimation for the output

parameters

particular a printed

replication,

and text

data file.

This file is suitable

copy of the estimated

.

21

pension benefits for each case. Even if this type of printed output is not needed-if

the OUTDATA

file is read directly by an analysis program- the file name must still be specified, euen if assigned to “ dummy* OUTERR represents the file name to write the program produced summary of any suspect dollar figure calculations in any portion of the estimation procedures. This file name must be

present. The file contains short messages about potential problems, indicating the case IDS and a list of the data values. That a case has been flagged for inclusion in the problem file does not

necessarily mean that the calculated value for the participant is incorrect, but that in the calculation process there were some suspect intermediate results.

Table 5 Output Data File for Entitlement Estimates Based on Actual Participant Data with Given Quit Date (RUNTYPE 1.2)

Order

Name

Definition

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

HHIDX CODEID SEW SEX SPOUSEBD BIRTHD E QWAGE

QASY
PENTYPE PENAGE

‘ x6QW WYR
3oYR ANNUALA PRVALUE A65EQVL

SCF Household ID Pension Plan ID Pension Plan/Provider ID Sex of participant Birth da* of spouse, if married Birth date of participant Date participant began employment Date participant terminates employment Annual wage or salary at quit date Number of years covered at quit date Type of retirement benefit Age benefit payments begin Pension benefit as percent of final wages Proportion of final wages per service year Proportion of final wages for 30 years Initial annual pension benefit amount Present value of entitlement Equivalent annual amount if start at 65

I

22

Table 6 Output Data File for Entitlement Estimates Based on Simulated Participant Data (RUNTYPE 4.2)

Order

Name CODEID TYPE 7oQW %NR ANNUALA PRVALUE

Definition

Pension plan ID. Type of pension benefit Benefit as percent of final wages Percent final wages per service year Initial annual benefit amount Present value of entitlement

Table 7 Output Data File for Entitlement Estimates Based on Actual Participant Data Using All Potential Quit Dates (RUNTYPE 3.2)

Order

Name
QUITD QAGE QASY QWAGE SSB PENBEN PENTYPE VESTED BENAGE VEST65 . DABLEB DTYPE NRT LRT ERT VDT DRT . DST CNT

De&i tion

-

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

Date employment terminates Age at quit date Total service years at quit date Wage or salary at quit date Social Security benefit amount Pension benefit amount Type of retirement benefit Deferred vested benefit Age when benefits begin Vested benefit if begin at 65 Disability pension benefit Type of disability pension Normal retirement benefit Late retirement benefit Early retirement benefit Deferred vested retirement Disability retirement benefit Survivor retirement benefit Benefit based on contributions

.

I
23

DATA

BASE

UTILITY

PROGRAMS

The pension pension either

program

produces participate.

one data

record

for each will want

respondent

or spouse these

for each records to

plan in which they the level of persons

Most analysts depending for example,

to aggregate

or households

on the goals of the analysis. will want to aggregate

Analyses

focused potential

on the worker records for both programs (RUNTYPE

as the unit of analysis,

the several

for each individual. the respondent

When the household and spouse need

is the unit of analysis, Both

the pension of the special

entitlements conversion data

to be aggregated. 1.2.

were designed
4.2), there

to be used with RUNTYPE

When using simulated before analysis.

participant

is no need to covert or aggregate

records

Conversion

to Person Records

The public use file that This Pascal pension variables to four variable program converts amounts

contains

the program program

to create output the

person

records

is SPFN:PP.PEREC.

the pension for each

to one line per individual+ giving the individual participates. The output repeated (HHIDX). for up This

entitlement

plan

in which

are in the same form as from the pension potential pensions. The first variable

program,

with the information

on each

line is the ID variable 5 above-note

is then followed by the same variables at the start of each set. The program SCARDS=

listed in Table is invoked

that the ID variable

is repeated

by the following command: SPRINT=PERDATA program, and PERDATA is the newly

$RUN SPFN:PP.PER.EC where created the file OUTDATA data file.

OUTDATA

is the output

from the pension

Conversion

LO Homehold

Records

The

public

use

file

that

contains converts

the

program program

to

create output

household

records

is

SPFN:PP.HHREC. giving the pension pensions respondent,

This program entitlement

the pension

to one line per household, Up to eight potential applying to the ID

amounts

for both the respondent in groups

and spouse.

for each household and the second

are recorded to the spouse.

of four, with the first group

Each line of the new fiIe starts

with the household

24
(HHID, without the suffix),and is followed by UP to eight sets of pension entitlement amounts. Whenever a respondent or spouse did not have a pension or was not covered by additional plans, the variables are padded with zeros. The order of the variables in each of the eight sets is the

same as given in Table 5. The program is invoked by the following command: $RUN SPFN:PP.HHREC SCARDS =OUTDATA SPRINT = HHDATA

where the file OUTDATA is the output from the pension program, and HHDATA is the newly created data file. Both types of data records can be generated from the same pension output file by simply using both record conversion programs on the same file.

OSIRIS OUTPUT DATA FILE CREATION Dictionary Files

Several public files are made available on SPFN to facilitate analysis, and serve as an example of how to use the output from the pension program as input to widely available statistical software. With the use of the provided Osiris dictionary, the free format output from the pension Even if users

program can be read by Osiris, and the desired statistical analysis performed.

prefer other statistical packages, such as SPSS, SAS, or MIDAS, these software programs have commands that are specifically tailored to’read Osiris datasets. Thus only in situations where

Osiris datasets cannot be read by the user’ software program, would the user prefer the free s format version. Particularly helpful are the included variable names, -field widths, and missing

data codes that the Osiris dictionary provides. Since the output data set differs depending on the RUNTYPE and record structure, three different Osiris dictionaries are provided. The dictionaries are in the files: SPFN:OSDICTl for

actual participant data aggregated to person records; SPFN:OSDICT2 aggregated to the household level; and SPFN:OSDICT4

for actual participant data Table 8

for simulated participant data.

gives the dictionary records for data aggregated to person records.

The dictionaries include the

width of the variable, the number of decimal places, the type of data (character), and the first and second missing data codes. Table 9 shows the dictionary for the household records data base. sets of pension output variables, with each

Note th’ this dictionary includes 153 variables-eight at

I
25 set having 19 variables, plus the added ID. The dictionary records for the simulated data set are shown in Table 10. Source Files for Modification Since the provided dictionaries make no abowance for any pass through variables, the

command files which created these dictionaries are also available to users on a read only basis. These files can be copied, and edited to reflect the addition of the user selected pass through variables. The file names are similar to the above with an added suffix: and SPFN:OSDICT4.SOU. SPFN:OSDICTl.SOU,

SPFN:OSDICTP.SOU,

EXAMPLES OF COMMAND FILES The complete set of appropriate pension program commands, record conversion command, and Osiris commands are available in public use files for person records, household records, and simulate data. The commands necessary to estimate pension entitlements when using actual

participant data aggregated to person records are: $RUN SPFN:PP4.0 1.2 SPFN:INDATA.SCF SPFN:INPARM -0UTDATAl -OUTTABl -OUTERRl $ENDFILE $RUN SPFN:PP.PEREC SCARDS = -0UTDATA 1 SPRINT = -0UTPEDA 1 $RUN ISR:OSIRIS.IV SPRINT= -0UTOS 1 &FREE DICTIN = SPFN:OSDICTl DATAIN = -0UTPEDAl DICTOUT= -DI 1 DATAOUT = DA1 OSIRIS BUILD FOR PARTICIPANT DATA AGGREGATED TO PERSON RECORDS VARS=ALL &END &STOP The appropriate commands to use when estimates aggregated commands into household are: records are available are based on actual participant data These

in the public use file SPFN:RUNPP.HH.

$RUN SPFN:PPQ.O 1.2 SPFN:INDATA.SCF SPFN:INPARM -0UTDATA2 -0U’ ABZ -0UTERRL M’ $ENDFILE $RUN SPFN:PP.HHREC SCARDS=-OUTDATAP SPRINT=-0UTHHDA2 $RUN ISR:OSIRIS.IV SPRINT=-OUTOSZ &FREE DICTIN=SPFN:OSDICTZ DATAIN=-0UTHHDA2 DICTOUT=-D12 DA2 OSIRIS BUILD FOR ACTUAL PARTICIPANT DATA ON HOUSEHOLD BASIS

DATAOUT=-

26

VARS=ALL &END &STOP The commands needed to base estimates on simulated data and build an Osiris data base are as follows:

are included in the file SPFN:RUNPP.SIM.

The required

commands

$RUN SPFN:PPI.O 4.2 INDATASIM(100) SPFN:INPARM -0UTDAI -0UTTAB4 -0UTERR4 $ENDFILE $RUN ISR:OSIRIS.IV SPRINT = -0UTOS4 &FREE DICTIN = SPFN:OSDICT4 DATAIN = -0UTDA4 DICTOUT = -DI4 DATAOUT = -DA4 OSIRIS FILE BUILD FOR SIMULATED DATA VARS = ALL &END &STOP

PASCAL PROGRAM SOURCE FILES PP4.0 Source Code
The Pascal read-only versions knowledge phases, $RUN source code that was used to create the program file PP4.0 is provided on a

basis in several to meet any

files on SPFN. special analytic

Users may copy this source needs. Such an

code, and modify their own requires an extensive in three

undertaking

of the underlying

data bases and procedures.

The PP4.0

program

is compiled

using the following commands: “P.4SCAWB SCARDS =SPFN:CALCULATE O=PP4.0(LAST+ 1)

I=” PASCALJBINCLUDE PAR=NOCHK,OPT $RUN *PASCALJB SCARDS = SPFN:EVALUATE $RUN ‘ PASCALIB SCARDS=SPFN:OUTSIDE The above programs need The access file to three

0 = PP4.0(LAST+ 1) PAR=NOCHK,OPT O=PP4.O(LAST+ 11 PAR=NOCHK,OPT files: contains SPFN:CASES, a list of SPFN:CASES2, all valid case and IDS. plan. two or

input

SPFN:PROCEDURES. SPFN:CASESP Other than

SPFN:CASES

lists the case IDS for those plans which need to be integrated listed in this file, the total entitlement the sum of the individual received under

with another under

for the cases

due from coverage

more pension plans is simply benefits depended

plan entitlements.

Only those plans whose in the CASES2 file.

on the benefits

another

plan are included

The file SPFN:PROCEDURES Pascal procedures.
‘ Each

contains procedure

all the benefit represents

formulas

and plan provisions and benefit

in the form of formulas of one

the plan provisions

27

pension plan as a separate Prvcedums Source Code The Pascal available to users source

system

of equations.

code for the program As with

that

generated

the input

procedures

file is also program is

for modification.

the above

program,

the procedures

compiled in three steps, using the following commands: $RUN “PASCALJB $RUN “PASCALJB $RUN “PASCALJB After the above Pascal following commands: $RUN OBJ SERCOM=-ERR1 SPRINT=FOlWULAS SPUNCH= *DUMMY* O=PEN.DICT l=PEN.DATA 2=COUNT 3=PROBLEMS $RUN OBJ SERCOM = -ERR2 SPRINT =DATALIST O=PEN.DICT l=PEN.DATA PAR=LIST $RUN OBJ SERCOM = -ERR3 SPRINT= ‘ DUMMY * SPUNCH = PROCEDURES O=PEN.DICT l=PEN.DATA 2=*DUMMY’ 3=*DUMMY* The first command in a format variables program Each suitable that above causes for printing. the program to output a list of all formulas instructs data set. the program for each pension plan to output a list of all causes the plan. files: The SCARDS=SPFN:GENERATE O=OBJ(LAST+ SCARDS=SPFN:EMIT O=OB.Y(LAST+ lj SCARDS=SPFN:MISCELLANY O=OBJ(LAST+ object file has been compiled, the PROCEDURES 1) 1) file is generated by the

The second command from the pension

the program

accessed

The third command

to output

all benefit formulas is named by its

in the form of Pascal pension plan ID. The

procedures, programs

one for each pension require two input survey.

procedure

PEN.DICT output

and PEN.DATA,

the Osiris

dictionary

and data

files for the pension of formulas

files COUNT

and PROBLEMS

give a summary

of the number encountered.

and cases that

have been processed, Utilities Souse The Pascal to either

and a listing of any potential

problems

Code source code used to compile records is available the programs that convert participant/plan basis in the files: records

person or household

on SPFN on a read-only

SPFN:PP.PEREC.PAS SPFN:PP.HHREC.PAS Each of these programs is compiled separately, as follows: O=PP.PEREC O=PP.HHR.EC

$RUN ‘ PASCALJB SCARDS=SPFN:PP.PERREC.PAS $RUN *PASCALJB SCARDS=SPFN:PP.HHREC.PAS

28

ONLINE DOCUMENTATION The contents the name of the document you are reading, as well as a shorter are available document which gives Simply edit or

and a brief description

of all public files,

to users online.

copy the files SPFN:PP4.DOC

or SPFN:PP.FILES.

AVAILABILITY All the pension other computer for magnetic Archive. Pascal program files available

TO NON-MTS on SPFN

USERS via telephone facilities. Study lines to Bequests Program of

can be transmitted

sites, or copied to magnetic tapes should be dire&d system

tape and mailed to other computer Research Center,

to the Survey operates

Pension

The MTS computer used is a product PascaVVS,

on an IBM 3090-400 Software, Inc.

mainframe. is very

The version similar

of Plug Compatible but has a capacity

This version

to the

IBM version,

for larger.programs. at least

When the program of main

is compiled memory to

to include, all pension execute. included

plan

formulas,

it requires

3.5 megabytes

The size of the object program in the compiled version,

can be controlled

by limiting

the number

of pension

plans size

and using multiple only one pension

versions plan-would

of the program.

The minimum 250K.

of the compiled program-including

be approximately

29

Table 8 OSIRIS Dictionary for Actual Participant Data Formatted as Person Records Vai# Vl VlOl V102 v103 v104 v105 V106 v107 V108 v109 VllO Vlll v112 v113 v114 V115 V116 v117 I’ ll8 v119 v201 v202 V203 V204 V205 V206 V207 V208 V209 V210 v211 v212 V213 V214 v215 V216 v217 V218 v219 v301 V302 v303 v304 v305

Name HHIDX Rl:HHIDX Rl:CODEID Rl:SEQ# Rl:SEX Rl:SPOUSEBD Rl:BIRTHD Rl:HIRED Rl:QUITD Rl:QWAGE Rl:QAGE R1:QASY RlPTYPE Rl:PAGE Rl:%QW Rl:%/YR R1:SOYR Rl:PENSION Rl:PRVALUE Rl:A65EQIV R2:HHIDX R2:CODEID RP:SEQ# R2:SEX R2:SPOUSEBD R2:BIRTHD R2:HIRED R2:QUTTD R2:QWAGE R2:QAGE R2:QASY R2:pTypE R2:PAGE R2:%Qw R2:%lYR R2:3oYR R2:PENSION R2:PRVALUE R2:A65EQIV R3:HHIDX R3:CODEID R3:SEQ# R3:SEX R3:SPOUSEBD

Width 5 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4 4 1 7

Ndec 0 0 0 0 0 2 2 2 2 2 2 2 0 2 2 2 2 2 2 2 0 0 0 0 2 2 2 2 2 2 2 0 2 2 2 2 2 2 2 0 0 0 0 2

TYP

MD1

MD2

C C C :

0
0 0 0 0

-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

C
C :

-1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

c” :
C C C

.

:
C C C

E c” c”
C C C

:
C C

c” c” : c”
C C

-.

30 Table 8 (continued)

Var# V306’ v307 V308 v309 v3 10 v311 V312 v313 v314 v315 V316 v317 V318 v319 v401 V402 v403 v404 v405 V406 v407 V408 v409 v410 V411 V412 v413 v414 v415 V416 v417 V418 v419

Name R3:BIRTHD R3:HIRED R3:QUITD R3:QWAGE R3:QAGE R3:QASY R3:PTYPE R3:PAGE RS:%QW R3:%NR R3:30YR R3:PENSION R3:PRVALUE R3:A65EQIV R4:HHIDX R4:CODEID RI:SEQ# R4:SEX . R4:SPOUSEBD R4:BIRTHD R4:HIRED R4:QUITD R4:QWAGE R4:QAGE R4:QASY R4:PTYPE R4:PAGE RQ:%QW R4:%NR R4:30YR R4:PENSION R4:PRVALUE R4:A65EQIV

Width 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6 6 10 11 10

Ndec 2 2 2 2 2 2 0 2 2 2 2 2 2 2 0 0 0 0 2 2 2 2 2 2 2 0 2 2 2 2 2 2 2

Type
C C C C C C C C C C C C C C

MD1
0 0 0 0 0 0 0 0 0 0 0 0 0

MD2 .-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

0 0
0 0 0

:
C C C C C C C

-1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

.C
C C C C C C C C C

31

Table 9 OSIRIS Dictionary for Actual Participant Data Formatted as Household Records Name HHID Rl:HHIDX Rl:CODEID Rl:SEQ# Rl:SEX Rl:SPOUSEBD R 1:BIRTHD Rl:HIRED R1:QUITD Rl:QWAGE Rl:QAGE R1:QASY Rl:PTYPE Rl:PAGE Rl:%QW Rl:‘ %/YR R1:30YR Rl:PENSION R1:PRVALUE Rl:A65EQIV R2:HHIDX R2:CODEID R2:SEQ# R2:SEX R2:SPOUSEBD R2:BIRTHD R2:HIRED R2:QUITD R2:QWAGE R2:QAGE R2:QASY R2:PTYPE R2:PAGE R2:%QW R2:%NR R2: 30YR R2:PENSION R2:PRVALUE R2:A65EQIV R3:HHIDX R3:CODEI.D R3:SEQ# R3:SEX R3:SPOUSEBD

Var# Vl VlOl V 102 v103
v104 v10.5

Width

Ndec 0 0 0 0 0 2 2 2 2 2 2 2 0 2. 2 2 2 2 2 2. 0 0 0 0 2 2 2 2 2 2 2 0 2 2 2 2 2 2 2 0 0 0 0 2

Type
C C C

MD1

_ MD2

V106 v107 V108 v109 VllO Vlll v112 v113 v114 v115 V116 v117 V118 v119 v201 v202 V203 V204 v205 V206 v207 V208 v209 v210 v211 v212 V213 V214 V215 V216 V217 V218 V219 v301 V302 v303 v304 v305

4 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4 4 1 7

:
C C

C C C C C

c

c

C C C C C C C C C C : C C C C : C

C
C C C C C C C : C

0 0 0 0 0 -1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1

-1

-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 .- 1 -1 -1 -1 -1

32

Table 9 (continued)

VanY V306 v307 V308 v309 v310 v311 V312 v313 v314 v315 V316 v317 V318 v319
v401 V402 v403 v404 v405 V406 v407

Name R3:BIRTHD R3:HIRED R3:QLJITD R3:QWAGE R3:QAGE R3:QASY R3:PTYPE R3:PAGE RB:%QW R3:%NR R3:30YR R3:PENSION R3:PRVALUE R3:A65EQIV R4:HHIDX R4:CODEID R4:SEQ# R4:SEX R4:SPOUSEBD R4:BIRTHD R4:HIRED R4:QUITD R4:QWAGE R4:QAGE R4:QASY R4:PTYPE R4:PAGE R4:%QW R4:ZNR R4:30YR R4:PENSION R4:PRVALUE R4:A65EQIV S 1:HHIDX S 1:CODEID S l:SEQ# Sl:SEX Sl:SPOUSEBD S 1:BIRTHD Sl:HIRED S 1:QUITD S 1:QWAGE S 1:QAGE S 1:QASY S M’ TYPE S l:PACE S M’ oQW S l:%NR

Width 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6

Ndec 2 . 2 2 2 2 2 0 2 2 2 2 2 2 2 0 0 0 0 2 2 2 2 2 2 2 0 2 2 2 2 2 2 2 0 0 0 0 2 2 2 2 2 2 2 0 2 2 2

Type
C C C C

MD1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 0 0 0 0 0 0 0 0 0 0

MD2 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1. -1 -1 -1 -1 -1

:
C C C

:
C C C C C

.

: :
C C C C C C C C C C C C C C C C C C C C C

V408 v409 v410 v411 V412 v413 v414 v415 V416 v417 V418 v419 v501 v502 v503 v504 v505 V506 v507 V508 v509 v510 v511 V512 v513 v514 v515

-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

:
C C C

:

-1 -1 -1 -1 -1 -1 -1 -1 -1 -1

33 Table 9 (continued)

Var# V516 v517 v51s V519 V601 V602 V603 V604 V605 V606 V607 V608 V609 V610 V611 V612 V613 V614 V615 V616 V617 V618 V619 v701 V702 v703 V704 V705 V706 v707 V708 v709 v710 v711 v712 v713 v714 V715 V716 v717 V718 v719 V801 V802 V803 V804 V805 V806

Name Sl:SOYR S l:PENSION S l:PRVALLJE Sl:A65EQIV S2:HHIDX S2:CODEID S2:SEQ# S2:SEX S2:SPOUSEBD S2:BIRTHD S2:HIRED S2:QUITD S2:QWAGE S2:QAGE S2:QASY S2:PTYPE S2:PAGE SZ:%QW S2:%lYR S2:30YR S2:PENSION S2:PRVALUE S2:A65EQIV S3:HHIDX S3:CODEID S3:SEQ# S3:SEX S3:SPOUSEBD S3:BIRTHD S3:HIRBD S3:QUITD S3:QWAGE S3:QAGE S3:QASY S3:PTYPE S3:PAGE S3:%QW S3:%NR s3:3oYR S3:PENSION S3:PRVALUE S3:A65EQIV S4:HHIDX S4:CODEI.D S4:SEQ# S4:SEX S4:SPOUSEBD S4:BIRTHD

Width 6 10 11 10 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4 4 1 7 7 7 7 11 6 6 2 6 6 6 6 10 11 10 5 4
4

Ndec 2 2 2 2 0 0 0 0 2 2 2 2 2 2 2 0 2 2 2 2 2 2 2 0 0 0 0 2 2 2 2 2 2 2 0 2 2 2 2 2 2 2 0 0 0 0 2 2

Type
C C C C C C C C C C C C C C C

MD1 0 0 0 0 0 0 0 0 -1 0 0 0 0 0 ‘ 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 0

MD2 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

:
C C C C C C C C C C C C C C C C C C C C C C

:
C

-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

: :
C C

1 7 7

-1

34

Table 9 (continued)

Vati
V807 V808 V809 V810 V811 V812 V813 V814 V815 V816 V817 V818 V819

I
~

Name

I

Width
7 7 11 6 6 2 6 6 6 6 10 11 10

Ndec 2
2

-Type C C C C C C C C C C C C C

MD1 0 0 0 0 0 0 0 0 0 0 0 0 0

MD2
-1 -1

S4:HIRED S4:QUITD S4:QWAGE ~ S4:QAGE S4:QASY S4:PTYPE S4:PAGE S4:kQW S4:%NR S4:30YR S4:PENSION S4:PRVALUE S4:AGjEQIV

2 2 2
0

.- 1
-1 -1 -1 -1 -1

2 2 2 2 2 2 2

-1

-1 -1 -1

-1

.

35

Table 10 OSIRIS Dictionary for Simulated Data Formatted as Pension Plan Records

Vai#

Name

Width

Ndec

Type
C C C C C C C C C C

MD1

MD2

Vl VlOl v102 v103 v104 v105 V201 v202 V203 V204 V205 v301 V302 v303 v304 v305 1’ 401 V402 v403 v404 v405 v501 V502 v503 v504 V505

CODEID 1ST PTYPE 1ST %QW 1ST %/YR 1ST PEN AMT 1ST P. VALUE 2ND PTYPE 2ND ‘ %QW 2ND %NR . 2ND PEN AMT 2ND P.VALUE 3R.D PTYPE 3RD %QW 3RD %NR

3RD 3RD 4TH 4TH 4TH 4TH 4TH 5TH 5TH 5TH 5TH 5TH

PEN AMT P.VALUE PTYPE %QW %NR PEN AMT P.VALUE PTYPE %QW %NR PEN AMT P.VALUE

4 1 6 6 10 11 1 6 6 10 11 1 6 6 10 11 1 6 6 10 11 1 6 6 10 11

0 0 2 2 2 2 0 2 2 2 2 0 2 2 2 2 0 2 2 2 2 0 2 2 2 2

C C C : C
C

c .

C C C C C C C C

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

-1 -1 -1 -1 -1 -1 -1 - 1-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1