User manual ALK PCMSERVE FOR UNIX & LINUX & AIX & SOLARIS V22

[. . . ] ALL RIGHTS RESERVED You may print one (1) copy of this document for your personal use. Otherwise, no part of this document may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language, in any form or by any means electronic, mechanical, magnetic, optical, or otherwise, without prior written permission from ALK Technologies, Inc. IBM is a registered trademark of International Business Machines Corporation. PC*MILER, CoPilot, and ALK are registered trademarks and BatchPro and RouteMap are trademarks of ALK Technologies, Inc. [. . . ] You can also verify that you are getting new lookups from your Version 22 PCMServe by sending a unique trip that your company would never have made before or by examining the PCMServe log file (see Recent Enhancements above). IMPORTANT: The provinces of Quebec and Newfoundland and Labrador have changed their jurisdiction codes from "PQ" to "QC" and "NF" to "NL" respectively. If you use the old incorrect code (PQ or NL) and you do not use a comma between the city and the jurisdiction code, you may be routed to a city with the same name located in another state or province if a matching city name exists in the PC*MILER North American database. 4 PCMServe User's Guide Starting with Version 18, the Mexican place names format was changed to include the Estado code (formerly Mexican names were entered using just "MX" for the state abbreviation). PCMServe and Latitude/Longitude Points The algorithm that PCMServe uses to calculate the distance between latitude/longitude points has changed. 14 and earlier) used the distance from each lat/long to the nearest node in its calculations (a node is where two PC*MILER highway segments join together). For nearby points, PCMServe now returns the air distance directly between the two points, which is a more accurate measurement of the actual distance traveled. Significant Changes to PC*MILER Stop Names For users upgrading from previous versions of PCMServe: a comma between the city name and state abbreviation is now optional, but if you do not use a comma there is a mandatory space between the city and state abbreviation. For PC*MILER Version 14 or earlier it was assumed that the last two characters of a city name were the state code, but that is no longer true. Length of city names: The length of city names in the PC*MILER database increased from 22 to 95 in Version 15. Also, city name returns now include ZIP code, Canadian Postal Code (if it exists), then city name, state/province abbreviation, and county name. Reports Are Different Than in Previous Versions of PCMServe For users upgrading from previous versions (14 or earlier) of PCMServe, reports have undergone revision due to changes in the underlying data. Efforts were made to maintain backward compatibility, but some differences were unavoidable. Provided that reports were parsed using Tabs as delimiters and not parsed as fixed length strings, the differences should be minor with the exception of the . RTR report (turn by turn driving instructions). Unlike previous versions, the new . RTR report cannot be directly displayed on a screen without parsing. Changes By Report . MIL Report: The . MIL report returns ZIP codes plus city/state abbreviations. Stop names over 25 characters in length are truncated at 25 characters, so state information may not be returned. PCMServe User's Guide For example: Aluminum CO of America Plant, PA, Dauphin is truncated to: Aluminum CO of America Pl 5 . OUT Report: This report returns stops in the format in which they were passed. Version 22 returns a comma between the city name and state abbreviation; the input file must contain a comma or space between the city name and state abbreviation. Stops passed that are over 20 characters in length are truncated to 20 characters, so state information may be lost. For example: Aluminum CO of America Plant, PA would be returned as: Aluminum CO of Ameri . STA Report: This report has had ferry miles added. The columns in the order returned are now Total Miles, Toll Mile, Non-Toll Miles, Ferry Miles, Loaded Miles, and Empty Miles. Like the . OUT report, the . STA report returns stops in the format in which they were passed. In Version 22, the comma between city and state will be returned (commas in the input file are optional but if you do not use the optional comma you must use a space to separate the city and state), and stops larger than 20 characters will be truncated. For example: Aluminum CO of America Plant, PA would be returned as: Aluminum CO of Ameri . RTR Report: This report has undergone some major enhancements. [. . . ] The column order from left to right is: State, Toll, Direction, Road Name, Segment Miles, Segment Time, [empty column], Intersection, Leg Miles, Leg Time, Total Miles, and Total Time. NOTE: On-duty and Off-duty information cannot be controlled using PCMServe. NOTE Also: For some segments, columns are moved to the right to accommodate long road or intersection names. PCMServe User's Guide 15 2. 4 PCMServe Examples Minimum Requirements Example: Initialization file (count includes an additional character for return after each line): IN_PATH: PCMFIFO Input request: 0045CLIENT_KEY:1234 DATA: DETROIT, MI BUFFALO, NY Output response (". MIL" file, 62 represents the number of bytes that follow, 48231 and 14205 are the default ZIP codes for Detroit and Buffalo): 6248231 Detroit, MI, Wayne 14205 Buffalo, NY, Erie 268. 3 Output response (". TOT" file, 572 is the byte count of the response): 572 Total Mileages for 1 Records Total Toll Free Ferry Loaded Empty MI 4. 0 0. 2 3. 8 0. 0 4. 0 0. 0 NY 2. 5 0. 1 2. 4 0. 0 6. 5 0. 0 ----------------------------------------------------US 6. 5 0. 3 6. 2 0. 0 6. 5 0. 0 ON 253. 2 0. 0 253. 2 0. 0 253. 2 0. 0 ----------------------------------------------------CAN 253. 2 0. 0 253. 2 0. 0 253. 2 0. 0 ----------------------------------------------------TOT 259. 7 0. 3 259. 7 0. 0 259. 7 0. 0 Average Request Example: Initialization file: IN_PATH: PCMFIFO EXTENSION: COST Input request: 0079CLIENT_KEY:1234 BORDERS:CLOSED REPORT:OUT DATA: DETROIT MI -L BUFFALO NY -E TAMPA FL 16 PCMServe User's Guide NOTE: -L(oaded) and ­E(mtpy) must be capital letters. Output response (". OUT" file, 134 represents the number of bytes in the response): 134 DETROIT BUFFALO MI NY BUFFALO TAMPA NY FL 259. 7 1266. 5 360. 92 2121. 30 NOTE: Although both the above examples are in uppercase, this is not a necessity except when setting Loaded and Empty legs. PCMServe User's Guide 17 2. 5 Quick Reference The following is a list of options and values. [. . . ]