PC*MILER® |AS/400 MULTIPLE VERSION SWITCH USER’S GUIDE 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.
Table of Contents PC*MILER|AS/400 Version 17 Notes – Please Read ........................................ 1 1.0 Introduction .................................................................................................. 3 2.0 Hardware and Software Requirements ...................................................... 4 2.1 PC*MILER Graphics ......................................................................... 4 3.0 Installation............................................................................
Appendix D: Configuring Client Access Express To Work With PC*MILER AS/400....................................................................... 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 ............................................................
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).
2 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’.
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.
4 PC*MILER|AS/400 MVS User’s Guide 2.0 Hardware and Software Requirements Because 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: • 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.
PC*MILER|AS/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 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.
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*MILERAS/400: • 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). • The second CD contains the 400 side ALKMVS Library. ⇒ NOTE: Required PC to AS/400 Connectivity Software is not provided by ALK.
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.
8 PC*MILER|AS/400 MVS User’s Guide 5. To grant object authority to library ALKMVS, enter the following: GRTOBJAUT (press ) 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 your ICC Work library and change the ICC Support Short Code names flag from ‘N’ to ‘Y’.
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.
10 PC*MILER|AS/400 MVS User’s Guide PC*MILER|TCP/IP Connect 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.
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.
12 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.
PC*MILER|AS/400 MVS User’s Guide Step 2.1 For Version 14: • • • • Run \v14\setup.exe If you are installing just PC*MILER 14.0 you will not need a product key code. If you are intalling an approved PC*MILER|AS/400 Multiple Version Switch data add-on, you will need a product key code. 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.
14 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: • • • • Run \v17\setup.exe If you are installing just PC*MILER 17.0 you will not need a product key code. If you are intalling an approved PC*MILER|AS/400 Multiple Version Switch data add-on, you will need a product key code from ALK.
PC*MILER|AS/400 MVS User’s Guide Step 3.2 Unzip the correct version of the TCP/IP file for your version. The selfextracting 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.
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.
PC*MILER|AS/400 MVS User’s Guide Note: In StartMvs.bat you will find the commands to start AS400.exe commented out. To have PC*MILER|AS/400 Multiple Version Switch started automatically, simply uncomment the CD and the Start lines. Once you have StartMvs.bat configured properly, you can create 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.
18 PC*MILER|AS/400 MVS User’s Guide pcmxtra.dll pcmserve.ini 16.x pcmsrv32.dll pcmtcp.dll pcmserve.ini 17.x pcmsrv32.dll pcmtcp.dll pcmserve.
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*MILER|AS/400 Multiple Version Switch installation, 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.
20 PC*MILER|AS/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 available 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.
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 underneath 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.
22 PC*MILER|AS/400 MVS User’s Guide 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: ⇒ 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 with the connection to the mileage server PC.
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 PrincetonNJ. Request Type: “MI”, the default entry, will cause PC*MILER (or PC*MILER|Streets) to generate only point-to-point mileage look-ups.
24 PC*MILER|AS/400 MVS User’s Guide • 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.
PC*MILER|AS/400 MVS User’s Guide • 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 > Help.
26 PC*MILER|AS/400 MVS User’s Guide 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 the trip. F24 Save a trip. Enter a trip identifier of up to 10 characters in the entry field that appears.
PC*MILER|AS/400 MVS User’s Guide PC. (Refer to the main PC*MILER User’s Guide for instructions on how to alter these values.) will exit the program. will print the screen. will return you to the previous screen and will clear it. will return you to the previous screen, without clearing 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 MVS User’s Guide 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.
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. ⇒ 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.
PC*MILER|AS/400 MVS User’s Guide E = Toll Discouraged/National Network/Practical F = Toll Discouraged/53 Foot Trailer/Practical G = Toll Discouraged/Shortest H = National Network/Shortest I = 53 Foot Trailer/Shortest J = Toll Discouraged/National Network/Shortest K = Toll Discouraged/53 Foot Trailer/Shortest Restriction Overrides by Version PC*MILER 14.x Feature not available PC*MILER 15.x Feature not available PC*MILER 16.x Available with Street Level Add-on Only PC*MILER 17.
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 software 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.
PC*MILER|AS/400 MVS User’s Guide 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 NewÆ Æ MV = Versions of PC*MILER Highway Data available. VA = Validation that a stop (City, ZIP code, etc.
34 PC*MILER|AS/400 MVS User’s Guide • 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 inaccurate. • 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.
35 PC*MILER|AS/400 MVS User’s Guide RESP-MVS RESP-FILL RESP-VERSIONS 3 7 228 Pos 29-31) PC*MILER Version Pos 32-38) Not Used Array of space delimited, left justified, 3 character Versions.IE:140150161 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.
36 PC*MILER|AS/400 MVS User’s Guide Validation Response: Var Name Len Value Description RESP-TYPE RESP-REF Filler-3 RESP-MORE Filler-3 Match 2 10 3 1 3 1 PL Stop pick list Output Queue Name 3 blanks Pos 16) M = more data to follow L Y N Filler-2 RESP-Seq RESP-ERR 2 4 2 E2 NewÆ Æ RESP-MVS 3 RESP-CIT 980 Filler 15 Extended Format 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*MILE
37 PC*MILER|AS/400 MVS User’s Guide 1 1 Pos 2) Pos 3) 1 1 1 Pos 4) Pos 5) Pos 6) REQ-REGION (Worldwide Only) 1 Pos 7) REQ-CUSTOM REQ-Ovrd Restrictions 1 1 Pos 8) Pos 9) REQ-MORE REQ-FMT REQ-Hazmat (Data Add-on) 1 REQ-SEQ REQ-ERR New Æ REQ-MVS 4 2 3 (Position 29-31) New Æ REQ-FILL 7 REQ-CIT 700 Pos 10) H=National Network/Shortest I=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
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).
39 PC*MILER|AS/400 MVS User’s Guide E4 E5 E6 E9 NewÆ Æ RESP-MVS NewÆ Æ RESP-Fill 3 7 Second city not found Unable to resequence Unable to calculate route Disconnected Highway Network PC*MILER Version (Pos 29-31) PC*MILER Version (Pos 32-38) RESP-CIT1 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 addr
40 PC*MILER|AS/400 MVS User’s Guide 1 1 REQ-MORE REQ-FMT 1 1 1 REQ-REGION (Worldwide Only) 1 REQ-Custom Routing REQ-Ovrd Restrictions 1 1 REQ-Hazmat 1 REQ-SEQ REQ-ERR New Æ REQ-MVS 4 2 3 (Position 29-31) New Æ REQ-FILL REQ-CIT 7 700 J=Toll Discouraged/National Network/Shortest K=Toll Discouraged/53 Foot Trailer/ Shortest Pos 2) M or K for miles or kilometers Pos 3) R = resequence stops H = hub leg miles F = resequence stops fixed destination blank = otherwise Pos 4) M = more data to follow Po
41 PC*MILER|AS/400 MVS User’s Guide 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 follow.
42 PC*MILER|AS/400 MVS User’s Guide RESP-SEQNUM RESP-ERROR 4 2 E1 E2 E3 E4 E5 E6 E9 NewÆ Æ RESP-MVS NewÆ Æ RESP-Fill 3 7 STATEMIL 220 FILLER 118 I = Inhalant Restriction R = Radioactive Restriction 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 Unable to calculate route Disconnected Highway Network PC*MILER Version (Pos 29-31) PC*MILER Version (Pos 32-38) 10 elements each element will consist
PC*MILER|AS/400 MVS User’s Guide 1 1 REQ-MORE REQ-FMT 1 1 1 REQ-REGION 1 REQ-Custom Routing REQ-Ovrd Restrictions 1 1 REQ-Hazmat 1 REQ-SEQ REQ-ERR REQ-CIT 4 2 700 43 K=Toll Discouraged/53 Foot Trailer/ Shortest Pos 2) M or K for miles or kilometers Pos 3) R = resequence 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=
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 response record has all of the required detailed route information. There are four route list records\response 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.
45 PC*MILER|AS/400 MVS User’s Guide REQ-SEQNUM REQ-ERROR 4 2 E1 E2 E3 E4 E5 E9 NewÆ Æ RESP-MVS NewÆ Æ RESP-Fill RouteInfo 3 7 300 ROUTEINFO 3 sets FILLER 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 1 toll indicator 6 directional (North,
46 PC*MILER|AS/400 MVS User’s Guide Format in previous versions: ROUTEINFO 4 sets 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
47 PC*MILER|AS/400 MVS User’s Guide 7.2.5 Sample Request and Response Records Sample records are shown below.
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.
PC*MILER|AS/400 MVS User’s Guide 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.log, located in the directory that the software is running from (srv32.exe).
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*MILER|AS/400 MVS User’s Guide 9.0 Common Questions and Installation Problems Question: PC*MILER works correctly when using the PCMILER command on the AS/400, but my Innovative software does not work. Answer: 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.
52 PC*MILER|AS/400 MVS User’s Guide Question: PC*MILER works correctly but my Innovative Print Missing Tariff miles is not returning miles for a few cities. Answer: 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 . PC*MILER will indicate that it is not found.
PC*MILER|AS/400 MVS User’s Guide 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/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.
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. Check by selecting HELP > About in the NS/Administrator or the midrange workspace.
PC*MILER|AS/400 MVS User’s Guide Then do the following: 1. In the Links Tab, highlight AnyNet, and then choose Properties. 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.
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).
PC*MILER|AS/400 MVS User’s Guide 4. In the local LU tab use the second option, Use a local specific value. These are the only changes you need to make. Leave the other settings on the defaults.
60 PC*MILER|AS/400 MVS User’s Guide Appendix 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. 2.
PC*MILER|AS/400 MVS User’s Guide Appendix D: Configuring Client Access Express To Work With PC*MILER AS/400 1. Install Client Access Express on your mileage server PC by running the setup.exe that is in the Express folder on your Client Access Express CD. 2. Go to the AS/400 Operations Navigator. For new installations, the Navigator will prompt to ask if you want to add a connection.
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. The Connection Properties Window is used for changing existing connections or changing the Restart Settings for new connections. ⇒ NOTE: Client Access Express has the ability to change passwords in the user profile.
PC*MILER|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. The default user ID is the User Profile that the mileage server PC will be signing on to.
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. For auto-restart, you will also have to make the above settings in the Connection Properties dialog.
PC*MILER|AS/400 MVS User’s Guide 4. Verify the connection. If a connection cannot be made, contact IBM for assistance.
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 CL program called “queue”.
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.
68 PC*MILER|AS/400 MVS User’s Guide Appendix F: PC*MILER|AS/400 Multiple Version Switch INI Settings PC*MILER|AS/400 Multiple Version Switch uses multiple INI files. AS400.exe uses Srv32.INI and Pcmmv.INI. Each instance of PC*MILER|TCP/IP Connect uses its own Pcmserve.INI Srv32.INI is used for startup information. Pcmmv.INI is used to store the locations of your various instances of PC*MILER|TCP/IP Connect. Srv32.INI and Pcmmv.INI have to be kept in synch at all times.
PC*MILER|AS/400 MVS User’s Guide 69 ;Password pass=express library=ALKMVS
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 (Defaults) Description CalcType Practical Set In Srv32.InI Units Miles Kilometers What unit of measure should distance be shown in. ChangeDest TRUE FALSE When optimizing the route, should the trip’s destination be optimized also.
71 PC*MILER|AS/400 MVS User’s Guide CustomRoute TRUE FALSE Should PC*MILER|Connect use Custom routing. HazRoute (for PC*MILER| Hazmat addon only) None General Explosive Inhalant Radioactive The default hazardous routing type: disabled, general material, explosive material, inhalant material, or radioactive material. Pcmmv.INI [PCMiler 140] address=127.0.0.1 ÅIp Addpress of Computer Name port=8014 Å Port Number that specified when PC*MILER|Tcpip Connect was started. [PCMiler 150] address=127.0.0.
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>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 for diagnostic purposes, as the log files get quite large.
73 PC*MILER|AS/400 MVS User’s Guide PCMS_CLOSINGERROR 126 PCMS_NORTENGINE 127 PCMS_NODATASERVER 128 Server did not shut down properly Server could not properly initialize internal routing component Server could not properly initialize internal routing component PC*MILER|Streets Error Codes: Error Codes Value Message PCMS_INVALIDPTR PCMS_NOINIFILE PCMS_LOADINIFILE PCMS_LOADGEOCODE PCMS_LOADNETWORK PCMS_MAXTRIPS PCMS_INVALIDTRIP PCMS_INVALIDSERVER PCMS_BADROOTDIR PCMS_BADMETANETDIR PCMS_NOLICENSE
