Finds the next geographic information record with partial matching to input names.
Syntax
01 GSID PIC S9(9) BINARY.
01 GSFUNSTAT PIC S9(9) BINARY.
*
CALL "GSFGN" USING GSID, GS-GEOGRAPHIC-INFO, GSFUNSTAT.Arguments
GSID Returned by GSINITWP for the current instance of GeoStan. Input.
GSFUNSTAT Return value for the procedure. Output.
Return Values
Next Geographic Information Record which has a partial match to the input.
"GSFUNSTAT" contains a value of "GS-SUCCESS" if there are one or more matching records.
See GSFGF for the remainder of the output fields.
Prerequisites
GSINITWP
GSFGF (Previous call with return status equal
"GS-SUCCESS")
Notes
This procedure retrieves the next Geographic information record which matches the input city, county, or state names. A previous call to "GSFGF" is required, with a returned status of "GS-SUCCESS".
The COBOL copy member "GEOSTAN" includes the record "GS-GEOGRAPHIC-INFO" which has the correct format for this function.
Input values may be zero-byte terminated strings or fixed-length with space padding. The returned values are fixed-length with space padding. The optional field "GS-INPUT-COUNTY" should be filled with spaces if it is not used.