Public Member Functions | Protected Member Functions

alma.acs.container.corba.JacOrbConfigurator Class Reference

Inheritance diagram for alma.acs.container.corba.JacOrbConfigurator:
alma.acs.container.corba.OrbConfigurator

List of all members.

Public Member Functions

String getPortPropertyName ()
String getORBClass ()
String getORBSingleton ()

Protected Member Functions

Properties _getProperties ()
CmdLineRegisteredOption[] _declareOptions ()

Detailed Description

Configures the JacORB ORB.

Created on 24-Feb-2003

Author:
hsommer

Member Function Documentation

CmdLineRegisteredOption [] alma.acs.container.corba.JacOrbConfigurator._declareOptions (  )  [protected, virtual]
Properties alma.acs.container.corba.JacOrbConfigurator._getProperties (  )  [protected, virtual]

Delivers the properties to configure the JacORB ORB and POA.

From the JacORB 1.4 Programming Guide:

Property Description Type
ORBInitRef.<service> Properties of this form configure initial service objects which can be resolved via the ORB resolve_initial_references. A variety of URL formats are supported. URL
org.omg.PortableInterceptor.
ORBInitializerClass.<name>
A portable interceptor initializer class instantiated at ORBcreation. class
jacorb.orb.objectKeyMap.<name> Maps an object key to an arbitrary string thereby enabling better readability for corbaloc URLs. string
jacorb.orb.print_version If enabled, the ORB's version number is printed whenever the ORB is initialized. Default is on. boolean
jacorb.verbosity Diagnostic verbosity level: 0 = off, 1 = important messages and exceptions, >= 3 = debug-level output (output may be extensive) integer
jacorb.logfile Output destination for diagnostic log file. If not set, then diagnostics are sent to standard output. file
jacorb.debug.dump_outgoing_messages Hex dump outgoing messages. Default is off. boolean
jacorb.debug.dump_incoming_messages Hex dump incoming messages. Default is off. boolean
jacorb.giop_minor_version The GIOP minor version number to use for newly createdIORs. Default is 2. integer

jacorb.retries

Number of retries if connection cannot directly be established. Default is 5.

integer

jacorb.retry_interval

Time in milliseconds to wait between retries. Default is 500.

millisec.

jacorb.outbuf_size

Size of network buffers for outgoing messages in bytes. Default is 2048.

byte

jacorb.maxManagedBufSize

This is NOT the maximum buffer size that can be used, but just the largest size of buffers that will be kept and managed. This value will be added to an internal constant of 5,so the real value in bytes is 2** (5 + maxManagedBufSize- 1). You only need to increase this value if you are dealing with LOTS of LARGE data structures. You may decrease it to make the buffer manager release large buffers immediately rather than keeping them for later reuse. Default is18.

integer

jacorb.connection.client_timeout

Client-side timeout. This is set to non-zero in order to stop blocking after specified number of milliseconds. Not set by default.

millisec.

jacorb.connection.server_timeout

Maximum time in milliseconds that a server keeps a connection open if nothing happens. Not set by default.

millisec.

jacorb.reference_caching

Whether or not JacORB caches objects references. Not set by default.

boolean

jacorb.hashtable_class

The following property specifies the class which is used for reference caching. WeakHashtable uses WeakReferences, so entries get garbage collected if only the Hashtable has a reference to them. This is useful if you have many references to short-living non-persistent CORBA objects. It is only available for java 1.2 and above. On the other hand the standard Hashtable keeps the references until they are explicitly deleted by calling release(). This is useful for persistent and long-living CORBA objects. Defaults to Hashtable.

class

jacorb.use_bom

Use GIOP 1.2 byte order markers, since CORBA 2.4-5. Default is off.

boolean

jacorb.giop.add_1_0_profiles

Add additional IIOP 1.0 profiles even if using IIOP 1.2. Default is off.

boolean

org.omg.PortableInterceptor.
ORBInitializerClass.bidir_init

This portable interceptor must be configured to support bi-directional GIOP. Not set by default.

class

jacorb.ior_proxy_host

The jacorb.ior proxy host and jacorb.ior proxy port properties inform the ORB what IP/port IORs should contain, if the ServerSockets IP/port can't be used (e.g. for traffic through a firewall). WARNING: this is just dumb replacing, so you have to take care of your configuration! Not set by default.

node

jacorb.ior_proxy_port

See jacorb.ior proxy host above. Not set by default.

port

OAIAddr

The Object Adapter Internet Address: IPaddress on multi-homed host (this gets encoded in object references). NOTE: Addresses like 127.0.0.X will only be accessible from the same machine! Not set by default.

node

OAPort

See OAIAddr above. Not set by default.

port

org.omg.PortableInterceptor.
ORBInitializerClass.standard_init

Standard portable interceptor. DO NOT REMOVE.

class

jacorb.net.socket_factory

Sets or defines the socket factory that must implement the operations defined in the org.jacorb.orb.factory.SocketFactory interface.

class

jacorb.net.server_socket_factory

Sets or defines the socket factory that must implement the operations defined in the org.jacorb.orb.factory.ServerSocketFactory interface.

class

jacorb.net.socket_factory.port.min

Sets the minimum port number that can be used for an additional supported socket factory. This property is used in conjunction with the jacorb.net.socket factory.port.max property. These properties enable the factory to traverse firewalls through a fixed port range. Default is unset, disabling the factory.

integer

jacorb.net.socket_factory.port.max

Sets the maximum port number that can be used for the additional supported socket factory. Refer to jacorb.net.socket factory.port.min above. Default is unset, disabling the factory.

integer

jacorb.poa.monitoring

Displays a GUI monitoring tool for servers. Default is off.

boolean

jacorb.poa.thread_pool_max

Maximum thread pool configuration for request processing.

integer

jacorb.poa.thread_pool_min

Minimum thread pool configuration for request processing.

integer

jacorb.poa.thread_priority

If set, request processing threads in the POA will run at this priority. If not set or invalid, MAX PRIORITY will be used. Not set by default.

integer

jacorb.poa.queue_max

The size of the request queue. Clients will receive Corba.TRANSIENT exceptions if load exceeds this limit. Default is 100.

integer

Information on threading:

JacORB currently offers one server side thread model. The POA responsible for a given request will obtain a request processor thread from a central thread pool. The pool has a certain size which is always between the maximum and minimum value configured by setting the properties jacorb.poa.thread_pool_max and jacorb.poa.thread_pool_min.

<font size="-1"> When a request arrives and the pool is found to contain no threads because all existing threads are active, new threads may be started until the total number of threads reaches jacorb.poa.thread_pool_max. Otherwise, request processing is blocked until a thread is returned to the pool. Upon returning threads that have finished processing a request to the pool, it must be decided whether the thread should actually remain in the pool or be destroyed. If the current pool size is above the minimum, a processor thread will not be out into the pool again. Thus, the pool size always oscillates between max and min. Setting min to a value greater than one means keeping a certain number of threads ready to service incoming requests without delay. This is especially useful if you know that requests are likely to come in in a bursty fashion. Limiting the pool size to a certain maximum is done to prevent servers from occupying all available resources. Request processor threads usually run at the highest thread priority. It is possible to influence thread priorities by setting the property jacorb.poa.thread_priority to a value between Java's Thread.MIN PRIORITY and Thread.MAX PRIORITY. If the configured priority value is invalid JacORB will assign maximum priority to request processing threads. </font>

See also:
alma.acs.container.corba.OrbConfigurator.getProperties()

Implements alma.acs.container.corba.OrbConfigurator.

References alma.acs.container.corba.OrbConfigurator.debug.

String alma.acs.container.corba.JacOrbConfigurator.getORBClass (  )  [virtual]
String alma.acs.container.corba.JacOrbConfigurator.getORBSingleton (  )  [virtual]
String alma.acs.container.corba.JacOrbConfigurator.getPortPropertyName (  )  [virtual]

The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables Enumerations Properties