User manual ALK PC MILER AS400 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. Windows is a registered trademark of Microsoft Corporation. IBM is a registered trademark of International Business Machines Corporation. [. . . ] See section 6. 2. 4. 1 for full details. REMINDER: Users of PC*MILER Versions 14 and 15, and PC*MILER|Streets Versions 1, 2000, 3, and 4 must type a comma between the city and the state or province. For Version 16 and higher you have the option of using a comma or a space between the city and state or province abbreviation. PC*MILER-AS/400 User's Guide 39 6. 1 Technical Overview The PC*MILER-AS/400 system uses distributed processing techniques (i. e. The user interface or interactive software is written in RPG and runs on the AS/400. 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. The RPG programs communicate with the PC mileage calculation software through Client Access Express. The interactive software on the AS/400 allows multiple users to look up point-to-point mileage and routes for up to thirty stop-off points. The Windows server application creates a data queue on the AS/400 at startup called MIDQUE. The server application waits for mileage requests and processes them when received. While the server application is waiting for work to do, the PC can be used for other tasks such as PC*MILER graphics or RUMBA terminal emulation. AS/400 Programs Files MIINQ CITALK CRTQ DELQ GETLAT GETLATC GETMIL GETMILC GETQNAME VALDR Description Main AS/400 inquiry program that sends request to MIDQUE data queue RPG program that verifies city ZIP spelling CL program that creates an output data queue based on the job number CL program that deletes the queue created by CRTQ Sample RPG Program that converts City, Jurisdiction pairs or zipcodes to Lat/longs CL program that creates output queue and starts GETLAT RPG Sample RPG Program performs point-to-point mileage lookups CL program that creates output queue and starts GETMIL RPG RPG Program that determines library and data queue name for sending requests RPG Program that validates ZIP codes, place names, and street addresses; also provides pick lists of ZIPs codes, names and addresses when partial name, ZIP or address is passed in RPG parameters. Data queue that contains input mileage lookup records CL program that creates output data queue and starts MIINQ rpg CL program that writes to the MIDQUE request data queue External data structure for sending mileage requests External data structure for receiving mileage output External data structure for sending graphics requests to PC External data structure with field mappings for Borders and Use Ferry Distance External data structure with field mappings for Borders and Use Ferry Distance MIDQUE MIINQC QUEUE MISEND MIRESP DRAW MISEND2 TLSEND2 PC*MILER-AS/400 User's Guide 40 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. Then a "DR" request with the truck's origin and destination can be sent so that a graphical ETA can be determined. The data structures of these subroutines are described below. The PC Mileage Server can respond to a total of thirteen types of mileage and graphic requests: Mileage: VN = Version of PC*MILER Highway Data being used by the server VA = Validation that a stop (City, ZIP code, etc. ) is recognized by PC*MILER or a list of possible matches to a partial city or ZIP code MI = Total mileage for up to 30 stops SM = Total mileage for up to 30 stops broken down by state or province HS = Turn-by-turn driving instructions for up to 30 stops LL = Returns the lat/long coordinates for a city or address (PC*MILER|Streets only) Graphics: DR = Draw Route for up to 30 Stops DT = Draw up to 30 truck bitmaps or "push pins" on the map CT = Clear Truck bitmap from a specified location CR = Clear a drawn route line CA = Clear all routes and trucks PR = Print route PA = Print all The PC Mileage Server responds with the following types of returns: VR ­ Version of PC*MILER or PC*MILER|Streets 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 returns a PL MI returns a CP SM returns a CP and an SR. HS returns a CP, an SR and an HR LL returns an LR PC*MILER-AS/400 User's Guide 41 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. It is recommended that a validation (VA) request always precede each mileage request, especially where street addresses are included, in order to avoid misleading or incomplete output. · When you input a street address, use a city and state abbreviation whenever possible. [. . . ] Rename C:\Program Files\ALK Technologies\Pmw220\AS400\Srv32. exe to "Srv32_Hwy. exe". Make a copy of the Srv32_Tolls. exe, rename this copy that you made to "Srv32. exe". After starting the Mileage Server you need to change the Library for data queues as follows: a. Click the File drop-down menu. PC*MILER-AS/400 User's Guide 113 b. [. . . ]