CPS Veterans Supplement (KV) kv.txt Section Listing 1. Survey Definition 2. FTP files listed in the survey directory. 3. Time series, series file, data file, & mapping file definitions and relationships 4. Series file format and field definitions 5. Data file format and field definitions 6. Mapping file formats and field definitions 7. Data Element Dictionary ================================================================================ Section 1 ================================================================================ Section 1 (Veterans) The Veterans Supplement provides estimates on the demographic and labor force characteristics of veterans 18 years old and over, including those who have a service-connected disability. The data also will identify Gulf War era veterans and Vietnam theater veterans--those who actually served in Vietnam, Laos, or Cambodia. Estimates of the number of veterans with and without a service-connected disability along with their labor force participation rates, occupational distributions, unemployment rates, periods of military service, and use of certain educational and job training programs are provided. Data are provided on labor force activity for the week prior to the survey. Comprehensive data are available on the employment status, occupation, and industry of persons 18 years old and over. Also shown are personal characteristics such as age, sex, race, marital status, veteran status, household relationship, educational background, and Hispanic origin. ================================================================================== Section 2 ================================================================================== The following CPS Veterans Supplement files are on the BLS internet in the sub-directory pub/time.series/kv/: kv.ages - Age codes mapping file kv.clas - Class of worker on primary job codes mapping file kv.data.1.All - All data kv.footnote - Detailed definition of the footnote codes mapping file kv.indy - Industry codes mapping file kv.lfst - Labor force status codes mapping file kv.pcts - Percents and rates codes mapping file kv.rsng - Reserve or National Guard status codes mapping file kv.scdr - Service-connected disability rating codes mapping file kv.series - All series and their beginning and end dates kv.sexs - Sex codes mapping file kv.tdat - Type of data codes mapping file kv.txt - General information kv.vets - Veterans status codes mapping file ================================================================================= Section 3 ================================================================================= The definition of a time series, its relationship to and the interrelationship among series, data and mapping files is detailed below: A time series refers to a set of data observed over an extended period of time over consistent time intervals (i.e. monthly, quarterly, semi-annually, annually). BLS time series data are typically produced at monthly intervals and represent data ranging from a specific consumer item in a specific geographical area whose price is gathered monthly to a category of worker in a specific industry whose employment rate is being recorded monthly, etc. The FTP files are organized such that data users are provided with the following set of files to use in their efforts to interpret data files: a) a series file (only one series file per survey) b) mapping files c) data files The series file contains a set of codes which, together, compose a series identification code that serves to uniquely identify a single time series. Additionally, the series file also contains the following series-level information: a) the period and year corresponding to the first data observation b) the period and year corresponding to the most recent data observation. The mapping files are definition files that contain explanatory text descriptions that correspond to each of the various codes contained within each series identification code. The data file contains one line of data for each observation period pertaining to a specific time series. Each line contains a reference to the following: a) a series identification code b) year in which data is observed c) period for which data is observed (A01 indicate annual averages) d) value e) footnote code (if available) ================================================================================= Section 4 ================================================================================= File Structure and Format: The following represents the file format used to define kv.series. Note that the Field Numbers are for reference only; they do not exist in the database. Data files are in ASCII text format. Data elements are separated by spaces; the first record of each file contains the column headers for the data elements stored in each field. Each record ends with a new line character. Field #/Data Element Length Value(Example) 1. series_id 19 KVU0101000000000124 2. seasonal 1 U 3. measure_type_code 1 - 4. measure_unit_code 1 - 5. measure_multiplier_code 1 - 6. publication_flag 1 P 7. footnote_codes 1 8. lfst_code 2 01 9. series_title 250 Civilian noninstitutional population, Veterans, Men 10. ages_code 3 00 11. clas_code 2 00 12. indy_code 4 0000 13. pcts_code 2 00 14. rsng_code 2 00 15. scdr_code 2 00 16. sexs_code 1 1 17. tdat_code 2 00 18. vets_code 2 00 The series_id (KVU0101000000000124) can be broken out into: Code Value survey abbreviation = KV seasonal (code) = U lfst_code = 01 sexs_code = 01 race_code = 00 ethnicity_code = 00 locality_code = 00 last 6 non unique = 000124 ================================================================================== Section 5 ================================================================================== File Structure and Format: The following represents the file format used to define each data file. Note that the field numbers are for reference only; they do not exist in the database. Data files are in ASCII text format. Data elements are separated by spaces; the first record of each file contains the column headers for the data elements stored in each field. Each record ends with a new line character. The kv.data file is partitioned into two separate files: OR -- The kv.data file is one file: 1. kv.data.1.AllData - All data The above-referenced data files have the following format: Field #/Data Element Length Value(Example) 1. series_id 19 KVU0101000000000124 2. year 4 2023 3. period 3 A01 4. value 12 15836 5. footnote_codes 1 - ================================================================================ Section 6 ================================================================================ File Structure and Format: The following represents the file format used to define each mapping file. Note that the field numbers are for reference only; they do not exist in the database. Mapping files are in ASCII text format. Data elements are separated by tabs; the first record of each file contains the column headers for the data elements stored in each field. Each record ends with a new line character. File Name: kv.ages Field #/Data Element Length Value(Example) 1. ages_code 2 00 2. ages_text 100 Text File Name: kv.clas Field #/Data Element Length Value(Example) 1. clas_code 2 00 2. clas_text 100 Text File Name: kv.footnote Field #/Data Element Length Value(Example) 1. footnote_code 2 00 2. footnote_text 100 Text File Name: kv.indy Field #/Data Element Length Value(Example) 1. indy_code 4 0000 2. indy_text 100 Text File Name: kv.lfst Field #/Data Element Length Value(Example) 1. lfst_code 2 01 2. lfst_text 100 Text File Name: kv.pcts Field #/Data Element Length Value(Example) 1. pcts_code 2 00 2. pcts_text 100 Text File Name: kv.rsng Field #/Data Element Length Value(Example) 1. rsng_code 2 00 2. rsng_text 100 Text File Name: kv.scdr Field #/Data Element Length Value(Example) 1. scdr_code 2 00 2. scdr_text 100 Text File Name: kv.sexs Field #/Data Element Length Value(Example) 1. sexs_code 1 0 2. sexs_text 100 Text File Name: kv.tdat Field #/Data Element Length Value(Example) 1. tdat_code 2 00 2. tdat_text 100 Text File Name: kv.vets Field #/Data Element Length Value(Example) 1. vets_code 2 00 2. vets_text 100 Text ========================================================================================= Section 7 ========================================================================================= CPS Veterans Supplement (KV) DATABASE ELEMENTS Data Element Length Value(Example) Description ages_code 2 00 Code identifying age groups. ages_text 100 Text Text identifying age groups. begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. clas_code 2 00 Code identifying class of worker on primary job. clas_text 100 Text Text identifying class of worker on primary job. begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. footnote_code 2 00 Code identifying footnote. footnote_text 100 Text A detailed text definition of the footnote. begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. indy_code 4 0000 Code identifying the type of industry. indy_text 100 Text Text identifying type of industry. begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. lfst_code 2 01 Code identifying the labor force staus. lfst_text 100 Text Text identifying labor force staus. begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. pcts_code 2 00 Code specifying the type of percents or rates pcts_text 100 Text Text specifying the type of percents or rates begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. rsng_code 2 00 Code identifying Reserve or National Guard status rsng_text 100 Text Text identifying Reserve or National Guard status begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. scdr_code 2 00 Code identifying the service-connected disability rating scdr_text 100 Text Text identifying the service-connected disability rating begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. sexs_code 1 0 Code identifying sex sexs_text 100 Text Text identifying sex begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. tdat_code 2 00 Code identifying the type of data tdat_text 100 Text Text identifying the type of data begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series. vets_code 2 00 Code identifying the veterans status vets_text 100 Text Text identifying the veterans status begin_period 3 A01 Identifies first data observation (A=Annual) within the first year for which data is available for a given time series. begin_year 4 YYYY Identifies first year for which Ex: 2023 data is available for a given time series.