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 :
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 :
Les deux variantes de la commande renvoient l'ID du travail soumis. |
Exemples :
|
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 :
|
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 :
|
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 :
|
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.
Arguments facultatifs :
|
Exemples :
|
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.
|
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 :
|
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 :
|
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.
|
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.
|
|
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.
Arguments facultatifs :
|
Exemples :
|
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> |
Arguments facultatifs :
|
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 |
|
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 :
|
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 :
|
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 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