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
.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. Thertrv-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:
Thertrv-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.