Class: com.sybase.jaguar.server.JaguarComponent (CORBA Component) EAServer 6.3 Help
Description A CORBA component can be implemented in C++, Java or PowerScript. To run in the server it must be wrapped as an EJB session bean (or message-driven bean).

The properties of a PowerBuilder component should be configured using the PowerBuilder IDE. The properties of a C++ or Java CORBA component should be configured using the web console, or by using the Set Properties Task, e.g. 

  <project name="corba-MyPackage">
    <target name="configure">
      <setProperties component="MyPackage/MyComp">
        <property name="com.sybase.jaguar.component.type" value="cpp"/>
        <property name="com.sybase.jaguar.component.cpp.class" value="MyCompImpl"/>
        ...
      </setProperties>
    </target>
  </project>
The jaguar-compiler command-line tool is used to generate and deploy the EJB-JAR wrapper for a CORBA package, e.g. 
  jaguar-compiler MyPackage

See also: CORBA Package.

Configuration See Set Properties Task.
Properties com.sybase.jaguar.component.auto.failover, com.sybase.jaguar.component.bind.object, com.sybase.jaguar.component.bind.thread, com.sybase.jaguar.component.code.set, com.sybase.jaguar.component.cpp.class, com.sybase.jaguar.component.cpp.copy, com.sybase.jaguar.component.cpp.debug, com.sybase.jaguar.component.cpp.library, com.sybase.jaguar.component.debug, com.sybase.jaguar.component.home, com.sybase.jaguar.component.instancePool.timeout, com.sybase.jaguar.component.interfaces, com.sybase.jaguar.component.java.class, com.sybase.jaguar.component.mdb.acknowledge-mode, com.sybase.jaguar.component.mdb.destination-type, com.sybase.jaguar.component.mdb.message-selector, com.sybase.jaguar.component.mdb.subscription-durability, com.sybase.jaguar.component.mdb.thread-count, com.sybase.jaguar.component.pb.class, com.sybase.jaguar.component.pb.librarylist, com.sybase.jaguar.component.pb.version, com.sybase.jaguar.component.pooling, com.sybase.jaguar.component.queue, com.sybase.jaguar.component.remote, com.sybase.jaguar.component.roles, com.sybase.jaguar.component.sharing, com.sybase.jaguar.component.thread.safe, com.sybase.jaguar.component.timeout, com.sybase.jaguar.component.topic, com.sybase.jaguar.component.tx_outcome, com.sybase.jaguar.component.tx_retry, com.sybase.jaguar.component.tx_timeout, com.sybase.jaguar.component.tx_type, com.sybase.jaguar.component.tx_vote, com.sybase.jaguar.component.type, com.sybase.jaguar.component.webservice
Files Repository/Instance/com/sybase/jaguar/server/JaguarComponent/*.properties

Property: com.sybase.jaguar.component.auto.failover (Automatic Failover)
Description When running in a cluster environment, enables clients to automatically switch to another server if the server they are communicating with fails.

See also: requestLog, responseLog.

Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.bind.object (Bind Object)
Description Allows a component instance to remain associated with a client's object reference after 'setComplete' is called. If this is not set, component instances are returned to the instance pool after 'setComplete' is called.
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.bind.thread (Bind Thread)
Description Ensures that all calls to a component instance are made by the same thread. This may be necessary if the component uses thread-local storage. However it is not particularly scalable as it requires the server to create one extra thread per component instance.
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.code.set (Code Set)
Description For C++ components, determines the code set for string parameters. If not specified, this defaults to the server's default code set.

Property: com.sybase.jaguar.component.cpp.class (C++ Class)
Description For C++ components, specifies the name of the component implementation class.
Only Used If Property com.sybase.jaguar.component.type has the value "cpp".

Property: com.sybase.jaguar.component.cpp.copy (Copy Library)
Description For C++ components, specifies whether the DLL (shared library) should be copied to a temporary file before loading. This permits "hot refresh" of C++ components.
Only Used If Property com.sybase.jaguar.component.type has the value "cpp".
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.cpp.debug (Debug Library)
Description For C++ components, set this if you plan to use a debugger.
Only Used If Property com.sybase.jaguar.component.type has the value "cpp".
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.cpp.library (C++ Library)
Description For C++ components, specifies the name of the DLL (shared library). A file suffix is not required, as depending on the operating system platform, an appropriate suffix will be added. The usual location for C++ DLLs is the server's "cpplib" directory.
Only Used If Property com.sybase.jaguar.component.type has the value "cpp".

Property: com.sybase.jaguar.component.debug (Debug)
Description Specifies whether the server should print debugging messages to the server log that may be helpful for troubleshooting problems with component instance lifecycle.
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.home (IDL Home Interface)
Description Name of the component's CORBA IDL home (factory) interface. If not specified, this will be automatically set during deployment.

Property: com.sybase.jaguar.component.instancePool.timeout (Instance Pool Timeout)
Description The number of seconds a pooled component instance may remain idle before it is destroyed.
Default Value 600
Minimum Value 0
Maximum Value 2147483647

Property: com.sybase.jaguar.component.interfaces (IDL Component Interfaces)
Description Comma-separated list of the component's CORBA IDL interfaces.

Property: com.sybase.jaguar.component.java.class (Java Class)
Description For CORBA Java components, the name of the Java implementation class.
Only Used If Property com.sybase.jaguar.component.type has the value "java".

Property: com.sybase.jaguar.component.mdb.acknowledge-mode (MDB Acknowlegde Mode)
Description For listener components, specifies the JMS acknowledge mode that will be used by the message-driven bean wrapper that is generated during deployment.
Only Used If Property com.sybase.jaguar.component.remote has the value "CtsComponents::MessageListener".
Default Value Auto-acknowledge
Legal Values Auto-acknowledge, Dups-ok-acknowledge

Property: com.sybase.jaguar.component.mdb.destination-type (MDB Destination Type)
Description For listener components, specifies the JMS destination type that will be used by the message-driven bean wrapper that is generated during deployment.
Only Used If Property com.sybase.jaguar.component.remote has the value "CtsComponents::MessageListener".
Default Value javax.jms.Queue
Legal Values javax.jms.Queue, javax.jms.Topic

Property: com.sybase.jaguar.component.mdb.message-selector (MDB Message Selector)
Description For listener components, specifies the JMS message selector that will be used by the message-driven bean wrapper that is generated during deployment.
Only Used If Property com.sybase.jaguar.component.remote has the value "CtsComponents::MessageListener".

Property: com.sybase.jaguar.component.mdb.subscription-durability (MDB Subscription Durability)
Description For listener components with a destination type of "javax.jms.Topic", specifies the JMS subscription durability that will be used by the message-driven bean wrapper that is generated during deployment.
Only Used If Property com.sybase.jaguar.component.remote has the value "CtsComponents::MessageListener".

Property: com.sybase.jaguar.component.mdb.thread-count (MDB Thread Count)
Description For listener components, specifies the JMS thread count that will be used by the message-driven bean wrapper that is generated during deployment.
Only Used If Property com.sybase.jaguar.component.remote has the value "CtsComponents::MessageListener".
Default Value 1
Minimum Value 0
Maximum Value 2147483647

Property: com.sybase.jaguar.component.pb.class (PowerBuilder NVO Class)
Description For PowerBuilder components, specifies the name of the PowerBuilder implementation class.

Note: this is normally set by the PowerBuilder IDE during deployment.

Only Used If Property com.sybase.jaguar.component.type has the value "pb".

Property: com.sybase.jaguar.component.pb.librarylist (PowerBuilder Library List)
Description For PowerBuilder components, specifies the library list.

Note: this is normally set by the PowerBuilder IDE during deployment.

Only Used If Property com.sybase.jaguar.component.type has the value "pb".

Property: com.sybase.jaguar.component.pb.version (PowerBuilder Version)
Description For PowerBuilder components, specifies the PowerBuilder version.

Note: this is normally set by the PowerBuilder IDE during deployment.

Only Used If Property com.sybase.jaguar.component.type has the value "pb".
Default Value 10.5

Property: com.sybase.jaguar.component.pooling (Pooled)
Description Specifies whether component instances should always be pooled. Instance pooling callbacks such as "canBePooled" or "canReuse" will not be called.
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.queue (MDB Queue Name)
Description For listener components with a destination type of "javax.jms.Queue", specifies the JMS queue name that will be used by the message-driven bean wrapper that is generated during deployment.
Only Used If Property com.sybase.jaguar.component.remote has the value "CtsComponents::MessageListener".

Property: com.sybase.jaguar.component.remote (IDL Remote Interface)
Description Name of the component's primary CORBA IDL interface. If this is not specified, it will be derived from the "com.sybase.jaguar.component.interfaces" property.

Property: com.sybase.jaguar.component.roles (Roles Required)
Description Comma-separated list of security roles. Any client attempting to call a method of this component must be a member of at least one of the roles.

Property: com.sybase.jaguar.component.sharing (Shared)
Description Specifies whether a singleton instance of this component should be used.
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.thread.safe (Thread Safe)
Description Specifies whether it is safe for business methods to be called simultaneously by different threads on multiple instances of this component.

Note: if "com.sybase.jaguar.component.sharing" is true, this property specifies whether it is safe for multiple threads to simultaneously call business methods on a singleton instance of this component.

Default Value true
Legal Values false, true

Property: com.sybase.jaguar.component.timeout (Passivation Timeout)
Description Idle timeout for stateful component instances. If "com.sybase.jaguar.component.tx_vote" is true, this determines how many seconds an instance can be idle before it is automatically destroyed.
Default Value 0
Minimum Value 0
Maximum Value 2147483647

Property: com.sybase.jaguar.component.topic (MDB Topic Name)
Description For listener components with a destination type of "javax.jms.Topic", specifies the JMS topic name that will be used by the message-driven bean wrapper that is generated during deployment.
Only Used If Property com.sybase.jaguar.component.remote has the value "CtsComponents::MessageListener".

Property: com.sybase.jaguar.component.tx_outcome (Transaction Outcome)
Description Indicates the situations in which a transaction rollback should be notified to the client as an exception. The value "failed" allows a code-initiated rollback (e.g. setRollbackOnly) to not send an exception to the client, whereas a system-initiated rollback will always send an exception.
Default Value always
Legal Values failed, system_exception_clienttxn, system_exception_implicittxn, always

Property: com.sybase.jaguar.component.tx_retry (Transaction Retry)
Description Specifies whether container-managed transactions should be automatically retried after a rollback.
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.tx_timeout (Transaction Timeout)
Description MISSING DESCRIPTION!
Default Value 0
Minimum Value 0
Maximum Value 2147483647

Property: com.sybase.jaguar.component.tx_type (Transaction Type)
Description Specifies the transaction attribute for container-managed transactions.
Default Value not_supported
Legal Values bean_managed, mandatory, never, not_supported, requires, requires_new, supports

Property: com.sybase.jaguar.component.tx_vote (Stateful Session Bean)
Description Specifies that a component should be wrapped as an EJB stateful session bean.
Default Value false
Legal Values false, true

Property: com.sybase.jaguar.component.type (Component Type)
Description Required. Specifies the implementation language for a CORBA component (C++, Java or PowerScript).
Legal Values cpp, java, pb

Property: com.sybase.jaguar.component.webservice (Expose As Web Service)
Description Specifies whether this component will be exposed as an EJB web service. If enabled, the component will still be exposed with an EJB remote interface.
Default Value false
Legal Values false, true