2 General Description

This chapter describes the general file format, size estimates, and naming convention.

2.1 General File Format

Report files are divided into three sections, the system header, the individual data report header, and the report data.

Figure 2-1 General File Format

System Header Field Names
System Header Field Values
<Blank Line>
Data Header
data, data, data, data, data, data, data, data, data <cr><lf>
…
…
data, data, data, data, data, data, data, data, data <cr><lf>

As shown in Figure 2-1, the first line in a report file contains the system header field names, followed on the second line by the system header field values. The third line is left blank to separate the system header section from the data sections. The fourth line is the data header, and subsequent lines contain the data. There is no blank line between the data header and data.

2.2 File Size Estimates

The system header size varies depending on the embedded data. A size of 250 bytes is used in all calculations, but this value can be as high as 331 bytes.

The report header size varies depending on the report type, but is always the same size for a specific report type.

The size of the report data section varies depending on the number of entries being reported.

For the estimates given in this document, 10 characters are assumed for each ASCII value and 3 bytes for each integer value, plus the comma delimiter. The file sizes could be significantly larger or smaller, depending on the configuration of a particular system.

2.3 File Naming Convention

File names consist of three fields, separated by underscores and followed by the .csv extension, enabling them to be readily identified as comma-separated value files. Long file names (beyond 8.3 format) are utilized. The three fields in the name are:
  • Retrieve type

    The retrieve type contains up to 13 characters, and is usually the table name. The supported types are shown in Table 2-1.

    The tables are grouped into the 6 table classes shown, except for the rtrv-stp command. The rtrv-stp command does not belong to any particular table class, and the command output report is based on the current system configuration.

    Table 2-1 Supported Retrieve Types

    MTP Tables GTT Tables GWS Tables VFLEX Tables IP Tables VLR Tables
    rtrv-aiqopts rtrv-gta rtrv-scr-aftpc rtrv-vflx-cd rtrv-appl-rtkey rtrv-vlr-prof
    rtrv-as rtrv-gtmod rtrv-scr-blkdpc rtrv-vflx-opts rtrv-assoc rtrv-vlr-roaming
    rtrv-atinpqopts rtrv-gtt rtrv-scr-blkopc rtrv-vflx-rn rtrv-ip-card
    rtrv-card rtrv-gttact rtrv-scr-cdpa rtrv-vflx-vmsid rtrv-ip-host
    rtrv-ctrl-feat rtrv-gttapath rtrv-scr-cgpa rtrv-ip-lnk
    rtrv-dstn rtrv-gttaset rtrv-scr-destfld rtrv-ip-rte
    rtrv-feat rtrv-gttsel rtrv-scr-dpc rtrv-na
    rtrv-ip-node rtrv-gttset rtrv-scr-opc rtrv-snmp-host
    rtrv-ls rtrv-map rtrv-scrset rtrv-snmpopts
    rtrv-measopts rtrv-tt rtrv-scr-sio
    rtrv-mtc-measopts rtrv-mrn rtrv-scr-tt
    rtrv-rte
    rtrv-sccpopts
    rtrv-sid
    rtrv-slk
    rtrv-ss-appl
    rtrv-stpopts
    rtrv-gen-name          

    Note:

    The rtrv-stp command does not belong to any particular table class.
  • DB date

    The DB date contains eight characters (yyyymmdd) and reflects the date on which the data was last updated.

  • DB time

    The DB time contains four characters (hhmm) and reflects the time at which the data was last updated.

Examples

  • dstn_20030510_1550.csv

    This file contains destination point code table data that was last updated on 05/10/2003 at 15:50.

  • scr-blkdpc_20030510_1550.csv

    This file contains blocked destination point code screening reference data that was last updated on 05/10/2003 at 15:50.