Digital Fleet Dispatch Integration 5/22/2017

Digital Fleet Dispatch Integration Digital Fleet Bridge Service is used to communicate with the Dispatch System Uses MSMQ to accomplish the communication Two queues From Dispatch (Integra) Messages placed here by the dispatch service (i.e. Unisignal) and picked up by DF Bridge Service Name of queue varies based on dispatch system To Dispatch (Integra) Messages placed here by DF Bridge Service and picked up by the dispatch service Requires correct client key, queue names, and endpoint address

Digital Fleet Dispatch Integration Everything placed in “From Dispatch” queue is retrieved by DF Bridge Service and sent to endpoint address regardless of content. The endpoint address is an “integration” project for different dispatch systems Must match expected format otherwise ignored at this point Client key is used for delivery of ticket/message to tablet and web application References client truck table for match with provided truck ID No match – no delivery of ticket/message

Digital Fleet Bridge Service Windows service that runs on the same server as Unisignal. Config file contains client specific info for queue placement and retrieval. Set to automatically startup to reduce likelihood service isn’t running after reboot.

MSMQ Queues Queues are used to pass info from/to Unisignal Integra sets up queues for use Located under Computer Management Message Queuing › Private Queues Todispatch queue Digital Fleet to Integra Fromdispatch queue Integra to Digital Fleet

Queue Messages Queue messages should normally be empty or a low value. The DF Bridge Service picks up information approximately every 5 seconds. If “From Dispatch” queue is filling up, it’s an indication the DF Bridge Service has stopped working. If “To Dispatch” queue is filling up, it’s an indication the dispatch service (i.e. Unisignal) may have stopped working.

MSMQ Queue Journaling If journaling is enabled, eventually all of the queue resources will be used and no information will be passed to/from Digital Fleet. If all tickets/messages fail on delivery or receipt, check if Unisignal is running and/or if Journaling is enabled for each queue. To check if journaling is enabled, right click the queue and select Properties.

MSMQ Queue Journaling Stores all messages in the Journal messages folder. The Journal messages contain all information for the queue message. Journaling should only be used for troubleshooting and only enabled for short amounts of time.

Integra Unisignal Integra Windows Service to communicate with the signaling vendor (Digital Fleet). Reads and writes to MSMQ Indication Unisignal isn’t working properly: No tickets or messages are going to or from the Digital Fleet platform. Generally caused by rebooting of the Integra database server without restarting of the Unisignal service.