Utilice Enterprise Service Tools para generar los artefactos necesarios para
habilitar la aplicación IMS PL/I
o COBOL
existente para que se ejecute como servicio Web en el entorno de ejecución de
IMS Enterprise Suite SOAP
Gateway.
Antes de empezar
Para generar los artefactos necesarios para habilitar una
aplicación PL/I o una aplicación COBOL de
IMS existentes para
IMS Enterprise
Suite SOAP Gateway, 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.
Acerca de 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 for System z como
ayuda para realizar esta tarea.
Para generar artefactos de servicios
Web para
IMS Enterprise
Suite SOAP Gateway:
- 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
IMS Enterprise Suite SOAP Gateway.
- 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 IMS Enterprise
Suite SOAP Gateway 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 IMS Enterprise
Suite SOAP Gateway.
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 IMS Enterprise Suite SOAP Gateway):
- En la pestaña Archivo correlacionador de IMS,
especifique las propiedades de correlacionador que es necesario especificar para el
entorno de IMS Enterprise Suite SOAP
Gateway. 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
IMS Enterprise Suite SOAP Gateway
mediante la herramienta de despliegue de SOAP IMS
(consulte Desplegar los archivos de servicio web en IMS Enterprise Suite SOAP Gateway).