Befehlszeilenschnittstelle für Stapeljobs
Die Befehlszeilenschnittstelle interagiert für die Übergabe und Bearbeitung eines Stapeljobs mit dem Job-Scheduler. Sie befindet sich wie das Script lrcmd.sh bzw. lrcmd.bat im Verzeichnis Anwendungsserverstammverzeichnis/bin und kann von jeder Position in der WebSphere-Zelle aus gestartet werden.
Verwenden Sie das Script lrcmd, um die folgenden Befehle auszuführen:
Befehl | Argumente | Beschreibung | Weitere Informationen |
---|---|---|---|
Verwendungsinformationen für lrcmd anzeigen | Keine | Der Befehl zeigt Verwendungsinformationen für den Befehl lrcmd an. | Beispiel: lrcmd |
Job an den Job-Scheduler übergeben |
|
Wenn Sie eine xJCL-Datei angeben
(XML Job Control Language, Jobsteuersprache XML), dann gibt -xJCL=<XJCL-Dateiname> den Pfad der
xJCL an, die aus dem Dateisystem übergeben und optional gespeichert werden soll.
Optionale Argumente:
Beide Varianten des Befehls geben eine Job-ID für den übergebenen Job zurück. |
Beispiele:
|
Zuvor übergebenen Job abbrechen |
|
Dieser Befehl bricht den Start eines zuvor übergebenen
Jobs oder die Ausführung eines aktiven Jobs ab. Verwenden Sie -jobid=<Job-ID> als die Job-ID, die der Job-Scheduler dem Job zugeordnet hat. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Mit dem Befehl -cmd=status kann auch die Job-ID für einen bestimmten Job ermittelt werden. Optionale Argumente:
|
Beispiel: lrcmd -cmd=cancel -jobid=myjob:2 -host=myLRShost -port=9083 |
Job erneut starten |
|
Dieser Befehl startet einen abgebrochenen Job erneut. Es können nur Jobs mit dem Status "Erneuter Start möglich"
erneut gestartet werden.
Verwenden Sie -jobid=<Job-ID> als die Job-ID, die der Job-Scheduler dem Job zugeordnet hat. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Mit dem Befehl -cmd=status kann auch die Job-ID für einen bestimmten Job ermittelt werden. Optionale Argumente:
|
Es kann nur ein Stapeljob erneut gestartet werden, dem
Stapelanwendungen zugeordnet sind.
Wenn ein Stapeljob mit dem Befehl -cmd=cancel abgebrochen wird, ändert sich sein Status in "Erneuter Start möglich".
Beim Neustart eines Jobs wird die Verarbeitung am letzten erfolgreich festgeschriebenen Prüfpunkt wieder aufgenommen. Beispiel: lrcmd -cmd=restart -jobid=myjob:2 -host=myLRShost -port=9081 |
Jobinformationen löschen |
|
Dieser Befehl löscht Jobinformationen aus dem Job-Scheduler und aus den
Grid-Endpunkten. Der Job-Scheduler verwaltet Informationen zu einem Job, nachdem der Job abgeschlossen wurde. Der Befehl "purge" löscht Jobinformationen permanent aus den Job-Scheduler- und Grid-Endpunktdatenbanken. Der Befehl löscht auch das Jobprotokoll des Jobs. Verwenden Sie -jobid=<Job-ID> als die Job-ID, die der Job-Scheduler dem Job zugeordnet hat. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Mit dem Befehl -cmd=status kann auch die Job-ID für einen bestimmten Job ermittelt werden. Optionale Argumente:
|
Der Job-Scheduler verwaltet Informationen zu einem Job, nachdem der Job abgeschlossen wurde.
Der Befehl purge löscht die Jobinformationen permanent aus den Datenbanken des
Job-Schedulers und der Grid-Endpunkt.
Der Befehl löscht auch das Jobprotokoll des Jobs.
Beispiel: lrcmd -cmd=purge -jobid=myjob:2 |
xJCL im Job-Repository speichern. |
|
Dieser Befehl speichert ein xJCL-Dokument für künftige Befehle
-cmd=submit im Job-Repository.
Optionale Argumente:
|
Beispiele:
|
Job aus dem Job-Repository entfernen. |
|
Dieser Befehl entfernt ein zuvor gespeichertes xJCL-Dokument aus dem Job-Repository.
Verwenden Sie -job=<Jobname>, um den Namen anzugeben, der dem Job zugeordnet wurde, als Sie die Datei im Job-Repository gespeichert haben.
|
Beispiel: lrcmd -cmd=remove -jobid=myjob:2 -host=myhost -port=9083 |
Status eines Stapeljobs anzeigen |
oder
|
Dieser Befehl zeigt Statusinformationen zu einem oder mehreren Jobs in der Datenbank des
Job-Schedulers an. Optionales Argument: Wenn Sie -job=<Job-ID> angeben, werden nur die Jobinformationen für den angegebenen Job angezeigt. |
Beispiele:
|
Job aussetzen |
|
Dieser Befehl setzt den Start eines Grid-Stapeljobs für den in Sekunden angegebenen Zeitraum aus.
Sofern Sie den Job nicht manuell (z. B. mit lrcmd -cmd=resume) wieder aufnehmen, wird die Ausführung des Jobs automatisch
nach dem in Sekunden angegebenen Zeitraum fortgesetzt.
Verwenden Sie -jobid=<Job-ID> als die Job-ID, die der Job-Scheduler dem Job zugeordnet hat. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Mit dem Befehl -cmd=status kann auch die Job-ID für einen bestimmten Job ermittelt werden. Optionale Argumente: Verwenden Sie -seconds=<Sekunden>, um anzugeben, wie lange (in Sekunden) der Jobstart ausgesetzt werden soll. Wenn Sie dieses Argument nicht angegeben, wird der Standardwert von 15 Sekunden verwendet. Wenn Sie -seconds=0 angeben, wird der Job erst gestartet, wenn er manuell wieder aufgenommen wird.
|
Beispiele: lrcmd -cmd=submit -xJCL=myxjcl.xml (gibt die Job-ID myjob:23 zurück). Nachdem die Ausführung des Jobs myjob:23 gestartet wurde, kann der Job mit dem folgenden Befehl beispielsweise fünf Minuten ausgesetzt werden: lrcmd -cmd=suspend -jobid=myjob:23 -seconds=300 –port=81 –host=myODRHost Die Ausführung des Jobs kann vor Ablauf der fünf Minuten mit dem folgenden Befehl fortgesetzt werden: lrcmd -cmd=resume -jobid=myjob:23. |
Start eines zuvor ausgesetzten Jobs fortsetzen |
|
Dieser Befehl setzt den Start eines zuvor ausgesetzten Stapeljobs fort. Verwenden Sie -jobid=<Job-ID> als die Job-ID, die der Job-Scheduler dem Job zugeordnet hat. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Mit dem Befehl -cmd=status kann auch die Job-ID für einen bestimmten Job ermittelt werden. |
Lesen Sie die Beschreibung zu -cmd=suspend. |
Ausgabe für einen Job anzeigen |
|
Zeigt die Ausgabe an, die vom Job-Scheduler und
Grid-Endpunkt während der Ausführung des angegebenen Jobs generiert wird.
Verwenden Sie -jobid=<Job-ID>, um die ID anzugeben, die dem Job vom Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Mit dem Befehl -cmd=status kann auch die Job-ID für einen bestimmten Job ermittelt werden. |
(keine) |
Rückkehrcode eines Stapeljobs anzeigen |
|
Zeigt den Gesamtrückkehrcode eines Grid-Stapeljobs an.
Verwenden Sie -jobid=<Job-ID>, um die ID anzugeben, die dem Job vom
Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd
-cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat.
Mit dem Befehl -cmd=status kann auch die Job-ID für einen bestimmten Job ermittelt werden.
|
(keine) |
Wiederkehrende Jobanforderung an den Job-Scheduler übergeben. |
oder
|
Übergibt eine wiederkehrende Jobanforderung an den Job-Scheduler.
Der Job-Scheduler übergibt einen Stapeljob für die angegebene
xJCL in dem mit den Argumenten definierten Zeitintervall.
Optionale Argumente:
|
Beispiele:
|
Eine vorhandene wiederkehrende Jobanforderung ändern. |
|
Argumente:
Optionale Argumente:
|
Beispiele:
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 |
Befehl | Argumente | Beschreibung | Weitere Informationen |
---|---|---|---|
Verwendungsinformationen für lrcmd anzeigen | Keine | Dieser Befehl zeigt Verwendungsinformationen für den Befehl lrcmd an. | Beispiel: lrcmd |
Ausführung eines zuvor übergebenen Jobs stoppen |
|
Dieser Befehl stoppt die Ausführung eines zuvor übergebenen Jobs bei einem Prüfpunkt.
Verwenden Sie -jobid=<Job-ID> als die Job-ID, die der Job-Scheduler dem Job zugeordnet hat. Optionale Argumente:
|
Beispiele:
|
Symbolvariablen anzeigen, die in der xJCL-Jobdefinition referenziert werden |
|
Dieser Befehl zeigt die Symbolvariablen an, die in der
xJCL-Jobdefinition referenziert werden. Verwenden Sie -jobid=<Job-ID> als die Job-ID, die der Job-Scheduler dem Job zugeordnet hat. Optionale Argumente:
|
Beispiele:
|
Jobprotokoll speichern |
|
Dieser Befehl speichert das Jobprotokoll, das der angeforderten Job-ID zugeordnet ist,
im lokalen Dateisystem.
Verwenden Sie -jobid=<Job-ID> als Job-ID, die dem Job vom Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Verwenden Sie -fileName=<Dateiname>, um den Namen einer Datei im lokalen Dateisystem anzugeben, in der die komprimierten Jobprotokolldaten gespeichert werden sollen. Die Datei wird ersetzt, wenn sie vorhanden ist. Der <Dateiname> darf keine eingebetteten Leerzeichen enthalten. Optionale Argumente:
|
Beispiele:
|
Jobprotokoll abrufen |
|
Zeigt das Jobprotokoll an, das der angeforderten Job-ID zugeordnet ist.
Verwenden Sie -jobid=<Job-ID> als Job-ID, die dem Job vom Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Optionale Argumente:
|
Beispiele:
|
Jobprotokoll löschen |
|
Entfernt das Jobprotokoll, das der angeforderten Job-ID und der Protokollzeitmarke
zugeordnet ist. Ein Jobprotokolleintrag bleibt erhalten, z. B.:
/opt/IBM/WebSphere/AppServer/profiles/scheduler/joblogs/PostingsSampleEar_99/14022007_164535/part.0.log.
Der Eintrag enthält den Grund für das Entfernen des Jobprotokolls.
|
Beispiele:
|
Jobprotokollmetadaten für die angeforderte Job-ID anzeigen |
|
Die Metadaten des Jobprotokolls enthalten die Zeitmarken
für die angeforderte Job-ID.
Die Metadaten (bzw. die Zeitmarke) identifizieren eine eindeutige
Instanz des Jobs.
Es können Protokolle mehrerer Jobs mit derselben
Jobnummer vorhanden sein. Verwenden Sie -jobid=<Job-ID> als Job-ID, die dem Job vom Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. |
Beispiele:
|
Liste der Jobprotokollabschnitte anzeigen. |
|
Zeigt den Auszug des Jobprotokolls an, der der angeforderten Job-ID und
Protokollzeitmarke zugeordnet ist.
Verwenden Sie den Befehl getLogMetaData, um eine Zeitmarke für
-logTimeStamp=<Zeitmarke> zurückzugeben. Verwenden Sie -jobid=<Job-ID> als Job-ID, die dem Job vom Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. |
Beispiele:
|
Abschnitt des Jobprotokolls anzeigen. |
|
Zeigt den Jobprotokollabschnitt an, der der angeforderten Job-ID, der
Protokollzeitmarke und dem Protokollabschnitt zugeordnet ist.
Verwenden Sie -jobid=<Job-ID> als Job-ID, die dem Job vom Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Verwenden Sie -logTimeStamp=<Protokollzeitmarke>, um die Zeitmarke (den Unterverzeichnisnamen) anzugeben, die das Jobprotokoll identifiziert, aus dem Informationen zurückgegeben werden sollen. Die Zeitmarke wird von "-cmd=getLogMetaData" zurückgegeben. Verwenden Sie -logPart=<Protokollabschnitt>, um den Abschnitt des Protokolls anzugeben, der der angeforderten Job-ID und der zurückzugebenden Zeitmarke zugeordnet ist. Die Informationen zum Protokollabschnitt werden von "-cmd=getLogPartList" zurückgegeben. |
Beispiele:
|
Größe des der angeforderten Job-ID zugeordneten Jobprotokolls anzeigen |
|
Dieser Befehl gibt die Größe des Jobprotokolls in Bytes zurück.
Verwenden Sie -jobid=<Job-ID> als Job-ID, die dem Job vom Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Verwenden Sie -logTimeStamp=<Protokollzeitmarke>, um die Zeitmarke (d. h. den Unterverzeichnisnamen) anzugeben, die das Jobprotokoll identifiziert, zu dem Auszugsinformationen zurückgegeben werden sollen. Die Zeitmarke wird von "-cmd=getLogMetaData" zurückgegeben. |
Beispiele:
|
Alter des Jobprotokolls (in Sekunden) seit der letzten Änderung des Protokolls zurückgeben |
|
Zeigt das Alter
Verwenden Sie -jobid=<Job-ID>, um die ID anzugeben, die dem Job vom Job-Scheduler zugeordnet wurde. Die Job-ID wird vom Befehl lrcmd -cmd=submit zurückgegeben, der den Job ursprünglich übergeben hat. Mit dem Befehl -cmd=status kann auch die Job-ID für einen bestimmten Job ermittelt werden. Verwenden Sie -logTimeStamp=<Protokollzeitmarke>, um die Zeitmarke (d. h. den Unterverzeichnisnamen) anzugeben, die das Jobprotokoll identifiziert, zu dem Auszugsinformationen zurückgegeben werden sollen. Die Zeitmarke wird von "-cmd=getLogMetaData" zurückgegeben. |
Beispiele:
|
Beispiel für das Abrufen der Ausgabe eines Stapeljobs:
lrcmd -cmd=output -jobid=mybatchjob:63 -host=myLRSHost -port=9081
Beispielergebnisse:
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 : Antwort auf Ausgabe
CWLRB1740I: [Wed Jun 15 17:55:36 EDT 2005] Job [mybatchjob:63] befindet sich in der Jobvorbereitung.
CWLRB1760I: [Wed Jun 15 17:55:37 EDT 2005] Job [mybatchjob:63] wurde zur Ausführung übergeben.
CWLRB2420I: [Wed Jun 15 17:55:37 EDT 2005] Job [mybatchjob:63] Abschnitt [Abschnitt1] befindet sich in der Abschnittsvorbereitung.
CWLRB2440I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Abschnitt [Abschnitt1] wurde zugeteilt.
CWLRB2460I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Abschnitt [Abschnitt1] befindet sich in der Abschnittsaufteilung.
CWLRB2600I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Abschnitt [Abschnitt1] wurde normal beendet. RC=0.
CWLRB2420I: [Wed Jun 15 17:55:39 EDT 2005] Job [mybatchjob:63] Abschnitt [Abschnitt2] befindet sich in der Abschnittsvorbereitung.
CWLRB2440I: [Wed Jun 15 17:55:39 EDT 2005] Job [mybatchjob:63] Abschnitt [Abschnitt2] wurde zugeteilt.
CWLRB2460I: [Wed Jun 15 17:55:40 EDT 2005] Job [mybatchjob:63] Abschnitt [Abschnitt2] befindet sich in der Abschnittsaufteilung.
CWLRB2600I: [Wed Jun 15 17:55:40 EDT 2005] Job [mybatchjob:63] Abschnitt [Abschnitt2] wurde normal beendet. RC=4.
Ende