Ejecución de un trabajo desde la línea de comandos

Antes de que pueda ejecutar un trabajo desde la línea de comandos, debe estar expuesto. Para exponer un trabajo, abra el trabajo en Enterprise Designer y seleccione Archivo > Exponer o anular exposición y Guardar.

Para ejecutar un trabajo desde la línea de comandos, debe instalar la utilidad del ejecutor de trabajos del sistema en que desea ejecutar el trabajo. Job Executor está disponible en la página de bienvenida de Spectrum™ Technology Platform en el servidor Spectrum™ Technology Platform (por ejemplo, http://myserver:8080).

Uso

java -jar jobexecutor.jar -u UserID -p Password -j Job [Optional Arguments]
Requerido Argumento Descripción
No -? Imprime información de uso.
No -d delimiter Configura un delimitador de instancia/estado. Solo aparece en la salida sincronizada.
No -e Utiliza una conexión HTTPS segura para comunicarse con el servidor Spectrum™ Technology Platform.
No -f property file Especifica una ruta a un archivo de propiedades de un trabajo. Un archivo de propiedades del trabajo contiene argumentos del ejecutor de trabajos. Para obtener más información sobre archivos de propiedades de trabajos, consulte Utilización de un archivo de propiedades de trabajo.
No -h host name Especifica el nombre o la dirección IP del servidor Spectrum™ Technology Platform.
No -i poll interval Especifica la frecuencia con que se verifican los trabajos completos, en segundos. Solo se aplica en el modo sincronizado.
Sí -j job name Lista de trabajos por ser ejecutados, separados por comas. Los nombres de los trabajos distinguen mayúsculas de minúsculas. Los trabajos comienzan según el orden de la lista.
No -n email list Especifica una lista de direcciones de correo electrónico adicionales separadas por comas para las notificaciones de trabajos configuradas.
No -o property file

Especifica una ruta a un archivo de propiedades de opciones de flujo de datos. Use un archivo de propiedades de opciones de flujo de datos para configurar las opciones de las etapas del flujo de datos. Para establecer las opciones de flujo de datos con un archivo de propiedades, debe configurar el flujo de datos para exponer las opciones de etapa durante el tiempo de ejecución. Para obtener más información, consulte Incorporación de opciones de tiempo de ejecución para el flujo de datos.

Por ejemplo, un archivo de propiedades de opciones de flujo de datos para un flujo de datos que contiene la etapa Assign GeoTAX Info puede tener el siguiente aspecto:

OutputCasing=U
UseStreetLevelMatching=N
TaxKey=T
Database.GTX=gsl
Sí -p password La contraseña del usuario.
No -r

Especifique este argumento para devolver un informe detallado sobre el trabajo. Esta opción solo funciona si también especifica --w. El informe ofrece la siguiente información:

  • Posición 1: nombre del trabajo
  • Posición 2: ID de procesamiento del trabajo
  • Posición 3: estado
  • Posición 4: fecha/hora de comienzo (MM/DD/AAAA HH:MM:SS)
  • Posición 5: fecha/hora de finalización (MM/DD/AAAA HH:MM:SS)
  • Posición 6: número de registros exitosos
  • Posición 7: número de registros fallidos
  • Posición 8: número de registros malformados
  • Posición 9: registros que actualmente no están en uso

Por ejemplo:

MySimpleJob|4|succeeded|04/09/2010 14:50:47|04/09/2010 14:50:47|100|0|0|

La información se delimita utilizando un delimitador especificado en el argumento -d.
No -s port Socket (puerto) en el que se ejecuta el servidor Spectrum™ Technology Platform. El valor predeterminado es 8080.
No -t timeout Establece el límite de espera (en segundos) para el modo sincronizado. El valor predeterminado es 3600. El valor máximo es 2147483. El límite de espera es global y agregado, y representa el tiempo máximo que se esperará para que se completen todos los trabajos generados.
Sí -u user name Nombre de inicio de sesión del usuario.
No -v Devuelve una salida detallada.
No -w Ejecuta el ejecutor de trabajos en modo sincronizado. Esto significa que el ejecutor de trabajos permanece en ejecución hasta que el trabajo finaliza.

Si no especifica -w, el ejecutor de trabajos deja de funcionar después de empezar el trabajo, a menos que el trabajo lea desde los archivos o les escriba en el servidor. En este caso, el ejecutor de trabajos se ejecutará hasta que todos los archivos locales se procesen y luego dejará de funcionar.
No StageName=Protocol:FileName Anula el archivo de entrada o de salida especificado en Read from File o Write to File. Para obtener más información, consulteSobrescribir ubicaciones de archivos de trabajo.
No StageName:schema=Protocol:SchemaFile Anula la definición de diseño de un archivo especificada en Read from File o Write to File y la reemplaza por una definida en un archivo de esquema. Para obtener más información, consulteReemplazo del formato de archivo en la línea de comandos.

Ejemplo de utilización de Job Executor

Los siguientes ejemplos muestran la salida e invocación de una línea de comandos:

D:\spectrum\job-executor>java -jar jobexecutor.jar -u user123 -p "mypassword" -j validateAddressJob1 -h spectrum.example.com -s 8888 -w -d "%" -i 1 -t 9999

validateAddressJob1%105%succeeded

En este ejemplo, la salida indica que el trabajo denominado 'validateAddressJob1' se ejecutó (con el identificador 105) sin errores. Otro posible resultado es "falló" o "en ejecución".