Indicates whether a Progress Application Server for OpenEdge (PAS for OpenEdge) instance, or Web service is currently connected and associated with the server handle, or if a socket handle is currently connected to a port.

Return type: LOGICAL

Applies to: Server object handle, Socket object handle

Syntax

CONNECTED ( )

For a Web service or PAS for OpenEdge instance, this method indicates if a server handle is currently connected (that is, if the client has a logical connection to the Web service or PAS for OpenEdge instance). It does not indicate that a physical connection exists between the ABL client and the Web service or PAS for OpenEdge instance.

For a state-reset, state-aware, or stateless application server, this method returns TRUE if the application server is currently connected and associated with the server handle. For a state-free application server, this method returns TRUE if the CONNECT( ) method has been successfully executed for an application service associated with this handle and at least one application server resource is available for the client to access this application service.

This method returns TRUE between the successful invocation of the CONNECT( ) method and a call to the DISCONNECT( ) method. If the connection terminated abnormally (that is, other than by the DISCONNECT( ) method), the CONNECTED( ) method returns FALSE.

Note: This method returning TRUE does not indicate the state of the HTTP connection to the Web service or PAS for OpenEdge instance. If there is a failure in the connection between the client and the Web service or PAS for OpenEdge instance, subsequent requests might fail.

However, in OpenEdge 12.3 and above, this method has been improved to return the availability of a valid server session for an ABL client. For more information, see the "Enhanced CONNECTED() method for ABL clients" entry in What's New in OpenEdge 12.3.

For a socket object, this method returns TRUE if the socket handle refers to a connected socket, and returns FALSE otherwise.