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 procesa mensajes de salida de transacción IMS de longitud variable y
con múltiples segmentos.
Antes de empezar esta guía de aprendizaje, primero debe obtener los recursos
necesarios:
- Información acerca del entorno IMS: en esta guía de aprendizaje, la
aplicación interactúa con un programa de aplicación de IMS en IMS. Deberá obtener
información como el nombre de sistema principal y número de puerto de IMS Connect y el
nombre del almacén de datos IMS en el que se ejecutará la transacción. Póngase en
contacto con el administrador de sistemas IMS para esta información. Concretamente,
deberá realizar ciertas tareas de configuración en IMS si desea ejecutar el programa
IMS IMS\MultiSegmentOutput. Esta información se proporciona a continuación.
- Una copia del archivo COBOL MSOut.cbl Puede encontrar este
archivo en el directorio de instalación del producto:
\rad\eclipse\plugins\com.ibm.j2c.cheatsheet.content_6.0.0\samples\IMS\MultiSegmentOutput.
Si desea almacenarlo localmente, puede copiar el código desde aquí:
MSOut.cbl.
- Un área de trabajo limpio
NOTA: La transacción IMS que se utiliza en esta guía de
aprendizaje no es uno de los programas de verificación de instalación de IMS. Esta
guía de aprendizaje utiliza DFSDDLT0, un programa de aplicación IMS que emite llamadas a
IMS basándose en información de sentencias de control. A continuación encontrará las
sentencias de control DFSDDLT0 de esta guía de aprendizaje. No obstante, debe configurar
su entorno para DFSDDLT0 y proporcionar el JCL necesario. En esta guía se utiliza SKS2
como código de transacción para la aplicación DFSDDLT0.
Sentencias de control DFSDDLT0
S11 1 1 1 1 TP 1
L GU
E OK
E Z0017 DATA SKS2 M2 SI1M3 SI1
WTO SEGMENT SI1 RECEIVED
L GN
E QD
WTO END OF INPUT SEGMENTS
L ISRT IW06OUT
L Z0012 DATA *******M1SO1
E OK
WTO SEGMENT SO1 INSERTTED
L ISRT
L Z0027 DATA ********M1SO2*********M2SO2
E OK
WTO SEGMENT SO2 INSERTTED
L ISRT
L Z0048 DATA **********M1SO3***********M2SO3************M3SO3
E OK
WTO SEGMENT SO3 INSERTTED
WTO CURRENT PROGRAM STLDDLT2 TERMINATED
L GU
En esta guía de aprendizaje se utilizan estructuras de datos COBOL para describir los
mensajes de entrada y salida de transacción IMS. Tenga en cuenta que los mensajes de
salida devueltos por IMS están formados por tres segmentos de longitud fija:
- OUTPUT-SEG1 (16 bytes)
- OUTPUT-SEG2 (31 bytes)
- OUTPUT-SEG3 (52 bytes)
El mensaje de salida devuelto por esta aplicación IMS particular tiene un tamaño
fijo de 99 bytes y se representa mediante la estructura COBOL 01 OUTPUT-MSG.
Un modo de desarrollar esta aplicación multisegmento consiste en utilizar la
definición de COBOL OUTPUT-MSG para definir la salida de la transacción.
Un segundo modo
consiste en crear un mensaje de salida para la salida de la transacción. El código que
proporciona esta guía de aprendizaje utiliza el segundo método, ya que también se puede
utilizar para crear una aplicación que procese un mensaje de salida de longitud
variable. Se seguirán utilizando las definiciones COBOL de los distintos segmentos de
mensaje para simplificar el acceso a los datos de cada uno de los segmentos.
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 IMS
- 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 Selección de adaptadores de recurso, seleccione el adaptador de
recurso IMS J2C 1.0 ó J2C 1.5. Para esta guía de aprendizaje, seleccione IMS
Connector para Java (IBM : 9.1.0.1.2). Pulse Siguiente.
En la página Propiedades de conexión, desmarque el recuadro de selección de
Conexión gestionada y marque Conexión no gestionada.
(En esta guía de aprendizaje utilizará una conexión no gestionada para acceder
directamente a IMS, por lo que no se necesita proporcionar un nombre JNDI.) Acepte el
nombre de clase de conexión por omisión de
com.ibm.connector2.ims.ico.IMSManagedConnectionFactory. En los campos en
blanco, proporcione toda la información de conexión necesaria.
Los campos obligatorios, indicados con un asterisco (*), son los siguientes:
Para conexión TCP/IP:
- Nombre de sistema principal: (Obligatorio) Dirección IP o nombre de
sistema principal de IMS Connect.
- Número de puerto: (Obligatorio) Número de puerto que utiliza la
conexión IMS destino.
Para la conexión de opción local:
- Nombre de IMS Connect: (Obligatorio) Nombre de la conexión IMS
destino.
Para ambos:
- Nombre de almacén de datos: (Obligatorio) Nombre del almacén de datos
IMS destino.
Puede obtener la información de conexión solicitándola a su administrador de
sistema IMS. 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.