Finds the first range object that meets the search criteria.
Syntax
01 GSID PIC S9(9) BINARY.
01 RANGE-HANDLE PIC S9(9) BINARY.
01 GSFUNSTAT PIC S9(9) BINARY.
*
CALL "GSFFRANG" USING GSID, RANGE-HANDLE, GSFUNSTAT.Arguments
GSID ID returned by GSINITWP for the current instance of GeoStan. Input.
RANGE-HANDLE Pointer to a range handle. Returns a valid handle if GeoStan finds a range. Input, Output.
GSFUNSTAT Return value for the procedure. Output.
Return Values
GS-SUCCESS Found a match. You can retrieve the data for that match using GSHGET.
GS-NOT-FOUND Did not find a match.
GS-ERROR An error occurred; use GSERRGET and GSERRGTX to retrieve more information.
Prerequisites
GSINITWP and GSCLEARNotes
You must call GSFFSEG before calling GSFFRANG.