Using the Routine

The U@GEOGETNXTG routine is typically called within a loop which is terminated when E@VERRORSTS contains the value E.

  1. Call the U@GEOSETNMCRI routine or the U@GEOSETGCRIT routine.

    This step resets the pointer in the list so that the following call to U@GEOGETNXTG returns the first GeoCode. The reset occurs even if the set criteria have not changed.

  2. Call the U@GEOGETNXTG routine.
  3. Examine the E@VERRORSTS field to determine if an error occurred.

    If an error occurred, display the E@VERRORMSG field.

    – or –

    If E@VERRORSTS = E, then no more GeoCodes exist for the set criteria.