Changing Rail Routing Options

The functions below affect the trip’s routing calculation.

PCRSSetRouteFormula HRESULT PCRSSetRouteFormula (Trip trip, char *newParam)

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.

PCRSSetRouteMethod HRESULT PCRSSetRouteMethod (Trip trip, char *newParam)

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.

PCRSSetRouteType HRESULT PCRSSetRouteType (Trip trip, char *newParam)

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.

PCRSSetUnitsMiles HRESULT PCRSSetUnitsMiles (Trip trip)

Tells the DLL to return MILES as the distance unit for all routing calculations. Default = MILES.

PCRSSetUnitsKilometers HRESULT PCRSSetUnitsKilometers (Trip trip)

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

PCRSSetIncNonStationRR HRESULT PCRSSetIncNonStationRR (Trip tripID, char *newParam)

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

PCRSSetIntermodalOnlyIncEx HRESULT PCRSSetIntermodalOnlyIncEx (Trip tripID, char *newParam)

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.

PCRSSetIncAMTK HRESULT PCRSSetIncAMTK (Trip tripID, char *newParam)

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