BBjConfig::isReleaseOnLostConnection

Description

In BBj 2.01 and higher, this method returns a boolean value that indicates whether the interpreter session will be terminated immediately if the client side of a thin client connection dies unexpectedly.

Syntax

Return Value	Method
boolean	isReleaseOnLostConnection()

Parameters

None.

Return Value

false (0) = Interpreter session not automatically terminated.

true (1) = Terminate interpreter session immediately.

Remarks

By default, the interpreter thread of a thin client connection is terminated if the client connection terminates unexpectedly. The application developer can choose to trap this event and do some final cleanup before terminating the interpreter thread. When releaseOnLostConnection() is set to false, the interpreter thread generates an interrupt signal if the client connection is dropped unexpectedly. This interrupt can trapped with a standard SETESC handler, which should do something like the following:

IF and(chr(tcb(19)),$08$)=$08$ THEN gosub cleanup; release

The cleanup routine must not attempt to communicate with the client session, since the client no longer exists. Any such attempt might generate a runaway error/retry situation as the program repeatedly attempts to communicate with a nonexistent client.

Example

config! = bbjapi().getConfig()
config!.releaseOnLostConnection(config!.isReleaseOnLostConnection())
print "releaseOnLostConnection? ",config!.isReleaseOnLostConnection()