El procesador por lotes
es una interfaz de línea de mandatos destinada a crear descripciones de servicios Web de
empresa y conversores de mensajes para aplicaciones
CICS
e IMS.
Acerca de esta tarea
Antes de ejecutar el procesador por lotes, cierre las instancias de
IBM® Rational Developer
para System
z en ejecución que utilice 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):
xsebatch
-s archivoLenguaje [-c | -w nombreServicio] | [-c -w nombreServicio]
-f archivoContenedor [-d espaciotrabajo] [-e directorioinstalación_WS]
[-verbose] [-version]
[-overwrite=yes|no] [-annot synFile] [-commtypes commTypesFile]
En este mandato,
archivoLenguaje es el nombre del archivo fuente de lenguaje que contiene la definición de
mensaje. Puede alterar temporalmente este nombre mediante la opción de especificación de mensaje
del archivo ServiceSpecification.xml.
Especificará
los parámetros -c, -w o ambos, del siguiente modo:
- -c
provocará 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 producirá 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".
La
variable archivoContenedor es 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.
Los
parámetros siguientes son opcionales:
- -d
espaciotrabajo es la vía de acceso totalmente calificada del espacio de trabajo que debe
utilizarse para la importación. Si no se especifica la vía de acceso, el valor
predeterminado se toma de la variable de entorno %workspace%. Si no se establece esta
variable de entorno, el valor predeterminado se establece en %eclipse_root%\workspace
- -e WS_installdir es el subdirectorio del directorio de Eclipse en el que está instalado
IBM Rational Developer
para System
z. Si no se especifica, el valor predeterminado se toma de la
variable de entorno %eclipse_root%. Si no se establece esta variable de entorno, 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 Windows® WDZ71INSTDIR."
Nota: Si
los nombres de directorio contienen espacios (por ejemplo, c:\test one\IBM), debe especificarlos
entre comillas dobles (por ejemplo, "c:\test one\IBM"). 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
barras inclinadas invertidas ('\') finales en ninguno de los nombres de vía de acceso
para las opciones -d y -e ni en las variables de entorno %workspace% y %eclipse_root%.
- -verbose
provoca la impresión de los mensajes de diagnóstico en la consola.
- -version
provoca la impresión de la información de versión, release y modificación en la consola.
- -overwrite:
si se establece en "yes" (valor predeterminado) provoca que la herramienta
sobrescriba todos los archivos generados. Si se establece en "no", se genera un
nombre de archivo nuevo para cada archivo existente. El nombre nuevo del archivo
contendrá 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 grupo
XseSpec descrito en la sección Consulta: Elementos de esquemas XML para el procesador por
lotes.
- -annot archSin: se puede utilizar para especificar la vía de acceso absoluta
para la ubicación y el nombre en el sistema de archivos del archivo XML de acciones sinónimas
(archSin). El archivo XML de
acciones sinónimas contiene la información de anotación opcional que puede estar presente en
el origen de las declaraciones de datos de interfaz de servicio.
La información de este
archivo se aplica a todos los archivos origen durante la invocación de
xsebatch. Para obtener más información, consulte la
sección Utilización de anotaciones origen para especificar la interfaz de servicio.
- -commtypes commTypesFile: se puede utilizar para especificar la vía de acceso
absoluta para la ubicación y el nombre del sistema de archivos del archivo XML de tipos comunes
(commTypesFile). El XML de tipos comunes describe la información de elementos y tipos comunes que
se utiliza en los esquemas WSDL y XSD generados para las referencias en lugar de incorporar y posiblemente
duplicar los tipos. La información de este
archivo se aplica a todos los archivos origen durante la invocación de
xsebatch. Para obtener más información, consulte la
sección Elementos y tipos utilizados normalmente.
Todas las demás opciones de generación
se especifican en archivos XML (directamente en el archivo contenedor o en los archivos
XML que contiene el archivo contenedor).
Qué hacer a continuación
Puede
visualizar el progreso del mandato xsebatch en la consola junto con los mensajes de error.
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 llenar archivos de propiedades de generación
Consultas relacionadas
Container.xml
PlatformProperties.xml
ServiceSpecification.xml