Accessing component properties
ContextKeyword service object
You can use the ContextKeyword service object to get component
property values. To retrieve property values, you call the GetContextKeywords function.
Before you can use the ContextKeyword service object, create
a reference to the object by calling the GetContextService function,
using ContextKeyword as the service name.
EAServer properties for
PowerBuilder
This table lists component
properties that pertain to PowerBuilder custom class user objects
running as EAServer components.
Component properties are prefixed with the string com.sybase.jaguar.component.
The values of all component properties are displayed on the All
Properties tab of the Component Properties dialog box in EAServer Manager. Some properties
also map to items on other tabs in this dialog box as shown in Table 24-7.
Property | Description | Where displayed |
---|---|---|
auto.failover | Enables client proxies for the component to transfer to alternative servers when a server becomes unavailable. This property cannot be enabled unless you have enabled automatic demarcation/deactivation. Automatic failover requires that your application use a cluster |
Transactions (Automatic Failover) |
bind.thread | Indicates whether the component instance must always be invoked on the creating thread. Valid values are TRUE and FALSE. |
Instances (Bind Thread) |
code.set | Specifies the name of the coded character set used by the component. By default, the component uses the server’s coded |
All Properties |
interfaces | Identifies the interfaces that the component implements. This is a comma-separated list of IDL interface names, each |
All Properties |
minpool | When instance pooling is enabled, specifies the minimum number of instances that can be pooled. To release idle pooled instances, EAServer has |
Resources |
maxpool | When instance pooling is enabled, specifies the maximum number of instances that can be pooled. If the maximum pool size is reached, EAServer destroys |
Resources |
name | Specifies the name of the component.
The value must take the form: package/component |
General (component part only) |
pb.appname | Specifies the name of the PowerBuilder application. |
General |
pb.class | Specifies the name of the PowerBuilder custom class user object. |
General |
pb.cookie | Provides a number used to construct the path for the library list. The path takes this form: RepositoryComponentpackagecomponentCcookie |
All Properties |
pb.debug | Indicates whether you can debug the component in the PowerBuilder debugger. |
All Properties |
pb.librarylist | Specifies the PowerBuilder library list.
When a library name has a prepended dollar sign ($), EAServer assumes that its location |
General |
pb.live_edit | Specifies whether you can build the project from the User Object painter instead of the Project painter. See “Live editing”. |
All Properties |
pb.trace | Specifies trace options for logging activity against the component (currently disabled). |
All Properties |
pb.version | Specifies the version of PowerBuilder in which the component was built. |
All Properties |
pooling | Indicates whether the component is pooled.
When the pooling property is set to TRUE, If the tx_vote property is set to FALSE, |
Instances |
sharing | Indicates whether this is a shared component.
When the sharing property is set to TRUE, To make a shared component a service, add it to the list of |
Instances |
state | When using automatic persistence, specifies the name of an IDL type. For PowerBuilder, the named type is a user-defined structure |
Persistence |
state.gs | The names of methods in the state structure that get and set the state datatype, specified as a 2-item comma-separated list. The default is: getState, setState |
Persistence (State Methods) |
stateless | Applies only to EJB session Beans and non-EJB components that use the control interface CtsComponents::ObjectControl. Setting this property has the same effect as setting the |
Instances |
storage | Specifies the name of a component that reads and writes component state information from a remote database server. Required when using automatic persistence, or when using component-managed Also specifies the connection cache and table used by the |
Persistence (Storage Component, Connection Cache, Table) |
thread.safe | Indicates whether multiple invocations can be processed simultaneously. For more information see “Concurrency property”. |
Instances (Concurrency) |
timeout | Specifies how long an active component instance can remain idle between method calls before being automatically deactivated. |
Resources (Instance Timeout) |
tx_outcome | Determines whether a CORBA::TRANSACTION_ROLLEDBACK exception is thrown to the client when a transaction is rolled back. The allowable settings are:
With |
All Properties |
tx_timeout | Specifies the maximum duration of an EAServer transaction.
EAServer checks for timeouts |
Resources (Transaction Timeout) |
tx_type | Indicates whether the component participates in EAServer transactions and in what way. Valid values are:
|
Transactions |
tx_vote | Indicates whether the component supports automatic demarcation and deactivation. When tx_vote is set to TRUE, the When tx_vote is set to FALSE, EAServer automatically deactivates |
Transactions (when the Automatic Demarcation/ Deactivation check box is checked, the value of this property is FALSE) |
type | Specifies the type of component.
For PowerBuilder objects, EAServer sets |
General |