Utilice Enterprise Service Tools para generar los artefactos necesarios para
habilitar la aplicación PL/I o la aplicación COBOL de
IMS existentes para que se ejecuten como servicio Web en el entorno de Pasarela SOAP de
IMS.
Antes de empezar
Para generar los artefactos necesarios para habilitar una
aplicación PL/I o una aplicación COBOL de IMS
existentes para la Pasarela SOAP d IMS,
debe tener un
archivo de inclusión PL/I o un libro de copia COBOL
que describan el formato de los mensajes de entrada y de salida para la aplicación
IMS.
Por qué y cuándo se efectúa esta tarea
Como los
artefactos generados por el asistente de Enterprise Service Tools (el archivo WSDL,
el archivo de correlacionador y el archivo de inclusión PL/I o
el libro de copia COBOL que contiene el controlador
de servicio Web y los programas de conversión XML de entorno de ejecución) deben
transferirse a un sistema z/OS,
puede utilizar la perspectiva Proyectos z/OS
y un proyecto local en IBM®
Rational
Developer para System z como
ayuda para realizar esta tarea.
Para generar artefactos de servicios Web para la Pasarela SOAP
IMS:
- Abra la perspectiva Proyectos
z/OS:
- Pulse el icono Abrir
perspectiva. Se abrirá la ventana Abrir perspectiva.
- En la ventana Abrir perspectiva, seleccione
Proyectos z/OS.
Se abrirá la perspectiva Proyectos z/OS.
- Cree un Proyecto
local (COBOL o
PL/I de estación de trabajo):
- En el menú principal del entorno de trabajo, seleccione
.
Se abrirá el asistente Proyecto nuevo.
- En el asistente Proyecto nuevo:
- Expanda COBOL o PL/I de
estación de trabajo.
- Seleccione
Proyecto local. Se abrirá el asistente Nuevo proyecto local.
- En el asistente Nuevo proyecto local, siga los pasos para crear un nuevo proyecto
local.
- Verifique que la vista Navegador esté abierta en la perspectiva Proyectos
z/OS; en la interfaz debe
estar visible una pestaña Navegador. Si la vista Navegador no está abierta, siga estos pasos para abrirla:
- En la barra de menú del entorno de trabajo, seleccione
. Se abrirá el asistente Mostrar vista.
- En el
asistente Mostrar vista:
- Expanda
General.
- Seleccione
Navegador.
- Pulse Aceptar.
Se abrirá la vista Navegador.
- Importe en el
proyecto local el archivo (el archivo de inclusión PL/I o el archivo de libro de copia COBOL), que contiene las estructuras de
datos que describen las estructuras de datos de entrada y salida de la aplicación
IMS. El archivo importado también debe estar visible en la vista Navegador.
Los archivos
que puede utilizar para importar en el proyecto local son:
- COBOL:.cbl, .cpy, .cob y .ccp
- PL/I: .pli, .inc y .mac
- Inicie el Launchpad de
asistentes de Enterprise Service Tools desde la vista Navegador:
- En la vista Navegador, pulse con el botón derecho del ratón en el archivo fuente importado (PL/I o COBOL)
que contiene las estructuras de datos de entrada y salida de la aplicación
IMS.
- Seleccione
Habilitar servicio Web de
empresa.
Se abrirá el asistente
Launchpad de asistentes de
Enterprise Service Tools.
- Inicie el
asistente Crear interfaz de servicio (ascendente)
- En el asistente Launchpad de
asistentes de Enterprise Service Tools:
- En el recuadro de lista
Entorno de
ejecución, seleccione
Pasarela SOAP
IMS.
- En el recuadro de lista
Escenario,
seleccione Crear interfaz de
servicio (ascendente).
- En el recuadro de lista Tipo
de conversión, seleccione
Conversión XML
compilada.
- Pulse Iniciar.
Se abrirá el asistente Crear interfaz de servicio (ascendente).
- En la primera página del asistente (denominada
Estructuras de
lenguaje):
- Pulse el botón Cambiar preferencias PL/I o Cambiar
preferencias COBOL. Se abrirá la ventana Preferencias y mostrará
las preferencias PL/I o COBOL en el panel derecho.
- En las preferencias PL/I o COBOL:
- En la pestaña
General:
- Expanda el recuadro de lista
Plataforma y
seleccione z/OS.
- Verifique o cambie otras entradas que se apliquen al sistema
z/OS.
- Pulse Aceptar. Se
cerrará la ventana
Preferencias.
- En la pestaña Estructura de lenguaje de petición, seleccione la estructura de lenguaje
de nivel superior (PL/I o COBOL) que es la estructura de entrada
para la aplicación IMS.
De manera predeterminada, se selecciona la primera estructura definida en el archivo fuente de programa.
- En la pestaña Estructura de lenguaje de respuesta, seleccione la estructura de lenguaje
de nivel superior (PL/I o COBOL) que es la estructura de
entrada para la aplicación IMS.
De manera predeterminada, se selecciona la primera estructura definida en el archivo fuente de programa.
- Pulse Siguiente.
- En la segunda página del asistente (denominada
Opciones de
generación):
- En la pestaña Conversores
XML:
- En el recuadro de lista
Página de códigos de
host, seleccione la página de códigos utilizada por el host.
- En los recuadros de lista Página de códigos de petición y Página
de códigos de respuesta, seleccione 1208 Unicode,
UTF-8.
Nota: Actualmente, el entorno de
ejecución Pasarela SOAP IMS
sólo da soporte a UTF-8.
- En la pestaña WSDL
y XSD:
- En el campo de entrada
Ubicación de
servicio (URI de punto final), cambie el nombre de host y el nombre de
puerto por la ubicación de la pasarela SOAP IMS.
Nota: Este URI especifica la dirección del servicio Web.
- Verifique o cambie otras entradas que se apliquen al sistema
z/OS.
- Pulse Siguiente.
- En la tercera página del asistente (denominada Proveedor de
servicios de Pasarela SOAP de IMS):
- En la pestaña Archivo de correlacionador de IMS, especifique las propiedades
de correlacionador que es necesario especificar para el entorno de Pasarela SOAP de
IMS. En particular:
- En el campo de entrada Contenedor de archivos,
especifique la carpeta y subcarpeta donde desee que se genere el archivo de correlacionador.
Nota: Puede generar artefactos
directamente en el sistema de
archivos
z/OS UNIX® System
Services (consulte la sección
Generar artefactos remotamente).
- Pulse Siguiente.
- En la cuarta página del asistente (denominada
Selección de archivo,
conjunto de datos o miembro):
- En la pestaña Conversores
XML:
- En el campo de entrada
Contenedor de archivos de
conversor, especifique la carpeta y la subcarpeta en las que desee
crear los programas de conversor.
- En el campo
de entrada Nombre de archivo
de controlador de conversores, escriba el nombre del archivo en el que
desee generar los programas de conversor.
Nota: Asegúrese de que el recuadro de selección
Generar todo para
controlador esté seleccionado. Esto hace que todos los programas de servicios Web generados (controlador, conversor de petición y
conversor de respuesta) se coloquen en el mismo archivo.
- En la pestaña WSDL
y XSD:
- En el campo de entrada
Contenedor de archivos
WSDL, especifique la carpeta y la subcarpeta en las que desee generar
los archivos WSDL y XSD.
- Asegúrese de que el
recuadro de selección que hay delante del campo de entrada
Nombre de archivo
WSDL esté seleccionado.
- En el
campo de entrada Nombre de
archivo WSDL, escriba el nombre del archivo en el que desee crear el
documento WSDL.
- Borre los recuadros de selección que preceden a los campos de entrada Nombre de archivo
XSD de petición y Nombre de archivo XSD de respuesta.
Nota: Los
archivos no son necesarios para el Acceso SOAP IMS. No obstante, de manera opcional,
puede seleccionar estos dos recuadros de selección para que se generen los dos
archivos XSD.
- Pulse Finalizar.
Se generarán
los siguientes archivos:
- El archivo WSDL (.wsdl).
- El archivo de
correlacionador (.xml).
- El archivo que contiene
el controlador de servicio Web y los programas de conversión XML de entorno de ejecución (.cbl).
- Los archivos XSD de petición y respuesta
(.xsd).
Después de crear los
archivos de interfaz de servicio, el siguiente paso es desplegar
los archivos de interfaz de servicio en la Pasarela SOAP
IMS mediante
el programa de utilidad de despliegue de SOAP
IMS
(consulte Desplegar los archivos de servicio Web en la Pasarela SOAP de IMS).