Allows GeoStan to use a record found outside of GSSFINDWP as a match.
Syntax
01 GSID PIC S9(9) BINARY.
01 GSFUNSTAT PIC S9(9) BINARY.
01 GSOPTIONS PIC S9(9) BINARY.
01 RANGE-HANDLE PIC S9(9) BINARY.
*
CALL "GSSSELR" USING GSID, RANGE-HANDLE, GSOPTIONS, GSFUNSTAT.Arguments
GSID ID returned by GSINITWP for the current instance of GeoStan. Input.
GSFUNSTAT Return value for the procedure. Output.
RANGE-HANDLE Range pointer of object to return as a match. A range record indicates a range of addresses such as "2800 – 2900 Center Green Drive". Input.
GSOPTIONS The following table contains the valid variables. Input.
|
GS-ADDR-CODE |
Attempts to standardize and find an address geocode. You must set this switch for address standardization. If this switch is not set, GeoStan uses only the input ZIP and ZIP + 4 address elements. |
|
GS-WIDE-SEARCH |
GeoStan considers all records matching the first letter of the street name, rather than the soundex key on the street name. This results in a wider search. |
|
GS-FINANCE-SEARCH |
When you add GS_FINANCE_SEARCH, GeoStan searches the entire Finance Area for possible streets. These modifiers have no meaning when doing a ZIP centroid match. |
|
GS-Z9-CODE |
Attempts to find ZIP + 4 centroid match only (no ZIP+2 or ZIP). |
|
GS-Z7-CODE |
Attempts to find ZIP+2 centroid match only (no ZIP + 4 or ZIP). |
|
GS-Z5-CODE |
Attempts to find a ZIP centroid match (no ZIP + 4 or ZIP+2). |
|
GS-Z-CODE |
Attempts to find a match based on all possible ZIP centroids available. |
If you specify GS_ADDR_CODE and a ZIP centroid option, GeoStan only returns a ZIP Code centroid match if an address geocode is not available.
You must use either GS_ADDR_CODE or GS_Z_CODE or both.(In general, you should specify both.) These option settings are additive.
If you enter a pre-parsed address, it must contain the USPS abbreviations for street type, predirectionals, and postdirectionals.
Return Values
GS-SUCCESS
GS-ERROR
Prerequisites
GSFFSEG
Notes
This procedure allows you to get a range handle which points to the address range you want to match to. Use this command to indicate that GSSFINDWP found the match, when in fact the match is set to whichever range handle is passed through the RANGE-HANDLE argument. You must specify the GSOPTIONS variable so that subsequent calls to GSDATGET have the type of location information to return.
This procedure returns standardized results from a list generated by GSFFSEG / GSFNRANG. This procedure performs a query procedure that lets the user choose from a list of possible matches.