Using the wizard to create a Connection object
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:
1 |
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:
1 |
long ll_rc<br>myconnect = create n_myclient_connect<br>ll_rc = myconnect.ConnectToServer()<br>IF ll_rc <> 0 THEN<br> MessageBox("Connection failed", ll_rc)<br>END IF |
Establishing multiple connections
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.