How to unlock AppServer agents in LOCKED status after a network failure


Article Number000060694
EnvironmentProduct: OpenEdge
Version: All supported versions
OS: Windows
Question/Problem Description
How to unlock AppServer Agents in LOCKED status after a network failure?
Is there a way to unlock AppServer Agents in a LOCKED state after a network failure?
Steps to Reproduce
Clarifying Information
Error Message
Defect/Enhancement Number
Environment was experiencing network problems, more specifically network bandwidth bottleneck. Agents were stuck on LOCKED because it lost the connection to the AppServer client it was currently associated with.
The AppServer KeepAlive (ASK) Protocol can be enabled on both the Server and client side if the configuration is not set up SSL:
  • non-SSL AppServer connections via a NameServer (AppServer protocol)
  • non-SSL AppServer direct connections (AppServerDC protocol)

1. To enable the ASK Protocol on the Server Side, modify the file as follows:

serverASKActivityTimeout=<Time in Seconds to send the request to client>
serverASKResponseTimeout=<Time in Seconds to wait for response from client>

2. Include the -AppServerKeepalive allowServerASK parameter to enable the ASK protocol on ABL/4GL client side:
hAppSrv:CONNECT ("-AppService <appservername> -H <host> -S <port/service name> -AppServerKeepalive allowServerASK").

Or do not include -AppServerKeepalive parameter because the default value is allowServerASK.
hAppSrv:CONNECT ("-AppService <appservername> -H <host> -S <port/service name> ).

Obs: The ASK protocol on the client is disabled by  adding  -AppServerKeepalive denyServerASK in the CONNECT method.
hAppSrv:CONNECT ("-AppService <appservername> -H <host> -S <port/service name> -AppServerKeepalive denyServerASK").

Last Modified Date12/18/2018 4:34 PM

Did this article resolve your question/issue?


Your feedback is appreciated.

Please tell us how we can make this article more useful. Please provide us a way to contact you, should we need clarification on the feedback provided or if you need further assistance.

Characters Remaining: 1025