Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

About JCA Resource Adapter data instances

Updated on April 6, 2022

Your applications can connect to Java EE Connector Architecture (JCA)-compliant resource adapters that support the Common Client Interface (CCI) of the JCA specification.

Note: Beginning in Pega Platform 8.6, EAR deployments of Pega Platform are deprecated. In the upcoming 8.7 release, EAR deployments will not be supported. As a result, in Pega Platform 8.7, JCA Resource Adapter data instances will also no longer be supported. For more information on the alternatives for EAR-related rules, see Deprecation of EAR deployments in Pega Platform 8.6.

The following tabs are available on this form:

JCA implements a mechanism for accessing legacy systems — called back-end enterprise information systems (EIS) — from Java or Java EE applications. A JCA resource adapter plugs into the Java EE application server and connects applications to a specific EIS. A JCA resource adapter data instance defines the properties of a single resource adapter that is deployed in the same application server that hosts Pega Platform.

You can deploy the JCA resource adapter in either a managed environment (deployed in a Java EE application server) or a non-managed environment (deployed in a non-Java EE Web application server).

Before you begin

Before creating a resource adapter data instance, verify that the resource adapter is deployed:

  • If your system operates in a managed environment, the resource adapter .rar file must be deployed in the same Java EE application server.
  • If your system operates in a non-managed environment, place the resource adapter .jar file an appropriate directory and update the compiler class paths. See the Pega Community article About the Process Commander class paths.

Referenced by

A JCA connector rule uses the information in a JCA resource adapter instance when connecting to a resource adapter to send a request to an Enterprise Information System at runtime. See About Connect JCA Rules.


To review or create JCA Resource Adapter data instances, use the Records Explorer.

To start the Connector and Metadata wizard, select Dev Studio > Integration > Connectors > Connector & Metadata wizard.


The Data-Admin-Connect-JCAAdapter class contains JCA resource adapter data instances. This class is part of the Integration-Resources category.

  • Previous topic Interface Generator form - Understanding the Definition tab
  • Next topic JCA Resource Adapter form - Completing the New or Save As form

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us