You can alter the pbfn.cfg configuration file using your application or any text editor. After you modify the pbfn.cfg file, the PBFNInit function loads the desired parameters. If you do not wish to use the pbfn.cfg configuration file to save setup parameters for your user-written application, you can store these values elsewhere. In that case, instead of using the PBFNInit call, you would allocate your own PBFNSetupDef structure, fill in the appropriate information, and pass that PBFNSetupDef structure directly to the PBFNInit call. The following is a sample pbfn.cfg configuration file for the Windows and Unix platforms.
File Section:
--------------
City Directory Filename =
ZIP+4 Directory Filename 1 =
--------------
CASS Section:
--------------
Batch Report Filename = BatchRpt.txt
3553 Report Filename =
CASS Company Name =
CASS Product Name =
CASS Product Version =
LOT Certified Company Name =
LOT Certified Product Name =
LOT Certified Product Version =
CASS Mailer Name =
CASS Mailer Address =
CASS Mailer Address2 =
CASS Mailer Address3 =
CASS Mailer Address4 =
CASS Mailer City Line =
CASS Configuration = AAA
Batch Report = ON
3553 Report = ON
-----------------
Process Section:
-----------------
CASS Flag = OFF
Assign Carrier Routes = ON
Assign Unassign Records =
Assign Abbreviated City = OFF
CASS Standardize Case = U
Cache Size = 12
Beginning Frame Char = !
End Frame Char = !
Return DPBC = ON
Dual Address Switch = P
Return Alias Street Name =
Assign LOT = OFF
Padded String Data =
Uppercase Input =
Remove Noise Characters =
Process Firms = ON
Return Input Firm =
All Street Matching =
R777 Deliverable =
Convert Secondary to PMB =
Number Exception Table Entries =
Suggestion Count = 10
------------------
Product Section:
------------------
Exception Table Filename =
EWS Filename =
LOT Filename =
DPV Filepath =
RDI Filepath =
LACSLink Filepath =
SuiteLink Filepath =
Early Warning System =
Delivery Point Validation =
DPV Shutdown Indicator =
DPV Tie Break =
DPV No-Stat Table =
DPV Vacant Table =
DPV PBSA Table =
DPV DNA Table =
DPV NSL Table =
DPV Throwback Table =
DPV Buffer Size =
DPV CMRA Table =
DPV Drop Table =
DPV NDD Table =
Residential Delivery Indicator =
LACSLink =
LACSLink Processing =
SuiteLink =
SuiteLink Small Memory Flag =
SuiteLink Shutdown Indicator =
Return SLK Input Secondary =
PreciselyID Processing =
SOFTWARE KEY =
DPVKey =
LACSLink Key =
------------------
Report Section:
------------------
Report Filename = report.txt
Report Title = Finalist Report File From PBFN.CFG
Address Detail Report PAGE LEN = 0
Address Detail Report MAX REC = 0
Address Detail Report NTH REC = 0
Address Detail Report Type =
Address Detail Report Isol =
Address Detail Report Sugg =
Address Detail Report Info =
-------------------
Log Msg Section:
-------------------
Log Filename = log.txt
Log Level = 3
The following table provides a description for each field in the pbfn.cfg configuration file.
Configuration Setting | Description |
---|---|
File Section | |
City Directory Filename | Identifies the City Database file name. |
ZIP + 4 Directory Filename 1 | Identifies the ZIP + 4 Database file name. |
CASS Section | |
Batch Report Filename | The Output file name for the Finalist Batch Report. The default file name is batch.txt. |
3553 Report Filename | The Output file name for the USPS Form 3553 (CASS Summary Report). The default file name is cass3553.txt. |
CASS Company Name | The name of the CASS-certified company displays in section A box 1 on the USPS Form 3553 (CASS Summary Report). |
CASS Product Name | The name of the CASS-certified product displays in section A box 2 on the USPS Form 3553 (CASS Summary Report). |
CASS Product Version | The version number for the CASS-certified product displays in section A box 2 on the USPS Form 3553 (CASS Summary Report). |
LOT Certified Company Name | The Line of Travel (LOT)-certified company name displays in section A box 10 on the USPS Form 3553 (CASS Summary Report). |
LOT Certified Product Name | The Line of Travel (LOT)-certified product name displays in section A box 11 on the USPS Form 3553 (CASS Summary Report). |
LOT Certified Product Version | The Line of Travel (LOT)-certified product version displays in section A box 11 on the USPS Form 3553 (CASS Summary Report). |
DPC Certified Company Name | The DirectDPV company name displays in section A box 7 on the USPS Form 3553 (CASS Summary Report). |
DPC Certified Product Name | The DirectDPV product name displays in section A box 8 on the USPS Form 3553 (CASS Summary Report). |
DPC Certified Product Version | The DirectDPV product version displays in section A box 8 on the USPS Form 3553 (CASS Summary Report). |
CASS Mailer Name | The Mailer's name displays in section D box 3 on the USPS Form 3553 (CASS Summary Report). |
CASS Mailer Address | Mailer's address. This information displays in section D box 3 on the USPS Form 3553 (CASS Summary Report). |
CASS Mailer Address 2-4 | Additional address lines for Mailer's address display in section D box 3 on the USPS Form 3553 (CASS Summary Report). |
CASS Mailer City Line | The Mailer's city, state, and ZIP Code information displays in section D box 3 on the USPS Form 3553 (CASS Summary Report). |
CASS Configuration | The CASS configuration value displays in section A box 3 on the USPS Form 3553 (CASS Summary Report). |
Batch Report | Indicate whether to print the
Finalist Batch Report:
|
3553 Report | Indicate whether to print the USPS
Form 3553 (CASS Summary Report).
|
Process Section | |
CASS Flag | Indicate whether to process in a
non-CASS or CASS mode.
|
Assign Carrier Routes | Indicate whether to assign carrier
route codes to your file.
|
Assign Unassign Records | Indicate how to code previously
unassigned or expired addresses. For more information on the assign/unassign
feature, refer to the description of the cProcessUnassigned field of the
PBFNSetupDef structure.
|
Assign Abbreviated City | Indicate whether to return
abbreviated city names in the label lines.
|
CASS Standardize Case | Indicate whether to return addresses
in all upper, all lower, or mixed upper and lower case. This field affects the
address coding output only.
|
Cache Size | Indicate whether Finalist should use
internal caching.
|
Beginning Frame Char | Specify the character to use for the front framing character for advanced barcodes. If you do not specify a character for BegFrame or EndFrame, Finalist uses the exclamation point (!) as the default value. |
End Frame Char | Specify the character to use for the end framing character for advanced barcodes. If you do not specify a value here, the BegFrame character is used as the default value. If you do not specify a character for BegFrame or EndFrame, Finalist uses the exclamation point (!) as the default value. |
Return DPBC | Indicate whether to return delivery
point barcodes.
|
Dual Address Switch | Specify the order for processing and
matching addresses when the input file contains dual addresses (one a
conventional address, a second containing a PO Box address). If the selected
address is valid, processing stops. If the selected address does not validate,
Finalist attempts to code the secondary address.
|
Return Alias Street Name | Indicates whether to return alias
street names in label lines. An alias street name is an alternate name for a
street, maintained at the range Plus4 ZIP Code level. An alias street name can
be a nickname alias street name of a preferred alias street name.
|
Assign LOT | Indicate whether to assign Line of
Travel (LOT) codes.
|
Padded String Data | If you use a platform or coding
language (for example, COBOL) that does not support null terminated strings,
pad all fields with blanks. Indicate whether you use input/output fields that
are padded with blanks or null terminated:
|
Process LOT Only | Indicate whether to perform only
eLOT processing.
|
Uppercase Input | Indicate if your input data is in an
all uppercase format.
|
Remove Noise Characters | Indicate whether to remove noise
characters (unnecessary punctuation and blanks).
|
Process Firms | Indicate whether to perform firm processing.
|
Return Input Firm | Indicate whether to return the input firm.
|
All Street Matching | Indicate whether to perform All
Street Matching (ASM) processing to apply additional matching logic to correct
errors in street names and obtain a match. For example, when the first letter
of a street is misspelled or missing on input, this feature searches all street
names in a locality to find an input address. ASM provides the best address
validation but may reduce performance. ASM processing is available for U.S.
addresses only.
|
R777 Deliverable | Addresses with Carrier Route R777
are phantom routes that are not eligible for street delivery. Since these
addresses are assigned a ZIP + 4 code by the USPS, Finalist marks these
addresses as deliverable. If you do not want the addresses with Carrier Route
R777 marked as deliverable, set this option to OFF and the following actions
are performed for the address:
Valid values are:
|
Convert Secondary to PMB | Indicate whether to convert
secondary information to "PMB" under the following conditions:
This processing only applies if the primary address codes to a CMRA. Valid values are:
|
Number Exception Table Entries | The maximum number of exception table entries. Defaults to 1000. |
Suggestion Count | The maximum number of returned suggestions per address based on the specified suggestion criteria. |
Product Section | |
Exception Table Filename | The Exceptions Table file name and path. |
EWS Filename | The Early Warning System (EWS) file name and path. |
LOT Filename | The Line of Travel (LOT) file name and path. |
DPV Filepath | The Delivery Point Validation (DPV) file path. |
RDI Filepath | The Residential Delivery Indicator (RDI) File path. |
LACSLink Filepath | The LACSLink File path. |
SuiteLink Filepath | The SuiteLink File path. |
PreciselyID Processing | Indicate whether to perform PreciselyID processing.
|
Early Warning System | Indicate whether to perform Early
Warning System (EWS) processing.
|
Delivery Point Validation | Indicate whether to perform Delivery
Point Validation (DPV) processing. Note: The USPS CASS regulations require DPV processing to generate the USPS Form
3553 (USPS CASS Summary Report).
|
DPV Shutdown Indicator | Indicate the action to take when
encountering a DPV Seed during the processing run.
|
DPV Tie Break | The USPS allows DPV processing to be
used as a tie breaker for matching inexact street records. If only one of the
records in a tie is delivery point validated, a match is allowed to the inexact
record. When processing results in an inexact match due to the input address
directional, DPV processing can be used as a tie breaker if only one of the
records is found to be delivery point validated and the delivery point
validated record does not violate the cardinal direction rule. Note: The USPS CASS regulations require DPV
Tie Break processing to generate the USPS Form 3553 (USPS CASS Summary
Report).
Indicate whether to perform DPV Tie Breaker processing.
|
DPV NoStat Table | DPV processing uses the No-Stat
Table to identify deliveries that are not valid for Computerized Delivery
Sequence (CDS) pre-processing. Indicate whether to use the No-Stat Table and
return the proper No-Stat code to the output.
|
DPV Vacant Table | DPV processing uses the Vacant Table
to identify delivery addresses that have been active in the past but, according
to USPS data, have not been occupied within the last 90 days. Indicate whether
to use the Vacant Table and return the proper Vacant code to the output.
|
DPV PBSA Table | DPV processing uses the PBSA Table
to identify PO Box Street Addresses (PBSA). A PBSA address is a street address
that represents a USPS PO Box. Indicate whether to use the PBSA Table and
return the PBSA result to the output.
|
DPV DNA Table | DPV processing uses the Door Not
Accessible (DNA) Table to identify delivery addresses where carriers cannot
knock on the door for mail delivery or where carriers cannot physically access
a residence/building such as rural/highway contact route (HCR), long driveway,
or gated community. Indicate whether to use the DNA Table and return the proper
DNA code to the output.
|
DPV Throwback Table | DPV processing uses the P.O. Box
Throwback Table to identify a delivery point that is a street address where
mail is not delivered. Instead, delivery is made to the customer's P.O.
Box address. Indicate whether to use the P.O. Box Throwback Table and return
the proper Throwback code to the output.
|
DPV NSL Table | DPV processing uses the No Secure
Location (NSL) table to identify delivery locations that are not secure. For
example, a carrier can access a door but cannot leave a package due to security
concerns. The NSL designation alerts mailers to locations where businesses are
closed on certain days and locations without mail receptacles (for example, a
storefront). Indicate whether to use the NSL Table and return the proper NSL
code to the output.
|
DPV Buffer Size | Indicates the memory model for DPV processing.
|
DPV CMRA TABLE | Indicate whether to perform CMRA
processing. Private companies offering mailbox rental services to individuals
and businesses are Commercial Mail Receiving Agents (CMRA).
|
Residential Delivery Indicator | Indicate whether to perform
Residential Delivery Indicator (RDI) processing.
|
LACSLink | Indicate whether to perform LACSLink processing. USPS CASS regulations
require LACSLink processing. If you do not
perform LACSLink processing, Finalist does
not generate a USPS Form 3553 (CASS Summary Report).
|
LACSLink Processing | Indicates the memory model for
LACSLink processing.
|
SuiteLink | Indicate whether to perform
SuiteLink processing. USPS CASS
regulations require SuiteLink processing.
If you do not perform SuiteLink
processing, Finalist does not generate a USPS Form 3553 (CASS Summary Report).
|
SuiteLink Small Memory Flag | Indicates the memory model for
SuiteLink processing.
|
SuiteLink Shutdown Indicator | Indicate the action to take when
encountering a SuiteLink processing error
during the processing run.
|
Return SLK Input Secondary | Indicates how to return secondary
information when SuiteLink secondary
information is available.
|
Software Key | Enter your Finalist activation key. |
DPVKey | Enter the Delivery Point Validation (DPV) activation key. |
LACSLink Key | Enter the LACSLink activation key. |
Report Section | |
Report Filename | Specify the Address Detail Report output file name. Defaults to rpt.txt. |
Report Title | Specify the title of the Address Detail Report. |
Address Detail Report PAGE LEN | Specify the maximum page length for the Address Detail Isolation Report. |
Address Detail Report MAX REC | Specify the maximum number of records to output to the Address Detail Isolation Report. |
Address Detail Report NTH REC | Specify the records to print on the Address Detail Isolation Report (for example, print every 8th record). |
Address Detail Report Type | Indicate whether to print the
Address Detail Report.
|
Address Detail Report Isol | Indicate whether to print the
Address Detail Isolation Report.
|
Address Detail Report Sugg | Indicate whether to print the
Address Detail Suggestion Report.
|
Address Detail Report Info | Indicate whether to print the
Address Detail Information Report.
|
Log Message Section | |
Log Filename | Specify the Log file name and path. |
Log Level | Indicate the level of the message to log:
|