R3_GET_JOBS

Verwenden Sie das Script-Element R3_GET_JOBS, um Hintergrund-Jobs in SAP auszuwählen und die Ergebnisse entweder im Aktivierungsreport oder in einer Datei auflisten. Die Auswahlkriterien werden in Form von Parametern zugewiesen. Diese Parameter entsprechen den Feldern der SAP-Dictionary-Struktur BAPIXMJSEL. Verwenden Sie bitte Dictionary oder BAPI-Browser, um detailliertere Informationen zu den einzelnen Feldern zu erhalten.

Tipp: Sie können Scripts auf der Seite Post-Prozess verwenden, um das Ergebnis Ihrer Auswahl zu analysieren. Verwenden Sie die folgenden Script-Funktionen:

Beispiel: Verwenden Sie R3_GET_JOBS, um eingeplante Jobs zu finden, die Ausgabe mit PREP_PROCESS_FILE zu analysieren und weitere Aktionen wie Befehle oder Jobs zu initiieren. Weitere Informationen finden Sie unter Prozess-Seiten

Transaktion: SM37
Schnittstelle: AE und Standard

Syntax

R3_GET_JOBS

    NAME=...
    [,JOBCOUNT=...]
    [,GROUP=...]
    [,USER=...]
    [,START_D[ATE]=...]
    [,START_T[IME]=...]
    [,END_D[ATE]=...]
    [,END_TIME=...]
    [,NO_DATE=...]
    [,WITH_PRED=...]
    [,EVENT_ID=...]
    [,EVENT_PARM=...]
    [,PRELIM=...]
    [,SCHEDUL=...]
    [,READY=...]
    [,RUNNING=...]
    [,FINISHED=...]
    [,ABORTED=...]
    [,NOFOUND=...]
    [,FILE=...]
    [,ENCODING=...]

Parameter

  • R3_GET_JOBS
    Wählt Hintergrund-Jobs in SAP aus und listet die Ergebnisse entweder im Aktivierungsreport oder in einer Datei auf

  • NAME=
    Wählt einen oder mehrere Intercepted Jobs anhand ihrer Namen aus. Verwenden Sie es zusammen mit dem Parameter JOBCOUNT (SAP-Jobnummer), um einen individuellen 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 (SAP-Jobname), um einen individuellen SAP-Job eindeutig zu identifizieren.
    Format: Script-Literal

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

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

  • START_D[ATE]=
    (Optional) Startdatum für die ausgewählten eingeplanten Jobs.
    Format: Script-Literal oder AE-Name
    Datumsformat: JJJJMMTT
    Standardwert: 20000101

  • START_T[IME]=
    (Optional) Startzeit für die ausgewählten eingeplanten Jobs.
    Format: Script-Literal oder AE-Name
    Zeitformat: HHMMSS
    Standardwert: 000000

  • END_D[ATE]=
    (Optional) Enddatum für die ausgewählten eingeplanten Jobs.
    Format: Script-Literal oder AE-Name
    Datumsformat: JJJJMMTT
    Standardwert: aktuelles Datum

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

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

    • "" (Standard)

    • X

  • WITH_PRED=
    (Optional) Gilt für Jobs, die die Startbedingung mit Vorgänger haben
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:

    • "" (Standard)

    • X

  • EVENT_ID=
    (Optional) Kann für Jobs verwendet werden, die mit einem Ereignis verknüpft sind; definiert den Namen des Ereignisses
    Format: Script-Literal oder AE-Name

  • EVENT_PARM=
    (Optional) Kann mit Jobs verwendet werden, die mit einem Ereignis verknüpft sind; definiert den Parameter des Ereignisses
    Format: Script-Literal oder AE-Name

  • PRELIM=
    (Optional) Kann für Jobs verwendet werden, die den Status eingeplant haben
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:

    • "" (Standard)

    • X

  • SCHEDUL=
    (Optional) Kann für Jobs verwendet werden, die den Status freigegeben haben
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:

    • "" (Standard)

    • X

  • READY=
    (Optional) Kann für Jobs verwendet werden, die den Status bereit haben
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:

    • "" (Standard)

    • X

  • RUNNING=
    (Optional) Kann für Jobs verwendet werden, die den Status aktiv haben
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:

    • "" (Standard)

    • X

  • FINISHED=
    (Optional) Kann für Jobs verwendet werden, die den Status abgeschlossen haben
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:

    • "" (Standard)

    • X

  • ABORTED=
    (Optional) Kann für Jobs verwendet werden, die den Status beendet haben
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:

    • "" (Standard)

    • X

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

    • NORMAL (Standard)

      Script-Ausführung wird fortgesetzt, der AE-Job endet normal

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

  • FILE=  
    (Optional) Name der Datei, in der die gefundenen SAP-Jobs gespeichert werden sollen. Diese Datei wird standardmäßig auf dem Rechner gespeichert, auf dem der Agent installiert ist.
    Format: Script-Literal
    Struktur der Datei: Die Datei verwendet Spalten. Die erste Zeile der Datei enthält Informationen zur Breite und zum Inhalt der Spalten. Jeder gefundene SAP-Job wird in eine separate Zeile geschrieben. Die einzelnen Zeilen sind ebenfalls in Spalten aufgeteilt. Die ersten 33 Zeichen einer Zeile enthalten den Namen des jeweiligen SAP-Jobs, die anderen 9 Zeichen seine Nummer.

    Hinweis: Wenn Sie diesen Parameter verwenden, wird das Ergebnis Ihrer Auswahl nicht in den Aktivierungsreport geschrieben. Die Zeilen sind im Aktivierungsreport unterschiedlich strukturiert. Der Aktivierungsreport trennt alle Informationen in einer Zeile jeweils mit Semikolon ab. Am Zeilenanfang werden zusätzlich ein Zeitstempel und eine AE-Nachrichtennummer ausgegeben. Weitere Informationen finden Sie in den folgenden Beispielen.

  • ENCODING=

    • (Optional) Codierung, die für die generierte Ausgabedatei (FILE= Parameter) verwendet werden soll.

    Beispiel: UTF-8

    Standardwert: ISO-8859-1

    Wird ein nicht unterstütztes bzw. ungültiges Codierungsformat angegeben, führt dies zum Abbruch des Jobs mit einer entsprechenden Fehlermeldung.

    SAP Forms bietet für dieses Feld eine Eingabehilfe, welche alle unterstützten Codierungsformate auflistet.

Beispiele

Das erste Beispiel wählt alle eingeplanten SAP-Jobs aus, die mit REL beginnen.

R3_GET_JOBS NAME="REL*",PRELIM="X"

Das Ergebnis wird in den Aktivierungsreport geschrieben, weil der Parameter FILE= nicht angegeben ist:

20200922/134303.567 - U2004943 ;RELEASE;13450801
20200922/134303.567 - U2004943 ;RELEASE;13455501
20200922/134303.567 - U2004943 ;RELEASE;16221501
20200922/134303.567 - U2004943 ;RELEASE;16225101
20200922/134303.567 - U2004943 ;RELEASE;16234801

Das zweite Beispiel wählt alle SAP-Jobs mit dem Namen EU_REORG aus, die sich in einem abgeschlossenen Status befinden. Das Auswahlergebnis soll in einer Datei gespeichert werden.

R3_GET_JOBS NAME='EU_REORG',FINISHED='X',FILE='jobs.txt'

Dies sind die ersten Zeilen der Datei:

COL=LENGTH,LENGTH_TAB='33=JOBNAME,9=JOBCOUNT'
EU_REORG                         01404301
EU_REORG                         01405401

Siehe auch:

seealso

SAP JCL