FailedEngines
Returns a quoted string list of session engines that were registered but have since failed.
Syntax
FailedEngines[Password As String] As String (read only)
Example
'http://IVWSVR1/WS1', 'http://IVWSVR2/WS1'
Arguments
Password
The Web tier registration password. The password is used to prevent unauthorized access to the session engine list.
Remarks
A session engine is marked as failed if three consecutive calls to it fail. The Web tier automatically attempts to reregister a failed session engine after the period specified in the EngineRetryTimeout configuration setting. If the failed engine is still unavailable after the number of retries specified in the EngineMaxRetries configuration setting, the engine is removed from the FailedEngines list.
The list of registered and failed engines is saved to file so that session engines do not need to be reregistered when the Web tier is restarted. The engine registration file, RegisteredEngines.xml, is stored in the same folder as the running instance of UNICOM Intelligence Interviewer Web. The file stores the list of registered and failed engines as simple XML:
<mrIWeb>
<Registered>
<Engine URL = "http://IVWSVR1/WS1">
<Engine URL = "http://IVWSVR1/WS2">
</Registered>
<Failed>
<Engine URL = "http://IVWSVR2/WS1">
</Failed>
</mrIWeb>
Note The engines referenced in the RegisteredEngines configuration setting are automatically reregistered on startup, even if they have been moved to the FailedEngines list. For this reason, the RegisteredEngines configuration setting should only be used when the session engine registration web service is disabled.
See also