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. Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States and other countries.
Table of Contents PC*MILER® Product Line END-USER LICENSE AGREEMENT ......................... i PC*MILER-AS400 Version Notes – Please Read .............................................. 1 1.0 Introduction .................................................................................................. 6 2.0 Hardware and Software Requirements ...................................................... 7 2.1 System Requirements .............................................................................. 7 2.
7.0 Using PC*MILER|Tolls with Other Transportation Software ................... 62 7.1 Technical Overview ................................................................................ 65 7.2 Request and Response Field Parameters .............................................. 67 7.2.1 Stop Validation (VA) Request and Response................................. 68 7.2.2 Point-to-point Miles (MI) Request and Response ........................... 70 7.2.3 State Miles (SM) Request and Response ..................
PC*MILER-AS400 User’s Guide i PC*MILER® Product Line END-USER LICENSE AGREEMENT 1. Grant of License: Subject to the terms, conditions, use limitations and payment of fees as set forth herein, ALK Technologies, Inc. (“ALK”) grants the end-user (“you”) a license to install and use the PC*MILER solution(s) (including traffic data subscriptions) you have purchased (“PC*MILER”) on a single personal computer.
PC*MILER-AS400 User’s Guide ii limited to Citrix MetaFrame and Microsoft Terminal Server) or otherwise (including but not limited to access through PC*MILER connectivity products), or install or use PC*MILER on a network file server, without first notifying ALK, executing a written supplemental license agreement, and paying the license fee that corresponds to the number and types of uses to which access is to be allowed. 6.
PC*MILER-AS400 User’s Guide iii B. For ninety (90) days from date of purchase, the software media on which ALK provides PC*MILER to you will function substantially free of errors and defects. ALK will replace defective media during the warranty period at no charge to you unless the defect is the result of accident, abuse, or misapplication of the product. C.
PC*MILER-AS400 User’s Guide C. iv Upon expiration of any written supplemental license agreement between you and ALK of which this license is a part. 14. Obligations on Termination: Termination or expiration of this Agreement shall not be construed to release you from any obligations that existed prior to the date of such termination or expiration. 15.
PC*MILER-AS400 User’s Guide PC*MILER-AS400 Version Notes – Please Read There were no functional changes made in the ALKWIN or ALKTLL libraries for Version 28. If you currently have Borders Open/Closed and Use Ferry Distance Yes/No flags when you run the alkwin/pcmiler or alktll/pcmtll commands, your ALKWIN or ALKTLL libraries are functionally up to date. The libraries that you received with the V.
PC*MILER-AS400 User’s Guide Practical/Toll Dijscouraged/53 Foot Trailer Shortest/Toll Discouraged/53 Foot Trailer Note that National Network and 53'/102" Trailer Routing cannot be combined, they are mutually exclusive. Third Party or In-house Transportation Software Must Be Modified to Utilize PC*MILER Version 17 and Higher If you are using PC*MILER with other transportation software, that software will have to be modified to utilize this functionality.
PC*MILER-AS400 User’s Guide GR Guerrero HG Hidalgo JA Jalisco EM Mexico (Estado) MH Michoacan de Ocampo MR Morelos NA Nayarit New for 25=> NX* or NL Nuevo Leon (PC Side Configuration Option – Tools menu) OA Oaxaca PU Puebla QA Queretaro Arteaga QR Quintana Roo SL San Luis Potosi SI Sinaloa SO Sonora TA Tabasco TM Tamaulipas TL Tlaxcala VZ Veracruz YC Yucatan ZT Zacatecas * “NX” is used for Nuevo Leon because “NL” is already used in the database for the Canadian province of Newfoundland and Labrador.
PC*MILER-AS400 User’s Guide parameter codes have changed from L (Light) to Y (Override Restrictions) and H (Heavy) to N (Obey Restrictions). Use of L and H is still supported. The Override Restrictions option is available to both PC*MILER Highway and PC*MILER|Streets Users. Changes for Version 21 ALK has merged the ALK|FleetSuite Tolls product into the standard PC*MILER and PC*MILER|Streets product lines.
PC*MILER-AS400 User’s Guide NOTE for ICC Users: As of May 5th, 2007, ICC has not added support for PC*MILER|Tolls. If you have purchased PC*MILER|Tolls, you must deselect the Tolls component during installation if you intend to install PC*MILER or PC*MILER|Streets for use with your ICC software. For more information, see Appendix H.
PC*MILER-AS400 User’s Guide 1.0 Introduction Congratulations! By purchasing a PC*MILER product, you have made a cost-effective investment in high quality software that is simple to learn and easy to use. PC*MILER for the AS400 uses simple-to-follow menus and requires minimal keystrokes to generate routing and mileage information. Shortest, Practical, National Network, Toll-Discouraged, and 53' Trailer routes can be calculated in a matter of seconds and can include up to 30 stops.
PC*MILER-AS400 User’s Guide 2.0 Hardware and Software Requirements Because PC*MILER-AS400 employs a Client server solution, the following hardware and software is required. The AS400 server uses SNA APPC data queues to communicate. 2.1 System Requirements 2.1.1 Platforms PC/LAN Windows XP, Server 2008 and Windows 7* and 8, 32-bit support only AS400 (PC*MILER-AS400 supports the OS/400, i5/OS and IBM i operating system versions 4.
PC*MILER-AS400 User’s Guide 8 2.1.3 Windows Requirements Environment: PC with a minimum 700 MHz processor (1-2 GHz processor recommended) Screen resolution 800 X 600 PC*MILER: PC*MILER – 2.5 GB hard disk space for full install, including all Add-Ons listed below and all Connectivity products PC*MILER|Tolls – Add 50 MB hard disk space PC*MILER|HazMat – Add 50 MB hard disk space PC*MILER|Streets (U.S. Data) – Add 1.
PC*MILER-AS400 User’s Guide 3.0 Installation NOTE for Upgrading Users: There have been no changes to the ALKWIN or ALKTLL libraries since the Version 20 release. There is no need to upgrade your ALK library if you are currently running the Version 20 library.
PC*MILER-AS400 User’s Guide users write to, with each user having their own output queue. The PC listens to the input queue for mileage request packets. Within each mileage request packet is the name of the user’s output queue. The PC does a destructive read of the request packet, processes the request, and writes to the specified user’s output queue. PC*MILER for the AS400 was developed using the data queue facilities of IBM’s Client Access Express.
PC*MILER-AS400 User’s Guide 3.2 AS400 Side Installation First install the resident AS400 software on your AS400. Sign on to QSECOFR or an account with equivalent authorities. Place the CD in the optical drive and follow the instructions below. NOTES For Upgrades: If you are upgrading your ALKWIN or ALKTLL Library from an earlier version, it is recommended that you rename your current ALKWIN [or ALKTLL] Library or clear your current library with the CLRLIB command.
PC*MILER-AS400 User’s Guide Make sure all objects were restored. You can ignore security warning messages. It is okay if MIDQUE does not restore because this file is created later on. NOTE: The ALKWIN [or ALKTLL] Library CD was created using Kisco Information Systems’ BlueCD, which allows you to create AS400 readable SAVLIBs on a PC CD writer. A small percentage of users may have difficulty restoring the ALKWIN [or ALKTLL] Library with the above command. If you experience problems. Type RSTLIB, then: a.
PC*MILER-AS400 User’s Guide NOTE: For ICC Users only (Be sure to do this!) Type config from the AS400 command line after the restore of the library and change the library for the location of mileage data queues from ALKWIN to your ICC Work library and change the ICC Support Short Code names flag from ‘N’ to ‘Y’. Depending on the version of your ICC software your library will be I93WORK, ITSR6WORK, or IESR7WORK. Check with ICC for this name. For ICC R8 and multiple company installations use ALKWIN.
PC*MILER-AS400 User’s Guide For Tolls: Input Data Queue Library 3.3 PC Side Installation STEP 1: Make sure that Client Access Express is installed and working on the PC (see Appendix D: Configuring Client Access Express for Use with PC*MILERAS400). STEP 2: Insert the Product Line INSTALL DVD into your DVD drive, or click the link that was sent to you via email from ALK Technologies.
PC*MILER-AS400 User’s Guide When you are prompted, enter the Product Key Code that was e-mailed to you at the time of purchase. Your product code will be in this format: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX When entering the Product Key Code, dashes are not required – dashes, spaces, or no spaces are all acceptable. If you do not have your Product Key Code, call ALK Technologies at 800-377-6453 ext. 2 from 9:00am to 5:00pm EST Monday through Friday.
PC*MILER-AS400 User’s Guide enlarged Tolls Cost data structures, see Chapter 7 and Appendix H for more information. NOTE: As of 5/7/07, Innovative Computing Corporation (ICC) has not released a version of their software that works with the PC*MILER|Tolls component. ICC users should not install PC*MILER|Tolls if they intend to use this installation in conjunction with their ICC software.
PC*MILER-AS400 User’s Guide Click Next and in the next screen select a folder to install to, or use the default folder (PCMILER28). Click Next again when ready. During the installation you will be prompted to enter the name of the library for data queues. The default values are ALKWIN (without PC*MILER|Tolls) and ALKTLL (with PC*MILER|Tolls). NOTE: ICC users need to coordinate with Innovative to enter the proper ICC Work Library for their release of the ICC software.
PC*MILER-AS400 User’s Guide Library for Data Queue Locations: Library for Data Queue Locations with PC*MILER|Tolls: 18
19 PC*MILER-AS400 User’s Guide When entering your system and sign-on information, if possible use the IP address rather than the System Name of your AS400. Be careful that the password for the User Profile that you specify is set not to expire. Your User Profile must have the authority to create and delete data queues in the library that you specified in the previous dialog. STEP 3: You must activate your installation within 15 days of installing.
PC*MILER-AS400 User’s Guide NOTE: The 15-day grace period for activation is only available for the first installation of Version 28 on your PC. If you are reinstalling for any reason you will have to activate the installation before it can be used.
21 PC*MILER-AS400 User’s Guide Automatic License Activation: Click Activate in the License Manager. The rest of the process is completely automated if you have internet access on your PC. You will see the message “License Activation Complete!” when the activation is finished. Close the Product Activation window, then click the Windows Start menu > Programs > PCMILER 28 > License Status and make sure that “Licensed” appears under Status in the PC*MILER License Tool window.
22 PC*MILER-AS400 User’s Guide Manual Activation: If the Automatic Activation process fails due to firewall security settings or for any other reason, try activating manually. Check the Manual Activation box. In the Manual Activation screen that appears, click the http://activate.alk.com link to open a webpage that will provide you with an activation code 24/7. You may need to add http://activate.alk.com or https://activate.alk.com as a trusted site to get the activation webpage to open.
PC*MILER-AS400 User’s Guide When the activation process is complete, a “License Activation Complete!” message will appear in the Product Activation window. Click the Windows Start menu, then Programs > PCMILER 28 > License Status and make sure that “Licensed” appears under Status in the PC*MILER License Tool window. If so, PC*MILER is now permanently licensed. If not, call Technical Support (see section 10.0). 3.
PC*MILER-AS400 User’s Guide For PC*MILER: C:\ALK Technologies\pcmiler28\as400\SRV32.exe 121 for NS Router Connections C:\ALK Technologies\pcmiler28\as400\SRV32.exe 122 for Client Access Express Connections For PC*MILER|Streets: C:\ALK Technologies\pcmiler28\as400\SRV32.exe 22 1 for NS Router Connections C:\ALK Technologies\pcmiler28\as400\ SRV32.
PC*MILER-AS400 User’s Guide 4.0 Starting and Stopping the Mileage Server 4.1 Starting the Mileage Server The software you installed on your dedicated PC will cause the interface to start automatically when the PC is turned on. You can launch the Mileage Server without restarting the PC by clicking: Start > Programs > PCMILER 28 > AS400 Interface. When the mileage server (SRV32.exe) starts, it displays the connection status in the mileage server’s log window.
PC*MILER-AS400 User’s Guide 0 Connection Good Created Data Queue 2 Connection Good Found Data Queue Return codes of 1 or 3 are generic error codes that indicate problems with your Client Access Express connection. NOTE: Both the PC and the AS400 must agree on the location of the Input or Request data queue. To change the location on the PC, click on the mileage server’s File menu. Choose AS400 Control, then Change Library/Queue.
PC*MILER-AS400 User’s Guide 27 4.3 Configuring the Use of Mexican Postal Codes Version 28 of PC*MILER includes over 25,000 Mexican postal codes in the database that provide comprehensive coverage of Mexico. Mexico and the United States use the same five-digit numbering scheme for their postal codes. The two countries share a large number of common codes and care must be taken so that users do not accidentally match a Postal or ZIP code to the wrong country.
PC*MILER-AS400 User’s Guide 5.0 Using PC*MILER for the AS400 To use PC*MILER for the AS400, issue the command PCMILER (or PCMTLL for PC*MILER|Tolls) from the command line. PCMILER Main Screen: NOTE: The PCMILER or PCMTLL command contacts the mileage server to read the data that the mileage server is using. If the command doesn’t respond or the PC*MILER screen comes up with ”PC DOWN” in the screen title, there is a problem with the connection to the mileage server PC.
PC*MILER-AS400 User’s Guide PCMTLL Main Screen: Control settings at the top of the main entry screen include the following: Request Type: "MI", the default entry, will generate only point-to-point mileage look-ups. "SM" will generate a summary of miles traveled through each state, broken down by toll roads and free roads, in addition to the point-to-point mileage. "HS" will generate detailed driving instructions, in addition to the state mileage summary and point-to-point mileage look-up.
PC*MILER-AS400 User’s Guide Routing Type: Either Practical or Shortest routing can now be combined with other available PC*MILER routing options (Toll Discouraged, National Network, or 53' Trailer or Twins). You must specify either P (Practical) or S (Shortest) for all routes. (Refer to the main PC*MILER User’s Guide for more detailed descriptions of these routing options.) See Chapter 6, Using PC*MILER With Other Transportation Software for details on using this functionality with other software packages.
PC*MILER-AS400 User’s Guide stops reordered. "F" is used to initiate route sequencing with both the origin and destination fixed and the remaining stops reordered. These options are described in more detail in the main PC*MILER User's Guide. Borders: “O” will open the borders and routes will cross International Borders to obtain the most efficient trip. “C” will close the borders and routes will only cross international borders if the trip has a stop in that country.
PC*MILER-AS400 User’s Guide In the middle of the screen are the stop entry fields. Enter the city names and state abbreviations for the stop-off locations desired, their ZIP codes, or their latitude/longitude positions. Both the Spelling Helper and ZIP Code Helper described in the main PC*MILER User's Guide are available for use with PC*MILER-AS400. You may enter up to 30 stop-offs.
33 PC*MILER-AS400 User’s Guide 5.1 Function Keys At the bottom of the screen, the function keys used with PC*MILER for the AS400 are described. These include: F2 State help. Displays a list of all state and province abbreviations. F3 Exit. Exits the program and returns to the main AS400 screen. F7 Ins stop. Allows you to insert a new stop-off where the cursor is positioned. F8 Del stop. Allows you to delete a stop-off where the cursor is positioned. F10 Process request. dedicated PC.
PC*MILER-AS400 User’s Guide 5.
PC*MILER-AS400 User’s Guide This basic PC*MILER mileage report contains leg and cumulative miles for each segment of your trip. The time and cost estimates are based on the values set in the copy of PC*MILER (or PC*MILER|Streets) installed on your dedicated PC. (Refer to the main PC*MILER User’s Guide for instructions on how to alter these values.) NOTE: The leg costs and total cost in the “COST” column include toll costs if PC*MILER|Tolls is installed. will exit the program.
PC*MILER-AS400 User’s Guide 36 5.
PC*MILER-AS400 User’s Guide Pressing displays Jurisdiction-by-Jurisdiction distance breakdowns: With PC*MILER|Tolls Installed: 37
PC*MILER-AS400 User’s Guide 5.4 Detailed Driving Directions Report After entering stops on the main screen and pressing to initiate a Detailed Driving Directions (HS) request, press in the mileage report screen to generate the driving directions. When processing is complete, the screen shown below will appear. Note that driving directions take significantly longer to process than miles or state miles because more information is requested and returned.
PC*MILER-AS400 User’s Guide A Detailed Driving Directions report with PC*MILER|Tolls installed is shown below. This sample report includes toll costs for each leg of the trip.
PC*MILER-AS400 User’s Guide 40 6.0 Using PC*MILER with other Transportation Software NOTE for Version 21 and Higher: The following features are not supported in the AS400 product line: Fuel Optimization, Vehicle Profiles, Estimated Greenhouse Gas Emissions, RouteSync, Entry/Exit Toll Plaza Names in Reports, and Real-time/Historical Traffic Data. Province/Estado Abbreviation Option to set “NL” preference is supported in Version 25-28 only.
PC*MILER-AS400 User’s Guide EM Mexico (Estado) MH Michoacan de Ocampo MR Morelos NA Nayarit New for 25=> NX* or NL Nuevo Leon (PC Side Configuration Option – Tools menu) OA Oaxaca PU Puebla QA Queretaro Arteaga QR Quintana Roo SL San Luis Potosi SI Sinaloa SO Sonora TA Tabasco TM Tamaulipas TL Tlaxcala VZ Veracruz YC Yucatan ZT Zacatecas * “NX” is used for Nuevo Leon because “NL” is already used in the database for the Canadian province of Newfoundland and Labrador.
PC*MILER-AS400 User’s Guide G = Toll Discouraged/Shortest H = National Network/Shortest I = 53 Foot Trailer/Shortest J = Toll Discouraged/National Network/Shortest K = Toll Discouraged/53 Foot Trailer/Shortest Use of the old codes is still supported, no changes are required. Old codes for National Network (N), Toll Discouraged (T), and 53 Foot Trailer (5) will be generated using the Practical network. Changing this default to the Shortest network is not possible.
PC*MILER-AS400 User’s Guide 43 6.1 Technical Overview The PC*MILER-AS400 system uses distributed processing techniques (i.e. the processing is split into two). The user interface or interactive software is written in RPG and runs on the AS400. Small CL programs are used for the creation and removal of temporary data queues (output or response queues). The mileage calculation software is written in C++ and runs on a PC in the Windows environment.
PC*MILER-AS400 User’s Guide The program MIINQ contains two subroutines that can be used to integrate miles with other transportation software. The subroutine SNDREQ sends mileage requests to PC*MILER and the subroutine RSLT receives mileage results from PC*MILER. The subroutine PLOT can be used to send graphics requests for ETA truck display of graphics. For example, a truck or vehicle ID’s Lat/Long, ZIP, or city name position can be sent to the PC using PLOT and the “DT” request.
PC*MILER-AS400 User’s Guide 6.2 Request and Response Field Parameters The following sections specify the field parameters for the request types defined in section 6.1 and the responses to each request type. IMPORTANT NOTE: When using PC*MILER|Streets, the best matching for address location lookups can be accomplished using the guidelines stated below. These rules apply to batch or interactive integration.
PC*MILER-AS400 User’s Guide 6.2.1 Stop Validation (VA) Request and Response The following are field parameters for stop and (for PC*MILER|Streets users) street address validation. A stop can be a city/state pair separated by a comma, a ZIP code, a latitude/longitude point or (with optional add-on modules) a Canadian Postal code or SPLC (Standard Position Location Codes). PC*MILER|Streets users may include street addresses.
47 PC*MILER-AS400 User’s Guide Validation Request: Var Name Len Value Description REQ-TYPE REQ-REF 2 10 VA Validate Stop or Address Output Queue Name (ALK uses “Q” plus job number) Filler 6 REGION (Worldwide Only) 6 1 Filler 1 Force Pick List 1 1 Filler 7 REQ-CIT 7 70 Filler-CIT 630 Extended Format Pos 19) A=Asia E=Europe, F=Africa N=North America O=Oceania S=South America P Pos 21) P or Blank P=Force Pick List, or use wildcard * after a partial city or address Pos 29) 70 bytes each left
48 PC*MILER-AS400 User’s Guide RESP-Seq RESP-ERR 4 2 RESP-CIT 980 Filler 15 E2 Pos 23-26) Sequence for multiple responses Pos 27-28 Error Code Place not found Array of 14 places 70 bytes each left justified or Error message if there is a problem 6.2.2 Point-to-point Miles (MI) Request and Response 1. (Request) The following are field parameters for requesting miles. The purpose of the Mileage request is to allow the host application to retrieve point-to-point miles.
49 PC*MILER-AS400 User’s Guide Custom Routing Override Restrictions 1 1 Hazmat (Data Add-on) 1 REQ-BRDR 1 REQ-FERRY 1 REQ-SEQ REQ-ERR REQ-CIT 2 2 700 O=Oceania S=South America Pos 8) C=Custom, blank=default Pos 9) Y=Override Restrictions, L=Light N=Obey Restrictions or H=Heavy Pos 10) G=General Restriction C=Corrosive E=Explosive Restriction F=Flammable I =Inhalant Restriction R = Radioactive Restriction Pos 11) O=Borders Open C= Closed Pos 12) Y=Include Ferry Distance N=Do Not Include Ferry Dis
50 PC*MILER-AS400 User’s Guide RESP-MIL-TYPE RESP-OPTION 1 1 RESP-MORE 1 REGION 1 1 Custom Routing Override Restrictions 1 1 Hazmat 1 RESP-SEQ 4 RESP-ERR 2 E1 E2 E3 E4 E5 E6 E9 RESP-CIT1 39 RESP-CIT2 39 RESP-MILE RESP-HOUR RESP-COST FILL133 O256 5 4 7 133 C=National Network/Practical D=53 Foot Trailer/Practical E=Toll Discouraged/National Network/Practical F=Toll Discouraged/53 Foot Trailer/Practical G=Toll Discouraged/Shortest H=National Network/Shortest I=53 Foot Trailer/Shortest J=T
51 PC*MILER-AS400 User’s Guide 6.2.3 State Miles (SM) Request and Response 1. (Request) The following are field parameters for a state miles request. The purpose of this request is to attain the state-by-state mileage information associated with a trip.
52 PC*MILER-AS400 User’s Guide REQ-CIT 700 Array of 10 places 70 bytes each left justified 3 sets of 700 when using the more flag 38 byte maximum city name 1 byte comma 2 byte state abbrev 1 byte comma (optional) 13 byte county name (optional) or 1 byte semicolon ; followed by street address Examples Warminster,PA,BUCKS Warminster,PA;1174 NASSAU ROAD 18974 Lat/long format should be 1234567N,1234567W 5 digit zips only Canadian Postal Codes use the format L#L #L# 2.
53 PC*MILER-AS400 User’s Guide REQ-MORE REQ-FMT 1 1 1 REGION 1 Custom Routing Override Restrictions 1 1 Hazmat 1 SEQNUM 4 ERROR 2 F = resequence stops fixed destination blank = otherwise Pos 4) M = more data to follow Pos 5) Reserved by DR request Pos 6) E = Extended Format (Required, see Appendix A) Pos 7) A=Asia, E=Europe, F=Africa, N=North America, O=Oceania, S=South America Pos 8) C=Custom, blank=default Pos 9) Y=Override Restrictions, L=Light, N=Obey Restrictions or H=Heavy Pos 10) G=Gene
54 PC*MILER-AS400 User’s Guide 6.2.4 Detailed Route Information (HS) Request and Response 1. (Request) Following are parameters for a route and state miles request. The purpose of this request is to allow the Host to retrieve detailed route information based on the city pair stop-off points.
55 PC*MILER-AS400 User’s Guide 3 sets of 700 when using the more flag 38 byte maximum city name 1 byte comma 2 byte state abbrev 1 byte comma (optional) 13 byte county name (optional) or 1 byte semicolon ; followed by street address Examples Warminster,PA,BUCKS Warminster,PA;1174 NASSAU ROAD 18974 Lat/long format should be 1234567N,1234567W 5 digit zips only Canadian Postal Codes use the formal L#L #L# 2. (Response) Following are field parameters for a response to the route and state miles request.
56 PC*MILER-AS400 User’s Guide REQ-FMT 1 1 REGION 1 Custom Routing Override Restrictions 1 1 Hazmat 1 SEQNUM 4 ERROR 2 Pos 5) Pos 6) Reserved by DR request E = Extended Format (Required, see Appendix A) Pos 7) A=Asia, E=Europe, F=Africa, N=North America, O=Oceania, S=South America Pos 8) C=Custom, blank=default Pos 9) Y=Override Restrictions, L =Light, N=Obey Restrictions or H=Heavy Pos 10) G=General Restriction C=Corrosive E=Explosive Restriction F=Flammable I=Inhalant Restriction R=Radioact
57 PC*MILER-AS400 User’s Guide 6.2.5 Upgrade Notice For Version 16 and higher, the ROUTEINFO portion of the HS return was increased by 25 characters and the number of ROUTEINFO Sets per response packet was decreased from four sets to three. Route Number was increased 15 characters from 20 to 35 (Highway, Road or Street Name), and Interchange City or Junction was increased 10 characters from 28 to 38. The previous format is shown below.
58 PC*MILER-AS400 User’s Guide or 1 byte semicolon ; followed by street address Examples Warminster,PA,BUCKS Warminster,PA;1174 NASSAU ROAD 18974 Lat/long format should be 1234567N,1234567W 5 digit zips only Canadian Postal Codes use the formal L#L #L# 2. (Response) Following are parameters for a latitude longitude coordinate response. Lat/longs are returned in degree, minute second format.
59 PC*MILER-AS400 User’s Guide REQ-BRDR REQ-FERRY 1 1 REQ-SEQ REQ-ERR REQ-CIT 2 2 700 F=Flammable I=Inhalant Restriction R=Radioactive Restriction Pos11) O=Borders Open C= Closed Pos12) Y=Include Ferry Distance N=Do Not Include Ferry Distance Sequence for multiple responses (Not read by PC) Error Code Array of 10 places 70 bytes each left justified 3 sets of 700 when using the more flag 38 byte maximum city name 1 byte comma 2 byte state abbrev 1 byte comma (optional) 13 byte county name (optional) or
60 PC*MILER-AS400 User’s Guide LABLE3 LOCAT4 LABLE4 LOCAT5 LABLE5 DRRQTP 119 18 119 18 119 2 CT DRRQTP 2 CR DRRQTP 2 CA TRUCK INFO for pop up box LOCATION of truck 4 (ZIP, city, or Lat/Long) TRUCK INFO for pop up box LOCATION of truck 5 (ZIP, city, or Lat/Long) TRUCK INFO for pop up box Clear all trucks red and blue Remaining fields not used Clear all routes Remaining fields not used Clear all graphics Var Name Len Value Description REQ-TYPE Map Title 2 20 PR Draw and Print current route A
61 PC*MILER-AS400 User’s Guide 6.4 Sample Request and Response Records Sample records are shown below.
PC*MILER-AS400 User’s Guide 7.0 Using PC*MILER|Tolls with Other Transportation Software Notes For Existing PC*MILER-AS400 Users: • A set of 10 new trip parameters has been inserted into all of the request and response packets. • All return types (CP, SR, HR) were expanded to hold Toll Cost information. CP was expanded by seven characters, SR by 77, and HR by 63.
PC*MILER-AS400 User’s Guide NOTE: PC*MILER 18 and higher now has full Mexican Estado information. Previously, all Mexican cities were referenced with ‘MX’ as the Estado code and the Estado was returned in the US county field. For example: Older versions format: Mexico City, MX, Distrito Federal Correct format for Version 18: Mexico City, DF REMINDER: The Province/Estado Abbreviation Option to set the “NL” preference is supported only in Version 25-28.
PC*MILER-AS400 User’s Guide “NX” is used for Nuevo Leon because “NL” is already used in the database for the Canadian province of Newfoundland and Labrador. The option to configure NL for routing to Nuevo Leon is supported in Version 25-28 only. NOTE: For Version 17 and higher the routing type options have changed for National Network, Toll Discouraged, and 53'/102" Trailer routing. These three routing options now can be generated in combination with the ‘Practical’ or ‘Shortest’ options.
PC*MILER-AS400 User’s Guide NOTE: For users upgrading from PC*MILER|Streets, the Light/Heavy vehicle option has been renamed to ‘Override Restrictions’. Parameter codes have changed from L (Light) to Y (Override Restrictions) and H (Heavy) to N (Obey Restrictions). Use of L and H is still supported. NOTE: For Version 16 and higher, the HS (Turn-by-Turn Driving Instructions) return packet was changed from previous versions.
PC*MILER-AS400 User’s Guide GTTLAT 66 GTTLATC Sample RPG Program that converts City, Jurisdiction pairs or zip codes to Lat/longs CL program that creates output queue and starts GETLAT RPG GTTMIL GTTMILC Sample RPG Program that performs point-to-point mileage lookups CL program that creates output queue and starts GETMIL RPG GTQNAMTL RPG Program that determines library and data queue name for sending requests VTLADR MIDQUE RPG Program that validates ZIP codes, place names, and street addresses; a
PC*MILER-AS400 User’s Guide CT = CR = CA = PR = PA = Clear Truck bitmap from a specified location Clear a drawn route line Clear all routes and trucks Print route Print all The PC Mileage Server responds with the following types of returns: VR – Version of PC*MILER running on the PC PL – Good/Bad Stop or a ‘pick list’ of potential matches CP – Total Miles for a trip SR – Total Miles for a trip broken down by state or province HR – Turn-by-turn driving instructions or “highway segments” VN returns a VR VA
PC*MILER-AS400 User’s Guide Example: Send 08540 as opposed to “08540;” – a semicolon will cause the server to look up a blank address (unnecessary). Three examples of correct input: Trenton, NJ;21 Olden Avenue New York, NY;118 Broadway 20001 7.2.1 Stop Validation (VA) Request and Response The following are field parameters for stop and (for PC*MILER|Streets users) street address validation.
69 PC*MILER-AS400 User’s Guide Validation requests are important because error reporting in mileage requests is limited to the first two stops of a trip. If your bad stop is lower in the list of stops, you will not be told which is the non-valid stop, you will get a generic “Can’t Run Trip” message. The VA request type can be used to produce lists of potential matches to partial spellings or ZIP codes.
70 PC*MILER-AS400 User’s Guide RESP-Seq RESP-ERR 4 2 Filler 10 RESP-CIT 10 980 Filler-16 16 E2 Pos 23-26) Sequence for multiple responses Pos 27-28 Error Code Place not found Pos 29-38) Pos 39-1018) Array of 15 places, 70 bytes each left justified or Error message if there is a problem Pos 1019-1035 Total 1035 7.2.2 Point-to-point Miles (MI) Request and Response For PC*MILER|Tolls, the MI Request layout was increased by 10 to hold a new set of trip parameters.
71 PC*MILER-AS400 User’s Guide 1 1 Pos 2) Pos 3) M or K for miles or kilometers R=resequence stops H=hub leg miles F=resequence stops fixed destination blank=otherwise 1 1 1 Pos 4) Pos 5) Pos 6) M=more data to follow Reserved by DR request E =Extended Format (Required, see Appendix A) REGION (Worldwide Only) 1 Pos 7) Custom Routing Override Restrictions 1 1 Hazmat (Data Add-on) 1 REQ-BRDR 1 Pos11) O=Borders Open C= Closed REQ-FERRY 1 Pos12) Y=Include Ferry Distance N=Do Not Include Ferry
72 PC*MILER-AS400 User’s Guide Canadian Postal Codes use L#L #L# Standard Position Location Code use SPLC+number * “MVS” is the PC*MILER Multi Version Switch product, an optional product that allows for connection to multiple versions of PC*MILER. 2. (Response) The following are field parameters for output miles. The City Pair response returns an output to the host application that contains city names and ZIP codes along with miles, cost and time estimates.
73 PC*MILER-AS400 User’s Guide RESP-SEQ 4 RESP-ERR 2 E1 E2 E3 E4 E5 E6 E9 E = Explosive Restriction F=Flammable I = Inhalant Restriction R = Radioactive Restriction Sequence for multiple responses (Note: Border & Ferry settings not echoed in CP response.
74 PC*MILER-AS400 User’s Guide Var Name REQ-TYPE REQ-REF Len 2 10 Value SM Description Extended Format Miles request Output Queue Name (ALK uses ‘Q’ + the job number) Request Options 13-22 REQ-OPTION 1 1 1 REQ-MORE REQ-FMT 1 1 1 REGION (Worldwide Only) 1 Custom Routing Override Restrictions 1 1 Hazmat 1 REQ-BRDR REQ-FERRY 1 1 REQ-SEQ REQ-ERR More Trip Options REQ-MVS 2 2 10 3 Pos 1) S=Shortest P=Practical N=National/Practical T=Toll Discouraged/Practical 5=53' Trailer/Practical B=Toll
75 PC*MILER-AS400 User’s Guide REQ-TollCost REQ—Fill 6 1 Pos 4) T for Cash D for Discount or Blank Pos 5-10) Not used blank fill REQ-CIT 700 Array of 10 places 70 bytes each left justified 3 sets of 700 when using the more flag 38 byte maximum city name 1 byte comma 2 byte state abbrev 1 byte comma (optional) 13 byte county name (optional) or 1 byte semicolon ; followed by street address Examples Warminster,PA,BUCKS Warminster,PA;1174 NASSAU ROAD 18974 Lat/long format should be 1234567N,1234567W 5 dig
76 PC*MILER-AS400 User’s Guide 1 1 REQ-MORE REQ-FMT 1 1 1 REGION 1 Custom Routing Override Restrictions 1 1 Hazmat 1 SEQNUM 4 ERROR 2 E1 E2 E3 E4 E5 E6 E9 More Options 29 -38 RESP-MVS RESP-TollCost RESP-FILL 3 1 6 STATEMIL 180 10 Sets FILLER Total 267 48 G=Toll Discouraged/Shortest H=National Network/Shortest I=53 Foot Trailer/Shortest J=Toll Discouraged/National Network/Shortest K=Toll Discouraged/53 Foot Trailer/ Shortest Pos 2) M or K for miles or kilometers Pos 3) R = resequence sto
77 PC*MILER-AS400 User’s Guide 7.2.4 Detailed Route Information (HS) Request and Response For PC*MILER|Tolls, the HS Request layouts were increased by 10 to hold a new set of Trip Parameters. The HR Response Layouts were changed in two ways: The number of Sets of Route Information was increased from three to nine to improve performance. This route information was increased by 63 to hold Tolls Cost data (7 x 9 sets). Output Data Queues increased from 1024 to 1048. 1.
78 PC*MILER-AS400 User’s Guide Custom Routing Override Restrictions 1 1 Pos 8) Pos 9) C=Custom, blank=default Y=Override Restrictions or L=Light N=Obey Restrictions or H=Heavy Hazmat 1 REQ-BRDR 1 REQ-FERRY 1 Pos 10) G = General Restriction C=Corrosive E = Explosive Restriction F=Flammable I = Inhalant Restriction R = Radioactive Restriction Pos11) O=Borders Open C= Closed (not echoed back) Pos12) Y=Include Ferry Distance N=Do Not Include Ferry Distance (not echoed back) REQ-SEQ REQ-ERR 2 2 Seq
79 PC*MILER-AS400 User’s Guide 2. (Response) Following are field parameters for a response to the route and state miles request. The PC response record has all of the required detailed route information. There are four route list records\response records. Therefore, if there are more than nine records for the route, additional response records must be returned. Multiple returned records are designated by the "M" in the "MORE" parameter field.
80 PC*MILER-AS400 User’s Guide E1 E2 E3 E4 E5 E9 E9 First state not found First city not found Second state not found Second city not found Unable to resequence Disconnected Highway Network Disconnected Highway Network More Options 29 -38 (Echoed Back From Request) RESP-MVS 3 Pos 1-3) MVS Version Only* RESP-TollCost 1 Pos 4) Tolls Cost RESP-FILL 6 Post 5-10) Not Used Number of Sets increased from 3 to 9, 7 characters added to each set to hold Tolls Cost Data ROUTEINFO 2 indicates end of route data for st
81 PC*MILER-AS400 User’s Guide 7.2.4.1 Upgrade Notice For Version 16 and higher the ROUTEINFO portion of the HS return was increased by 25 characters and the number of ROUTEINFO Sets per response packet was decreased from four sets to three. Route Number was increased 15 characters from 20 to 35 (Highway, Road or Street Name), and Interchange City or Junction was increased 10 characters from 28 to 38. The previous format is shown below.
82 PC*MILER-AS400 User’s Guide 7.2.5 City/Address to Lat/Long (LL) Request and Response 1. (Request) Following are parameters for latitude/longitude coordinates for a given city, postal code, or address (PC*MILER|Streets only). Lat/longs are returned in degree, minute second format.
83 PC*MILER-AS400 User’s Guide FILL-10 10 Blank Fill RESP-SEQ 4 Sequence (Always 0001 for LL Requests) RESP-ERR 2 Error Code (E2=No Match Found) More Options RESP-MVS RESP-TollCost RESP-FILL 29 -38 3 1 6 (Echoed Back From Request) Pos 1-3) MVS Version Only* Pos 4) Not Used LL Requests Post 5-10) Not Used RESP-LL 17 Fill-211 211 Lat/Long Coordinate in Degree, Minutes, Seconds Format Blank Fill * “MVS” is the PC*MILER Multi Version Switch product, an optional product that allows for connecti
84 PC*MILER-AS400 User’s Guide 1 byte comma (optional) 13 byte county name (optional) or 1 byte semicolon ; followed by street address Examples Warminster,PA,BUCKS Warminster,PA;1174 NASSAU ROAD 18974 Lat/long format should be 1234567N,1234567W 5 digit zips only Canadian Postal Codes use the formal L#L #L# *“MVS” is the PC*MILER Multi Version Switch product, an optional product that allows for connection to multiple versions of PC*MILER. The following requests use the DRAW external data structure.
85 PC*MILER-AS400 User’s Guide Var Name Len Value Description REQ-TYPE Map Title 2 20 PR Draw and Print current route Assign a title to the Map or defaults to the name of Map Pos 4) M = more data to follow Pos 5-10) Not used Sequence for multiple responses Not used REQ-MORE REQ-SEQ REQ-ERR 4 2 More Trip Option REQ-MVS REQ-TollCost REQ—Fill REQ-CIT 10 3 1 6 220 FILL8 B256 7 1 REQ-TYPE 2 Map Title 20 Positions 29-38) Pos 1-3) No Graphics Support MVS Version Pos 4) Not Used PR Request Type P
86 PC*MILER-AS400 User’s Guide 7.2.8 Sample Request and Response Records Sample records are shown below.
PC*MILER-AS400 User’s Guide 87 8.0 Using the PC*MILER-AS400 Mileage Server and Map Window When you first open PC*MILER for AS400, an active map window is displayed if mapping is on: If mapping is off, the Server Log is displayed when AS400 is opened.
88 PC*MILER-AS400 User’s Guide 8.1 Menus All menu commands in PC*MILER for the AS400 are described on the following pages. The File Menu Using the File menu, you can open, close, save and duplicate routes; print graphics and reports; and exit the PC*MILER program. Delete AS400 Input Queue When a queue becomes corrupted, creates a new queue and deletes the corrupted one. Exit Exit PC*MILER-AS400.
89 PC*MILER-AS400 User’s Guide be drawn on the map. This will speed up the display. Log to File: Turn diagnostics on/off. This is useful for debugging problems. When on, diagnostics are written to a file called as400.log, located in the directory that the software is running from (srv32.exe). Choose between Append, Overwrite, and Close. Host Polling Timer: Use faster time slice to poll the AS400 more often for faster interactive response time, or slower time slice for smoother graphic display.
90 PC*MILER-AS400 User’s Guide Hide all trucks Hide all truck icons. Show entire Map Show all routes and truck icons. Frame Route Frames current trip The Window Menu Use the Window menu to control and organize the active windows in your display. Tile Vertical Active windows will fit your screen, running vertically. Tile Horizontal Active windows will fit your screen, running horizontally. Display Serve Log Restore the Serve Log window if minimized.
PC*MILER-AS400 User’s Guide 91 8.2 Built-in Functionality Similar to PC*MILER|Mapping, PC*MILER for the AS400 has built-in zooming features, and a menu that can be invoked using the right mouse button which provides much of its functionality. To zoom into an area, drag a rectangle (hold down the left mouse and drag) or double-click on a point (this will zoom in and place the point at the center of the map).
PC*MILER-AS400 User’s Guide Copy: Copy the map to the clipboard for retrieval in other Windows programs. Print: Print the map that is currently displayed in the Map Window.
PC*MILER-AS400 User’s Guide 9.0 Common Questions and Installation Problems Question: PC*MILER works correctly when using the PCMILER command on the AS400, but my Innovative software does not work. Answer: Run the CONFIG command on the AS400 (which is described in the manual) and type the Innovative work library name I93WORK, ITSR5W0RK, or IESR7WORK (check with ICC). After this is complete, check the File menu in the AS400 Mileage Server, choose AS400 Control>Change Library Queue.
PC*MILER-AS400 User’s Guide spelling of the city, for example ok* OK, to determine the PC*MILER spelling. Press to invoke the ICC city update program and correct the spelling for Oklahoma City OK. After all the corrections are made, re-run the ICC Print Missing Tariff Miles utility to update those missing miles. Question: Some of the mileage returned from PC*MILER is different from the mileage returned by my other transportation software.
PC*MILER-AS400 User’s Guide 10.0 Technical Support Technical support is available to registered users of PC*MILER-AS400 from 9:00am to 5:00pm EST, Monday through Friday. Call (609) 6830220, ext. 2. Or, e-mail us at pcmsupport@alk.com (type “PCM/AS400” in the subject line).
PC*MILER-AS400 User’s Guide 11.0 About ALK® Technologies ALK® Technologies, Inc., a Trimble® company headquartered in Princeton, NJ, was founded in 1979 as a transportation industry pioneer. ALK harnesses the power of information technology to enhance transportation and mobility, supporting competitive advantage and improved quality of life. Today, ALK is a global leader in GeoLogistics® Solutions and navigation software.
PC*MILER-AS400 User’s Guide Appendix A: Backward Compatibility ALK Technologies does support backward compatibility with previous versions of PC*MILER and PC*MILER for the AS400. However, it is not advisable to develop new applications that use these short city name structures, because you lose access to county information which is necessary for resolving duplicate city name problems. Over time, this backward compatibility becomes increasingly difficult for ALK Technologies to maintain.
PC*MILER-AS400 User’s Guide 98 Appendix B: Configuring an N/S Router For Use With PC*MILER-AS400 ALK is no longer supporting the use of the N/S Router. It remains an installation option and may work on some systems. Unless you have a twinax connection, configure your router using the AnyNet protocol. AnyNet needs to be enabled on the AS400 (see Appendix D: Configuring AnyNet on the AS400). For PC*MILER Version 14 (or higher) and any PC*MILER|Streets version, you must have the N/S Router version 3.
PC*MILER-AS400 User’s Guide Then do the following: 1. In the Links Tab, highlight AnyNet, and then choose Properties. 2. In Properties, fill in the AS400’s IP address. You can use a system name, but if your host tables are not filled in properly, you will be able to connect to the AS400, but PC*MILER won’t be able to create a Data Queue.
PC*MILER-AS400 User’s Guide 3. The Systems tab adds the AS400’s system name. This is where you set the password with which the router signs in. Make sure that the password has not expired, and that the account has object authority to the library where your mileage request Data Queue will reside (usually alkwin or an Innovative Work Library).
PC*MILER-AS400 User’s Guide 101 4. In the local LU tab use the second option, Use a local specific value. These are the only changes you need to make. Leave the other settings on the defaults.
PC*MILER-AS400 User’s Guide 102 Appendix C: Configuring AnyNet On the AS400 The following instructions are provided by NetManage. 1. Type the following command at the AS400 command prompt: CHGNETA ALWANYNET(*YES) This value can only be changed when the AnyNet controller is varied off. Vary on the controller to make the change effective. You can check this attribute with the DSPNETA command, and page down to the bottom. 2.
PC*MILER-AS400 User’s Guide 103 Appendix D: Configuring Client Access Express To Work With PC*MILER-AS400 1. Install Client Access Express on your mileage server PC by running the setup.exe that is in the Express folder on your Client Access Express CD. 2. Go to the AS400 Operations Navigator. For new installations, a Navigator prompt will ask if you want to add a connection.
PC*MILER-AS400 User’s Guide 104 For existing installations of Client Access Express, go into the AS400 Operations Navigator and right mouse click on your AS400 connection. Choose Properties to make changes or Verify to verify a connection. The Connection Properties Window is used for changing existing connections or changing the Restart Settings for new connections. NOTE: Client Access Express has the ability to change passwords in the user profile.
PC*MILER-AS400 User’s Guide 105 3. Password Considerations - There are several areas to consider with a Client Access Express installation. Client Access Express offers three Password options. You can choose to have the PC logged on manually to the AS400, have Client Access Express use the Windows User Name and Password, or you can specify a user profile and have the password typed in as needed. The default user ID is the User Profile that the mileage server PC will be signing on to.
PC*MILER-AS400 User’s Guide 106 If you want to have an unattended restart, your only option with Client Access Express is to store the User Profile Name and Password in the mileage server’s .ini file. At this time, the password is not encrypted, but it is stored as text. For auto-restart, you will also have to make the above settings in the Connection Properties dialog. (For new connections, right mouse click on your connection in the AS400 Operation Navigator, and choose properties to get this screen.
PC*MILER-AS400 User’s Guide 107 4. Verify the connection. If a connection cannot be made, contact IBM for assistance.
PC*MILER-AS400 User’s Guide 108 Appendix E: The Sleep Feature For PC Connection/ IPL Issues The Sleep Feature has been added to correct an issue in which the PC Distance Server (srv32.exe) does not reliably reconnect to the AS400 after an IPL or power down. To activate the Sleep Feature, you need to send a message to the PC mileage server (SRV32.exe). Included in your ALKWIN Library is a CL program called “queue”. For queue to work you must have alkwin in your library list.
PC*MILER-AS400 User’s Guide 109 Call queue(‘SP60’) press . Watch the server log to see that it catches the sleep message. Finally, the mileage server should wake up and reconnect with the mileage server. Now go back to the green screen PC*MILER and send another mileage request to test that the re-established connection is working properly. If it is working now, you can use this feature before your ipl’s or power downs.
110 PC*MILER-AS400 User’s Guide Appendix F: PCMSERVE.INI Settings The pcmserve.ini file resides on the mileage PC in the c:\windows or the c:\winnt folder. Values specified in pcmserve.ini will be used unless they are otherwise specified in the mileage request packet. PC*MILER|Streets uses pmwssrv.ini, and has a few additional key values included at the bottom of the chart. Valid values for default and option settings in the pcmserve.ini that can be changed by the user are described below.
111 PC*MILER-AS400 User’s Guide [Options] CustomRoute TRUE FALSE Should Custom routing be used. HazRoute (for PC*MILER Hazmat add-on only) None General Explosive Inhalant Radioactive Corrosive Flammable The default hazardous routing type: disabled, general material, explosive, inhalant, radioactive, corrosive, or flammable. Light Vehicle TRUE FALSE Set to TRUE (T) for light vehicle routing and restriction overrides; FALSE (F) = heavy vehicle routing and obey restrictions.
112 PC*MILER-AS400 User’s Guide the INI, the default U.S. code will be used. See section 4.3 for a list of all setting combinations. PC*MILER|Streets-specific Key values for pmwssrv.ini: [Options] UseStreets TRUE FALSE Should street-level (T) or highway-only (F) routing be used when stops are city names or ZIP codes. MatchRoadNameOnly TRUE FALSE Set to (T) to match address on road name only.
113 PC*MILER-AS400 User’s Guide Appendix G: AS400.LOG Error Codes To create a log file of all mileage server input and outputs, click on the mileage server’s File menu>AS400 Control and choose Log to file. The file created is c:\ALK Technologies\pcmiler28\as400\as400.log. AS400.log displays requests and responses in the exact format as they are received and sent by the mileage server. It is recommended that logging only be used for diagnostic purposes, as the log files get quite large.
114 PC*MILER-AS400 User’s Guide PCMS_NORTENGINE 127 PCMS_NODATASERVER 128 Server could not properly initialize internal routing component Server could not properly initialize internal routing component PC*MILER|Streets Error Codes: Error Codes Value PCMS_INVALIDPTR PCMS_NOINIFILE PCMS_LOADINIFILE PCMS_LOADGEOCODE PCMS_LOADNETWORK PCMS_MAXTRIPS PCMS_INVALIDTRIP PCMS_INVALIDSERVER PCMS_BADROOTDIR PCMS_BADMETANETDIR PCMS_NOLICENSE 101 102 103 104 105 106 107 108 109 110 111 PCMS_TRIPNOTREADY PCMS_INV
PC*MILER-AS400 User’s Guide 115 Appendix H: Technical Implications of PC*MILER|Tolls To accommodate the extra space needed for requesting and receiving Tolls Cost data, the request and response packet layouts were increased in size and the size of the response data queues was increased as detailed below. Third party or In-house transportation software must be modified to utilize PC*MILER-AS400 with the Tolls Cost component.
PC*MILER-AS400 User’s Guide 116 If the Tolls component is checked during installation, you will have the PC*MILER|Tolls build (Srv32.exe) and also “Srv32_Hwy.exe”, which is a renamed copy of the standard PCMILER build. However, a different installation will occur if the Tolls component is unchecked during installation, or if you respond ‘Yes’ to this dialog: In this case you will get a standard PC*MILER build named “Srv32.exe” along with “Srv32_Tolls.
PC*MILER-AS400 User’s Guide 117 After installing without Tolls (Tolls component unchecked or answered ‘Yes’ to ICC user flag prompt): The standard PC*MILER build for use with ALKWIN Library and existing third party applications is not modified to work with PC*MILER|Tolls, whereas the PC*MILER|Tolls build for use with ALKTLL Library and third party applications is written to work with the Tolls Cost component. To Switch Between Versions After Installation: Standard Highway to Tolls: 1.
PC*MILER-AS400 User’s Guide 118 a. Click the File drop-down menu. b. Choose “AS400 Control” then “Change Library/Data Queue”. c. Change the ALKWIN to “ALKTLL”. (AS400 users will need ALKTLL in their library lists.) Converting Tolls Cost Component to Standard Highway: 1. Stop the PC Mileage Server (srv32.exe) 2. Rename C:\ALK Technologies\pcmiler28\AS400\Srv32.exe to “Srv32_Tolls.exe”. 3. Make a copy of the Srv32_Hwy.exe, rename this copy that you made to “Srv32.exe”. 4. Launch the Mileage Server. 5.
PC*MILER-AS400 User’s Guide 119 “ALKWIN”. If your existing Library= value is an ICC library, you must change it to another library. 3. Create a shortcut to either Srv32_Hwy.exe or Srv32_Tolls.exe. Set the command line parameters to 2 2 2 or 2 2 1 as below. C:\ALK Technologies\pcmiler28\as400\SRV32_hwy.exe 122 for Client Access Express Connections C:\ALK Technologies\pcmiler28\as400\SRV32_hwy.exe 121 for NS Router Connections For PC*MILER|Streets: 1.
PC*MILER-AS400 User’s Guide 120 Appendix I: Renamed Program Objects PC*MILER-AS400 with the optional Tolls Cost component (PC*MILER|Tolls) is a modified version of the standard PC*MILER-AS400 version. The following objects have been renamed to avoid conflicts with existing PC*MILER products. NOTE: Some objects have been renamed twice to adhere to an updated naming policy.
PC*MILER-AS400 User’s Guide ALKWIN/STOPSD ALKTLL/STPTLD ALKWIN/SAVESTD ALKTLL/SAVETLD ALWIN/VALHLPD ALKTLL/VALHTLD 121
PC*MILER-AS400 User’s Guide 122 Appendix J: Setting Toll Discount Program Membership Toll Discount membership is set on your PC Mileage Server. Changes are made within the desktop PC*MILER program (C:\ALK Technologies\ pcmiler28\ App\ pcmwin32.exe). On your Mileage Server PC: 1. Click Start Programs PCMILER 28 PCMILER 28 (pcmwin32.exe). 2. Click Route Default Route Options. 3. Click the Tolls Tab. 4. Check the appropriate boxes as pictured below. 5. Exit pcmwin32.exe.
PC*MILER-AS400 User’s Guide 123 Appendix K: Method for Setting the Default Cost Per Mile or Kilometer For users who interpret the trip cost value as the trip distance in hundredths of miles or kilometers, the method for changing the default cost per mile or kilometer was changed in Version 24. If upgrading from v. 23 or older, follow the steps below. Before starting the PC Distance Server (srv32.exe), first run the desktop program (pcmwin32.exe) and follow these steps: 1.
PC*MILER-AS400 User’s Guide 124 2. In the Cost/Time tab, change the following values to 0: - Fuel Cost Per Gallon MPG Loaded and Empty Greenhouse Gases Labor Cost Per Hour 3. Set Other Cost Per Mile Loaded and Empty to 1. 4. After you’ve confirmed your changes, this is how the Default Route Options dialog will appear: 5. Click Save to save the edits and close the dialog. 6. Exit the Desktop PC*MILER program, then start your PC Distance Server.
PC*MILER-AS400 User’s Guide 125 Appendix L: Running PC*MILER and PC*MILER|Tolls Builds of the AS400 Interface on the Same PC These instructions are intended for use if you are required to run a Tolls build and a Non-Tolls build of the PC AS400 Interface (Srv32.exe, also known as ‘Bart’) on the same PC. Where noted, this method can also be used if you need to run two AS400 Interfaces connected to two different AS400s.
PC*MILER-AS400 User’s Guide Step 1: What is my configuration? 1. Start=> Programs=> PCMILER 28=> Right Click=> Bart=> Properties. 2. Read the ‘Target’ Parameters, will be 1 2 2 or 2 2 2. 3. Hit ‘Find Target’ button, do a right mouse click=> properties on Srv32.exe. 4. Hit ‘Version’ tab, will be either PC*MILER Build or PC*MILER|Tolls Build. View of Shortcut properties: Right-click Srv32.
PC*MILER-AS400 User’s Guide After right-clicking properties on Srv32.
PC*MILER-AS400 User’s Guide 128 Step 2: Copy C:\Windows DLL and INI File For parameters of 1 2 2 make a copy of c:\windows\pcmserve.ini and rename this copy to pmwssrv.ini. Make a copy of c:\windows\pcmsrv32.dll and rename this copy to pmwssrv.dll. For parameters of 2 2 2 compare the date and size of c:\windows\pmwssrv.dll to pcmsrv32.dll and compare the contents of pcmserve.ini to pmwssrv.ini. If they do not match, rename pcmsrv32.dll and pcmserve.ini and then make a copy of pmwssrv.