GSDPVGFH - geostan_1 - 2024.01

GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > GeoStan
Version
2024.01
Language
English
Product name
GeoStan
Title
GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS
Copyright
2024
First publish date
1994
Last updated
2024-07-29
Published on
2024-07-29T23:01:18.924000
Retrieves DPV statistics for the header record for a DPV false positive report.
Note: If singleline address input is used, the output from GSDPVGFH will be incorrect.

Syntax

01 GSID                         PIC S9(9) BINARY.
GS-FALSE-POS-HEADER-DATA
01 RETURN-CODE                  PIC 9(9) BINARY.
CALL "GSDPVGFH" USING GSID, GS-FALSE-POS-HEADER-DATA, GS-FPHD-SIZE, RETURN-CODE.

Arguments

GSID   ID returned by GSINITWP for the current instance of GeoStan. Input.

GS-FALSE-POS-HEADER-DATA    Retrieves DPV statistics from the header record for false positive address matches using the data passed in GSDPVGFD. The output data members are statistics for the false positive reports. The input data members include information to correctly complete the false positive report for the USPS. This structure contains the following:

GS-FPHD-MAILERS-ADDRESS-LINE    Address of the mailer. Input.

GS-FPHD-MAILERS-CITY-NAME    City of the mailer. Input.

GS-FPHD-MAILERS-COMPANY-NAME    Name of the mailer. Input.

GS-FPHD-MAILERS-STATE-NAME    State of the mailer. Input.

GS-FPHD-MAILERS9-DIGITZIP    ZIP Code of the mailer. Input.

GS-FPHD-NUMBER-FALSE-POS    Number of found DPV false positive matches. Output.

GS-FPHD-NUMBER-ZIP-ON-FILE    Number of distinct ZIP Codes processed through DPV. Output.

GS-FPHD-TOTAL-MATCHED    Number of records matched with DPV data. Output.

GS-FPHD-TOTAL-PROCESSED    Number of records processed through DPV. Output.

GS-FPHD-TOTAL-ZIP4-MATCHED    Number of records that have matched with ZIP + 4. Output.

RETURN-CODE    Size of the GSDPVGFD data structure. Input.

Return Values

GS-SUCCESS

GS-ERROR   Call GSERRGTX for more information

GS-WARNING   Call GSERRGTX for more information

Prerequisites

GSINITWP with the appropriate DPV initialization properties set.