Progress
Language Reference
CONNECT( ) Method
(AppServer)Connects to and associates a Progress AppServer instance with the specified server handle. The current application becomes a client application of the connected AppServer.
Return Type: LOGICAL Applies To: Server Object Handle
All of the parameters for the CONNECT( ) method are optional and have defaults if you do not specify them.
connection-parms
A character string containing a space-separated list of one or more AppServer connection parameters. Table 48 describes each AppServer connection parameter that you can include in this string. If you include any other parameters in this string, the method ignores them.
[ userid ] [ , password ] [ , app-server-info ]
From one to three character string parameters passed as input to the AppServer Connect procedure. The possible values that you can specify for these parameters is determined by the Connect procedure for the AppServer application. If you omit a parameter, it defaults to the unknown value (?).
If an error occurs while executing the CONNECT( ) method, the method returns FALSE. Otherwise, it returns TRUE. An error can occur if:
- The server handle is invalid.
- One of the parameters contains an invalid value.
- One of the values specified in the connection-parms parameter is invalid.
- The Name Server cannot be located.
- The specified Application Service is not registered to a Name Server.
- The client application cannot connect to the AppServer selected by the Name Server.
- The AppServer selected by the Name Server cannot allocate a connection for the client application.
- The AppServer executes a Connect procedure that terminates with a STOP condition, a QUIT condition, or after executing a RETURN ERROR statement. For more information on Connect procedures, see Building Distributed Applications Using the Progress AppServer .
If CONNECT( ) completes successfully, the CONNECTED( ) method returns TRUE.
The connection lasts until the client application executes the server handle DISCONNECT( ) method or until Progress detects any failure conditions that automatically terminate the connection.
The -URL connection parameter allows you to connect to an AppServer using the AppServer Internet Adapter (AIA) with the following protocols: HTTP and HTTPS.
For more information on the AppServer Internet Adapter (AIA), see Progress Version 9 Product Update Bulletin.
For more information on Progress AppServers, see Building Distributed Applications Using the Progress AppServer .
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |