Etape de travail de l'utilitaire CommandRunner

Utilisez l'étape de travail de l'utilitaire CommandRunner pour exécuter des lignes de commande de shell en tant qu'étapes de travail. Les lignes de commande de shell peuvent inclure des commandes de shell, des scripts de shell, et les programmes compilés.

L'utilitaire CommandRunner exécute la ligne de commande de shell indiquée dans un processus de système d'exploitation. La sortie standard et les flux d'erreurs standard sont capturés et écrits dans le journal de travail. Le code retour de ligne de commande est capturé et défini en tant que code retour d'étape. Si l'étape de travail est annulée, le code retour est -8.

Syntaxe de la commande

Utilisez la syntaxe suivante pour l'utilitaire CommandRunner :
<job-step name={nom_étape}>
<classname>com.ibm.websphere.batch.utility.CommandRunner</classname>
{propriétés_étape_travail}
</job-step>
Par exemple, le code d'étape de travail suivant exécute un programme Java™ de ligne de commande :
<job-step name="RunJava">
<classname>com.ibm.websphere.batch.utility.CommandRunner</classname>
<props>
<prop name="com.ibm.websphere.batch.cmdLine" 
      value="java.exe com.ibm.websphere.batch.samples.TestCase" />
<prop name="CLASSPATH" value="${user.dir}\testcases;${user.dir}\bin" />
<prop name="Path" value="${java.home}\bin;${env:Path}" />
</props>		
</job-step>

Propriété d'étape de travail requise

La propriété suivante est requise pour l'étape de travail de l'utilitaire CommandRunner.
com.ibm.websphere.batch.cmdLine
Indique l'appel de ligne de ligne, y compris les arguments.
Par exemple, exécutez le fichier java.exe comme ligne de commande :
<prop name="com.ibm.websphere.batch.cmdLine" 
          value="java.exe com.ibm.websphere.batch.samples.TestCase" />

Propriétés d'étape de travail facultatives

Les propriétés suivantes sont facultatives pour l'étape de travail de l'utilitaire CommandRunner.
com.ibm.websphere.batch.workingDir
Indique le répertoire de travail dans lequel la ligne de commande spécifiée est exécutée.
Par exemple, activez /tmp comme répertoire de travail sous Linux :
<prop name="com.ibm.websphere.batch.workingDir" value="/tmp" />

La valeur par défaut n'est pas définie.

com.ibm.websphere.batch.debug
Spécifie la valeur true ou false pour indiquer si la ligne de commande s'exécute en mode débogage ou non. Le mode débogage imprime les messages de débogage pour vous aider à résoudre les problèmes liés aux substitutions de variables et d'autres problèmes qui empêchent les lignes de commande de fonctionner correctement.
Par exemple, activez le mode débogage :
<prop name="com.ibm.websphere.batch.debug" value="true" />

La valeur par défaut est false.

com.ibm.websphere.batch.expansion
Indique la valeur true ou false pour activer ou désactiver l'extension de propriété d'étape de travail, également connu en tant que substitution de propriété. Désactivez cette fonction pour améliorer les performances des étapes avec des cartes de propriétés volumineuses qui ne dépendent pas de l'extension de propriété.
Par exemple, désactivez l'extension de propriété :
<prop name="com.ibm.websphere.batch.expansion" value="false" />

La valeur par défaut est true.

com.ibm.websphere.batch.shell.executor
Indique la commande du programme d'exécution shell. Utilisez cette propriété pour spécifier un shell personnalisé comme programme d'exécution de ligne de commande.
Par exemple, spécifiez un shell personnalisé fastshell :
<prop name="com.ibm.websphere.batch.shell.executor" value="fasthell" />

La valeur par défaut correspond à la valeur de la propriété système com.ibm.websphere.batch.command.runner.shell.executor.

com.ibm.websphere.batch.shell.failure.rc
Indique le code retour de l'échec de l'exécution de l'interpréteur de commandes (shell). Ce retour est renvoyé par le programme d'exécution de shell pour indiquer que la ligne de commande spécifiée ne peut pas être exécutée. Lorsque le code retour du programme d'exécution de shell correspond à la valeur du code retour de défaillance de shell, le travail de l'utilitaire CommandRunner affecte au code retour de l'étape du travail la valeur de la propriété com.ibm.websphere.batch.step.failure.rc.
Par exemple, le shell renvoie -1 lorsque l'exécution de la ligne de commande spécifiée échoue :
<prop name="com.ibm.websphere.batch.shell.failure.rc" value="-1" />

La valeur par défaut correspond à la valeur de la propriété système com.ibm.websphere.batch.command.runner.shell.failure_rc.

com.ibm.websphere.batch.step.failure.rc
Indique le code retour de l'étape de travail en cas d'échec de l'exécution de la ligne de commande. Ce code retour d'étape de travail est renvoyé lorsque le code retour du programme d'exécution de shell correspond à la valeur de com.ibm.websphere.batch.shell.failure.rc.
Par exemple, l'étape de travail renvoie -1 lorsque l'exécution du shell échoue :
<prop name="com.ibm.websphere.batch.step.failure.rc" value="-1" />

Propriétés système

Toutes les propriétés système de l'utilitaire CommandRunner sont facultatives.
com.ibm.websphere.batch.command.runner.shell.executor
Indique la valeur par défaut de la propriété d'étape de travail com.ibm.websphere.batch.shell.executor.

[Windows]La valeur par défaut est cmd.exe /c.

[AIX][HP-UX][Solaris][Linux][z/OS]La valeur par défaut est sh –c.

com.ibm.websphere.batch.command.runner.shell.failure_rc
Indique la valeur par défaut de la propriété d'étape de travail com.ibm.websphere.batch.shell.failure.rc.

[Windows]La valeur par défaut est 1.

[AIX][HP-UX][Solaris][Linux][z/OS]La valeur par défaut est 127.

Substitution de propriété

L'étape de travail de l'utilitaire CommandRunner prend en charge la substitution de propriété pour extension. Vous pouvez effectuer l'extension à l'aide des propriétés de substitution xJCL, des propriétés système Java et des variables de processus, comme illustré dans les exemples suivants.
Propriété de substitution xJCL
L'exemple suivant remplace la propriété de substitution xJCL testcase.dir en tant que répertoire de travail.
<prop name="com.ibm.websphere.batch.workingDir" value="${testcase.dir}" />
Propriété système Java
L'exemple suivant remplace la propriété système Java user.dir dans la variable de processus CLASSPATH :
<prop name="CLASSPATH" value="${user.dir}/classes" />
Variable de processus
L'exemple suivant remplace la variable de processus PATH dans la nouvelle valeur de la variable de processus PATH :
<prop name="PATH" value="/tmp:${env:PATH}" />
Important : Les propriétés de substitution sont traitées comme des propriétés système Java, si elles sont affichées dans la liste des propriétés système Java. Sinon, elle sont traitées comme des propriétés de substitution xJCL. La substitution de variable de processus est signalée par la syntaxe ${env:<nom de variable>}.

Variables de processus

L'utilitaire CommandRunner ajoute toutes les propriétés d'étape de travail, après substitution, au pool de variables de processus pour le processus dans lequel la ligne de commande spécifiée s'exécute.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rgrid_cmdrun
Nom du fichier : rgrid_cmdrun.html