Dispatcher Options

Introduction

The Options Window provides for tailoring Dispatcher options according to user needs and preferences. The Options Menu provides access to Dispatcher options and provides for saving Dispatcher options on disk for later use. Both are described below in detail. Available Dispatcher options are described fully in the following section.

Using the Options Window

Selecting Options Window... in the Options menu of the Dispatcher window brings up the window shown below.

This window shows options currently selected for Dispatcher. To change Dispatcher options, change to the desired option configuration, and click the Apply button. All options are set to the selections in the Options window, and the Options window disappears. To dismiss this window without changing any options, click the Cancel button. Each option is explained below:

Check Use connectivity from Layout Editor panel: and select a Layout Editor panel (if there's more than one panel), if you have a Layout Editor panel that fully describes your layout, including blocks and turnouts, and would like Dispatcher to make use of this connectivity. Uncheck this item if no Layout Editor panel with full connectivity is available. If this item is checked, Dispatcher will automatically check if turnouts are set correctly when allocating a Section, and will inform the dispatcher if the turnouts are not set correctly. This item must be checked if Dispatcher is to set turnouts when a Section is allocated (see below).
Select one of the three options for Dispatcher to select trains from when creating Active Trains. The three possibilities are:

Trains from Roster - Dispatcher will list all trains in the JMRI Roster that are not currently in Active Trains.
Trains from Trains - Dispatcher will list all trains available from Operations that are not in Active Trains.
Trains from User Entry - Dispatcher will replace the train selection box in the Activate New Train window with two entry fields allowing the user to enter a train name and a dcc Address.

Check Layout has block detection hardware if block occupancy detection is available from the layout. Uncheck if the layout does not have block occupancy detection, or if Dispatcher should not make use of block occupancy detection.
Check Automatically allocate Sections to Active Trains to activate automated dispatching. Uncheck to deactivate automated dispatching features. This item is equivalent to the Auto Allocate item in Dispatcher's Options menu. Currently automatic functions are limited, but more will be added in the future.
Check Automatically set turnouts when a Section is allocated to activate automatic setting of turnouts. Uncheck to deactivate automatic setting of turnouts. This item is equivalent to Auto Set Turnouts in Dispatcher's Options menu. This item requires that "Use connectivity from Layout Editor panel" be checked (see above). Turnouts will not be set unless the Section to be allocated is free and unoccupied, except for the first Section of an Active Train that starts in the Transit. If turnouts cannot be set, the dispatcher will be warned. When setting turnouts, Dispatcher only issues commands to set turnouts; it does not wait for turnouts to actually change.
Check Use short Active Train names to use the train name as the Active Train name in tables and selection boxes where Active Trains are referenced. Uncheck to use the full Active Train name in those locations.
Check Place train name in starting Block to request that Dispatcher set the "value" of the starting Block to the train name when creating a new Active Train. Uncheck to suppress setting the starting Block value to the train name. This feature is designed to facilitate Train Tracking in Layout Editor panels.
Select layout scale in the Layout Scale selection box. The selected scale is used in conjunction with Block length in automatic running of trains.

Note: Automated dispatching is not fully implemented in this version of Dispatcher. Some limited function is available, but more will be available in later versions of Dispatcher.

Using the Options Menu

The Options menu is used to access, edit, and save Dispatcher options. Items in this menu and their use are explained below:

Auto Allocate - This check box is used to turn automated dispatching functions on (checked) or off (unchecked). This item is equivalent to an item in the Options Window. Automated dispatching may be turned on or off at any time. The item is repeated here for convenience of the dispatcher.
Auto Set Turnouts - This check box is used to turn on (checked) or off (unchecked) automatic setting of turnouts when Sections are allocated. This item is equivalent to an item in the Options Window. Automatic setting of turnouts may be turned on or off at any time. The item is repeated here for convenience of the dispatcher.
Options Window... - Selecting this item brings up the Options Window described above.
Save Options... - Selecting this item saves Dispatcher options currently in effect into a small XML file (dispatcheroptions.xml) in the user's preferences directory. This is the same location where JMRI preference files are saved. When Dispatcher is started, if a file named "dispatcheroptions.xml" is found in the user's preference directory, that file is read, and Dispatcher options are set accordingly. If the file is not present when Dispatcher is started, default options are used. Note: Dispatcher options are not saved automatically. Saving Dispatcher options is optional. Selecting this menu item is the only way to save Dispatcher options.