Index

A

accessing data
configuration object life cycle, Configuration object life cycle
managed object life cycle, Managed object life cycle
minimizing state conflicts, Guidelines
active version, Versions
adminport, Deployment tool
annotations, Defining a managed object, Defining a system management target
@ByReference, By-Reference Fields
@ByValue, By-Value Fields
@Command, @Command annotation
@Default, @Default annotation
@KeyField, Constructors
@Managed, Defining a managed object
@ManagementTarget, @ManagementTarget annotation
@Parameter, @Parameter annotation
managed objects, Defining a managed object
system management, Defining a system management target
application data
data loss exposure, Failure exposure
partitioning, Defining and enabling partitions
applications
execution scope of, Application scope
monitoring, Monitoring applications
arrays
local copy of, Array copy-in/copy-out
ast.properties
locating, Locating the ast.properties file
supported properties, Defining a component
asynchronous methods, Asynchronous methods
overview, Asynchronous methods
restrictions, Asynchronous methods
atomic creates
determining whether object was selected or created, Atomic Create or Select
audit rules
@ByReference, Audit rules
@ByValue, Audit rules
authentication, Deployment tool

B

backup policies
failure exposure and, Failure exposure
buildtype, Deployment tool
by-reference field, By-Reference Fields
contained object life-cycle, Managed object life cycle
by-value field, By-Value Fields

C

class files
loading by deployment tool, Architecture
class path, Class resolution
class upgrades
overview, Online cluster upgrades
classes, Architecture
(see also class files)
com.kabira.platform.Transaction, Transaction boundaries
resolution, Class resolution
CLASSPATH, Class resolution
cluster upgrades, Cluster Upgrades, Putting it all together, Putting it all together
com.kabira.platform.ObjectMismatchTrigger, Changing a class
field mapping, Field mapping
final fields, Final fields
inheritance, Inheritance
java.io.Serializable, Changing a class
mapping errors, Mapping errors
no serialVersionUID, Versions
non-transparent, Non-transparent changes
not-allowed, Unsupported changes
object mismatch trigger, Object mismatch interface
serialVersionUID, Changing a class
transparent, Transparent changes
upgrade utility, Upgrade utility
code snippets, Code snippets
com.kabira.platform.ObjectMismatchTrigger, Changing a class
com.kabira.platform.ResourceUnavailableException exception, Unavailable node exceptions
com.kabira.platform.StateConflictError exception, State conflict
com.kabira.platform.swbuiltin.TransactionNotifier class, Notifiers
com.kabira.platform.Transaction class, Transaction boundaries
compensation, Notifiers
components, Components, Example, Example
ast.properties, Defining a component
configuration, Configuration
defining, Defining a component
notifiers, Notifiers
configuration, Configuration, Shared configuration objects, Shared configuration objects
active version, Versions
base classes, Defining configuration objects
ByGroupState key, Versions
date representation, Data Format
defining, Defining configuration objects
defining type, Configuration type
life cycle of, Configuration object life cycle
notifier, Notifiers
notifiers, Notifiers
object, Defining configuration objects
optional fields, Optional fields
restrictions, Restrictions
supported types, Supported field and array types
console (see TIBCO ActiveSpaces® Transactions Administrator)
constructor
distributed object, Constructors
constructors, Constructors
copytarget, Deployment tool
creating and deleting objects
and transaction isolation of extent, Locking and isolation
and transaction isolation of index, Locking and Isolation
configuration object life cycle, Configuration object life cycle
invalid reference after delete, Managed object life cycle
locking behavior, Locking and deadlocks
managed object life cycle, Managed object life cycle
current, Upgrade utility

D

data (see application data)
deadlocks
and automatic transaction replay, Transaction boundaries
and Java monitors, Interaction with Java monitors
avoiding, Transactional considerations
detection, Locking and deadlocks
eliminating distributed deadlocks, Guidelines
debug, Deployment tool, Upgrade utility
debugger, Debugging
example, Debugging example
remote debug port, Debugging
debugging, Debugging
(see also debugger)
enabling diagnostic output, Deployment tool
enabling server diagnostics, Deployment tool
enabling upgrade utility diagnostic output, Upgrade utility
JDWP support, Java Debug Wire Protocol
server process control, Deployment tool
deploy.jar, Architecture, Deployment tool
(see also deployment tool)
options, Deployment tool
options file, Options file
syntax, Deployment tool
deployment tool, Architecture
(see also deploy.jar)
adminport, Deployment tool
buildtype, Deployment tool
copytarget, Deployment tool
debug, Deployment tool
detach, Class resolution, Deployment tool
detachtimeout, Deployment tool
discoverytimeout, Deployment tool
displayversion, Deployment tool
domaingroup, Deployment tool
domainname, Deployment tool
domainnode, Deployment tool
exitonfailure, Deployment tool
hostname, Deployment tool
ignoreoptionsfile, Deployment tool
jvmname, Deployment tool
keepaliveseconds, Deployment tool
mirrorclient, Deployment tool
nodecleanup, Deployment tool
password, Deployment tool
remotedebug, Deployment tool
remotedebugport, Deployment tool
reset, Deployment tool
schedulerpolicy, Deployment tool
serverdebug, Deployment tool
serverdebugfilter, Deployment tool
serverdebugpause, Deployment tool
servicename, Deployment tool
shutdowntimeoutseconds, Deployment tool
suspend, Deployment tool
username, Deployment tool
detach, Deployment tool
detachtimeout, Deployment tool
discoverytimeout, Deployment tool
displayversion, Deployment tool
distributed computing, Distributed computing, Guidelines, Guidelines
guidelines, Guidelines
distributed objects
accessing a remote object, Remote objects
constructors, Constructors
global extents for, Extents
life cycle, Distributed object life cycle
non-replicated caching behavior, Remote objects
replicated caching behavior, Remote objects
distribution
architecture of, Architecture, Architecture
developing applications with, Developing distributed applications, Debugging, Debugging
method signature restrictions, Distributed method signature restrictions
overview, Distribution
domain
specifying for deploy.jar, Deployment tool
domain group
specifying for deploy.jar, Deployment tool
domain groups
executing applications on, Application scope
Domain Manager
nodes, domains, and the deployment tool, Architecture
domain node
specifying for deploy.jar, Deployment tool
domaingroup, Deployment tool
domainname, Deployment tool
domainnode, Deployment tool
domains
and the deployment tool, Architecture
executing applications on, Application scope
durable object store (see persistence)
overview, Durable object store

E

errors
due to inconsistent reset values, Highly available and distributed systems
stack dump using non-TIBCO ActiveSpaces® Transactions JVM, Deployment tool
exceptions
com.kabira.platform.ResourceUnavailableException, Unavailable node exceptions
com.kabira.platform.StateConflictError, State conflict
java.lang.IllegalAccessError, Transaction required exception
java.lang.NullPointerException, Managed object life cycle
Transaction.Rollback, Transaction boundaries
unchecked exceptions used to rollback transactions, Exception handling
unhandled exception handling, Exception handling
unhandled exceptions terminate transactions, Transaction boundaries
unhandled, JVM lifecycle and, Unhandled Exceptions
exit code
non-zero exit from unhandled exception, Unhandled Exceptions
exitonfailure, Deployment tool
extents, Extents, Locking and isolation, Locking and isolation
can return deleted object references, Locking and isolation
iteration and, Locking and isolation
locking and isolation, Locking and isolation

F

failover
ha timer behavior, Failover and migration
field mapping
ManagedObjectStreamClass class, Field mapping
ObjectInputStream.GetField and ObjectOutputStream.PutField classes, Field mapping
flush notifier, Flushing objects

G

garbage collection
managed objects vs Java proxy objects, Managed object life cycle
groupId
prohibited in configuration objects, Restrictions

H

HA (see high availability)
high availability, High availability, Failure exposure, Failure exposure
dynamically maintaining cluster wide partitions, Node state change notifiers
node state change notifiers, Node state change notifiers
overview, High availability
timers, Timers
high-availability
node initialization, Initializing or restoring a node
node restore, Initializing or restoring a node
highly available objects, Defining a partitioned object
hostname, Deployment tool

I

ignoreoptionsfile, Deployment tool
IGNORE_PARTITIONING, Defining a partition mapper
indexes
locking and isolation, Locking and Isolation

J

Java Debug Wire Protocol (see JDWP)
Java monitors, Interaction with Java monitors
avoiding use of, Transactional considerations
Java Native Interface (see JNI)
java.io.Serializable, Changing a class
java.lang.IllegalAccessError exception, Transaction required exception
java.lang.NullPointerException exception, Managed object life cycle
java.lang.reflect, Reflection limitations
java.util.Date, Supported field types, Supported field and array types
representation in a configuration file, Data Format
JDWP, Java Debug Wire Protocol
JNI, JNI transactional programming
JVM
input and output, System input and output
life cycle of, Java Virtual Machine, Unhandled Exceptions, Unhandled Exceptions
non-daemon threads and JVM shutdown, Shutdown
operator shutdown, Shutdown
Runtime.getRuntime().exit, Shutdown
shutdown, Shutdown
shutdown hooks, Shutdown, Shutdown Hooks
shutdown sequence timeout, Shutdown
stack dump using non-TIBCO ActiveSpaces® Transactions , Deployment tool
System.exit(), Shutdown
transactions can span multiple JVMs, Transaction thread of control
jvmname, Deployment tool

K

keepaliveseconds, Deployment tool
keys, Keys and Queries
@Key, @Key and @KeyList Annotations
@KeyList, @Key and @KeyList Annotations
Duplicate Keys, Duplicate Keys
inherited, Inherited Keys
key annotations, @Key and @KeyList Annotations
mutable, Mutable keys
ObjectNotUniqueError, Duplicate Keys
supported field types, Keys and Queries
unsupported field types, Keys and Queries
keys and queries
overview, Keys and queries

L

life cycle
of configuration objects, Configuration object life cycle
of managed objects, Managed object life cycle
lock promotion
avoiding promotion deadlocks, Transactional considerations
explicit locking used to prevent, Explicit locking
locking
of extents, Locking and isolation
of indexes, Locking and Isolation
locks, Locking and deadlocks, Explicit locking
(see also deadlocks)
(see also lock promotion)
explicit locking, Locking and deadlocks, Explicit locking
I/O, Transactional considerations
method execution, Locking and deadlocks
minimizing lock duration, Transactional considerations
minimizing resource contention, Transactional considerations

M

managed object annotation (see @Managed)
managed object flushing, Flushing objects
managed objects, Managed objects, Managed objects, Reflection limitations, Extents, Triggers, Reflection limitations
(see also extents)
(see also replicated objects)
(see also triggers)
asynchronous methods, Asynchronous methods
base classes, Defining a managed object
by-reference fields, By-Reference Fields
by-value fields, By-Value Fields
changing shape of, Reset
defining, Defining a managed object
distributed behavior, Distributed computing
equals, Equals and Hashcode
hashCode, Equals and Hashcode
inheritance, @Managed annotation
key restrictions, Key Restrictions
life cycle of, Managed object life cycle
named caches, Named caches
overview, Managed objects
persistent, Defining a managed object
restrictions, Restrictions
static classes, Static fields
static fields, Static fields
supported types, Supported field types
triggers, Triggers
ManagedObjectStreamClass, Versions
management console (see TIBCO ActiveSpaces® Transactions Administrator)
mirrorclient, Deployment tool
modifying field
locking behavior, Locking and deadlocks
monitoring applications, Monitoring applications, Object monitor, Object monitor
monitors, Object monitor
(see also object monitor)
multi-byte characters, Ordered
multi-master
simulation, Simulating a multi-master scenario

N

native libraries, Native libraries
node initialization
high-availability, Initializing or restoring a node
node state change notifiers, Node state change notifiers
nodecleanup, Deployment tool
nodes
access error if unavailable, Unavailable node exceptions
adding, Adding a node
executing applications on individual nodes, Application scope
restoring, Restoring a node
transactions can span multiple, Transaction thread of control
noDestinationTimeoutSeconds, Shutdown
non-transactional resources
integration with, Notifiers
notifier
flush, Flushing objects
notifiers, Notifiers
transaction, Notifiers

O

object monitor, Object monitor
partition display, Object monitor
object references
extent may include invalid, Locking and isolation
invalid after delete, Managed object life cycle
ObjectMismatchTrigger interface, Object mismatch interface
readObjectFromStream, Object mismatch interface
writeObjectToStream, Object mismatch interface
objects, Managed objects, Configuration
(see also configuration)
(see also managed objects)
optional configuration data, Optional fields
options file, Options file
jvmoptions, Default JVM properties
ordered queries
sort order, Ordered

P

partition
migration, Partition migration
object behavior in disabled partitions, Disabled partition behavior
transparent failover, Transparent failover
partition mapper, Defining a partition mapper
auditing, Defining a partition mapper
clearing, Defining a partition mapper
dynamic, Updating partition mapping
inheritance, Defining a partition mapper
Installation, Defining a partition mapper
partition property
broadcast partition definition updates, Defining and enabling partitions
force replication, Defining and enabling partitions
number of threads, Defining and enabling partitions
objects locked per transaction, Defining and enabling partitions
restore from node, Defining and enabling partitions
sparse partition audit, Defining and enabling partitions
partitioned objects
defining, Defining a partitioned object
life cycle, Partitioned object life cycle
restrictions, Restrictions
partitions
defining, Defining and enabling partitions
defining in configuration, Defining partitions using configuration
merging, Updating partition mapping
re-partitioning, Updating partition mapping
splitting, Updating partition mapping
updating mapping, Updating partition mapping
password, Deployment tool
performance
changing operating system scheduling policy, Deployment tool

Q

queries
@KeyField annotation, Constructors
atomic creates of unique keyed objects, Atomic Create or Select
atomic creates of uniquely keyed partitioned objects, Partitioned objects
atomic creates with inherited keys, Inherited keys
constructors, Constructors
general pattern, Queries
KeyFieldValueList, Queries
KeyFieldValueRangeList, Queries
KeyManager, Queries
KeyQuery, Queries
locking and isolation, Locking and Isolation
mapping constructor parameters, Constructors
non-unique key, Non-Unique
ordered, Ordered
query scope, Query Scope
QueryScope, Queries
range, Range
unique key, Unique

R

reading field
locking behavior, Locking and deadlocks
reference, Reference, Java Debug Wire Protocol, Java Debug Wire Protocol
reference cluster, Reference cluster
reflection, Reflection limitations
registration
of management targets, Target lifecycle
remote debug port, Debugging
remote objects
state conflict and, State conflict
remote references
discovering using distributed queries, Guidelines
remotedebug, Deployment tool
remotedebugport, Deployment tool
replacement, Upgrade utility
reset, Deployment tool
reset option, Reset, Highly available and distributed systems
restoring a node
high-availability, Initializing or restoring a node
restoring after a multi-master
created and deleted objects, Defining and enabling partitions
duplicate keys, Defining and enabling partitions
rollback
and explicit compensation, Notifiers
run method
to execute code in a transaction, Transaction boundaries
runtime objects, Runtime objects

S

schedulerpolicy, Deployment tool
secondary store, Secondary Stores, Chaining notifiers, Chaining notifiers
atomic create or select, Atomic create or select
chaining notifiers, Chaining notifiers
distributed and partitioned object modifications, Secondary Stores
distributed queries, Secondary Stores
extent notifier, Extent notifier
lifecycle, Lifecycle
query notifier, Query notifier
record notifier, Record notifier
result set ordering, Query notifier
transaction management, Transaction management
serialization errors, Mapping errors
serialVersionUID, Changing a class
serverdebug, Deployment tool
serverdebugfilter, Deployment tool
serverdebugpause, Deployment tool
service discovery, Deployment tool
servicename, Deployment tool
shutdowntimeoutseconds, Deployment tool
JVM shutdown timeout value, Shutdown
snippets, Code snippets
sort order, Ordered
multi-byte characters, Ordered
ssl.TrustManagerFactory.algorithm, Security
state conflicts, State conflict
minimizing, Guidelines
static fields
prohibited in managed objects, Restrictions
suspend, Deployment tool
switchadmin, Security
switchmonitor, Security
system management, System management, Example, Example
access control, Security
active principal executing command, Security
asynchronous commands, Synchronous and asynchronous execution
authentication, Security
synchronous commands, Synchronous and asynchronous execution
system management target
executes in JVM, Target lifecycle
System Properties
ssl.TrustManagerFactory.algorithm, Security
System.in, System input and output
System.out, System input and output

T

target
defining, Defining a system management target
threads
application shutdown and, Managing Threads
creation, Transaction thread of control
managing, Managing Threads
transaction span of, Transaction thread of control
transactions can span threads, Transaction thread of control
TIBCO ActiveSpaces® Transactions
JVM, What is TIBCO ActiveSpaces® Transactions ?
TIBCO ActiveSpaces® Transactions Administrator, Management console
timers, Timers
transaction
isolation level, Transaction isolation level
Transaction class (see com.kabira.platform.Transaction class)
transaction notifier
restrictions, Transaction notifier restrictions
transaction notifiers
execution location, Notifiers
Transaction.createdInTransaction(), Atomic Create or Select
Transaction.modifiedInTransaction(), Atomic Create or Select
Transaction.Rollback exception, Transaction boundaries
transactional classes
guidelines for use, Transactional considerations
use outside transaction illegal, Transaction required exception
TransactionNotifier class (see com.kabira.platform.swbuiltin.TransactionNotifier class)
transactions, Transactions, Transactional considerations, Transactional considerations
boundaries, Transaction boundaries
isolation of extents, Locking and isolation
isolation of indexes, Locking and Isolation
overview, Transactions
thread of control, Transaction thread of control
triggers, Triggers, Triggers
compensation, Triggers
compensation trigger, Triggers
delete, Triggers
delete trigger, Triggers
TrustManagerFactory, Security
X.509v3 algorithm, Security

U

unregister
of management targets, Target lifecycle
updating data (see accessing data)
upgrade plan, Upgrade utility
upgrade utility
current, Upgrade utility
debug, Upgrade utility
replacement, Upgrade utility
upgradefile, Upgrade utility
upgrade.jar, Upgrade utility
options, Upgrade utility
required directories, Upgrade utility
syntax, Upgrade utility
upgradefile, Upgrade utility
username, Deployment tool

V

VERIFY_DEFER_INSTALL, Defining a partition mapper
VERIFY_PARTIONING, Defining a partition mapper
versionId
prohibited in configuration objects, Restrictions

X

XA
integration with, Notifiers