User Tools

Site Tools


support:dispatch:motor_clubs

This is an old revision of the document!


Motor Clubs

Create the account

This will display the list of all configured auto club accounts for the company, as shown below.

Click the Add auto club button to create the new entry

This will result in a new entry in the list with Id=-1, as shown below.

Select the desired auto club

Click on the cell under the Auto club column, and a drop down list will appear. Click on the arrow to see the list, as shown below. Select the desired auto club.

Enter the contractor or vendor ID

  • Tab to the contractor/vendor ID cell, or click on it, to invoke edit mode. Enter the contractor ID as shown below. Tab to the next cell to leave the cell, which will invoke the save process.
  • After you enter the contractor ID and leave the cell, the system will save this minimum information and possibly sort the new account into the list of other entries.
  • Notice that after the new account is saved, the ID will no longer be -1.

Enter username

  • Select the username cell on the desired account row, which should invoke edit mode.
  • Enter the username, and tab to the password field.
  • Note: this step is not necessary for Cross Country setup.

Enter the password

  • Enter the password, and click on any other cell to save the password.
  • Note: this step is not necessary for Cross Country setup.

Cross Country-specific configuration

Enter tax ID

  • On the auto club list screen, the configuration for CCAS must also include the tax ID (no dashes) used to obtain the vendor ID from CCAS, as shown below.
  • Notice that username and password are not required for CCAS.

Obtain client ID and register location(s)

  • Select the Cross Country locations menu option.
  • If the configured vendor ID and tax ID match CCAS records, you should see a list of one or more CCAS locations with which the tow company has been associated in the right pane, as shown below.

  • Click on the desired location in the right pane. This will load the details of the location in the center pane, as shown below.
  • If the location has not yet been registered, the Select and register location button should be enabled, as shown below.

  • Enter a user name and password specific to the location. If the tow company is associated with more than one CCAS location, the user name and password combinations must be unique between all of them.

Register locations

Manage the connection

  • For Tracker customers, Ranger automatically attempts to log on to auto club accounts whenever RangerService is started. However, there are situations in which the company must manage auto club connections outside the RangerService startup process. For example, DriveAmerica will forcibly log off a service provider that fails to respond to a dispatch in a timely manner.
  • For RangerDispatch customers, when the dispatch screen is used to logon the dispatcher, the auto club logon process will happen automatically.

List all connections and their statuses

  • Shown below is an example of a company with multiple configured accounts, with only one logged in.
  • A logged-in connection will have a session ID, and in the case of Cross Country, will also have a session token. It will also provide a Logout button for manual logout.
  • Likewise, a logged-out connection will provide a Login button for manual login.

Logout a connection

  • Click the Logout button on the desired account row, and the system will communicate with the auto club and logout the connection.
  • The service provider will no longer receive dispatches from the auto club until login is performed.
  • The screen should be updated to reflect the new status. The logged-out connection will now have a Login button, and the session ID will be blank, as shown below.

Login a connection

  • Click the Login button on the desired account row, and the system will communicate with the auto club and login the connection.
  • The service provider will be expected to respond in a timely manner to dispatches from the auto club until logout is performed.
  • The screen should be updated to reflect the new status. The logged-in connection will now have a Logout button, and the session ID will be updated, as shown below.
  • Note: If DriveAmerica has forcibly logged the service provider off, the service provider may be required to contact DriveAmerica via phone before account logon will be allowed

Login fails

  • If, after clicking the Login button, an Error dialog box is displayed as shown below, login has failed.
  • If the error is “Root element is missing” and the auto club is USAC, it is likely that DriveAmerica does not have the configured contractor ID in their system. The service provider will likely need to contact DriveAmerica to resolve the issue.

support/dispatch/motor_clubs.1217424181.txt.gz · Last modified: 2008/07/30 09:23 by edmondsj