For z/OS platforms

Enabling generated record data in outbound optimized local adapter connections in Liberty

If you are passing data by using one of the Java™ EE Connector Architecture (JCA) record interfaces that the WebSphere® optimized local adapters (WOLA) support, you can generate the Record classes by using the Rational® Application Developer CICS®/IMS™ Java Data Binding wizard.

About this task

You can use the Rational Application Developer CICS/IMS Java Data Binding wizard to generate a javax.resource.cci.Record object that can replace the byte array that sends and receives data in the IndexRecordImpl and MappedRecordImpl objects. To use the generated Record classes, you must set up an extra library in the Liberty server instance to enable the server instance to serialize and deserialize the data in the Record object.

Procedure

  1. Copy the marshalling JAR file from Rational Application Developer into a lib subdirectory underneath the server configuration directory, which contains the server.xml file. The exact name and location of the marshalling JAR file varies depending on the version of Rational Application Developer, but the name of the JAR file starts with com.ibm.etools.marshall.runtime. For example, the marshalling JAR file might be plugins/com.ibm.etools.marshall.runtime_6.1.300.v20130321_2211.jar.
  2. In the server.xml file, create a library element that points to the new location of the marshalling JAR file, as shown in the following example. Replace marshall.jar with the actual name of your marshalling JAR file.
    <!-- Library required by RAD generated application classes. -->
    <library id="MarshallLib">
        <file name="${server.config.dir}/lib/marshall.jar"/>
    </library>
  3. In the server.xml file, add the new library to the application definition that contains the generated Record class by specifying the library ID that you created on a classloader element. The following example adds the MarshallLib library to the WolaApp application.
    <!-- Application installed in ${server.config.dir}/apps. -->
    <application id="WolaApp" name="WolaApp" location="OLA.ear">
        <classloader commonLibraryRef="MarshallLib"/>
    </application>

Results

You can now use the Rational Application Developer CICS/IMS Java Data Binding wizard to generate record data for your outbound connection. For more information, see Using the Liberty optimized local adapters APIs to call services in an external address space.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_dat_radrecdata
File name: twlp_dat_radrecdata.html