Business objects ACE 7.72C User Manual

Download

ACE Release Notes

ACE 7.72c

December 2006

Contact information Contact us on the Web at http://www.firstlogic.com/customer

If you find any problem with this documentation, please report it to Business Objects in writing at

Patents Business Objects owns the following U.S. patents, which may cover products that are

documentation@businessobjects.com

offered and sold by Business Objects: 5,555,403, 6,247,008 B1, 6,578,027 B2, 6,490,593 and 6,289,352.

Trademarks Business Objects, the Business Objects logo, Crystal Reports, and Crystal Enterprise

are trademarks or registered trademarks of Business Objects SA or its affiliated companies in the United States and other countries. All other names mentioned herein may be trademarks of their respective owners.

Third-party contributors Business Objects products in this release may contain redistributions of software

licensed from third-party contributors. Some of these individual compo nents may also be available under alternative licenses. A partial listing of third-party contributors that have requested or permitted acknowledgments, as well as required notices, can be found at: http://www.businessobjects.com/thirdparty

ACE 7.72c Release Notes

Introduction

What’s new in this release

This release includes the following changes and enhancements:

 DSF

 Suite

. Verify addresses and add address attributes using the USPS’ s DSF2

data and ACE’s DSF

Link

. Build accurate and complete addresses by adding suite

for-sale option. See “DSF2” on page 6.

numbers to high-rise business addresses through the USPS’s Suite

Link

product and ACE’s Suite finalizing our Suite

Link

Suite

options in ACE 7.72c. When licensing is in place, you will be able

Link

for-sale option. We are in the process of

solution. Therefore, you can preview some of the new

Link

to order this for-sale option. Please contact your sales representative for the latest information on availability. See “SuiteLink” on page 18 for a preview of SuiteLink features.

 Updated reports and statistics files. The ACE Job Summary, Mover ID

Summary , and statist ics fi les now include DSF

and Suite

Link

information. See “ACE Job Summary report” on page 25 and “Updated statistics files” on

page 26.

 DPV No Stats Indicators. ACE outputs No Stats indicators when you

process your records with DSF

and DPV. See “DPV No Stats indicator s” on

page 28.

 No DPV when sequencing is turned on. If you set up your ACE job for

walk sequencing, and you have DPV enabled, ACE will stop the DPV processing and issue a message.

What’s in your package

In your package today, you’ll find the following:

 ACE 7.72c software  ACE 7.72c Release Notes (this document)

Product versions Product versions for this release are as follows:

 ACE 7.72c revision 1. This is the overall version of the ACE software.  CASS-certified ACE version 7.70.01.K. The last character is the letter K for

CASS Cycle K. This is the most recently CASS-certified version of ACE.

 Mover ID version 4.0. This version applies to ACE’s Mover ID option.

Introduction

Documentation Your complete ACE documentation set includes the following:

 ACE User’s Guide  ACE Job-File Reference (if you use ACE job file)  ACE Library Reference (if you use ACE Library)  Mover ID User’s Guide for NCOA  Quick Reference  System Administrator’s Guide  Edjob User’s Guide  Database Prep  Views Quick Start Guide (if you use ACE Views)

Link

(if you purchased this add-on option)

Access the latest documentation

You can access ACE documentation in several places:

 Your computer. Choose Start > Programs > Firstlogic Applications >

Documentation.

 Customer Portal. Go to www.firstlogic.com/customer and click the

Documentation link. View the PDFs online or save them to your computer.

ACE 7.72c Release Notes

Installation

Installation advice To simplify installation, read the following tips before you begin:

 Give the contents of this software shipment to your system administrator.

This software should be installed by, or with the approval of, the system administrator.

 Although you can install your applications and dir ect ories in any order, it’s

best to install software first and then directories.

 If you install on multiple operating systems, chec k the bottom of the CD label

for the appropriate operating system.

Install ACE on Windows

You do not need administrative privileges to run ACE Views on Windows 2000/ XP. However, you need administrative privileges for installing.

When you insert the software CD, the installation program should start automatically. If it doesn’t, follow these steps:

1. Access your Windows Start menu and choose Run.

2. In the Run window, type x:\setup (where x is the letter of your CD-ROM drive) and click OK.

For more information, see your System Administrator’s Guide.

Install ACE on UNIX T o install ACE on UNIX, u se the install_consol e installation for the Jav a Runtime

Environment explained in the System Administrator’s Guide.

Client shortcuts If you have ACE installed on one computer , but you run it from another comp uter

using client shortcuts, you must refresh your client-side shortcuts b y usi ng the Universal Client installer.

If you use ACE Views, job file, or RAPID, run Edjob

Before you run this version of ACE, you must update your existing jobs with the Edjob utility. For details, see the Edjob User’s Guide. To update your jobs to this version of ACE, run pwacejob.upd. The syntax of the Edjob command line is:

Operating system versions

edjob [options] [path]update_script.upd job_file.ace

The ACE update scripts are in the ace subdirectory.

Run ACE on one of our supported operating systems:

http://www.firstlogic.com/customer/InfoSource/SystemInformation.asp

ACE does not run on unsupported operating systems such as Windows 98, NT, and ME.

Installation

DSF

What is DSF2? DSF

(Second Generation Delivery Sequence File – Licensed Service) is a USPS product that mailers can use to validate addresses, add delivery sequence information, and add address attributes to addresses.

 Validate addresses. DSF

inaccurate or incomplete. This helps reduce the quantity of undeliverable-asaddressed (UAA) mail and keeps mailing costs down. DSF (Delivery Point Validation, an add-on option) to validate addresses and identify inaccurate or incomplete addresses.

 Add delivery sequence information. DSF

information to your data, which you can use with presorting software to qualify for walk-sequence discounts.

 Add address attributes. DSF

the addresses) to your data. Use the attribute information to create more targeted mailings.

USPS DSF2 data is available only to USPS-certified DSF2 licensees. See “Becoming a DSF2 licensee” on page 7.

See also “Address attributes” on page 13 and “Walk sequencing” on page 15.

ACE’s DSF2 option ACE provides access to DSF

ACE’s DSF

feature, you can perform DSF2 processing in a single-pass — at the same time with your other ACE processing. By running DSF processing at the same time, you can receive information about addresses both pre- and post-move if a move has occurred.

validates addresses and identifies those that are

uses DPV

adds delivery sequence

adds address attributes (information about

data through its new DSF2 add-on feature. With

and NCOA

Link

If you are interested in purchasing ACE’s DSF2 add-on option, you must first

become a licensed DSF

licensee” on page 7). Then, to purchase the ACE DSF

Business Objects at http://www.firstlogic.com/customer The ACE DSF

add-on option is available in ACE job file and ACE Views. It is

provider through the USPS (see “Becoming a DSF2

add-on option, contact

not currently available in ACE Library or ACE RAPID.

ACE 7.72c Release Notes

Becoming a DSF2 licensee

Before you can perform DSF2 processing in ACE, you must complete the USPS

certification procedures and then purchase the DSF2 add-on option from

DSF Business Objects.

Start with the USPS. Before you purchase ACE’s DSF2 add-on option,

perform all of the USPS DSF

Read about DSF

and the certification procedure, and obtain the required

certification steps that you can.

application form and other crucial documents on the USPS RIBBS web page (http://ribbs.usps.gov/)

. If you have further questions, contact the USPS. Phone: 800-238-3150 Address: DSF2 Department

United States Postal Service 6060 Primacy Pkwy Ste 201 Memphis TN 38188-0001

DSF2 directories DSF

Data Description

DPV To verify addresses and identify inaccurate addresses, ACE requires the

eLOT To assign walk sequence numbers, ACE requires the eLOT directories

Other DSF2 tables

Delivery statistics file

processing requires the following data.

DPV directories that Business Objects provides. The DSF

data that the USPS sends to you also includes DPV data, but it is in a format that ACE cannot access.

You must use the DPV data that Business Objects pro-

vides to you.

that Business Objects provides. The DSF

data that the USPS sends to

you also includes eLOT data, but it is in a format that ACE cannot access.

You must use the eLOT data that Business Objects provides to you.

This DSF2 data is necessary for assigning address attributes. You must choose to install the DSF2 directory file during installation.

Business Objects provides the delivery statistics file ( on the National Directories CD and also on the Customer Portal (

www.firstlogic.com/customer

dsf.dir

) directory

http://

USPS CDs. DSF2 files from the USPS currently are delivered on three CDs.

You need to install only the second DSF

CD’s tables.

You must specify the location of these directory files. See “Specify the path to

DSF2 files” on page 9.

To meet DSF

requirements, you must install these updated directories monthly.

DSF2

Set up DSF2 processing in ACE

After you’ve become a certified DSF2 licensee and purchased the ACE DSF2

add-on option, you can perform DSF

up DSF

processing, set the following items in ACE.

processing in ACE V iews or job file. To set

Enable DSF2 processing To enable DSF

In addition, because DSF information, you must enable DPV processing (set the mode to Validate or Both) when you perform any type of DSF when DSF2 Mode is set to Sequence or Both.

When you perform DSF

processing, set the DSF2 Mode option in the Execution block.

includes DPV (Delivery Point Validation) and eLOT

processing and enable eLOT processing

processing, Assignment Mode must be set to Assign.

BEGIN Execution ============================ Assignment Mode(NONE/ASSIGN/PARSE/GEO)= Assign Assign Which Records (ALL/UNASSIGNED) = ALL

Perform Mover ID NCOALink (Y/N)...... = N

Perform Z4Change Processing (Y/N).... = N

Perform GeoCensus Processing (Y/N)... = N

Perform EWS Processing (Y/N)......... = N

Perform eLOT Processing (Y/N)........ = Y

Perform RDI Processing (Y/N)......... = N

Perform LACSLink Processing (Y/N).... = N

Perform SuiteLink Processing (Y/N)... = N DPV Mode (VALIDATE/TIEBREAK/BOTH/N).. = BOTH DSF2 Mode (AUGMENT/SEQUENCE/BOTH/N).. = BOTH

Enable TaxIQ Feature (Y/N)........... = N

Enable Non-CASS Features (Y/N)....... = N

+ Sort Input File by ZIP Code (Y/N).. = N

Warn Before File Overwrite (Y/N)..... = Y

Show Detailed Process Messages (Y/N). = Y

Message Update Increment............. = 100

Work File Directory (path)........... =

DSF2 Mode setting Description

Augment Set DSF2 Mode to Augment to receive address attributes. See

“Address attributes” on page 13.

Sequence Set DSF2 Mode to Sequence to receive walk-sequence data,

which you can use to earn mailing discounts. See “Walk

sequencing” on page 15.

Both Set DSF2 Mode to Both if you want both the address attributes

and walk-sequencing benefits of DSF

N Set DSF2 Mode to N if you do not want to perform DSF2 pro-

cessing on this job.

ACE 7.72c Release Notes

Specify the path to DSF2 files

In the Auxiliary Files block, specify the path to the DSF2 directory and specify the path and file name for the DESLTATS directory.

BEGIN Auxiliary Files =================================== City Directory (path & city09.dir)... = C:\DIR\city09.dir

ZCF Directory (path & zcf09.dir)..... = C:\DIR\zcf09.dir

ZIP+4 Directory 1 (path & zip4*.dir). = C:\DIR\zip4us.dir ZIP+4 Directory 2 (path & zip4*.dir). = Rev ZIP+4 Dir (path & revzip4.dir)... = C:\DIR\revzip4.dir EWS Directory (path & ewyymmdd.dir).. =

eLOT Directory (path & elot.dir)..... = C:\DIR\elot.dir

RDI Directory (path only)............ =

LACSLink Directory (path only)....... =

SuiteLink Directory (path only)...... =

DPV Directory (path only)............ = C:\PW\DPV

DSF2 Directory (path only)........... = C:\PW\DSF2

DELSTATS Directory (path & dsf.dir).. = C:\DIR\dsf.dir

NCOALink Directory (path only)....... =

Name Parsing Files (path only)....... =

Option Description

DSF2 Directory Type the path to the directory that holds the DSF2 files you received

from the USPS. (Because there is more than one file, do not type file name.)

DELSTATS Directory

Type the path to, and file name of, the delivery statistics product (

dsf.dir

). Business Objects provides this file to you on the National

Directory CD.

dsf.dir

The

file provides counts of business and residential addresses

per ZIP Code per carrier route.

DSF2

Identify the DSF2 licensee When you perform DSF

-licensed company and the party for whom it is processing this job.

DSF

If you are performing DSF2 and NCOA the information that you enter in the Customer & USPS Licensee Information block must apply to both DSF for example, the customer ID is different for DSF need to perform the job in two passes.

BEGIN Customer & USPS Licensee Information ===============

NCOALink Platform ID (4 chars)....... =

DSF2 Licensee ID (4 chars)........... = BA92

Licensee Name (to 40 chars).......... = The Big Company

List Owner NAICS (6 chars)........... = 309482

Customer/List ID (6 chars)........... = SML123

Customer Company Name (to 50 chars).. =

Customer Address (to 50 chars)....... =

Customer City (to 28 chars).......... =

Customer State (2 chars)............. =

Customer ZIP (5 chars)............... =

Customer ZIP+4 (4 chars)............. =

Customer Phone (10 chars)............ =

Customer Tax ID Number (to 12 chars). =

Processing Frequency (to 2 chars).... =

Date List Received (yyyy/mm/dd)...... = 2006/12/28

List Return Date (yyyy/mm/dd)........ = 2006/12/29

Log File Directory (path only)....... = C:\PW\ACE\LOG\

END

processing, you must provide information about the

Link

processing in the same pass, then

and NCOA

Link

and NCOA

processing. If,

Link

, you will

The following parameters in the Customer & USPS Licensee Information block must be filled in.

Option Description

DSF2 Licensee ID Enter your DSF2 identification number, as the USPS assigned it to you. Licensee Name Enter the name of the company that is licensed to perform DSF List Owner NAICS Enter the North American Industry Classification System (NAICS) code, which identifies what

business the list owner engages in. For more information, see

http://www.census.gov/epcd/www/naics.html

Customer/List ID Enter a unique identification code for this customer or list. You assign this ID to identify the cus-

tomer or list.

Date List Received Enter the date when you received this list for DSF

processing. Use the yyyy/mm/dd format. List Return Date Enter the date when the list will be returned to the customer. Use the yyyy/mm/dd format. Log File Directory Enter the path where the DSF

log files will be produced. ACE determines the file names based

on USPS requirements. This directory must exist and be writable. For more details, See page 17.

ACE 7.72c Release Notes

processing.

Improve processing speed You can cache DSF

 You’re running on a 64-bit UNIX operating system, or  You’re running on 32-b it Windows and have the Extended Memory option

turned on.

To cache DSF

data, turn on the Load DSF2 Dirs Into Memory option in the Memory Usage block. ACE caches only the directories needed for adding address attributes (when the DSF2 Mode parameter is set to Augment or Both). If you’re performing sequencing only , there ’s no need to cache the DSF

data to improve DSF2 processing speed if:

directories.

BEGIN Memory Usage ====================================== Windows Use Extended Memory (See Note)= AUTO Windows Memory Window Size (# of MB). = Load RDI Dirs into System Memory (Y/N)= N Load LACSLink Dirs into Memory (Y/N). = N Load SuiteLink Dirs into Memory (Y/N) = N Load DPV Dirs into System Memory (Y/N)= N

Load DSF2 Dirs into Memory (Y/N)..... = Y

NCOALink Memory (AUTO/MANUAL/N)...... = N

NCOALink Memory Allocation (# of MB). = Cache for ZIP Order Processing (Y/N). = N Insufficient Memory Action(ABORT/CONT)= ABORT END

Include output components

Be sure to include the new address-attribute components and AP.Walk_Seq in your output file block. AP.Walk_Seq is necessary only if you’re walk-sequencing your mailing and want to claim the walk-sequence discount.

See “Address attributes” on page 13 and “Walk sequencing” on page 15.

DSF2

Set up the Delivery Sequence Invoice report

If you claim walk-sequence discounts on this job, the USPS requires the Delivery Sequence Invoice report.

Important: The Delivery Sequence Invoice report can be large, sometimes

exceeding 1000 pages. The number of pages relates to the number of ZIP Codes in your output.

To create the Delivery Sequence Invoice report, include the Report: Delivery Sequence Invoice block in your job and set it up in the same manner that you set up other report blocks. The only parameter that is unique to this block is the Site Location parameter.

BEGIN Report: Delivery Sequence Invoice =============

BEGIN Report: Delivery Sequence Invoice ============= Location and File Name/Printer Device = $job.dsf

Location and File Name/Printer Device = $job.dsi

Existing File (APPEND/REPLACE) ...... = REPLACE

Number of Copies (1 to 10) .......... = 1

Case (UPPER/Upper and Lower) ........ = UPPER

Page Header Line 1 (to 80 chars) .... =

Page Header Line 2 (to 80 chars) .... =

Page Header Line 3 (to 80 chars) .... =

Page Header Line 4 (to 80 chars) .... =

Printer Init, For Reports ........... =

Printer Reset, For Reports .......... =

Page Length (in lines) .............. =

Page Width (in chars) ............... =

Top Margin (in lines) ............... =

Bottom Margin (in lines) ............ =

Left Margin (in chars) .............. =

Right Margin (in chars) ............. =

Site Location (to 20 chars).......... = Chicago Blaine

END

Option Description

Site Location Type the name of your company’s location where the DSF2

processing is performed for this job.

ACE 7.72c Release Notes

See the report sample below.

DSF2 DELIVERY SEQUENCE INVOICE ACE 7.72C PAGE 1

LICENSEE NAME: BUSINESS OBJECTS SITE LOCATION: LA CROSSE PROCESSING DATE: 12/07/2006 OUTPUT FILE: D:\TEST_SUITE\JOB\OUTPUT\DPV\DATA\DSF2002.DBF

----------------------------------------------------------------------------- ZIP CART TOTAL TOTAL CART RES. %ACTV. %RES. DISCOUNTS CODE CODE DELIV. RES. SEQ. SEQ. DELIV. DELIV. A B C D +-------+------+--------+--------+-------+-------+-------+-------+---------+ | 01001 | C006 | 495 | 494 | 150 | 149 | 30 | 30 | Y Y N N | | 01103 | C006 | 399 | 271 | 125 | 0 | 31 | 0 | Y Y N N | | 01201 | C054 | 315 | 310 | 150 | 145 | 47 | 46 | Y Y N N | | 01301 | H079 | 461 | 455 | 125 | 119 | 27 | 26 | Y Y N N | | 01420 | C004 | 425 | 394 | 125 | 94 | 29 | 23 | Y Y N N | | 01501 | C006 | 416 | 411 | 150 | 145 | 36 | 35 | Y Y N N | | 01602 | C033 | 566 | 563 | 370 | 367 | 65 | 65 | Y Y N N | | 01701 | C053 | 521 | 481 | 370 | 330 | 71 | 68 | Y Y N N | | 01801 | C028 | 598 | 576 | 500 | 478 | 83 | 82 | Y Y N Y | | 01902 | C021 | 612 | 599 | 500 | 487 | 81 | 81 | Y Y N Y | | 02019 | C005 | 506 | 487 | 370 | 351 | 73 | 72 | Y Y N N | | 02111 | C014 | 792 | 735 | 420 | 363 | 53 | 49 | Y Y N N | | 02215 | C058 | 860 | 805 | 498 | 438 | 57 | 54 | Y Y N N | | 02301 | C091 | 759 | 723 | 500 | 464 | 65 | 64 | Y Y N N | | 02446 | B017 | 19 | 10 | 10 | 10 | 52 | 100 | Y N Y N | | 02446 | C005 | 499 | 493 | 465 | 459 | 93 | 93 | Y Y Y Y | | 02532 | R003 | 676 | 673 | 500 | 497 | 73 | 73 | Y Y N N | | 02633 | C002 | 694 | 619 | 401 | 326 | 57 | 52 | Y Y N N | | 02720 | B005 | 24 | 10 | 10 | 10 | 41 | 100 | Y N Y N | | 02720 | C006 | 545 | 523 | 457 | 435 | 83 | 83 | Y Y N Y | | 02861 | C034 | 685 | 609 | 500 | 424 | 72 | 69 | Y Y N N | | 04938 | B007 | 13 | 10 | 10 | 7 | 76 | 70 | Y N N Y | | 04938 | R001 | 490 | 485 | 125 | 125 | 25 | 25 | Y Y N N | | 04938 | R005 | 546 | 525 | 365 | 365 | 66 | 69 | Y Y N N | | 06226 | C004 | 719 | 547 | 437 | 271 | 60 | 49 | Y Y N N | | 06901 | C071 | 685 | 537 | 500 | 352 | 72 | 65 | Y Y N N | | 15238 | C009 | 411 | 393 | 365 | 365 | 88 | 92 | Y Y Y Y | | 15238 | C011 | 381 | 372 | 125 | 125 | 32 | 33 | Y Y N N | | 15238 | C095 | 334 | 318 | 10 | 9 | 2 | 2 | Y N N N | |-------|------|--------|--------|-------|-------|-------|-------|---------| A = CARRIER ROUTE DISCOUNT B = 125 WALK SEQUENCE C = 90% RESIDENTIAL SATURATION DISCOUNT D = 75% TOTAL ACTIVE SATURATION DISCOUNT

Address attributes When you perform DSF

Both, for every address that was assigned, address attributes are available in the following output fields. Be sure to include the fields containing information you’ll need in your output file block.

processing in ACE with DSF2 Mode set to Augment or

DSF2

DSF2 address-attribute output fields

Address attributes for the assigned address are available in AP fields. Address

Link

attributes for the address post-NCOA

processing, if applicable, are available

in APM fields.

Field Length Description

AP.DSF_Vacant, APM.DSF_Vacant

AP.DSF_Tback, APM.DSF_Tback

AP.DSF_Season, APM.DSF_Season

AP.DSF_Busind, APM.DSF_Busind

AP.DSF_Rectyp, APM.DSF_Rectyp

1 Vacant address indicator.

Y N

blank

Address is vacant.

Address is not vacant.

Address was not looked up.

1 Throwback indicator.

Customer with street address wants delivery at PO Box instead.

No throwback necessary.

blank

Address was not looked up.

1 Seasonal address indicator.

Y N

blank

Address is seasonally occupied.

Address is not seasonal.

Address was not looked up.

1 Residential/business indicator. You may use this infor-

mation to lower your parcel-shipping costs. (Some parcel delivery services charge more for delivery to residential addresses.)

Y N

blank

Business address.

Not a business address.

Address was not looked up.

1 Record type.

B R U G

blank

Business address. Residential address. Unknown. AP.DSF_Deltype is blank.

General delivery.

No information available.

ACE 7.72c Release Notes

AP.DSF_Deltyp, APM.DSF_Deltyp

AP.DSF_Dropin, APM.DSF_Dropin

AP.DSF_Dropct, APM.DSF_Dropct

1 Delivery type.

1 2

3 4

Door-slot delivery.

blank

Curb-side delivery. NDCBU (Neighborhood Delivery Centralized

Box Unit) delivery. Central delivery.

Address was not looked up.

1 Drop indicator.

Delivery point serves multiple businesses or families. For example, delivery point may be a CMRA (Commercial Mail Receiving Agency).

blank

Delivery address is not a CMRA. Address was not looked up.

3 Drop count. If AP.DSF_Dropin or APM.DSF_Dropin

contains Y or AP.DPV_CMRA contains Y, then this field contains a value from 000 to 999, indicating the number of businesses or families served by this delivery point.

Field Length Description

Walk

AP.DSF_Edu,

1 Educational indicator.

APM.DSF_Edu

AP.DSF_LACS,

1 LACS (Locatable Address Conversion System) indica-

APM.DSF_LACS

Walk sequencing If yo u want to use DSF

so that you can claim walk-sequence discounts, be sure to set DSF2 Mode in the Execution block to Sequence or Both. See “Enable DSF2 processing” on page 8.

walk sequence:

The order in which the letter carrier delivers mail for a route. This

order is required for most Carrier Route presort mail.

An Introduction to Mailing for Businesses and Organizations

http://pe.usps.gov/text/dmm200/reference.htm

When you perform DSF information to your data, which you can use with presorting software to qualify for walk-sequence discounts. ACE does not place your data in walk sequence.

Y N

blank

Address is an educational institution.

Address is not an educational institution.

Address was not looked up.

tor.

Y N

blank

processing to add walk-sequence information to yo ur list

Address is LACS convertible.

Address is not LACS convertible.

Address was not looked up.

, USPS

sequencing in ACE, ACE adds delivery sequence

Pseudo sequence DSF

USPS walk sequencing. Where USPS walk-sequence numbers cover every address, DSF addresses in that particular file.

address, whether or not they’re included in your list or mailing

0001

ACE uses DSF confirmed delivery points (AP.DPV_Status or APM.DPV_Status contains “Y”). Other addresses present in your output file that are not valid DPV-confirmed delivery points will receive “0000” as their sequence number.

walk sequencing is often called “pseudo” sequencing because it mimics

processing provides “pseudo” sequence numbers for only the

sequencing includes every U.S.

0002

0003

data to assign sequence numbers for all addresses that are DPV-

seudo sequencing includes only the addresses in your list. In the illustration below, assume the middle house is not included in your list.

0001

0002

DSF2

Processing notes When you walk sequence your mail with ACE, remember the following points:

 Batch only. DSF

sequencing is available only in batch mode. You cannot

assign sequence numbers in Quick ACE, for example.

 No posting to input file. If you are sequencing, you must post to a non-

delimited output file. You cannot post walk-sequence numbers to the input file.

 Filters. Do not fil ter on AP.Walk_Seq to create multiple output files. Also, do

not filter on AP.Walk_Seq in the Copy parameter.

 DSF

output. The ACE output file (from DSF2 processing) correctly outputs

zeros (0000) for ZIP+4 assignments that do not receive a DPV confirmation. However, Postalsoft Presort software expects a blank. If you are using Postalsoft Presort, change these 0s to a blank in your output. If you don’t do this, you might receive postal discounts that you are not eligible for because of differences in walk-sequence field values between ACE and Presort.

 File changes? Reprocess! If your data changes in any way, you mu st re-

assign sequence numbers. Sequence numbers are valid only for the data file as you process it at the time.

False positives. When ACE encounters a false positive in a DSF2 job that is

set up for sequencing, it locks DPV processing and does not sequence the output file. ACE adds the following message to the DPV lock section in the Job Summary Report:

DSF2 walk-sequence output fields

“Output files were not sequenced because DPV was locked.”

ACE outputs walk-sequence information to the following fields. If you want to assign walk-sequence numbers, these fields must be present in your output file.

Field Length Description

AP.Walk_Seq 4 Walk Sequence number.

Contains sequence number 0000-9999.

Link

If you perform NCOA

and DSF2 processing at the

same time, the assigned sequence number is based on the move-updated address if one exists. If no move-updated address exists, then the assigned sequence is based on the original address.

AP.DSF_Seqsrc 1 DSF sequence source.

Indicates which address is the basis for the assigned walk sequence (AP.Walk_Seq).

Original address.

Move-updated address (available if you’re performing

Link

NCOA

processing also).

ACE 7.72c Release Notes

LOT (line-of-travel) fields. If the AP.LOT and AP.LOT_Order fields (or APM.LOT and APM.LOT_Order fields) are present in your output file, they

will be empty as a result of DSF

processing in accordance with USPS rules.

This effects all records in your input file. Walk-sequence information

retrieved from DSF

processing is more accurate than LOT codes, and

therefore the USPS requires that LOT and LOT Order fields be erased when

processing is performed.

DSF

Reports If you are claiming walk-sequence discounts, the USPS requires the Delivery

Sequence Invoice report. See “Set up the Delivery Sequence Invoice report” on

page 12.

See also “ACE Job Summary report” on page 25.

Statistics files The job statistics file and file statistics file now contain DSF

“Updated statistics files” on page 26 for details.

DSF2 Log file The USPS requires DSF

the DSF

log file. The naming format for the log file is as follows:

licensees to save information about their processing in

[licensee number][mmyy].dat

The USPS dictates the contents of the DSF it to them monthly . For detai ls, see the DSF

log file and requires that you submit

Licensee Performance Requirements document, which is available on the USPS RIBBS website (http://ribbs.usps.gov/ ).

You must submit the DSF

log file to the USPS by the third business day of each

month by e-mail to Carrie Feldhaus at the USPS (carrie.feldhaus@usps.gov).

information. See

DSF2

Suite

Link

How does Suite work?

Link

Preview only. We are in the process of finalizing our Suite Therefore, you can preview some of the new Suite

Link

solution.

options in ACE 7.72c.

When licensing is in place, you will be able to order this for-sale option.

With Suite

Link

you can build accurate and complete addresses by adding suite numbers to high-rise business addresses. With the secondary address information added to your addresses, more of your pieces are sorted by delive ry sequence and delivered with accuracy and speed.

Link

Access to Suite

data is available through ACE Views, Job, Library, and

Printform ACE as an add-on feature.

Suite

Link

is a USPS directory. It contains multiple files of specially indexed

information like secondary numbers and unit designators for high-rise buildings.

Link

ACE uses the data in the Suite

product to add suite numbers to an address.

ACE matches a company name, a known high-rise address, and the CASS-

Link

certified ZIP+4 in your database to data in Suite

. When there is a match, ACE

creates a complete business address that includes the suite number.

Note: ACE uses the firm information from the PW.FIRM field. If there is nothing in the PW.FIRM field, ACE checks any multiline input fields that are present (for example, LINE1-LINE12). This information is generally found in the AP.Extra9 and AP.Extra10 fields.

Look at the AP.Input_Firm field to see what firm ACE used.

ACE 7.72c Release Notes

Suite

Link

example This example shows a record that is processed through Suite

record with the assigned suite number.

The input record contains:

 Firm name (in AP.Input_Firm field)  Known high-rise address  CASS-certified ZIP+4

SuiteLink directory contains:

 secondary numbers  unit designators

Output record contains:

 Correct suite number

ACE Input Record SuiteLink directory ACE output

Link

, and the output

Poplar Auto 987 Main St 12345-6789

Poplar Medical Sales Ste 212 Poplar Auto Sales Ste 214 Poplar Computers Ste 216 Wilson Law Firm Ste 218 Boyce’s Kayaks Ste 220

Poplar Auto 987 Main St Ste 214 12345-6789

SuiteLink

Suite

Link

directory The Suite

Link

directory is distributed monthly. You must use the Suite

Link

directory with a ZIP+4 directory labeled for the same month. For example, the

Link

December 2006 Suite

directory can be used with only the December 2006

ZIP+4 directory.

Non-CASS mode: SuiteLink is disabled if you are running your job in non-

CASS mode.

Becomming a

Link

Suite

Set up Suite

licensee

Link

for

ACE Views or job file

Turn on Suite

Link

processing

You cannot use a Suite

Link

directory that is older than 60 days based on its release

date. ACE warns you 15 days before the directory expires. As with all directories,

Link

ACE won’t process your records with an expired Suite

If you are interested in purchasing ACE’s Suite

Link

become a licensed Suite purchase the ACE Suite

data user/data distributor through the USPS. Then, to

Link

add-on option, contact Business Objects at

Link

add-on option, you must first

directory.

http://www.firstlogic.com/customer.

For information about applying for a license, go to the RIBBS website (http://

ribbs.usps.gov/) and click Suite

ACE automatically prepares your data for Suite

Link

in the left column.

Link

processing by assigning accurate ZIP+4 and the correct CASS Qualitative Statistical Summary (QSS) high-rise address. This information makes processing more efficient and increases the accuracy of the secondary address assignment.

Link

There are just a few parameters that you need to complete to set up Suite

There is a new option in the Execution sec tion: Perform Suite

Link

Processing.

Either select the option in ACE Views or enter Y to activate it in ACE job file.

ACE 7.72c Release Notes

BEGIN Execution ============================== Assignment Mode(NONE/ASSIGN/PARSE/GEO)= Assign Assign Which Records (ALL/UNASSIGNED) = ALL

Perform Mover ID NCOALink (Y/N)...... = N

Perform Z4Change Processing (Y/N).... = N

Perform GeoCensus Processing (Y/N)... = N

Perform EWS Processing (Y/N)......... = N

Perform eLOT Processing (Y/N)........ = Y

Perform RDI Processing (Y/N)......... = N

Perform LACSLink Processing (Y/N).... = N

Perform SuiteLink Processing (Y/N)... = Y DPV Mode (VALIDATE/TIEBREAK/BOTH/N).. = N DSF2 Mode (AUGMENT/SEQUENCE/BOTH/N).. = N

Enable TaxIQ Feature (Y/N)........... = N

Enable Non-CASS Features (Y/N)....... = N

+ Sort Input File by ZIP Code (Y/N).. = N

Warn Before File Overwrite (Y/N)..... = Y

Show Detailed Process Messages (Y/N). = Y

Message Update Increment............. = 100

Work File Directory (path)........... =

Create Backup File (Y/N)............. = Y

Backup Directory (path).............. =

Create Reports (Y/N)................. = Y

END

Specify the path to

Link

Suite

files

Enter the path for the location of the Suite

Link

directories in the Auxiliary Files

section. Also, Suite

Link

uses the same supporting files as NCOA

files allow the software to parse name data for possible NCOA

Link

. These supporting

Link

and Suite

Link

assignment. Therefore, the NCOALink Supporting Files parameter is renamed to

Name Parsing Files. The default location of the name parsing files is <install_dir>/pw/ace/ncoalink.

The supporting files consist of:



acenpe.dat



acenpr.dat



acenpu.dat



pwcap.dct



acenp.so

(on all UNIX



acenpp.dat



acenps.dat



parsing.dct



acenp.dll



acenp.sl

(on Windows)

(on HP)

platforms except HP)

BEGIN Auxiliary Files ================================ City Directory (path & city09.dir)... = city09.dir

ZCF Directory (path & zcf09.dir)..... = zcf09.dir

ZIP+4 Directory 1 (path & zip4*.dir). = zip4us.dir ZIP+4 Directory 2 (path & zip4*.dir). = Rev ZIP+4 Dir (path & revzip4.dir)... = revzip4.dir EWS Directory (path & ewyymmdd.dir).. = ew*.dir

eLOT Directory (path & elot.dir)..... = elot.dir

RDI Directory (path only)............ =

LACSLink Directory (path only)....... =

SuiteLink Directory (path only)...... =

DPV Directory (path only)............ =

DSF2 Directory (path only)........... =

DELSTATS Directory (path & dsf.dir).. =

NCOALink Directory (path only)....... =

Name Parsing Files (path only)....... =

TaxIQ File (path & file name)........ =

Firm Line Dct (path & firmln.dct).... = firmln.dct

Address Line Dct (path & addrln.dct). = addrln.dct

Last Line Dct (path & lastln.dct).... = lastln.dct

Capitalization Dct (path & pwcas.dct) = pwcas.dct

Default Format (path & file name).... =

Default DEF (path & file.def)........ =

END

SuiteLink

Improve processing speed You may increase Suite

into memory. To activate this option, go to the Memory Usage block and enter Y in the Load SuiteLink Dirs into Memory option (Job) or select Load SuiteLink Directories into System Memory (Views).

Link

processing speed if you load the Suite

BEGIN Memory Usage ======================================== Windows Use Extended Memory (See Note)= NONE Windows Memory Window Size (# of MB). = Load RDI Dirs into System Memory (Y/N)= N Load LACSLink Dirs into Memory (Y/N). = N Load SuiteLink Dirs into Memory (Y/N) = Y Load DPV Dirs into System Memory (Y/N)= N

Load DSF2 Dirs into Memory (Y/N)..... = N

NCOALink Memory (AUTO/MANUAL/N)...... = N

NCOALink Memory Allocation (# of MB). = Cache for ZIP Order Processing (Y/N). = N Insufficient Memory Action(ABORT/CONT)= ABORT END

Link

Reports Suite

require specific Suite The ACE Job Summary report now shows the number of Suite

the percentage based on the total records processed. See also “ACE Job Summary report” on page 25.

Link

information is available in the ACE Job Summary. The USPS does not

Link

reports.

Link

matches and

Statistics files The file, job, and address-conversion statistics files now contain Suite

information. See “Updated statistics files” on page 26.

Suite

Link

output fields The following new Suite

about Suite

Link

and ACE Library, see “Set up SuiteLink processing in ACE

Link

output fields are available. For more information

Library” on page 24.

ACE Views or job-file field

AP.SteLink_RC ACE_SUITELINK_

ACE Library field Length Description

2 The result of Suite

RETCODE

Suite

assigned to this record as a result of Suite

Suite

Link

processing.

Link

match—secondary information exists and was

Link

no match—lookup was attempted but no match-

Link

ing record could be found.

blank

A Suite

Link

lookup was not attempted because one of the

following was true:



The address was not a highrise default according to CASS.



The address did not contain a firm.

AP.PreSL_ZIP ACE_PRESL_ZIP 5 The ZIP Code that was assigned by ACE before Suite

ing. 5-digit ZIP Code The AP.SteLink_RC value is A.

blank

No ZIP Code assigned.

AP.PreSL_ZIP4 ACE_PRESL_ZIP4 4 The ZIP+4 that was assigned by ACE before Suite

Link

The ZIP+4 is either for a high-rise default or street default record.

Link

processing.

Link

process-

processing.

AP.PreSL_DPBC ACE_PRESL_DPBC 2 The numeric 2-digit code for the delivery point barcode that was

generated before Suite

AP.PreSL_SecR ACE_PRESL_SEC_

RANGE

up to 8 The secondary range information that existed before Suite

cessing. If this is blank, ACE did not assign any secondary infor-

Link

processing.

Link

pro-

mation.

AP.PreSL_Unit ACE_PRESL_UNIT_

DESIG

AP.Input_Firm ACE_INPUT_FIRM 60 The firm name from your input file that is used only for Suite

up to 10 The unit designator that existed before SuiteLink processing. If

this is blank, ACE did not assign any secondary information.

Link

processing. ACE matches the contents of this field to Suite data. To see what firm name Suite

Link

used for processing, look at

Link

the contents of this field.

SuiteLink

Output information for Customer Service Log (CSL)

When you run Suite

Link

concurrently with NCOA

Link

, the following fields are

populated in the CSL.

Field name Length (characters) Position from/to

Link

Suite Suite Suite Suite Suite

Software Name 30 from 2143 to 2172

Link

Software Version 12 from 2173 to 2184

Link

Data Release Date 8 from 2185 to 2192

Link

Return Code A—Match 11 from 2193 to 2203

Link

Return Code 00—No Match 11 from 2204 to 2214

Set up Suite

Link

processing in ACE

Link

Suite

is available in ACE Library and is supported by specific Suite

file identifiers.

Link

mode

Library

Enable Suite directory

Symbol for mode_ID Default modes Description

Link

and cache

Use these ACE_Mode file identifiers to enable Suite Use these with the ace_set_mode() and ace_get_mode() functions.

Link

and to set up caching.

ACE_MODE_ENABLE_SUITELINK FALSE Set to True to enable SuiteLink in ACE Library. ACE_MODE_CACHE_SUITELINK_D

IRS

F ALSE Set to True to enable caching the SuiteLink directories to the

ACE Library.

ACE_MODE_CACHE_ERROR FALSE If you cache the SuiteLInk directories, you must specify if

you want to stop processing if insufficient memory is available.



Set this option to FALSE to continue SuiteLink processing without caching.



Set this option to TRUE to discontinue processing. When this option is set to TRUE and there is not enough system memory available to load the SuiteLink directories, the function callace_open() will fail.

Note: This option has no effect unless ACE_MODE_CACHE_SUITELINK_DIRS is set to TRUE.

Locations for Suite directory files

Link

Suite

Link

and NCOA

mode file identifiers to set up the directories for both NCOA

Link

use the same support files. Use the new and revised

Link

and Suite

Link

Use these with the ace_set_file(), and ace_get_file() functions.

New file define Old file define Description

ACE_DIR_SUITELINK N/A (this is a new file define) The SuiteLink directory location (path

only).

ACE_DIR_NAME_P ARSING_FILES ACE_DIR_NCOALINK_SUPPORT The NCOALink and SuiteLink directory

locations (path only.

ACE 7.72c Release Notes

ACE Job Summary report

Updated Setup Information section

Updated Auxiliary Files section

The ACE Job Summary report contains new and updated sections with information about the new DSF

and Suite

Link

features. See the samples below.

The Setup Information section of the ACE Job Summary shows whether Suite

or DSF

The Auxiliary Files section now lists the DSF2 and Suite

was enabled for this job.

Assign Which Records: All Assignment Mode: Assign Enable Non-CASS: N Geo Mode: N/A Enable EWS: N Enable eLOT: Y DPV Mode: Y Enable TaxIQ: N Enable RDI: N Enable LACSLink: N Enable SuiteLink: Y DSF2 Mode: Both

Link

files and paths.

Auxiliary Files -------------------------------------------------------------

File Description Date File Name

------------------------- ---------- --------------------------------------... eLOT Directory 01/2006 C:\dirs\elot.dir DPV Directory RDI Directory LACSLink Directory SuiteLink Directory 11/14/2006 C:\dirs Z4 Change Directory DSF2 Directory DELSTATS Directory

Link

Updated CASS

The CASS QSS section shows the number and percentage of Suite

Link

matches.

Qualitative Statistical Summary section

Count % Count %

------------------------------------ -------------------------------------High Rise Default 8 10.26 Rural Route Default 0 0.00 High Rise Exact 70 89.74 Rural Route Exact 0 0.00 EWS Match 0 0.00 LACS Convertible 0 0.00 DPV Confirmed 0 0.00 RDI 0 0.00 LACSLink Conversions 0 0.00 SuiteLink Matches 76 97.44

CASS Qualitative Statistical Summary (QSS)

(Percentages based on # of records passing the filter)

Note: The High Rise Default information reflects the number of high rise

Link

defaults after Suite

processing.

New DSF2 section The new Second Generation Delivery Sequence File section of the ACE Job

Summary report shows counts and percentages of addresses in your file that

match the various DSF

categories.

This same information appears in the Mover ID Summary report for post-move addresses.

Second Generation Delivery Sequence File (DSF2) (Percentages based on # of records passing the filter Indicators Count % Delivery Types Count %

--------------------------------- -----------------------------------Drop 0 0.00 Curb 0 0.00 Business 0 0.00 NDCBU 0 0.00 Throwback 0 0.00 Central 0 0.00 Seasonal 0 0.00 Door Slot 0 0.00 Educational 0 0.00 Vacant 0 0.00 LACS 0 0.00

ACE Job Summary report

Updated statistics files

Job and file statistics files

The file statistics file, job statistics file, and Address Conversion S tat istics (ACS)

file now contain information about DSF

and Suite

In the file statistics file, the DSF2 and Suite

Link

processing.

fields appear between the rdi_p

and e101 fields, in the order listed below.

Field Length Description

ste_match 10 Number of Suite ste_p 6 Percentage of Suite dsf_drop 10 Number of DSF dsf_drop_p 6 Percentage of DSF dsf_business 10 Number of DSF dsf_business_p 6 Percentage of DSF dsf_throwback 10 Number of DSF dsf_throwback_p 6 Percentage of DSF dsf_seasonal 10 Number of DSF dsf_seasonal_p 6 Percentage of DSF dsf_educational 10 Number of DSF dsf_educational_p 6 Percentage of DSF dsf_vacant 10 Number of DSF dsf_vacant_p 6 Percentage of DSF dsf_lacs 10 Number of DSF dsf_lacs_p 6 Percentage of DSF dsf_curb 10 Number of DSF dsf_curb_p 6 Percentage of DSF dsf_ndcbu 10 Number of DSF

Link

matches.

Link

matches.

drop matches.

business matches.

throwback matches.

seasonal matches.

educational matches.

vacant matches.

LACS matches.

curb matches.

NDCBU (Neighborhood Delivery

Centralized Box Unit) matches. dsf_ndcbu_p 6 Percentage of DSF dsf_central 10 Number of DSF dsf_central_p 6 Percentage of DSF dsf_slot 10 Number of DSF dsf_slot_p 6 Percentage of DSF

NDCBU matches.

central matches.

doorslot matches.

ACE 7.72c Release Notes

ACS file The USPS ACS file now includes Suite

appear at the end of the file in the order listed below. These new fields are also present in the USPS-required NCOA

service log (CSL) file.

Field Length Description

STE_SWNAME 31 Suite STE_SWVER 13 Suite STE_DIRDAT 9 Suite STE_RET_A 11 Suite STE_RET_00 11 Suite

Link

information. The Suite

Link

software name.

Link

software version.

Link

directory date.

Link

return code “A” matches.

Link

return code “00” matches.

Link

customer

fields

Updated statistics files

DPV No Stats indicators

The USPS uses No Stats indicators to mark addresses that fall under t he No Stats category. ACE uses the No Stats table when you have DPV or DSF your job. The USPS classifies No Stats addresses as those that:

 do not have established delivery yet  receive mail as part of a drop  have been vacant for a certain period of time

No Stats table ACE performs DSF

No Stats table (dpv_no_stats.dir). The No Stats table is supplied by Business Objects on the DPV directory install CD.

ACE automatically checks for the No Stats t able in the director y folder that you indicate in your job setup. ACE performs DSF install status of the directory.

dpv_no_stats.dir Type of

Installed DSF

Not installed DSF

turned on in

and DPV processing based on the install status of the DP V

and DPV processing based on the

Results

processing

ACE checks the No Stats table and outputs No Stats indicators when you include the No Stats output fields in your job.

ACE stops processing and displays an error message telling you to install the No Stats table.

Installed DPV ACE autom atically perform s DPV processing

and outputs No Stats indicators when you include the No Stats output fields in your job.

Not installed DPV ACE automatically skips the No Stats processing

and does

not

issue an error message. ACE will perform DPV processing but won’t populate the AP.DPV_NoStat and APM.DPV_NoStat output fields.

CASS mode: In all of these instances, ACE does not perform DSF2 or DPV

processing when you are not running ACE in CASS mode.

No Stats output fields Use the new No Stats output fields to post No Stat indicator information to an

output file.

ACE Job-file and Views

AP.DPV_NoStat APM.DPV_NoStat

ACE Library Length Description

ACE_DPV_NO_STATS 1 No Stat indicator. No Stat means that the address is a vacant

property, it receives mail as a part of a drop, or it does not have an established delivery yet.

Y N

blank

Address is flagged as No Stat in DPV data. Address is not No Stat. Address was not looked up.

T o indicate the maximum length of this component in ACE Library, use ACE_DPV_NO_STA TS_LEN.

ACE 7.72c Release Notes

Business objects ACE 7.72C User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Introduction

What’s new in this release

What’s in your package

Product versions Product versions for this release are as follows:

Installation

Installation advice To simplify installation, read the following tips before you begin:

Install ACE on Windows

Install ACE on UNIX T o install ACE on UNIX, u se the install_consol e installation for the Jav a Runtime

Client shortcuts If you have ACE installed on one computer , but you run it from another comp uter

If you use ACE Views, job file, or RAPID, run Edjob

Operating system versions

What is DSF2? DSF

ACE’s DSF2 option ACE provides access to DSF

Becoming a DSF2 licensee

DSF2 directories DSF

Set up DSF2 processing in ACE

Address attributes When you perform DSF

Walk sequencing If yo u want to use DSF

Reports If you are claiming walk-sequence discounts, the USPS requires the Delivery

Statistics files The job statistics file and file statistics file now contain DSF

DSF2 Log file The USPS requires DSF

Reports Suite

Statistics files The file, job, and address-conversion statistics files now contain Suite

Output information for Customer Service Log (CSL)

ACE Job Summary report

Updated Setup Information section

Updated Auxiliary Files section

New DSF2 section The new Second Generation Delivery Sequence File section of the ACE Job

Updated statistics files

Job and file statistics files

ACS file The USPS ACS file now includes Suite

DPV No Stats indicators

No Stats table ACE performs DSF

No Stats output fields Use the new No Stats output fields to post No Stat indicator information to an