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 dataflow. Utilisez un fichier de propriétés d'options de dataflow pour définir des options pour les stages du dataflow. Pour définir des options de dataflow à l’aide d’un fichier de propriétés, vous devez configurer le dataflow 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 dataflow pour un dataflow 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).