Oracle Application Server Containers for J2EE Services Guide -- Index

1pc

see single-phase commit

abnormal termination

OC4J JMS, 3-19

AbstractPrincipalMapping

extending, 8-23

administration

OracleAS JMS, 3-29

administration properties

OracleAS JMS, 3-29

admin.jar

resource adapters, deploying, 8-10

resource adaptors, undeploying, 8-10

admin.jar tool, 6-4, 6-6

ALLOWNULL Java Object Cache attribute, 9-16

application client example

JNDI, 2-8

ApplicationClientInitialContextFactory, 2-6

application-client.jar

JNDI, 2-4, 2-6

application-client.xml, 6-25

JNDI, 2-6

<application-server> element, 8-12

application.xml, 7-13

<data-sources> tag, 4-10

designating data-sources.xml, 4-10

location, 4-10

AQ, 3-33

<as-context> element, 6-23

Attributes.setCacheEventListener() method, 9-47

authentication classes

OC4J-specific, 8-20

bean-managed transactions

MDBs, and JMS clients, 7-19

between, 8-4

BMT

recovery, 7-16, 7-17

browse

JMS utility, 3-13

cache

concepts, 9-2

cache region, 9-10

CacheAccess

createPool() method, 9-57

CacheAccess.getOwnership() method, 9-64

CacheAccess.releaseOwnership() method, 9-64

CacheAccess.save() method, 9-53

CacheEventListener

Java Object Cache attribute, 9-18

CacheEventListener interface, 9-47

CacheLoader.createStream() method, 9-56

caching scheme, 4-28

CapacityPolicy

Java Object Cache attribute, 9-17

check

JMS utility, 3-12

class

<data-source> attribute, 4-11

clean-available-connections-threshold

<data-source> attribute, 4-13

clean-interval configuration XML element, 9-30

client.sendpassword, 6-20

client.sendpassword property, 6-25

client-side installation requirements

RMI/IIOP, 6-3

RMI/ORMI, 5-3

client-side transaction demarcation, 7-9

clustering

issues, JMS and OracleAS JMS, 3-68

JNDI

enabling, 2-15

limitations, 2-15

overview, 2-14

CMP

connection recovery, 7-16

retry count, 7-17

CMT

recovery, 7-16

retry count, 7-17

com.evermind.server package

ApplicationClientInitialContextFactory, 5-14, 6-26

ApplicationInitialContextFactory, 5-14

JNDI, 2-6

RMIInitialContextFactory, 5-14

<commit-class> element, 7-14

<commit-coordinator> element, 7-14

Common Secure Interoperability Version 2

see CSIv2

com.oracle.iiop.server package

IIOPInitialContextFactory, 6-26

component-managed sign-on, 8-16

<confidentiality> element, 6-22

configuration

two-phase commit transaction, 7-11

configuration elements

OracleAS JMS hierarchical tree, 3-5

configuration files

data sources, 4-9

configuring

connection pooling, 8-14

high availability, 3-64

high availability, OJMS, 3-64

high availability, OracleAS JMS, 3-57

JMS provider, 3-34

OC4J for interoperability, 6-16

OC4J mount point in RMI/IIOP, 5-17

OC4J to support RMI tunneling, 5-16

Oracle JMS, 3-36

Oracle JMS provider in OC4J XML files, 3-39

OracleAS JMS, 3-3

OracleAS JMS ports, 3-3

resource provider with data sources property, 3-40

single-phase commit, 7-3

timeouts in server.xml, 7-16

timeouts JTA, 7-16

configuring custom resource provider

JMS, 3-32

configuring resource provider

OJMS, 3-40, 3-41

connection, 4-12

connection factories

default, in JMS, 3-7

connection factory

configuration examples, 3-27

connection pooling

configuring, 8-14

connection-driver

<data-source> attribute, 4-11

ConnectionFactory

JMS, 3-7

connection-factory element, 3-25

connection-retry-interval

<data-source> attribute, 4-12

Consider, 2-15

constructing

JNDI contexts, 2-3

JNDI InitialContext, 2-4

container-managed sign-on, 8-17

container-managed transactions

MDBs, 7-19

<container-transaction> element, 7-8

context factory

usage, 5-14, 6-26

Context.bind API call, 2-2

contextFactory

ApplicationClientInitialContextFactory, 6-25

IIOPInitialContextFactory, 6-25

contextFactory property, 6-25

context.SECURITY_CREDENTIAL

JNDI-related environment properties, 2-8

context.SECURITY_PRINCIPAL

JNDI-related environment properties, 2-7

copy

JMS utility, 3-13

CORBA Object Service Naming

see CosNaming

CORBA Transaction Service

see OTS

corbaname URL, 6-13

CosNaming, 6-2, 6-13

createDiskObject() method, 9-24, 9-53

createInstance() method, 9-59

CreatePool() method, 9-57

createStream() method, 9-24

CSIv2, 6-2

and EJBs, 6-20

internal-settings.xml, 6-20

introduction, 6-19

properties in orion-ejb-jar.xml, 6-22

security properties, 6-20, 6-22

Data Guard, 4-34

data source

configuration, 4-8

configuration file, 4-9

connection sharing, 4-23

default, 4-15

definition, 4-2

emulated, 4-15

error conditions, 4-24

JDBC driver, 4-25

user name, 4-24

JDBC connections, 4-2

JNDI, 4-2

location of XML file, 4-10

non-emulated, 4-5

behavior, 4-23

JTA transaction, 4-23

Oracle JDBC extensions, 4-27

portable, lookup, 4-20

retrieving connection, 4-20

using DataDirect driver, 4-30

using OCI driver, 4-29

<data-source> attribute

min-connections, 4-12

data source entry

SQLServer, with DataDirect, 4-31

data sources

configuration files, 4-9

defining, 4-8

defining in Enterprise Manager, 4-14

emulated, 4-3

introduction, 4-1

mixing, 4-7

native, 4-6

non-emulated, 4-5

summary, 1-3

two-phase commit, 4-25

types, 4-2

using, 4-20

data sources property

configuring resource provider, 3-40

database

caching scheme, 4-28

database configuration, 7-11

database-schema, 4-13, 4-18

DataDirect driver, 4-30

DataDirect JDBC drivers

installing, 4-30

<data-source>

attributes, 4-10

<data-source> attribute

class, 4-11

clean-available-connections-threshold, 4-13

connection-driver, 4-11

connection-retry-interval, 4-12

ejb-location, 4-12

inactivity-timeout, 4-12

location, 4-11

max-connect-attempts, 4-12

max-connections, 4-12

name, 4-11

password, 4-11

rac-enabled, 4-13

schema, 4-13, 4-18

stmt-cache-size, 4-12

URL, 4-11

username, 4-11

wait-timeout, 4-12

xa-location, 4-11

DataSource object

look-up, 4-22, 7-4

retrieving, 7-4

types, 4-2

<data-source> tag, 4-10

data-sources.xml, 4-8, 7-13, 7-14

about, 4-9

designating location, 4-10

EAR file, 4-10

location, 4-10

preinstalled definitions, 4-15

use in JTA, 7-3

DBMS_AQADM package, 3-35

DBMS_AQADM.CREATE_QUEUE, 3-36

DbUtil

oracleFatalError method, 7-17

dcmctl

resource adaptors, deploying, 8-10

resource adaptors, undeploying, 8-10

declarative container-managed sign-on, 8-19

dedicated.rmicontext

JNDI-related environment properties, 2-7

DefaultTimeToLive

Java Object Cache attribute, 9-17

default-web-site.xml, 5-18

defineGroup() method, 9-21, 9-22

defineObject() method, 9-22

defineRegion() method, 9-20

deployment

and interoperability, 6-16

deployment descriptor

J2EE Connector, 8-5

JTA, 7-7

JTA attribute

Mandatory, 7-7

Never, 7-7

NotSupported transaction attribute type, 7-7

Required, 7-7

RequiresNew, 7-7

Supports, 7-7

dequeue-retry-count, 7-19

dequeue-retry-interval, 7-19

destinations

JMS utility, 3-13

destroy() method, 9-26

destroyInstance() method, 9-59

disallowed-field, 4-19

discoveryAddress property, 9-62

DISTRIBUTE

Java Object Cache attribute, 9-14, 9-61

distributed transaction coordinator, 4-25

drain

JMS utility, 3-13

DTC, 4-25

DTDs

internal-settings.xml, 6-19

<ior-security-config> element, 6-23

durables

JMS utility, 3-13

EJB

CSIv2, 6-20

interoperability, 6-1

making interoperable, 6-4, 6-9

server security properties table, 6-17

EJB interoperability

introduction, 6-2

ejb_sec.properties, 6-20, 6-24

ejb-jar.xml, 8-7

<message-driven-deployment> element, 7-18

ejb-location

<data-source> attribute, 4-12

emulated data sources, 4-3

Enterprise Information Systems (EISs), 8-2

Enterprise Manager

defining data sources, 4-14

<entity-deployment> element, 6-16

environment properties

JNDI-related, 2-7

<establish-trust-in-client> element, 6-22

<establish-trust-in-target> element, 6-22

example

JNDI, servlet retrieves data source, 2-11

examples

connection factory configuration, 3-27

exception queue, predefined

OracleAS JMS, 3-20

exceptionHandler() method, 9-24

file-based persistence

OracleAS JMS, 3-14

files

interoperability deployment, 6-16

flags

OC4J, starting interoperably, 6-16

generated stub JAR file, 6-4, 6-6

getConnection method, 7-4

getConnection method, 4-22, 7-5

getID() method, 9-47

getName() method, 9-24

getOwnership() method, 9-64

getOwnsership() method, 9-68

getParent() method, 9-22

getRegion() method, 9-24

getSource() method, 9-47

global-web-application.xml, 5-16

GROUP_TTL_DESTROY

Java Object Cache attribute, 9-14

GROUP_TTL_DESTROY attribute, 9-25, 9-26

handleEvent() method, 9-47

help

JMS utility, 3-12

HiAvailability

and clustering, JMS, 3-56

hierarchical tree

OracleAS JMS configuration elements, 3-5

High Availability

Data Guard, 4-34

network failover, 4-34

Oracle Maximum Availability Architecture, 4-33

Real Application Clusters, 4-34

SQL exceptions, 4-41

TAF, 4-34

high availability, 3-57, 3-64

configuring, 3-64

http.tunnel.path

JNDI-related environment properties, 2-7

identifying objects, 9-8

IdleTime

Java Object Cache attribute, 9-17

IIOP, 1-2, 6-2

iiopClientJar switch, 6-4, 6-6

IIOPInitialContextFactory, 2-14

import

oracle.ias.cache, 9-20

inactivity-timeout

<data-source> attribute, 4-12

initial context

creating in OC4J, 2-5

JNDI, 2-2

initial context factories

accessing objects in same application, 2-11

accessing objects not in same application, 2-13

JNDI, 2-6

INITIAL_CONTEXT_FACTORY

InitialContext property, 2-4

InitialContext

constructing in JNDI, 2-4

constructors, 2-4

InitialContext object, 2-2

InitialContext properties

INITIAL_CONTEXT_FACTORY, 2-4

PROVIDER_URL, 2-5

SECURITY_CREDENTIAL, 2-5

SECURITY_PRINCIPAL, 2-5

installing

client-side, RMI/IIOP, 6-3

client-side, RMI/ORMI, 5-3

JMS provider, 3-34

OC4J client JAR files, 5-3, 6-3

<integrity> element, 6-22

internal-settings.xml

CSIv2 entities, 6-20

DTD, 6-19

EJB server security properties, 6-17

<sep-property> element, 6-17, 6-20

Internet Inter-ORB Protocol

see IIOP

interoperability

adding to EJB, 6-4, 6-9

advanced, configuring manually, 6-11

advanced, configuring with Oracle Enterprise Manager, 6-11

advanced, in OracleAS environment, 6-10

configuring OC4J for, 6-16

files configuring, 6-16

naming, 6-2

OC4J flags, 6-16

overview, 1-2, 6-1

security, 6-2

simple, configuring manually, 6-9

simple, configuring with Oracle Enterprise Manager, 6-6

simple, in OracleAS environment, 6-6

transaction, 6-2

transport, 6-2

interoperability, advanced

in standalone environment, 6-5

interoperability, simple

in standalone environment, 6-4

interoperable transport, 6-4

introduction to data sources, 4-1

introduction to OC4J services, 1-1

invalidate() method, 9-25

<ior-security-config> element, 6-16

DTD, 6-23

J2EE application clients

JNDI initial contexts, 2-6

J2EE application components

JNDI initial contexts, 2-11

J2EE Connector, 8-1

deployment descriptor, 8-5

resource adapters, 8-2

J2EE Connector Architecture

deployment directory locations, 8-13

file locations, 8-13

summary, 1-3

JAAS

pluggable authentication classes, 8-25

Java Key Store (JKS), 6-17

Java Message Service, see JMS

Java Naming and Directory Interface

see JNDI

Java Object Cache, 9-2

attributes, 9-13

basic architecture, 9-3

basic interfaces, 9-5

cache consistency levels, 9-67

cache environment, 9-10

classes, 9-5

configuration

clean-interval XML element, 9-30

maxObjects property, 9-31

maxSize property, 9-31

ping-interval XML element, 9-30

consistency levels

distributed with reply, 9-68

distributed without reply, 9-68

local, 9-67

synchronized, 9-68

default region, 9-10

defining a group, 9-21, 9-22

defining a region, 9-20

defining an object, 9-22

destroy object, 9-26

disk cache

adding objects to, 9-53

disk objects, 9-52

definition of, 9-9

distributed, 9-53

local, 9-53

using, 9-53

distribute property, 9-62

distributed disk objects, 9-52

distributed groups, 9-62

distributed mode, 9-61

distributed objects, 9-62

distributed regions, 9-62

features, 9-7

group, 9-11

identifying objects, 9-8

invalidating objects, 9-25

local disk objects, 9-52

local mode, 9-61

memory objects

definition of, 9-8

local memory object, 9-8

spooled memory object, 9-8

updating, 9-8

naming objects, 9-8

object types, 9-6, 9-8

pool objects

accessing, 9-58

creating, 9-57

definition of, 9-9

using, 9-57

programming restrictions, 9-50

region, 9-10

StreamAccess object, 9-9

subregion, 9-11

summary, 1-3

Java Object Cache attributes

ALLOWNULL, 9-16

CacheEventListener, 9-18

CapacityPolicy, 9-17

DefaultTimeToLive, 9-17

DISTRIBUTE, 9-14, 9-61

GROUP_TTL_DESTROY, 9-14

IdleTime, 9-17

LOADER, 9-15

maxCount, 9-19

MaxSize, 9-19

MEASURE, 9-16

ORIGINAL, 9-15

Priority, 9-18

REPLY, 9-15

SPOOL, 9-15

SYNCHRONIZE, 9-16

SYNCHRONIZE_DEFAULT, 9-16

TimeToLive, 9-18

User-defined, 9-19

Version, 9-18

Java Transaction API

see JTA

Java-CORBA exception mapping, 6-15

java.naming.factory.initial property, 2-6, 5-11

java.naming.provider.url

JNDI-related environment properties, 2-7

property, 5-11, 6-25

java.util.Hashtable

JNDI, 2-4

javax.naming package, 2-2

javax.naming.Context interface

JNDI, 2-4

javax.sql.DataSource, 4-1, 4-2

JDBC

Oracle extensions, 4-27

transactions, 7-9

JMD

default connection factories, 3-7

JMS, 3-1

configuring custom resource provider, 3-32

configuring provider, 3-34

ConnectionFactory, 3-7

Destination, 3-35

example, where to download, 3-1

HiAvailability and clustering, 3-56

installing provider, 3-34

OracleAS, 3-2

overview, 3-1

programming models, 3-2

queue connection factory, 3-5

QueueConnectionFactory, 3-7

resource providers, 3-32

sending a message, JMS steps, 3-8

summary, 1-2

system properties, 3-29

topic connection factory, 3-6

TopicConnectionFactory, 3-7

XAConnectionFactory, 3-7

XAQueueConnectionFactory, 3-7

XATopicConnectionFactory, 3-7

JMS provider

configuring, 3-34

installing, 3-34

JMS utility

browse, 3-13

check, 3-12

copy, 3-13

destinations, 3-13

drain, 3-13

durables, 3-13

help, 3-12

knobs, 3-12

move, 3-13

stats, 3-13

subscribe, 3-13

unsubscribe, 3-13

<jms-config> element, 3-4

jms/ConnectionFactory, 3-7

jms/QueueConnectionFactory, 3-7

jms-server element, 3-23

jms/TopicConnectionFactory, 3-7

jms/XAConnectionFactory, 3-7

jms/XAQueueConnectionFactory, 3-7

jms/XATopicConnectionFactory, 3-7

jms.xml

persistent-file attribute, 3-15

jms.xml, 3-3

modifying with Oracle Enterprise Manager, 3-3

JNDI, 2-1, 2-14

application client example, 2-8

application-client.jar, 2-4, 2-6

application-client.xml, 2-6

clustering

enabling, 2-15

limitations, 2-15

overview, 2-14

com.evermind.server package, 2-6

constructing contexts, 2-3

environment, 2-4

example, servlet retrieves data source, 2-11

initial context, 2-2

initial context factories, 2-6

InitialContext constructors, 2-4

java.util.Hashtable, 2-4

javax.naming.Context interface, 2-4

jndi.propertiesfile, 2-4

orion-application-client.xml, 2-6

overview, 2-1

summary, 1-2

JNDI initial components

from J2EE application clients, 2-11

JNDI initial contexts

from J2EE application clients, 2-6

JNDI lookup

properties in orion-ejb-jar.xml, 7-4

jndi.jar file, 2-2

jndi.properties file, 5-11, 6-25

JNDI, 2-4

JNDI-related environment properties, 2-7

context.SECURITY_CREDENTIAL, 2-8

context.SECURITY_PRINCIPAL, 2-7

dedicated.rmicontext, 2-7

http.tunnel.path, 2-7

java.naming.provider.url, 2-7

JTA

bean-managed transaction, 7-2, 7-8

client-side transaction demarcation, 7-9

code download site, 7-2

configuring timeouts, 7-16

container-managed transaction, 7-2, 7-7

demarcation, 7-2, 7-6

deployment descriptor, 7-7

MDBs, 7-17, 7-18

programmatic transaction demarcation, 7-8

resource enlistment, 7-2, 7-3

retrieving data source, 7-4

retry count, 7-17

single-phase commit

definition, 7-3

single-phase commit, configuring, 7-3

specification web site, 7-2

summary, 1-3

transaction attribute types, 7-7

transactions, 7-9

two-phase commit, 7-10

two-phase commit, configuration, 7-11

two-phase commit, definition, 7-3

keystore

definition, 6-17

knobs

JMS utility, 3-12

LOADER

Java Object Cache attribute, 9-15

location

<data-source> attribute, 4-11

locations

deployment directories, 8-13

J2EE Connector Architecture, 8-13

J2EE Connector Architecture files, 8-13

log element, 3-26

log() method, 9-24

MAA, 4-33

Mandatory, 7-7

max-connect-attempts

<data-source> attribute, 4-12

max-connections

<data-source> attribute, 4-12

maxCount

Java Object Cache attribute, 9-19

maxObjects property, 9-31

MaxSize

Java Object Cache attribute, 9-19

maxSize property, 9-31

max-tx-retries attribute, 7-17

MDBs

and OJMS, 3-56

JTA, 7-17, 7-18

transaction timeout, 7-18

transactions, 7-17

transactions with OC4J JMS, 7-18

transactions with Oracle JMS, 7-18

with bean-managed transactions and JMS clients, 7-19

with container-managed transactions, 7-19

MEASURE

Java Object Cache attribute, 9-16

message

sending in JMS, steps, 3-8

message expiration

OracleAS JMS, 3-20

message paging

OracleAS JMS, 3-21

message-driven beans, see MDBs

<message-driven-deployment> element, 7-18

min-connections

<data-source> attribute, 4-12

move

JMS utility, 3-13

name

<data-source> attribute, 4-11

nameservice.useSSL property, 6-25

naming interoperability, 6-2

naming objects, 9-8

native data sources, 4-6

netSearch() method, 9-24, 9-68

network failover, 4-34

Never transaction attribute type, 7-7

non-emulated data sources, 4-5

object, behavior, 4-23

NotSupported transaction attribute type, 7-7

OBJECT_INVALIDATION event, 9-48

OBJECT_UPDATED event, 9-48

OC4J

configuring to support RMI tunneling, 5-16

sample code page, 3-35

OC4J client JAR files, 5-3, 6-3

OC4J JMS

abnormal termination, 3-19

persistence file management, 3-16

OC4J mount point

configuring, 5-17

OC4J sample code page, 3-1, 3-35

oc4j-connectors.xml, 8-8

OC4J-hosted beans

invoking from non-OC4J container, 6-15

oc4j.iiop.ciphersuites property, 6-24

oc4j.iiop.enable.clientauth property, 6-24

oc4j.iiop.keyStoreLoc property, 6-24

oc4j.iiop.keyStorePass property property, 6-24

oc4j.iiop.trustedServers property, 6-25

oc4j.iiop.trustStoreLoc property, 6-24

oc4j.iiop.trustStorePass property, 6-24

oc4j.jms.debug OracleAS JMS control knob, 3-30

oc4j.jms.forceRecovery OracleAS JMS control knob, 3-31

oc4j.jms.listenerAttempts OracleAS JMS control knob, 3-29

oc4j.jms.maxOpenFiles OracleAS JMS control knob, 3-29

oc4j.jms.messagePoll OracleAS JMS control knob, 3-29

oc4j.jms.noDms OracleAS JMS control knob, 3-30

oc4j.jms.pagingThreshold, 3-31

oc4j.jms.saveAllExpired OracleAS JMS control knob, 3-29

oc4j.jms.saveAllExpired property, 3-21

oc4j.jms.serverPoll OracleAS JMS control knob, 3-29

oc4j.jms.socketBufsize OracleAS JMS control knob, 3-30

oc4j-ra.xml, 8-5, 8-6

OCI driver, 4-29

OJMS

as resource provider, 3-33

configure resource provider with Enterprise Manager, 3-36

configuring resource provider, 3-40, 3-41

define resource provider, 3-36

resource provider, 3-33

using as a resource provider, 3-33

using as resource provider, 3-33

OJMS configuring, 3-64

OPMN, 6-18

OPMN URL, 6-14

opmn.xml file

editing, 5-10

Oracle Application Server Containers for J2EE (OC4J)

interoperability, 6-1

interoperability flags, 6-16

Oracle Enterprise Manager

configuring JMS ports, 3-3

modifying jms.xml, 3-3

Oracle JMS

configuring, 3-36

Oracle JMS provider

configuring in OC4J XML files, 3-39

Oracle JMS, see OJMS

Oracle Maximum Availability Architecture, 4-33

Oracle Process Management Notification service, 6-18

OracleAS JMS, 3-2

administration, 3-29

administration properties, table, 3-29

configuration elements hierarchical tree, 3-5

configuring, 3-3

control knob oc4j.jms.debug, 3-30

control knob oc4j.jms.forceRecovery, 3-31

control knob oc4j.jms.listenerAttempts, 3-29

control knob oc4j.jms.maxOpenFiles, 3-29

control knob oc4j.jms.messagePoll, 3-29

control knob oc4j.jms.noDms, 3-30

control knob oc4j.jms.saveAllExpired, 3-29

control knob oc4j.jms.serverPoll, 3-29

control knob oc4j.jms.socketBufsize, 3-30

exception queue, predefined, 3-20

file-based persistence, 3-14

message expiration, 3-20

message paging, 3-21

port,

configuring, 3-3

predefined exception queue, 3-20

utilities, 3-11

utilities, table, 3-12

OracleAS JMS configuring, 3-57

OracleAS JMS ports

configuring, 3-3

OracleAS Web Cache, 9-2

oracleFatalError method, 7-17

oracle.ias.cache package, 9-20

oracle.j2ee.connector package

AbstractPrincipalMapping, 8-23

OracleTwoPhaseCommitDriver, 7-14

ORIGINAL

Java Object Cache attribute, 9-15

orion-application-client.xml

JNDI, 2-6

orion-application.xml file

<resource-provider>, 3-52, 3-54, 3-55

orion-application.xml file, 7-13, 7-14

and JNDI resource provider, 3-32

EAR file, 4-10

OrionCMTDataSource, 7-14

orion-ejb.jar file

<as-context> element, 6-23

/ element, 6-23

<transport-config> element, 6-22

orion-ejb-jar.xml file

<session-deployment> element, 6-16

, 6-22, 7-4, 8-7

<confidentiality> element, 6-22

<entity-deployment> element, 6-16

<establish-trust-in-client> element, 6-22

<establish-trust-in-target> element, 6-22

<integrity> element, 6-22

<ior-security-config> element, 6-16

security properties, 6-22

ORMI, 5-2

ORMI tunneling, 5-16

OTS, 6-2

overview of JMS, 3-1

overview of OC4J services, 1-1

password

<data-source> attribute, 4-11

indirection, 4-15

obfuscation, 4-15

persistence file management

OC4J JMS, 3-16

persistent-file attribute, 3-15

ping-interval configuration XML element, 9-30

pluggable authentication classes, 8-25

PoolAccess

close() method, 9-58

get() method, 9-58

getPool() method, 9-58

object, 9-58

returnToPool() method, 9-58

PoolInstanceFactory

implementing, 9-59

predefined exception queue

OracleAS JMS, 3-20

Priority

Java Object Cache attribute, 9-18

programmatic container-managed sign-on, 8-20

programmatic transaction demarcation, 7-8

programming models

JMS, 3-2

PROVIDER_URL

InitialContext property, 2-5

QoS

see Quality of Service

Quality of Service

contracts, specifying, 8-14

JCA types, 8-4

queue connection factory

JMS, 3-5

queue element, 3-23

QueueConnectionFactory

JMS, 3-7

queue-connection-factory element, 3-25

RAC, 4-34

rac-enabled

<data-source> attribute, 4-13

RAR file, 8-2

ra.xml file, 8-6

release_Ownsership() method, 9-68

releaseOwnership() method, 9-64

Remote Method Invocation

see RMI

REPLY

Java Object Cache attributes, 9-15

REPLY attribute, 9-63

Required, 7-7

RequiresNew, 7-7

resource adapter archive

see RAR file

resource adapters

deploying, 8-5

embedded, 8-3, 8-11

introduction, 8-2

standalone, 8-9

undeploying, 8-5

with admin.jar, 8-10

resource provider

configuring with data sources property, 3-40

OJMS, 3-33

OJMS, configure with Enterprise Manager, 3-36

OJMS, define, 3-36

resource providers

JMS, 3-32

<resource-env-ref> element, 3-47

<resource-provider> element, 3-52, 3-54, 3-55

<resource-provider> element, 3-39

ResourceProvider interface

JMS, 3-32

ResourceProvider interface

OJMS, 3-33

<resource-ref> element, 3-47, 4-20

<res-ref-name> element, 4-21

returnToPool() method, 9-58

RMI

IIOP, 6-2

introduction, 5-2

ORMI, 5-2

overview, 1-2, 5-1

RMI tunneling

configuring OC4J to support, 5-16

<rmi-config> element, 5-7

RMI/IIOP

advanced interoperability in OracleAS environment, 6-10

advanced interoperability in standalone environment, 6-5

configuring for advanced interoperability manually, 6-11

configuring for advanced interoperability with Oracle Enterprise Manager, 6-11

configuring for simple interoperability manually, 6-9

configuring for simple interoperability with Oracle Enterprise Manager, 6-6

configuring OC4J mount point, 5-17

contextFactory property, 6-25

Java-CORBA exception mapping, 6-15

java.naming.factory.initial property, 5-11

java.naming.provider.url property, 5-11, 6-25

jndi.properties file, 5-11, 6-25

simple interoperability in OracleAS environment, 6-6

simple interoperability in standalone environment, 6-4

RMIInitialContextFactory, 2-13

<rmi-server> element, 5-7

rmi.xml

editing, 5-7

sample code page, OC4J, 3-1

<sas-context> element, 6-23

save() method, 9-53

schema

<data-source> attribute, 4-13, 4-18

security interoperability, 6-2

security properties, 6-19

SECURITY_CREDENTIAL

InitialContext property, 2-5

SECURITY_PRINCIPAL

InitialContext property, 2-5

sending a message

JMS steps, 3-8

<sep-config> element, 5-10, 6-16

<sep-property> element, 6-17, 6-20

server.xml

<application-server> element, 8-12

and RMI, 5-7

configuring timeouts, 7-16

<sep-config> element, 5-10, 6-16

service provider interfaces, 2-2

<session-deployment> element, 6-16

setAttributes() method, 9-24

setCacheEventListener() method, 9-47

single-phase commit

configuring, 7-3

SPIs, 2-2

SPOOL

Java Object Cache attribute, 9-15, 9-53

SQLServer

data source entry with DataDirect, 4-31

standalone resource adapters, 8-2

stats

JMS utility, 3-13

stmt-cache-size

<data-source> attribute, 4-12

StreamAccess object, 9-9

InputStream, 9-55

OutputStream, 9-55

using, 9-55

Streams Advanced Queuing (AQ), 3-33

subscribe

JMS utility, 3-13

Supports, 7-7

SYNCHRONIZE

Java Object Cache attribute, 9-16, 9-64

SYNCHRONIZE_DEFAULT

Java Object Cache attribute, 9-16, 9-64

TAF

configuration options, 4-38

configuring, 4-36, 4-37

descriptor, 4-38

exceptions, 4-40

timeouts

configuring, JTA, 7-16

TimeToLive

Java Object Cache attribute, 9-18

topic connection factory

JMS, 3-6

topic element, 3-24

TopicConnectionFactory

JMS, 3-7

topic-connection-factory element, 3-25

transaction

bean managed, 7-2

container-managed, 7-2

demarcation, 7-2, 7-6

resource enlistment, 7-2, 7-3

two-phase commit, 7-11

UserTransaction object, 7-9

transaction attribute types, 7-7

transaction demarcation

client-side, JTA, 7-9

programmatic, JTA, 7-8

transaction interoperability, 6-2

transactions

JDBC, 7-9

JTA, 7-9

MDBs, 7-17

MDBs with OC4J JMS, 7-18

MDBs with Oracle JMS, 7-18

transaction-timeout attribute, 7-18

<transaction-type> element, 7-6, 7-8

trans-attribute attribute, 7-17

<trans-attribute> element, 7-7, 7-8

Transparent Application Failover

see TAF

transport interoperability, 6-2

<transport-config> element, 6-22

trust relationships, 6-21

truststore

definition, 6-17

tunneling

ORMI, 5-16

two-phase commit

data sources, 4-25

definition, 7-3

engine limitations, 7-15

OracleTwoPhaseCommitDriver, 7-14

overview, 7-10

tx-retry-wait attribute, 7-17

type-mapping, 4-19

unsubscribe

JMS utility, 3-13

URL

<data-source> attribute, 4-11

corbaname, 6-13

OPMN, 6-14

User-defined

Java Object Cache attribute, 9-19

username

<data-source> attribute, 4-11

UserTransaction object

use in JTA, 7-9

using resource provider

OJMS, 3-33

utilities

OracleAS JMS, 3-11

OracleAS JMS, table, 3-12

Version

Java Object Cache attribute, 9-18

wait-timeout

<data-source> attribute, 4-12

Web Cache, 9-2

Web Object Cache, 9-2

XAConnectionFactory

JMS, 3-7

xa-connection-factory element, 3-25

xa-location

<data-source> attribute, 4-11

XAQueueConnectionFactory

JMS, 3-7

xa-queue-connection-factory element, 3-25

XATopicConnectionFactory

JMS, 3-7

xa-topic-connection-factory element, 3-25

Index

Numerics

A

B

C

D

E

F

G

H

I

J

K

L

M

N

O

P

Q

R

S

T

U

V

W

X