GSVGSDDT - geostan_1 - 2024.01

GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > GeoStan
Version
2024.01
Language
English
Product name
GeoStan
Title
GeoStan Geocoding Suite Reference for Windows, Linux, and z/OS
Copyright
2024
First publish date
1994
Last updated
2024-07-29
Published on
2024-07-29T23:01:18.924000

Validates the presence of data for specified states in the GSD data file.

Syntax

01    GSID                    PIC S9(9) BINARY.
01    STATES                  OCCURS 100 TIMES.
05    STATE-CODE              PIC X(3).
05    STATE-COUNT             PIC S9(9) BINARY.
01 GSFUNSTAT                  PIC S9(9) BINARY.

CALL "GSVGSDDT" USING GSID, STATES, GSFUNSTAT.

Arguments

GSID   ID returned by GSINITWP for the current instance of GeoStan. Input.

STATES   Structure containing the list of state abbreviations and/or FIPS codes. Input.

GSFUNSTAT   Return value for the procedure. Output.

Return Values

GS-SUCCESS   All states specified in STATES are present in the GSD data.

GS-GSD-DATA-MISSING    One or more states specified in STATES are not present in the GSD data.

GS-ERROR    STATES structure is invalid.

Notes

If GeoStan did not find the GSD primary data for all the specified states, this function creates an error in the error list retrievable using GSERRGTX. The error message code is 114 and the error message is "NO GSD DATA FOUND FOR STATE" and indicates which states GeoStan did not find.

The state abbreviations and corresponding state FIPS codes are as follows:

State

Abbrev.

FIPSCodeaa

State

Abbrev.

FIPSCodea

Alabama

AL

1

New Jersey

NJ

34

Alaska

AK

2

New Mexico

NM

35

Arizona

AZ

4

New York

NY

36

Arkansas

AR

5

North Carolina

NC

37

California

CA

6

North Dakota

ND

38

Colorado

CO

8

Ohio

OH

39

Connecticut

CT

9

Oklahoma

OK

40

Delaware

DE

10

Oregon

OR

41

District of Columbia

DC

11

Pennsylvania

PA

42

Florida

FL

12

Rhode Island

RI

44

Georgia

GA

13

South Carolina

SC

45

Hawaii

HI

15

South Dakota

SD

46

Idaho

ID

16

Tennessee

TN

47

Illinois

IL

17

Texas

TX

48

Indiana

IN

18

Utah

UT

49

Iowa

IA

19

Vermont

VT

50

Kansas

KS

20

Virginia

VA

51

Kentucky

KY

21

Washington

WA

53

Louisiana

LA

22

West Virginia

WV

54

Maine

ME

23

Wisconsin

WI

55

Maryland

MD

24

Wyoming

WY

56

Massachusetts

MA

25

American Samoa

AS

60

Michigan

MI

26

Guam

GU

66

Minnesota

MN

27

North Mariana Islands

MP

69

Mississippi

MS

28

Palau

PW

70

Missouri

MO

29

Puerto Rico

PR

72

Montana

MT

30

Virgin Islands

VI

78

Nebraska

NE

31

Nevada

NV

32

New Hampshire

NH

33

aDo not specify Minor Islands (UM, 74) or you will receive an error. This is defined as a FIPS code, but the USPS does not generate data for this code.

The following pseudo FIPS codes support APO and FPO addresses:

Address

Abbrev.

FIPS Code

Armed Forces Europe

AE

57

Armed Forces Pacific

AP

58

Armed Forces Americas

AA

59