Passes data for all address elements to GeoStan.
Syntax
01 GSID PIC S9(9) BINARY.
01 GSFUNSTAT PIC S9(9) BINARY.
01 GSOPTIONS PIC 9(9) BINARY.
01 VALUE PIC X(LEN).
*
CALL "GSDATSET" USING GSID, GSOPTIONS, VALUE, GSFUNSTAT.Arguments
GSID ID returned by GSINITWP for the current instance of GeoStan. Input.
GSFUNSTAT Return value for the procedure. Output.
GSOPTIONS Symbolic constant for the data item to load. See Variables for storing and retrieving data for a list of valid variables. Input.
VALUE String pointer containing the data to be loaded. Input.
Return Values
GS-SUCCESS
GS-ERROR
Prerequisites
GSINITWP
Notes
This procedure loads data elements into internal GeoStan buffers. When loading address information as a complete address or last line, GeoStan parses the data into fields. For example, if you entered a last line of "Boulder, CO 80301-1234", GeoStan parses the data and sets the city, state, ZIP, and ZIP + 4 fields. You can retrieve parsed data using GSDATGET and requesting the INPUT to these fields.
If you are passing both an address line and a last line or ZIP Code, be sure to enter the last line or ZIP Code first to ensure the greatest accuracy in address standardization.
If you are passing both the address information and the last line information as one input line, enter the address information first.
Using the appropriate parameters defined in the COBOL copy member "GEOSTAN", you can pass singleline addresses, two-line addresses, or multiline addresses of up to six lines. For more information, see Extracting Data from GSD Files.
Do not call GSSMM after a call to GSDATSET. If you need to change the match mode in mid-process, you must reenter the data for the current address with GSDATSET.