CONNECTED( ) method

Indicates whether an AppServer, 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 AppServer, this method returns TRUE if the AppServer is currently connected and associated with the server handle. For a state-free AppServer, this method returns TRUE if the CONNECT( ) method has been successfully executed for an application service associated with this handle and at least one AppServer 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.

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

For more information on AppServers see OpenEdge Application Server: Developing AppServer Applications.

For more information on PAS for OpenEdge see Progress Application Server for OpenEdge: Application Migration and Development Guide.

For more information on Web services see OpenEdge Development: Web Services

.