Deprecated. Specifies the datum GeoStan uses to calculate address coordinates.
Syntax
01 GSID PIC 9(09) BINARY.
01 NEWDATUM PIC 9(09) BINARY.
01 GSFUNSTAT PIC S9(09) BINARY.
*
CALL "GSSDATUM" USING GSID, NEWDATUM, GSFUNSTAT.Arguments
GSID ID returned by GSINIT for the current instance of GeoStan. Input.
NEWDATUM Variable value indicating the datum to use in returning address coordinates. Valid variables are DATUM-NAD87 and DATUM-NAD83. Input.
GSFUNSTAT Return value for the procedure. Output.
Return Values
GS-SUCCESS GeoStan used the requested datum to calculated the existing coordinates (no conversion required), or the files for the requested datum were present.
GS-ERROR Did not find all of the files for the requested datum. GeoStan does not reset the datum, and continues to use the current datum. Call GSERRGET to find the datum files that were not loaded.
Prerequisites
GSINIT
Notes
A datum is a mathematical model of the Earth used to calculate the coordinates on any map, chart, or survey system. The North American Datum (NAD) is the official reference ellipsoid used for the primary geodetic network in North America.
Use GSSDATUM to select the datum you want GeoStan to use when returning address coordinates via GSDATGET.
You must call GSSDATUM before calling GSSFIND to ensure that the lat and lon values are cached and are not modified.
This setting affects only the numeric coordinates returned by GSDATGET for the latitude and longitude of an address.
Although the arguments are DATUM_NAD27 and DATUM_NAD83, note that GTD uses WGS84 instead of NAD83. These two coordinate systems are compatible.