user manual

vii
Configuring the Transaction Level Type . 300
Configuring ra-borland.xml . . . . . . . . . 300
Anatomy of ra-borland.xml . . . . . . . 301
Configuring the <ra-link-ref> element . . 302
Configuring the Security Map . . . . . . 303
Developing the Resource Adapter. . . . . . . 303
Connection Management . . . . . . . . . 303
Transaction Management . . . . . . . . . 304
Security Management . . . . . . . . . . . 304
Packaging and Deployment . . . . . . . . 305
Deploying the Resource Adapter . . . . . . . 305
The ra-borland.xml deployment descriptor DTD 306
Editing Descriptors . . . . . . . . . . . . . 306
DOCTYPE Header Information . . . . . 306
Element Hierarchy . . . . . . . . . . . . . 308
The DTD . . . . . . . . . . . . . . . . . . 309
Application Development Overview . . . . . . 315
Developing Application Components. . . . 315
Common Client Interface (CCI) . . . . . 315
Managed Application Scenario . . . . . 316
Non-Managed Application Scenario . . 317
Code Excerpts - Programming to the CCI 317
Deployment Descriptors for Application
Components . . . . . . . . . . . . . . . 320
EJB 2.x example . . . . . . . . . . . . 321
EJB 1.1 example . . . . . . . . . . . . 322
Other Considerations . . . . . . . . . . . . . 324
Converting a Local Connector to a Remote
Connector . . . . . . . . . . . . . . . . 324
Conversion . . . . . . . . . . . . . . . 324
Working with Poorly Implemented Resource
Adapters . . . . . . . . . . . . . . . . . 326
Examples of Poorly Implemented Resource
Adapters. . . . . . . . . . . . . . . . 326
Working with a Poor Resource Adapter
Implementation . . . . . . . . . . . . 327
Chapter 28
Apache Ant and running BES examples
333
Syntax and general usage. . . . . . . . . . . 334
Translating BES commands into Ant tasks . . 335
Basic Syntax . . . . . . . . . . . . . . . . 335
Omitting attributes . . . . . . . . . . . . . 335
Multiple File Arguments . . . . . . . . . . 336
Building the example . . . . . . . . . . . . . 336
Deploying the example . . . . . . . . . . . . 337
Running the example . . . . . . . . . . . . . 337
Undeploying the example . . . . . . . . . . . 337
Troubleshooting . . . . . . . . . . . . . . . . . 337
Chapter 29
iastool command-line utility 339
Using the iastool command-line tools. . . . . . 339
compilejsp . . . . . . . . . . . . . . . . . . 341
compress . . . . . . . . . . . . . . . . . .342
deploy . . . . . . . . . . . . . . . . . . . . 343
dumpstack . . . . . . . . . . . . . . . . . . 345
genclient . . . . . . . . . . . . . . . . . . . 346
gendeployable . . . . . . . . . . . . . . . . 347
genstubs . . . . . . . . . . . . . . . . . . . 348
info . . . . . . . . . . . . . . . . . . . . . . 349
kill . . . . . . . . . . . . . . . . . . . . . . 350
listpartitions . . . . . . . . . . . . . . . . . 352
listhubs. . . . . . . . . . . . . . . . . . . . 353
listservices . . . . . . . . . . . . . . . . . . 354
merge . . . . . . . . . . . . . . . . . . . . 355
migrate. . . . . . . . . . . . . . . . . . . . 357
patch . . . . . . . . . . . . . . . . . . . . . 357
ping . . . . . . . . . . . . . . . . . . . . . 358
pservice . . . . . . . . . . . . . . . . . . . 360
removestubs . . . . . . . . . . . . . . . . . 362
restart . . . . . . . . . . . . . . . . . . . . 362
setmain . . . . . . . . . . . . . . . . . . . 364
start . . . . . . . . . . . . . . . . . . . . . 365
stop . . . . . . . . . . . . . . . . . . . . . 366
uncompress . . . . . . . . . . . . . . . . . 368
undeploy . . . . . . . . . . . . . . . . . . . 369
usage . . . . . . . . . . . . . . . . . . . . 370
verify . . . . . . . . . . . . . . . . . . . . . 370
Executing iastool command-line tools from a script
file . . . . . . . . . . . . . . . . . . . . . . . 372
Piping a file to the iastool utility . . . . . . . 373
Passing a file to the iastool utility . . . . . . 373
Chapter 30
Partition XML reference 375
<partition> element . . . . . . . . . . . . . . . 375
<statistics.agent> element . . . . . . . . . . 376
<security> element . . . . . . . . . . . . . 377
<container> element . . . . . . . . . . . . . 377
<user.orb> element . . . . . . . . . . . . . 378
<management.orb> element. . . . . . . . . 378
<shutdown> element . . . . . . . . . . . . 379
<services> element . . . . . . . . . . . . . 380
<service> element . . . . . . . . . . . . 380
<properties> element. . . . . . . . . . .381
<archives> element. . . . . . . . . . . . 382