The functions below affect the trip’s routing calculation.


HRESULT PCRSSetRouteFormula (Trip trip, char  *newParam)


PCRSSetRouteFormula() allows users to choose between PRACTICAL (P), SHORTEST (S) path, INTERMODAL (I), COAL/BULK (C), AUTO RACKS (A), and FUEL SURCHARGE (F) style routing. Default = P.



HRESULT PCRSSetRouteMethod (Trip trip, char *newParam)


PCRSSetRouteMethod() allows users to choose FAMILIZED (F) versus NON-FAMILIZED (N) routing (i.e. determines if moves over railroad family members should occur as if they were a movement over the specified railroad). Default = F.



HRESULT PCRSSetRouteType (Trip trip, char *newParam)


PCRSSetRouteType() allows users to choose between INTERACTIVE (I) and AUTOROUTE (A) type routing. In an Interactive route, consecutive stops must be reachable on the same railroad (or family member) or be a junction between two railroads at a given location. AutoRouting will let the PC*MILER|Rail routing engine determine junctions between stops if necessary. This is similar to Single Route and AutoRoute entry modes in the main PC*MILER|Rail application. Default = I.



HRESULT PCRSSetUnitsMiles (Trip trip)


PCRSSetUnitMiles() tells the DLL to return MILES as the distance unit for all routing calculations. Default = MILES



HRESULT PCRSSetUnitsKilometers (Trip trip)


PCRSSetUnitKilometers() tells the DLL to return KILOMETERS as the distance unit for all routing calculations. Default = MILES (PCRSSetUnitMiles).



HRESULT PCRSSetIncNonStationRR (Trip tripID, char *newParam)


PCRSSetIncNonStationRR() allows AutoRouter users to choose between EXCLUDING (E) and INCLUDING (I) railroads that do not have active freight stations at a location. Default = I.



HRESULT PCRSSetIntermodalOnlyIncEx (Trip tripID, char *newParam)


PCRSSetIntermodalOnlyIncEx() provides the option to EXCLUDE (E) or INCLUDE (I) intermodal-only stations on a Practical route. Default = I. This option can only be used when the routing formula for a route is Practical, Coal/Bulk, or Auto Racks; the Exclude option cannot be used with other route formulas.



HRESULT PCRSSetIncAMTK (Trip tripID, char *newParam)


PCRSSetIncAMTK() allows AutoRouter users to choose between EXCLUDING (E) and INCLUDING (I) Amtrak from their list of AutoRoutes. Default = E.