Appendix A EAServer 1.1 Java Classes and Interfaces

jaguar.beans.enterprise.JProperties class

Description

package com.sybase.jaguar.beans.enterprise;

public class JProperties extends Properties

JProperties provides convenience methods for initializing properties required by the CommunicationManager.createInstance(Properties) method.

Methods

Table 5-1 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 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   Note You must set this property to true when instantiating stubs for intercomponent calls 		No
setPortNumber A string specifying the port at which the 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 EAServer 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 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 EAServer 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

See Also

CommunicationManager.createInstance(Properties)

 

Copyright © 2001 Sybase, Inc. All rights reserved.