Using the Routine

The 900-GEO-GET-NEXT-GEOCODE routine is typically called within a loop which is terminated when VTX-ERROR-STATUS contains the value E.

  1. Call the 900-GEO-SET-NAME-CRITERIA routine or the 900-GEO-SET-GEOCODE-CRITERIA routine.

    This step resets the pointer in the list so that the following call to 900-GEO-GET-NEXT-GEOCODE returns the first GeoCode. The reset occurs even if the set criteria have not changed.

  2. Call the 900-GEO-GET-NEXT-GEOCODE routine.
  3. Examine the VTX-ERROR-STATUS field to determine if an error occurred.

    If an error occurred, display the VTX-ERROR-MSG field.

    – or –

    If VTX-ERROR-STATUS = E, then no more GeoCodes exist for the set criteria.