Skip Headers

Oracle TopLink Developer's Guide 10g Release 3 (10.1.3) B13593-01 |
| Home | Solution Area | Contents

Previous |

# Index

A B C D E F G H I J K L M N O P Q R S T U V W X Z

## Symbols

  `<J2EE-Container>-jar.xml` file
    EJB 3.0, 8.1.4.3

## A

  access
    data access, 84
    direct, 35.16.1
    modifiers, 5.7.2.2
    optimizing data access, 11.10
    remote sessions, 75.9.2.1
  access method
    direct, 35.6
    generating, 5.5.3.2
    mappings, 35.6.1
    method, 35.6
    specifying, 35.16.1
  access modifiers, classes, 5.7.2.2
  acquiring
    client sessions, 78.4
    sessions, at runtime, 75.2.4
    unit of work, 101.1
  activating descriptors, 5.3.3
  Add Named Query dialog, 28.7.1.1, 28.7.1.6.1, 28.7.1.7.1
  Add New Class dialog, 5.7.1.1
  Add New Table button, 5.5.1.2
  Add or Refresh Class button, 5.7.3.1
  `addConstraingDependencies()`, 102.10.2
  address
    multicast group, 91.4
    multicast port, 91.5
  Add/Update Existing Tables from Database button, 5.5.1.3
  advanced properties for descriptors, 22.6
  After Load tab, 28.33.1
  aggregate collection relational mappings
    and EJB, 36.9.2
    configuring, 44
    understanding, 36.9
  aggregate descriptors
    about, 26.2.6
    aggregate object mapping, 26.2.6.1
    EIS projects, 26.2.6.2
    EJB 3.0, 26.2.6.1.1
    inheritance, 26.7.4
    relational projects, 26.2.6.1
    XML projects, 26.2.6.3
  aggregate object relational mapping
    aggregate descriptors, and, 26.2.6.1
  aggregate object relational mappings
    configuring, 47
    understanding, 36.12
  aggregation, isolated client sessions, 75.5.2
  `AllFieldsLockingPolicy`, 26.8.4
  allows none, 28.7.1.6.1, 97.7.1.1
  allows null, 28.7.1.6.1, 97.7.1.1
  amending descriptors, 2.9.2.1.1, 26.2.5, 28.33
    see also after load
  announcement delay, 91.9
  Ant, integrating with Oracle TopLink Workbench, 5.8
  any collection XML mappings
    configuring, 72
    understanding, 65.8
  any object XML mappings
    configuring, 71
    understanding, 65.7
  application development
    deploying, 10
    mapping, 2.9.2.1
    querying, 2.4.3.4, 74.5
    troubleshooting, 15
  application layer, remote sessions, 75.9.1.1
  application servers
    EJB support, customizing, 7.7
    integrating with Oracle TopLink, 7
    logging, 75.2.6.1.3
    optimization, 11.13
    setter parameter type checking, 7.7, 7.7.1
    single-object finder return type checking, 7.7, 7.7.3
    software requirements, 7.2.1
    target platforms, 2.2.2
    unknown primary key class support, 7.7, 7.7.2
  architectures
    application, 1.4
    BMP, 1.4, 2.14
    cache, 90.1
    choosing, 2.2
    CMP, 1.4, 2.13
    EIS, 2.2.1.4, 2.2.1.5, 56.2.7
    EJB entity beans, 1.4, 1.4, 2.13, 2.14
    EJB session bean facade, 1.4, 2.12, 2.12
    locking, 2.3.5, 2.3.5.1, 2.3.5.2
    optimistic locking, 2.3.5.1
    Oracle TopLink, 1.1
    pessimistic locking, 2.3.5.2
    selecting, 2.3
    session brokers, 75.7.1
    sessions, 75.2.1
    three-tier, 1.4, 2.10, 2.10
    two-tier, 1.4, 2.11, 2.11
    unit of work, 100.1
    web services, 1.4, 2.15
  arguments, binding in query, 29.4
  array
    dimensionality, 5.7.2.6.1, 5.7.2.10.1
    object-relational mappings, 49.4
  `AsOfClause`, 99.2
  asynchronous change propagation, 91.2
  `AttributeChangeTrackingPolicy`
    about, 100.2.3.3
    OC4J CMP integration, 100.2.3.3.1
    OC4J EJB 1.x CMP integration, 100.2.3.3.1
    OC4J EJB 2.x CMP integration, 100.2.3.3.1
    OC4J EJB 3.0 CMP integration, 100.2.3.3.1
    other application servers, 100.2.3.3.2
  attributes
    adding to descriptors, 5.7.2.5
    array dimensionality, 5.7.2.6.1, 5.7.2.10.1
    changes, tracking, 28.29.1.3
    final, 5.7.2.5.1, 5.7.2.9.1
    in TopLink Workbench, Navigator window, 5.3.3
    lazy loading. see fetch groups
    static, 5.7.2.5.1, 5.7.2.9.1
    transforming, 35.15, 35.15, 35.16, 35.16, 36.13
    transient, 5.7.2.5.1, 5.7.2.9.1
    unmapping, 34.5.1
    volatile, 5.7.2.5.1, 5.7.2.9.1
  Attributes tab, 5.7.2.4.1, 5.7.2.5.1, 5.7.2.8.1
  Attunity Connect platform, 84.1.3.1
  auditing
    authentication, 84.1.4.3
    unit of work, 102.12
  authentication
    about, 84.1.4
    auditing, 84.1.4.3
    proxy authentication, 84.1.4.2
    simple JDBC authentication, 84.1.4.1
    three-tier architecture, 84.1.4.2
    two-tier architecture, 84.1.4.1
  Automap, 34.3.1
  automapping descriptors
    about, 34.3
    see also mappings
  automatic table generation
    about, 33.2.3.2
    configuring, 8.7.1.3

## B

  Base64 encoded strings, 35.12.2
  batch options
    mappings, 37.4.1
    writing, 11.10.3
  batch reading
    in query objects, 98.2.1.9
    read optimization, and, 11.11.7
  batch writing
    about, 11.10.3, 11.11.8, 86.6.2
    dynamic, 11.10.3
    dynamic, `setMaxBatchWritingSize()`, 11.10.3
    MySQL4 platform, 86.6
    non-parameterized, 11.10.3
    parameterized, 11.10.3
    `setMaxBatchWritingSize()`, 11.10.3
  BEA WebLogic
    deploying to, 10.4.2
    deployment exceptions, 15.3
    modifying persistence descriptor, 8.8.1
    setting classpath, 7.4.1, 7.4.2
    setting shared library, 7.4.1, 7.4.2
    transport layer, 75.9.1.2
    using a security manager, 7.4.5
  beans
    session beans, 2.12.3
    stateful beans, 2.12.3
    stateless beans, 2.12.3
  bidirectional relationships
    about, 36.2.1
    generating, 5.5.3.2
    in one-to-one mappings, 35.18
    target keys, 36.5
    with indirection, 35.18
  `bindAllParameters()` method, 23.6
  bindings
    arguments, 29.4
    input paramters, 98.4.1.1
    JAXB, 20.5.1
    see parameter binding
  BMP
    and EJB 1.1, 2.14
    and EJB 2.0, 2.14
    and TopLink, 2.14
    deployment files, 8.6
    descriptors, 26.2.3, 28.17
    packaging for deployment, 9.5
  boolean logic in expressions, 97.2.1
  branch classes, 26.7, 26.7
  buttons. see toolbars
  Byte array Base64, 35.12.2

## C

  cache
    about, 2.4.3.3, 2.8.8, 90
    architecture, 90.1
    configuring, 90.2.3, 99.11.1
    coordination, 90.2.6, 91, 92, 93
    descriptor level, 28.12
    disabling during read query, 96.15.4
    distributed, 90.2.6
    expiration, 22.14, 28.15, 99.11.2
    expression limitations, 96.15.2.2
    identity maps, using, 75.8
    in-memory queries, 96.15.2.1, 96.15.2.2
    internal query object cache, 96.15.6, 96.15.7, 96.15.7.1, 99.11.1, 99.11.2
    invalidation, 22.14, 28.15, 90.2.3.4, 90.2.5
    isolated client sessions, 75.5.2
    isolation, 90.2.3, 90.2.7
    object cache, 96.15.7
    object cascading refresh, 96.15.5.2
    object refresh, 96.15.5.1
    optimizing, 11.9
    project level, 22.11
    queries, 90.2.2, 96.15
    query cache, 96.15.7
    `readObject` method, and, 98.1.1.1
    refreshing, 28.9, 90.2.4.1, 96.15.5.3
    restrictions, 96.15.7.1
    service channel, 91.3
    sessions, 75.2.1.1, 75.10, 90.1.1
    stale data, 90.2.3
    storing query results, 96.15.6, 96.15.6, 99.11.1
    type and size, 22.11, 28.12
    unit of work cache, 90.1.2
  cache coordination
    about, 90.2.6
    application server clustering, and, 7.2.5
    avoiding stale data, 90.2.3.5
    CMP projects, 8.7.1.2
    EJB Entity Beans with BMP architecture, and, 2.14.3.3
    explicit query refreshes, 90.2.4
    JMS, 92
    `orion-ejb-jar.xml`, 8.7.1.2
    packet time-to-live, 91.12
    permissions, 7.6.1.3
    RMI, 93
  cache invalidation, avoiding stale data, 90.2.3.4
  cache synchronization. see cache coordination
  `cacheAllStatements()`, 23.6
  `cacheQueryResults()`, 28.7.1.10
  cache-synchronization property, 8.7.1.2
  Caching tab, 28.12.1, 28.13.1, 28.14.1, 28.16.1
  call
    call queries, 96.9
    EIS, 98.6
    EJBQLCall, 98.5
    SQLCall, 98.4, 98.4.1
    StoredFunctionCall, 98.4.3
    StoredProcedureCall, 98.4.2
  Call finders
    creating, 99.9.2.1
    executing, 99.9.2.2
    using, 99.9.2
  `Call` object, queries, 96.2.1
  cascading
    object refresh, 96.15.5.2
    optimistic version locking, 26.8.2
    write queries, compared to non-cascading, 96.7.3.7, 98.2.2.3
  catalog, database, 5.5.1.2
  `catchExcpetions()`, 77.11
  change policy
    about, 28.29
    attribute change tracking, configuring, 28.29.1.3
    deferred change detection, configuring, 28.29.1.1
    empty transaction, 100.2.3
    object change tracking, configuring, 28.29.1.2
    unit of work, 100.2.3
  change tracking
    attribute, configuring, 28.29.1.3
    deferred, configuring, 28.29.1.1
    object, configuring, 28.29.1.2
  changed items, displaying in TopLink Workbench Navigator window, 5.3.3
  `ChangedFieldsLockingPolicy`, 26.8.4
  changing package names, 5.7.5
  `checkDatabase()`, 77.11
  checking in/out projects, 4.2.1
  `checkInstantiationPolicy()`, 77.11
  Choose a Schema Context dialog box, 31.2.1.1, 32.2.1.1
  Choose Query Key dialog box, 97.7.1.1
  Choose Relationships to Generate dialog box, 5.5.3.2, 5.5.3.2
  Choose Root Element dialog box, 31.3.1.1, 32.4.1.1
  class extraction method
    about, 26.7.1.2
    inheritance, 26.7.1.2
  class indicator
    about, 26.7.1
    class extraction method, 26.7.1.2
    class indicator field, 26.7.1.1, 41.2
  class loader
    host application, 2.2.2
    loading session, 78.3.2
  class modifiers, 5.7.2.2
  Class tab, 5.7.2.1.1, 5.7.2.2.1, 5.7.2.3.1
  classes
    access modifiers, 5.7.2.2
    adding and refreshing, 5.7.3.1
    branch, 26.7
    creating, 5.7.1.1, 5.7.5.1
    CursoredStream, optimizing, 99.10.5
    Database Exception, 98.7
    `DatabaseMapping`, 33.3
    default null values, 35.19
    DeleteObjectQuery, 98.2.2.1
    ExpressionBuilder, 97.7.2
    generating from database, 5.5.3.2
    InsertObjectQuery, 98.2.2.1, 98.2.2.1, 100.3.1.1.2
    interfaces, 5.7.2.3
    leaf, 26.7
    merging files, 4.2.2.2
    methods, adding, 5.7.2.8
    naming, 5.7.2.1.1
    non-descriptor classes, 5.7.4
    object model, 2.8.1
    Performance Profiler, 11.3.1
    persistent requirements, 2.4.2
    preferences, 5.4.4
    refreshing, 5.7.3.1
    removing, 5.7.3.1
    root, 26.7
    troubleshooting, 14.8
    tutorial, 16.2.1.1
    unit of work, 100.3.1.1.2
    UpdateObjectQuery, 98.2.2.1, 98.2.2.1, 98.2.2.3
    `ValueHolderInterface`, 2.4.2, 33.2.4.1, 36.8
    `VariableOneToOneMapping`, 36.6, 36.6
    see also specific class name
  classpath
    adding, 22.3.1
    BEA WebLogic, 7.4.1
    configuring, 5.2, 7.4.1, 7.5.1.1
    `connector.jar`, 5.2
    custom Collection class, 5.2
    `DRIVER_CLASSPATH`, Oracle TopLink Workbench, 5.2
    IBM WebSphere, 7.5.1.1
    J2C adapter, 5.2
    JDBC driver, 5.2, 5.5.1.3
    `JDBC_CLASSPATH`, 5.2
    Oracle TopLink Workbench `DRIVER_CLASSPATH`, 5.2
    relative, 22.3.1
    setting for BEA WebLogic, 7.4.2
    troubleshooting, 14.8
    `xdb.jar` file, 5.2
  class-table relationships, 16.2.2
  client sessions
    about, 75.1, 75.3, 75.7
    acquiring, 78.4
    configuration, 82.1
    example, 75.3.2.2
    shared resources, 75.3.2.1
  client-controlled transactions, 102.14.1
  client-server architecture. See two-tier
  clones
    copying methods, 28.28
    merging changes, 102.5
    post-commit, avoiding, 102.16.1
    unit of work, 100.1.1, 100.2.4
  Cloudscape platform, 84.1.3.1
  clustering, integrating TopLink with, 7.2.5
  CMP
    and EJB 1.1, 2.13
    and EJB 2.x, 2.13
    and EJB 3.0, 2.13
    and TopLink, 2.13
    `CMPPolicy`, 26.2.3, 28.17
    deploying, 8.5, 10.4
    descriptors, inheritance, 26.2.3.3
    external transactions, 100.1.2.3
    isolated client sessions, 75.5.2
    local transaction, 102.14.1, 102.14.2
    non-deferred write, 102.14.3
    OC4J persistence, 7.3.2
    packaging for deployment, 9.4
    setter parameter type checking, 7.7.1
    single-object finder return type checking, 7.7.3
    transaction attribute, 102.14.1
    unit of work, 100.1.2.3, 102.14
    unknown primary key class support, 7.7.2
  code generation, optimizing, 11.5
  collapsing items in Navigator window, 5.3.3
  collection class
    specifying, 98.2.1.6
    specifying in query objects, 98.2.1.6
  collections
    persistent requirements for mappings, 2.4.2
    query results, 96.5.1
  comments
    descriptors, 28.5.1, 28.6, 28.6.1
    mappings, 35.8
    projects, 22.15
  commit
    and Java Transaction API, 100.2.6.1, 100.2.6.1.1
    failure, resuming after, 102.6
    resuming unit of work after, 102.6
  Communication Exceptions, 13.11
  composite collection EIS mappings
    configuring, 61
    example, 56.6
    understanding, 56.6
  composite collection XML mappings
    configuration, 70.1
    configuring, 70
    understanding, 65.6
  composite descriptors
    about, 26.2.6
    composite object mapping, 26.2.6.2, 26.2.6.3
    EIS projects, 26.2.6.2
    XML projects, 26.2.6.3
  composite direct collection EIS mappings
    configuring, 59
    understanding, 56.4
  composite direct collection XML mappings
    configuring, 68
    understanding, 65.4
  composite EIS descriptors, 27.4.1.2
  composite object EIS mappings
    composite descriptors, and, 26.2.6.2
    configuring, 60
    understanding, 56.5
  composite object mappings
    composite descriptors, and, 26.2.6.3
  composite object XML mappings
    configuration, 69.1
    configuring, 69
    understanding, 65.5
  composite primary key, 36.8
  concrete class. see container policy
  concurrency
    about, 2.8.7
    exceptions, 13.2
    server session, 75.3.2.5
  Concurrency Exceptions, 13.2, 13.2
  configurations
    about, 76.2
    creating, 76.2.1
    development environment, 4.1
    new, 76.2.1
    Oracle JDeveloper, 4.1
    session, 76.2.1, 76.3.1, 76.4.1, 76.5.1, 76.6.1
  conforming
    about, 102.4
    alternatives, UnitOfWork method writeChanges, 102.4.4.1
    alternatives, UnitOfWork properties, 102.4.4.2
    descriptors, and, 102.4.3
    in-memory queries, 102.4.1.2
    queries, alternatives to, 102.4.4
  `ConnectBy`, 99.8.2.2
  connection policy
    configuring, 77.12
    exclusive connections, 77.12
    lazy connection acquisition, 77.12
  connection pool
    about, 84.1.6, 84.1.6
    connection count, 89.2
    ConnectionPolicy, 75.5
    external, 84.1.6.2
    internal, 84.1.6.1, 84.1.6.3, 84.1.6.3, 84.1.6.4, 84.1.6.5
    lazy connection allocation, 75.3.2.6, 78.4.6
    named, 84.1.6.5, 84.1.6.5
    parameter binding, 11.10.4
    prepared statement caching, 11.10.4
    read, 84.1.6.3
    sequence, 20.2.6, 84.1.6.4, 84.1.6.4
    server session, 75.3.2.6
    sessions, and, 75.2.1.2
    size, 89.2
    write, 84.1.6.3
  Connection Specifications tab, 24.3.1
  Connection tab, 24.3.1
  connections
    about, 84.1.5
    connection pool, 84.1.6
    exclusive write connection, 77.12
    lazy acquisition, 77.12
    reading through the write connection, 102.15.1.4
  `connector.jar`, 5.2, 20.4
  container configuration file, 8.1.4
  container policy
    about, 35.14
    custom Collection class, 5.2
    sorting, in memory, 35.14
  container-controlled transactions, 102.14.1
  context
    JAXB path, 20.5.1.3.2
    menus, 5.3.1.2
    schema, 31.2, 32.2
  `Context.SECURITY_CREDENTIALS`, 91.7.1
  `Context.SECURITY_PRINCIPAL`, 91.7.1
  Conversion Exception, 13.3
  Converter tab
    object type mappings, 35.11, 35.11.1
  converters
    custom, 36.2.2.2
    object type, 35.11, 35.11.1
  coordinated announcement delay, 91.9
  coordinated cache, 8.7.1.2
    configuring, 91
    naming service, 91.6
    service channel, 91.3
  copy policy
    about, 28.28
    method, 28.28
    setting, 28.28.1
  copying project objects, 4.2.3
  Copying tab, 28.28.1
  CORBA
    Oracle TopLink transport layer support, 75.9.1.2
    Transaction Service see OTS
  Create New Project button, 21.1.1.1
  Create New Project dialog box, 21.1.1.1
  Create New Session dialog, 76.4.1, 76.5.1, 76.6.1
  Create Project from JAXB dialog, 21.5.1
  Create Project from OC4J dialog, 7.3.2.2
  creating
    configurations, 76.2.1
    expressions, 97.7.1
    sessions, 76.4.1, 76.5.1, 76.6.1, 88.1.1
  Crimson XML parser, 7.2.2.2
  cursored streams
    example, 99.10.4.1
    optimizing, 99.10.5
    remote sessions, 75.9.2.5
    usage example, 75.9.2.5
  cursors
    as query results, 96.5.3
    traversing scrollable, 99.10.3.1
  custom SQL
    Custom SQL tab, 29.4.1
    unit of work, 102.9
  customization
    about, 12, 12.1
    data types, 12.2
    EIS, 12.1
    mapping extensions, 12.2
    overview, 2.6
    XML, 12.1

## D

  data access
    about, 84
    authentication, 84.1.4
    connection pool, 84.1.6
    connections, 84.1.5
    optimizing, 11.10, 11.10.2
    platforms, 84.1.3
  data level queries
    example, 97.6.2
    in expressions, 97.6
  data source platform
    about, 84.1.3
    Attunity Connect database, 84.1.3.1
    Cloudscape database, 84.1.3.1
    databases, 84.1.3.1
    DB2 database, 84.1.3.1
    EIS, 84.1.3.2
    HSQL database, 84.1.3.1
    Informix database, 84.1.3.1
    J2C adapter, 84.1.3.2
    JDBC drivers, 84.1.3.1
    Microsoft Access database, 84.1.3.1
    MySQL4 database, 84.1.3.1
    Oracle database, 84.1.3.1
    Oracle8 database, 84.1.3.1
    Oracle9 database, 84.1.3.1
    PointBase database, 84.1.3.1
    SQLAnyWhere database, 84.1.3.1
    SQLServer database, 84.1.3.1
    SybasePlatform database, 84.1.3.1
  data sources
    configuring, 85
    nontransactional, 84.1.1
    transactional, 84.1.1
    troubleshooting, 14.9
  Database Exceptions, 13.4, 98.7
  database fields, configuring, 37.2
  database functions, in expressions, 97.2.2
  database login
    parameter binding, 86.6
    prepared statement caching, 86.6
  Database Preferences, 5.4.6
  database queries
    about, 96.7, 98.2
    fetch groups, 96.7.1.5
    join reading, 96.7.1.4
    object level modify query, 96.7.3, 96.7.4
    object level read query, 96.7.1, 96.7.2
    partial object query, 96.7.1.3
    read all query, 96.7.1.2
    read object query, 96.7.1.1
    report query, 96.7.5
  database schema
    tables, 5.5.1.2
    tutorial, 16.2.2
  database sessions
    about, 75.1, 75.8
    cache, 75.10.1
    configuration, 83.1
    creating, 76.6
  database tables
    about, 5.5
    adding to database, 5.5.1.2
    creating, 5.5.1.2
    descriptors and classes, generating, 5.5.3.2
    EJB entity generation, 5.5.3.3
    fields, 5.5.2.1
    generating, 5.5.3.1, 5.5.3.2, 5.5.3.4
    importing, 5.5.1.3
    Java source generation, 21.9.4
    JDBC driver classpath, 5.5.1.3
    properties, 5.5.2
    references, 5.5.2.3, 5.5.2.4
    removing, 5.5.1.4
    renaming, 5.5.1.5
    schema, 5.5.1.2
    SQL generation, 5.5.3.1
    TopLink Workbench, Navigator window, 5.3.3
  `DatabaseException` class, 98.7
  `DatabaseLogin`, 84.1.2.1
  `DatabaseMapping` class, 33.3, 33.3
  `DatabaseQuery`, 96.2.2
  `DatabaseRow`, 36.13
  databases
    catalog, 5.5.1.2
    common problems, 14.9.1
    connect to, 5.5.1.1
    creating reference tables on, 5.5.2.3
    custom drivers, 5.4.6
    disconnect from, 5.5.1.1
    drivers, 5.4.6
    exceptions, 98.7
    fields, configuring, 37.2
    for project, 21.1.1.1
    Java type conversion, 6.1.1
    linking, 75.7.4.1
    log out of, 5.5.1.1
    logging into, 5.5.1.1, 23.5.1.1
    logins, 86
    mapping. See mappings
    platform, 21.1.1.1, 23.2, 24.2, 86.2, 87.2
    preferences, 5.4.6
    schema, 5.5.1.2
    schema manager, 6
    tables, 5.5
    TopLink Workbench, Navigator window, 5.3.3
    troubleshooting, 14.9.1
    type conversion, schema manager, 6.1.1
    using with Oracle TopLink Workbench, 5.5
  DatabaseSession class
    logging SQL and messages, 75.2.6.4
  DB2
    platform, 84.1.3.1
    schema manager type conversion, 6.1.1
  DBase platform, 84.1.3.1
  default mapping
    about, 33.2.3.2
    automatic table generation, and, 33.2.3.2, 33.2.3.2
    configuring, 8.7.1.3
    default table generator, 6.4
  Default Mapping Exception, 13.19
  default table generator
    default mapping, 6.4
    table creator, creating, 6.2.2
  defaults
    login level null values, 85.6
    mapping level null values, 35.5
    null values, 35.5, 35.19, 85.6
    optimization, 11.5
    root, 32.4
    see also preferences
  DefaultSequence, 86.4.2.1
  deferred change detection
    configuring, 28.29.1.1
  `DeferredChangeDetectionPolicy`, 100.2.3.1
  Delete All Interaction tab, 63.3
  `deleteObject()`, 29.4.1
  DeleteObjectQuery, 98.2.2.1
  deletes
    controlling order, 102.10
    delete operation, 98.1.2.5
    queries, EIS mappings, 63.3
  demarcation of unit of work transactions, 100.1.2
  dependent objects
    non-deferred write, 26.2.3.1
  deploy tool
    about, 10.7, 10.7
    troubleshooting, 10.7.2.1
    using with WebSphere Studio Application Developer, 10.7.2
  deploying
    about, 2.5, 2.5.1, 10
    application server requirements, 7
    BEA WebLogic, 10.4.2
    CMP applications, 10.4, 10.6.1
    database login, 23.5.1
    entity beans overview, 2.5.2
    generating XML for, 8.1.1.4
    hot deployment, 10.6, 10.6.1, 10.6.2
    IBM WebSphere, 10.4.3
    Java applications, 10.1
    JSP and Servlet applications, 10.2
    modifying BEA WebLogic persistence descriptor, 8.8.1
    non-CMP applications, 10.6.2
    packaging, 9
    Session Bean applications, 10.3
    troubleshooting, 15
  deployment descriptors, 26.2.3
  Deployment Exceptions, 13.13
  deployment exceptions
    BEA WebLogic deployment, 15.3
    Deployment Exceptions (14001-14033), 13.13
    IBM WebSphere deployment, 15.7
  deployment files
    BMP applications, 8.6
    CMP applications, 8.5
    creating, 8.1
    descriptors, 26.2.3
    EJB 3.0, 8.1, 9
    JARs, troubleshooting, 15.1
    Java applications, 8.2
    JSP and Servlet applications, 8.3
    Session Bean applications, 8.4
    XML, generating, 8.1.1.4
  deployment XML, exporting, 21.9.1
  `DeploymentXMLGenerator`, 8.1.1.5
  Descriptor Event Listener, 28.24
  Descriptor Event Manager
    about, 26.2.7
    Descriptor Event Listener, 28.24, 28.24
    domain object methods, 28.23
    event types, 28.23
    handlers, 26.2.7, 28.23, 28.24
    handlers, Descriptor Event Listener, 28.24
    understanding, 26.2.7
  descriptor events
    about, 26.2.7
    Descriptor Event Listener, 28.24
    domain object methods, 28.23
    handlers, 26.2.7, 28.23, 28.24, 28.24
    types of, 28.23
    understanding, 26.2.7
  Descriptor Exceptions, 13.1, 13.5
  Descriptor Info tab, 28.2.1, 28.3.2, 28.4.1, 29.2.1, 29.3.1, 31.2.1, 31.3.1, 31.3.1, 32.2.1, 32.3.1, 32.3.1, 32.4.1, 32.4.1, 32.5.1
  DescriptorEventListener, 28.24
  descriptors
    about, 19.1.2, 19.1.2, 26
    advanced properties, default, 22.6
    aggregate, 26.2.6, 27.2.1.2
    aggregate, EJB 3.0 and, 26.2.6.1.1
    aggregate, relational projects and, 26.2.6.1
    amending, 2.9.2.1.1, 26.2.5, 28.33
    API, 26.9
    architecture, 26.2.1
    attributes, adding, 5.7.2.5
    automapping, 34.3
    automatically mapping, 34.3
    BMP, 26.2.3, 28.17
    cache refreshing, 28.9
    change policy, 28.29
    child inheritance, 28.19
    class, 27.2.1.1
    CMP, 26.2.3, 28.17
    CMPPolicy, 26.2.3, 28.17
    comments, 28.5.1, 28.6, 28.6.1
    composite, 26.2.6, 26.2.6.2, 26.2.6.3, 27.4.1.2
    composite EIS, 27.4.1.2
    configuring, 28, 28.1
    conforming, 102.4
    creating, 27, 27.2.1.1, 27.2.1.2, 27.4.1.1, 27.4.1.2
    custom EIS interactions for basic persistence, 31.5
    custom SQL queries for basic persistence, 29.4
    deactivating, 5.3.3
    default mappings, 33.2.3.2
    default root, 31.3.1
    deployment information, 26.2.3
    Descriptor Event Listener, 28.24, 28.24
    domain object methods, 28.23
    EIS, 26.5, 27.4.1.1, 27.4.1.2, 31
    EIS projects, 26.2.6.2
    EJB, 26.2.3, 28.17
    EJB information, 26.2.3, 26.2.3, 28.17
    errors, 5.3.3, 5.3.5, 14.3
    event handlers, 26.2.7, 28.23, 28.24, 28.24
    events, 26.2.7, 26.2.7, 28.23
    existence checking, 11.7, 28.16
    fetch groups, 28.32
    files, merging, 4.2.2.2
    generating from database, 5.5.3.2
    hierarchy, inheritance, 26.9.1
    history policy, 28.30
    identity maps, 22.11, 28.12, 28.12, 28.13, 28.14
    in Java, 26.9
    inactive, 5.3.3
    inheritance, 26.2.2, 26.7, 28.19, 28.20
    instantiation, 11.7
    interface, 27.2.1.3, 28.10, 28.11
    mapping, 28.2.1, 29.2.1, 33.2.3.2, 34.2, 34.3
    merging, 4.2.2.2
    named queries, 28.7
    nondescriptor classes, 5.7.4
    object-relational, 26.4, 30
    optimizing, 11.7, 11.7
    parent inheritance, 28.20
    projects, 19.1.2, 26.1
    query key interfaces, 28.10
    query timeout, 28.7.1.10, 28.8
    read only, 28.3
    registering with sessions, 75.2.10, 77.2, 77.2.2, 77.5.2
    relational, 26.3, 27.2.1.1, 27.2.1.2, 27.2.1.3, 29
    removing, 5.7.3.1
    returning policy, 28.26
    root EIS, 27.4.1.1, 27.4.1.1
    root element, 32.4
    schema context, 31.2, 32.2, 32.3
    sequencing, 26.2.9, 29.3
    TopLink Workbench, Navigator window, 5.3.3
    types of, 26.1
    validating, 27.6
    XML, 26.6, 32
    XML projects, 26.2.6.3
  detachment indirection, 33.2.4.5.1
  developing applications with Oracle TopLink, 2
  development environments
    about, 3.1
    configuring, 4.1
    database logins, 23.5.1
  development process
    about, 2.1
    additional support, 2.1.2
    stages of, 2.1.1
    with Oracle TopLink, 2.1
  development tools
    about, 3
    profiler, 11.3
    schema manager, 6
  dimensionality, array, 5.7.2.6.1, 5.7.2.10.1
  direct access
    about, 22.4, 35.6
    specifying, 35.16.1
  direct collection relational mappings
    configuring, 45, 45.1
    example, 36.10
    understanding, 36.10
  direct collections
    session broker limitations, 75.7.3.1
  direct EIS mappings
    configuring, 58
    understanding, 56.3
  direct field
    in direct collection mappings, 45.3
  direct key fields, 46.3
  direct map relational mappings
    configuring, 46, 46.1
    direct keys, 46.3
    direct value, 46.2
    understanding, 36.11
  direct mappings
    generating deprecated, 22.10
    with EJB, 36.2.3
  direct value fields, 46.2
  direct XML mappings
    configuring, 67
    understanding, 65.3
  directionality in mappings, 36.2.1
  direct-to-field mappings
    ObjectTypeMapping deprecated, 36.2.2.2
    SerializedObjectMapping deprecated, 36.2.2.2
    type conversions, 37.2
    TypeConversionMapping deprecated, 36.2.2.2
  direct-to-field relational mappings
    configuring, 38
    options, 38.1
    timestamp support, 37.2
    understanding, 36.3
  direct-to-XMLType relational mappings
    configuring, 39
    understanding, 36.4
  Discovery Exception, 13.20
  DMS profiler
    about, 11.4, 75.2.7.2
    accessing with JMX, 11.4.2
    and JMX
    nouns, 11.4, 75.2.7.2
    selecting, 77.6.1, 77.8.1, 77.10.1, 77.12.1
    sensors, 11.4, 75.2.7.2
  document information in XML schemas, 5.6.2, 5.6.4.1, 5.6.5.1
  documentation
    hosted, 5.4.2
    See also Help
  does exist write object, 11.11.8
  `dontOptimizeDataConversion()`, 11.10.2
  `doPrivileged()`, 7.2.3
  `DRIVER_CLASSPATH`
    Oracle TopLink Workbench environment, 5.2
  drivers, custom database, 5.4.6
  dynamic batch writing
    about, 11.10.3
    `setMaxBatchWritingSize()`, 11.10.3
  dynamic fetch groups, querying with, 99.3.3

## E

  Editor window, about, 5.3, 5.3.4
  EIS
    about, 20.4
    architecture, 2.2.1.4
    call, 98.6
    custom interactions for basic persistence, per descriptor, 31.5
    indexed records, configuring, 31.4
    interactions, 31.5, 96.2.8.4, 98.6
    mapped records, configuring, 31.4
    mappings, 20.4, 56.2
    projects, 21.1.1.1
    queries, 96.2.8.4
    record format, configuring, 31.4
    XML records, configuring, 31.4
  EIS descriptors
    composite, 27.4.1.2
    configuring, 31
    default root, 31.3.1
    locking policy, 28.25
    root descriptor, 27.4.1.1
    schema context, 31.2
    `setDataTypeName`, 31.3.2
    understanding, 26.5
  EIS mappings
    about, 56, 56.2
    architecture, 56.2.7
    composite collection, 56.6, 61
    composite direct collection, 56.4, 59
    composite object, 56.5, 60
    configuring, 57
    direct, 56.3, 58
    jaxb:class support, 56.2.4
    list support, 56.2.3
    one-to-many, 56.8, 63
    one-to-many, key on source, 56.8.1
    one-to-many, key on target, 56.8.2
    one-to-one, 56.7, 62
    one-to-one, key on source, 56.7.1
    one-to-one, key on target, 56.7.2
    transformation, 56.9, 64
    types of, 56.1
    union support, 56.2.3
    xsd:list, 56.2.3
    xsd:union, 56.2.3
  EIS projects
    configuring, 24
    `connector.jar`, 20.4
    indexed records, 20.4.2
    mapped records, 20.4.2
    sequencing, 20.2.6
    understanding, 20.4
    XML records, 20.4.1
  EIS queries, 96.2.8.4
  EIS record types, supported, 56.2.1
  `EISLogin`, 84.1.2.1
  EJB
    descriptors, 21.8.1
    isolated client sessions, 75.5.2
    setter parameter type checking, 7.7
    single-object finder return type checking, 7.7
    unknown primary key class support, 7.7
  EJB 1.1
    and BMP, 2.14
    and CMP, 2.13
  EJB 1.x
    indirection, 33.2.4.5.2
    serialization, 33.2.4.5.2
  EJB 2.x
    and BMP, 2.14
    and CMP, 2.13
    default mapping, 33.2.3.2
    indirection, 33.2.4.5.2
    serialization, 33.2.4.5.2
  EJB 3.0
    `<J2EE-Container>-jar.xml` file, 8.1.4.3
    and CMP, 2.13
    attribute change tracking policy, OC4J CMP integration, 7.3.1, 100.2.3.3.1
    Bean annotation, fetch=lazy, 33.2.4.4.1
    default mapping, 33.2.3.2
    deployment files, 8.1, 9
    deployment files, OC4J CMP integration, 7.3.1
    detachment, 33.2.4.5.1
    Embedded annotation, 26.2.6.1.1
    packaging for deployment, 9
    packaging, OC4J CMP integration, 7.3.1
    `projects.xml` file, 8.1.1.6, 8.1.3.1
    serialization, 33.2.4.5.1
    `sessions.xml` file, 8.1.2.4
    `toplink-ejb.xml` file, 8.1.5.4
    value holder indirection, 33.2.4.4.1
  EJB descriptors, opening projects with, 21.8.1
  EJB entities
    BMP indirection, 33.2.4.4.3
    CMP hot deployment, 10.6.1
    deployment overview, 2.5.2
    EJB 1.x indirection, 33.2.4.4.3
    EJB 2.x indirection, 33.2.4.4.2
    EJB 3.0 indirection, 33.2.4.4.1
    generating, 5.5.3.3
    hot deployment, 10.6, 10.6.1, 10.6.2
    indirection, 33.2.4.4.3
    inheritance, 26.2.3.3, 26.7.5
    inserting after `ejbCreate`, 26.2.3.2
    inserting after `ejbPostCreate`, 26.2.3.2
    mapping, 22.5
    non-CMP hot deployment, 10.6.2
    non-deferred write, understanding, 26.2.3.1, 102.14.3
    sequencing, 20.7.4
  EJB entity beans
    and EJB 1.1, 2.13, 2.14
    and EJB 2.x, 2.13, 2.14
    and EJB 3.0, 2.13
    with BMP architecture, 1.4, 1.4, 2.14
    with CMP architecture, 1.4, 1.4, 2.13
  EJB Exception Factory Exceptions, 13.10
  EJB finders
    about, 96.14
    Call finders, 96.14.3, 99.9.2
    creating, 99.9.1
    DatabaseQuery finders, about, 96.14.4
    default finders, about, 96.14.2
    default finders, creating, 99.9.1
    EJB QL finders, about, 96.14.8
    `ejb-jar.xml` options, 99.9.1.1
    ejbSelect method, 96.14.11
    ejbSelect, creating, 99.9.10
    ejbSelect, using, 99.9.10
    expression finders, about, 96.14.7
    named query finders, about, 96.14.5
    predefined, about, 96.14.1
    primary key finders, about, 96.14.6
    redirect finders, about, 96.14.10
    redirect finders, using, 99.9.9
    single-object finder return type checking, 7.7
    SQL finders, about, 96.14.9
  EJB Info tab, 28.17.1
  EJB JAR XML Exception, 13.25
  EJB QL
    exceptions, 13.8
    queries, 29.4, 96.2.8.2
    query language, 96.2.8.2
  EJB session bean facade architecture
    about, 1.4, 1.4, 2.12
    understanding, 2.12
  EJB Session Beans, 75.9.1.2
  `ejbc`
    about, 10.4.2
    troubleshooting, 10.4.2.1
  `ejbCreate`, 26.2.3.2
  `ejb-jar.xml` file
    about, 8.1.3, 21.10
    configuring, 8.1.4
    corresponding to Oracle TopLink Workbench functions, 21.10
    EJB finder options, 99.9.1.1
    location, 22.5.1
    managing, 4.2.4
    preferences, 5.4.5
    synchronization under EJB 2.0, 8.1.3
    updating from, 21.10.2
    writing, 21.10.1
  `ejbPostCreate`, 26.2.3.2
  @Embeddable, 26.2.6.1.1
  @Embedded, 26.2.6.1.1
  empty unit of work transactions, 100.2.3
  encrypting login passwords, 21.9
  enhanced validation exceptions, 8.1.2.1
  Enterprise Information Systems. see EIS
  entity beans
    deployment, 2.5.2
    descriptor information, 26.2.3
    direct mappings, 36.2.3
    indirection, BMP, 33.2.4.4.3
    indirection, EJB 1.x, 33.2.4.4.3
    indirection, EJB 2.x, 33.2.4.4.2
    indirection, EJB 3.0, 33.2.4.4.1
    sequencing with, 20.7.4
  environment
    configuring, 5.2
    `JAVA_HOME`, 5.2
    `JDBC_CLASSPATH`, 5.2
    proxy, 5.4.1, 5.4.2, 21.10.2
  error codes
    1-176, 13.1
    1-176, 13.1, 14.1, 14.2, 14.4, 14.5, 14.6, 14.7
    200-399, 14.3
    10001-10047, 13.10
    12000-12004, 13.11
    13000-13020, 13.12
    14001-14027, 13.13
    15001-15024, 13.14
    17001-17006, 13.15
    18001-18002, 13.17
    19001-19003, 13.18
    22001-22004, 13.20
    22101-22105, 13.21
    3001-3007, 13.3
    4002-4018, 13.4
    5001-5008, 13.5
    6001-6098, 13.6
    7001-7104, 13.7
    72000-72023, 13.25
    8001-8010, 13.8
    9000-9009, 13.9
  errors
    about, 13
    codes and descriptions, 13, 14.1
    descriptors, 5.3.3, 5.3.5
    migration, 7.3.2.5
    Oracle TopLink Workbench, 14
  Event Manager, 75.2.5
  events
    about, 26.2.7, 26.2.7
    client session, 75.2.5.1
    database access, 75.2.5.1
    Descriptor Event Listener, 28.24
    domain object methods, 28.23
    handlers, 26.2.7, 28.23, 28.24
    listeners, sessions, 75.2.5.2
    session, 75.2.5
    session manager, 75.2.5.1
    sever session, 75.2.5.1
    types of, 28.23
    unit of work, 75.2.5.1
  examples
    composite collection EIS mapping, 56.6
    context menu, 5.3.1.2
    cursored streams, 99.10.4.1
    direct collection mappings, 36.10
    direct-to-field mappings, 36.3
    exception handler, 77.7.2
    indirection, 33.2.4
    inheritance, 26.7
    Oracle TopLink Workbench, 5.3
    performance optimization, 11.11.7.2, 11.11.7.4
    proxy indirection in code, 35.3.2.5
    READALL finders, 99.9.2.1, 99.9.2.2, 99.9.2.2, 99.9.3, 99.9.6
    report query, 98.2.1.3
    scrollable cursors, 99.10.3.1
    serialized mapping, 33.2.6.1
    stored procedure call, 98.4.2.1, 98.4.2.2, 98.4.2.3
    transformation mapping, 36.13
    transformation XML mapping, 56.9, 65.9
    Unit of Work, 100.2.2, 101.6
    write, write all, 98.1.2.1
  exception handler
    about, 75.2.9
    example, 77.7.2
    selecting, 77.7.1
  exceptions
    chained, 75.2.6.5
    communication exceptions, 13.11
    conversion exceptions, 13.3
    database exceptions, 13.4, 98.7
    Default mapping exception, 13.19
    deployment exceptions, 13.13
    descriptor exceptions, 13.1, 13.1
    discovery exceptions, 13.20
    EJB exceptions factory, 13.10
    EJB JAR XML exceptions, 13.25
    EJB QL exceptions, 13.8
    enhanced validation, 8.1.2.1
    `java.security.AccessControlException`, 15.7, 15.7
    JMS processing exceptions, 13.17
    Migration utility exception, 13.24
    optimistic locking, 13.5
    query exceptions, 13.6
    remote command manager exceptions, 13.21
    SDK data store exceptions, 13.15
    SDK descriptor exceptions, 13.18
    selecting exception handler, 77.7.1
    session loader exceptions, 13.9
    synchronization exceptions, 13.14
    Transaction exception, 13.22
    validation exceptions, 13.7
    XML conversion exception, 13.23
    XML data store exceptions, 13.12
  exclusive connections
    about, 102.15.1.4.3
    internal read connection pool, 89.6
    isolated sessions, 75.5, 77.12
    named queries, 28.7.1.10
  existence checking, 102.1.4
    descriptors, 28.16
    projects, 22.7
  expanding items in Navigator window, 5.3.3
  expiration of objects in the cache, 22.14, 28.15
  explicit query refreshes, cache coordination, 90.2.4
  exporting
    deployment XML, 21.9.1
    Java model, 21.9.2
    Java source, 21.9.3
    preferences, 5.4
    projects, 21.9
  Expression Builder, 97.7.1, 97.7.2
  Expression Builder dialog box, 97.7.1
  `Expression` class, 97.1
  `ExpressionMath` class, 97.1
  expressions
    about, 96.2.6, 97, 97.1
    allows none, 28.7.1.6.1, 97.7.1.1
    allows null, 28.7.1.6.1, 97.7.1.1
    building, 97.7.1
    comparing with SQL, 97.1.1
    components, 97.2, 97.2
    creating, 97.7
    data level queries, 97.6
    database functions, 97.2.2
    in relationships, 97.2.7
    in-memory queries, limitations, 96.15.2.2
    mathematical functions, 97.2.3
    multiple, 97.5
    one-to-one mappings, 97.2.6
    outer joins, 98.2.1.10
    parallel expressions, 97.5.2
    parameterized, 97.3
    platform functions, 97.8
    query keys, 97.4
    subqueries and subselects, 97.5.1
    user-defined functions, 97.2.5, 97.8
    using Boolean logic, 97.2.1
    XML Type functions, 97.2.4
    see also queries
  external
    applications, 102.15.1.1
    connection pools, 84.1.6.2
    controller, transaction, 100.1
    JDBC pools, 2.14.3.1
    transactions, 100.1, 100.1
  external transaction controller
    configuration, sessions, 77.9
    session, 100.1.2

## F

  factory name, JMS connection, 92.3
  failure, resuming unit of work after commit, 102.6
  features of Oracle TopLink, 1.3
  fetch groups
    about, 26.2.4, 28.32
    configuring, 28.32, 99.3.1
    default, 28.32, 99.3.1
    disabling, 99.3.1
    dynamic, 99.3.3
    object level read query, 96.7.1.5
    read optimization, and, 28.32
    size, 11.11.5
    static, 99.3.2
  @Bean fetch=lazy, 33.2.4.4.1
  field references, 37.6
  Field uses XML Schema "type" attribute option, 33.2.6.4
  fields in database tables, 5.5.2.1
  Fields tab, 47.3.1
  field-to-object attribute transformation, 35.15, 35.16
  files
    JAXB-specific, 20.5.1.1
    TopLink-specific, 20.5.1.2
    see also specific file name
  final attributes, 5.7.2.5.1, 5.7.2.9.1
  `findAll`, using, 96.14.4
  finders
    caching options, 96.15.8.1
    disabling cache, 96.15.8.2
    managing large result sets, 99.10.6
    refreshing results, 96.15.8.3
    see also EJB finders
  flashback queries
    about, 96.9.1.4.3
    historical client sessions, 81.1.1
  `forceUpdateToVersionField()`, 102.11
  foreign keys
    about, 2.8.5, 37.6
    configuring in EIS mappings, 62.2
    EIS mappings, 63.2
    multiple tables, 29.7.1
    one-to-many mappings, 36.7
    one-to-one mappings, 35.18, 36.5
    parameterized expressions, 97.3
    references, 14.4, 14.6
    target, 36.5, 37.6
    troubleshooting, 14.4, 14.6
  full identity map, 90.2.1.1

## G

  garbage collection, managing, 101.7.1
  General Preferences dialog, 5.4.1
  Generate Classes and Descriptors dialog, 5.5.3.2
  Generate EJB Entity Classes and Descriptors dialog, 5.5.3.3
  generating
    access method, 5.5.3.2
    deployment JARs, troubleshooting, 15.1
    deprecated direct mappings, 22.10
    see also exporting
  `getCatalogs()`, 5.5.1.3
  `getField()`, 97.6.1
  `getImportedKeys()`, 5.5.1.3
  `getParameter`, 97.3.1
  `getPrimaryKeys()`, 5.5.1.3
  `getTable()`, 97.6.2
  `getTables()`, 5.5.1.3
  `getTableTypes()`, 5.5.1.3
  `getValue()`, 33.2.4.1
  `getValue()` method, 33.2.4.1

## H

  hard cache weak identity map
    about, 90.2.1.3
    when to use, 90.2.1.6
  help
    about, 5.3.6
    displaying, 5.3.6
  Help button., 5.3.6
  Help Preferences, 5.4.4
  hierarchical queries
    about, 96.9.1.4.2
    described, 99.8.2
  hints, Oracle Hints in queries, 96.9.1.4.1
  historical client sessions
    about, 75.1, 75.6
    cache, 75.10.3
    limitations of, 75.6.1
  historical queries, 99.2
    about, 96.11
    see also AsOfClause
  history policy, configuring, 28.30
  holders, value, 33.2.4.1
  host URL, JMS topic, 92.4
  hosted
    documentation, 5.4.2
    XSD files, 8.1.1.1, 8.1.2.1
  hot deployment
    about, 10.6
    CMP applications, 10.6.1
    non-CMP applications, 10.6.2
  HSQL platform, 84.1.3.1

## I

  IBM Informix Database native sequencing, 20.7.2.6
  IBM WebSphere
    deploy tool, 10.7
    deploying to, 10.4.3
    deployment exceptions, 15.7
    setting classpath, 7.5.1.1
  identity
    about, 2.8.3, 90.2.1
    cache, and, 90.2.1
    using cache to preserve, 90.2.1
    see also identity map
  identity map cache
    disabling during a write query, 98.2.2.4
    refresh in read query, 96.15.5.3
  identity maps
    about, 28.12, 28.13, 28.14, 75.8
    cascading refresh during read query, 96.15.5.3
    descriptors, 22.11, 28.12
    example, 96.15.5.3
    full, 90.2.1.1
    guidelines for choosing type, 90.2.1.5
    hard cache weak identity map, 90.2.1.3, 90.2.1.6
    isolated client sessions, 75.5.2
    no identity map, 90.2.1.4
    refreshing during read query, 96.15.5.3
    soft cache weak identity map, 90.2.1.3, 90.2.1.6
    soft cache weak identity map and read optimization, 11.11.7
    specifying, 28.12, 28.13, 28.14
    weak, 90.2.1.2
    weak identity map and read optimization, 11.11.7
  Identity tab. see Caching tab
  impedance mismatch, solving, 1.2
  Implementors tab, 28.11
  Import Tables from Database dialog, 5.5.1.3
  importing
    classes, 5.4.4
    preferences, 5.4
  inactive descriptors
    about, 5.3.3
    mapping to, 37.3.1, 57.2.1
  independent relationships, 35.7
  indexed records, 56.2.1.1
  indirection
    about, 2.8.10, 33.2.4, 33.2.4
    bidirectional relationships, 35.18
    choosing the correct type, 35.3
    configuring, 35.3
    EJB, 33.2.4.4
    EJB 1.x CMP, 33.2.4.4.3
    EJB 2.x CMP, 33.2.4.4.2
    EJB 3.0 CMP, 33.2.4.4.1
    example, 33.2.4
    many-to-many mappings, 36.8
    nontransparent, 2.4.2
    one-to-many mappings, 35.18
    proxy indirection, 33.2.4.3
    remote sessions, 75.9.2.4
    serialization, 33.2.4.5
    transparent, 2.4.2, 33.2.4.2
    value holder, 33.2.4.1
    `ValueHolderInterface`, 2.4.2
    see also proxy indirection, transparent indirection
  Informix platform, 84.1.3.1
  inheritance
    about, 2.8.6, 26.2.2, 26.7
    aggregate classes, 26.7.4
    aggregate collection mappings, 36.9.1
    branch classes, 26.7, 26.7
    child descriptors, 28.19
    class extraction, 26.7.1.2, 26.7.1.2
    class indicator, 26.7.1, 26.7.1.2
    descriptors, 26.2.2, 26.7, 28.19, 28.20
    finding subclasses, 26.7.1
    instantiating subclasses, 26.7.1
    isolated client sessions, 75.5.2
    leaf classes, 26.7, 26.7, 99.5
    primary keys, 26.7.2
    queries, 96.12
    querying on hierarchy, 99.5
    relational parent, 28.20
    root class, 26.7, 26.7, 28.19.1, 28.20.1
    root class subclasses, finding in inheritance, 26.7.1
    supporting with multiple tables, 26.7.3.2
    supporting with one table, 26.7.3.1
    transformed to relational model, 11.6.3
    using with EJB, 26.2.3.3, 26.7.5
  inheritance hierarchies
    descriptors, 26.9.1
    querying on, 99.5
  Inheritance tab, 28.19.1, 28.20.1
  inherited subclasses, mapping, 28.22
  in-memory query
    about, 90.2.2
    check cache using exact primary key, 96.15.2.1
    check cache using primary key, 96.15.2.1
    check database if not in cache, 96.15.2.1
    conform results in unit of work, 96.15.2.1
    conforming, 102.4.1.2
    expression limitations, 96.15.2.2
    supported, 96.15.2.1
    using, 96.15.2.1
  inner join, 97.2.7.1
  insert operation, 98.1.2.1, 98.1.2.3
  `insertObject()`, 29.4.1
  instantiation policy
    about, 28.27
    setting, 28.27.1
  Instantiation tab, 28.27.1
  integrity checker, 27.6
    about, 75.2.8
    configuring, 77.11
  interactions
    about, 98.6
    creating, 31.5
  interface alias
    about, 29.5
    creating, 29.5.1
  Interface Alias tab, 29.5.1
  interfaces
    classes, implementing, 5.7.2.3
    customizing, 5.4.1
    descriptors, 27.2.1.3, 28.10, 28.11
    queries, 96.12
    query keys, 28.10
    querying on, 99.4
  internal connection pool
    about, 84.1.6.1
    named, 84.1.6.5
    read, 84.1.6.3
    sequence, 84.1.6.4
    write, 84.1.6.3
  internal query object cache
    about, 96.15.7
    configuring, 99.11.1, 99.11.2
    expiration, 99.11.2
    restrictions, 96.15.7.1
  internal transactions, 100.1
  invalidation of objects in the cache, 22.14, 28.15, 90.2.5
  IP address for multicast group, 91.4
  isolated client sessions
    about, 75.1, 75.5, 80
    configuration, 80.1
    life cycle, 75.5.1.3
    limitations of, 75.5.2
    session event handlers, 75.5.1
    with Oracle Virtual Private Database (VPD), 75.5.1
  isolated session
    cache, 75.10.2
    ConnectionPolicy, 75.5
    exclusive connections, 75.5
    supported databases, 75.5
  isolation
    cache, 90.2.3
    transaction levels, 100.1
    unit of work transactions, 100.1.3
  Iterator interface, 99.10.3

## J

  J2C adapters
    about, 84.1.3.2
    configuring for Oracle TopLink Workbench, 5.2
    `EISLogin`, 84.1.2.1
    selecting, 84.1.3.2
    with EIS, 21.1.1.1
  J2EE, 8.1.4
    parameter binding, 11.10.4
    prepared statement caching, 11.10.4
    web applications, 1.4
  Java
    database tables, 21.9.4
    exporting to, 21.9.3
    integration with any datasource, 1.2
    iterators, 99.10.3
    object model, 2.4
  Java applications
    deploying, 10.1
    deployment files, 8.2
    packaging for deployment, 9.1
  Java Cryptography Extension, 21.9
  Java Management Extensions. see JMX
  Java Naming and Directory Interface. See JNDI
  Java Object Builder, 75.2.1.4
  Java streams
    described, 99.10.4
    optimizing, 99.10.5
    support for, 99.10.4.1
  Java Transaction API
    and unit of work commit, 100.2.6.1, 100.2.6.1.1
    and unit of work rollback, 100.2.6.2.1
    see also JTA
  Java Transaction Service see JTA
  `JAVA_HOME`, 5.2
  `java.security.AccessControlException`, 15.7, 15.7
  `java.util.Collection` interface, 35.14
  `java.util.Map` interface, 35.14
  `java.util.Set` interface, 35.14
  `javax.ejbEntityBean` interface, 5.5.3.3
  JAXB
    creating projects from, 21.5.1
    files, 20.5.1.1
    generating project from the command line, 21.5.2
    jaxb:class, and EIS mappings, 56.2.4
    jaxb:class, and XML mappings, 65.2.6
    proxy configuration, 21.5.2
    `tljaxb.cmd`, 21.5.2
    `tljaxb.sh`, 21.5.2
    typesafe enumeration converter, 35.13
    understanding, 20.5.1
    validation, 20.5.2
    XML projects, 20.5.1
  JAXB typesafe enumeration converter
    configuring, 35.13
    understanding, 33.2.10
  `JAXBContext`, 20.5.1.3.2
  JCE. see Java Cryptography Extension
  JConnect, 11.10.1
  JDBC
    adaptor for EIS, 56.2.7
    database gateway for EIS, 56.2.7
    driver classpath, 5.5.1.3
    JConnect, 11.10.1
    Sybase JConnect, 11.10.1
  JDBC drivers
    about, 84.1.3.1
    configuring for Oracle TopLink Workbench, 5.2
    fetch size, 11.10.1, 11.11.5
    general properties, 11.10.1
    selecting, 84.1.3.1
  JDBC pools
    external with EJB Entity Beans with BMP architecture, 2.14.3.1
  `JDBC_CLASSPATH`, 5.2
  JDeveloper. See Oracle JDeveloper
  JITDG75002|Understanding data access, data access concepts, 84.1
  JMS
    connection factory name, 92.3
    coordinated cache, 92
    Processing Exceptions, 13.16, 13.17
    topic host URL, 92.4
    topic name, 92.2
  JMX
    about
    and DMS profiler
    DMS profiler, 11.4.2
  JNDI naming service, 91.7
  joining
    about, 96.7.1.4
    expressions, and, 97.2.7
    mappings, and, 40.2
    one-to-many, about, 98.2.1.10.2
    one-to-many, when not to use, 97.2.7.3
    one-to-one mappings, 40.2, 98.2.1.10.2
    optimizing reads, 11.11.7
    queries, and, 98.2.1.10, 98.2.1.10.2
    QueryManager expressions, 99.6
    read queries, 11.11.7, 98.2.1.10
  JSP and Servlet applications
    deploying, 10.2
    deployment files, 8.3
    packaging for deployment, 9.2
  JTA
    about, 100.1.2.1
    and unit of work, 100.1.2.1
    isolated client sessions, 75.5.2
    unit of work, 100.1
  JTA/JTS
    using with EJB Entity Beans with BMP architecture, 2.14.3.2
  just-in-time reading. see indirection

## K

  Key Converter tab, 46.4.1
  key pairs
    database table reference, 5.5.2.4
    troubleshooting, 14.4, 14.6
  keys
    about, 2.8.3
    foreign, 2.8.5, 35.18, 36.5
    foreign, target, 36.5
    inheritance, 26.7.2
    multiple tables, 29.7.1
    primary, 26.7.2, 29.7.1, 35.2, 36.6, 36.8, 41.3.1
    read-only settings, 35.2
    reference key field, 36.10, 36.11
    variable class relationships, 36.6, 41.3.1

## L

  large result sets, managing in finders, 99.10.6
  lazy attribute loading and read optimization, 28.32
  lazy connection
    acquisition, 77.12
    allocation, 75.3.2.6, 78.4.6
  lazy loading. see indirection
  lazy reading. see indirection
  leaf classes, 26.7, 26.7, 99.5
  life cycle of unit of work, 100.2.2
  local
    documentation, 5.4.2
    transactions, 102.14.2
  locked files, 4.2.5
  locking policy
    `AllFieldsLockingPolicy`, 26.8.4
    `ChangedFieldsLockingPolicy`, 26.8.4
    configuring, 28.25
    field locking, 26.8.4
    optimistic, 26.2.10, 26.8.2, 26.8.4
    optimistic version locking, 26.8.1
    `OptimisticLockException`, 26.8.1, 26.8.4
    pessimistic locking policy, 26.2.10, 26.8.5
    `SelectedFieldsLockingPolicy`, 26.8.4
    stale data, and, 90.2.3.1
    three-tier architectures, optimistic locking and, 26.8.6.1
    three-tier architectures, pessimistic locking and, 26.8.6.2
    `TimestampLockingPolicy`, 26.8.1
    understanding, 26.2.10, 26.8
    version locking, 26.8.2
    `VersionLockingPolicy`, 26.8.1
  Locking tab, 28.25.1
  log into database, 5.5.1.1
  Log Out of Database, 5.5.1.1
  log out of database, 5.5.1.1
  logging
    application server, 75.2.6.1.3
    chained exceptions, 75.2.6.5
    `java.util.logging`, 75.2.6.1.2
    log level, 75.2.6.3
    Oracle Enterprise Manager 10g, 75.2.6.6
    output, 75.2.6.2
    permissions, 7.6.1.5
    sessions, 75.2.6, 77.4, 77.4.1
    TopLink native logging, 75.2.6.1.1
    types, 75.2.6.1
  Logging tab, 77.4.1
  login
    CMP deployment, 20.2.4.2
    database, 23.4.1, 23.5.1.1, 86
    deployment, 20.2.4.2
    development, 20.2.4.3, 20.2.4.3
    platforms, and, 20.2.5
    projects, and, 20.2.4, 74.3, 84.1.2
    role in project, 20.2.4, 84.1.2
    session, 20.2.4.1, 77.3
    session role, non-CMP, 20.2.4.1
  `logMessages` method, 75.2.6
  look and feel, specifying, 5.4.1

## M

  Manage Non-Descriptor Classes dialog, 5.7.4
  management, source control, 4.2.1
  manager, session events, 75.2.5
  many-to-many mappings
    relation table, 36.8
    relation tables, 43.2
    session broker limitations, 75.7.3.1
  many-to-many relational mappings
    configuring, 43
    EJB, 36.8.1
    understanding, 36.8
  mapped records, 56.2.1.2
  mapping extensions
    custom data types, 12.2
    JAXB typesafe enumeration converter, 33.2.10, 35.13
    object type converter, 33.2.6.3, 35.11
    serialized object converter, 33.2.6.1, 35.9
    simple type translator, 33.2.6.4, 35.12
    transformation mappings, 33.2.6.5
    type conversion converter, 33.2.6.2, 35.10
  mappings
    about, 2.8, 2.8.4, 19, 19.1.3, 19.1.3, 33, 33, 34.1
    access types, 35.6.1
    aggregate collection mappings and EJB, 36.9.2
    anyType mapping, 66.3
    as part of the application development process, 2.9.2.1
    automatic, 34.3
    batch options, 37.4.1
    class hierarchy, 33.3
    comments, 35.8
    configuring, 34.2, 35, 35.1
    database field, 37.2.1
    default mapping, 33.2.3.2
    deprecated, generating, 22.10
    direct access, 11.7, 35.6, 35.6
    directionality, 36.2.1
    EIS mappings, 20.4, 33.7, 56, 56.1, 57
    EJB 2.0 entities, 22.5
    errors, 14.4
    example, 33.2.2
    extensions, about, 33.2.6
    hierarchy, 33.3
    inactive descriptors, 37.3.1, 57.2.1
    indirection, 11.7, 33.2.4, 35.3
    isolated client sessions, 75.5.2
    manually configuring, 34.2
    many-to-many, 36.8.1
    many-to-many, with EJB, 36.8.1
    method access, 35.6, 35.16.1
    null values, 35.5, 35.19
    object-relational, 49, 50
    one-to-many object, with EJB, 36.7.1
    one-to-one with EJB, 36.5.1
    optimizing, 11.7, 11.7
    OX mappings, 33.6
    projects, and, 19.1.3
    read only, 35.2, 35.2.1
    relation tables, 43.2, 43.2
    relational, 36, 37
    removing, 34.5.1
    to tables, 28.2.1, 29.2.1
    TopLink Workbench, Navigator window, 5.3.3
    types of, 33, 33.1
    XML mappings, 65, 65.1, 66
  mathematical functions, in TopLink expressions, 97.2.3
  menu bar, 5.3.1.1
  menus
    about, 5.3, 5.3.1
    context menus, 5.3.1.2
    menu bar, 5.3.1.1
  merging
    changes in clones, 102.5
    Oracle TopLink Workbench project files, 4.2.2
    project files, 4.2.2.1
  messages, error, 13, 14.1
  metadata
    about, 2.4.3.1, 2.9
    advantages, 2.9.1
    creating, 2.9.2, 2.9.3
    mapping and configuration, 19
    project metadata, 2.9.2
    session metadata, 2.9.3
  Metalink, 2.1.2
  method access
    about, 22.4, 35.6
    setting, 35.16.1
  methods
    adding, 5.7.2.8
    `getValue()`, 33.2.4.1
    `setValue()`, 33.2.4.1
    wrapper policy, 28.31.1
    see also specific method name
  Microsoft Access
    platform, 84.1.3.1
    schema manager type conversion, 6.1.1
  Microsoft SQL Database native sequencing, 20.7.2.6
  migrating
    error messages, 7.3.2.5
    OC4J persistence to TopLink, 7.3.2
    Oracle TopLink Workbench projects, 21.8.1
    troubleshooting, 7.3.2.5
  Migration Utility Exception, 13.24
  model source, exporting, 21.9.2
  modifiers, class, 5.7.2.2
  multicast group address, coordinated cache, 91.4
  multicast port, coordinated cache, 91.5
  multiple sessions, 75.7.4.2, 75.7.4.2, 78.1.2
  multiple tables
    about, 29.7
    specifying for descriptors, 29.7.1
  multiplicity in relationships, resolving, 7.3.2.5
  multi-processing, 11.11.8.1.4
  Multitable Info tab, 28.18.1, 29.7.1
  mutable mappings, 35.17
  `.mwp` file, 5.1, 21.1.1
  MySQL4
    batch writing, 86.6
    platform, 84.1.3.1
    primary key restrictions, 20.7
    schema manager type conversion, 6.1.1, 6.1.1

## N

  named connection pools, 84.1.6.5
  named queries
    about, 28.7, 77.13, 96.8
    configuring, 28.7, 77.13
    descriptor level, 28.7
    exclusive connections, 28.7.1.10
    options, advanced, 28.7.1.10
    parameter binding, 28.7.1.9
    prepared statement caching, 28.7.1.9
    redirect query, 96.8
    session level, 77.13
    using, 98.3
    when not to use, 96.8
    when to use, 96.8
  namespaces
    about, 20.2.7, 20.8
    configuring, 5.6.5
  naming service
    coordinated cache, 91.6
    JNDI, 91.7
    RMI, 91.8
  native sequencing
    IBM Informix Database, 20.7.2.6
    Microsoft SQL Database, 20.7.2.6
    Microsoft SQL Server, 6.2.3.4
    non-Oracle database, 20.7.2.6
    Oracle Database, 20.7.2.5, 20.7.3
    Oracle Database SEQUENCE object, 20.7.2.5.2
    Sybase Database, 6.2.3.4, 20.7.2.6
  Navigator window
    about, 5.3, 5.3.3
    attribute and mapping, 5.3.3
    database, 5.3.3, 5.3.3
    database tables in, 5.5
    descriptor, 5.3.3
    example, 5.3.3
    package, 5.3.3
    project, 5.3.3
    unsaved or changed item, 5.3.3
  NCHAR, 33.2.6.2
  NCLOB, 33.2.6.2
  neediness warnings. See troubleshooting
  nested table object-relational mappings
    configuring, 55
    understanding, 49.6
  nested unit of work, 100.2.5, 102.8.2
  new projects, 21.1.1.1
  New Reference dialog box, 5.5.2.3
  New Session button, 76.4.1, 76.5.1, 76.6.1
  New Sessions Configuration, 76.2.1
  New Table dialog box, 5.5.1.2
  `newInstance` method, 102.1.1
  no identity map, 90.2.1.4
  non-cascading write queries
    compared to cascading, 96.7.3.7, 98.2.2.3
    creating using `dontCascadeParts ()` method, 96.7.3.7, 98.2.2.3
  non-deferred write
    configuring, 102.4.4.1
    dependent objects, 26.2.3.1
    understanding, 26.2.3.1, 102.3, 102.14.3
  nonintrusive persistence, 2.8.9
  nonpersistent projects, 20.2.3
  nonrelational projects, 20.2.2
  nontransactional data sources, 84.1.1
  nontransparent indirection, 2.4.2
  nouns
    DMS profiler, 11.4, 75.2.7.2
  null values
    default, 35.5, 35.19, 85.6
    in expressions, 97.7.1
    login level, 85.6
    mapping level, 35.5
  NVARCHAR2, 33.2.6.2

## O

  object array object-relational mappings
    configuring, 54
    understanding, 49.5
  object cache, 96.15.7
  object cache, sessions, 75.2.1.1
  object change tracking
    configuring, 28.29.1.2
  object identity, 75.8
    about, 2.8.3, 90.2.1
    cache, and, 90.2.1
    using cache to preserve, 90.2.1
    see also identity map
  object indirection
    read optimization, as, 11.11.7
  object level modify query
    about, 96.7.3, 96.7.4
  object level read query
    about, 96.7.1, 96.7.2
    fetch groups, 96.7.1.5
    join reading, 96.7.1.4
    partial object query, 96.7.1.3
    read all query, 96.7.1.2
    read object query, 96.7.1.1
  object model
    about, 2.8.1
    generating with `tljaxb.cmd`, 21.5.2
    optimization, 11.6
    Oracle TopLink requirements, 2.4
    tutorial, 16.2.1.1
  object type converter
    about, 12.2, 33.2.6.3
    configuring, 35.11
  object type mappings
    configuring, 35.11, 35.11.1
  `ObjectLevelChangeTrackingPolicy`, 100.2.3.2
  object-relational descriptors
    configuring, 30
    locking policy, 28.25
    understanding, 26.4
  object-relational mappings
    about, 49
    array, understanding, 49.4
    configuring, 50
    nested table, 49.6, 55
    object array, 49.5, 54
    overview, 2.8
    reference, 49.3, 52, 53
    structure, 49.2, 51
  object-relational projects
    about, 20.3.2
    sequencing, 20.2.6
  objects
    cascading refresh in cache, 96.15.5.2
    creating and registering, 102.1.1
    query, 98.2.1.4
    refreshing in cache, 96.15.5.1
    registering and unregistering, 102.1
  ObjectTypeMapping
    see ObjectTypeConverter
  OC4J. See Oracle Containers for J2EE
  one-to-many EIS mappings
    configuring, 63
    key on source, 56.8.1
    key on target, 56.8.2
    understanding, 56.8
  one-to-many relational mappings
    configuring, 42
    understanding, 36.7
  one-to-one EIS mappings
    configuring, 62
    key on source, 56.7.1
    key on target, 56.7.2
    understanding, 56.7
  one-to-one relational mappings
    configuring, 40
    expressions, 97.2.6
    joining, 40.2
    understanding, 36.5
    with EJB, 36.5.1
  online help, 5.4.2
  Open Project button, 21.8.1
  opening projects, 21.8.1
  operators
    boolean logic, 97.2.1
  optimistic locking
    about, 26.2.10
    application architecture, 2.3.5.1
    cascading locking policy, 26.8.2, 28.25.2.2
    database exception, 98.7
    exceptions, 13.5
    field locking policy, about, 26.8.4
    rollbacks, 26.8.3
    version locking policy, 26.8.1, 26.8.2, 28.25.2.2
    with `forceUpdateToVersionField()` method, 102.11
  optimistic locking policy
    field locking, about, 26.8.4
    version locking, 26.8.1, 26.8.2, 28.25.2.2
  `OptimisticLockException`, 26.8.1, 26.8.4
  optimization
    about, 11, 11.1
    application bottlenecks, 11.2
    application server, 11.13
    batch reading, 11.11.3
    batch writing, 11.10.3
    CMP partial object queries, 11.11.4
    code generation, 11.5
    data access, 11.10, 11.10.2
    data format, 11.10.2
    database, 11.13
    descriptors, 11.7, 11.7
    DMS profiler, 11.4, 75.2.7.2
    existence checking, 11.7
    fetch groups, 11.11.4
    fetch size, JDBC, 11.11.5
    general, 11.5
    inheritance, 26.7.3.2
    instantiation, 11.7
    JDBC driver, 11.10.1, 11.11.5
    join reading, 11.11.3
    mappings, 11.7, 11.7
    named queries, 11.11.2
    object model, 11.6
    overview, 2.6
    parameter binding, 11.10.4
    partial object queries, 11.11.4
    prepared statement caching, 11.10.4
    profiler, 11.4, 75.2.7.2
      optimization, 11.3
    queries, 11.11
    reading, 11.11.7
    ReadQuery method setMaxRows, 11.11.5
    schema, 11.6
    setMaxRows, 11.11.5
    understanding, 11.1
    unit of work, 11.12
    writing, 11.11.8
  Oracle
    development support, 2.1.2
    remote session support, 75.9.1.2
  Oracle Containers for J2EE
    creating projects from, 7.3.2.2
    migrating to TopLink, 7.3.2
  Oracle Database
    date and timestamp mappings, 37.2
    native sequencing, 20.7.3
      Oracle Database, 20.7.2.5.2
    platform, 84.1.3.1
    schema manager type conversion, 6.1.1
  Oracle extensions
    hierarchical queries, 99.8.2
    Oracle Hints, 99.8.1
  Oracle Hints, using with TopLink queries, 99.8.1
  Oracle JDeveloper
    configuring with Oracle TopLink, 4.1
    TopLink sessions, 4.1.2
  Oracle TopLink
    about, 1, 1, 5.1
    application architectures, 1.4
    architectures, 1.1
    deploy tool for IBM WebSphere, 10.7
    development, 2, 2.1, 3
    features, 1.3
    integrating with application server, 7, 7.2.1
    mapping types, 33.1
    optimization, 11.1
    packaging your application, 9
    public source, 12.3
    runtime components, 3.2
    understanding, 1
  Oracle TopLink Sessions Editor. see sessions
  Oracle TopLink Workbench
    about, 5, 5.1
    Ant integration, 5.8
    classpath, 5.2
    creating projects, 21.1
    development process, 5.1
    `DRIVER_CLASSPATH`, 5.2
    environment, 5.2
    error messages, 14, 14.2
    `JDBC_CLASSPATH`, 5.2
    parts of, 5.3
    preferences, 5.4
    project, 5.1, 21.1.1
    proxy, 5.4.1, 5.4.2, 21.10.2
    sample, 5.3
    table creator, creating, 6.2.1
    upgrading projects, 21.8.1
  Oracle Virtual Private Database (VPD)
    isolated client sessions, 75.5.1
    proxy authentication, 75.5.1.1, 84.1.4.2, 86.8
  `oracle.sql.TimeStamp`, 37.2
  order
    query keys, 37.5
    relational mappings, 37.5
  `OrderSibling`, 99.8.2.3
  `orion-ejb-jar.xml` file
    about, 8.7
    `entity-deployment` attribute `pm-name`, 8.7.1
    modifying for Oracle TopLink, 8.7
    `persistence-manager` attribute `class-name`, 8.7.1
    `persistence-manager` attribute `descriptor`, 8.7.1
    `persistence-manager` attribute `name`, 8.7.1
    `persistence-manager` subentry for`pm-properties`
      `cache-synchronizations`, 8.7.1.1
      `customization-class`, 8.7.1.1
      `db-platform-class`, 8.7.1.1
      `default-mapping`, 8.7.1.1
      `project-class`, 8.7.1.1
      `remote-relationships`, 8.7.1.1
      `session-name`, 8.7.1.1
  OTN (Oracle Technology Network), 1.3, 2.1.2
  OTS (Object Transaction Service)
    about, 100.1.2.2
    unit of work, 100.1.2.2
  outer joins
    in expressions, 98.2.1.10
    inheritance, 28.18
  output parameter event in stored procedures, 98.4.2.4
  OX mappings
    about, 33.6, 33.7
    extensions, simple type translator, 33.2.6.4.1, 33.2.6.4.2
    read conversions, 33.2.6.4.1
    write conversions, 33.2.6.4.2

## P

  package names
    generating, 5.5.3.2
    renaming, 5.7.5
    TopLink Workbench, Navigator window, 5.3.3
    see also classes
  packaging for deployment
    about, 9
    BMP applications, 9.5
    CMP applications, 9.4
    EJB 3.0, 9
    Java applications, 9.1
    JSP and Servlet applications, 9.2
    Session Bean applications, 9.3
  packet time-to-live cache coordination, 91.12
  parallel
    expressions, 97.5.2
    unit of work, 100.2.5
  parameter binding
    about, 11.10.4
    byte arrays, 11.10.4
    configuring, 23.6, 28.7.1.9, 86.6, 98.2.7
    database login level, 86.6
    descriptor level, 28.7.1.9
    external connection pools, 11.10.4
    internal connection pools, 11.10.4
    J2EE, 11.10.4
    named queries, 28.7.1.9
    optimizing, 11.10.4
    project level, 23.6
    queries, 98.2.7
    streams, 11.10.4
    strings, 11.10.4
    trouble shooting, 11.10.4
  parameterized batch writing
    about, 11.10.3
    `setMaxBatchWritingSize()`, 11.10.3
  parameterized expressions
    about, 97.3
    example, 97.3.1
  parameterized SQL
    enabling on queries, 98.2.7
    Oracle TopLink optimization features, 11.11.8
    See also parameter binding
  parser conflicts, XML, 7.2.2
  partial object reading optimization, 11.11.7
  passwords, encryption, 21.9
  performance optimization
    about, 11.1
    application bottleneck, 11.2
    examples, 11.11.7.1
    JConnect method isClosed, 11.10.1
    using Performance Profiler, 11.3
  Performance Profiler
    about, 11.3
    class, 11.3.1
  persistence
    about, 2.8.9
    BEA WebLogic deployment, 8.8.1
    by reachability, 101.5
    components of, 2.4.3
    descriptor, 8.8
    implementation options, 2.4.1
    manager, 7.2.4
    OC4J, 7.3.2
    projects, 20.2.3
    types, 22.5
    using a persistence layer, 2.4.4
  persistence manager
    default, 7.2.4
    migration, 7.2.4
    restrictions, 7.2.4
  persistent classes
    requirements, 2.4, 2.4, 2.4.2, 2.4.2
    types, 22.5.1
  pessimistic locking
    about, 26.2.10, 26.8.5
    application architecture, 2.3.5.2
    policy, 26.8.5
  phantom reads, preventing, 102.15.5
  platforms
    Attunity Connect database, 84.1.3.1
    Cloudscape database, 84.1.3.1
    data source, 84.1.3
    database, 21.1.1.1, 23.2, 24.2, 84.1.3.1, 86.2, 87.2
    DB2 database, 84.1.3.1
    EIS, 84.1.3.2
    functions in expressions, 97.8
    HSQL database, 84.1.3.1
    Informix database, 84.1.3.1
    J2C adapter, 84.1.3.2
    JDBC drivers, 84.1.3.1
    Microsoft Access database, 84.1.3.1
    MySQL4 database, 84.1.3.1
    Oracle database, 84.1.3.1
    Oracle8 database, 84.1.3.1
    Oracle9 database, 84.1.3.1
    parser, XML, 7.2.2
    PointBase database, 84.1.3.1
    projects, and, 20.2.5
    server, 77.9.1
    session configuration, 77.9.1
    SQLAnyWhere database, 84.1.3.1
    SQLServer database, 84.1.3.1
    SybasePlatform database, 84.1.3.1
    XML parser, 7.2.2
    see also target platforms
  PointBase platform, 84.1.3.1
  pop-up menus. see context menus
  ports
    multicast group, 91.5
    permissions, 7.6.1.3, 7.6.1.4
  post-commit clones, avoiding, 102.16.1
  Potential EJB Descriptors dialog box, 21.8.1
  pre-allocating sequence numbers, 20.7.3, 23.3.1, 86.4.1, 87.2.1
  preferences
    class import, 5.4.4
    database, 5.4.6
    EJB, 5.4.5
    general, 5.4.1
    help, 5.4.2
    importing and exporting, 5.4
    Oracle TopLink Workbench, 5.4
    sessions, 5.4.7, 5.4.8
  Preferences - Class dialog, 5.4.4
  Preferences - EJB dialog, 5.4.5
  Preferences - General dialog, 5.4.1
  Preferences - Help dialog, 5.4.2
  Preferences - Mappings dialog, 5.4.3
  Preferences dialog, 5.4
  prepared statement caching
    about, 11.10.4
    configuring, 23.6, 28.7.1.9, 86.6, 98.2.7, 98.2.7
    database login level, 86.6
    descriptor level, 28.7.1.9
    external connection pools, 11.10.4
    internal connection pools, 11.10.4
    J2EE, 11.10.4
    named queries, 28.7.1.9
    optimizing, 11.10.4
    project level, 23.6
    queries, 98.2.7
    query level, 98.2.7
  preserving XML documents, 32.5
  primary key
    about, 2.8.3
    composite, 36.8
    inheritance, 26.7.2
    multiple tables, 29.7.1
    `primkey` in `ejb-jar.xml` file, 21.10
    read-only settings, 35.2
    restrictions, 20.7
    setting, 5.5.2.2, 28.2.1, 29.2.1
    unit of work, 100.2.7
    unknown, 28.17.1
    variable class relationships, 36.6, 41.3.1
  private relationships, 35.7
  Problems window
    about, 5.3, 5.3.5
    sample, 5.3.5
    see also error messages
  profiler
    about, 77.6
    development tool, 11.3
    DMS, 11.4, 75.2.7.2
    Oracle TopLink, 11.3, 11.3.1, 75.2.7.1
    selecting, 77.6.1, 77.8.1, 77.10.1, 77.12.1
  Project - Multiple Projects tab, 77.5.1
  Project Status Report dialog box, 21.8.3
  projects
    about, 19.1.1, 20, 20.2, 21.1.1
    architecture, 20.2.1
    cache type and size, 22.11, 28.12
    comments, 22.15
    configuring, 22
    copying objects, 4.2.3
    creating, 7.3.2.2, 21, 21.1, 21.1.1.1, 21.1.2, 21.5.1
    deployment login, and, 20.2.4.2
    deployment overview, 2.5.2
    descriptors, 19.1.2
    development login, and, 20.2.4.3
    direct access to mapped fields, 22.4
    EIS, 20.4, 20.4, 20.4.1, 20.4.2, 20.4.2, 24
    errors, 14.2
    existence checking, 22.7
    exporting, 21.9, 21.9.2
    for sessions, 77.5
    indexed records, 20.4.2
    Java, 21.1.2
    JAXB, 21.5.1
    locked, 4.2.5
    login, 20.2.4, 74.3, 84.1.2, 84.1.2
    login, and, 20.2.4
    mapped field access, default, 22.4
    mapped records, 20.4.2
    mapping projects, creating, 21.1.1.1
    mappings, 19.1.3, 21.1.1.1
    merging, 4.2.2, 4.2.2.1
    metadata, 2.9.2
    method access to mapped fields, 22.4
    model, exporting, 21.9.2
    `.mwp` file, 5.1
    nondescriptor classes, 5.7.4
    non-persistent, 20.2.3
    nonrelational, 20.2.2
    object-relational, types supported, 20.3.2
    OC4J, creating from, 7.3.2.2
    open, 21.8.1
    Oracle TopLink Workbench, 21.1.1
    packages, renaming, 5.7.5
    persistence type, 20.2.3, 22.5.1
    platforms, and, 20.2.5
    prior TopLink versions, 21.8.1
    recently opened, 21.8.1
    relational, 20.2.2, 20.3, 20.3.1, 20.3.2, 23
    renaming, 21.8.2.1
    reopening, 21.8.1
    saving, 21.8.2
    sequencing, 20.2.6, 20.2.6, 20.2.6, 20.2.6, 20.2.6, 23.3, 86.4
    session login, and, 20.2.4.1
    sharing, 4.2.3
    status report, 21.8.3, 21.8.3
    team development, 4.2
    TopLink Workbench, Navigator window, 5.3.3
    types of, 20.1, 21.1.1, 26.1
    updating from `ejb-jar.xml`, 21.10.2
    upgrading from 2.x or 3.x, 21.8.1
    writing `ejb-jar.xml` file, 21.10.1
    XML, 20.5, 25
    XML records, 20.4.1
  `projects.xml` file
    about, 8.1.1
    EJB 3.0, 8.1.1.6, 8.1.3.1
    schema, 8.1.1.1
    XSD file, 8.1.1.1
  propagation mode, cache, 91.2
  proxies. see wrapper policy
  proxy authentication
    about, 84.1.4.2
    applications, 84.1.4.2
    Oracle Virtual Private Database, 75.5.1.1, 84.1.4.2, 86.8
    session events, 75.2.5
    use cases, 84.1.4.2
  proxy indirection
    about, 33.2.4.3
    example, 35.3.2.5
    restrictions, 33.2.4.3.1
  proxy settings, preferences, 5.4.1
  public source code, 12.3

## Q

  qualified names, database tables, 5.5.1.3, 5.5.1.3
  queries
    about, 96
    application development process, 2.4.3.4, 74.5
    building, 96.3
    cache, 96.15
    `Call` queries, 96.2.1, 96.9
    cascading, 96.7.3.7, 98.2.2.3
    concepts, 96.2
    conforming, 102.4
    database queries, 96.7, 98.2
    DatabaseQuery, 96.2.2
    descriptor query manager, 96.2.5
    EIS interactions, 96.2.8.4
    EJB finders, 96.14
    EJB QL query language, 96.2.8.2
    `ejb-jar.xml` file, 28.7, 29.4, 31.5
    executing, 96.4
    expressions, 96.2.6
    fetch groups, 96.7.1.5
    flashback queries, 81.1.1, 96.9.1.4.3
    hierarchical queries, Oracle extensions, 96.9.1.4.2
    hints, Oracle extensions, 96.9.1.4.1
    historical, 96.11, 99.2
    interface and inheritance queries, 96.12
    joining, 96.7.1.4, 96.7.1.4
    languages, about, 96.2.8
    named queries, 96.8
    object level modify query, 96.7.3, 96.7.4
    object level read query, 96.7.1, 96.7.2
    on inheritance hierarchies, 99.5
    on interfaces, 99.4
    optimizing, 11.11
    Oracle database features, 99.8
    Oracle extensions, 96.9.1.4, 96.9.1.4.1, 96.9.1.4.2, 96.9.1.4.3, 96.9.1.4.4
    parameter binding, 98.2.7
    partial object query, 96.7.1.3
    performance, 11.11
    prepared statement caching, 98.2.7
    query keys, 96.2.7
    read all query, 96.7.1.2
    read object query, 96.7.1.1
    redirect queries, 96.10
    remote sessions, 75.9.2.2
    report, 11.11.7.1.2, 96.5.2
    report query, 96.7.5
    results, 96.5
    returning policy, 96.9.1
    session queries, 96.6, 98.1
    SQL query language, 96.2.8.1
    stored functions, Oracle extensions, 96.9.1.4.4
    subqueries, 97.5
    summary queries, 96.2.4
    timeout, 28.7.1.10, 28.8, 98.2.1.8
    types, 96.1
    UpdateAll, 96.7.3.5
    XML query language, 96.2.8.3
  Queries tab, 28.8.1, 28.9.1
  query by example, 98.2.1.4
  query cache, 96.15.7
  Query Exception, 13.6, 13.6
  query keys
    about, 28.10, 28.11, 96.2.7
    adding, 28.10.1, 28.11.1
    and expressions, 97.4
    creating, 28.10.1, 28.11.1
    direct mappings, 28.10
    generating, 28.10
    in expressions, 97.4
    interface descriptors, 28.10, 28.11
    Java implementation, 28.10.2
    modifying, 28.10
    order, 37.5
    relationship mappings, 28.10
    specifying, 28.10.1, 28.11.1
    unmapped attributes, 28.10, 28.10, 28.10
  Query Keys tab, 28.10.1
  query object query. See `DatabaseQuery`
  query objects
    batch reading, 98.2.1.9
    cache expiration, 99.11.2
    caching results, 96.15.6, 99.11.1
    examples, 98.2.1.1, 98.2.1.1
    ordering for `ReadAll` queries, 98.2.1.5
    report query, 11.11.7.1.2
    specifying collection class, 98.2.1.6
  query results
    about, 96.5
    caching, 96.15.6
    collections, 96.5.1
    cursors, 96.5.3
    reports, 96.5.2
    streams, 96.5.3
  query timeout example, 98.2.1.8
  QueryManager
    about, 26.2.8
    joining expressions, 99.6
  QuerySequence, 86.4.2.3

## R

  read access
    providing in sessions, 75.3.2.2
  read all operation, 98.1.1.2, 98.1.1.2
  read conversions
    simple type translator, 33.2.6.4.1
  read only
    descriptors, 28.3
    files, 4.2.5
    mappings, 35.2, 35.2.1
  read operation, 98.1.1.1
  read optimization
    about, 11.11.7
    batch reading, 11.11.7
    fetch groups, 28.32
    joining, 11.11.7
    lazy attribute loading, 28.32
    object indirection, 11.11.7
    partial object reading, 11.11.7
    report query, 11.11.7
    soft cache weak identity map, 11.11.7
    unit of work, 11.11.7
    weak identity map, 11.11.7
  read queries
    cascading refresh of identity maps, 96.15.5.3
    identity map cache refresh, 96.15.5.3
    refreshing identity maps, 96.15.5.3
  `ReadAll finders`
    executing, 99.9.3
  `ReadAll` queries
    ordering in query objects, 98.2.1.5
  `readAllObjects()`
    about, 29.4.1
    example, 98.1.1.2
  reading
    `ejb-jar.xml`, 21.10.2
    just-in-time reading, 33.2.4.2
    whole XML documents, 39.2
  reading through the write connection, 102.15.1.4
  read-locking, 26.2.10
  `readObject()`
    example, 98.1.1.1
  recently opened projects, 21.8.1
  redirect queries
    about, 96.10, 99.1
    creating, 99.1.1
    finders, 99.9.9
    using, 99.9.9
  reference key field, 36.10, 36.11
  reference object-relational mappings
    configuring, 52, 53
    understanding, 49.3
  `ReferenceMapping` class, 49.3
  references
    database tables, 5.5.2.3, 5.5.2.4
    foreign keys, 14.4, 14.6
  Refresh from Database button, 5.5.1.6
  refresh policy
    cache, 90.2.4.1
    EJB finders, 90.2.4.2
  refreshing
    cache, 28.9
    classes, 5.7.3.1, 5.7.3.1
    `refreshObject()`, 98.1.1.3
    remote sessions, 75.9.2.3
    sessions, 78.3.5
  registering objects, 102.1
  `registerNewObject` method, 102.1.2
  reimporting schemas, 5.6.3
  relation tables
    about, 36.8
    many-to-many mappings, 43.2
    mappings, 43.2
  relational descriptors
    associated table, 29.2
    configuring, 29
    locking policy, 28.25
    understanding, 26.3
  relational mappings
    about, 36
    aggregate collection, 36.9, 44
    aggregate object, 36.12, 47
    configuring, 37
    converters, 36.2.2
    direct collection, 36.10, 45
    direct map, 36.11, 46
    direct-to-field, 36.3, 38
    direct-to-XMLType, 36.4, 39
    many-to-many, 36.8, 43
    one-to-many, 36.7, 42
    one-to-one, 36.5, 40
    options, 37.1
    order, 37.5
    transformation, 36.2.2, 36.13, 48
    variable one-to-one, 36.6, 41
  relational projects
    about, 20.2.2
    configuring, 23
    object-relational databases, 20.3.2
    relational databases, 20.3.1
    understanding, 20.3
  relationships
    about, 2.8.5
    bidirectional, 5.5.3.2, 35.18, 36.5
    expressions, 97.2.7
    in `ejb-jar.xml` file, 21.10
    unexpected multiplicity, 7.3.2.5
  relative locations
    about, 22.2
    classpath, 22.3.1
  Remote Command Manager Exception, 13.21
  remote connection using RMI, example, 76.7.1
  remote sessions
    about, 75.1, 75.9
    application layer, 75.9.1.1
    creating, 76.7
    limitations of, 75.9.2
    securing access, 75.9.2.1
    server layer, 75.9.1.3
    transport layer, 75.9.1.2
    unit of work, 75.9.2.6
  Remove Class button, 5.7.3.1
  Remove Table button, 5.5.1.4
  removing sessions from brokers, 82.2
  Rename dialog, 5.5.1.5
  renaming
    packages, 5.7.5, 5.7.5
    projects, 21.8.1, 21.8.2.1
  reopening projects, 21.8.1
  report query
    about, 96.7.5
    query objects, 11.11.7.1.2
    read optimization, and, 11.11.7
    using, 11.11.7.1.2, 96.5.2
  reports
    project status, 21.8.3
    query results, 96.5.2
    see also status reports
  resuming unit of work
    after commit, 102.6
    after commit failure, 102.6
  returning policy
    configuring, 28.26
    SQLCall, 96.9.1
  Returning tab, 28.26.1
  RMI
    coordinated cache, 93
    naming service, 91.8
    remote session support, 75.9.1.2
  rollback
    and Java Transaction API, 100.2.6.2.1
    overview, 100.2.6.2
    with optimistic locking, 26.8.3
  root class
    about, 26.7
    inheritance, 26.7
  root EIS descriptor, 27.4.1.1
  root element, descriptor, 32.4
  runtime
    acquiring sessions, 75.2.4
    components, 3.2
    services, configuring sessions, 77.9
    troubleshooting, 15.7.1

## S

  Save All button, 21.8.2
  Save button, 21.8.2
  saving projects, 22.2
  schema context
    descriptors without, 32.3
    EIS descriptors, 31.2
    XML descriptors, 32.2
  Schema Document Info tab, 5.6.4.1, 5.6.5.1
  schema manager
    about, 6
    automatic table creation, 6.4
    creating a table creator, 6.2
    DB2, 6.1.1
    default table generator, 6.2.2
    Java table creator, 6.2.3
    MS Access, 6.1.1
    MySQL, 6.1.1
    Oracle, 6.1.1
    Oracle TopLink Workbench table creator, 6.2.1
    sequencing, 6.1.2, 6.2.3.4
    Sybase, 6.1.1
    table creator, 6.1, 6.2.1, 6.2.3, 6.3, 6.4
    table definition, 6.1
    type conversion, 6.1.1, 6.1.1, 6.1.1
    usage, 6.1
  Schema Structure tab, 5.6.2
  schemas
    about, 2.8.2
    context for EIS descriptors, 31.2
    context for XML descriptor, 32.2
    data storage, 2.8.2
    database, 5.5.1.2
    default root for EIS descriptors, 31.3.1
    details, 5.6.2
    document information, 5.6.4.1, 5.6.5.1
    errors, 14.6
    importing, 5.6.3
    optimizing, 11.6
    properties, 5.6.3
    reimporting, 5.6.3
    schema manager, 6
    structure, 5.6.2
    XML schemas, 5.6.1
  SCM. see source control management
  scripts
    SQL, generating, 5.5.3.1
    see also SQL
  scrollable cursor
    traversing, 99.10.3.1, 99.10.3.1
    using for ReadAllQuery, 99.10.3
  SDK
    Data Store Exception, 13.15
    Descriptor Exception, 13.18
  security
    cache coordination, permissions, 7.6.1.3
    data source access, permissions, 7.6.1.4
    disabling `doPrivileged()`, 7.6.3
    `doPrivileged()`, 7.2.3
    EJB, permissions, 7.6.1.6
    enabling `doPrivileged()`, 7.6.3
    J2EE application, permissions, 7.6.1.6, 7.6.1.6
    java.util.logging, permissions, 7.6.1.5
    loading project.xml, permissions, 7.6.1.2
    loading sessions.xml, permissions, 7.6.1.2
    logging, permissions, 7.6.1.5
    password encryption, 21.9
    permissions by feature, 7.6.1
    permissions when `doPrivileged()` disabled, 7.6.2
    port permissions, 7.6.1.3, 7.6.1.4
    `SecurityManager` integration, 7.2.3
    system properties, permissions, 7.6.1.1
    understanding permissions, 7.6
    with BEA WebLogic, 7.4.5
  Select Classes dialog box, 5.7.3.1, 5.7.3.1
  `SelectedFieldsLockingPolicy`, 26.8.4
  sensors, DMS profiler, 11.4, 75.2.7.2
  SEQ_COUNT column in sequence table, 20.7.3
  sequence connection pools, 84.1.6.4
  sequence numbers, write optimization features, 11.11.8
  SEQUENCE objects in Oracle native sequencing, 20.7.2.5.2
  sequencing
    about, 20.7, 20.7
    BEA WebLogic, 20.7.4
    BEA WebLogic single column sequence table, 20.7.2.2, 23.3, 86.4
    configuring, 20.7.1, 20.7.1
    connection pools, 84.1.6.4
    default, 86.4.2.1, 86.4.2.1, 86.4.2.1
    DefaultSequence class, 86.4.2.1
    descriptors, 26.2.9, 29.3
    entity beans, 20.7.4
    IBM WebSphere, 20.7.4
    isolated client sessions, 75.5.2
    Java configuration, 20.7.1
    Microsoft SQL Server, 6.2.3.4
    native, 20.7.2.5, 20.7.2.6, 20.7.3
    non-Oracle database native, 20.7.2.6
    Oracle Database native, 20.7.2.5, 20.7.3
    Oracle TopLink Workbench configuration, 20.7.1
    overriding default, 86.4.2.1
    platform default, 86.4.2.1
    preallocation, 11.11.8.1.3, 20.7.3
    QuerySequence class, 86.4.2.3
    schema manager, 6.2.3.4
    SEQ_COUNT, 20.7.3
    sequence type, configuring, 23.3, 86.4
    sessions, and, 75.2.12
    stored procedures, 20.7.2.3, 86.4.2.3, 86.4.2.3
    Sybase Database, 6.2.3.4
    table, 20.7.2.1
    table, default column and table names, 20.7.2.1.1
    unary table, 20.7.2.2
    with stored procedures, 86.4.2.3
  serialization
    descriptor exceptions, 102.5
    EJB 1.x, 33.2.4.5.2
    EJB 2.x, 33.2.4.5.2
    EJB 3.0, 33.2.4.5.1
    indirection, 33.2.4.5
    merging into session cache with unit of work, 102.5
  serialized object converter
    about, 12.2, 33.2.6.1
    configuring, 35.9
  serialized object mappings, 35.9.1
  server layer, 75.9.1.3
  server platform
    external transaction controller, 77.9
    runtime services, 77.9
    session configuration, 77.9
    session event listener, 77.9.2
  Server Platform tab, 77.9.1
  server sessions
    about, 75.1, 75.3, 75.3.2.1
    cache, 75.10.1
    connection options, 75.3.2.6
  service channel, coordinated cache, 91.3
  session accessor
    about, 2.13.3.5.1
    managing dependent objects with, 2.13.3.5.1
  session beans
    about, 2.12.3
    deploying, 8.4, 9.3, 10.3
    model, 2.11, 2.12.3, 2.12.3
    remote session support for, 75.9.1.2
  session brokers
    about, 75.1, 75.7
    adding sessions to, 82.2
    alternatives, 75.7.4
    architecture, 75.7.1
    configuration, 82.1
    limitations of, 75.7.3
    renaming, 82.2
    two-phase commits, 75.7.2
    two-stage commits, 75.7.2.2
  session configuration file
    about, 76.1
    loading alternative, 78.3.3
    preferences, 5.4.7, 5.4.8
    see also `sessions.xml` file
  session customizer, 75.2.3
  Session Event Manager, 75.2.5
  session events
    example, 75.2.5, 75.2.5
    isolated sessions, and, 75.2.5
    manager, 75.2.5
    proxy authentication, and, 75.2.5
  Session Loader Exceptions, 13.9
  Session Manager
    about, 78.1, 78.1.1
    acquiring, 78.2, 78.3
    defaults, 78.3.1
    destroying sessions, 78.9
    J2EE defaults, 78.3.1
    sessions, acquiring, 75.2.4
    storing sessions, 78.8
  sessions
    about, 2.4.3.2, 74.2, 75, 75, 75.2, 76
    acquiring at runtime, 75.2.4, 78, 78.1
    adding to session brokers, 82.2, 82.2
    additional mapping projects, 77.5
    API, 75.11
    application server logging, 75.2.6.1.3
    architecture, 75.2.1
    cache, 75.10, 90.1.1
    client, 75.3
    configuring, 77, 77.1, 77.9.2
    connection policy, 77.12
    creating, 2.9.3, 76.1, 76.4.1, 76.5.1, 76.6.1, 88.1.1
    customization, 75.2.3
    database sessions, 75.8, 76.6
    destroying in Session Manager, 78.9
    errors, 14.7
    event listeners, 75.2.5.2, 77.9.2
    events, 75.2.5.1
    external transaction controller, 77.9, 100.1.2
    historical client sessions, 75.6
    in `sessions.xml` file, 75.2.2
    isolated client sessions, 75.5, 80
    loading with alternative class loader, 78.3.2
    logging, 75.2.6, 75.2.6.1.3, 75.2.6.4, 77.4, 77.4.1
    logging into, 78.5
    logging out of, 78.7
    logins, 77.3
    management of, 78.1
    metadata, about, 2.9.3
    multiple sessions, 75.7.4.2, 75.7.4.2, 78.1.2
    named queries, 77.13
    object cache, 75.2.1.1
    optimizing, 11.8
    preferences, 5.4.7, 5.4.8
    queries, 96.4, 96.6, 98.1, 98.1
    refreshing, 78.3.5
    registering descriptors, 75.2.10, 77.2, 77.2.2, 77.5.2
    remote sessions, 75.9, 76.7
    sequencing, about, 75.2.12
    server, 75.3
    server platform, 77.9, 77.9.1
    SQL and messages, 75.2.6.4
    storing in Session Manager, 78.8
    three-tier architecture, 75.3.1
    transformation mappings, 36.13
    types, 75.1
    unit of work, 75.1, 75.4
  `sessions.xml` file
    about, 8.1.2
    acquiring, 75.2.4
    CMP applications, 8.1.2.3, 75.2.3
    configuring with JDeveloper, 4.1.2
    creating, 76.1, 76.2
    default location, 75.2.4
    EJB 3.0, 8.1.2.4
    loading alternative configuration file, 78.3.3
    non-CMP applications, 8.1.2.2
    schema, 8.1.2.1
    sessions, 75.2.2
    XSD file, 8.1.2.1
  `setAdditionalJoinExpression()`, 99.6.1
  `setenv.cmd` file, 5.2
  `setenv.sh` file, 5.2
  `setMaxBatchWritingSize()`, 11.10.3
  `setMultipleTableJoinExpression()`, 99.6.1
  `setShouldPerformDeletesFirst()`, 102.10.1
  Settings tab, 28.8.1, 28.9.1
  `setValue()` method, 33.2.4.1
  shared library
    setting for BEA WebLogic, 7.4.2
  shared library for BEA WebLogic, 7.4.1
  simple type translators
    about, 12.2, 33.2.6.4
    configuring, 35.12
    in Java, 35.12.2
    read conversions, 33.2.6.4.1
    write conversions, 33.2.6.4.2
  soft cache weak identity map
    about, 90.2.1.3
    when to use, 90.2.1.6
  sorting, in memory, 35.14
  source code, public, 12.3
  source control management
    projects, 4.2
    with Oracle TopLink Workbench, 4.2.1
    see also team development
  source table, reference, 5.5.2.3
  `source.jar`, 12.3
  splash screen, 5.4.1
  SQL
    call, 98.4
    comparing with expressions, 97.1.1
    custom queries for basic persistence, per descriptor, 29.4
    EJBQLCall, 98.5
    generating from database tables, 5.5.3.1, 5.5.3.1
    parameter binding, 11.10.4
    parameterized, 11.11.8, 98.2.7
    prepared statement caching, 11.10.4
    queries, 96.2.8.1, 96.2.8.1
    scripts with binding arguments, 29.4
    SQLCall, 98.4.1
    `StoredFunctionCall`, 98.4.3
    StoredProcedureCall, 98.4.2
    unit of work, 102.9
  SQL Creation Script dialog box, 5.5.3.1
  SQL DISTINCT, 11.11.7.2
  SQL Exception, 13.4
  SQLAnyWhere platform, 84.1.3.1
  SQLCall
    about, 96.9.1.1
    binding input parameters, 98.4.1.1
    cursors, 99.10.1
    input parameters, 98.4.1.1
    input-output parameters, specifying, 98.4.1.3
    output parameters, 98.4.1.2, 99.10.1
    parameter type, 98.4.1.4
    Returning Policy, 96.9.1
    ReturningPolicy, 98.4.1.4
    using, 98.4.1
  SQLServer platform, 84.1.3.1
  stages of development with Oracle TopLink, 2.1.1
  stale data
    cache, 90.2.3, 90.2.3.4, 90.2.3.5
    coordination, cache, 90.2.3.5
    invalidating the cache, 90.2.3.4
    locking policy, and, 90.2.3.1
    per-class cache configuration, 90.2.3.2
    per-query cache refresh, 90.2.3.3
  `StartWith`, 99.8.2.1
  stateful
    beans, 2.12.3
    comparing with stateless, 2.12.3
  stateless
    comparing with stateful, 2.12.3
  static attributes, 5.7.2.5.1, 5.7.2.9.1
  static fetch groups, querying with, 99.3.2
  status report, generating, 21.8.3
  stored functions
    about, 96.9.1.4.4
    using, 98.4.3
  stored procedures
    output parameter event, 98.4.2.4
    queries, 98.4.2
    sequencing, and, 20.7.2.3, 86.4.2.3
  streams
    as query results, 96.5.3
    cursored, 75.9.2.5, 99.10.5
  structure object-relational mappings
    configuring, 51
    understanding, 49.2
  `StructureMapping` class, 49.2
  subqueries
    multiple expressions, 97.5
    subselects in expressions, 97.5.1
  subselects, in expressions, 97.5.1
  summary queries, 96.2.4
  superclass, 5.7.2.1.1
  Sybase
    database schema manager type conversion, 6.1.1
    native sequencing, 20.7.2.6
    platform, 84.1.3.1
  Synchronization Exceptions, 13.14
  synchronous change propagation, 91.2
  system properties
    oracle.j2ee.security.usedoprivileged, 7.6.3
    oracle.j2ee.toplink.security.usedoprivileged, 7.6.3
    `toplink.cts.collection.checkParameters`, 7.7.1
    toplink.xml.platform, 7.2.2.1

## T

  table creator
    about, 6.1
    creating, 6.2
    using, 6.3
  Table Creator dialog, 6.2.1
  table generation. see automatic table generation
  table sequence
    about, 20.7.2.1
    default column and table names, 20.7.2.1.1
  table-class relationships, 16.2.2
  tables
    adding database, 5.5.1.2
    associating with relational descriptors, 29.2
    database, 5.5
    defining schema, 6.1
    errors, 14.5
    generating, automatic, 33.2.3.2
    import filter, 5.5.1.3
    mapping to descriptors, 28.2.1, 29.2.1
    merging files, 4.2.2.2
    multiple, 29.7
    primary key, 5.5.2.2
    references, 37.6
    relation tables for mappings, 43.2
    `TableDefinition` class, 6.1
    see also database tables
  target foreign keys
    about, 36.5, 37.6
    configuring, 37.6
  target platforms
    about, 2.2.2
    choosing, 2.2
  target tables
    in direct collection mappings, 45.2
    reference, 5.5.2.3
  team development, 4.2
  technical support, 2.1.2
  three-tier architecture
    about, 1.4, 2.10
    authentication, 84.1.4.2
    migrating to scalable architecture, 75.8
    overview, 2.10
    sessions, 75.3.1
  timestamp support
    about, 37.2
    direct to field mappings, 37.2
    Oracle Database, 37.2
    TIMESTAMP timezone, 37.2
  `TimestampLockingPolicy`, 26.8.1
  timezone, with TIMESTAMP, 37.2
  `tljaxb.cmd` file, 21.5.2
  toolbars, 5.3, 5.3.2, 5.3.2
  topic name, 92.2
  TopLink expressions. see expressions
  TopLink profiler
    about, 11.3
    selecting, 77.6.1, 77.8.1, 77.10.1, 77.12.1
  TopLink Workbench. see Oracle TopLink Workbench
  `toplink-ejb-jar.xml` file, 8.1.5, 19.1.1
  `toplink-ejb.xml` file, 8.1.5.4
  Transaction Exception, 13.22
  transactional data sources, 84.1.1
  transactions
    client-controlled, 102.14.1
    CMP, 100.1.2.3, 102.14.1, 102.14.1
    container-controlled, 102.14.1
    demarcation, 100.1.2
    external transaction controller, 77.9, 100.1.2
    external, integrating, 100.1.2, 102.13
    isolated client sessions, 75.5.2
    isolation, 100.1, 100.1.3
    JTA, 100.1.2.1
    JTS, 100.1.2.1
    local, 102.14.1
    local, CMP, 102.14.2
    OTS, 100.1.2.2
    overview, 2.4.3.5, 74.6, 100.1
    see also unit of work
  transformation EIS mappings
    configuring, 64
    understanding, 56.9
  transformation mappings
    about, 33.2.6.5
    attribute transformation, 35.15, 35.16
    mutable, 35.17
  transformation relational mappings
    configuring, 48
    understanding, 36.13
  transformation XML mappings
    configuring, 73
    understanding, 65.9
  transient attributes, 5.7.2.5.1, 5.7.2.9.1
  transparent indirection
    about, 33.2.4.2
    persistent class requirements, 2.4.2
  transport layer, 75.9.1.2
  troubleshooting
    BEA WebLogic deployment, 15.3
    data sources, 14.9
    deploy tool, 10.7.2.1
    deployment, 15
    `ejbc`, 10.4.2.1
    IBM WebSphere deployment, 15.7
    migration from OC4J persistence, 7.3.2.5
    Oracle TopLink Workbench, 14
    unit of work, 102.16, 102.16.5.1
  tutorial
    about, 16.1
    database schema, 16.2.2
    planning, 16.1
  two-phase commits, 75.7.2
  two-stage commits, 75.7.2.2
  two-tier architecture
    about, 1.4, 1.4, 2.11
    authentication, 84.1.4.1
    understanding, 2.11
  type conversion
    automatic, 37.2
    NCHAR, 33.2.6.2
    NCLOB, 33.2.6.2
    NVARCHAR2, 33.2.6.2
    `oracle.sql.TimeStamp`, 37.2
    schema manager, 6.1.1
    String to TIMESTAMP, 33.2.6.2
    TIMESTAMP to String, 33.2.6.2
  type conversion converter
    about, 12.2, 33.2.6.2
    configuring, 35.10
    provided by direct-to-field mappings, 37.2
  TypeConversionMapping
    see TypeConversionConverter
  types of mappings, 33.1
  typesafe enumeration, in EIS mappings, 56.2.5

## U

  unary table sequence
    about, 20.7.2.2
    BEA WebLogic single column sequence table, 20.7.2.2, 23.3, 86.4
  undeployment, 10.6, 10.6.1, 10.6.2
  unexpected relationship multiplicity, 7.3.2.5
  unidirectional relationships, 36.2.1
  unit of work
    about, 100.1, 100.1.1, 100.2, 100.2.1
    acquiring, 101.1
    API, 100.3
    architecture, 100.1
    auditing, 102.12, 102.12
    benefits of, 100.2.1
    cache, 90.1.2
    change policy, 100.2.3
    clones, 100.2.4
    CMP integration, 100.1.2.3
    commit and Java Transaction API, 100.2.6.1, 100.2.6.1.1
    commit, writing changes before, 102.3, 102.4.4.1, 102.13.4.1, 102.13.4.2
    conform results of in-memory query, 96.15.2.1
    creating objects, 101.2
    deleting objects, 101.7
    example, 100.2.2
    external transaction controller, 77.9, 100.1.2
    external transactions, 100.1.2, 100.1.2, 102.13
    integrating with CMP, 102.14
    isolation, 100.1.3
    JTA integration, 100.1.2.1
    JTS integration, 100.1.2.1
    life cycle, 100.2.2
    modifying objects, 101.3
    mutable mappings, 35.17
    nested, 100.2.5, 102.8.1, 102.8.2
    `newInstance` method, 102.1.1
    optimization, 11.12, 100.2.8
    OTS integration, 100.1.2.2
    parallel, 100.2.5, 102.8.1
    pre-commit validation, 102.16.5.1
    primary keys, 100.2.7
    proxy indirection, 33.2.4.3.1
    queries, 100.3.1.1.2
    read optimization, 11.11.7
    read-only classes, 102.2, 102.2.1, 102.2.2
    `registerNewObject` method, 102.1.2
    remote sessions, 75.9.2.6
    resuming, 102.6
    reverting, 102.7
    rollback, 100.2.6.2, 100.2.6.2.1
    sessions, 75.1, 75.4
    transaction demarcation, 100.1.2
    transactions, 100.1.3
      unit of work, 100.1.2
    troubleshooting, 102.16
    validating objects, 102.16.5
    with custom SQL, 102.9
    write optimization, 11.11.8
    writing changes before commit, about, 102.3
    writing changes before commit, and external transaction exceptions, 102.13.4.2
    writing changes before commit, and external transaction timeouts, 102.13.4.1
    writing changes before commit, as alternative to conforming, 102.4.4.1
  unmapping, 34.5.1
  unregistering objects, 102.1
  unsaved items, displaying in TopLink Workbench Navigator window, 5.3.3
  update
    operation, 98.1.2.1, 98.1.2.4
    projects from prior versions, 21.8.1
  UpdateAll query, 96.7.3.5
  `updateObject()`, 29.4.1
  Use XML Schema "type" attribute, configuring, 35.12
  `useBatchWriting()`, 86.6.2
  user-defined functions, in expressions, 97.8

## V

  validating
    descriptors, 27.6
    JAXB, 20.5.2
    projects, 21.8.3
    unit of work, 102.16.5
  Validation Exceptions, 13.7, 13.7
  Value Converter tab, 46.5.1
  value holders
    about, 33.2.4.1
    `ValueHolder` class, 33.2.4.1
  `ValueHolderInterface` class, 2.4.2, 33.2.4.1, 36.8
  variable one-to-one relational mappings
    class indicator, 41.2
    configuring, 41
    primary key, unique, 41.3
    understanding, 36.6
  `VariableOneToOneMapping` class, 36.6
  Varray in Oracle database. see array mappings
  version control, 4.2.5
  Version Control Assistance dialog box, 4.2.5
  `VersionLockingPolicy`, 26.8.1
  volatile attributes, 5.7.2.5.1, 5.7.2.9.1
  VPD. see Oracle Virtual Private Database

## W

  warning icon, 5.3.3, 5.3.5
  weak identity map, 90.2.1.2
  web browser, specifying, 5.4.2
  web services architecture, 1.4, 2.15
  WebLogic. see BEA WebLogic
  `weblogic-ejb-jar.xml` file
    described, 8.1.4
    modifying for Oracle TopLink, 8.8
    unsupported tags, 8.8.2
  WebSphere. see IBM WebSphere
  welcome screen, 5.4.2
  wildcard, 66.3
  wrapper policy
    about, 28.31
    implementing in Java, 28.31.1
  write
    conversions, simple type translator, 33.2.6.4.2
    write all operation, 98.1.2.2
  write query
    disabling identity map cache, 98.2.2.4
    non-cascading, 98.2.2.3
    objects, 98.2.2.1
    overview, 98.2.2.1
  write-locking, 26.2.10
  writing
    batch, 11.11.8, 86.6.2
    `ejb-jar.xml` file, 21.10.1
    optimization, 11.11.8
    sessions write access, 75.3.2.3

## X

  `xdb.jar` file, 5.2
  XML
    descriptor, schema context, 32.2
    generating deployment, 8.1.1.4
    mappings, concepts, 65.2
    preserving data, 32.5
    projects, 21.1.1.1
    query language, 96.2.8.3
    reading whole documents, 39.2
    records, 56.2.1.3
    schemas, 5.6.1
  XML Conversion Exception, 13.23
  XML Data Store Exceptions, 13.12
  XML descriptors
    configuring, 32
    schema context, 32.2
    understanding, 26.6
  XML mappings
    about, 65
    any collection, 65.8, 72
    any object, 65.7, 71
    any type support, 65.2.5
    composite collection, 65.6, 70
    composite direct collection, 65.4, 68
    composite object, 65.5, 69
    concepts, 65.2
    configuring, 66
    default conversion pairs, customizing, 65.3.5
    direct, 65.3, 67
    extensions, 65.2.8
    jaxb:class support, 65.2.6
    list support, 65.2.4
    reference descriptor, configuring, 66.2
    transformation, 65.9, 73
    types of, 65.1
    union support, 65.2.4
    xsd:list, 65.2.4
    xsd:union, 65.2.4
  XML parser platform
    about, 7.2.2
    configuring, 7.2.2.1, 7.2.2.1
    creating, 7.2.2.2
    Crimson, 7.2.2.2
    default, 7.2.2.1
    limitations, 7.2.2.2
    parser conflicts, 7.2.2
    toplink.xml.platform system property, 7.2.2.1
    used by, application server, 7.2.2
    used by, Oracle TopLink, 7.2.2
  XML projects
    configuring, 25
    JAXB support, 20.5.1
    sequencing, 20.2.6
    understanding, 20.5
  XML queries, 96.2.8.3
  XML schema
    jaxb:class, and EIS mappings, 56.2.4
    jaxb:class, and XML mappings, 65.2.6
    jaxb:class, understanding, 33.2.9
    type, 35.12
    xs:any, understanding, 65.2.5
    xs:anyType, understanding, 65.2.5
    xsd:list, understanding, 33.2.8
    xsd:union, understanding, 33.2.8
    see also schemas
  XML Type functions, 97.2.4
  XPath
    by name, 33.2.7.3
    by position, 33.2.7.1
    mapping Java attributes, 35.4
    support in OX mappings, 33.2.7
    support in XML mappings, 56.2.2, 65.2.3
  XSD file
    `projects.xml` file, 8.1.1.1
    `sessions.xml` file, 8.1.2.1

## Z

  zero-argument constructors
    editing, 5.4.4, 5.4.4
  TopLink. see Oracle TopLink