Introduction
The SIMS alarm provider driver is an integration between AutoDispatch 2 and SIMS. Incoming messages to AutoDispatch 2 are expected to be delivered to the port specified by the ListenPort configuration parameter. Responses from AutoDispatch 2 are delivered back via the FEP as BoldXML signals. It is expected that the FEP will make a connection to AutoDispatch 2 on the port specified by the FepPort configuration parameter.
Driver File
The SIMS driver file is SIMSAlarmProvider.dll
564Configuration
The SIMS driver is configured via the "SIMS" section of the appsettings.json file. The configuration looks like this with the default values:
"SIMS": {
// Port on which this ADGW will listen for messages from SIMS.
// Default = ??
"ListenPort": 7001,
// Port on which this ADGW will listen for connections with the FEP.
// Default = ??
"FepPort": 7002,
// File path where the log files will get written.
// Default is "C:\\AutoDispatchLogs".
"LogPath": "C:\\AutoDispatchLogs",
// Number of days to save log files.
// Default is 7 days.
"LogDays": 7
// Transmitter ID to use when sending Comm Fail/Rest signals via the FEP.
"TXID": "1234",
// Event code for comm fail. Default = YC
"CommFail": "YC",
// Event code for comm restore. Default = YK
"CommRest": "YK"
},
- ListenPort
- Specifies the port number on which the SIMS Driver will listen for requests from SIMS.
- FepPort
- Specifies the port number on which the SIMS Driver will listen for connections from the FEP.
- LogPath
- As SIMS does not have an internal logger mechanism with which AutoDispatch 2 can communicate, diagnostic and other informational/error messages from AutoDispatch 2 are written to a daily disk file named ADGWLogYYYY-MM-DD.txt. This parameter specifies the file path to which the log files will be written. Note that UTC date/time is used for the log.
- LogDays
- To minimize clutter and use of disk space, AutoDispatch 2 will delete older log files upon initial startup and change of date. This parameter specifies how many days of log files to keep. During cleanup, any daily file prior to the current date minus LogDays will be deleted.
- TXID
- Comm fail/restore signals will be sent to SIMS using this transmitter ID. If this is empty, comm fail/restore signals will not be sent. The comm fail/restore refers only to the AutoDispatch connection with a dispatch provider such as TMA.
- CommFail
- This is the event code that will be sent when a comm fail is detected. This will happen after 3 heartbeats with no response, no response to an actual message being sent, or shutdown of the SIMS alarm provider.
- CommRest
- This is the event code that will be sent when a comm restore is detected. This will happen after resumption of response to a heartbeat, or a response to an actual message being sent. When the SIMS alarm provider is first started, the connection is assumed to be down, so the first communication will send a CommRest signal to SIMS.
