The following table lists the methods. Each method takes one
parameter. The second column describes the values to be supplied
as the method's parameter. The third column describes whether
the information is required or optional.
Table 5-1: JProperties
Methods
Method
|
Input value
|
Required
(yes/no)
|
|---|
setProtocol
|
A string with one of the
following values:
- "jdbc102" if
the code will run in a Java virtual machine that is compatible with JDK
1.0.2
- "jdbc" or "iiop" if
the code will run in a Java virtual machine that is compatible with
JDK 1.1
- "iiops" to specify that the connection should
use secure IIOP. The port number specified with setPortNumber determines
the security options that are used for the connection. Currently,
this option is only available to applets that are running in a browser
that supports the HTTPS protocol
|
Yes
|
setMachineName
|
A string containing the
machine name on which the Jaguar server is running, or "localhost" if
the server is configured with "localhost" as a
machine name in its IIOP listener
|
Yes
|
setNewConnection
|
A boolean. If true
,
the stub object will use a new (rather than cached) connection.
The default is false
, which
means the stub may share a connection with stubs that invoke methods
on the same server
Setting the property to true
can
improve response time of client method calls at the expense of server-side,
client-side, and network resources
 Note
You must set this property to true
when instantiating
stubs for intercomponent calls
|
No
|
setPortNumber
|
A string specifying the
port at which the Jaguar server accepts IIOP requests, for example "9000"
The server's IIOP ports are configured in Jaguar
Manager, in the IIOP Listeners folder. A server may listen on several
ports, each of which accepts connections using different security
options. See "Security Configuration" in the Jaguar
CTS System Administration Guide for more information
If you choose a secure port, specify "iiops" when
calling setProtocol. If you choose a secure port
that requires client-side SSL authentication, users of your program
must have an SSL certificate
|
Yes
|
setUserName
|
A string specifying the
user name for the connection
|
Yes
|
setPassword
|
A string specifying the
password for the connection
|
Yes
|
setStubPackageName
|
A string specifying the
Java package name of the generated stub class, for example "com.xyz.JagStubs"
|
Yes
|
setHTTPTunneling
|
A string with value "jag_tunnel" to
enable HTTP tunnelling. Tunneling is off by default. HTTP tunneling
is required to make connections through a network firewall that does
not recognize TDS packets
|
No
|
setHTTPPortNumber
|
A string specifying the
port number at which the Jaguar server listens for HTTP requests. Used
only when HTTP tunnelling is enabled. If no port is specified, the
default port ("8080") is used
|
No
|
setPackageName
|
A string specifying the
Jaguar package name in which the component is installed, as displayed
in Jaguar Manager. Package names are not case sensitive. The package
must be available on the server
|
Yes
|
setComponentName
|
A string specifying the
component name, as displayed in Jaguar Manager. Component names
are not case sensitive. The component must be installed in the package
that is specified by calling setPackageName
|
Yes
|
