Ejercicio 1.1: seleccionar el adaptador de recurso
En esta guía de aprendizaje recorrerá todos los pasos detallados para generar una
aplicación J2C que interactúa con una transacción que utiliza una interfaz de llamadas
externas (ECI). El servicio se crea a partir de una función CICS COBOL,
getCustomer, que acepta un número de cliente y devuelve la información de
dicho cliente, como se muestra en el siguiente diagrama.
Antes de empezar esta guía de aprendizaje, primero debe obtener los recursos
necesarios:
- Conexión con un servidor CICS ECI: en esta guía de aprendizaje, la aplicación
interactuará con un programa CICS en un servidor. Concretamente, deberá configurar una
pasarela de transacción CICS en una máquina para poder acceder al servidor. También
deberá realizar ciertas tareas de configuración en la máquina del servidor CICS en la que
desee ejecutar CICS. Estos pasos no se cubren aquí.
- Una copia del archivo COBOL taderc99.cbl. Puede encontrar una copia de este
archivo en el directorio de instalación del producto:
\rad\eclipse\plugins\com.ibm.j2c.cheatsheet.content_6.0.0\Samples\CICS\taderc99.
Si desea almacenarlo localmente, puede copiar el código desde aquí:
taderc99.cbl.
- Un área de trabajo limpio
Utilizar el Asistente J2C Java Bean para seleccionar el adaptador de recurso
Pasar a la perspectiva J2EE
Si el icono de J2EE,
, no aparece en la pestaña superior derecha del área de trabajo, deberá
pasar a la perspectiva J2EE.
- En la barra de menús, seleccione Ventana > Abrir perspectiva >
Otros. Se abre la ventana Seleccionar perspectiva.
- Seleccione J2EE.
- Pulse Aceptar. Se abre la perspectiva J2EE.
Conexión con el servidor CICS ECI
- En la perspectiva J2EE, seleccione Archivo > Nuevo > Otro.
- En la página Nuevo, seleccione J2C > J2C Java Bean. Pulse
Siguiente
Nota: si no ve la opción J2C en la lista del asistente, deberá
habilitar las capacidades J2C.
- En la barra de menús, pulse Ventana > Preferencias.
- En el lado izquierdo de la ventana de preferencias, expanda el Entorno de trabajo.
- Pulse Prestaciones. Se muestra el panel de prestaciones. Si desea recibir un
aviso cuando se utilice por primera vez una función que requiera una capacidad
habilitada, seleccione Avisar al habilitar prestaciones.
- Expanda Enterprise Java.
- Seleccione Enterprise Java. Las prestaciones J2C necesarias ya se han
habilitado. Otra posibilidad es seleccionar la carpeta de la prestación Enterprise Java
para habilitar todas las prestaciones que contiene la carpeta. Para devolver la lista de
prestaciones habilitadas a su estado original en el momento de su instalación, pulse
Restaurar valores por omisión.
- Para guardar los cambios, pulse Aplicar y, a continuación, pulse
Aceptar. La habilitación de las prestaciones Enterprise Java habilitará
automáticamente las demás prestaciones necesarias para desarrollar y depurar aplicaciones
J2C.
En la página Adaptadores de recurso, en Ver por, seleccione Versión
JCA. Expanda 1.5 y seleccione ECIResourceAdapter (IBM:6.0.0) . Pulse
Siguiente.
En la página Propiedades de conexión, marque el recuadro Conexión no
gestionada. (En esta guía de aprendizaje utilizará la conexión no gestionada para
acceder directamente al servidor CICS, por lo que no se necesita proporcionar el nombre
JNDI.) Acepte el nombre de clase de conexión por omisión de
com.ibm.connector2.cics.ECIManagedConnectionFactory. En los campos en
blanco, proporcione toda la información de conexión necesaria. Los campos obligatorios se
indican con un asterisco (*):
- Nombre de servidor: (Opcional) Nombre del servidor CICS Transaction Gateway.
- URL de conexión*: (Obligatorio) Dirección del servidor CICS ECI.
- Número de puerto: (Opcional) Número de puerto que se utiliza para comunicarse
con CICS Transaction Gateway. El puerto por omisión es 2006.
- Nombre de usuario: (Opcional) Nombre de usuario para la conexión.
- Contraseña: (Opcional) Contraseña de la conexión.
Puede obtener la información de conexión solicitándola a su administrador de sistema del
servidor CICS.
Cuando haya proporcionado la información de conexión necesaria, pulse
Siguiente.
Ahora ya está preparado para empezar el Ejercicio 1.2:
configurar el proyecto Web y la interfaz e implementaciones Java.