Generación de apéndices de llamada COBOL

Puede utilizar el generador de apéndices de llamada COBOL para crear un apéndice de llamada Java™ a fin de invocar un programa COBOL. Puede añadir el apéndice de llamada a una aplicación por lotes de Java.

Antes de empezar

Lea el tema Visión general del contenedor COBOL.

Instale los productos siguientes, que son necesarios para utilizar el generador de apéndices de llamada COBOL:

  • IBM® Rational Application Developer for WebSphere Software, Versión 7.5 o posterior, que suministra las herramientas de J2EE Connector (J2C)
  • Java Runtime Environment (JRE), Versión 1.6.0 o posterior

Para comprobar que las herramientas de Java EE Connector (J2C) están habilitadas, inicie Rational Application Developer, seleccione la perspectiva Java EE y seleccione Archivo > Nuevo > Otro. Si el asistente J2C está disponible, significa que puede crear un proyecto J2C y que las herramientas J2C están habilitados.

Si la instalación de Rational Application Developer no contiene las herramientas de Java EE Connector (J2C), utilice Installation Manager para modificar la instalación de Rational Application Developer e instale las herramientas J2C:

  1. Inicie Installation Manager.
  2. En la página Modificar paquetes, seleccione IBM Rational Application Developer for WebSphere Software > Herramientas de J2EE Connector (J2C) > Siguiente.
  3. Complete la instalación de las herramientas de J2C.

Acerca de esta tarea

Puede ejecutar el generador de apéndices de llamada COBOL desde una línea de mandatos, desde una tarea Ant o desde la interfaz gráfica del producto Rational Application Developer.

El generador de apéndices de llamada COBOL realiza las tareas siguientes:

  1. Analiza el programa fuente COBOL.
  2. Genera el código Java para que el apéndice de llamada invoque el programa COBOL.
  3. Genera el código Java para los enlaces de datos de las entradas de parámetro y el valor de retorno que utiliza el programa COBOL. Se presupone que el programa fuente es un programa COBOL válido que se ha analizado y compilado con un compilador COBOL.

Las clases de enlace de datos Java para los parámetros COBOL y el valor de retorno se generan mediante la herramienta de enlace de datos de J2C, que forma parte de la herramientas de Java EE Connector del producto Rational Application Developer. Al ejecutar el generador de apéndices de llamada COBOL desde una línea de mandatos, el generador de apéndices de llamada y la herramienta de enlace de datos se ejecutan en una sesión Eclipse autónoma. La sesión de Eclipse autónoma se inicia como un proceso Java independiente. Al ejecutar el generador de apéndices de llamada COBOL desde la interfaz gráfica, el generador de apéndices de llamada y la herramienta de enlace de datos se ejecutan en la sesión activa de Rational Application Developer.

Procedimiento

  1. Cree un proyecto Rational Application Developer para el código generado.
  2. Compruebe la sentencia PROCEDURE del archivo de origen COBOL.
    La sentencia PROCEDURE debe aparecer en el archivo fuente COBOL, no en un libro de copias incluido en el archivo de origen. Si el generador de apéndices de llamada no encuentra la sentencia PROCEDURE en el archivo fuente COBOL, el generador de apéndices de llamada falla con un error:
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      No se puede encontrar la sentencia PROCEDURE en el archivo archivo_fuente_COBOL 
    Además, la sentencia PROCEDURE no debe contener nombres de parámetro duplicados en la cláusula USING. Si la cláusula USING contiene un nombre de parámetro duplicado, el generador de apéndices de llamada falla con un error:
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Se ha detectado un COBOLDataElement duplicado: nombre de parámetro 
  3. Actualice el archivo de configuración de generador de apéndices de llamada.

    Consulte el tema relativo al archivo de configuración del generador de apéndices de llamada.

  4. Ejecute el generador de apéndices de llamada COBOL.

    Puede ejecutar el generador de apéndices de llamada de tres maneras:

    Desde una línea de mandatos
    1. Cree un script que invoque el generador de apéndices de llamada.
    2. Ejecute el script.
      $ java –jar lib/COBOLCallStubGenerator.jar vía-acceso_script/Sample01.cbl –configFile csg.properties –callStubPackage my.pkg

    Consulte el tema relativo a la invocación del generador de apéndices de llamada desde una línea de mandatos.

    Desde un programa Ant
    1. Defina una tarea Ant que invoque el generador de apéndices de llamada.
    2. Especifique un archivo de compilación Ant, como por ejemplo el archivo CSG.xml que se suministra con el generador de apéndices de llamada COBOL, para ejecutar el generador de apéndices de llamada.
    3. Ejecute el archivo de compilación Ant.

    Consulte el tema relativo a la invocación del generador de apéndices de llamada desde una tarea Ant.

    Desde la interfaz gráfica de Rational Application Developer
    1. Configure una compilación Ant bajo el menú Ejecutar > Herramientas Externas > Configuración de herramientas externas que invoque el generador de apéndices de llamada.
    2. Especifique ese archivo de compilación Ant, como por ejemplo CSG.xml, para ejecutar el generador de apéndices de llamada.
    3. Ejecute el archivo de compilación Ant.

    Consulte el tema relativo a la invocación del generador de apéndices de llamada desde una interfaz gráfica.

Resultados

Si la invocación del generador de apéndices de llamada es satisfactoria, el generador de apéndices de llamada crea un apéndice de llamada Java para invocar un programa COBOL.

Con una invocación de Rational Application Developer autónoma, podía producirse un error al ejecutar el generador de apéndices de llamada. La ejecución del generador de apéndices de llamada desde una línea de mandatos o desde una tarea Ant utiliza una invocación autónoma. Examine los registros siguientes para resolver un error:
vía_acceso_espacio_trabajo/.metadata/.log
El registro identifica si el error se debe a problemas con las herramientas basadas en Eclipse, como por ejemplo que la invocación autónoma no se ha iniciado.
inicio_usuario/.eclipse/ibm.software.delivery.platform_7.5.0/configuration
Cada invocación autónoma puede crear archivos de registro en el directorio configuration. Si los archivos de registro existen, pueden proporcionar información de resolución de problemas sobre el error.

Qué hacer a continuación

Utilice el apéndice de llamada Java generado para invocar un programa COBOL.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tgrid_cobol_csg_generate
File name: tgrid_cobol_csg_generate.html