WebSphere Extended Deployment, Version 6.0.x     Systèmes d'exploitation : AIX, HP-UX, Linux, Solaris, Windows, z/OS

Interface de ligne de commande

L'interface de ligne de commande interagit avec le planificateur pour exécution longue afin de soumettre et de manipuler des travaux à exécution longue. Elle se trouve dans le répertoire racine_was/bin et correspond au script lrcmd.sh ou lrcmd.bat ; elle peut être appelée à partir de n'importe quel emplacement dans la cellule WebSphere.

Le script lrcmd peut exécuter les commandes suivantes :

Table 1. Commandes lrcmd
Commande Arguments Description Informations supplémentaires
Afficher les informations de syntaxe de lrcmd Aucun Cette commande affiche les informations de syntaxe de la commande lrcmd. Exemple : lrcmd
Soumettre un travail au planificateur pour exécution longue -cmd=submit -xJCL=<nomfichier_xjcl> [-job= <nom_travail>(-add | -replace)][-startDate=<dateDébut> -startTime=<heureDébut>] [-host=<hôte>] [-port=<port>] ou -cmd=submit -job=<nom_travail> [-startDate=<dateDébut> - startTime=<heureDébut>] [-host=<hôte>] [-port=<port>]
Lorsqu'un fichier xJCL est spécifié, -xJCL=<nomfichier_xjcl> indique le chemin du fichier xJCL à soumettre à partir du système de fichiers et éventuellement à sauvegarder. Arguments facultatifs :
  • -job=<nom_travail> indique le nom à utiliser pour sauvegarder un fichier XJCL dans le référentiel xJCL. Pour plus d'informations, voir -cmd=save ci-après.
  • -add ajoute le fichier xJCL au référentiel des travaux en utilisant le nom de travail indiqué.
  • -replace remplace ou ajoute le fichier xJCL au référentiel des travaux en utilisant le nom de travail indiqué.
  • -startDate=<dateDébut> indique la date à laquelle le travail doit être soumis en vue de son exécution ; le format de startDate est aaaa-MM-jj. Le paramètre -startTime doit être défini.
  • startTime=<heureDébut> indique l'heure à laquelle le travail doit être soumis en vue de son exécution ; le format de startTime est HH:mm:ss. Ce paramètre requiert la définition du paramètre -startDate.
  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.

Les deux variantes de la commande renvoient l'ID du travail soumis.

Exemples :
  • lrcmd -cmd=submit -xJCL=monxjcl.xml–host=monhôte -port=81
  • lrcmd -cmd=submit -xJCL=monxjcl.xml -add -job=montravail
  • lrcmd -cmd=submit -job=montravail
  • lrcmd -cmd=submit -xJCL=C:\\monXJCL -add -job=MonTravail -port=80 -startDate=2005-11-25-startTime=23:59:00
  • lrcmd -cmd=submit -job=MonTravail -startDate=2005-11-25 -startTime=23:59:00
Annuler un travail déjà soumis -cmd=cancel -jobid=<idtravail>[-<hôte>] [-port=<port>] Cette commande annule l'exécution d'un travail déjà soumis.

-jobid=<idtravail> est l'ID attribué au travail par le planificateur de travaux à exécution longue. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Vous pouvez aussi utiliser la commande -cmd=status pour identifier l'ID d'un travail particulier.

Arguments facultatifs :
  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.
Exemple :

lrcmd –cmd=cancel –jobid=montravail:2 –host=monHôteLRS –port=9083

Redémarrer un travail -cmd=restart -jobid=<idtravail> [-host=<hôte>] [-port=<port>] Cette commande relance l'exécution d'un travail. Seuls les travaux à l'état redémarrable peuvent être redémarrés.

-jobid=<idtravail> est l'ID attribué au travail par le planificateur de travaux à exécution longue. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. La commande -cmd=status permet également d'identifier l'ID d'un travail particulier.

Arguments facultatifs :
  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.
Seuls les travaux à exécution longue associés à des travaux par lots peuvent être relancés. Lorsqu'un travail par lots est annulé à l'aide de la commande -cmd=cancel, il passe à l'état redémarrable.

Lorsqu'un travail est redémarré, le traitement reprend à partir du dernier point de contrôle validé.

Exemple :

lrcmd –cmd=restart –jobid=montravail:2 –host=monHôteLRS –port=9081

Supprimer les informations d'un travail -cmd=purge -job=<idtravail> [-host=<hôte>] [-port=<port>] Cette commande supprime les informations des travaux du planificateur pour exécution longue et des environnements d'exécution.

-jobid=<idtravail> est l'ID attribué au travail par le planificateur de travaux à exécution longue. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Vous pouvez aussi utiliser la commande -cmd=status pour identifier l'ID d'un travail particulier.

Arguments facultatifs :
  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.
Le planificateur pour exécution longue gère les informations d'un travail à l'issue du traitement. Cette commande supprime définitivement les informations des travaux du planificateur pour exécution longue et des bases de données des environnements d'exécution.

Exemple :

lrcmd –cmd=purge –jobid=montravail:2

Sauvegarder xJCL dans le référentiel des travaux -cmd=save -xJCL=<nomfichier_xjcl> -job=<nom_travail> [-host=<hôte>] [-port=<port>] Cette commande sauvegarde un document xJCL dans le référentiel des travaux pour que les commandes -cmd=submit puissent l'utiliser ultérieurement.
  • -xJCL=<nom_fichier_xjcl> indique le nom du fichier xJCL à sauvegarder.
  • -job=<nom_travail> indique le nom à utiliser lors de la sauvegarde du fichier xJCL dans le référentiel des travaux. Vous pouvez utiliser le nom du travail dans d'autres commandes
  • -cmd=submit permet de référencer le fichier xJCL sauvegardé.
Arguments facultatifs :
  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.

Exemples :

  • lrcmd -cmd=save -xJCL=monxjcl.xml -job=montravail –host=monHôteODR –port=82
  • lrcmd -cmd=submit -job=montravail
Supprimer un travail du référentiel des travaux -cmd=remove -job=<nom_travail>[-host=<hôte>] [-port=<port>] Cette commande supprime un document xJCL déjà sauvegardé du référentiel des travaux.

-job=<nom_travail> indique le nom affecté au travail lorsqu'il a été sauvegardé dans le référentiel des travaux.

  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.
Exemple :

lrcmd –cmd=remove –jobid=montravail:2 –host=monhôte –port=9083

Afficher un document xJCL stocké dans le référentiel des travaux -cmd=show -job=<nom_travail> Cette commande affiche le fichier xJCL stocké dans le référentiel des travaux.

-job=<nom_travail> indique le nom associé au travail lors de sa sauvegarde dans le référentiel des travaux.

Exemples :
  • lrcmd -cmd=save -xJCL=monxjcl.xml -job=montravail
  • lrcmd -cmd=show -job=montravail
Afficher l'état des travaux à exécution longue -cmd=status ou -cmd=status -jobid=<idtravail> [-host=<hôte>] [-port=<port>] Cette commande affiche les informations d'état d'un ou de plusieurs travaux de la base de données du planificateur pour exécution longue.

Argument facultatif : -job=<idtravail>, s'il est spécifié, indique que seules les informations du travail indiqué doivent s'afficher.

Exemples :
  • lrcmd -cmd=status host=monHôteODR –port=83
  • lrcmd -cmd=submit -xJCL=monxjcl.xml (renvoie l'ID du travail LongRunningScheduler:17)
  • lrcmd -cmd=status -jobid=LongRunningScheduler:17
Interrompre un travail -cmd=suspend -jobid=<idtravail> -seconds=<secondes>[-host=<hôte>] [-port=<port>] Cette commande interrompt l'exécution d'un travail par lots à exécution longue pendant le nombre de secondes indiqué. Si l'exécution du travail n'est pas relancée manuellement (avec lrcmd -cmd=resume, par exemple), elle reprend automatiquement à l'issue du nombre de secondes indiqué.

-jobid=<idtravail> est l'ID associé au travail par le planificateur de travaux à exécution longue. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. La commande -cmd=status permet également d'identifier l'ID d'un travail particulier.

Arguments facultatifs :

-seconds=<secondes> indique la durée d'interruption du travail (en secondes). Si vous n'indiquez pas de valeur, la valeur par défaut de 15 secondes est utilisée. Si vous indiquez -seconds=0, l'exécution du travail ne reprend pas sans intervention manuelle.

  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.

Exemples :

lrcmd -cmd=submit -xJCL=monxjcl.xml (renvoie l'ID de travail montravail:23). Une fois que myjob:23 commence à s'exécuter, vous pouvez l'interrompre pendant cinq minutes (par exemple) en entrant lrcmd -cmd=suspend -jobid=montravail:23 -seconds=300 –port=81 –host=monHôteODR

L'exécution du travail peut reprendre avant la fin des cinq minutes si vous entrez lrcmd -cmd=resume -jobid=montravail:23

Reprendre l'exécution d'un travail interrompu -cmd=resume -jobid=<idtravail>[-host=<hôte>] [-port=<port>] Cette commande reprend l'exécution d'un travail par lots interrompu.

-jobid=<idtravail> est l'ID attribué au travail par le planificateur de travaux à exécution longue. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Vous pouvez aussi utiliser la commande -cmd=status pour identifier l'ID d'un travail particulier.

Voir la description de -cmd=suspend.
Afficher les données générées d'un travail -cmd=output -jobid=<idtravail>[-host=<hôte>] [-port=<port>] Affiche les données générées par le planificateur pour exécution longue et l'environnement d'exécution lors du traitement du travail indiqué.

-jobid=<idtravail> est l'ID attribué au travail par le planificateur de travaux à exécution longue. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Vous pouvez aussi utiliser la commande -cmd=status pour identifier l'ID d'un travail particulier.

 
Afficher le code retour d'un travail par lots -cmd=getBatchJobRC -jobid=<idtravail>[-host=<hôte>] [-port=<port>] Affiche le code retour global généré par un travail par lots à exécution longue.
-jobid=<idtravail> est l'ID attribué au travail par le planificateur de travaux à exécution longue. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Vous pouvez aussi utiliser la commande -cmd=status pour identifier l'ID d'un travail particulier.
  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.
 
Soumettre une requête de travail récurrent au planificateur pour exécution longue -cmd=submitRecurringRequest -xJCL=<nom du fichier XML> -request=<nom de la requête> -startDate=<date à laquelle le premier travail est soumis>-startTime=<heure à laquelle le travail est soumis>-interval=<intervalle entre les soumissions de travaux>[-host=<hôte>] [-port=<port>] OU

-cmd=submitRecurringRequestjob=<nom_travail> -request=<nom de la requête> -startDate=<date à laquelle le premier travail est soumis>-startTime=<heure à laquelle le travail est soumis>-interval=<intervalle entre les soumissions de travaux>[-host=<hôte>] [-port=<port>]

Soumet une requête de travail récurrent au planificateur. Le planificateur soumet des travaux à exécution longue pour le fichier xJCL spécifié aux intervalles de temps indiqués par les arguments.
  • xJCL=<nomfichier_xjcl> indique le chemin d'accès au fichier xJCL à soumettre à partir du système de fichiers et éventuellement à sauvegarder.
  • -request=<nom de la requête> est le nom unique de la requête permettant d'identifier la requête de soumission de travail récurrent-startDate=<date à laquelle le premier travail est soumis indique la date à laquelle le premier travail est soumis en vue de son exécution ; le format de startDate est aaaa-MM-jj. Il requiert la définition du paramètre -startTime.
  • -startTime=<heure à laquelle le travail est soumis> indique l'heure à laquelle le premier travail et tous les travaux récurrents suivants sont soumis en vue de leur exécution ; le format de startTime est HH:mm:ss. Ce paramètre requiert la définition du paramètre -startDate.
  • -interval=<intervalle de temps entre les soumissions de travaux> indique l'intervalle de temps entre deux soumissions de travaux pour cette requête de travail récurrent ; les intervalles de temps pris en charge sont daily (quotidien), weekly (hebdomadaire) et monthly (mensuel).
Arguments facultatifs :
  • Nom du fichier XJCL sauvegardé dans le référentiel xJCL. Voir -cmd=save pour plus d'informations.
  • -host=<hôte> indique le nom d'hôte du routeur ODR ou du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est localhost.
  • -port=<port> indique l'adresse du proxy HTTP du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue. S'il n'est pas spécifié, la valeur par défaut est 80.

Exemples :

  • lrcmd :-cmd=submitRecurringRequest-xJCL=C:\\monXJCL -port=81 -request=MonRapportMensuel -interval=monthly -startDate=2006-01-02 -startTime=23:59:00
  • lrcmd -cmd=submitRecurringRequest -job=TravailHebdomadaire -request=MonRapportHebdomadaire -interval=weekly -startDate=2006-01-02 -startTime=23:59:00
Modifier une requête de travail récurrent existante lrcmd -cmd=modifyRecurringRequest -request=<nom de la requête> -xJCL=< nom du fichier XML> -interval=<intervalle de temps entre les soumissions de travaux>-startDate=<date à laquelle le premier travail est soumis> -startTime=<heure à laquelle le travail est soumis>
  • <nom de la requête> indique le nom unique de la requête permettant d'identifier cette modification de requête de soumission de travail récurrent.
  • <nom du fichier XML> indique le nom du fichier XML qui décrit le travail à exécution longue devant être planifié en vue de son exécution.
  • <intervalle de temps entre les soumissions de travaux> indique l'intervalle de temps entre deux soumissions de travaux pour cette requête de travail récurrent ; les intervalles de temps pris en charge sont daily (quotidien), weekly (hebdomadaire) et monthly (mensuel).
  • <date à laquelle le premier travail est soumis indique la date à laquelle le premier travail est soumis en vue de son exécution ; le format de startDate est aaaa-MM-jj. Ce paramètre requiert la définition du paramètre -startTime.
  • <heure à laquelle le travail est soumis> indique l'heure à laquelle le premier travail et tous les travaux récurrents suivants sont soumis en vue de leur exécution ; le format de startTime est HH:mm:ss. Ce paramètre requiert la définition du paramètre -startDate.
Vous devez définir l'un des paramètres suivants pour cette commande : -xJCL, -interval (-startDate et -startTime).

Arguments facultatifs :

  • -port: indique l'adresse HTTP proxy du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue ; la valeur par défaut est 80.
  • -host: indique l'hôte du routeur ODR ou du planificateur pour exécution longue ; la valeur par défaut est localhost.
Exemples :

lrcmd -cmd=modifyRecurringRequest -request=MonRapportHebdomadaire -xJCL=C:\\monNouveauXJCL -port=81

lrcmd -cmd=modifyRecurringRequest -request=MonRapportHebdomadaire -startDate=2006-02-02 -startTime=22:30:00 -xJCL=C:\\monXJCLFev -port=81

Annuler une requête de travail récurrent existante  
  • <nom de la requête> indique le nom unique de la requête permettant d'identifier cette requête de soumission de travail récurrent.
Exemple : lrcmd-cmd=getRecurringRequestDetails-request=MonRapportHebdomadaire-port=81
Afficher les détails d'une requête de travail récurrent existante lrcmd -cmd=getRecurringRequestDetails-request=<nom de la requête

<nom de la requête> indique le nom unique de la requête permettant d'identifier cette requête de soumission de travail récurrent.

Arguments facultatifs :
  • -port: indique l'adresse HTTP proxy du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue ; la valeur par défaut est 80.
  • -host: indique l'hôte du routeur ODR ou du planificateur pour exécution longue ; la valeur par défaut est localhost.
Exemple : lrcmd -cmd=getRecurringRequestDetails -request=MonRapportHebdomadaire-port=81
Répertorier toutes les requêtes de travaux récurrents existantes lrcmd -cmd=showAllRecurringRequests   Exemple : lrcmd -cmd=showAllRecurringRequests -port=81
Afficher tous les travaux récurrents d'une requête lrcmd -cmd=showRecurringJobs-request=<nom de la requête> <nom de la requête> indique le nom unique de la requête permettant d'identifier cette requête de soumission de travail récurrent.
Arguments facultatifs :
  • -port: indique l'adresse HTTP proxy du routeur ODR ou le port HTTP du serveur du planificateur pour exécution longue ; la valeur par défaut est 80.
  • -host: indique l'hôte du routeur ODR ou du planificateur pour exécution longue ; la valeur par défaut est localhost.
Exemples : lrcmd -cmd=showRecurringJobs -request=MonRapportHebdomadaire -port=81 lrcmd -cmd=status -jobid=<identificateur du travail>-port=80 -host=monhôteodr.com lrcmd -cmd=status -port=80-host=monhôteodr.com

Exemple

Exemple d'extraction de sortie d'un travail par lots :

lrcmd -cmd=output -jobid=mybatchjob:63 –host=monhôteLRS –port=9081

CWLRB4940I: com.ibm.websphere.batch.wsbatch : -cmd=output -jobid=mybatchjob:63

CWLRB5000I: Wed Jun 15 17:55:36 EDT 2005 : com.ibm.websphere.batch.wsbatch : réponse

CWLRB1740I: [Wed Jun 15 17:55:36 EDT 2005] Le travail [mybatchjob:63] est dans la configuration du travail.
CWLRB1760I: [Wed Jun 15 17:55:37 EDT 2005] Le travail [mybatchjob:63] est soumis pour exécution.
CWLRB2420I: [Wed Jun 15 17:55:37 EDT 2005] L'étape [Step1] du travail [mybatchjob:63] est dans la configuration d'étape.
CWLRB2440I: [Wed Jun 15 17:55:38 EDT 2005] L'étape [Step1] du travail [mybatchjob:63] est distribuée.
CWLRB2460I: [Wed Jun 15 17:55:38 EDT 2005] L'étape [Step1] du travail [mybatchjob:63] se termine.
CWLRB2600I: [Wed Jun 15 17:55:38 EDT 2005] L'étape [Step1] du travail [mybatchjob:63] s'est terminée normalement. Code retour=0.
CWLRB2420I: [Wed Jun 15 17:55:39 EDT 2005] L'étape [Step2] du travail [mybatchjob:63] est dans la configuration d'étape.
CWLRB2440I: [Wed Jun 15 17:55:39 EDT 2005] L'étape [Step2] du travail [mybatchjob:63] est distribuée.
CWLRB2460I: [Wed Jun 15 17:55:40 EDT 2005] L'étape [Step2] du travail [mybatchjob:63] se termine.
CWLRB2600I: [Wed Jun 15 17:55:40 EDT 2005] L'étape [Step2] du travail [mybatchjob:63] s'est terminée normalement. Code retour=4.
Fin



Related concepts
Gestion des applications à exécution longue

Rubrique Référence    

Conditions d'utilisation | Commentaires Dernière mise à jour le : Mar 16, 2006 9:58:13 AM EST
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=?topic=/com.ibm.websphere.xd.doc/info/scheduler/cbgcommd.html

© Copyright IBM 2005, 2006. All Rights Reserved.
Ce centre de documentation s'appuie sur la technologie Eclipse. (http://www.eclipse.org)