Invocación del generador de apéndices de llamada desde una línea de comandos

Se puede ejecutar el generador de apéndices de llamada COBOL desde una línea de comandos.

Antes de empezar

Cree un proyecto Rational Application Developer para el código generado por el generador de apéndices de llamada COBOL.

Cree un archivo de configuración de generador de apéndices de llamada. Asegúrese de que los valores de las propiedades obligatorias EclipseHome, WorkSpace y EclipseProjectName sean correctos.

Compruebe la sentencia PROCEDURE del archivo de origen COBOL.

Acerca de esta tarea

Para ejecutar el generador de apéndices de llamada COBOL desde una línea de comandos, hay que ejecutar un comando que especifique los valores de los parámetros obligatorios configFile y callStubPackage. También se pueden especificar los valores de los parámetros opcionales del comando.

El comando que ejecuta el generador de apéndices de llamada COBOL debe utilizar la sintaxis siguiente:

java –jar COBOLCallStubGenerator.jar 
    {archivo de entrada cobol}
    -configFile nombre_archivo_configuración
    -callStubPackage nombre_paquete
    [-callStubClass nombre_clase]
    [-cobolModule módulo_COBOL]
    [-workSpace nombre_ruta]
    [-eclipseProjectName nombre_proyecto]
    [-build cadena_compilación]
    [-mockPackage nombre_paquete]
    [-mockClass nombre_clase]
    [-v | -verbose]
    [-? | -h]
Tabla 1. Parámetros del comando de ejecución del generador de apéndices de llamada COBOL. Los parámetros del comando tienen las definiciones siguientes.
Name Valor por omisión Obligatorio u opcional Descripción
configFile   Obligatorio Especifica el nombre del archivo de configuración del generador de apéndices de llamada.
callStubPackage   Obligatorio Especifica el nombre de paquete y la vía de acceso del archivo generado que hay que utilizar en el apéndice de llamada generado.
callStubClass ID DE PROGRAMA COBOL Opcional Especifica el nombre de clase que debe utilizarse en el apéndice de llamada generado.
cobolModule ID DE PROGRAMA COBOL Opcional Especifica el nombre del módulo COBOL o archivo DLL que contiene el programa COBOL.
workSpace   Opcional Especifica la ruta completa al directorio raíz del espacio de trabajo de Eclipse o de Rational Application Developer que hay que utilizar para crear la clase de enlace de datos Java™.

Cualquier valor especificado para workSpace sustituye el valor de workSpace en el archivo de configuración del generador de apéndices de llamada, que se identifica mediante el valor configFile.

eclipseProjectName   Opcional Especifica el nombre del proyecto en el espacio de trabajo de Eclipse o en Rational Application Developer que proporciona el directorio inicial de la clase Java generada.

El proyecto debe existir antes de poder ejecutar el generador de apéndices de llamada.

Cualquier valor especificado para eclipseProjectName sustituye el valor de EclipseProjectName en el archivo de configuración del generador de apéndices de llamada, que se identifica mediante el valor configFile.

build Unknown Build Opcional Especifica un identificador de compilación asignado por el usuario.
mockPackage   Opcional Especifica el nombre del paquete de la clase ficticia.
mockClass   Opcional Especifica el nombre de la clase usada en el arnés de prueba ficticio.

Procedimiento

  1. Cree un script que ejecuta el generador de apéndices de llamada.
  2. Asegúrese de que no haya una sesión de Rational Application Developer activa en ese momento en el espacio de trabajo.
  3. Ejecute el script.

    Por ejemplo, ejecute el comando siguiente para ejecutar el script Sample01.cbl. El archivo de configuración se denomina csg.properties y el paquete de apéndices se denomina my.pkg.

    $ java –jar lib/COBOLCallapéndiceGenerator.jar ruta_script/Sample01.cbl –configFile csg.properties –callapéndicePackage my.pkg

Resultados

El comando ejecuta el generador de apéndices de llamada. Si el comando es satisfactorio, el generador de apéndices de llamada crea una clase Java de apéndices de llamada COBOL.

Al ejecutar el comando, el generador de apéndices de llamada crea un archivo de compilación Ant temporal, directorio_temp_sistema/CSG.temp.xml y luego ejecuta el archivo en una sesión de Eclipse en modo autónomo. El archivo temporal se borra después de ejecutar el comando.

Las clases de enlace de datos Java de los parámetros COBOL y el valor de retorno se generan mediante la herramienta de enlace de datos de J2C, que forma parte de las herramientas de Java EE Connector de IBM® Rational Application Developer for WebSphere Software, versión 7.5 o posteriores. El generador de apéndices de llamada y la herramienta de enlace de datos J2C se ejecutan en la sesión de Eclipse en modo autónomo, que se inicia como un proceso Java independiente.

La invocación en modo autónomo de Eclipse intenta obtener un bloqueo sobre el espacio de trabajo antes de ejecutar el archivo de compilación Ant. Si hay una sesión Rational Application Developer activa en ese momento en el espacio de trabajo, Eclipse no podrá obtener un bloqueo sobre espacio de trabajo y el comando fallará.

Qué hacer a continuación

Utilice la clase Java de apéndices de llamada COBOL generada.


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_commandline
File name: tgrid_cobol_csg_commandline.html