Die Befehlszeilenschnittstelle interagiert mit dem Job-Scheduler, wenn ein Compute-Grid-Job übergeben und bearbeitet werden soll. Sie finden die Befehlszeilenschnittstelle im Verzeichnis WAS-Stammverzeichnis/bin als Script lrcmd.sh oder lrcmd.bat und können diese von jeder Position in der WebSphere-Zelle aufrufen.
Verwenden Sie das Script lrcmd, um die folgenden Befehle auszuführen:
Befehl | Argumente | Beschreibung | Weitere Informationen |
Verwendungsinformationen für lrcmd anzeigen. | Keine | Dieser Befehl zeigt Verwendungsinformationen für den Befehl lrcmd an. | Beispiel: lrcmd |
Einen Job an den Job-Scheduler übergeben. | -cmd=submit -xJCL=<xjcl-Dateiname> [-job= <Jobname> (-add | -replace)] [-startDate=<Startdatum> -startTime=<Startzeit>] [-host=<Host>] [-port=<Port>], oder -cmd=submit -job=<Jobname> [-startDate=<Startdatum> - startTime=<Startzeit>] [-host=<Host>] [-port=<Port>] |
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:
|
Einen zuvor übergebenen Job abbrechen. | -cmd=cancel -jobid=<Job-ID> [-<Host>] [-port=<Port>] |
Dieser Befehl bricht den Start eines zuvor übergebenen
Jobs oder die Ausführung eines gerade ausgeführten 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=meinjob:2 -host=meinLRShost -port=9083 |
Einen Job erneut starten. | -cmd=restart -jobid=<Job-ID> [-host=<Host>] [-port=<Port>] |
Dieser Befehl startet die Ausführung eines Jobs erneut. Es können nur Jobs in einem wieder anlauffähigen
Status 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 Compute-Grid-Job 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=meinjob:2 -host=meinLRShost -port=9081 |
Jobinformationen löschen. | -cmd=purge -job=<Job-ID> [-host=<Host>] [-port=<Port>] |
Dieser Befehl löscht Jobinformationen aus dem Job-Scheduler und aus den
Grid-Endpunkte. 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=meinjob:2 |
xJCL im Job-Repository speichern | -cmd=save -xJCL=<xjcl-Dateiname> -job=<Jobname> [-host=<Host>] [-port=<Port>] |
Dieser Befehl speichert ein xJCL-Dokument im Job-Repository, so dass es von
nachfolgend ausgeführten Befehlen -cmd=submit wieder verwendet werden kann.
Optionale Argumente:
|
Beispiele:
|
Job aus dem Job-Repository entfernen | -cmd=remove -job=<Jobname> [-host=<Host>] [-port=<Port>] |
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 zuvor im Job-Repository gespeichert haben.
|
Beispiel:
lrcmd -cmd=remove -jobid=meinjob:2 -host=meinhost -port=9083 |
Im Job-Repository gespeicherte xJCL anzeigen | -cmd=show -job=<Jobname> |
Dieser Befehl zeigt die im Job-Repository gespeicherte xJCL an.
Verwenden Sie -job=<Jobname>, um den Namen anzugeben, der dem Job zugeordnet wurde, als er im Job-Repository gespeichert wurde. |
Beispiele:
|
Status eines Compute-Grid-Jobs anzeigen | -cmd=statusoder -cmd=status -jobid=<Job-ID> [-host=<Host>] [-port=<Port>] |
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:
|
Einen Job aussetzen | -cmd=suspend -jobid=<Job-ID> -seconds=<Sekunden> [-host=<Host>] [-port=<Port>] |
Dieser Befehl setzt den Start eines Grid-Stapeljobs für die angegebene Anzahl Sekunden aus.
Sofern Sie den Job nicht manuell (z. B. mit "lrcmd -cmd=resume") wieder aufnehmen, wird die Ausführung des Jobs automatisch
nach der angegebenen Anzahl von Sekunden 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=meinexjcl.xml (gibt die Job-ID meinjob:23 zurück). Nachdem die Ausführung des Jobs meinjob:23 gestartet wurde, kann der Job mit dem folgenden Befehl beispielsweise fünf Minuten ausgesetzt werden: lrcmd -cmd=suspend -jobid=meinjob:23 -seconds=300 –port=81 –host=meinODRHost Die Ausführung des Jobs kann vor Ablauf der fünf Minuten mit dem folgenden Befehl fortgesetzt werden: lrcmd -cmd=resume -jobid=meinjob:23. |
Start eines zuvor ausgesetzten Jobs fortsetzen | -cmd=resume -jobid=<Job-ID> [-host=<Host>] [-port=<Port>] |
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 | -cmd=output -jobid=<Job-ID> [-host=<Host>] [-port=<Port>] |
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 | -cmd=getBatchJobRC -jobid=<Job-ID> [-host=<Host>] [-port=<Port>] |
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) |
Sich wiederholende Jobanforderung an den Job-Scheduler übergeben | -cmd=submitRecurringRequest -xJCL=<XML-Dateiname> -request=<Name der Anforderung> -startDate=<Datum der ersten Übergabe des Jobs> -startTime=<Uhrzeit der ersten Übergabe des Jobs> -interval=<Intervall zwischen Jobübergaben> [-host=<Host>] [-port=<Port>]oder -cmd=submitRecurringRequestjo b=<Jobname> -request=<Name der Anforderung> -startDate=<Datum der ersten Übergabe des Jobs> -startTime=<Uhrzeit der ersten Übergabe des Jobs> -interval=<Intervall zwischen Jobübergaben> [-host=<Host>] [-port=<Port>] |
Übergibt eine sich wiederholende Jobanforderung an den Job-Scheduler.
Der Job-Scheduler übergibt einen Compute-Grid-Job in
den mit den Argumenten angegebenen Zeitintervallen an die angegebene
xJCL.
Optionale Argumente:
|
Beispiele:
|
Eine vorhandene sich wiederholende Jobanforderung ändern | lrcmd -cmd=modifyRecurringRequest -request=<Name der Anforderung> -xJCL=<XML-Dateiname> -interval=<Intervall zwischen Jobübergaben> -startDate=<Datum der ersten Übergabe des Jobs> -startTime=<Uhrzeit der ersten Übergabe des Jobs> |
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 |
Eine vorhandene sich wiederholende Jobanforderung abbrechen | -cmd=cancelRecurringRequest -request=<Job-ID> [-<Host>] [-port=<Port>] (keine) |
Argumente:
|
Beispiel: lrcmd-cmd=cancelRecurringRequest -request=MyWeeklyReport -port=80 |
Details einer vorhandenen sich wiederholenden Jobanforderung anzeigen | lrcmd -cmd=getRecurringRequestDetails -request=<Name der Anforderung> |
Verwenden Sie <Name_der_Anforderung> als eindeutigen Namen für die Anforderung, der verwendet wird, um die sich wiederholende Jobübergabeanforderung zu identifizieren. Optionale Argumente:
|
Beispiel: lrcmd -cmd=getRecurringRequestDetails -request=MyWeeklyReport-port=80 |
Alle vorhandenen sich wiederholenden Jobanforderungen auflisten | lrcmd -cmd=showAllRecurringRequests |
Ohne | Beispiel: lrcmd -cmd=showAllRecurringRequests -port=80 |
Alle sich wiederholenden Jobs einer Anforderung anzeigen | lrcmd -cmd=showRecurringJobs -request=<Name der Anforderung> |
Verwenden Sie <Name_der_Anforderung> als eindeutigen Namen für die
Anforderung, der verwendet wird, um die sich wiederholende Jobübergabeanforderung zu identifizieren.
Optionale Argumente:
|
Beispiele: lrcmd -cmd=showRecurringJobs -request=MeinWeeklyReport -port=81lrcmd -cmd=status -jobid=<job-ID>-port=80 -host=meinodrhost.comlrcmd -cmd=status -port=80-host=meinodrhost.com |
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 | -cmd=stop [-jobid=<Job-ID> [-host=<Host>] [-port=<Port>] |
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:
|
Zeigt die Symbolvariablen an, die in der xJCL-Jobdefinition referenziert werden. | -cmd=getSymbolicVariables -xJCL=<xjcl-Datei> [-<Host>] [-port=<Port>] |
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:
|
Speichert das Jobprotokoll. | -cmd=saveJobLog -jobid=<Job-ID> [-host=<Host>] [-fileName=<Dateiname>] |
Dieser Befehl speichert das Jobprotokoll, das der angefordrdten 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:
|
Das Jobprotokoll abrufen. | -cmd=getJobLog -jobid=<Job-ID> |
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 |
-cmd=getJobLog -jobid=<Job-ID> -logTimeStamp=<Protokollzeitmarke> |
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:
|
Zeigt die Metadaten des Jobprotokolls für die angeforderte Job-ID an. | -cmd=getLogMetaData -jobid=<Job-ID> |
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:
|
Zeigt einen Auszug des Jobprotokolls an. | -cmd=getLogPartList -jobid=<Job-ID> -logTimeStamp=<Protokollzeitmarke> |
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:
|
Den Jobprotokollabschnitt anzeigen. | -cmd=getLogPart -jobid=<Job-ID> -logTimeStamp=<Protokollzeitmarke> -logPart=<Protokollabschnitt> |
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:
|
Informationen zu Jobs anzeigen, die der angeforderten Jobklasse zugeordnet sind. | -cmd=getJobsByClass -class=<Klasse> |
Die zurückgegebenen Informationen enthalten die Jobverzeichnisstruktur.
Beispiel: Jobverzeichnis/Zeitmarkenverzeichnis, z. B.
MeineAnw_1/20102006_155529 Verwenden Sie -class=<Klasse>, um den Namen der Jobklasse anzugeben, deren Job-IDs zurückgegeben werden sollen. |
Beispiele:
|
Die Größe des der angeforderten Job-ID zugeordneten Jobprotokolls anzeigen. | -cmd=getLogSize -jobid=<Job-ID> -logTimeStamp=<Protokollzeitmarke> |
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 Jobprotokol identifiziert, zu dem Auszugsinformationen zurückgegeben werden sollen. Die Zeitmarke wird von "-cmd=getLogMetaData" zurückgegeben. |
Beispiele:
|
Der Befehl gibt das Alter des Jobprotokolls in Sekunden seit der letzten Änderung zurück. | -cmd=getLogAge -jobid=<Job-ID> -logTimeStamp=<Protokollzeitmarke> |
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 Jobprotokol 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=meinStapeljob:63 -host=meinLRSHost -port=9081
CWLRB4940I: com.ibm.websphere.batch.wsbatch : -cmd=output -jobid=meinbatchjob: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 [meinbatchjob:63] befindet sich in der Jobvorbereitung. CWLRB1760I: [Wed Jun 15 17:55:37 EDT 2005] Job [meinbatchjob:63] wurde zur Ausführung übergeben. CWLRB2420I: [Wed Jun 15 17:55:37 EDT 2005] Job [meinbatchjob:63] Abschnitt [Abschnitt1] befindet sich in der Abschnittsvorbereitung. CWLRB2440I: [Wed Jun 15 17:55:38 EDT 2005] Job [meinbatchjob:63] Abschnitt [Abschnitt1] wurde zugeteilt. CWLRB2460I: [Wed Jun 15 17:55:38 EDT 2005] Job [meinbatchjob:63] Abschnitt [Abschnitt1] befindet sich in der Abschnittaufteilung. CWLRB2600I: [Wed Jun 15 17:55:38 EDT 2005] Job [meinbatchjob:63] Abschnitt [Abschnitt1] wurde normal beendet. RC=0. CWLRB2420I: [Wed Jun 15 17:55:39 EDT 2005] Job [meinbatchjob:63] Abschnitt [Abschnitt2] befindet sich in der Abschnittvorbereitung. CWLRB2440I: [Wed Jun 15 17:55:39 EDT 2005] Job [meinbatchjob:63] Abschnitt [Abschnitt2] wurde zugeteilt. CWLRB2460I: [Wed Jun 15 17:55:40 EDT 2005] Job [meinbatchjob:63] Abschnitt [Abschnitt2] befindet sich in der Abschnittaufteilung. CWLRB2600I: [Wed Jun 15 17:55:40 EDT 2005] Job [meinbatchjob:63] Abschnitt [Abschnitt2] wurde normal beendet. RC=4. End