Interface de ligne de commande pour les travaux par lots
L'interface de ligne de commande interagit avec le planificateur de travaux pour soumettre et manipuler un travail par lots. Elle est située dans le répertoire racine_serveur_app/bin sous le nom lrcmd.sh ou lrcmd.bat et peut être lancée depuis n'importe quel emplacement dans la cellule WebSphere.
Utilisez le script lrcmd pour exécuter les commandes suivantes :
Commande | Arguments | Description | Informations supplémentaires |
---|---|---|---|
Affichage des informations de syntaxe pour lrcmd | Aucune | La commande affiche les informations de syntaxe de la commande lrcmd. | Exemple : lrcmd |
Soumission d'un travail au planificateur de travaux |
|
Lorsqu'un fichier xJCL (XML Job Control Language) est indiqué, -xJCL=<nom_fichier_xjcl> indique le chemin du fichier xJCL à soumettre à partir du système de fichiers et, facultativement, à sauvegarder. Arguments facultatifs :
Les deux variantes de la commande renvoient l'ID du travail soumis. |
Exemples :
|
Annulation d'un travail déjà soumis |
|
Cette commande annule le démarrage d'un travail déjà soumis ou l'exécution d'un
travail déjà en cours d'exécution. -jobid=<IDtravail> est l'ID attribué au travail par le planificateur de travaux. 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émarrage d'un travail |
|
Cette commande relance un travail annulé. 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. 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 :
|
Seul un travail par lots associé à des applications par lots peut être redémarré. Lorsqu'un travail par lots est annulé à l'aide de la commande -cmd=cancel, il passe à l'état redémarrable. Lorsque le 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 |
Suppression des informations d'un travail. |
|
Cette commande supprime les informations du
planificateur de travaux et des noeuds finaux de grille. Le planificateur de travaux conserve les informations relatives à un travail à l'issue du traitement. Cette commande supprime définitivement les informations du travail des bases de données du planificateur de travaux et du noeud final de grille. La commande purge également le journal des travaux. -jobid=<IDtravail> est l'ID attribué au travail par le planificateur de travaux. 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 de travaux conserve les informations relatives à un travail à l'issue du traitement. La commande purge supprime définitivement les informations relatives au travail dans les bases de données du planificateur de travaux et du noeud final de grille.
La commande purge également le journal des travaux. Exemple : lrcmd -cmd=purge -jobid=monTravail:2 |
Enregistrez un élément xJCL dans le référentiel des travaux. |
|
Cette commande enregistre un document xJCL dans le référentiel
des travaux pour une utilisation par des commandes -cmd=submit.
Arguments facultatifs :
|
Exemples :
|
Suppression d'un travail du référentiel des travaux. |
|
Cette commande supprime du référentiel des travaux
un document xJCL précédemment sauvegardé. Utilisez -job=<nom_travail> afin de spécifier le nom attribué au travail lors de la sauvegarde précédente du fichier dans le référentiel des travaux.
|
Exemple : lrcmd -cmd=remove -jobid=monTravail:2 -host=monhôte -port=9083 |
Affichage de l'état d'un travail par lots. |
or
|
Cette commande affiche les informations d'état d'un ou de plusieurs travaux
de la base de données du planificateur de travaux. Argument facultatif : s'il est indiqué, l'argument -job=<idTravail> indique que seules les informations du travail indiqué doivent s'afficher. |
Exemples :
|
Suspendre un travail. |
|
Cette commande suspend le démarrage
d'un travail de grille par lots pendant le nombre de secondes indiqué. Si vous ne relancez pas le travail manuellement (avec lrcmd -cmd=resume, par exemple), il redémarre automatiquement après le nombre de secondes défini. -jobid=<IDtravail> est l'ID attribué au travail par le planificateur de travaux. 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 : Utilisez -seconds=<secondes> pour indiquer la durée pendant laquelle le démarrage du travail est suspendu. Si vous n'indiquez pas de valeur, la valeur par défaut de 15 secondes est utilisée. Si vous indiquez -seconds=0, le travail ne démarre que lorsqu'il est repris manuellement.
|
Exemples : lrcmd -cmd=submit -xJCL=myxjcl.xml (renvoie l'ID du travail montravail:23). Dès que l'exécution du travail montravail:23 a commencé, 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 le démarrage d'un travail précédemment suspendu. |
|
Cette commande reprend le démarrage
d'un travail par lots précédemment suspendu. -jobid=<IDtravail> est l'ID attribué au travail par le planificateur de travaux. 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. |
|
Affiche les données générées par le
planificateur de travaux et le
noeud final de grille pendant l'exécution du travail indiqué. -jobid=<IDtravail> est l'ID attribué au travail par le planificateur de travaux. 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. |
(Aucune) |
Affichez le code retour d'un travail par lots. |
|
Affiche le code retour global généré par un travail de grille par lots. -jobid=<IDtravail> est l'ID attribué au travail par le
planificateur de travaux. 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.
|
(Aucune) |
Soumettre une demande de travail récurrent au planificateur de travaux. |
or
|
Soumet une demande de travail récurrente au planificateur de travaux.
Le planificateur de travaux
soumet un travail par lots pour le fichier xJCL spécifié aux intervalles de temps indiqués par les arguments.
Arguments facultatifs :
|
Exemples :
|
Modifier une demande de travail récurrente existante. |
|
Arguments :
Arguments facultatifs :
|
Exemples : lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -xJCL=C:\\myNewXJCL -port=80 lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -startDate=2006-02-02 -startTime=22:30:00 -xJCL=C:\\myFebXJCL -port=80 |
Commande | Arguments | Description | Informations supplémentaires |
---|---|---|---|
Affichage des informations de syntaxe pour lrcmd | Aucune | Cette commande affiche les informations de syntaxe de la commande lrcmd. | Exemple : lrcmd |
Arrêtez l'exécution d'un travail déjà soumis. |
|
Cette commande arrête l'exécution d'un travail déjà soumis lorsqu'un point de contrôle survient. Utilisez -jobid=<IDtravail> pour indiquer l'ID attribué au travail par le planificateur de travaux Arguments facultatifs :
|
Exemples :
|
Affichez les variables symboliques référencées dans le fichier xJCL de définition du travail. |
|
Cette commande affiche les variables symboliques référencées dans le fichier xJCL de définition du travail. Utilisez -jobid=<IDtravail> pour indiquer l'ID attribué au travail par le planificateur de travaux Arguments facultatifs :
|
Exemples :
|
Sauvegardez le journal des travaux. |
|
Cette commande sauvegarde le journal des travaux associé à l'identificateur de travail dans le système de fichiers local. Utilisez -jobid=<ID_travail> pour spécifier l'ID attribué au travail par le planificateur de travaux. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Utilisez -fileName=<nomFichier> pour indiquer le nom d'un fichier du système de fichiers local dans lequel le journal de travaux compressé doit être enregistré. S'il existe déjà, le fichier est remplacé. Le nom de fichier <nomFichier> ne doit pas contenir d'espaces imbriqués. Arguments facultatifs :
|
Exemples :
|
Extrait le journal des travaux |
|
Affiche le journal des travaux associé à l'identificateur de travail demandé. Utilisez -jobid=<ID_travail> pour spécifier l'ID attribué au travail par le planificateur de travaux. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Arguments facultatifs :
|
Exemples :
|
Purger un journal des travaux |
|
Supprime le journal de travail associé à l'identificateur
de travail et à l'horodatage demandés. Une entrée de journal subsiste. Par exemple :
/opt/IBM/WebSphere/AppServer/profiles/scheduler/joblogs/PostingsSampleEar_99/14022007_164535/part.0.log.
L'entrée indique la raison pour laquelle le journal de travail a été supprimé.
|
Exemples :
|
Affichez les métadonnées du journal des travaux pour l'identificateur de travail demandé. |
|
Les métadonnées du journal des travaux indiquent les horodatages de journal associés à l'identificateur de journal requis. Les métadonnées ou l'horodatage identifient une instance unique d'un travail. Des journaux peuvent exister pour différents travaux sous le même numéro de travail. Utilisez -jobid=<ID_travail> pour spécifier l'ID attribué au travail par le planificateur de travaux. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. |
Exemples :
|
Affichez la liste partielle du journal des travaux. |
|
Affiche la partie du journal des travaux associée à l'identificateur de travail et à l'horodatage demandés. Utilisez la commande
getLogMetaData pour renvoyer l'horodatage à utiliser avec -logTimeStamp=<horodatage>. Utilisez -jobid=<ID_travail> pour spécifier l'ID attribué au travail par le planificateur de travaux. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. |
Exemples :
|
Affichez la liste partielle du journal des travaux. |
|
Affiche la partie du journal des travaux associée à l'identificateur de travail, à l'horodatage de journal et à la partie de journal demandés. Utilisez -jobid=<ID_travail> pour spécifier l'ID attribué au travail par le planificateur de travaux. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Utilisez -logTimeStamp=<horodatage_journal> pour indiquer l'horodatage (le nom du sous-répertoire) qui identifie le journal des travaux dont des informations partielles doivent être renvoyées. L'horodatage est renvoyé par -cmd=getLogMetaData. Utilisez -logPart=<partie_journal> pour indiquer la partie du journal des travaux associée à l'identificateur et à l'horodatage du travail qui doit être renvoyée. Les informations partielles du journal sont renvoyées par -cmd=getLogPartList. |
Exemples :
|
Affichez la taille du journal de travaux associé à l'identificateur de travail demandé. |
|
Cette commande retourne la taille en octets de la connexion du travail. Utilisez -jobid=<ID_travail> pour spécifier l'ID attribué au travail par le planificateur de travaux. L'ID du travail est renvoyé par la commande lrcmd -cmd=submit qui a soumis le travail à l'origine. Utilisez -logTimeStamp=<horodatage_journal> pour indiquer l'horodatage, c'est-à-dire le nom du sous-répertoire, qui identifie le journal des travaux dont des informations partielles doivent être renvoyées. L'horodatage est renvoyé par -cmd=getLogMetaData. |
Exemples :
|
Renvoyez l'ancienneté, en secondes, du journal des travaux depuis sa dernière modification. |
|
Affiche l'ancienneté du
-jobid=<IDtravail> est l'ID attribué au travail par le planificateur de travaux. 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. Utilisez -logTimeStamp=<horodatage_journal> pour indiquer l'horodatage, c'est-à-dire le nom du sous-répertoire, qui identifie le journal des travaux dont des informations partielles doivent être renvoyées. L'horodatage est renvoyé par -cmd=getLogMetaData. |
Exemples :
|
Exemple d'extraction de sortie d'un travail par lots :
lrcmd -cmd=output -jobid=monTravailParLots:63 -host=monHôteLRS -port=9081
Résultats de l'exemple :
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 [monTravailParLots:63] est dans la configuration du travail.
CWLRB1760I: [Wed Jun 15 17:55:37 EDT 2005] Le travail [monTravailParLots:63] est soumis pour exécution.
CWLRB2420I: [Wed Jun 15 17:55:37 EDT 2005] L'étape [Step1] du travail [monTravailParLots:63] est dans la configuration d'étape.
CWLRB2440I: [Wed Jun 15 17:55:38 EDT 2005] L'étape [Step1] du travail monTravailParLots:63] est distribuée.
CWLRB2460I: [Wed Jun 15 17:55:38 EDT 2005] L'étape [Step1] du travail [monTravailParLots:63] se termine.
CWLRB2600I: [Wed Jun 15 17:55:38 EDT 2005] L'étape [Step1] du travail [monTravailParLots:63] s'est terminée normalement. Code retour=0.
CWLRB2420I: [Wed Jun 15 17:55:39 EDT 2005] L'étape [Step2] du travail [monTravailParLots:63] est dans la configuration d'étape.
CWLRB2440I: [Wed Jun 15 17:55:39 EDT 2005] L'étape [Step2] du travail [monTravailParLots:63] est distribuée.
CWLRB2460I: [Wed Jun 15 17:55:40 EDT 2005] L'étape [Step2] du travail [monTravailParLots:63] se termine.
CWLRB2600I: [Wed Jun 15 17:55:40 EDT 2005] L'étape [Step2] du travail [monTravailParLots:63] s'est terminée normalement. Code retour=4.
Fin