Enhanced Interlocking Tower Manager Rule

Revision as of 04:46, 17 December 2016

Enhanced Interlocking Tower Manager Rule is a session rule that is released with the Enhanced Interlocking Tower package, that enables under surveyor to edit your towers and paths from a centralized interface, and under run time that enables to display a run time monitor to display current available information on your towers, paths and trains using or waiting for any path.

The rule is available on DLS under the KUID <kuid2:61392:8130:11>. The rule works with both standard interlocking towers and enhanced interlocking towers.

Enhanced Interlocking Tower Manager Rule - How it can help using Interlocking Tower

The Enhanced Interlocking Tower Manager Rule is a session rule that enables under surveyor to define and edit from a centralized point all the existing towers and paths on your route. But under surveyor, the rule is redundant with the integrated edition facility included in Interlocking Tower. It is not under surveyor that this rule is helpful, but more under driver mode that the rule integrated interlocking tower run time monitor may be very helpful to understand what are the current paths states and what mat be the current session problems with interlocking towers either standard ones or enhanced version.

First a short reminder on how in driver mode to launch the enhanced interlocking tower rule run time monitor facility. To launch the monitor window, you only need to click on the user rule icon ( the little book icon in the toolbar at the top right of the main window) and choose tower manager in the displayed menu items. When selecting the towers manager item, you should have a new window opened by the enhanced interlocking manager rule and displaying the list of all the available towers on the route

The image below shows where you need to click and select towers manager in the menu.

And the following image below shows the initial page displayed by the run time monitor facility

This first screen will list all the interlocking towers available on your route and the type of the interlocking tower : either standard or enhanced. The window displayed has a tabs toolbar on the second line displayed with two tabs : towers and trains. The current tower tab (you can see it is the current tab as the tab has some pink background) displays the list of the available towers and the other tab named trains will list all the trains with drivers currently on your route.

From the tower list screen, you can select any tower and display more details about the tower by clicking the display details link. the display details screen will show the selected tower paths list and their current state. if a is active, it will also give which train is currently owning the path and if the train has already entered the path or not. This information is available for both standard and enhanced interlocking tower. For only enhanced interlocking tower, the monitor will also list trains waiting for path activation or path cancellation.

here just below an example of the display details screen for IT Garrenac South"

You can see on this example screen that there are now three pages available in the tabs toolbar : the towers page, the tower paths page (currently displayed as the tabs has a pink background) and the trains tab. Using these tables link it is very easy to switch from one page to another by clicking on the adequate tab.

The tower paths list page has a header to remind you the tower options used for the selected tower, and will list all the available paths in the tower with the path name, the entry signal, the exit signal and the current path status. The page will be refreshed every two seconds and you can follow on this page all the paths states evolution in the tower.

The paths states can be path not set, path not activable, path activating, path active, path cancelling, path in panic mode. When a path is not set, the monitor checks if the path is currently activable or not and will display path not set for path that can be activated and path is not activable for path that cannot be activated due to some ressources conflicts. Using the show details link, you can display another details screen this time at the path level that will list resources in conflicts that makes the path not activable. Just below the path status, the monitor will display for active path the train owing the active path and if the train has already entered the path or not. The message Train xxx owns activated path means that the train has not already entered the path, while the message Train xxx has entered active path means that the train has reached ad left the path entry signal and is currently on the path. This information is available for both standard and enhanced tower paths. For only enhanced towers, you will have also some information about the trains waiting for the path activation or waiting for the path cancellation. On the example screen above, we can see that Train T004 - Louise is waiting for path V1ToSouth activation and that the path is currently not activable. To obtain the reason why the path is not activable, you will need to click on the show details link on the displayed path status line. We can also see that Train T001 - Ami currently owns path V3ToSouth which is active.

To understand why path V1toSouth is not activable, we will click on the display details link. And the monitor will display all the current path details :

example of the display details screen for path V1toSouth in IT Garrenac South"

The path details screen display first the properties of the selected path with the enhanced options for a path belonging to an enhanced tower. But the important thing is that it displays the current path state : path is not activable. Why ? because some path objects are currently locked. It reminds that train T004 - Louise is waiting for this path activation. And the status is displayed with a yellow color because there is a train waiting for the path. And below, you will find the conflicting ressource, in our case a conflicting path V3toSouth which is currently active and owned by train T001 - AMI. This is only an example, but on this screen you will find why a path is not activable, because some objects are locked by a conflicting path, or because a TCB is occupied or locked, or because an exclusive set name is locked and not available, or because an extra consist has been detected on the path.You can

The main interest of this run time monitor is to be able to know all the path states, which trains are using or waiting for these paths, and if a path is not activable, why ? and which conflicting ressource is making this path not activable.

You can also see that when displaying the path details screen, the tabor has now four tabs : the rtower list page, the tower paths list page, the tower path details tab and the trains tab making easy to switch from one view to another one.

Let's now show the train tab view.

@@ Line 12: / Line 12: @@
 The rule is available on DLS under the KUID <kuid2:61392:8130:11>.  The rule works with both standard interlocking towers and [[Enhanced Interlocking Tower|enhanced interlocking towers]].
-====Enhanced Interlocking Tower Manager Rule - Home page : Available towers list page ====
+====Enhanced Interlocking Tower Manager Rule - How it can help using Interlocking Tower ====
-When launched under surveyor or under driver using the user rules icon in the main window tool bar at the top right, the first page that will be displayed is a list of all the available towers on your route
+The Enhanced Interlocking Tower Manager Rule is a session rule that enables under surveyor to define and edit from a centralized point all the existing towers and paths on your route. But under surveyor, the rule is redundant with the integrated edition facility included in Interlocking Tower. It is not under surveyor that this rule is helpful, but more under driver mode that the rule integrated interlocking tower run time monitor may be very helpful to understand what are the current paths states and what mat be the current session problems with interlocking towers either standard ones or enhanced version.
-[[File:enhanced-interlocking-tower-manager-page-1.png | none | 800px ]]
+First a short reminder on how in driver mode to launch the enhanced interlocking tower rule run time monitor facility. To launch the monitor window, you only need to click on the user rule icon ( the little book icon in the toolbar at the top right of the main window) and choose tower manager in the displayed menu items. When selecting the towers manager item, you should have a new window opened by the enhanced interlocking manager rule and displaying the list of all the available towers on the route
-''... by the way, the example above shows that you can use quite a lot (31) of interlocking towers on a a route ...''
-The towers list page lists all the interlocking tower available on your route and the type of interlocking tower : either standard or enhanced.
+''The image below shows where you need to click and select towers manager in the menu.''
-The view details link enables to display the tower details page that will list all the paths available for the tower selected.
+[[File:eit manager run time monitor - image 1.png | 800px]]
-The copy from link is a link to help users migrating paths between towers. When you click on the link, you will have to select a source tower and all the paths definition from this source tower will be copied to the current selected towers. By using this link and afterwards deleting in the towers the paths you no longer need, you can migrate paths from one tower to another one without the need to re enter all the path data definition.
-====Enhanced Interlocking Tower Manager Rule - Tower paths list page ====
-When you select a view details link for a selected tower, the following page will be displayed which display all the tower paths list.
+''And the following image below shows the initial page displayed by the run time monitor facility''
+[[File:eit manager run time monitor - image 2.png | 800px]]
-''Enhanced Interlocking Tower Manager - Tower path list page in surveyor mode''
+This first screen will list all the interlocking towers available on your route and the type of the interlocking tower : either standard or enhanced.
-[[File:Enhanced-interlocking-tower-manager-page-2.png | none | 800px ]]
+The window displayed has a tabs toolbar on the second line displayed with two tabs : towers and trains. The current tower tab (you can see it is the current tab as the tab has some pink background) displays the list of the available towers and the other tab named trains will list all the trains with drivers currently on your route.
-At the top of the page, you have a tabulation bar that displays all the available page with the current page (in our case case tower paths) with a pink background. You can click on any of the tabs available to quickly change from a page view to another one.
+From the tower list screen, you can select any tower and display more details about the tower by clicking the display details link. the display details screen will show the selected tower paths list and their current state. if a is active, it will also give which train is currently owning the path and if the train has already entered the path or not. This information is available for both standard and enhanced interlocking tower. For only enhanced interlocking tower, the monitor will also list trains waiting for path activation or path cancellation.
-Following hou have a header than contains many informations :
-:*'''Current tower selected''' reminds you the name of the current tower being selected. By clicking on its name, you can select from a dropdown towers list another tower you want to display.
-:*'''tower type''' will display the type of tower either '''standard''' or '''enhanced'''.
-:*'''tower path assignment option''' will give the current path assignment option used for this tower, either '''no paths assignment''', '''external only''', '''external then ai''', '''ai only''' or '''ai then external'''. This option value defines how automatic path assignment is done when a train approaches a tower path entry signal : no paths assignment means there is no automatic path assignment for this tower ; external only means that only listeners rules will be called for automatic path assignment ; external then ai means listeners rules are called first then internal auto path assignment routine ; ai the external means first ai internal routine the external listeners if no assignment was done by the ai module. This option can be modified by clicking on its value.
-:*'''tower display yellow disc option''' is only displayed for enhanced tower : this enhanced option can either be '''display yellow disc enabled''' or '''display yellow disc disabled'''. Clicking on its current value will toggle the option value.
-:*'''tower path request on schedule blocked''' is only displayed for enhanced tower : this enhanced option enables to choose between the standard behavior for an AI train with schedule blocked, where the tower tries to cancel and requeue for activation all unused paths (paths owned but not entered by the owning train)  to help some other paths to be activated and solve the schedule blocked problem, or to avoid this processing that may have sometimes some side effects. Clicking on the current value will toggle the option value.
-:*'''tower arc compatible mode''' is also displayed only for enhanced tower : this option enables or disables that crossings compliant with trc system is managed by the trc system or by the interlocking tower. Clicking the option value will toggle the option value.
-:*'''tower debug log/print levels''' is an available option for both standard and enhanced towers : it can either be '''no debugging''', '''only log debugging information''' or '''log and print debugging information'''. This option is mainly for session developers and defines how the interlocking towers will trace in the log their operations. Each click on the current option value will set the next option value.
-The header includes also at its bottom two links : '''Reset tower options to default''' will reset the options to the default values defined by the tower asset content creator. The second link '''Propagate tower options to all enhanced towers''' enables to copy all the current tower enhanced options to all the other enhanced towers on the route.
+''here just below an example of the display details screen for IT Garrenac South"
-Following the header, in surveyor mode, you will have the usual list of all the tower paths with their names, entry signals, exit signals, priorities. To change priorities you can either edit the priority numbers or use the up arrow or down arrow to modify the order and priority of a path. The edit link enables to display a path detail page for the selected path and the delete link enables to remove the selected path.
+[[File:eit manager run time monitor - image 3.png | 800px]]
-Just underneath the '''Create path''' link enables to add a new path to the tower by entering its entry signal name.
+You can see on this example screen that there are now three pages available in the tabs toolbar : the towers page, the tower paths page (currently displayed as the tabs has a pink background) and the trains tab. Using these tables link it is very easy to switch from one page to another by clicking on the adequate tab.
-This page is very similar to the edit tower page in the tower asset, but as it is included in the rule it offers to quickly switch from one tower paths list to another tower paths list in a centralized rule, which may be sometimes preferable to find on the route the tower object to click and edit its properties.
+The tower paths list page has a header to remind you the tower options used for the selected tower, and will list all the available paths in the tower with the path name, the entry signal, the exit signal and the current path status. The page will be refreshed every two seconds and you can follow on this page all the paths states evolution in the tower.
+The paths states can be '''path not set''', '''path not activable''', '''path activating''', '''path active''', '''path cancelling''', '''path in panic mode'''.
+When a path is not set, the monitor checks if the path is currently activable or not and will display path not set for path that can be activated and path is not activable for path that cannot be activated due to some ressources conflicts. Using the show details link, you can display another details screen this time at the path level that will list resources in conflicts that makes the path not activable.
+Just below the path status, the monitor will display for active path the train owing the active path and if the train has already entered the path or not. The message Train xxx owns activated path means that the train has not already entered the path, while the message Train xxx has entered active path means that the train has reached ad left the path entry signal and is currently on the path. This information is available for both standard and enhanced tower paths. For only enhanced towers, you will have also some information about the trains waiting for the path activation or waiting for the path cancellation.
+On the example screen above, we can see that Train T004 - Louise is waiting for path V1ToSouth activation and that the path is currently not activable. To obtain the reason why the path is not activable, you will need to click on the show details link on the displayed path status line. We can also see that Train T001 - Ami currently owns path V3ToSouth which is active.
-In driver mode the display is slightly different :
+To understand why path V1toSouth is not activable, we will click on the display details link. And the monitor will display all the current path details :
+''example of the display details screen for path V1toSouth in IT Garrenac South"
+[[File:eit manager run time monitor - image 4.png | 800px]]
+The path details screen display first the properties of the selected path with the enhanced options for a path belonging to an enhanced tower. But the important thing is that it displays the current path state : path is not activable. Why ? because some path objects are currently locked. It reminds that train T004 - Louise is waiting for this path activation. And the status is displayed with a yellow color because there is a train waiting for the path. And below, you will find the conflicting ressource, in our case a conflicting path V3toSouth which is currently active and owned by train T001 - AMI.
+This is only an example, but on this screen you will find why a path is not activable, because some objects are locked by a conflicting path, or because a TCB is occupied or locked, or because an exclusive set name is locked and not available, or because an extra consist has been detected on the path.You can
+The main interest of this run time monitor is to be able to know all the path states, which trains are using or waiting for these paths, and if a path is not activable, why ? and which conflicting ressource is making this path not activable.
+You can also see that when displaying the path details screen, the tabor has now four tabs : the rtower list page, the tower paths list page, the tower path details tab and the trains tab making easy to switch from one view to another one.
+Let's now show the train tab view.
-''Enhanced Interlocking Tower Manager - Tower path list page in driver mode''
-[[File:Enhanced-interlocking-tower-manager-page-2D.png | none | 800px ]]
-First you cannot edit or delete paths neither create new paths in driver mode. So the corresponding links have been removed from the display. Some other links may not be available : for example the trc compatibility option can only be set in surveyor mode, and cannot be changed later in driver mode, so the option is still displayed but with no link to change it. There is still a link to display the path details page ('''show details'''). But more important, the display will now show and monitor the current path state, which train is currently owning an active path and if the owning train only owns the path or has already entered the path. For only enhanced tower, trains waiting path activation will also be displayed. When is path has a status of path not activable, by clicking on the show details you will have some information why the path is not activable inside the path details page.
-====Enhanced Interlocking Tower Manager Rule - Path details page ====

Enhanced Interlocking Tower Manager Rule

Revision as of 04:46, 17 December 2016

Contents

Enhanced Interlocking Tower Manager Rule

Enhanced Interlocking Tower Manager Rule - How it can help using Interlocking Tower

Views

Personal tools

Navigation

Search

Toolbox