Rational Developer for System z, Versión 7.6.1

Generación de archivos de interfaz de servicio desde la aplicación IMS

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:
  1. Abra la perspectiva Proyectos z/OS:
    1. Pulse el icono Abrir perspectiva. Se abrirá la ventana Abrir perspectiva.
    2. En la ventana Abrir perspectiva, seleccione Proyectos z/OS. Se abrirá la perspectiva Proyectos z/OS.
  2. Cree un Proyecto local (COBOL o PL/I de estación de trabajo):
    1. En el menú principal del entorno de trabajo, seleccione Archivo > Nuevo > Proyecto. Se abrirá el asistente Proyecto nuevo.
    2. En el asistente Proyecto nuevo:
      1. Expanda COBOL o PL/I de estación de trabajo.
      2. Seleccione Proyecto local. Se abrirá el asistente Nuevo proyecto local.
    3. En el asistente Nuevo proyecto local, siga los pasos para crear un nuevo proyecto local.
  3. 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:
    1. En la barra de menú del entorno de trabajo, seleccione Ventana > Mostrar vista > Otra. Se abrirá el asistente Mostrar vista.
    2. En el asistente Mostrar vista:
      1. Expanda General.
      2. Seleccione Navegador.
      3. Pulse Aceptar.
    Se abrirá la vista Navegador.
  4. 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
  5. Inicie el Launchpad de asistentes de Enterprise Service Tools desde la vista Navegador:
    Nota: Los pasos siguientes son solo para el asistente Crear servicio (ascendente), consulte la sección Contextos de inicio de los asistentes de servicio único cuando ejecute el asistente fuera de la perspectiva Enterprise Tools para obtener información adicional.
    1. 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.
    2. Seleccione Habilitar servicio Web de empresa.
    Se abrirá el asistente Launchpad de asistentes de Enterprise Service Tools.
  6. Inicie el asistente Crear interfaz de servicio (ascendente)
    1. En el asistente Launchpad de asistentes de Enterprise Service Tools:
      1. En el recuadro de lista Entorno de ejecución, seleccione IMS Enterprise Suite SOAP Gateway.
      2. En el recuadro de lista Escenario, seleccione Crear interfaz de servicio (ascendente).
      3. En el recuadro de lista Tipo de conversión, seleccione Conversión XML compilada.
      4. Pulse Iniciar.
      Se abrirá el asistente Crear interfaz de servicio (ascendente).
  7. En la primera página del asistente (denominada Estructuras de lenguaje):
    1. 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.
    2. En las preferencias PL/I o COBOL:
      1. En la pestaña General:
        1. Expanda el recuadro de lista Plataforma y seleccione z/OS.
        2. Verifique o cambie otras entradas que se apliquen al sistema z/OS.
      2. Pulse Aceptar. Se cerrará la ventana Preferencias.
    3. 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.
    4. 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.
    5. Pulse Siguiente.
  8. En la segunda página del asistente (denominada Opciones de generación):
    1. En la pestaña Conversores XML:
      1. En el recuadro de lista Página de códigos de host, seleccione la página de códigos utilizada por el host.
      2. 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.
    2. En la pestaña WSDL y XSD:
      1. 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.
      2. Verifique o cambie otras entradas que se apliquen al sistema z/OS.
    3. Pulse Siguiente.
  9. En la tercera página del asistente (denominada Proveedor de servicios de IMS Enterprise Suite SOAP Gateway):
    1. 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:
      1. 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).
    2. Pulse Siguiente.
  10. En la cuarta página del asistente (denominada Selección de archivo, conjunto de datos o miembro):
    1. En la pestaña Conversores XML:
      1. 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.
      2. 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.
        Nota: Puede generar artefactos directamente en MVS (consulte la sección Generar artefactos remotamente).
    2. En la pestaña WSDL y XSD:
      1. 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.
      2. Asegúrese de que el recuadro de selección que hay delante del campo de entrada Nombre de archivo WSDL esté seleccionado.
      3. En el campo de entrada Nombre de archivo WSDL, escriba el nombre del archivo en el que desee crear el documento WSDL.
      4. 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.
        Nota: Puede generar artefactos directamente en el sistema de archivos z/OS UNIX System Services (consulte la sección Generar artefactos remotamente).
    3. 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).


Términos de uso | Comentarios

Este Information Center está basado en tecnología Eclipse. (http://www.eclipse.org)