Return to PSG Models documentation page

GEMINI output file .XSB

--- .XSB file contains cross-sectional survey information for cohort sample
         members who are alive and are native-born or have immigrated by
         survey time, where the survey information is gathered in
         STATS.xsb_year, using supplementary questions in STATS.xsb_suppl,
         only if STATS.xsb_olc is true and if operating in OLC mode.
    IMPORTANT NOTE: If STATS.xsb_olc is true, be sure to combine the
         many xsbNNNNN.YYY files into a single runNNNNN.xsb file using
         the "GEMINI Data" capabilities of the EDA Toolkit (or use the
         xsall utility to produce the xsbNNNNN.all file with exactly
         the same contents as the runNNNNN.xsb file).

The GEMINI runNNNNN.xsb file has no heading lines and no summary 
lines.  Individual survey results are written to a tab-delimited
file that has one row per person interview, making the survey
results file suitable for tabulating with an AWK program.
NOTE: the runNNNNN.xsb file must be constructed from the
component cohort files named xsbNNNNN.YYY using the "GEMINI Data"
capabilities in the EDA Toolkit for GEMINI or the xsall utility.

>>> IMPORTANT NOTE: the runNNNNN.xsb file never contains
                    individuals born before 1935.

FORMAT OF INDIVIDUAL SINGLE-ROW RECORD:
------------------------------------------------------------------------------
**** CORE SURVEY QUESTIONS
------------------------------------------------------------------------------
**** Core statistics are statistics for the xsb_year, many of which are the
**** the same as statistics in the .sum output file or the relevant age line
**** in the .adq output file.  The square bracket information indicates 
**** whether the statistic is the same as a statistic in one of those files.
( 1) scenario: (positive integer) [sum:1]
( 2) indiv id: (positive integer) [sum:2]
( 3) indiv gender: 1=female, 0=male [sum:3]
( 4) indiv highest lifetime schooling: [sum:4]
            0 = never in high school,  1 = high school attended,
            2 = high school completed, 3 = college attended,
            4 = four-year college degree or graduate degree
( 5) indiv annual total earnings (thousands of nominal dollars) [adq:5]
( 6) im_age: indiv immigration age (0 ==> native-born indiv) [sum:24]
( 7) em_age: indiv emigration age [sum:25]
( 8) docage: indiv age at which gains USA immigration documentation [sum:43]
( 9) indiv xsb age: indiv age when xsb cross-section survey conducted
(10) indiv marital status [adq:1]
            0 = never married (marriage defined as lasting at least 0.5 year)
            1 = divorced (with no marriage lasting ten+ years so far)
            2 = divorced (with one+ marriage lasting ten+ years so far)
            3 = married
            4 = widowed (from most recent marriage)
(11) indiv family equivalence scale (adult equivalents in family) [adq:9]
            NOTE: determined by family composition and specified values of
            the STATS.equivs_p, STATS.max_k_age, and STATS.equivs_f parameters.
(12) couple annual total earnings (thousands of nominal dollars) [adq:6]
(13) indiv annual pretax OASDI benefit (thousands of nominal dollars) [adq:2]
NOTE that statistics 14-16 classify people using the SSA primary-benefit rule.
(14) number of OAI beneficiaries receiving the indiv OASDI benefit in (13)
(15) number of  SI beneficiaries receiving the indiv OASDI benefit in (13)
(16) number of  DI beneficiaries receiving the indiv OASDI benefit in (13)
NOTE that statistics 14-16 classify people using the SSA primary-benefit rule.
(17) couple annual pretax OASDI benefit (thousands of nominal dollars) [adq:4]
(18) indiv annual pretax employer-sponsored pension benefit (ditto) [adq:7]
(19) couple annual pretax employer-sponsored pension benefit (ditto) [adq:8]
(20) indiv annual pretax OASDI-covered earnings (thousands of nominal dollars)
(21) couple annual pretax OASDI-covered earnings (thousands of nominal dollars)
(22) indiv annual OASDI-taxable earnings (thousands of nominal dollars)
(23) couple annual OASDI-taxable earnings (thousands of nominal dollars)
(24) indiv adq-file benefit type (value 0 through 9) [adq:3]
------------------------------------------------------------------------------
END OF CORE SURVEY QUESTIONS
------------------------------------------------------------------------------
++++ SUPPLEMENT 1 QUESTIONS for OAI recipients:
---------------------------     ^^^^^^^^^^^^^^
++++ the OAI-recipient supplement:
++++ questions posed only to indiv with (24) equal to 1, 2, or 3.
(25) number of people getting OAI benefits (regardless of primary-benefit type)
(26) number of kids getting OAI benefits
(27) kids OAI benefits included in core statistic 13 (same units as 13)
------------------------------------------------------------------------------
++++ SUPPLEMENT 2 QUESTIONS for SI recipients:
---------------------------     ^^^^^^^^^^^^^
++++ the SI-recipient supplement:
++++ questions posed only to indiv with (24) equal to 4, 5, 6, or 9.
(25) number of people getting SI benefits (regardless of primary-benefit type)
(26) number of kids getting SI benefits
(27) kids SI benefits included in core statistic 13 (same units as 13)
------------------------------------------------------------------------------
++++ SUPPLEMENT 3 QUESTIONS for DI recipients:
---------------------------     ^^^^^^^^^^^^^
++++ the DI-recipient supplement:
++++ questions posed only to indiv with (24) equal to 7 or 8.
(25) do_age: disability onset age (999 ==> no onset) [sum:16]
(26) dr_age: disability recovery age (999 ==> no recovery) [sum:17]
(27) first age at which received DI benefits (should never be negative)
(28) kids DI benefits included in core statistic 13 (same units as 13)
------------------------------------------------------------------------------
++++ SUPPLEMENT 4 QUESTIONS for ALL individuals:
---------------------------     ^^^^^^^^^^^^^^^
++++ the federal income tax supplement (see PENSIM Overview, Chapter 7):
++++ questions posed to all individuals included in output file.
(25) income tax filing status:
       -1 = not a tax unit because is a dependent on another tax return,
        0 = single (apply unit weight in income tax tabulations),
        1 = married filing jointly (apply half weight in tabulations),
        2 = head of household (apply unit weight in tabulations).
          The parenthetical statements above are instructions about
          how to tabulate aggregate tax-return statistics from a GEMINI
          cross-sectional sample of individuals; failing to apply a
          one-half (0.5) weight to individuals who file jointly will result
          in the double counting of joint tax units.
(26) tax unit is nonfiler (0=no, 1=yes).
     NOTE: can be nonfiler because of -1 filing status or low income.
     IMPORTANT NOTE: ignore any non-zero tax statistics for a nonfiler.
(27) elderly tax unit with at least one person age 65+ (0=no, 1=yes).
(28) nominal annual AGI of individual's tax filing unit ($K).
(29) nominal annual OASDI benefit included in AGI ($K).
(30) nominal annual federal income tax liability ($K).
(31) nominal annual EITC included in tax liability ($K).
(32) number of EITC-qualified kids in individual's tax filing unit.
(33) nominal annual savers credit paid to individual's tax filing unit ($K).
(34) filing unit has positive OASDI income this year (0=no, 1=yes).
(35) filing unit has positive DI income this year (0=no, 1=yes).
(36) nominal annual imputed divinc this year ($K); details in PENSIM Overview.
(37) nominal annual imputed capinc this year ($K); details in PENSIM Overview.
(38) nominal annual imputed munint this year ($K); details in PENSIM Overview.
(39) nominal annual imputed businc this year ($K); details in PENSIM Overview.
(40) nominal annual imputed uicomp this year ($K); details in PENSIM Overview.
(41) nominal annual OASDI payroll tax credit included in tax liability ($K).
(42) nominal annual family employee DC pension contribution ($K).
(43) nominal annual family employer DC pension contribution ($K).
------------------------------------------------------------------------------