Home

ALK Technologies AS/400 Switch User Manual

1. 19 5 0 Starting and Stopping the Mileage Server 20 6 0 Using PC MILER for the AS 400 ooo oom 22 7 0 Using PC MILER AS 400 Multiple Version Switch With Other Transportation Software oom 28 7 1 Technical OVerVIGIN seite onde SK KK as 32 7 2 Request and Response Field Parameters oooooo 33 7 2 1 PC MILER Versions Available MV Request and PESONA naa Sarees aan 34 7 2 2 Stop Validation VA Request and Response 35 7 2 3 Point to point Miles MI Request and Response 36 7 2 4 State Miles SM Request and Response 39 7 2 5 Detailed Route Information HS Request and Response 42 7 2 4 1 Upgrade NOlCO sorteo EDI an kn beer 45 7 2 5 Sample Request and Response Records 47 8 0 Using the PC MILER AS 400 Mileage Server and Map Window 48 SA hE ML Tod Ed dM du 48 9 0 Common Questions and Installation Problems 51 10 0 Technical Sup Aa PER RE UD Saa ccc FEN ALLE 53 Appendix A Backward Compatibility oom 55 Appendix B Configuring an N S Router For Use With PC MILER P B 56 Appendix C Configuring AnyNet On the AS 400 60 Appendix D Configuring Client Access Express To Work With PC
2. AS 400 display name instead of MIDQUE Mapping on Not Available Graphics for Mile Requests Not Available Log to File Turn diagnostics on off This is useful for debugging problems When on diagnostics are written to a file called as400 10g located in the directory that the software is running from srv32 exe Host Polling Timer Use faster time slice to poll the AS 400 more often for faster interactive response time or slower time slice for smoother graphic display Force Pick List Turns AS 400 pick lists off on for duplicate city names Activates lists for both large cities with multiple ZIP codes and duplicate city names The Map View Menu Not Available in PC MILER AS 400 Multiple Version Switch 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 50 PC MILER AS 400 MVS User s Guide Tile Horizontal Active windows will fit your screen running horizontally Display Serve Log Restore the Serve Log window if minimized Display Map Restore the Display Map window if minimized PC MILERAS 400 MVS User s Guide 9 0 Common Questions and Installation Problems Question Answer Question Answer Question Answer PC MILER works correctly when using the PCMILER command on the AS 400 but my Innovative software does
3. 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 I253 Foot Trailer Shortest J Toll Discouraged National Network Shortest K Toll Discouraged 53 Foot Trailer Shortest M or K for miles or kilometers R resequence stops H hub leg miles F resequence stops fixed destination blank otherwise M more data to follow Reserved by DR request E Extended Format A Asia E Europe F Africa N North America O Oceania S South America C Custom blank default Y Override Restrictions or L Light N Obey Restrictions or H Heavy G General Restriction E Explosive Restriction I Inhalant Restriction R Radioactive Restriction RESP SEQ 4 Sequence for multiple responses RESP ERR 2 Error Code El First state not found E2 First city not found E3 Second state not found PC MILER AS 400 MVS User s Guide 39 E4 Second city not found E5 Unable to resequence E6 Unable to calculate route E9 Disconnected Highway Network New RESP MVS 3 PC MILER Version Pos 29 31 New2 RESP Fill 7 PC MILER Version Pos 32 38 RESP CITI 39 39 bytes All stop information including Zip and or city state and or county and or Street address or If there is error the pcmiler error code RESP CIT2 39 39 bytes All stop information including Zip and or city state and or county and or Street
4. Install PC MILER for Windows and any of the following licensed data add ons e SPLCs e CanPosts e PC MILER HazMat e PC MILER Streets You will need product key codes to unlock these add ons please contact ALK at 609 683 0220 x301 The currently supported Versions of PC MILER are V14 x V15 x V16 x V17 x 2 For PC s previously used for PC MILER products check the Winnt folder for old dll s and INI files see file list in Step 4 6 below 11 PC MILER AS 400 MVS User s Guide 3 Install the correct version of PC MILER TCP IP Connect for each version of PC MILER that you will be using Pay strict attention to which version you are installing 4 Install PC MILER AS 400 Multiple Version Switch ALKMVS by following the steps below Step 1 Make sure the Netsoft Router or Client Access Express is installed and working on the PC see Appendix B Configuring an N S Router for Use with PC MILER AS 400 or Appendix D Configuring Client Access Express for Use with PC MILER AS 400 NOTE For NS Router Users PC MILER for the AS 400 is built on a specific Netmanage Data Queue DLL This DLL E32DQW DLL dated 12 18 98 is only on the PC MILER CD If you install any Netmanage software after installing the PC MILER for the AS 400 interface software you run the risk of getting the wrong version of this critical file and unpredictable behavior may result Step 2 Insert the PC MILERJAS 400 Multiple Version Switch Windows Inst
5. MEA ga ce dada 61 Appendix E The Sleep Feature For NS Router Installations 66 Appendix F PC MILER AS 400 Multiple Version Switch INI Settings 68 Appendix G AS400 LOG Error Codes ooooooo momo 72 PC MILER AS 400 MVS User s Guide 1 PC MILER AS 400 Important Changes for Version 17 Please Read For Version 17 PC MILER now offers two basic route types Practical and Shortest that may be combined with one or more of the other three route types that PC MILER users are familiar with Toll Discouraged and National Network or 53 Trailer Routing Users of the PC MILER interactive program who want to obtain Toll Discouraged National Network or 53 Trailer routing will additionally have to specify either the Practical or Shortest Route type Previous to Version 17 all Toll Discouraged National Network or 53 Trailer routes were based on the Practical route type This new functionality gives you the option to run 12 diferent route types Practical Shortest Practical Toll Discouraged Shortest Toll Discouraged Practical National Network Shortest National Network Practical 53 Foot Trailer Shortest 53 Foot Trailer Practical Toll Discouraged National Network Shortest Toll Discouraged National Network Practical Toll Discouraged 53 Trailer Shortest Toll Discouraged 53 Trailer Note that National Network and 53 Trailer Routing cannot be combined they are mutually exclus
6. 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 MV returns a NS VA returns a PL MI returns a CP SM returns a CP and an SR HS returns a CP an SR and an HR 7 2 Request and Response Field Parameters The following sections specify the field parameters for the request types defined in section 7 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 e When you input a street address use a city and state abbreviation whenever possible Example Princeton NJ 1000 Herrontown Road The comma between the city and state is optional The semicolon between the state abbreviation and the street address is required 34 PC MILER AS 400 MVS User s Guide e Use a street number Example Princeton NJ 1000 Herrontown Road as opposed to Princeton NJ Herrontown Road In this example if Herrontown Road is 50 miles long and no address is included the returned mileages could be very inaccura
7. a long enough period of time If Bart wakes up too early before the AS 400 is back up it won t be able to connect Be sure to leave enough time between sending the sleep command and starting the ipl or power down Bart needs time to disconnect the router before the router senses the AS 400 dropping out or the process fails 67 68 PC MILER AS 400 MVS User s Guide Appendix F PC MILER AS 400 Multiple Version Switch INI Settings PC MILERIAS 400 Multiple Version Switch uses multiple INI files AS400 exe uses Srv32 INI and Pemmv INI Each instance of PC MILERITCP IP Connect uses its own Pcmserve INI Srv32 INI is used for startup information Pemmv INI is used to store the locations of your various instances of PC MILERITCP IP Connect Srv32 INI and Pcmmv INI have to be kept in synch at all times Changes to the values under the MultiVersion Key in Srv32 INI have to be mirrored in Key names in Pcmmv INI For example from Srv32 INI Multi Version ProductO PCMiler 140 amp Maps to PCMiler 140 in Pemmv INI Product ZPCMiler 150 lt Maps to PCMiler 150 in Pemmv INI Product2 PCMiler 160 lt Maps to PCMiler 160 in Pemmv INI Product3 PCMiler 170 lt Maps to PCMiler 170 in Pemmv INI In Pemmv INI default product PCMiler 150 This must match one of the Products listed above The default instance of PC MILERITCP IP Connect is only used if a mileage request Has no version specifed blanks in MVS parameter An error will be
8. address RESP MILE 5 Total miles returned or PC MILER 3 digit error code RESP HOUR 4 Total time in hours 0031 3 1 hours RESP COST 7 Total cost for city pair 0052295 522 95 FILL134 134 Blank Fill Total 266 Bytes 7 2 4 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 Var Name Len Value Description Extended Format REQ TYPE 2 SM Miles request REQ REF 10 Output Queue Name ALK uses Q the job number Request Options 13 22 REQ OPTION 1 Pos 1 S Shortest P Practical N National Practical T Toll Discouraged Practical 5 53 Trailer Practical B Toll Discouraged Practical 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 1 53 Foot Trailer Shortest 40 REQ MORE REQ FMT REQ REGION Worldwide Only REQ Custom Routing REQ Ovrd Restrictions REQ Hazmat REQ SEQ REQ ERR New gt REQ MVS New gt REQ FILL REQ CIT wrn Position 29 31 700 PC MILER AS 400 MVS User s Guide 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 reseguence stops H hub leg miles F resequence stops fi
9. common input or request queue that all 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 Multiple PC MILER versions are made available via a bundling of one or more instances of PC MILER TCP IP Connect pemsock exe AS 400 users communicate only with the PC mileage server as400 exe The PC mileage server handles the communication with the various instances of PC MILER TCP IP Connect These instances can be run on a single PC or a group of PC s PC MILER for the AS 400 was developed using the data queue facilities of Netmanage s NS Router and IBM s Client Access Express You must have one of these two connectivity products installed and properly configured on the mileage server PC ALK Technologies recommends you use Client Access Express If you want to use NS Router it is bundled in many releases of Client Access or it can be purchased directly from Netmanage at www netmanage com or 408 973 7171 The NS Router is no longer being produced as a separate package but is being sold under Netmanage s Legacy Program Netmanage provides limited support for their Legacy products The NS Router is bundled in several Netmanage packages For your PC MILER for the AS 400 installa
10. name is being sent to PC MILER click on the Pick Pins icon and then on the stop off point in the mapping window Now correct your AS 400 cities file When I change my queue name to MIDQUE my PC can t receive anything from the AS 400 Make sure that you exit and restart the PC MILER interactive software on the AS 400 The PC MILER program on the AS 400 will detect the presence of the new queue and it will send requests to this queue The interactive response time has become slower on the AS 400 since we have added several more users Can we improve the performance Yes You can run multiple copies of the PC MILER AS 400 program on the same PC if you have enough memory Or if you have another available PC you can start up PC MILER AS 400 on the other PC How can I run PC MILER AS 400 on more than one PC Make sure that PC MILER AS 400 is installed properly on each PC Additionally set the queue name to MIDQUE so that the multiple PC s are servicing the same queue PC MILER AS 400 MVS User s Guide 53 10 0 Technical Support Technical support is available to registered users of PC MILER AS 400 from 9 00am to 5 00pm EST Monday through Friday Call 609 683 0220 x303 Or e mail us at pcmsupport alk com type PCM AS400 in the subject line PC MILER AS 400 MVS User s Guide Appendix A Backward Compatibility ALK Technologies does support backward compatibility with previous versions of PC MILER and PC MILER for the AS
11. not work Run the CONFIG command on the AS 400 which is described in the manual and type the Innovative work library name I93WORK or ITSR5W012 check with ICC After this is complete check the File menu in the AS 400 Mileage Server choose AS 400 Control Change Library Queue Or you can edit the PCMSERVE INI or PMWSSRV INI for Streets changing the LIBRARY ALKMVS to LIBRARY I93WORK and then restart the AS 400 Mileage Server Or re install the AS 400 windows CD and type I93WORK Restart the SERVER PC MILER works correctly when using the PCMILER command but my McCormick software does not use the same routing options such as Practical or Shortest The McCormick software was enhanced so that it uses the mileage parameters that are set by our CONFIG utility Some McCormick sites do not have these enhancements The user should call McCormick about this problem The Interactive PC MILER screen crashes when I type in an ICC Short City Code PC Miler does a lookup in an ICC Cities database when you use Short City Codes a component program of PC Miler needs to be compiled with access to your Cities database The compile will fail unless you have ALKMVS and your Innovative work and file libraries in your library list Get a 400 command line and do a DSPLIB make sure you have ALKMVS and your two Innovative Libraries in your list The Innovative libraries are different from release to release They can be I93WORK and I93DATA or ITSRAWORK an
12. restricted roads will always be avoided In addition Heavy Vehicle routing takes nationwide 13 6 height restrictions into account A heavy vehicle is one weighing at least 80 000 pounds a light vehicle weighs less than 80 000 pounds e Miles Kilometers M will cause PC MILER to generate distances in miles K will cause PC MILER to generate distances in kilometers e HazMat Hazardous Material Type optional add on data module Types of hazardous material routing that can be generated are G for General E for explosive I for Inhalant and R for Radioactive PC MILERAS 400 MVS User s Guide e Region Continent Regions in which mileages can be generated are A for Asia E for Europe F for Africa N for North America O for Oceania or S for South America Regions outside North America require PC MILER Worldwide FOR AN ON SCREEN DISPLAY OF THESE DEFINITIONS press the Help key on your keyboard For Terminal Emulation sessions on PC s this is typically the Scroll Lock key or Right Mouse Click gt Help 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 AS 400 You may enter up to 30 stop offs NOTE PC MILER AS 400 only suppo
13. to make adjustments later in the installation Remember your installation location You do not need to reboot the PC as directed Step 2 3 Version 16 1 Run cdrom W161 setup exe e If you are installing just PC MILER 16 1 you will not need a product key code f you are intalling an approved PC MILER AS 400 Multiple Version Switch data add on you will need a product key code e Without a product key code enter Trial in the Registration Number dialog Do not choose PC MILER Streets unless you have previously licensed it from ALK and have the Street Level Data CD PC MILER AS 400 MVS User s Guide The default install location is C Program Files Alk Technologies Pmw160 If you change this you will need to make adjustments later in the installation Remember your installation location Step 2 4 Version 17 0 e Run lt cdrom gt v17 setup exe e f you are installing just PC MILER 17 0 you will not need a product key code e f you are intalling an approved PC MILER AS 400 Multiple Version Switch data add on you will need a product key code from ALK e Without a product code enter Trial in the Registration Number dialog Do not choose PC MILER Streets unless you have previously licensed it from ALK and have the Street Level Data CD The default install location is C Program Files VAlk Technologies Pmw 1 70 If you change this you will need to make adjustments later in the installation Remember yo
14. with the connection to the mileage server PC At the top of the main entry screen are several control settings These include PC MILER Version Available Versions are returned from the mileage server PC This will be a list of three digit numbers like 140 lt space gt 150 lt space gt 160 lt space gt 170 This list is updated only at PCMVS Startup If no versions are available the word Trouble or some nonsensical word will be listed PC MILER AS 400 MVS User s Guide Note The requirements for commas between the city name and the jurisdiction code vary with the requested PC MILER Version For Version 14 x and 15 x a comma is required e g Princeton NJ For Versions 16 x and 17 x you can use a comma or a space e g Princeton NJ or Princeton lt space gt NJ Request Type MI the default entry will cause PC MILER or PC MILER Streets to generate only point to point mileage look ups SM will cause PC MILER to 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 cause PC MILER to generate detailed driving instructions in addition to the state mileage summary and point to point mileage look up Graphics requests Are not supported in PC MILER AS 400 Multiple Version Switch Routing Type Varies with the Version Requested For Versions 14 x amp 15 x the options are P Practical S Shortest N National Network T
15. 102bwam Properties Unattended v 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 AS 400 Operation Navigator and choose properties to get this screen PC MILER AS 400 MVS User s Guide 65 4 Verify the connection If a connection cannot be made contact IBM for assistance Verify AS 7400 Connection 3 Verifying connection to system S102BWAM Successfully connected to server application Network File Successfully connected to server application Network Print uccessfully connected to server application Data Access uccessfully connected to server application Data Queues uccessfully connected to server application Security uccessfully connected to server application Telnet 5 5 Successfully connected to server application Remote Command 5 H i E AG Connection verified to system S102Bw AM Eana VETITIGRU OT 66 PC MILER AS 400 MVS User s Guide Appendix E The Sleep Feature For NS Router Installations The Sleep Feature has been added to correct an issue in which the NS Router does not reliably reconnect to the AS 400 after an IPL or power down There should be no need to use this feature when you are using a Client Access Express connection To activate the sleep feature you need to send a message to the PC mileage server SRV32 exe Included in your ALKMVS Library is a C
16. 2 drivers etc hosts For 95 98 c windows hosts sam Here we are adding an AS 400 called S102BWAM you can also use the IP address of your AS 400 Add AS 400 Connection Welcome Welcome to the Operations Navigator Add Connection wizard What is the name of the 45 400 system to which you want to connect 4S 400 system Environment My 45 400 Connections Back Cancel 61 62 PC MILER AS 400 MVS User s Guide For existing installations of Client Access Express go into the AS 400 Operations Navigator and right mouse click on your AS 400 connection Choose Properties to make changes or Verify to verify a connection S102bwam Properties 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 If you are prompted for a new password you will be making a permanent change in that user profile PC MILER AS 400 MVS User s Guide 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 AS 400 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 Add AS 400 Connection AS 400 Signon
17. 234567N 1234567W 5 digit zips only Canadian Postal Codes use the format L L lt space gt L add on data module For Standard Position Location Codes SPLC plus the number add on data module Filler CIT 630 blank 36 New gt Validation Response Var Name Len Value RESP TYPE 2 PL RESP REF 10 Filler 3 3 RESP MORE 1 Filler 3 3 Match 1 L Y N Filler 2 2 RESP Seq 4 RESP ERR 2 E2 RESP MVS 3 RESP CIT 980 Filler 15 PC MILER1AS 400 MVS User s Guide Description Extended Format Stop pick list Output Queue Name 3 blanks Pos 16 M more data to follow Pos 20 List of Cities Exact match No match 2 blanks Pos 23 26 Sequence for multiple responses Pos 27 28 Error Code Place not found Pos 29 31 3 character PC MILER Version Pos 32 38 Not Used Array of 14 places 70 bytes each left justified or Error message if there is a problem 7 2 3 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 This type of request could be used for a quick mile lookup from a host inquire program or for running several stop off points in a batch environment The host dispatching software could generate this request when a new trip is established Var Name Len Value REQ TYPE 2 MI REO REF 10 Trip Options Positions 13 22 REO OPTION 1 Description Extended
18. 400 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 Future backward compatibility is not guaranteed If you would like more information about backward compatible formats please contact the ALK technical support staff see Chapter 10 56 PC MILER AS 400 MVS User s Guide Appendix B Configuring an N S Router For Use With PC MILER AS 400 Unless you have a twinax connection configure your router using the AnyNet protocol AnyNet needs to be enabled on the AS 400 see Appendix D Configuring AnyNet on the AS 400 For PC MILER Version 14 or higher and any PC MILER Streets version you must have the N S Router version 3 0 or higher About NS Administrator x NS Administrator Version 3 10 Copyright 1995 1997 NetSoft Photos Copyright 1995 Digital Stock Copyright 1994 Corel Corporation Check by selecting HELP About in the NS Administrator or the midrange workspace NOTE If you need to upgrade your NS Router you must reinstall the PC MILER AS 400 interface afterwards The PC MILER interface is built on a specific Netsoft Data Queue DLL that is available only on the PC MILER interfaces CD To start the configuration go to the N S Administrator ri
19. E 140 space 150 space 161 7 2 2 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 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 nonvalid 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 Validation Request Var Name Len Value Description Extended Format REQ TYPE 2 VA Validate Stop or Address REQ REF 10 Output Queue Name ALK uses Q plus job number Filler 8 8 Force Pick List 1 P Force Pick List or Blank Position 20 Filler 7 7 New MVS Parms 10 positions 29 31 3 bytes PC MILER Version 7 bytes not used REQ CIT 70 70 bytes each left justified 38 byte maximum city name byte comma optional 2 byte state abbrev byte comma optional 13 byte county name optional or for Streets byte semicolon followed by street address Examples Warminster PA BUCKS Warminster PA 1174 NASSAU ROAD 18974 Lat long format should be 1
20. ER 16 x Quebec QC Newfoundland NF P ractical S hortest Comma or space T oll Discouraged N ational Network 5 FiftyThree Foot required between city and jurisdiction code PC MILER 17 x Quebec QC Newfoundland NL P ractical S hortest N ational Network prac 5 Fifty Three Foot prac T oll Discouraged prac Comma or space required between city and jurisdiction code B Toll Discouraged Practical C National Network Practical D 53 Foot Trailer Practical PC MILER AS 400 MVS User s Guide 31 E Toll Discouraged National Network Practical F Toll Discouraged 53 Foot Trailer Practical G Toll Discouraged Shortest H National Network Shortest 53 Foot Trailer Shortest J Toll Discouraged National Network Shortest K Toll Discouraged 53 Foot Trailer Shortest Restriction Overrides by Version PC MILER 14 x PC MILER 15 x PC MILER 16 x PC MILER 17 x Feature not available Feature not available Available with Street Level Add on Only Available all versions Codes For PC MILER Versions Must be 3 characters PC MILER 14 0 140 PC MILER 14 1 141 PC MILER 15 0 150 PC MILER 15 0 151 PC MILER 16 0 160 PC MILER 16 1 161 PC MILER 17 0 170 PC MILER 17 1 171 32 PC MILER AS 400 MVS User s Guide 7 1 Technical Overview The PC MILER AS 400 system uses distributed processing techniques i e the processing is split into two The user interface or interactive softwa
21. Format Miles reguest Output Queue Name ALK uses Q the job number Request Position Pos 1 S Shortest P Practical N National Practical T Toll Discouraged Practical 5253 Trailer Practical B Toll Discouraged Practical 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 PC MILER AS 400 MVS User s Guide 37 HzNational Network Shortest I 53 Foot Trailer Shortest J Toll Discouraged National Network Shortest K Toll Discouraged 53 Foot Trailer Shortest 1 Pos 2 M or K for miles or kilometers 1 Pos 3 R resequence stops H hub leg miles F resequence stops fixed destination blank otherwise REQ MORE 1 Pos 4 M more data to follow 1 Pos 5 Reserved by DR request REQ FMT 1 Pos 6 E Extended Format Required see Appendix A REQ REGION 1 Pos 7 A Asia Worldwide Only E Europe F Africa N NorthAmerica O Oceania S South America REQ CUSTOM 1 Pos 8 C Custom blank default REQ Ovrd Restrictions 1 Pos9 Y Override Restrictions or L Light N Obey Restrictions or H Heavy REQ Hazmat Data Add on 1 Pos 10 G General Restriction E Explosive Restriction I Inhalant Restriction R Radioactive Restriction REQ SEQ 4 Sequence for multiple responses REQ ERR 2 Error Code New gt REQ MVS 3 Requested PCMILER Version Position 29 31 140 PC MILER Version 14 141 PC MILER Version 14 1 150 PC MILER Ve
22. Information Eg What user ID do you want to use to sign on to S102BWAM C Use Windows user name and password no prompting SHUMAKER Use default user ID prompt as needed PCMILER C Prompt every time lt Back Cancel The default user ID is the User Profile that the mileage server PC will be signing on to This user will need the authority to create and delete data gueues in either the ALKMVS Library or your Innovative Work Library If you choose to use the Windows User and Password you have to have the Windows User Name and Password match the user profile and Password that you will be using for your mileage server PC to sign onto the 400 with The Windows User and password must exactly match those in the user profile you are using In the event of a power loss the PC will not connect to the AS 400 until someone manually types in the Windows password To get a PC to restart without prompting for a password you have to set the Windows Password to nothing AS 400 security does not allow a null password So if you want the mileage server PC to reconnect automatically after a power outage you cannot use the Windows Password option 64 PC MILER AS 400 MVS User s Guide 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 S
23. L program called queue For queue to work you must have ALKMVS in your library list You may have to compile the queue if you do not have the program use the command WRKOBJPDM with 12 on QCLSRC and 14 on queue The syntax for queue is Queue lt space gt SP60 where 60 is the number of seconds that you want the mileage server to sleep for NOTE Queue is case sensitive the SP has to be in caps To put the mileage server to sleep for a 3 hour period before an IPL you would have to run this command with ALKMVS in your library list Call ALKMVS queue lt space gt SP10800 The sleep process only works if the only thing using the NS Router is one mileage server You can t be running Netsoft Green Screens or more than one mileage server The sleep feature sends a message to the NS Router to disconnect its conversations with the AS 400 The sleep command can only disconnect its own connections having other active connections causes the process to fail You will need to test the sleep feature On your mileage server set up your screen so you can watch both the Router Midrange Workspace and the mileage server s Server Log SRV32 exe To get the Midrange Workspace up double click the small overlapping white amp purple squares icon that resides by the system clock You can also press and hold down the ALT key and press and release the TAB key until the Midrange Workspace NS Router Icon is selected and then re
24. Light N Obey Restrictions or H Heavy Pos 10 G General Restriction E Explosive Restriction 42 PC MILER AS 400 MVS User s Guide I Inhalant Restriction R Radioactive Restriction RESP SEQNUM 4 Sequence for multiple responses RESP ERROR 2 Error Code El First state not found E2 First city not found E3 Second state not found E4 Second city not found E5 Unable to resequence E6 Unable to calculate route E9 Disconnected Highway Network New RESP MVS 3 PC MILER Version Pos 29 31 New RESP Fill 7 PC MILER Version Pos 32 38 STATEMIL 220 10 elements each element will consist of 2 for state code 5 for total miles 4 for toll miles FILLER 118 7 2 5 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 Var Name Len Value Description Extended Format REO TYPE 2 HS Miles reguest REO REF 10 Output Oueue Name ALK uses Q the job number Request Options 13 22 REQ OPTION 1 Pos 1 S Shortest P Practical N National Practical T Toll Discouraged Practical 5 53 Trailer Practical B Toll Discouraged Practical CzNational 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 1 53 Foot Tr
25. PC MILER AS 400 MULTIPLE VERSION SWITCH USER S GUIDE PC MILER PAK ALK Technologies Inc 1000 Herrontown Road Princeton NJ 08540 ALK ALK Technologies Inc 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 trademark of Microsoft Corporation PC MILER is a registered trademarks of ALK Technologies Inc ALK Technologies Inc reserves the right to make changes or improvements to its programs and documentation materials at any time and without prior notice Copyright 1994 2003 ALK Technologies Inc 1000 Herrontown Road Princeton NJ 08540 Table of Contents PC MILER AS 400 Version 17 Notes Please Read 1 140 IntrodU ton Mun akik ak bd n 3 2 0 Hardware and Software Requirements oom 4 2 1 PC MILER Graphics en asu en Na 4 3 0 Installation as cia iden aera RED D nva ARE hn ha lakban lala ana 5 3 1 Installation Overview cote oic reb eec ena Hb 6 3 2 AS 400 Side Installation jes e eio Uw req ptos poten lean 6 3 3 PC Side Install atiO i hd KS qux at De RR 9 4 0 Starting an Instance of PC MILER TCP IP Connect
26. S Library will cause the program to crash if HS requests are used 1 Create a library with the CRTLIB command Type CRTLIB ALKMVS 2 Add the library to the current library list Type ADDLIBLE ALKMVS For Innovative Computing Corporation installations you will also need your ICC WORK and FILE libraries in your current library list For Version R6 type ADDLIBLE I93FILE or ITSR6FILE and then ADDLIBLE I93WORK or ITSR6WORK The ICC Version 7 libraries are IESR7WORK and IESR7FILE Call ICC if you don t know which version you are running NOTE For Updates Only Type config from the AS 400 command line and print screen your current mileage settings These settings will be overwritten during the library restore After the restore of the library re enter these settings by running the ALKMVS CONFIG command Make sure there are no users working in PC MILER or PC MILER Streets PC MILER AS 400 MVS User s Guide 3 Command for restoring from CD rstlib savlib ALKMVS dev opt01 vol ALKMVS Label ALKMVS mbropt all alwobjdif all rstlib ALKMVS where opt01 is your CD ROM drive 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 gt NOTE The ALKMVS Library CD was created using Kisco Information Systems BlueCD which allows you to create AS 400 readable SAVLIBs on a PC CD writer A small percentage of users may have difficulty
27. Toll Discouraged For Version 16 x P Practical S Shortest N National Network T Toll Discouraged 5 Fifty three Foot Trailer For Version 17 x Either Practical or Shortest routing can now be combined with other available PC MILER routing options Toll Discouraged National Network or 53 Trailer You must specify either P Practical or S Shortest for all routes Refer to the main PC MILER Users Guide for more detailed descriptions of these routing options See Chapter 7 Using PC MILER With Other Transportation Software for details on using this new functionality with other software packages Route options are described below e Toll Discouraged Version 17 Only T will cause PC MILER to generate miles which avoid long stretches of toll roads You will receive either a Practical Toll Discouraged Route or a Shortest Toll Discouraged Route depending on how you have your Routing Type set 23 24 PC MILER AS 400 MVS User s Guide e National 53 Foot Version 17 Only N will cause PC MILER to generate miles calculated using the National Network which is designed for larger trucks 5 will generate miles suitable for 53 trailer routing National Network or 53 Foot Trailer will be generated using either the Practical or Shortest routing type You can also combine National Network and 53 Foot Trailer routing with the Toll Discouraged option For example you can generate a Practical To
28. ailer Shortest J Toll Discouraged National Network Shortest PC MILER AS 400 MVS User s Guide 1 1 REQ MORE 1 1 REQ FMT 1 REQ REGION 1 REQ Custom Routing 1 REQ Ovrd Restrictions 1 REQ Hazmat 1 REQ SEQ 4 REQ ERR 2 REQ CIT 700 43 K Toll Discouraged 53 Foot Trailer Shortest Pos 2 M or K for miles or kilometers Pos 3 R reseguence stops H hub leg miles 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 or L Light N Obey Restrictions or H Heavy Pos 10 G General Restriction E Explosive Restriction I Inhalant Restriction R Radioactive Restriction Sequence for multiple responses 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 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 44 PC MILER AS 400 MVS User s Guide 2 Response Following are field parameters for a response to the route and state miles request The PC re
29. all Disk On the CD are the following folders MVSInst V14 V151 V161 V17 You can install any version you are licensed for If you are installing the PC MILER Streets add on you will need a Street Level Data CD not automatically shipped with PC MILER AS 400 Multiple Version Switch You can install all four versions of PC MILER on one PC or you can install each version on its own PC the PC s must be networked PC MILER AS 400 MVS User s Guide 13 Step 2 1 For Version 14 e Run cdrom W1 4 setup exe f you are installing just PC MILER 14 0 you will not need a product key code e f you are intalling an approved PC MILER AS 400 Multiple Version Switch data add on you will need a product key code e Without a product key code check only the PCMILER 14 0 box and then use Pcd1400001 for the serial number The default install location is C Pmw140 If you change this you will need to make adjustments later in the installation Remember your installation location You do not need to reboot the PC as directed Step 2 2 For Version 15 1 Run cdrom W151 setup exe e f you are installing just PC MILER 15 0 you will not need a product key code e f you are intalling an approved PC MILER AS 400 Multiple Version Switch data add on you will need a product key code e Without a product key code check only the PCMILER 15 0 box The default install location is C Pmw150 If you change this you will need
30. aring it 28 PC MILER AS 400 MVS User s Guide 7 0 Using PC MILER AS 400 Multiple Version Switch With Other Transportation Software PC MILER AS 400 Multiple Version Switch is a modified version of PC MILER AS 400 Connect PC MILER AS 400 Multiple Version Switch has an additional trip parameter available that enables the user to specify or Switch between various versions of PC MILER Currently PC MILER versions 14 x 15 x 16 x and 17 x are supported PC MILER AS 400 Multiple Version Switch is licensed in addition to any PC MILER versions a company has purchased All supported versions may not be available You will have to make use of the MV request to verify what versions are available Passing Blanks will result in the return of an error There is no support for a default version Notes for All Users Changes to route types and jurisdiction codes are not unified see chart below Use of Comma between city and jurisdiction code not unified see chart below All HS highway segment turn by turn driving instructions are uniform at the Version 16 x level e Override Route Restrictions option not uniformly available see chart below Versions 16 x and 17 x have more detailed highway networks and therefore have slower response times You may have to adjust your wait times accordingly Notes For Existing PC MILER AS 400 Connect Users Asetof 10 new trip parameters has been inserted into all of the request and re
31. d ITSRAFILE or ITSR5WORK and ITSRSFILE or ITSReWORK and ITSR6FILE or IESR7WORK and IESR7FILE If the necessary libraries are not in your list use the ADDLIBLE command to add them Then do a WRKOBJPDM lt space gt ALKMVS Do a 12 on QRPGSRC and then a 14 on CITICC say yes to replace existing member 51 52 Question Answer Question Answer Question Answer Question Answer Question Answer PC MILER AS 400 MVS User s Guide PC MILER works correctly but my Innovative Print Missing Tariff miles is not returning miles for a few cities The city spellings in the Innovative city file are different than in PC MILER Use the report from the Print Missing Tariff Miles which lists the city discrepancies and type PCMILER from the AS 400 command line Now type the city code in e g OCOK should be Oklahoma City OK and press lt ENTER gt PC MILER will indicate that it is not found Now use the long spelling of the city for example ok OK to determine the PC MILER spelling Press lt F16 gt 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 Some of the mileage returned from PC MILER is different from the mileage returned by my other transportation software The city spelling or ZIP being used by the other software is probably not correct To verify what place
32. d region ID PCMS_CLOSINGERROR PCMS_NORTENGINE PCMS_NODATASERVER Error Codes PCMS_INVALIDPTR PCMS_NOINIFILE PCMS_LOADINIFILE PCMS_LOADGEOCODE PCMS_LOADNETWORK PCMS_MAXTRIPS PCMS_INVALIDTRIP PCMS_INVALIDSERVER PCMS_BADROOTDIR PCMS_BADMETANETDIR PCMS_NOLICENSE PCMS_TRIPNOTREADY PCMS_INVALIDPLACE PCMS_ROUTINGERROR PCMS_OPTERROR PCMS_OPTHUB PCMS_OPT2STOPS PCMS_OPT3STOPS PCMS_NOTENOUGHSTOPS PCMS_BADNETDIR PCMS_LOADGRIDNET PCMS_BADOPTIONDIR PCMS_DISCONNECTEDNET PCMS_NOTRUCKSTOP PCMS_INVALIDREGIONID PCMS_CLOSINGERROR PC MILER AS 400 MVS User s Guide 126 127 128 PC MILER Streets Error Codes Value 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 73 Server did not shut down properly Server could not properly initialize internal routing component Server could not properly initialize internal routing component Message Invalid pointer The INI file was not found Could not load the INI file Could not load location database Could not load the network database Too many open trips limit 8 Invalid trip ID Invalid server ID Invalid Root Dir setting in INI file Invalid Met aNet Dir setting in INI file License infraction too many users or licenses not found The trip is not ready to calculate Invalid place name city state not found Calculation failed portions of trip are invalid Optimization
33. eate a short Cut for it in your Startup folder Step 4 5 Icons There is an icon for PC MILER AS 400 Multiple Version Switch installed in alkmvs You can copy it to other locations Note for NetSoft Users If you are forced to use the NetSoft Router instead of Client Access Express you will have to change the icon properties Change the third parameter from 2 to 3 so that the target will be c alkmvs as400 exe lt space gt 3 lt space gt 2 lt space gt 1 Step 4 6 Removing DLL s from Winnt If you are using PC s that previously were used for PC MILER products check the Winnt folder on each one for old dll s and INI files The files listed below for each version of PC MILER Connect formerly PC MILER Server must not be in the Winnt folder Version Files that can not be in Winnt Folder 14 x pcmdsrv dll pcmfav dll pcmgcode dll pcmgnet dll pcmnet dll pcmreng dll pcmsrv32 dll pcmtcp dll pcmxtra dll pcmserve ini 15 x pcmdsrv dll pcmfav dll pcmgcode dll pcmgnet dll pcmnet dll pcmreng dll pcmsrv32 dll pcmtcp dll 18 16 x 17 x pcmxtra dll pcmserve ini pcmsrv32 dll pcmtcp dll pcmserve ini pcmsrv32 dll pcmtcp dll pcmserve ini PC MILER AS 400 MVS User s Guide PC MILER AS 400 MVS User s Guide 4 0 Starting an Instance of PC MILER TCP IP Connect PC MILER TCP IP Connect can be started from a command or from a batch file Within the PC MILERJAS 400 Multiple Version Switch installat
34. es in PCMMVI INI Values Must Be Formatted as Name lt space gt Where is 040 for Streets 4 0 and as follows 140 141 150 151 160 161 170 171 et cetera ProductO PCMiler 140 Product1 PCMller 150 Product2 PCMiler 160 Product3 PCMiler 170 Each instance of PC MILER TCP IP connect has it s own pcmserve ini file in that version s Tcpip folder Values specified in pcmserve ini will be used unless they are otherwise specified in the mileage request packet included at the bottom of the chart 70 PC MILER AS 400 MVS User s Guide These values will only be used if they are not specified by the calling application Valid values for default and option settings in the pcmserve ini that can be changed by the user are described below Key Valid Values Description Defaults Defaults CalcType Practical Set In Srv32 Inl Units Miles What unit of measure should Kilometers distance be shown in ChangeDest TRUE When optimizing the route FALSE should the trip s destination be optimized also Borders TRUE Set in Srv32 Inl FALSE Should the engine try to keep routes within the United States F or can they cross and recross the borders at will T HubMode TRUE Calculate the routes from the FALSE origin to each stop T not through each stop F AlphaOrder TRUE List the states in the State FALSE Report in alphabetical order or in the order driven FerryMiles TRUE Use ferry dis
35. failed portions of the trip are invalid Cannot optimize a trip in HUB mode Not enough stops to optimize the trip Not enough stops to optimize without changing destination Not enough stops to calculate the trip Bad network directory Error loading gridded network Bad option directory Disconnected network Truck inaccessible stop Invalid region ID Closing error
36. for diagnostic purposes as the log files get quite large PC MILER 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 Invali
37. ght click on the N S Router and choose Properties i NS Administrator Iof xi Workspace Object View Tools Help alsz 5 ES EH f J Midrange Workspace 43 400 45 400 Printer Display 9 New 45 400 Display PC MILER AS 400 MVS User s Guide 57 Then do the following 1 In the Links Tab highlight AnyNet and then choose Properties Properties for NS Router al Direct TCP IP 2 In Properties fill in the AS 400 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 AS 400 but PC MILER won t be able to create a Data Queue Property for NS 7Houter AnyNet 159 29 63 254 58 PC MILER AS 400 MVS User s Guide 3 The Systems tab adds the AS 400 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 ALKMVS or an Innovative Work Library Properties for NS Router System Properties PC MILER AS 400 MVS User s Guide 59 4 In the local LU tab use the second option Use a local specific value Properties for NS Router F Use the detaulbname inthe she server These are the only changes you need to make Leave the other settings on the defaults 60 PC MILER AS 400 MVS User s Guide A
38. h the data queue name and library is the connection status return code Good returns are 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 NS Router or Client Access Express connections NOTE Both the PC and the AS 400 must agree on the location of the Input or Request data queue To change the location on the PC click on the mileage servers File menu Choose AS 400 Control then Change Library Queue The change is made on the AS 400 by running the ALKMVS config command and filling out the library field The server log only notes incoming requests If you need to see the mileage server s outputs turn on the Log to File feature by selecting the mileage server s File menu and choosing AS400 Control Highlight Log to File This will create a file called c ALKMVS as400 log It is recommended to only use logging for diagnostic purposes otherwise the log files tend to grow large Stopping the Interface To close PC MILER TCP IP Connect click Exit in the File menu From the PC MILER AS 400 Multiple Version Switch window choose Exit from the File menu NOTE If you are closing your router remember to disconnect the AS 400 beforehand Please be patient the PC MILER mileage server can take a minute or two to exit Be sure to disconnect the Netsoft Router from the AS 400 before closing the router Failure to do so may result in hav
39. hway Road or Street Name and Interchange City or Junction was increased 10 characters from 28 to 38 The previous format is shown on the next page 46 Format in previous versions ROUTEINFO 4 sets PC MILER AS 400 MVS User s Guide 2 indicates end of route data for stop 2 state code 1 toll indicator 6 directional North Turn L etc 20 route number 4 leg mileage 28 for intersection city or junction 8 for cumulative leg miles 6 for cumulative stop miles PC MILER AS 400 MVS User s Guide 47 7 2 5 Sample Request and Response Records Sample records are shown below Sample State Miles SM request record State Mile request type Extended Format required Origin city name and state Region North America abbreviation Output Queue Name street address only with Q plus job number PC MILER Streets Y Override Restrictions Light i SMQ208684 PM EN Y 0001 170 princeton nj 1000 herrontown road l PC MILER Version san diego ca Sequence for multiple responses Practical routing Report distances in Miles Destination city name and state abbreviation Sample State Miles SR response record M for More indicates more CP response record than one SR Total miles total time total cost see Miles recedes SR response record needed Ml request and response description P P record to follow MI reg E P CPQ208684 L 0001 170 Princeton NJ 1000 Herrontown Road 92138 San D
40. iego CA San Diego 0279104250306987 SRQ208684 PMM N L 0002 170 AZ004900000CA001690000IL001720000IN001570000M0002860000NJ000160000NM0037300 000H0023300000K003550195PA003470 SRO208684 PM N L 0003 TX00179Q000WV000130000 State Miles AZ CA IL IN etc More State Miles in second SR output record TX WV 48 PC MILER AS 400 MVS User s Guide 8 0 Using the PC MILER AS 400 Mileage Server and Map Window Maps are not available in PC MILER AS 400 Multiple Version Switch 8 1 Menus All menu commands in PC MILER for the AS 400 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 AS 400 Input Queue When a queue becomes corrupted creates a new queue and deletes the corrupted one Exit Exit PC MILER AS 400 When you exit all active windows are saved as they appear on your screen for the next time PC MILER AS 400 is opened AS 400 Control Configure the Mileage server for different purposes Choose from the sub menu Change Library Queue Location of request input queue Default Library is ALKMVS Default Data Queue Name is MIDQUE Innovative users use your ICC work library IE ITRS6WORK or IESR7WORK If you want to display routes trucks for requests coming from this one PC rather than for all requests use your PC MILER AS 400 MVS User s Guide
41. ilable PC MILER versions It will find a newly started instance of PC MILER TCP IP Connect and will remove a version which has stopped responding If you edit StartMvs bat and create a shortcut for it in your startup folder as described in installation Step 4 4 the software you installed on your dedicated PC will cause the interface to start automatically when the PC is turned on If Client Access Express or Netsoft Router is running on the PC then click on the PC MILER AS 400 icon or reboot the PC Client Access Express or the NetSoft Router must automatically sign on with a user ID and password if unattended startups of the mileage server PC are desired To automate the sign on process by supplying a user ID and password see Appendix D for Client Access Express or Appendix B for the N S Router When the mileage server as400 exe starts it displays the connection status in the mileage server s log window You can bring up this window by clicking on the mileage servers Window menu and choosing Display Server Log Multiversion A400 1 0 Server Log Ioj xl 3 File Map View Window Help lj x A9400 Server Loa Started reesei Creating Queue ALKMVS MIDOUE Create return value 2 Setting Data conversion mode on SetMode return value 0 Waiting for data queue request PC MILER AS 400 MVS User s Guide The Name of Mileage Request or Input data queue and the library in which the queue resides are logged The number underneat
42. imized and the product can be launched automatically For multiple PC installations the increase in network traffic is minimal for mileage requests less than 0 3KB per request and generally no larger than 35KB for turn by turn Driving Directions Performance between versions is not equal ALK s highway networks have become more detailed over time which has slowed down processing a bit Version 17 is the slowest followed by 16 x Versions 14 amp 15 are roughly egual Depending on lookup volume you may be able to combine versions 14 and 15 on one PC and dedicate one PC each to versions 16 and 17 Another thing to consider is that when starting the product as described below you will have to launch an instance of PC MILER TCP IP Connect on every PC PC Side Essentially the PC side of the PC MILER AS 400 Multiple Version Switch installation can be broken down into two parts PC MILER AS 400 Multiple Version Switch as400 exe which reads mileage requests from a request data queue on the AS 400 and at least one instance of PC MILER TCP IP Connect pcmsock exe which provides the mileage and routing information for as400 exe to return to a response data queue on the AS 400 Each instance of PC MILER TCP IP Connect needs its own copy of the PC MILER desktop application This installation provides the highway network database and a mechanisim for editing custom routing features PC MILER AS 400 MVS User s Guide PC MILER TCP IP Connec
43. ing to reboot the PC before you can reconnect to the AS 400 It is not necessary to manually disconnect a Client Access Express connection 6 0 Using PC MILER for the AS 400 To use PC MILER for the AS 400 issue the command PCMVS from the command line The following screen will appear l Session A 24 x 80 lal xl File Edit Transfer Appearance Communication Assist Window Help E Go allot ge 5 a 2 5a Ta Display Color ad Record Stop Play Quit Clipbrd Support Index MultiVersion AS400 1 8 20 03 PCxMiler Version 170 160 150 140 09 38 18 Request Type MI SM HS Routing Type Practical S Shortest Toll Discouraged _ Blank National 53Foot _ National 5 53foot Blank Custom Routing _ Custom Blank Hub or Optimize RF Ovrd Restrictions or N HazMat Miles or Kilometers or K i N A E F N O S Continent Enter City State County or Zip Press Help key for examples Margo SK Chloe LA Calcasieu Debs MN Beltrami Ate Andrew AB 1 2 3 4 5 6 7 8 9 10 F2 State help F3 Exit F7 Ins stop F8 Del stop F10 Process F11 Restart F22 Swap stops F23 Load Trip F24 Sav Trip MA a 17 011 Connected to remote server host 172 21 63 254 using port 23 Ai NOTE The PCMVS command contacts the mileage server to read the data that the mileage server is using If the PCMVS command doesn t respond or the PC MILER screen comes up with PC DOWN in the screen title there is a problem
44. inzip windows These files must be extracted to the App subfolder of your PC MILER V16 1 or V17 0 installation Step 4 Configuring PC MILER AS 400 Multiple Version Switch Step 4 1 Edit AlkMvs Srv32 ini You will need to complete the following with the IP Address or System Name of your AS 400 and the User Profile and Password that the PC will be using for the AS 400 signon IP Address or System Name of AS 400 system User Profile user Password pass Save your changes and exit srv32 ini Step 4 2 Edit AlkMvs pcmmv ini to set default PC MILER Version Set the default version of PC MILER under the Default Key The default version is necessary for starting PC MILER AS 400 Multiple Version 15 16 PC MILER AS 400 MVS User s Guide Switch Mileages will only be returned if the PC MILER Version trip parameter is valid The default name must match one of the key names Be careful of editing the Key Names like PCMiler 150 these values have to match those set in srv32 ini under multiversion Step 4 3 Edit AlkMvs Pcmmv ini to point to your various instances of PC MILER TC PIP Connect If you are going to run each instance of PC MILER TCP IP Connect on a single PC you can skip this step Pcmmv ini is used to locate the various instances of PC MILER TCP IP Connect By default Pcmmyv ini is pointing to local copies via the loop back address If you are using multiple PCs you will have to change the loop bac
45. ion each copy of PC MILER TCP IP Connect pcmsock exe has been renamed to reflect the PC MILER version it is returning mileage and routing information for The format is pcmsockxx exe where xx is the PC MILER version This enables identification of a particular version within the Windows Task Manager Pcmsock exe takes two parameters the PC MILER package and the port number The PC MILER package is PC MILER You should use Ports in the 8000 range with the last two digits corresponding to the version of PC MILER that is being used For example Pcmsock14 exe lt space gt PC_MILER lt space gt 8014 would be the command to start Version 14 PC MILER TCP IP Connect Note There has to be agreement between the Port number that an instance of PC MILER TCP IP Connect is listening to and that version s entry in AlkMvs Pcmmv ini It is best to use a batch file to start the various services See Step 4 4 of the installation instructions Within the batch file you must change directories to the installation directory of PC MILER TCP IP Connect before launching the start command Note If you are using a multiple PC setup you will need to have a batch file on each PC 20 PC MILER LAS 400 MVS User s Guide 5 0 Starting and Stopping the Mileage Server At least one instance of PC MILER TCP IP Connect must be running before you can start PC MILER AS 400 Multiple Version Switch as400 exe AS400 exe while running maintains a list of ava
46. ive Third Party or In house Transportation Software Must Be Modified to Utilize PC MILER Version 17 If you are using PC MILER with other transportation software that software will have to be modified to utilize the new functionality Without modifications to your third party or in house software you will have only the following routing types available PC MILER AS 400 MVS User s Guide Shortest Practical Practical Toll Discouraged Practical National Network Practical 53 Trailer See Chapter 7 Using PC MILER With Other Transportation Software for more information Note for Users Upgrading from PC MILER Streets If you are upgrading from PC MILER Streets note that the Light Heavy vehicle option has been renamed to Override Restrictions The 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 PC MILER AS 400 MVS 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 AS 400 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 for the AS 400 includes all the sta
47. k 127 0 0 1 to the IP address or the computer name of the remote PC If you are having trouble connecting on a computer name you will have to map that computers name to its IP address in C winnt system32 drivers etc hosts If your system has a conflict with the default port number you will have to change the port number in pcmmv ini and in the batch file that is used to start uo PC MILER TCP IP Connect See Step 4 4 Step 4 4 The various instances of PC MILER TC PIP Connect need to be started before starting the PC MILER AS 400 Multiple Version Switch executable The best way to do this is via a batch file A working copy of one is installed in C AlkMvs called StartMvs bat StartMvs bat is setup for running all four versions of PC MILER on the same PC If you do not have a particular version you will have to remove it from StartMvs bat Note Each version of pcmsock exe has been renamed with its version number appended so that the versions are distinguishable in the Windows Task Manager Note The second parameter passed to pcmsock1x exe is the Port Number if you change these values you must change the values in alkmvs pcmmv ini PC MILER AS 400 MVS User s Guide 17 Note In StartMvs bat you will find the commands to start AS400 exe commented out To have PC MILERJAS 400 Multiple Version Switch started automatically simply uncomment the CD and the Start lines Once you have StartMvs bat configured properly you can cr
48. lease both keys PC MILER AS 400 MVS User s Guide To get the AS 400 mileage server screen you can click on SRV32 on your tool bar You can also press and hold down the ALT key and press and release the TAB key until the AS 400 Server PC MILER icon is selected and then release both keys To bring up the Server Log click on the Bart s Windows pull down menu or press ALT W and choose Display server Log From a green screen on another PC or terminal run PC MILER and runa route from 10001 to 90009 to make sure that it is working Watch the PC MILER AS 400 Servers server log You should see those ZIP codes show up in a line that starts out inputz This test is to ensure that you are working with the correct mileage server and that it is working properly Now exit the green screen PC MILER and send a 60 second sleep command Call queue lt space gt SP60 press lt ENTER gt Watch the server log to see that it catches the sleep message Also watch in the Midrange Work Space that the number of conversations drops to zero Finally the mileage server should wake up and reconnect with the mileage server the number of conversations in the Midrange Work Space should go up to 2 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 Be sure to put it to sleep for
49. ll Discouraged National Network route See Chapter 7 Using PC MILER With Other Transportation Software for details on using this new functionality with other software packages e Custom Routing C will use custom routing preferences avoids and favors set in PC MILER or PC MILER Streets When this position is blank routing preferences will be disabled e Hub or Optimize A blank space is the default entry and is used for the standard PC MILER operation H is used to initiate the hub distance generator R is used to initiate route sequencing with the origin fixed and the remaining 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 e Ovrd Override Restrictions Version 17 x and 16 x with optional Street Level Add on Only In addition to the five basic PC MILER route types a Heavy and Light Vehicle routing option is now offered When Ovrd Restrictions is set to Y the Light Vehicle option is activated With Light Vehicle routing active truck prohibited roads will always be avoided but truck restricted roads are considered for a route PC MILER normally gives preference to Interstates major highways and major thru roads where possible With Ovrd Restrictions set to N Heavy Vehicle routing is in effect so both truck prohibited and truck
50. ndard features found in the PC version including the Hub Distance Generator Spelling Helper route resequencing and user defined time and cost estimates You are referred to the main PC MILER Users Guide for a more thorough discussion of these features With PC MILER AS 400 you can quickly and easily generate point to point miles driving instructions and mileage summaries broken down by toll roads and freeways A route map of a trip can be viewed and printed from a PC with PC MILER Mapping installed In house software can be customized to draw the ETA status of a truck s current location during a trip PC MILER for the AS 400 utilizes a unique distributed processing solution This solution maximizes the efficiency of your AS 400 by farming out repetitive mileage calculations to a PC With PC MILER AS 400 you can benefit from having a seamless mileage interface with your management system Interfaces have been developed for Innovative Computing Corporation Qualcomm McCormick amp Associates and others Use PC MILER for the AS 400 to audit driver logs and supplement your fuel tax reports Increase driver productivity by using PC MILER s driving instructions ETA s with graphical truck display and trip sequencing In addition your purchase of PC MILER AS 400 will eliminate the high costs of leasing mileage systems or paying exorbitant transaction fees 4 PC MILER AS 400 MVS User s Guide 2 0 Hardware and Software Requirements Beca
51. om blank default REQ Ovrd Restrictions 1 Pos 9 Y Override Restrictions or L Light N Obey Restrictions or H Heavy REQ Hazmat 1 Pos 10 G General Restriction E Explosive Restriction I Inhalant Restriction R Radioactive Restriction PC MILER AS 400 MVS User s Guide REQ SEQNUM 4 REQ ERROR 2 El E2 E3 E4 ES E9 New RESP MVS 3 New RESP Fill 7 RouteInfo 300 ROUTEINFO 3 sets FILLER 2 45 Sequence for multiple responses Error code First state not found First city not found Second state not found Second city not found Unable to resequence Disconnected Highway Network PC MILER Version Pos 29 31 PC MILER Version Pos 32 38 3 Sets of 100 Each 2 indicates end of route data for stop 2 state code toll indicator 6 directional North Turn L etc 35 route number 4 leg mileage 38 for intersection city or junction 6 for cumulative leg miles 6 for cumulative stop miles NOTES The PC will send CP response records for MI requests The PC will send CP and SR response records for SM requests The PC will send CP SR and HR response records for HS requests 7 2 4 1 Upgrade Notice All HR returns regardless of requested PC MILER Version return the larger V16 format In Version 16 and 17 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 Hig
52. ow gt NOTES A CP city pair point to point miles response is always returned first for all three request types MI SM and HS and an SR state miles output record follows the CP response to an HS highway system detailed route information request see section 7 2 4 Response from PC Len Value REQTYPE 2 SR REFNUM 10 Request Options 13 22 PARMS 1 1 1 RESP MORE 1 1 RESP FMT 1 RESP REGION 1 RESP Custom Routing 1 RESP Ovrd Restrictions 1 RESP Hazmat 1 Description State miles summary Output Queue Name ALK uses Q the job number Pos 1 Pos 2 Pos 3 Pos 4 Pos 5 Pos 6 Pos 7 Pos 8 Pos 9 S Shortest P Practical N National Practical T Toll Discouraged Practical 5253 Trailer Practical B Toll Discouraged Practical 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 1 53 Foot Trailer Shortest J Toll Discouraged National Network Shortest K Toll Discouraged 53 Foot Trailer Shortest M or K for miles or kilometers R resequence stops H hub leg miles F resequence stops fixed destination blank otherwise M more data to follow Reserved by DR request E Extended Format Required see Appendix A A Asia E Europe F Africa N North America O Oceania S South America C Custom blank default Y Override Restrictions or L
53. ppendix C Configuring AnyNet On the AS 400 The following instructions are provided by NetManage 1 Type the following command at the AS 400 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 Type the following command at the AS 400 command prompt CRTCTLAPPC CTLD controller name LINKTYPE ANYNW RMTCPNAME same as controller name RMTNETID NETATR For controller name any name can be used Only create one AnyNet controller per 255 users If multiple AnyNet controllers are created unpredictable results may occur For any further questions see your AS 400 System Administrators User s Guide PC MILER AS 400 MVS User s Guide Appendix D Configuring Client Access Express To Work 1 With PC MILER AS 400 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 Go to the AS 400 Operations Navigator For new installations the Navigator will prompt to ask if you want to add a connection You will need to know the IP Address of your AS 400 and the System Name if you want to configure your connection using the AS 400 System name You will have to make a table entry in the PC s Hosts File For NT or Windows 2000 the file is C winnt system3
54. re is written in RPG and runs on the AS 400 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 N S Router or Client Access Express The interactive software on the AS 400 allows multiple users to look up point to point mileages 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 The server application responds to an output queue specified within the request packet AS 400 Programs Files Description MVSIINQ Main AS 400 inquiry program that sends request to MIDQUE data queue CITALK RPG program that verifies city ZIP spelling CITHLP RPG program that displays city help screen with pick list CRTQ CL program that creates an output data queue based on the job number DELQ CL program that deletes the queue created by CRTQ GETLAT Sample RPG Program that converts City Jurisdiction pairs or ZIP codes to Lat longs GETLATC CL program that creates output queue and starts GETLAT RPG GETMILV Sample RPG Program performs point to point mileage lookups GETMILVC CL program that creates output queue and starts GETMIL RPG GETQNAME RPG Program that determines library and data queue name for sending requests VALDR RPG Program that validates ZIP codes place names and stree
55. restoring the ALKMVS Library with the above commana If you experience problems Type RSTLIB then a Specify the library ALKMVS and the appropriate optical device b Press lt F10 gt for more options c Specify ALL on database member options d Specify ALL on allow object differences 4 The system administrator should make the library ALKMVS available to users at sign on time There are two ways to insert ALKMVS into the library list a The WRKSYSVAL command can be used by typing WRKSYSVAL and then searching for the QUSRLIBL entry Insert ALKMVS b If your users are using a job description in their user profiles then use the CHGJOBD command type CHGJOBD and insert ALKMVS For Innovative Computing installations a command is available to help insert a library into the library list ALKMVS should be the first library in the library list NOTE Run this command from a typical ICC user account or profile not QSECOFR Enter the following ADDLIBLE ILPGMR LAST CHGLIBLS insert ALKMVS 8 PC MILER AS 400 MVS User s Guide 5 To grant object authority to library ALKMVS enter the following GRTOBJAUT press lt F4 gt object ALL library ALKMVS objtype ALL users public authority ALL NOTE For ICC Users only Be sure to do this Type config from the AS 400 command line after the restore of the library then change the library for the location of mileage data queues from ALKMVS to yo
56. returned for any other Invalid version request SRV32 INI Explained Defaults Default values valid values are listed after the description Leave values blank to use the following internal defaults CalcType Practical Route Type Units Miles Distance Units Miles or Kilometers ChangeDest TRUE Route Through All on Trip Resequence HubMode FALSE Lock in Hub mode Use with Caution AlphaOrder TRUE List States alphabetically versus in drive through order in reports IP Address or System Name of AS 400 system User Profile user PC MILER AS 400 MVS User s Guide 69 Password pass express libraryZALKMVS Location of request Queue Midque and Temporary Response Queues qname MIDQUE PICKLIST FALSE Force Pick list for cities with multiple zip codes and for partial matches SLEEPTIME 300 Used for NS Router Connects during IPL s FrameTrip FALSE Not used DIAG TRUE Turn on logging Borders FALSE amp False Cross International Borders only for International Stops Timer Time between reads of request queue Mapping FALSE Not Supported ExpMap Not Supported ExitWin Not Supported Options CustomRoute Obey Avoids Favors and Restriction Overrides set in pemwin32 exe Default Region NA ProductName MultiVersion AS400 ProductVersion 1 0 Must Point to the location of pemmv dll DLLPath C alkmvs Multi Version Values Here Must Match Key Nam
57. rsion 15 0 151 PCMILER Version 15 1 et cetera New gt REQ FILL 7 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 digit zips only Canadian Postal Codes use L L lt space gt L Standard Position Location Code use SPLC number 38 PC MILER AS 400 MVS User s Guide 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 The CP response is always returned first for all three request types MI SM and HS Var Name Len Value Description Extended Format RESP TYPE 2 CP City pair returned output RESP REF 10 Output Queue Name ALK uses Q the job number Request Options 13 22 RESP NET 1 Pos 1 RESP MIL TYPE 1 Pos 2 RESP OPTION Pos 3 AQ RESP MORE 1 Pos 4 Pos 5 1 Pos 6 RESP REGION 1 Pos 7 RESP Custom Routing 1 Pos 8 RESP Ovrd Restrictions 1 Pos 9 RESP Hazmat 1 Pos 10 S Shortest P Practical N National Practical T Toll Discouraged Practical 5 53 Trailer Practical B Toll Discouraged Practical
58. rts Degree Minute Second lat long format e g 0333716N 1142709W NOTE For PC MILER Streets Users An address should directly follow the city state or ZIP code entry separated by a semicolon e g Princeton NJ 1000 Herrontown Road You can also purchase separate add on data modules for Canadian postal codes or SPLC codes A Canadian postal code is entered in the same manner as a ZIP code but in the following format L L lt space gt L e g K7L 4E7 A SPLC is a six or nine digit number preceded by the letters SPLC e g SPLC908601 At the bottom of the screen the function keys used with PC MILER for the AS 400 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 AS 400 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 Sends the request to PC MILER on the dedicated PC F11 Restart Clears the screen and lets you start making data entries on the screen again 25 F12 Main Screen Returns to the main stop entry screen from the mileage report screens F22 Reverse Reverses the order of stops entered F23 Load a saved trip In the screen that comes up typing X with the cursor on a trip identifier in the pick list will load that trip typing D will delete
59. sition Location Codes SPLCs Canadian Postal Codes e PC MILER HazMat e PC MILER Streets Do not install e PC MILER Connect aka PC MILER Server e PC MILER TCP IP Connect e PC MILER AS 400 Connect PC MILER Black Box or PC MILER for the AS 400 interface e PC MILER Mapping e PC MILER SpreadSheets PC MILER AS 400 MVS User s Guide Note Pre Version 16 SPLC s and CanPosts were mutually exclusive you could install one or the other In Version 16 and higher both can be installed together For installing PC MILER Streets Versions 16 x or 17 x you will need the Street Level Data CD which is not automatically provided with the PC MILER AS 400 Multiple Version Switch shipment If the product was previously licensed you will have a Street Level Data CD with that shipment For new purchases of PC MILER Streets to be used with PC MILER AS 400 Multiple Version Switch you will receive a second set of disks which will contain the Street Level Data CD You can reuse product key codes from previous installations if you have them Do not intall any add ons but the ones listed above as being compatible SPLC s CanPosts Hazmat routing and Street Level routing For Version 17 do not attempt to license the installation when you are prompted at the end of the installation Once the various PC MILER TCP IP installations are complete install PC MILER AS 400 Multiple Version Switch ALKMVS Step by Step Installation Instructions 1
60. sponse packets Output Data Queues sizes were lengthened from 1024 to 1034 e Data Area Comalk was modified to store a default PC MILER version Old mode or short city names 22 characters are not supported Graphics maps are not supported NOTE For Version 17 the routing type options have changed for National Network Toll Discouraged and 53 Trailer routing These three special PC MILER AS 400 MVS User s Guide 29 routing options now can be generated in combination with the Practical or Shortest options Additionally National Network and 53 Trailer routing can be combined with the Toll Discouraged options The only way to take advantage of this new functionality is to pass in the new code in position 1 of the Request Options Previously the five available codes were P Practical S Shortest N National Network T Toll Discouraged 5 53 Foot Trailer New Codes P Practical S Shortest B Toll Discouraged Practical 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 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 Disco
61. sponse record has all of the required detailed route information There are four route list records vesponse records Therefore if there are more than four records for the route additional response records must be returned Multiple returned records are designated by the M in the MORE parameter field gt REMEMBER A CP and SR output record will always precede the HR response record Response from PC Len Value Description REQTYPE 2 HR Route highway information returned REFNUM 10 Output Queue Name ALK uses Q the job number Request Options 13 22 REQ OPTION 1 Pos 1 S Shortest P Practical N National Practical T Toll Discouraged Practical 5253 Trailer Practical B Toll Discouraged Practical 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 1 53 Foot Trailer Shortest J Toll Discouraged National Network Shortest K Toll Discouraged 53 FootTrailer Shortest 1 Pos 2 M or K for miles or kilometers 1 Pos 3 R reseguence stops H hub leg miles F resequence stops fixed destination blank otherwise REQ MORE 1 Pos 4 M z more data to follow 1 Pos 5 Reserved by DR request REQ FMT 1 Pos 6 E Extended Format Required see appendix A REQ REGION 1 Pos 7 A Asia E Europe F Africa N North America O Oceania S South America REQ Custom Routing 1 Pos 8 C Cust
62. t addresses also provides pick lists of ZIP codes names and addresses when partial name ZIP or address is passed in RPG parameters MIDQUE Data queue that contains input mileage lookup records MVSIINOC CL program that creates output data gueue and starts MIINO rpg QUEUE CL program that writes to the MIDQUE request data queue NWSEND External data structure for sending mileage requests NWRESP External data structure for receiving mileage output The program MSVIINQ 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 PC MILER AS 400 MVS User s Guide 33 New gt New gt The PC Mileage Server can respond to a total of five types of Mileage Requests Mileage VN Version of PC MILER AS 400 Multiple Version Switch being used by the server MV Versions of PC MILER Highway Data available 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 The PC Mileage Server responds with the following types of returns VR Version of PC MILER or PC MILER Streets running on the PC NS Version s of PC MILER running available
63. t is itself built on another PC MILER product called PC MILER Connect ALK s mileage and routing dynamic link library dll PC MILER Connect is a version specific product for example Connect Version 15 x will not work with Version 16 PC MILER The normal installation of PC MILER Connect involves installation of our milage and routing dlls to a computer s Winnt folder For PC MILER AS 400 Multiple Version Switch these dlls are installed to the working directory for pcmsock exe underneath the top level of that version s PC MILER for Windows installation Note If you are installing PC MILER AS 400 Multiple Version Switch on a PC that previously was used to produce PC MILER mileages you will first have to manually remove PC MILER Connect dlls from the computer s Winnt folder See the chart of file names by version below Installation Overview Install a copy of PC MILER for Windows for each version you will be accessing Versions 14 0 15 1 16 1 and 17 are bundled on the PC MILER AS 400 Multiple Version Switch PC Side CD Install only compatible add ons from the list below You can install the data add ons listed below if you have licensed them If you licensed any of these add on products you will have to contact ALK at 609 683 0220 x301 to obtain a product key code to unlock them If you aren t installing any add ons you won t need a product key code PC MILER AS 400 Multiple Version Switch Compatible Add ons e Standard Po
64. tances in FALSE mileage and cost calculations T or don t use F Options OnRoad TRUE Show latitude longitudes on FALSE the nearest road segment or at their true locations FavorMajor TRUE Attach latitude longitudes to Roads FALSE larger more important roads or to the nearest road segment PC MILER AS 400 MVS User s Guide CustomRoute TRUE FALSE HazRoute None for General PC MILER Explosive Hazmat add Inhalant on only Radioactive Pcmmv INI PCMiler 140 71 Should PC MILER Connect use Custom routing The default hazardous routing type disabled general material explosive material inhalant material or radioactive material address 127 0 0 1 Ip Addpress of Computer Name port 8014 Port Number that specified when PC MILERITcpip Connect was started PCMiler 150 address 127 0 0 1 port 8015 PCMiler 160 address 127 0 0 1 port 8016 PCMiler 170 address 127 0 0 1 port 8017 default amp Used if Version Parm populated with blanks product PCMiler 150 72 PC MILER AS 400 MVS 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 gt AS 400 Control and choose Log to file The file created is c pmw170 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
65. te e When a street address is not supplied do not send a semi colon Example Send 08540 as opposed to 08540 a semi colon will cause the server to look up a blank address which is not necessary Three examples of correct input Trenton NJ 21 Olden Avenue New York NY 118 Broadway 20001 7 2 1 PC MILER Versions Available MV Request and Response It is recommended that you maintain a list of available versions via the MV request type Within the NV return is a space delimited list of available versions For instance 140 150 161 170 Note The PC MILER AS 400 Multiple Version Switch PC mileage Server is designed such that if the Mileage Server as400 exe loses connection to a particular version of PC MILER the affected version will be removed from the list Version Request Var Name Len Value Description REQ TYPE 2 MV PC MILER Versions Available REQ REF 10 Output Queue Name ALK uses Q plus job number REQ PARMS 10 Optional REQ SEQUENCE 4 Optional REQ ERROR 2 REO MVS 3 Optional REO FILL 237 Blank Fill Total 268 Version Response Var Name Len Value Description RESP TYPE 2 NV Stop pick list RESP REF 10 Output Queue Name RESP PARMS 10 Trip Parms RESP SEQUENCE 4 Always 0001 RESP ERR 2 Pos 27 28 Error Code PC MILER AS 400 MVS User s Guide 35 RESP MVS 3 Pos 29 31 PC MILER Version RESP FILL 7 Pos 32 38 Not Used RESP VERSIONS 228 Array of space delimited left justified 3 character Versions I
66. the trip F24 Save a trip Enter a trip identifier of up to 10 characters in the entry field that appears Help Pressing the key labeled Help on your keyboard will bring up detailed instructions for using various features of PC MILER for the AS 400 f you are using an emulator the Help key on your keyboard will usually be the Scroll Lock key or Right Mouse Click Help Once you have entered stops on the main screen and initiated a mileage inquiry by pressing lt F10 gt the following screen will appear 0x File Edit Transfer Appearance Communication Assist Window Help 3 E i E 2 f ES E af Va E a o tr B PrtScm Copy Paste Send Recv Display Color Map Record Stop il Clipbrd Support Index _8 20 03 09 45 32 Chloe LA Calcasieu O 2575 90 1918 04 1419 92 Connected to remote server host 172 21 63 254 using port 23 This report contains leg and cumulative miles for each segment of your trip The time and cost estimates are based on the values contained in the copy of PC MILER or PC MILER Streets installed on your dedicated PC MILER AS 400 MVS User s Guide 27 PC Refer to the main PC MILER User s Guide for instructions on how to alter these values F3 will exit the program F9 will print the screen lt F11 gt will return you to the previous screen and will clear it lt F12 gt will return you to the previous screen without cle
67. tion you need only the NS Router The NS Router must be configured to use the Anynet or Twinax protocols Connecting via Anynet requires the creation of an Anynet Controller on the AS 400 If you are using NS Router you need the NS Router 3 0 or higher for PC MILER AS 400 Version 17 Client Access 3 2 has the 3 0 Router bundled with it Do not patch your router without talking to ALK first The PC MILER for the AS 400 system was developed on a non patched Router and installing any patch may cause unpredictable behavior 6 PC MILER AS 400 MVS User s Guide 3 1 Installation Overview You should have received two CD s with your purchase of PC MILER AS 400 e The PC MILER Product Line CD which includes the complete PC MILER application and the PC MILER AS 400 Mileage Server PC MILER Connect AS 400 e The second CD contains the 400 side ALKMVS Library NOTE Required PC to AS 400 Connectivity Software is not provided by ALK You need either IBM s Client Access Express or the NS Router from either IBM s Client Access Bundle or Netmanage 3 2 AS 400 Side Installation First install the resident AS 400 software on your AS 400 Sign on to QSECOFR or an account with equivalent authorities Place the CD in the optical drive and follow the instructions below NOTE For Upgrades ALK increased the length of the Highway Segment HS Turn By Turn Driving Instructions by 25 characters Failure to upgrade your current ALKMV
68. ur 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 IBSWORK ITSREWORK or IESR7WORK Check with ICC for this name NOTE Also The AS 400 side and the PC Side must match which Library the Mileage Request or Input data queue resides in You will be prompted during the PC Side Installation for your data queue location or there is an option to change it under the PC Connect AS 400 Control Menu I Session A 24 x 801 Fie ER Transfer Appearance Communication Asgst indon Help 9 gt 2 sis mm ams igi Aj ejm Input Data Queue Library Connected to remote servershost 172 21 63 254 using port 23 PC MILER AS 400 MVS User s Guide 3 3 PC Side Installation The PC Side of the PC MILER AS 400 Multiple Version Switch installation is a multi faceted process The installation varies depending on the number of versions of PC MILER and PC MILER Streets involved and the number of mileage server PCs that will be used Generally installations can be performed in less than half an hour if you strictly follow the instructions Failure to follow instructions can result in hours of trouble shooting with the possibility of multiple reboots The installation and operation of the product is made easier if you use of one quality desktop PC dedicated to running only PC MILER AS 400 Multiple Version Switch Configuration time is min
69. ur installation location Do not choose to Activate the License as prompted at the end of the installation STEP 3 Install PC MILER AS 400 Multiple Version Switch On the PC MILER AS 400 Multiple Version Switch Windows Install Disk is a folder called MVSInst Within the folder are the following self extracting zip files alkmvs exe gt Contains PC MILER AS 400 Mutiple Version Switch Install For16App exe gt V16 1 Mileage and Routing Support Files For17App exe gt V17 0 Mileage and Routing Support Files v14tcpip exe gt V14 PC MILER Tcpip Connect v15tcpip exe gt V15 PC MILER Tcpip Connect v16tcpip exe gt V16 PC MILER Tcpip Connect v17tcpip exe gt V17 PC MILER Tcpip Connect Step 3 1 Run alkmvs exe it is set to unzip to C ALKMVS You can redirect the path in the Unzip window if necessary PC MILERAS 400 MVS User s Guide Step 3 2 Unzip the correct version of the TCP IP file for your version The self extracting zip files are set to unzip to the default locations If you installed your PC MILER to non default locations you will have to redirect the extractions In the winzip windows If you redirect the extractions be sure to include a folder called Tcpip below the top level of your PC MILER installation Step 3 3 For Versions 16 1 and 17 0 extract the correct support files For16App exe and for17App exe If you installed your PC MILER to non default locations you will have to redirect the extractions in the w
70. uraged T and 53 Foot Trailer 5 will be generated using the Practical network Changing this default to the Shortest network is not possible 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 30 PC MILER AS 400 MVS User s Guide NOTE For Version 16 the HS Turn by Turn Driving Instructions return packet was changed from previous versions The fields for Route and Interchange were lengthened and the number of sets of route information was reduced from 4 sets per packet to 3 See section 7 2 4 1 for full details gt IMPORTANT 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 17 the comma between the city and state or province is optional Version Specific Routing and City Format Information Version Route Types Available City Entry Jurisdiction Info PC MILER 14 x Quebec PQ Newfoundland NF P ractical S hortest T oll Discouraged Comma required between city and N ational Network jurisdiction code PC MILER 15 x Quebec PQ Newfoundland NF P ractical S hortest T oll Discouraged Comma required between city and N ational Network jurisdiction code PC MIL
71. use PC MILER AS 400 employs a Client server solution the following hardware and software is required The AS 400 server uses SNA APPC data queues to communicate For PC MILER AS 400 e A PC with a Pentium processor 300 MHz clock speed or higher and 128 MB of RAM The hard disk should have 200 MB of space available running Windows NT 2000 or XP Pro For best performance use a Pentium PC 400 MHz or higher or use two PCs For PC MILER Streets AS 400 e A PC with a Pentium processor 300 MHz clock speed or higher and 128 MB of RAM The hard disk should have 2 gigabytes of space available running Windows NT 2000 or XP Pro High performance disk drives are recommended For best performance use a Pentium PC 500 MHz or higher or use two PCs PC to AS 400 Connectivity Options Not Provided by ALK e Netsoft s NS Router 3 0 or higher NS Router 3 0 comes bundled in Client Access V3R2 e Client Access Express V4R4MO Recommended gt NOTE Netmanage is now only supporting their NS Router on a limited basis you are strongly encouraged to use Client Access Express as your PC to AS 400 connectivity tool 2 1 PC MILER Graphics PC MILER map graphics are not supported in PC MILER AS 400 Multiple Version Switch PC MILERAS 400 MVS User s Guide 3 0 Installation PC MILER for the AS 400 works by connecting a 32 bit Windows PC to your AS 400 The PC provides mileage lookups to the AS 400 via data queues Generally there is one
72. xed 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 NorthAmerica O Oceania S South America Pos 8 C Custom blank default Pos 9 Y Override Restrictions or L Light N Obey Restrictions or H Heavy Pos 10 G General Restriction E Explosive Restriction I Inhalant Restriction R Radioactive Restriction Sequence for multiple responses Error Code Requested PCMILER Version 140 PC MILER Version 14 141 PC MILER Version 14 1 150 PC MILER Version 15 0 151 PCMILER Version 15 1 et cetera Blank Fill 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 PC MILER AS 400 MVS User s Guide 41 2 Response The following are field parameters for the state miles output The PC will respond with the miles or kilometers for the stops indicated in the SM request There will be 10 state miles returned for each record If additional records are needed an M in the MORE parameters field is used to indicate that there is more data to foll

ALK Technologies AS/400 Switch User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents