Exécution d'un job à partir de la ligne de commande

Avant de pouvoir exécuter un job à partir de la ligne de commande, il doit être exposé. Pour exposer un job, ouvrez-le dans Enterprise Designer et sélectionnez Fichier > Exposer/Ne plus exposer et Enregistrer.

Pour exécuter un job à partir de la ligne de commande, vous devez installer l'utilitaire Job Executor sur le système dans lequel exécuter le job. L'Exécuteur de job est disponible depuis la page d'accueil de Spectrum™ Technology Platform sur le serveur Spectrum™ Technology Platform (par exemple, http://monserver:8080).

Utilisation

java -jar jobexecutor.jar -u UserID -p Password -j Job [Optional Arguments]
Obligatoire Argument Description
Non -? Imprime les informations d'utilisation.
Non -d delimiter Définit un délimiteur d'instance/état. Ceci apparaît uniquement dans les sorties synchrones.
Non -e Utilisez une connexion HTTPS sécurisée pour communiquer avec le serveur Spectrum™ Technology Platform.
Non -f property file Indique un chemin vers un fichier de propriétés d'un job. Un fichier de propriété de job contient des arguments de Job Executor. Pour plus d'informations sur les fichiers de propriétés d'un job, voir Utilisation d'un fichier de propriétés de job.
Non -h host name Indique le nom ou l'adresse IP du serveur Spectrum™ Technology Platform.
Non -i poll interval Indique la fréquence de vérification des jobs achevés, en secondes. Ceci ne s'applique qu'en mode synchrone.
Oui -j job name Une liste de jobs séparés par des virgules à exécuter. Les noms de jobs sont sensibles à la casse. Les jobs sont lancés selon l'ordre répertorié.
Non -n email list Indique une liste d'adresses email supplémentaires séparées par des virgules pour les notifications de job configurées.
Non -o property file

Indique un chemin vers un fichier de propriétés des options de flux de données. Utilisez un fichier de propriétés d'options de flux de données pour définir des options pour les stages du flux de données. Pour définir des options de flux de données à l’aide d’un fichier de propriétés, vous devez configurer le flux de données pour qu'il expose les options de stage lors de l’exécution. Pour plus d'informations, reportez-vous à la section Ajout d'options d'exécution de flux de données.

Par exemple, un fichier de propriétés d'options de flux de données pour un flux de données contenant un stage Assign GeoTAX Info peut ressembler à ceci :

OutputCasing=U
UseStreetLevelMatching=N
TaxKey=T
Database.GTX=gsl
Oui -p password Mot de passe de l'utilisateur.
Non -r

Spécifiez cet argument pour renvoyer un rapport détaillé sur le job. Cette option ne fonctionne que si vous spécifiez également -w. Le rapport contient les informations suivantes :

  • Position 1—Nom du job
  • Position 2—ID du processus du job
  • Position 3—État
  • Position 4—Date/Heure de début (JJ/MM/AAAAA HH:MM:SS)
  • Position 5—Date/Heure de fin (JJ/MM/AAAAA HH:MM:SS)
  • Position 6—Nombre d'enregistrements ayant réussi
  • Position 7—Nombre d'enregistrements ayant échoué
  • Position 8—Nombre d'enregistrements non conformes
  • Position 9—Actuellement non employé

Par exemple :

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

Les informations sont délimitées à l'aide du délimiteur spécifié dans l'argument -d.
Non -s port Le socket (port) sur lequel le serveur Spectrum™ Technology Platform s'exécute. La valeur par défaut est 8080.
Non -t timeout Configure le délai d'attente (en secondes) pour le mode synchrone. La valeur par défaut est 3 600. La valeur maximum est 2147483. Il s'agit d'un délai d'attente global agrégé qui représente la durée d'attente maximale que tous les jobs générés se terminent.
Oui -u user name Le nom de connexion de l'utilisateur.
Non -v Renvoie une sortie détaillée.
Non -w Exécute Job Executor en mode synchrone. Cela signifie que l'exécution de Job Executor se poursuit jusqu'à ce que le job soit terminé.

Si vous ne spécifiez pas -w, Job Executor s’arrête après le démarrage du job, sauf si le job lit ou écrit dans des fichiers sur le serveur. Dans ce cas, Job Executor s’exécutera jusqu'à ce que tous les fichiers locaux soient traités, puis il s'arrêtera.
Non StageName=Protocol:FileName Remplace le fichier d'entrée ou de sortie indiqué dans Read from File ou Write to File. Pour plus d'informations, reportez-vous à la section Remplacement des emplacement des fichiers Job.
Non StageName:schema=Protocol:SchemaFile Remplace la définition de disposition de fichier spécifiée dans Read from File ou Write to File par une définition définie dans un fichier de schéma. Pour plus d'informations, reportez-vous à la section Remplacement du format de fichier dans la ligne de commande.

Exemple d'utilisation de Job Executor

L'exemple suivant affiche la ligne de commande et sa sortie :

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 9999validateAddressJob1%105%succeeded

Dans cet exemple, la sortie indique que le job nommé « validateAddressJob1 » a été exécuté (avec l'identifiant 105) sans erreur. Le résultat aurait aussi pu être « failed » (échec) ou « running » (en cours d'exécution).