R3_ACTIVATE_JOBS

Verwenden Sie das Script-Element R3_ACTIVATE_JOBS, um Jobs auszuführen, die in SAP unter der Kontrolle der Automation Engine eingeplant wurden. Die zu startenden Jobs werden aus einer Liste gewählt. Die Auswahlkriterien werden in Form von Parametern zugewiesen. Die verwendete Transaktion ist SM37.

Tipp: Sie können PREP_PROCESS_FILE verwenden, um die Ausgabe zu durchsuchen und Reaktionen zu definieren.

Diese Seite beinhaltet Folgendes:

AE-Schnittstelle

Syntax

R3_ACTIVATE_JOB[S]

    NAME=...
    [,JOBCOUNT=...]
    [,GROUP=...]
    [,USER=...]
    [,NOFOUND=...]
    [,ERROR=...]
    [,SELECT=...]
    [,START=...]
    [,NEW_NAME=...]
    [,START_D[ATE]=...]
    [,START_T[IME]=...]
    [,END_D[ATE]=...]
    [,END_T[IME]=...]
    [,NO_DATE=...]
    [,TARGET_S[ERVER]=...]
    [,BEG_LOGLINES=...]
    [,END_LOGLINES=...]
    [,GET_SPOOL=...]

Parameter

  • R3_ACTIVATE_JOB[S]
    Führt Jobs aus, die in SAP unter der Kontrolle der AE eingeplant wurden

  • NAME=
    Wählt einen oder mehrere Intercepted Jobs anhand ihrer Namen aus. Verwenden Sie diesen Parameter zusammen mit dem Parameter JobCOUNT=, um einen einzelnen SAP-Job eindeutig zu identifizieren. Um mehrere Jobs auszuwählen, können Sie das Platzhalterzeichen * verwenden, wie beispielsweise xxx*.
    Format: Script-Literal oder AE-Name

  • JOBCOUNT=
    (Optional) Nummer des SAP-Jobs. Verwenden Sie diesen Parameter zusammen mit dem Parameter NAME=, um einen einzelnen SAP-Job eindeutig zu identifizieren
    Format: Script-Literal

  • GROUP=
    (Optional) Wählt Aufträge auf der Grundlage von Gruppen aus, wie beispielsweise xxx*.
    Format: Script-Literal oder AE-Name
    Standardwert: "*"

  • USER=
    (Optional) Wählt Jobs auf der Grundlage von Benutzern aus, wie beispielsweise xxx*.
    Format: Script-Literal oder AE-Name
    Standardwert: "*"

  • NOFOUND=
    (Optional) Aktion, die ausgeführt werden soll, wenn keine Jobs gefunden werden
    Format: Script-Literal
    Erlaubte Werte:

    • NORMAL (Standard)
      Script-Ausführung wird fortgesetzt, der AE-Job endet normal

    • ABEND
      Script-Ausführung stoppt, der AE-Job endet vorzeitig

  • ERROR=
    (Optional) Aktion, die ausgeführt werden soll, wenn einer der ausgewählten Jobs frühzeitig endet
    Format: Script-Literal
    Erlaubte Werte:

    • ABEND (Standard)
      Script-Ausführung endet, der AE-Job endet vorzeitig

    • IGNORE
      Die Script-Ausführung wird fortgesetzt, der AE-Job endet vorzeitig

  • SEL[ECT]=
    (Optional) Die Auswahl gilt einmalig oder dauerhaft
    Format: Script-Literal
    Erlaubte Werte:

    • ONCE (Standard)
      Die Anzahl der ausgewählten Jobs wird einmalig abgerufen

    • EVERY
      Die Anzahl der ausgewählten Jobs wird nach jeder Job-Freigabe abgerufen. Deshalb können freigegebene Jobs parallel ausgeführt werden.

  • START=
    (Optional) Legt fest, ob der ursprüngliche Job oder ein Duplikat gestartet werden soll
    Format: Script-Literal
    Erlaubte Werte:

    • ORIGINAL (Standard)

    • DUPLICATE

  • NEW_NAME=
    (Optional) Name des Jobs, der als Duplikat gestartet werden soll
    Verwenden Sie diesen Parameter nur in Kombination mit START=DUPLICATE, andernfalls, wird dieser Parameter ignoriert.
    Format: Script-Literal

  • START_D[ATE]=
    (Optional) Startdatum für die ausgewählten eingeplanten Jobs. Wenn Sie diesen Parameter ohne den Parameter END_DATE= verwenden, werden alle geplanten Jobs ausgewählt und starten an dem Startdatum, das Sie hier angeben.
    Format: Script-Literal
    Datumsformat: JJJJMMTT
    Standardwert: 20000101

  • START_T[IME]=
    (Optional) Startzeit für die ausgewählten eingeplanten Jobs. Wenn Sie diesen Parameter ohne den Parameter END_TIME= verwenden, werden alle eingeplanten Jobs ausgewählt und starten zu der angegebenen Startzeit. 23:59 Uhr ist die angewendete Endzeit in diesem Fall.
    Format: Script-Literal
    Zeitformat: HHMMSS
    Standardwert: 000000

  • END_D[ATE]=
    (Optional) Enddatum für die ausgewählten eingeplanten Jobs. Verwenden Sie das gleiche Datum für diesen Parameter UND den Parameter START_DATE=, wenn Sie alle Aufträge auswählen möchten, die an diesem Tag eingeplant sind.
    Format: Script-Literal
    Datumsformat: JJJJMMTTD
    Standardwert: aktuelles Datum

  • END_T[IME]=
    (Optional) Endzeit für die ausgewählten eingeplanten Jobs.
    Format: Script-Literal
    Zeitformat: HHMMSS
    Standardwert: 235959

  • NO_DATE=
    (Optional) Gilt für Jobs ohne Startdatum
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:

    • "" (Standard)

    • X

  • TARGET_S[ERVER]=(Optional)
    Zielsystem, das der freigegebene SAP-Job verwenden soll.
    Format: Script-Literal
    Erlaubte Werte:

    • KEEP(Standard)
      Das im ursprünglichen Job definierte Zielsystem wird beibehalten

    • ATTRIBUTE
      Das Zielsystem, das in den Hostattributen des Jobs definiert ist, wird verwendet.

  • BEG_LOGLINES=
    (Optional) Dieser Parameter bestimmt die Anzahl der Zeilen, die an den AE-Job-Report weitergegeben werden sollen, gezählt ab dem Anfang des SAP-Job-Logs

  • END_LOGLINES=
    (Optional) Legt die Anzahl der Zeilen fest, die dem AE-Jobreport ab dem Ende des SAP-Joblogs hinzugefügt werden sollen
    Standardwert: Das vollständige Joblog wird verwendet, wenn weder END_LOGLINES noch BEG_LOGLINES definiert sind. Wenn Sie nur einen dieser beiden Parameter definieren, werden die entsprechenden Zeilen des Job-Logs entweder vom Anfang oder vom Ende aus gelesen. Es wird kein Job-Log hinzugefügt, wenn Sie in beiden Parametern den Wert 0 definieren.
    Erlaubte Werte: Zahlen

  • GET_SPOOL=
    (Optional) Fordert die Spool-Liste des gestarteten Jobs an
    Format: Script-Literal
    Erlaubte Werte:

    • NO (Standard)
      Die Spool-Liste wird nicht angefordert.

    • YES
      Die Spool-Liste wird angefordert. Sie wird als Textdatei in dem Verzeichnis abgelegt, das in der INI- Datei des SAP-Agenten mit dem Parameter Download_dir= (Abschnitt [GLOBAL]) definiert wurde. Weitere Informationen finden Sie unter Agent SAP.

      Der Name der Textdatei ist wie folgt aufgebaut:
      <SAP-Jobzähler>_<Schrittnummer>_<Spool-Nummer>.txt
      Diese Datei wird auch als Jobausgabe im AE-Job registriert. Weitere Informationen finden Sie unter Registrierte Job-Ausgabe.

Beispiele

Das folgende Beispiel gibt alle Jobs frei, die vom Benutzer NI eingeplant wurden:

R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='NI'

Das zweite Beispiel wählt alle Aufträge aus, die zwischen dem 01.07.2020, 12:00:00 und 02.07.2020, 23:59:59 eingeplant sind.

R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='SUPPORT',START_DATE='20200701',END_DATE='20200702'

Das dritte Beispiel wählt alle Jobs aus, die zwischen dem 01.07.2020, 12:30:00 Uhr und dem 02.07.2020, 12:30:00 eingeplant sind.

R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='SUPPORT',START_DATE='20200701',END_DATE='20200702'

Standard-Schnittstelle

Syntax

R3_ACTIVATE_JOB[S]

    NAME=...
    [,JOBCOUNT=...]
    [,NOFOUND=...]
    [,ERROR=...]
    [,SELECT=...]
    [,START=...]
    [,NEW_NAME=...]
    [,START_D[ATE]=...]
    [,START_T[IME]=...]
    [,END_D[ATE]=...]
    [,END_T[IME]...]
    [,TARGET_S[ERVER]...]
    [,MON[ITOR]...]
    [,WAIT...]
    [,ABORTED...]
    [,REPL[ICATE]...]
    [,END_LOGLINES=...]
    [,GET_SPOOL=...]

Parameter

  • R3_ACTIVATE_JOB[S]
    Führt Jobs aus, die in SAP unter der Kontrolle der AE eingeplant wurden

  • NAME=
    Wählt einen oder mehrere Intercepted Jobs anhand ihrer Namen aus. Verwenden Sie ihn zusammen mit dem Parameter JOBCOUNT, um einen bestimmten SAP-Job eindeutig zu identifizieren. Um mehrere Jobs auszuwählen, können Sie das Platzhalterzeichen * verwenden, wie beispielsweise xxx*.
    Format: Script-Literal oder AE-Name

  • JOBCOUNT=
    (Optional) Nummer des SAP-Jobs
    Verwenden Sie ihn zusammen mit dem Parameter NAME, um einen individuellen SAP-Job eindeutig zu identifizieren.
    Format: Script-Literal

  • NOFOUND=
    (Optional) Aktion, die ausgeführt werden soll, wenn keine Jobs gefunden werden
    Format: Script-Literal
    Erlaubte Werte:

    • NORMAL (Standard)
      Script-Ausführung wird fortgesetzt, der AE-Job endet normal

    • ABEND
      Script-Ausführung stoppt, der AE-Job endet vorzeitig

  • ERROR=
    (Optional) Aktion, die ausgeführt werden soll, wenn einer der ausgewählten Jobs frühzeitig endet
    Format: Script-Literal
    Erlaubte Werte:

    • ABEND (default)
      Script-Ausführung endet, der AE-Job endet vorzeitig

    • IGNORE
      Die Script-Ausführung wird fortgesetzt, der AE-Job endet vorzeitig

  • SEL[ECT]=
    (Optional) Die Auswahl gilt einmalig oder dauerhaft
    Format: Script-Literal
    Erlaubte Werte:

    • ONCE (Standard)
      Die Anzahl der ausgewählten Jobs wird einmalig abgerufen

    • EVERY
      Die Anzahl der ausgewählten Jobs wird nach jeder Job-Freigabe abgerufen. Deshalb können freigegebene Jobs parallel ausgeführt werden.

  • START=
    (Optional) Legt fest, ob der ursprüngliche Job oder ein Duplikat gestartet werden soll
    Format: Script-Literal
    Erlaubte Werte:

    • ORIGINAL (Standard)

    • DUPLICATE

  • NEW_NAME=
    (Optional) Name des Jobs, der als Duplikat gestartet werden soll
    Verwenden Sie diesen Parameter nur in Kombination mit START=DUPLICATE, andernfalls, wird dieser Parameter ignoriert.
    Format: Script-Literal

  • START_D[ATE]=
    (Optional) Startdatum für die ausgewählten eingeplanten Jobs. Wenn Sie diesen Parameter ohne den Parameter END_DATE= verwenden, werden alle geplanten Jobs ausgewählt und starten an dem Startdatum, das Sie hier angeben.
    Format: Script-Literal
    Datumsformat: JJJJMMTT
    Standardwert: 20000101

  • START_T[IME]=
    (Optional) Startzeit für die ausgewählten eingeplanten Jobs. Wenn Sie diesen Parameter ohne den Parameter END_TIME= verwenden, werden alle eingeplanten Jobs ausgewählt und starten zu der angegebenen Startzeit. 23:59 Uhr ist die angewendete Endzeit in diesem Fall.
    Format: Script-Literal
    Zeitformat: HHMMSS
    Standardwert: 000000

  • END_D[ATE]=
    (Optional) Enddatum für die ausgewählten eingeplanten Jobs. Verwenden Sie das gleiche Datum für diesen Parameter UND den Parameter START_DATE=, wenn Sie alle Aufträge auswählen möchten, die an diesem Tag eingeplant sind.
    Format: Script-Literal
    Datumsformat: JJJJMMTTD
    Standardwert: aktuelles Datum

  • END_T[IME]=
    (Optional) Endzeit für die ausgewählten eingeplanten Jobs.
    Format: Script-Literal
    Zeitformat: HHMMSS
    Standardwert: 235959

  • TARGET_S[ERVER]=(Optional)
    Zielsystem, das der freigegebene SAP-Job verwenden soll.
    Format: Script-Literal
    Erlaubte Werte:

    • KEEP (Standard)

      Das im ursprünglichen Job definierte Zielsystem wird beibehalten.

    • ATTRIBUTE
      Das Zielsystem, das in den Hostattributen des Jobs definiert ist, wird verwendet.

  • MON[ITOR]=
    (Optional) das Logging der Statusüberwachung im Aktivierungslog.
    Format: Script-Literal
    Erlaubte Werte: NO (Standardwert) und YES

  • WAIT=
    (Optional) Wartet, bis SAP-Job-Child-Prozesse enden
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:
    • NO (Standardwert)
      Es wird nicht gewartet, bis alle Child-Prozesse beendet sind
    • YES
      Es wird auf das Ende aller Children gewartet. Child-Prozesse werden im Aktivierungsreport protokolliert.
  • ABORTED=
    (Optional) Reaktion auf ein ungewöhnliches Ende von SAP-Job-Child-Prozessen
    Format: Script-Literal oder AE Name
    Erlaubte Werte:
    • YES (default)
      SAP-Job (Parent) wurde abgebrochen Das Script wird nicht fortgesetzt und der AE-Job endet vorzeitig.
    • NO
      Der SAP-Job (Parent) wurde nicht abgebrochen. Das Script wird fortgesetzt, der AE-Job endet normal. 
  • REPL[ICATE]=
    (Optional) Verarbeitet die Child-Prozesse von Intercepted Jobs.
    Format: Script-Literal
    Erlaubte Werte:
    • NO (default)
      Es erfolgt keine Replikation im AE-System.
    • YES
      Die Child-Prozesse eines Jobs werden im AE-System repliziert. Sie werden in der Perspektive "" angezeigt. Process Monitoring Statistische Aufzeichnungen und Reports werden ebenfalls im AE-System generiert.
  • BEG_LOGLINES=
    (Optional) Dieser Parameter bestimmt die Anzahl der Zeilen, die an den AE-Job-Report weitergegeben werden sollen, gezählt ab dem Anfang des SAP-Job-Logs
  • END_LOGLINES=
    (Optional) Legt die Anzahl der Zeilen fest, die dem AE -Job-Report beginnend am dem Ende des SAP-Joblogs hinzugefügt werden sollen
    Standardwert: Wenn weder END_LOGLINES noch BEG_LOGLINES definiert sind, wird das vollständige Joblog verwendet. Wenn Sie nur einen dieser beiden Parameter definieren, werden die entsprechenden Zeilen des Job-Logs entweder vom Anfang oder vom Ende aus gelesen. Es wird kein Job-Log hinzugefügt, wenn Sie in beiden Parametern den Wert 0 definieren.
    Erlaubte Werte: Zahlen

  • GET_SPOOL=
    (Optional) Fordert die Spool-Liste des gestarteten Jobs an
    Format: Script-Literal
    Erlaubte Werte:

    • NO (Standard)
      Die Spool-Liste wird nicht angefordert.

    • YES
      Die Spool-Liste wird angefordert. Sie wird als Textdatei in dem Verzeichnis abgelegt, das in der INI- Datei des SAP-Agenten mit dem Parameter Download_dir= (Abschnitt [GLOBAL]) definiert wurde. Weitere Informationen finden Sie unter Agent SAP.

      Der Name der Textdatei ist wie folgt aufgebaut:
      <SAP-Jobzähler>_<Schrittnummer>_<Spool-Nummer>.txt
      Diese Datei wird auch als Jobausgabe im AE-Job registriert. Weitere Informationen finden Sie unter Registrierte Job-Ausgabe.

Beispiel

Das folgende Beispiel gibt alle eingeplanten Aufträge mit dem Namen REORG_SPOOL frei

R3_ACTIVATE_JOBS NAME='REORG_SPOOL',NOFOUND='ABEND'

Siehe auch:

seealso

SAP JCL