The following error codes are also in the header file pcmsdefs.h, found in the PC*MILER installation folder.


Error Codes
Value

Message

PCMS_INVALIDPTR
101

Invalid pointer

PCMS_NOINIFILE
102

The INI file was not found

PCMS_LOADINIFILE
103

Could not load the INI file

PCMS_LOADGEOCODE
104

Could not load location database

PCMS_LOADNETWORK
105

Could not load the network database

PCMS_MAXTRIPS
106

Too many open trips (limit of 8)

PCMS_INVALIDTRIP
107

Invalid trip ID

PCMS_INVALIDSERVER
108

Invalid server ID

PCMS_BADROOTDIR
109

Could not find RootDir setting in INI file

PCMS_BADMETANETDIR
110

Invalid PCMNetDir setting

PCMS_NOLICENSE
111

License infraction: too many users, or licenses not found

PCMS_TRIPNOTREADY
112

The trip is not ready to calculate

PCMS_INVALIDPLACE
113

Invalid place name (city, state not found)

PCMS_ROUTINGERROR
114

Calculation failed: portions of trip are invalid

PCMS_OPTERROR
115

Optimization failed: portions of the trip are invalid

PCMS_OPTHUB
116

Cannot optimize a trip in HUB mode

PCMS_OPT2STOPS
117

Not enough stops to optimize the trip

PCMS_OPT3STOPS
118

Not enough stops to optimize without changing destination

PCMS_NOTENOUGHSTOPS
119

Not enough stops to calculate the trip

PCMS_BADNETDIR
120

Bad network directory

PCMS_LOADGRIDNET
121

Error loading gridded network

PCMS_BADOPTIONDIR
122

Bad option directory

PCMS_DISCONNECTEDNET
123

Disconnected network

PCMS_NOTRUCKSTOP
PCMS_INVALIDREGIONID
124
125

Truck inaccessible stop

Invalid region ID

PCMS_CLOSINGERROR
126

Engine did not shut down properly

PCMS_NORTENGINE
127

Engine could not properly initialize internal routing component

PCMS_NODATASERVER
128

Engine could not properly initialize internal routing component

PCMS_SWITCHDIR
129

Connect could not switch the current working directory for the directory specified by ‘DLLPath’ in the INI file

PCMS_NOACTIVATE
135

Your product or add-on license has not yet been activated

PCMS_EXPIRED
136

Your license has expired

PCMS_BADDLLPATH
137

Could not find the directory specified by ‘DLLPath’ in the INI file.

PCMS_LOADLICDLL
138

Unable to load alk_license.dll or alk_license64.dll

PCMS_LOADGRIDDLL
139

Unable to load alk_grid.dll or alk_grid64.dll

PCMS_LOADDATADLL
140

Unable to load alk_data.dll or alk_data64.dll

PCMS_NETUSER_EXCEED
157

Too many users connecting to the network license, user count exceeded



PCMSLookup Extended Error Codes Returned With Option 5

Error

Value

Explanation

Error: Bad postal code format

400

The data given as a postal code was not properly formatted and could not be parsed; see Appendix D for postal code formats by country.

Error: No city or ZIP entered

410

Users entered only a state without a city or ZIP to accompany it

Error: This ZIP is not usable for routing

420

The given ZIP code cannot be used to generate a route

Error: State invalid for region

430

The given state is not a valid state within the current region

Error: No matching ZIP found

440

No zip was found that matches the given postal code

Error: No matching city found

445

No city was found that matches the given city name

Error: ZIP doesn’t match ST for given city,ST

450

No entries were found where the given zip resides in the specified state

Error: ZIP doesn’t match city for given city,ST

455

No entries were found where the given zip resides in the specified city

Error: No exact matches for city name

460

No results were found that exactly match the entered city.  Partial or similar matches may have been found instead

Error: No ZIP code exists for input city,ST

470

The given city, ST entry does not have any valid ZIP codes associated with it

Error: No matching SPLC found

475

No SPLC was found that matches the given code

Error: Not enough information provided to locate the requested stop

500

No valid ZIP, city, or state tokens could be parsed from the user’s input

Error: Street not found near the provided coordinates

525

Returned if a street address plus lat/longs was input and could not be found.

Warning: “There is a parity mismatch with the address range”

1000

Returned if address number is within the overall data range, but not in the odd or even range for this link

Warning: “The address provided had no number”

1010

Returned if the supplied address did not contain a number, e.g. “Smith Ave.” instead of “10 Smith Ave.”

Error: “The address provided has no matches in the zip/city provided”

1020

Returned if the supplied address cannot be found within the provided postal code.

Warning: “The street type does not match”

1030

Returned if the “best match” address has a different street type from the input address, i.e. “Smith St.” vs. “Smith Rd.”

Warning: “The street name is misspelled”

1040

Returned if street was matched through soundex, but did not match name on the data link, e.g. “Main” vs. “Maine”

Warning: “Street has multiple exact matches”

1050

Returned if the geocoder returned a confidence level of 100%, but more than one match

Warning: “No street name”

1060

Returned if there was no street name in the address

Warning: “Street is not within zip code specified”

1080

Returned if the ZIP code contained on the link does not match the street name specified

Warning: “The coordinates returned are for the zip centroid”

1090

Returned if the best match is the ZIP centroid (center point of the zip code area) for the address received

Warning: “Invalid entry”

2000

Returned if the format and/or the location data entered are invalid because of error(s) not cited in any of the above error codes



HOS-Specific Errors
Value

Message

PCMS_HOS_TRIP_NO_US_STOPS

-200

“The trip does not contain any stops in the United States.”

PCMS_HOS_TRIP_NOT_VALIDATED

-201

“The trip has not been validated using PCMSValidateRouteHOS”

PCMS_HOS_CDT_ABOVE_MAX

-202

“The Consecutive Drive Time is above the maximum allowed value”

PCMS_HOS_TDT_ABOVE_MAX

-203

“The Total Drive Time is above the maximum allowed value”

PCMS_HOS_TODT_ABOVE_MAX

-204

“The Total On Duty Time is above the maximum allowed value”

PCMS_HOS_CDT_BELOW_MIN

-205

“The Consecutive Drive Time is below the minimum allowed value”

PCMS_HOS_TDT_BELOW_MIN

-206

“The Total Drive Time is below the minimum allowed value”

PCMS_HOS_TODT_BELOW_MIN

-207

“The Total On Duty Time is below the minimum allowed value.”

PCMS_HOS_ETDT_ABOVE_MAX

-208

“The Estimated Total Drive Time is above the maximum allowed value.”

PCMS_HOS_ETODT_ABOVE_MAX

-209

“The Estimated Total On Duty Time is above the maximum allowed value.”

PCMS_HOS_TRIP_HUB_MODE_ON

-210

“Hub mode is on” (HOS for hub routing is not supported)

PCMS_HOS_TRIP_ HWY_ON

-211

“Highway is on” (Streets routing must be enabled for HOS routes)


TCP/IP Error CodesValue

PCMS_TCPIP_NET_ERROR


400

PCMS_TCPIP_NO_FUNCTION


401

PCMS_TCPIP_MISSING_NAME


402
PCMS_TCPIP_TOO_FEW_ARGS
403
PCMS_TCPIP_TYPE_MISMATCH
404
PCMS_TCPIP_BAD_RESPONSE
405