ts.ShutdownTimeout

Specifies the time, in seconds, that the Telephony Session service waits for calls to complete after a shutdown request:

  • The default is -1, meaning disabled. The Telephony Session service stops accepting new calls and waits for any active calls to complete before shutting down.
  • Specify 0 for the Telephony Session service to hang up all calls immediately and complete the shutdown. The difference between this behavior and an abort is that an abort does not hang up calls.
  • Specify the number of seconds for the Telephony Session service to wait for active calls to complete. Once the specified time elapses, the Telephony Session service hangs up all calls and completes the shutdown.

Setting this service property to 0 or a reasonable time means that a shutdown can happen faster. This feature is useful for deployments where calls can last a long time.

For example, say a host is running a role that includes two Telephony Session service instances, TSS 1 and TSS 2. Both instances are handling calls. The total amount of time to complete a shutdown equals 2 X ts.ShutdownTimeout. Here’s how it works:

  1. A shutdown all request occurs.
  2. The Management Station sends a shutdown message to TSS 2.
  3. TSS 2 waits for all calls to complete or the time specified by ts.ShutdownTimeout, then finishes the shutdown.
  4. The shutdown message goes to TSS 1 and the process is repeated.
  5. Once TSS 1 has shut down, the Management Station sends the shutdown message to the remaining services, which shut down immediately.