Automation Engine Script-Leitfaden > AE JCL für Anwendungen > SAP > R3_GET_JOBS

R3_GET_JOBS

Selektiert SAP-Jobs und listet das Ergebnis im Aktivierungsreport oder in einer Datei auf.

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=...]

Syntax

Beschreibung/Format

NAME= 

Selektion eines oder mehrerer Jobs nach Namen
Format: Script-Literal oder AE-Name

In Verbindung mit dem JOBCOUNT wird ein einzelner SAP-Job eindeutig identifiziert.
Bei der Selektion mehrerer Jobs kann das Wildcardzeichen "*" verwendet werden (z.B. "xxx*").

Parameter 

Weitere Selektionskriterien in Form eines Schlüsselwortes und einer Zuweisung.

Nicht angegebene Parameter erhalten Standardwerte. Formate gelten für die Zuweisung zum Schlüsselwort. 

JOBCOUNT= 

Nummer des SAP-Jobs.
Format: Script-Literal

In Verbindung mit dem Namen wird ein SAP-Job eindeutig identifiziert.

GROUP= 

Selektion von Jobs nach Gruppen (z.B. "xxx*")
Format: Script-Literal oder AE-Name

Standardwert: "*" 

USER= 

Selektion von Jobs nach Benutzern (z.B. "xxx*")
Format: Script-Literal oder AE-Name

Standardwert: "*" 

START_D[ATE]= 

Geplantes Startdatum für die Ausführung des Jobs
Format: Script-Literal oder AE-Name

Datums-Format: JJJJMMTT
Standardwert: "20010101"

START_T[IME]= 

Geplante Startzeit für die Ausführung des Jobs
Format: Script-Literal oder AE-Name

Zeit-Format: HHMMSS
Standardwert: "000000"

END_D[ATE]= 

Geplantes Enddatum für die Ausführung des Jobs
Format: Script-Literal oder AE-Name

Datums-Format: JJJJMMTT
Standardwert: aktuelles Datum

END_TIME= 

Geplante Endzeit für die Ausführung des Jobs
Format: Script-Literal oder AE-Name

Zeit-Format: HHMMSS
Standardwert: "235959"

NO_DATE= 

Jobs ohne Starttermin
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert) oder "X"

WITH_PRED= 

Jobs mit Starttermin "nach Vorgänger"
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert) oder "X"

EVENT_ID= 

Jobs, die mit einem Ereignis verkettet sind: Name des Ereignisses.
Format: Script-Literal oder Automic-Name

EVENT_PARM= 

Jobs, die mit einem Ereignis verkettet sind: Parameter des Ereignisses.
Format: Script-Literal oder AE-Name

PRELIM= 

Jobs mit Zustand "Geplant"
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert) oder "X"

SCHEDUL= 

Jobs mit Zustand "Freigegeben"
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert) oder "X"

READY= 

Jobs mit Zustand "Bereit"
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert) oder "X"

RUNNING= 

Jobs mit Zustand "Aktiv"
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert) oder "X"

FINISHED= 

Jobs mit Zustand "Fertig"
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert) oder "X"

ABORTED= 

Jobs mit Zustand "Abgebrochen"
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert) oder "X"

NOFOUND= 

Behandlung, wenn durch die Selektion keine Jobs gefunden wurden
Format: Script-Literal oder AE-Name

Erlaubte Werte: "NORMAL" (Standardwert) und "ABEND"

"NORMAL" - Das Script wird fortgesetzt, der AE-Job endet normal.
"ABEND" - Das Script wird nicht fortgesetzt, der AE-Job endet abnormal.

FILE= 

Name einer Datei, in welcher das Ergebnis (gefundene SAP-Jobs) gespeichert werden soll
Format: Script-Literal

Das Selektionsergebnis wird nicht im Aktivierungsreport ausgegeben, wenn dieser Parameter verwendet wird. 

ENCODING=

Encoding für die erzeugte Ausgabedatei (Parameter FILE=).

Beispiel: UTF-8

Standardwert: ISO-8859-1

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

In den SAP-Forms ist für dieses Feld eine Eingabehilfe verfügbar, welche alle unterstützten Encodings auflistet.

Beschreibung

Das Script-Sprachmittel ermöglicht es, Hintergrundjobs im SAP zu selektieren. Die Selektionskriterien werden als Parameter übergeben. Die 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.

Das Ergebnis der Selektion wird entweder in den Aktivierungsreport oder in eine Datei geschrieben. Für jeden gefundenen SAP-Job gibt es eine Zeile. Der Aufbau der Zeilen im Aktivierungsreport und in der Datei ist unterschiedlich.

In der Datei werden Spalten verwendet. Die erste Zeile der Datei enthält Informationen zur Breite und zum Inhalt der Spalten. Die einzelnen Zeilen sind nach dieser Festlegung unterteilt. Die ersten 33 Stellen enthalten jeweils den Namen des SAP-Jobs, weitere 9 dessen Nummer.

Im Aktivierungsreport sind die Informationen innerhalb einer Zeile durch Semikolon getrennt. Zusätzlich werden ein Zeitstempel und eine AE-Meldungsnummer am Anfang der Zeile ausgegeben.

Das Ergebnis der Selektion kann mit Script-Funktionen analysiert werden. PREP_PROCESS_REPORT kann in der Registerkarte Post-Script dazu verwendet werden, um den Aktivierungsreport zu analysieren. PREP_PROCESS_FILE wird zum Beispiel verwendet, wenn das Selektionsergebnis in eine Datei gespeichert wurde.

Beachten Sie, dass erzeugte Dateien standardmäßig am Rechner, auf dem der Agent installiert ist, gepeichert werden (z.B.: R3_GET_JOB_SPOOL; FILE=).

Beispiele

Im ersten Beispiel werden alle geplanten SAP-Jobs selektiert, welche mit "FREIG" beginnen.

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

Das Ergebnis wird im Aktivierungsreport ausgegeben und könnte wie diese Zeilen aussehen:

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

Das zweite Beispiel selektiert alle SAP-Jobs mit dem Namen "EU_REORG" und dem Zustand "Fertig". Das Ergebnis der Selektion wird in eine Datei gespeichert.

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

Die ersten Zeilen in der Datei könnten beispielsweise wie diese aussehen:

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

 

Siehe auch:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH