Rational Developer for System z, Versión 7.6.1

Iniciar el procesador por lotes

El procesador por lotes es una interfaz de línea de mandatos destinada a generar los mismos tipos de archivos de salida que se generan en los asistentes de servicio único.

Consejo: Al ejecutar un asistente de servicio único, éste crea automáticamente tres archivos de propiedades de generación que pueden utilizarse con el procesador por lotes para generar los mismos archivos que se generaban con el asistente de servicio único (consulte la sección Creación de archivos de propiedades de generación para el procesador por lotes).
Importante: Antes de ejecutar el procesador por lotes, concluya las instancias de IBM® Rational Developer for System z en ejecución que utilicen el espacio de trabajo destino.

Inicie el procesador por lotes especificando el mandato siguiente desde la línea de mandatos o ejecutándolo desde un script. Hay dos formatos de invocación:

Figura 1. Formatos de los parámetros de la invocación del procesador por lotes:
(1) xsebatch -s WSDLorigen | -f archivoContenedor [-d espacio_trabajo] -c
          [-e dir_instalación_WS] [-verbose] [-version]

(2) xsebatch -s archivoLenguaje [-c | -w nombreServicio] | [-c -w nombreServicio]
          -f archivoContenedor [-d espacio_trabajo] [-e dir_instalación_WS] [-verbose]
          [-version] [-overwrite=yes|no] [-annot archivoSin]
          [-commtypes archivoTiposCom] 

Formato (1)

En el formato (1), es obligatorio especificar el parámetro -s o el parámetro -f y también el parámetro -c. Los parámetros del formato (1) son:
  • -s WSDLorigen: es obligatorio especificar este parámetro o el parámetro -f. WSDLorigen es el nombre del archivo WSDL de origen. Si se especifica este parámetro, todas las opciones de generación y preferencias de configuración se establecen a partir de los valores predeterminados. Si también está presente el parámetro -d, especifica la ubicación de las preferencias predeterminadas. De lo contrario, los motores de generación establecen las preferencias predeterminadas.
  •  
  • -f archivoContenedor: En el formato (1), es obligatorio especificar este parámetro o el parámetro -s. Este parámetro especifica el nombre del archivo Container.xml que contiene las opciones de generación. La mayor parte del contenido de los elementos de este archivo es opcional, pero algunos elementos son obligatorios y deben especificarse.
  •  
  • -c archivoContenedor: En el formato (1), este parámetro es obligatorio. En el formato (1), -c provoca la generación de los artefactos siguientes: estructuras de lenguaje, conversores de lenguaje, metadatos de correlación, un programa de plantilla y metadatos de entorno de ejecución (IMS Enterprise Suite SOAP Gateway).
  •  
  • -d espacio_trabajo: este parámetro especifica la vía de acceso completa del espacio de trabajo que debe utilizarse para la importación. Si no se especifica esta vía de acceso en la línea de mandatos, el valor predeterminado se toma de la variable de entorno workspace. Si esta variable de entorno no se ha establecido, el valor predeterminado se establece en lo siguiente:
  •     • Linux $eclipse_root/workspace
  •     • Windows %eclipse_root%\workspace
  •  
  • -e dir_instalación_WS: este parámetro especifica el subdirectorio de Eclipse del directorio en el que está instalado IBM Rational Developer for System z. Si no se especifica, el valor predeterminado se toma de la variable de entorno eclipse_root. Si esta variable de entorno no se ha establecido, el valor predeterminado se establece en el directorio de instalación predeterminado para IBM Rational Developer for System z. Dicho directorio se registra durante la instalación por parte del proceso de instalación y se establece en la variable de entorno de WDZ71INSTDIR.
  •  
  •  Nota relativa a los nombres de directorio en los parámetros -d y -e: si un nombre de directorio contiene espacios, debe especificarse entre comillas dobles:
  •     • Linux "/home/username/mi espacio de trabajo"
  •     • Windows "c:\mi espacio de trabajo"
  • Sólo debe utilizar las comillas al especificar valores para los parámetros de línea de mandatos -d y -e. Si utiliza variables de entorno, omita las comillas en estos valores. No utilice caracteres de separación de archivos finales en los nombres de vía de acceso para las opciones -d y -e ni en los valores de las variables de entorno workspace y eclipse_root.
  •  
  • verbose: este parámetro provoca la impresión de los mensajes de diagnóstico en la consola.
  •  
  • version: este parámetro provoca la impresión de la información de versión, release y modificación en la consola.
  •  

Formato (2)

En el formato (2), los parámetros siguientes son obligatorios: -s, -c o -w o ambos, y -f. Los parámetros utilizados en el formato (2) son:
  • -s archivoLenguaje: este parámetro es obligatorio a menos que se haya especificado la misma información en el elemento importFile. Aquí, archivoLenguaje es el archivo origen de lenguaje que contiene la definición de mensaje. Puede alterar temporalmente este nombre especificando valores para los elementos importDirectory e inputFile del elemento MessageSpec del archivo ServiceSpecification.xml.
  •  
  • (-c | (-w nombreServicio)) | -c -w nombreServicio: es obligatorio especificar uno de los parámetros -c o -w nombreServicio, o ambos:
  • -c provoca la generación del conjunto de conversores de lenguaje, el controlador y los esquemas XML. Puede alterar temporalmente esta opción mediante las opciones generateConverters y generateSeparateXSD de los archivos Container.xml y ServiceSpecification.xml. La opción generateSeparateXSD=true genera archivos XSD sólo si se ha especificado -c (o generateConverters=true).
  • w nombreServicio provoca la generación de archivos de definición de servicio mediante el nombre especificado para el servicio Web. Puede alterar temporalmente esta opción mediante la opción generateWSDL de los archivos Container.xml y ServiceSpecification.xml. El valor de este parámetro puede alterarse temporalmente mediante el atributo value del elemento EISService del archivo ServiceSpecification.xml. El valor predeterminado está establecido en esvc.
  •  
  • -f archivoContenedor: En el formato (2), este parámetro es obligatorio. Especifica el nombre del archivo Container.xml que contiene las opciones de generación. La mayoría de los elementos de este archivo son opcionales, pero algunos de ellos son obligatorios y deben especificarse.
  •  
  • -d espacio_trabajo: Consulte el Formato (1).
  •  
  • -e dir_instalación_WS: Consulte el Formato (1).
  •  
  • -verbose: Consulte el Formato (1).
  •  
  • -version: Consulte el Formato (1).
  •  
  • -overwrite=yes|no: si se establece en yes, este parámetro hace que los archivos generados sobrescriban los archivos existentes con los mismos nombres. Si se establece en no, se suministran nombres nuevos para los archivos generados que, de otro modo, sobrescribirían los archivos existentes. El nombre nuevo del archivo contiene como sufijo un número entero que se incrementará para cada archivo duplicado hasta que se encuentre un nombre exclusivo (por ejemplo, myfile12o.xsd). La sobrescritura de conversores y del archivo XSD puede ajustarse más mediante el valor del atributo overwrite de los elementos de especificación de generación de archivo del elemento XseSpec (consulte la sección (consulte la sección XseSpec).
  •  
  • -annot archivoSin: este parámetro especifica la vía de acceso absoluta y el nombre de archivo del archivo XML de acciones sinónimas. El archivo XML de acciones sinónimas contiene la información de anotación opcional que puede estar presente en el código fuente de las declaraciones de datos de interfaz de servicio. Si se especifica este parámetro, la información de anotación se incluye en las declaraciones de datos de interfaz de servicio en los archivos generados. La información de este archivo se aplica a todos los archivos fuente durante la invocación de xsebatch (consulte la sección Utilización de anotaciones origen para especificar la interfaz de servicio).
  •  
  • -commtypes archivoTiposCom: este parámetro especifica la vía de acceso absoluta y el nombre de archivo del archivo XML de tipos comunes. El archivo XML de tipos comunes describe los elementos y tipos comunes existentes entre todos los diversos elementos y tipos que van a utilizarse en los archivos generados. Si se especifica este parámetro, los esquemas WSDL y XSD generados harán referencia a los elementos y tipos comunes en lugar de incorporar y posiblemente duplicar los elementos y tipos. La información de este archivo se aplica a todos los archivos fuente durante la invocación de xsebatch (consulte la sección Elementos y tipos utilizados normalmente).
  •  

Mensajes de estado y error

Puede visualizar el progreso del mandato xsebatch en la consola junto con mensajes de estado y de error.

Obtener los archivos de salida

Una vez finalizada la ejecución del programa xsebatch, reinicie IBM Rational Developer for System z para ver los archivos generados en el espacio de trabajo, o acceda al sistema de archivos con el Explorador de Windows®.

Conceptos relacionados

Procesador por lotes

Tareas relacionadas

Crear y configurar archivos de propiedades de generación

Consultas relacionadas

Container.xml
PlatformProperties.xml
ServiceSpecification.xml


Términos de uso | Comentarios

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