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 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.

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 para System z como ayuda para realizar esta tarea.

Para generar artefactos de servicios Web para la Pasarela SOAP IMS:
  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 Visión general de los contextos para abrir el Launchpad 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 Pasarela SOAP IMS.
      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 Pasarela SOAP IMS 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 la pasarela SOAP IMS.
        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 Pasarela SOAP de IMS):
    1. 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:
      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 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).


Términos de uso | Comentarios

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