Configuración de transacciones CICS en WebSphere Liberty Profile

30/01/2015

WebSphere Liberty Profile
A continuación se describen los pasos a seguir para configurar el acceso a transacciones CICS (Customer Information Control System) desde WebSphere Liberty Profile.

WebShpere Liberty Profile, a partir de la versión 8.5.5.2, soporta la configuración de adaptadores de recursos que cumplan con la especificación Java EE Connector Architecture (JCA) 1.6, 1.5 o 1.0.

Lo primero que necesitamos es el adaptador de recursos adecuado para la versión de CICS TG con a la que atacar. En mi caso es la 7.2. El adaptador de recursos lo podemos descargar directamente desde la página web de IBM (archivo cc03.zip). El archivo zip, contiene varias versiones del conector pero nosotros nos quedaremos con el fichero cicseci.rar de la versión 7.2 (situado en la ruta /V7.2/Multiplatforms Fix Pack 7.2.05/ dentro del zip).

Importante:

El soporte para JCA en WebSphere Libety Profile debe añadirse a la hora de crear el entorno de ejecución del servidor Liberty Profile en el Eclipse.

Dentro del Eclipse, una vez que tenemos configurado nuestro servidor Websphere Liberty Profile vamos al “Project Explorer“, desplegamos la carpeta “WebSphere Application Server Liberty Profile” –> shared –> resources –> Boton derecho –> Import –> General –> File System. Pulsamos Next y navegamos a la carpeta donde tenemos el fichero cicseci.rar.
Import File system
Pulsamos Finish
Liberty Profile resources
Nos situamos sobre la vista de Servers, pulsamos sobre la nueva configuración de servidor creada “WebSphere Application Server Liberty Profile at localhost” y la desplegamos. Hacemos doble click en “Server Configuration [server.xml] new server“.
Server Configuration
Pulsamos en la pestaña “Source” y tenemos que añadir el siguiente contenido:

server.xml


<?xml version="1.0" encoding="UTF-8"?>
<server description="new server">
<!-- Enable features -->
<featureManager>
...
<feature>jndi-1.0</feature>
<feature>jca-1.6</feature>
...
</featureManager>
...
<resourceAdapter id="cicsECI" location="${shared.resource.dir}/cicseci.rar">
<classloader apiTypeVisibility="spec, ibm-api, api, third-party"/>
</resourceAdapter>
...
<connectionFactory id="XXXXXXXX" jndiName="eis/XXXXXXXX">
<properties.cicsECI
connectionUrl="server.com" portNumber="2097" TPNName="XXXX"
tranName="XXXX" userName="XXXXXXX" />
</connectionFactory>
...
</server>

Donde la connectionFactory se repetiría tantas veces como transacciones CICS necesitemos (con sus correspondientes valores de id, jndiName, connetionUrl, portNumber, TPNName, tranName y userName).

IMPORTANTE!!

Para que nuestra aplicación pueda hacer uso y tener acceso a las clases de los adaptadores de recursos, es necesario definir un cargador de clases que tenga como proveedor de clases el del propio adaptador. La forma de hacerlo es mediante el atributo classProviderRef, junto con el correspondiente apiTypeVisibility del classloader. Por ejemplo:

server.xml

...
<enterpriseApplication id="app-ear"
location="app-ear.ear" name="app-ear">
<classloader
classProviderRef="cicsECI, ims1320" apiTypeVisibility="spec, ibm-api, api, third-party" />
</enterpriseApplication>
...

Donde cicsECI e ims1320 serían los identificadores de los resouceAdapter cuyas connectionFactory va a utilizar nuestra aplicación.

Responder

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s

A %d blogueros les gusta esto: