Telcordia™ TPM™ DATA SOURCE Data Set / File Specifications 10-15-03 This document contains data set / file specifications for the Telcordia™ TPM™ Data Source as provided on CD ROM, magnetic tape, and transmitted via electronic data transfer, as of the date indicated above. File layouts are those associated with the fixed formatted data files provided in the TPM. For further information, call the Telcordia ™ Routing Administration (TRA) Customer Service Center on 732-699-6700. This document may also be downloaded at www.trainfo.com (documents). Telcordia and TPM Data Source are trademarks of Telcordia Technologies, Inc. Copyright© 1994-2003 Telcordia Technologies, Inc. All Rights Reserved Issue date: 06/15/03 TPM – Flat File Information - History The following identifies previous issues of these specifications in this format and identifies pertinent changes associated with each issuance of this document. Note that the “issue date” need not be the same as the “effective date”. Since specifications often need to be issued with sufficient lead-time to permit review, cosmetic changes, error corrections, and/or possible pertinent changes may occur before a “final” version can be solidified. If you are concerned as to whether you have the latest version of this document, please call TRA on (732) 699-6700 or check www.trainfo.com, where you can also download copies of these specifications. Effective Date 07/01/95 12/15/95 03/15/96 10/15/97 04/15/98 01/15/99 07/15/99 07/15/00 01/15/03 10/15/03 Changes Initial specs in this format - Inclusion of "activity" and "master" files into a single TPM product - Updates to Glossary (CO TYPE, NXXTYPE) and various clarifications. - Introduction of SCAN as a viewer for diskette data. - Revisions to naming of supporting diskette files (e.g. "read me"). - COUNTREC.EXE added to diskette. - No structural file changes - supports the incorporation of the VHCD and TPM (previously separate outputs) - The VHCD BCR MASTER .NPANXX tape dataset becomes BCR.TPM.MASTER - The VHCD NXXMSTR.DAT diskette file becomes TPM.DAT - The VHCD BCR.ACTVTY.NPANXX tape dataset becomes BCR.TPM.ACTVTY - The VHCD NXXACTVY.DAT diskette file becomes TPMACT.DAT - Glossary/specs files added to disk and tape - OCN file updated to include CO TYPE, Bill to RAO, Send to RAO - TPMEND file added to note the product date and to provide a listing of file record counts for reconciliation purposes - Inclusion of Portability Indicator on TPM, TPMACT, and MINORVH files - Addition of PLNAME file - Inclusion of files associated with CD ROM version - Inclusion of RAO file - Inclusion of Pooling Indicator on TPM, TPMACT, and MINORVH files - Addition of TBP file - Removal of Special Rating Indicator and “Actual NPA for Non-Mexican "Other Place"” NPA fields from TPM and MINORVH files - Expansion of fields in TBP file to those in TPM.DAT; addition of Rate Center name information and RC file; addition of AOCN data field in TBP file - Removal of diskette media notations to support earlier discontinuance - Addition of TBPACT.DAT - Addition of TPMAPP02.MDB (CD only) TPM™ Data Source Dataset and File Record Layouts – 10/15/03 Product Description: Telcordia Routing Administration (TRA) ((732) 699-6700) provides The Telcordia™ TPM™ Data Source in support of systems used in rating telephone calls and other processes that involve the NPA NXX data it contains. The TPM is provided monthly as data files in a magnetic tape format and on CD ROM. The CD ROM version contains an additional Microsoft Access® version of the data. Electronic transmission of data files via Network Data Mover (NDM) (aka Connect:Direct®) is also available under certain conditions. File Descriptions: This document provides detailed record layouts of the files provided on the TPM data file products. Tape and CD ROM data file versions are essentially identical in terms of data content and file layout. Brief field descriptions and a listing of coded values used in certain fields are provided in Appendix A-1 (GLOSSARY file). The definitions and values are subject to clarification and other changes on an ongoing basis. The sequence of file layouts in this document follows the sequence of files on the TPM tape. The Last Change dates in the file description headers in this document refer to when the file was last structurally changed, or alternatively, first appeared. Dates of 1990 are used as defaults since tracking did not occur prior to that date. Structural changes would include the addition or removal of fields either physically, or though redefinition of filler space as well as the redefinition of a field. Wording changes done to clarify existing fields will not, of and by themselves, generate a "Last Change" date. Please note the following: Appendix A-1 to this document (GLOSSARY file), available at www.trainfo.com (documents) provides a brief description of most fields, as well as a listing of specific field values (or other qualifiers) when reasonable and applicable. The TPM contains both "primary" (master) files of NPA NXX data (TPM.DAT and TBP.DAT) as well as a subset of the primary file, called an "activity" file (TPMACT.DAT and TBPACT.DAT) of NPA NXX data. The primary and respective activity files are structured identically. All data records found in the "activity" file are also found in the "primary" file. The TBP files contain the same basic information as the TPM files plus some additional data fields and a more detailed level of data (Thousands Blocks within an NXX). Note that Special Calling Card (SCC) (NXXTYPE = 14) records appear only in the TPM files (SCC data however is also provided in the SCC.DAT file). In the TBP files, the equivalent TPM.DAT records are identified with BLOCK ID = A. In addition, where an NPA NXX is further broken down into Thousands Blocks, the TBP files contain information for records identified with BLOCK ID = 0-9 (note that not all 10 blocks may be assigned and thus a record for each of the potential 10 blocks under an NPA NXX may not be provided). Dataset BCR.MINOR.VH (file MINORVH.DAT) is structured identical to the TPM.DAT "master" file with the exception that the "minor" V&H fields have been appended to the end of the record. Only those records containing nonzero minor V&H data are included in this dataset / file. This file should be considered as an “extension” of the data in the “master”, not as different records from the “master”. Note that unless the change has to do directly with minor V&Hs, the change code in this file should be the same as that in the “master” file. Note: Products are shipped (and should be received) approximately 2-3 weeks before the "product" date. Issue Date: 6/15/03 TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 Page 1 of 9 General Information: Tape CD ROM Standard IBM Label 9 Track, 1600bpi EBCDIC recording Volser = TPmmyy (mmyy is the product date) External label shows the volser and product date matching the internal HDR and VOL label. DOS formatted CD ROM ASCII / Access Tape Dataset Name (in sequence order) Tape BLKSIZE Data LRECL CD ROM Filename General Description BCR.COPY.RIGHT BCR.TPM.MASTER BCR.TPM.ACTVTY BCR.NUMBER.SCC BCR.NUMBER.OCN BCR.NUMBER.CIID BCR.MINOR.VH BCR.PLNAME.DAT BCR.NUMBER.RAO BCR.TBP.DAT 4000 4000 4000 3000 4200 3840 4500 6208 6000 6050 80 80 80 30 42 256 90 64 500 110 COPYRGHT.DAT TPM.DAT TPMACT.DAT SCC.DAT OCN.DAT CIID.DAT MINORVH.DAT PLNAME.DAT RAO.DAT TBP.DAT BCR.TBPACT.DAT 6050 110 TBPACT.DAT BCR.RCNAME.DAT BCR.GLOSSARY.TXT BCR.SPECSTP.TXT BCR.TPMEND.TXT The following are only on the CD ROM: – – – – – – 6208 4000 4000 4000 64 80 80 80 RCNAME.DAT GLOSSARY.TXT SPECSTP.TXT TPMEND.TXT Copyright Notice Complete NPA NXX data NPA NXX Activity data Special Calling Cards Operating Company Numbers Card Issuer IDentifier data Minor V&H data Place Name 10/50 mapping RAO Directory Complete Thousands Block Pooling data Thousands Block Pooling Activity data RC Name 10/50 mapping Glossary of field definitions File layout information Prod date w/file record counts – – – – – – – – – – – – READMETP.TXT READ_ME.EXE COUNTREC.EXE GLOSSARY.DOC SPECSTP.DOC TPMAPP02.MDB – – – TPMAPP00.MDB – – – TPMAPP97.MDB – – – TPMDATA.MDB – – – INSTALL.DOC Issue Date: 6/15/03 High level information A means to view "read me(s)" Counts lines in a file WORD version of Glossary WORD version of SPECSTP CD – Microsoft Access User Interface (V.2002) CD – Microsoft Access User Interface (V.2000) CD – Microsoft Access User Interface (V.97) CD – Tables with indexed TPM Data Source (V.97) CD- Instructions / Overview of Microsoft Access version of data TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 Page 2 of 9 File Layouts: (Note: the following are DATA file layouts, TXT files are not listed below) Tape Dataset: CD ROM Filename: 1. BCR.COPY.RIGHT COPYRGHT.DAT File Sequence: 1 FIELD DESCRIPTION Copyright and Notice Tape Dataset: CD ROM Filename: BCR.TPM.MASTER TPM.DAT Description: Last Change: LENGTH 80 File Sequence: 2 Description: Last Change: Copyright Notice 1990 POSITION 1-80 All NXX records 1/15/03 This dataset / file has all NPA NXX data (including all activity records). This “complete” dataset is considered the main component of the TPM product for most users. The “activity” dataset / file usually contains a few thousand records, but can theoretically contain up to the total number in the main dataset. 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. FIELD DESCRIPTION Major Vertical Coordinate Major Horizontal Coordinate filler Rate Center LATA Subzone Rate Center LATA Thousands Block Pooling Indicator IDDD Indicator (0=N, 1=Y) Dialable Indicator (DIND) (0=N, 1=Y) Company Code filler filler NPA NXX NXXTYPE Portability Indicator (0=N, 1=Y) Send to RAO filler Other Line Rate Step Operating Company Number (OCN) Bill to RAO filler Time Zone Daylight Savings Observed Indicator (0=N, 1=Y) Place Name (or Service Name) State, Province, or Country Abbreviation Effdate of Last Change (mmddyy) Change Code Company Type Point Identification Issue Date: 6/15/03 LENGTH 5 5 7 2 3 1 1 1 2 3 1 3 3 2 1 3 4 2 4 3 1 1 1 10 2 6 1 1 1 TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 POSITION 1-5 6-10 11-17 18-19 20-22 23 24 25 26-27 28-30 31 32-34 35-37 38-39 40 41-43 44-47 48-49 50-53 54-56 57 58 59 60-69 70-71 72-77 78 79 80 Page 3 of 9 Tape Dataset: CD ROM Filename: BCR.TPM.ACTVTY TPMACT.DAT File Sequence: 3 Description: Last Change: NXX Activity records 1/15/99 This dataset / file is structured identical to the master (BCR.TPM.MASTER / TPM.DAT). The activity dataset usually contains a few thousand records, but can theoretically contain up to the total number in the complete dataset. With the exception of records containing a change code of "A", this file simply identifies the records in the TPM.DAT file that have a change code. Change codes indicate that there is some "activity" associated with the record since the previous month's product. Tape Dataset: CD ROM Filename: BCR.NUMBER.SCC SCC.DAT File Sequence: 4 Description: Last Change: FIELD DESCRIPTION 1. 2. 3. 4. 5. 6. 7. 8. Bill to RAO 0/1XX (SCC Code within RAO) Send to RAO NPA Change Code Effdate of Last Change (mmddyy) Operating Company Number (OCN) filler Tape Dataset: CD ROM Filename: 1. 2. 3. 4. LENGTH BCR.NUMBER.OCN OCN.DAT File Sequence: FIELD DESCRIPTION Operating Company Number (OCN) Company Name Change Code filler Issue Date: 6/15/03 Special Calling Cards 1990 POSITION 3 3 3 3 1 6 4 7 5 1-3 4-6 7-9 10-12 13 14-19 20-23 24-30 Description: Last Change: LENGTH 4 30 1 7 TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 OCN Listing 7/15/00 POSITION 1-4 5-34 35 36-42 Page 4 of 9 Tape Dataset: CD ROM Filename: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. BCR.NUMBER.CIID CIID.DAT File Sequence: FIELD DESCRIPTION Beginning of CIID Assigned Range Ending of CIID Assigned Range Card Issuer's Name Card Issuer's Address (Line 1) Card Issuer's Address (Line 2) Card Issuer's Address (Line 3) Card Issuer's City Card Issuer's State Card Issuer's Zip Code Card Issuer's Billing Code Carrier Identification Code (CIC) or Alternate Billing Entity Code (ABEC) ABEC Indicator 0 = Previous field not an ABEC 1 = Previous field is an ABEC Access Customer Name Abbreviation (ACNA) Validation Database Operator Name Billing Agent or Host Name filler Billing Agent/Host RAO Code filler Effdate of Last Change (mmddyy) Change Code Issue Date: 6/15/03 6 Description: Last Change: LENGTH 6 6 25 25 25 25 25 2 10 5 CIID Codes 1990 POSITION 1-6 7-12 13-37 38-62 63-87 88-112 113-137 138-139 140-149 150-154 1 155 3 25 25 3 3 35 6 1 156-158 159-183 184-208 209-211 212-214 215-249 250-255 256 TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 Page 5 of 9 Tape Dataset: CD ROM Filename: 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. 31. BCR.MINOR.VH MINORVH.DAT 7 Description: Last Change: FIELD DESCRIPTION Major Vertical Coordinate Major Horizontal Coordinate filler Rate Center LATA Subzone Rate Center LATA Thousands Block Pooling Indicator IDDD Indicator (0=N, 1=Y) Dialable Indicator (DIND) (0=N, 1=Y) Company Code filler filler NPA NXX NXXTYPE Portability Indicator (0=N, 1=Y) Send to RAO filler Other Line Rate Step Operating Company Number (OCN) Bill to RAO filler Time Zone Daylight Savings Observed Indicator (0=N, 1=Y) Place Name (or Service Name) State, Province, or Country Abbreviation Effdate of Last Change (mmddyy) Change Code Company Type Point Identification Minor Vertical Coordinate Minor Horizontal Coordinate Tape Dataset: BCR.PLNAME.DAT CD ROM Filename: PLNAME.DAT 1. 2. 3. 4. 5. File Sequence: File Sequence: FIELD DESCRIPTION Place Name State (Territory, Province, Country) filler Place Name – Abbreviated 10 Characters filler Place Name – Extended 50 Characters Issue Date: 6/15/03 LENGTH 5 5 7 2 3 1 1 1 2 3 1 3 3 2 1 3 4 2 4 3 1 1 1 10 2 6 1 1 1 5 5 8 Description: Last Change: LENGTH 2 1 10 1 50 TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 Minor V&H Data 1/15/03 POSITION 1-5 6-10 11-17 18-19 20-22 23 24 25 26-27 28-30 31 32-34 35-37 38-39 40 41-43 44-47 48-49 50-53 54-56 57 58 59 60-69 70-71 72-77 78 79 80 81-85 86-90 Place Name 10/50 Char. Mapping 1/15/99 POSITION 1-2 3 4-13 14 15-64 Page 6 of 9 Tape Dataset: CD ROM Filename: BCR.NUMBER.RAO RAO.DAT File Sequence: FIELD DESCRIPTION 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. RAO Code filler Send to RAO RAO User Operating Company Number (OCN) Company Name RAO Contact Information Contact Name - Field 1 Contact Name - Field 2 Number, Street, Room P.O. Box City State Zip Change of Address Indicator (0=N, 1=Y) Service Contact Information Accounting Toll Phone Number MIC Bureau Phone Number Calling Card Phone Number Collect Ticket Phone Number MIC Fraud Phone Number Miscellaneous Service Heading 1 Miscellaneous Service 1 Phone Number Miscellaneous Service Heading 2 Miscellaneous Service 2 Phone Number Notes RAO Code Type Indicator Direct CMDS Participant / Hosting OCN filler Issue Date: 6/15/03 9 Description: Last Change: LENGTH RAO Directory 7/15/99 POSITION 3 1 3 4 30 1-3 4 5-7 8-11 12-41 25 25 25 9 25 2 9 1 42-66 67-91 92-116 117-125 126-150 151-153 153-161 162 10 10 10 10 10 25 10 25 10 200 1 4 13 163-172 173-182 183-192 193-202 203-212 213-237 238-247 248-272 273-282 283-482 483 484-487 488-500 TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 Page 7 of 9 Tape Dataset: CD ROM Filename: 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. 31. 32. 33. 34. 35. 36. BCR.TBP.DAT TBP.DAT File Sequence: 10 FIELD DESCRIPTION NPA NXX BLOCK ID filler Range NXXTYPE filler Effdate of Last Change (mmddyy) Change Code filler Operating Company Number (OCN) Administrative Operating Company Number (AOCN) Company Code Company Type Bill to RAO Send to RAO filler Major Vertical Coordinate Major Horizontal Coordinate Rate Center LATA Rate Center LATA Subzone Rate Center Name Abbreviation Rate Center Type Place Name (or Service Name) State, Province, or Country Abbreviation filler Time Zone Daylight Savings Observed Indicator (0=N, 1=Y) Portability Indicator (0=N, 1=Y) Thousands Block Pooling Indicator IDDD Indicator (0=N, 1=Y) Dialable Indicator (DIND) (0=N, 1=Y) Other Line Rate Step Point Identification Effective Date of Assignment filler Tape Dataset: CD ROM Filename: BCR.TBPACT.DAT TBPACT.DAT File Sequence: 11 Description: Last Change: LENGTH 3 3 1 1 8 2 1 6 1 1 4 4 2 1 3 3 1 5 5 3 2 10 1 10 2 1 1 1 1 1 1 1 2 1 6 11 Description: Last Change: NPA NXX BLOCK ID 1/15/03 POSITION 1-3 4-6 7 8 9-16 17-18 19 20-25 26 27 28-31 32-35 36-37 38 39-41 42-44 45 46-50 51-55 56-58 59-60 61-70 71 72-81 82-83 84 85 86 87 88 89 90 91-92 93 94-99 100-110 NPA NXX BLOCK ID 10/15/03 This dataset / file is structured identical to the master (BCR.TBP.DAT / TBPACT.DAT). The activity dataset usually contains a few thousand records, but can theoretically contain up to the total number in the complete dataset. With the exception of records containing a change code of "A", this file simply identifies the records in the TBP.DAT file that have a change code. Change codes indicate that there is some "activity" associated with the record since the previous month's product. Issue Date: 6/15/03 TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 Page 8 of 9 Tape Dataset: BCR.RCNAME.DAT CD ROM Filename: RCNAME.DAT 1. 2. 3. 4. 5. File Sequence: 12 FIELD DESCRIPTION RC Name State (Territory, Province, Country) filler RC Name – Abbreviated 10 Characters filler Rate Center (RC) Name – Extended 50 Characters Issue Date: 6/15/03 Description: Last Change: LENGTH 2 1 10 1 50 TPM Data Source - Data Set / File Specifications Effective Product Date: 10/15/03 Rate Center 10/50 Char. Mapping 1/15/03 POSITION 1-2 3 4-13 14 15-64 Page 9 of 9