Skip to main content

PC*Miler Connect error codes

Contents

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


Error Codes

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 124 Truck inaccessible stop
PCMS_INVALIDREGIONID 125 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

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 Codes

TCP/IP Error Codes Value
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
Last updated July 19, 2025.
Contents