Enabling hazardous mileage lookups

You can set up your system to generate hazmat-compliant routes and mileages based on ALK’s hazardous routing options for:

  • General hazardous material

  • Explosives

  • Inhalants

  • Radioactive material

  • Flammable

  • Corrosive

  1. The Flammable and Corrosive options require TMWSuite V. 2014.13_07.0242 or later and the manual creation of the Flammable and Corrosive option in the ALKHazLevel label.

  2. For details, see "Creating label options for Flammable and Corrosive" in the Mileage database maintenance in the TMWSuite System Administration online help.

Using hazardous mileage lookups requires you to have ALK’s HazMat add-on module and either PC*MILER V.18 (or greater) or PC*MILER|Streets V.18 (or greater).

Additional system setup is required before using the HazMat Mileage feature. Some setup options pertain to the HazMat Mileage feature in general, while others pertain to using the HazMat Mileage feature in Fuel Dispatch.

You use these settings to set up the HazMat Mileage feature for Fuel Dispatch.

Setting

Used to

Set a value of Y in the String1 field of the HazMatMileageLookups General Info Table setting (required)

Activate the HazMat Mileage feature

Set [MileageInterface]HazMatLookupMode=FgtClass in your TTS50 (required)

Link commodities to the Commodity Class 1 category specified in the Fgt Class field on the commodity profile

Note: For details, see "Linking commodities to ALK’s Hazardous Routing Options" in the Mileage database maintenance in the TMWSuite System Administration online help.

Set a value of 2004 in the String1 field of the DistanceLookupVersion General Info Table setting (recommended)

Enable TMWSuite’s enhanced mileage features

Note: Enabling the enhanced mileage features should result in more accurate mileages for fuel delivery trips.

Set a value of Y in the String1 field of the DistanceCacheOneWay General Info Table setting (recommended)

Store separate mileage values for each direction of a route

Set [MileageInterface]HazardousMiles=Y in your TTS50 (optional)

Manually calculate HazMat mileage in TMWSuite’s Mileage Inquiry window or Route Mileage Inquiry window

Note: For more information, see Looking up HazMat mileage manually.

Set [FuelDispatch]CommoditySubclass=1 in your TTS50 (optional)

Note: Before you change this setting, discuss it with your TMWSuite Support Team.

Use Commodity Class 1 for Fuel Dispatch relationships instead of Commodity Class 2

Note: For more information, see Using Commodity Class1 options for relationships.

General HazMat mileage setup

Because the HazMat feature was first introduced in the TMWSuite base system, the general setup procedures are documented in the TMWSuite documentation set.

For details about the general setup options, see "Hazardous mileage routing" in the Mileage database maintenance in the TMWSuite System Administration online help.

Additional setup for Fuel Dispatch

In addition to the general setup options, Fuel Dispatch requires you to perform additional setup:

Discuss with your Trimble Support Team before changing this setting.

Using Commodity Class1 options for relationships

Fuel Dispatch requires you to set up relationships between companies, commodities, and commodity classes before you can record a commodity on an order. This limits the list of commodities that can be picked up or delivered at a company. You set up commodity-to-consignee relationships in the Company Relations Profile window.

By default, Fuel Dispatch uses the Commodity Class2 options to set up commodity relationships.

However, Commodity Class1 options are required to use:

  • The HazMat Mileage feature

  • The TMWSuite rating engine to calculate billing or pay based freight classifications

You can assign both Commodity Class1 and Commodity Class2 options to a commodity, and then use:

  • The Commodity Class2 options for Fuel Dispatch requirements

  • The Commodity Class1 options for the HazMat feature and for rating

If you prefer assigning only one commodity class to a commodity, you can set [FuelDispatch]CommoditySubclass=1 in your TTS50. This setting causes the system to use Commodity Class1 instead of Commodity Class2 for the relationships you create in Fuel Dispatch.

  1. Before changing the setting, discuss it with your TMWSuite Support Team.

  2. For more information, see Maintaining commodity classes.

Storing separate mileage values for each direction of a route

By default, mileage for each route in TMWSuite is considered bi-directional. For example, suppose mileage had been stored for a route with an origin at CMP1 and destination at CMP2. When a new route is created with an origin at CMP2 and destination of CMP1, the system would use the mileage calculation used for the previous route.

However, inbound and outbound mileages for fuel delivery routes can vary considerably. The DistanceCacheOneWay General Info Table setting allows you to set up the system to store separate mileage values for each direction of the same route.

Using the HazMat Mileage feature

When you have the HazMat Mileage feature set up, the freight’s HazMat category determines the mileage. The system calculates the hazardous mileages automatically.

After setting up the feature, you can verify it is pulling the correct HazMat mileages by creating a trip with HazMat freight and noting the mileages pulled. Then run a mileage lookup for the same route within your ALK mileage application. The mileage returned in Fuel Dispatch should match the mileage returned in ALK. If the mileages do not match, contact your Trimble Support team.

Looking up HazMat mileage manually

In Fuel Dispatch, you cannot look up HazMat mileage in the Mileage Inquiry or the Route Mileage Inquiry window.

image1

image2

However, you can lookup HazMat mileage in these windows in TMWSuite if you have both:

image3

image4

You can also manually lookup HazMat mileages directly in your ALK mileage application.

  1. For more information on using Fuel Dispatch’s Mileage Inquiry or Route Mileage Inquiry windows, see Determining point-to-point mileage.

  2. For more information on using TMWSuite’s Mileage Inquiry or Route Mileage Inquiry windows, see "Looking up Hazmat mileage manually" in the Mileage database maintenance in the TMWSuite System Administration online help.