PSJaguarConnection

Specifies the connection information used to connect to a component on EAServer. This component provides interoperability between the Web DataWindow control and page servers that support ActiveX or Java.

Syntax

Syntax specifying server name and properties

PSJaguarConnection(serverName, userId, password, componentName, bOneTrip)

Syntax specifying an EAServer profile (JSP targets only)

PSJaguarConnection(profileName, componentName, bOneTrip)

Constructors

PSJaguarConnectionconstructor

Datatype

Description

serverName

String

The name of the server that runs the component for your Web DataWindow control. The syntax for this entry is serverName:port.

profileName

String

The server connection parameters defined in the jaguar.properties file in the \WEB-INF\classes directory. This file is created when you build the JSP target and its content is taken from the EAServer profiles defined in PowerBuilder.

userId

String

The username that the object uses to connect to the specified EAServer. The default is Jaguar.

password

String

The password that the object uses to connect to the specified EAServer. The default is guest.

componentName

String

The name of the Web DataWindow server component on EAServer that uses this connection. The default is DataWindow/nv_html_data_window.

bOneTrip

String

Specifies how many round trips are made to the server. Lets you specify that one method, rather then several, perform the setup and generate the HTML for your Web DataWindow.

  • true One trip is made to the server to set up and generate HTML.

    If set to true, the DataWindow must have a name configured. Setting this parameter can help increase performance for a custom component that has already loaded a DataWindow object.

  • false (default) Methods for setting up your DataWindow and generating the HTML are coded separately and require more than one trip to the server.

Examples

Example 1

The following example for an ASP target defines a connection to the EAServer named "Jaguar1" using the port 9000:

Var jagParm = new PSJaguarConnection(Jaguar1:9000)

Example 2

For JSP targets, you must assign a variable as an object of the PSJaguarConnection type before you can instantiate it, and you must use semicolons to terminate each line of code:

PSJaguarConnection jagConn = new PSJaguarConnection("my-desktop:9000", "jagadmin", "", "DataWindow/HTMLGenerator100", false);