User manual ALK PCMILER RAIL 17 CONNECT

[. . . ] Routing, Mileage, and Mapping Software VERSION 17 PC*MILER|Rail - Connect Users Guide ALL RIGHTS RESERVED You may print one (1) copy of this document for your personal use. Otherwise, no part of this document may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language, in any form or by any means electronic, mechanical, magnetic, optical, or otherwise, without prior written permission from ALK Technologies, Inc. IBM is a registered trademark of International Business Machines Corporation. PC*MILER is a registered trademark and BatchPro and RouteMap are trademarks of ALK Technologies, Inc. [. . . ] PCRSGetStop() places the number of characters copied into the buffer into the given pointer `numChars'. PCRSGetNumStops() is used to get the total number of stops currently in the trip's stop list, including origin and destination. Refer to the sample functions shipped with the DLL for more coding examples on DLL usage. 3. 6 Looking Up Place Names and Railroads (Geocoding) Several functions are included in PC*MILER|Rail-Connect which support looking up places and railroads. They are listed and described below. Chapter 3: Using PC*MILER|Rail-Connect From `C' 21 HRESULT PCRSGeoLookup(Trip trip, char *geoName, char *geoChar, char *rrIn, int *numMatches); HRESULT PCRSGetNumGeoMatches(Trip trip, int *numMatches); HRESULT PCRSGetGeoMatch(Trip trip, int which, char *buffer, int bufSize, int *pNumChars); HRESULT PCRSRRLookup(Trip trip, char *geoName, char *geoChar, int *numMatches); HRESULT PCRSGetRRMatch(Trip trip, int which, char *buffer, int bufSize, int *pNumChars); HRESULT PCRSJunctionLookup(Trip tripID, char *rrin, char *rrOut, int *numMatches); HRESULT PCRSGetJunctionMatch(Trip tripID, int which, char *buffer, int bufSize, int pNumChars); HRESULT PCRSRRName2Num (char *rr, short *pRRNum); HRESULT PCRSRRNum2Name (short rrNum, char *rrBuf); HRESULT PCRSConvertGeoCode(char *geoName, char *geoCharFrom, char *geoCharTo, char *rr, char *buffer, int bufsize, int *pNumChars); The first function, PCRSGeoLookup(), finds a list of matching places and returns how many match your input. You can then check each item in the list yourself for a matching name, or pop up the list in your own list box. Input names can contain the meta-character `*' to force the server to do partial matches. For example, `HOU* TX' will return a list of all places that match the partial string `HOU' in the state of New Jersey. The railroad (rrIn) is an optional field to allow users to further narrow the search to stations on that specific rail carrier. Input names can be any of the aforementioned geocode types (station name/state, SPLC, FSAC, ERPC, Rule260). The argument geoChar denotes which of these types is being given (S=SPLC, E=ERPC, C=City/State (station name), F=FSAC, R=Rule260). The number of matches found is returned in the given pointer `pNumChars'. Note that these input places can be `mapped' to other places in the PC*MILER|Rail-Connect User's Guide 22 PC*MILER|Rail network via overrides, should this be necessary based on the input data (see section 3. 8, Managing Overrides, below). Once you've seeded the trip with matching cities, use PCRSGetGeoMatch() to retrieve each matching place. Pass the index of the desired match and a buffer to store the information in. The name stored in the buffer (first 22 chars) is the place name as PC*MILER|Rail knows it and should be the name passed to PCRSAddStop(). PC*MILER|Rail names are the 22-character station/state names previously discussed, including the NULL terminator. Note that the buffer should be long enough to contain the entire name. Additional information will be included in the buffer (such as SPLC and FSAC) where possible. The following is a code sample for Geocode lookups: #define BUFLEN 25 char buffer[BUFLEN]; int matches, numChars; HRESULT srvRet; /* Lookup all cities that match */ srvRet = PCRSGeoLookup(myTrip, "HOU* TX", "C", NULL, &matches); printf ("%d matching cities to 'HOU* TX'\n", matches); /* Show all the matching cities. Note: You could use variable*/ for (i = 0; i < matches; i++) { PCRSGetGeoMatch(trip, i, buffer, BUFLEN, &numChars); printf ("[%s]\n", buffer); } The Lookup functions work like the Geocoding functions described above. PCRSRRLookup()and PCRSJunctionLookup() return lists of matching railroads and junctions respectively, and return how many match your input. The number of matches found is returned in the given pointer numMatches. [. . . ] It can also occur if the Add-In was not able to correctly load the PC*MILER|Rail database. Turn on debugging (set the debug level to 12) to diagnose the Add-In startup, then shut down Excel and restart it. Running your application in Windows 7, XP or Server 2008 generates the error `pcrwin32. exe has stopped working' Follow these steps: Appendix A: `C' Function Declarations 71 1. Select Settings Control Panel System and Security System Advanced System Settings Advanced tab Performance Setting Data Execution Prevention tab 3. Select "Turn on DEP for essential Windows programs and services only. " PC*MILER|Rail-Connect User's Guide 72 C Appendix Appendix C: The PC*MILER|Rail TCP/IP Interface This software provides a way to interact with the PC*MILER|Rail Connectivity (DLL) Products running on Windows personal computers over a TCP/IP network from any other computer platform. [. . . ]