En este tema se describen los pasos de desarrollo que necesita
realizar para crear los artefactos necesarios para instalar un nuevo servicio Web en
CICS utilizando la perspectiva Enterprise Service Tools.
Este proceso utiliza el asistente Crear interfaz de servicio (ascendente) de
Enterprise Service Tools.
Nota: También puede realizar estas tareas mediante el procesador por lotes (consulte
la sección
Procesador por lotes).
Localizar el fuente de aplicación y los libros de copia de CICS
Para poder generar los artefactos necesarios para habilitar una aplicación como
servicio Web, el asistente Crear interfaz de servicio (ascendente) debe tener acceso a un programa completo o a
un libro de copia que contenga la estructura de lenguaje que constituye la interfaz
con la aplicación.
Dado que los artefactos generados (los conversores XML, el controlador, el archivo
WSBind y el archivo WSDL) se deben transferir a un sistema
z/OS, puede utilizar
las perspectivas de proyectos y sistema de z/OS
de IBM® Rational Developer for System
z como ayuda para realizar esta tarea. Asimismo, si el fuente del
programa y los libros de copia se encuentran en
z/OS,
puede acceder a ellos mediante la perspectiva de proyectos de
z/OS.
Para obtener más información acerca de las perspectivas y proyectos de z/OS,
consulte la sección
Sistemas,
proyectos y propiedades
Crear un proyecto local
e importar los archivos fuente de programa para el programa
CICS
en el proyecto. Si los archivos fuente de programa existen en un sistema remoto,
utilice la vista Sistemas remotos para copiarlos en el proyecto local.
Generar los artefactos de servicios Web
Siga
estos pasos para generar los artefactos de servicios Web:
- Verifique que la vista Navegador esté abierta. 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.
- Inicie el
Launchpad de asistentes de
Enterprise Service Tools:
- En la vista Navegador, pulse con el botón derecho del ratón el archivo fuente de
programa que contiene la estructura de datos de interfaz del programa.
- Seleccione
Habilitar servicio Web de
empresa.
Se abrirá el Launchpad de
asistentes de Enterprise Service Tools.
- Inicie el
asistente Crear interfaz de servicio (ascendente)
- En el Launchpad de asistentes
de Enterprise Service Tools:
- En el recuadro de lista Entorno de ejecución, seleccione
Servicios Web para CICS.
- 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):
- En la pestaña Estructura de lenguaje de petición, seleccione
la estructura de lenguaje de alto nivel que es la estructura de entrada para la aplicación. De forma 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 que es la estructura de salida para la aplicación. Se permite que se seleccionen u omitan estructuras adicionales. Sin embargo, se selecciona de forma predeterminada 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 grupo Especificar atributos de
identificación, verifique o cambie otras entradas que se aplican al sistema
z/OS (por
ejemplo, el nombre del programa de aplicación CICS en "Nombre de programa de
servicio:" debe ser correcto).
- En el grupo Especificar las codificaciones de caracteres,
verifique o cambie otras entradas para el sistema z/OS.
- En la pestaña WSDL
y XSD:
- En el campo Ubicación de
servicio, escriba el URI de punto final.
Nota: La parte local del URI (excluidos el servidor y el puerto) se utiliza como valor
predeterminado para el URI local en el WSBind (por ejemplo,
/exampleApp/inquireSingle).
- Pulse Siguiente.
- En la tercera página del asistente (denominada
Servicios Web para
CICS):
- En la pestaña
Opciones básicas:
- En el grupo Especificar
destinos para el archivo WSBind:
- En el campo de entrada
Contenedor de archivos
WSBind, especifique la carpeta y la subcarpeta en las que desee generar
el archivo WSBind.
- En el grupo Especificar propiedades de
programa de aplicación, especifique si el programa CICS se comunica a
través de un canal.
- Expanda el recuadro de lista
Interfaz de
programa y seleccione
CHANNEL.
- En el campo Nombre de
contenedor, escriba el nombre del contenedor.
- En la pestaña Opciones
avanzadas, especifique las opciones de instalación del servicio Web de
CICS.
Si no especifica estas propiedades, deberá definirlas en tiempo de
instalación, durante la creación manual de las definiciones de servicio Web en
CICS.
- 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 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: De forma predeterminada, todos los
programas de conversor (controlador, conversor de petición y conversor
de respuesta) se colocan en el mismo archivo. Si deselecciona el
recuadro de selección Generar
todo en controlador, puede especificar otro archivo para que contenga
cada programa conversor, o puede deseleccionar el recuadro de selección que precede
al nombre del programa conversor para que el asistente no genere el programa
conversor.
- En la pestaña WSDL
y XSD:
- En el campo Contenedor de
archivos WSDL, especifique la carpeta y la subcarpeta en las que desee
generar los archivos WSDL y XSD.
- En cada uno de los campos de entrada Nombre de archivo WSDL, Nombre de archivo XSD
de petición y Nombre de archivo XSD de respuesta, escriba el nombre
que desee utilizar para el archivo. Borre el recuadro de selección que precede al nombre de archivo XSD de petición o el nombre de archivo XSD
de respuesta para que el asistente no genere ese archivo.
- Pulse Finalizar.
El asistente Crear interfaz de servicio (ascendente) genera la salida especificada.
Construir los conversores XML
Los conversores XML constan de
varios programas que deben compilarse y enlazarse estáticamente junto con el programa
controlador como punto de entrada principal. Mediante la perspectiva de proyectos de
z/OS,
cree un proyecto remoto que haga referencia al sistema destino del servicio Web. Para
poder construir los conversores XML, es necesaria una versión de Enterprise
COBOL que dé soporte al análisis de XML (versión 3.1 o posterior). Copie los archivos
conversores XML en un sistema z/OS remoto, utilizando la vista Sistemas remotos
de la perspectiva z/OS (también puede generar los archivos directamente en el sistema remoto desde los asistentes Habilitar servicio
Web de empresa). Desplácese por los archivos conversores de XML en la vista
"Sistemas remotos" y añádalos al proyecto remoto. Edite las propiedades del
proyecto remoto para reflejar las opciones de compilación y enlace específicas de su
cuenta del sistema z/OS. La biblioteca de carga destino para el proyecto remoto debe
estar en la concatenación DFHRPL de la región CICS destino. Cuando
los programas conversores se generen en archivos separados, nombre el controlador de conversores como el punto
de entrada principal y pulse con el botón derecho del ratón en el proyecto remoto para hacer que se visualice
el menú de contexto. Seleccione
Reconstruir proyecto en el menú. Los
resultados de la construcción, incluidos los listados de compilación, aparecerán en el
proyecto remoto.