When you select EAServer as the connection type in the Connection Object wizard, PowerBuilder creates a standard class user object inherited from the Connection object. You supply the Connection object properties in the wizard and specify whether connection information will be provided in the registry, an INI file, or a script. The Connection Object wizard gets information about the server you want to connect to from the EAServer profiles you have set up. For how to create an EAServer profile, see “Creating an application server profile”.
The Constructor event of the Connection object calls a function, of_getconnectioninfo, that gets the stored connection information from the source you specified.
Once you have used the Connection Object wizard to create a Connection object, you need to execute the PowerScript statements required to perform these operations:
Use the Create statement to instantiate the Connection object.
Invoke the ConnectToServer function to establish a connection to the server.
(Optional) Check for errors.
You do not need to set properties for the Connection object, but you can modify them in the of_getconnectioninfo function. You can also set options for the Connection object in its constructor event, for example:
this.options = "ORBHttp='TRUE'"
Example The following script instantiates the myconnect instance of the n_myclient_connect object created by the wizard, invokes the ConnectToServer function to establish a connection to the server, and checks for errors:
long ll_rc
myconnect = create n_myclient_connect
ll_rc = myconnect.ConnectToServer()
IF ll_rc <> 0 THEN
MessageBox("Connection failed", ll_rc)
END IF
You can establish multiple connections in a single client application. If you want to connect a client to two different servers, run the Connection Object wizard again to create a new user object with different connection properties.
