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

R3_ACTIVATE_JOBS

Führt bereits im SAP eingeplante Jobs unter der Kontrolle von AE durch. Die zu startenden Jobs werden über eine Selektion ermittelt.

Transaktion: SM37

Schnittstelle: AE und Standard

AE Schnittstelle

[AE] [Standard]

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

Syntax	Beschreibung/Format
NAME=	Selektion eines oder mehrerer Jobs nach Namen Format: Script-Literal oder AE-Name Name und Nummer identifizieren einen einzelnen SAP-Job eindeutig. 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 Name und Nummer identifizieren einen einzelnen SAP-Job eindeutig.
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: ""
NOFOUND=	Behandlung, wenn durch die Selektion keine Jobs getroffen wurden. Format: Script-Literal 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.
ERROR=	Behandlung, wenn ein Job aus der selektieren Menge abnormal endet. Format: Script-Literal Erlaubte Werte: "ABEND" (Standardwert) und "IGNORE" "ABEND" - Das Script wird nicht fortgesetzt, der AE-Job endet abnormal "IGNORE" - Das Script wird fortgesetzt, der AE-Job endet normal.
SELECT=	Einmalig oder permanent selektieren. Format: Script-Literal Erlaubte Werte: "ONCE" (Standardwert) und "EVERY" "ONCE" - Es wird die Treffermenge (= Anzahl freizugebender Jobs) einmalig ermittelt. "EVERY" - Nach jeder Freigabe eines Jobs wird die Treffermenge erneut ermittelt. Diese Technik erlaubt das Parallelisieren freigegebener Jobs.
START=	Soll das Original des Jobs oder ein Duplikat gestartet werden. Format: Script-Literal Erlaubte Werte: "ORIGINAL" (Standardwert) und "DUPLICATE"
NEW_NAME=	Name für den Job, der als Duplikat gestartet wird. Format: Script-Literal Wird nur ausgewertet, wenn START=DUPLICATE angegeben wurde. Soll das Original des Jobs gestartet werden, wird der Parameter ignoriert.
START_D[ATE]=	Start-Datum der Selektion von eingeplanten Jobs. Format: Script-Literal Datums-Format: JJJJMMTT Standardwert: "20000101" Wird dieser Parameter ohne den Parameter END_DATE verwendet, werden alle eingeplanten Jobs ab dem angegebenen Start-Datum selektiert und gestartet.
START_T[IME]=	Start-Zeit der Selektion von eingeplanten Jobs. Format: Script-Literal Zeit-Format: HHMMSS Standardwert: "000000" Wird dieser Parameter ohne den Parameter END_TIME verwendet, werden alle eingeplanten Jobs ab der angegebenen Start-Zeit selektiert und gestartet. 23:59 Uhr gilt als Ende-Zeit.
END_D[ATE]=	Ende-Datum der Selektion von eingeplanten Jobs. Format: Script-Literal Datums-Format: JJJJMMTT Standardwert: Aktuelles Datum Um alle eingeplanten Jobs eines Tages zu selektieren, muss dieser Parameter angegeben und das gleiche Datum wie beim Parameter START_DATE verwendet werden.
END_T[IME]=	Start-Zeit der Selektion von eingeplanten Jobs. Format: Script-Literal Zeit-Format: HHMMSS Standardwert: "235959"
NO_DATE=	Jobs ohne Starttermin Format: Script-Literal oder AE-Name Erlaubte Werte: "" (Standardwert) oder "X"
TARGET_S[ERVER]=	Zielsystem, das ein freigegebener SAP-Job verwenden soll. Format: Script-Literal Erlaubte Werte: "KEEP" (Standardwert) und "ATTRIBUTE" "KEEP" - Das im Originaljob eingetragene Zielsystem wird beibehalten. "ATTRIBUTE" - Das Zielsystem aus den Host-Attributen des Jobs wird verwendet.
BEG_LOGLINES=	Legt fest wie viele Zeilen vom Beginn des SAP Joblogs in den AE-Jobreport übernommen werden sollen.
END_LOGLINES=	Anzahl der Zeilen, ab Ende des SAP Joblogs, die in den AE-Jobreport geschrieben werden. Wird weder der Parameter END_LOGLINES noch BEG_LOGLINES angegeben, so wird standardmäßig das komplette Joblog verwendet. Wenn nur ein Parameter angeführt wird, so werden entweder nur Zeilen vom Beginn oder Ende des Joblogs gelesen. Wenn "0" als Wert für beide Parameter eingetragen ist, wird kein Joblog übertragen. Für beide Parameter sind nur numerische Werte erlaubt.
GET_SPOOL=	Spoolliste des gestarteten Jobs anfordern. Format des Wertes: Script-Literal Erlaubte Werte: "YES" oder "NO" (Standardwert) "YES" = Spoolliste anfordern. Diese wird dabei als Text-Datei in das Verzeichnis gespeichert, welches Sie in der INI-Datei des SAP-Agenten mit dem Parameter Download_dir= (Sektion [GLOBAL]) festlegen. Der Name dieser Datei setzt sich folgendermaßen zusammen: <SAP-Job-Count>_<Step-Nummer>_<Spool-Nummer>.txt Zusätzlich wird diese Datei beim AE-Job als Job-Output registriert. "NO" = Spooliste wird nicht angefordert

Beispiel

Alle eingeplanten Jobs des SAP-Benutzers 'NI' freigeben.

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

Im zweiten Beispiel werden alle Jobs, die zwischen dem 1.7.2001 00:00:00 Uhr und dem 2.7.2001 23:59:59 Uhr eingeplant sind, selektiert und gestartet.

R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='SUPPORT',START_DATE='20010701',END_DATE='20010702'

Im Beispiel werden alle Jobs, die zwischen dem 1.7.2001 12:30:00 Uhr und dem 2.7.2001 12:30:00 Uhr eingeplant sind, selektiert und gestartet.

R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='SUPPORT',START_DATE='20010701',END_DATE='20010702'

Standard Schnittstelle

[AE] [Standard]

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]=...]
[,BEG_LOGLINES=...]
[,END_LOGLINES=...]
[,GET_SPOOL=...]

Syntax	Beschreibung/Format
NAME=	Selektion eines oder mehrerer Jobs nach Namen Format: Script-Literal oder AE-Name Name und Nummer identifizieren einen einzelnen SAP-Job eindeutig. 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 Name und Nummer identifizieren einen einzelnen SAP-Job eindeutig.
NOFOUND=	Behandlung, wenn durch die Selektion keine Jobs getroffen wurden. Format: Script-Literal 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.
ERROR=	Behandlung, wenn ein Job aus der selektieren Menge abnormal endet. Format: Script-Literal Erlaubte Werte: "ABEND" (Standardwert) und "IGNORE" "ABEND" - Das Script wird nicht fortgesetzt, der AE Job endet abnormal. "IGNORE" - Das Script wird fortgesetzt, der AE Job endet normal.
SELECT=	Einmalig oder permanent selektieren. Format: Script-Literal Erlaubte Werte: Erlaubte Werte "ONCE" (Standardwert) und "EVERY" "ONCE" - Es wird die Treffermenge (= Anzahl freizugebender Jobs) einmalig ermittelt. "EVERY" - Nach jeder Freigabe eines Jobs wird die Treffermenge erneut ermittelt. Diese Technik erlaubt das Parallelisieren freigegebener Jobs.
START=	Soll das Original des Jobs oder ein Duplikat gestartet werden. Format: Script-Literal Erlaubte Werte: "ORIGINAL" (Standardwert) und "DUPLICATE"
NEW_NAME=	Name für den Job, der als Duplikat gestartet wird. Format: Script-Literal Wird nur ausgewertet, wenn START=DUPLICATE angegeben wurde. Soll das Original des Jobs gestartet werden, wird der Parameter ignoriert.
START_D[ATE]=	Start-Datum der Selektion von eingeplanten Jobs. Format: Script-Literal Datums-Format: JJJJMMTT Standardwert: "20000101" Wird dieser Parameter ohne den Parameter END_DATE verwendet, werden alle eingeplanten Jobs ab dem angegebenen Start-Datum selektiert und gestartet.
START_T[IME]=	Start-Zeit der Selektion von eingeplanten Jobs. Format: Script-Literal Zeit-Format: HHMMSS Standardwert: "000000" Wird dieser Parameter ohne den Parameter END_TIME verwendet, werden alle eingeplanten Jobs ab der angegebenen Start-Zeit selektiert und gestartet. 23:59 Uhr gilt als Ende-Zeit.
END_D[ATE]=	Ende-Datum der Selektion von eingeplanten Jobs. Format: Script-Literal Datums-Format: JJJJMMTT Standardwert: Aktuelles Datum Um alle eingeplanten Jobs eines Tages zu selektieren, muss dieser Parameter angegeben und das gleiche Datum wie beim Parameter START_DATE verwendet werden.
END_T[IME]=	Start-Zeit der Selektion von eingeplanten Jobs. Format: Script-Literal Zeit-Format: HHMMSS Standardwert: "235959"
TARGET_S[ERVER]=	Zielsystem, das ein freigegebener SAP-Job verwenden soll. Format: Script-Literal Erlaubte Werte: "KEEP" (Standardwert) und "ATTRIBUTE" "KEEP" - Das im Originaljob eingetragene Zielsystem wird beibehalten. "ATTRIBUTE" - Das Zielsystem aus den Host-Attributen des Jobs wird verwendet.
MON[ITOR]=	Statusüberwachung im Aktivierungslog protokollieren. Format: Script-Literal Erlaubte Werte: "YES" und "NO" (Standardwert)
WAIT=	Auf das Ende der Children eines SAP-Jobs warten Format des Wertes: Script-Literal oder AE-Name Erlaubte Werte: "YES" und "NO" (Standardwert) "NO" - Es wird nicht auf das Ende aller Children gewartet. "YES" - Es wird auf das Ende aller Children gewartet. Children werden im Aktivierungsprotokoll protokolliert.
ABORTED=	Auf das abnormale Ende der Children eines SAP-Jobs reagieren Format des Wertes: Script-Literal oder AE-Name Erlaubte Werte: "YES" und "NO" (Standardwert) "NO" - SAP-Job (Parent) wird nicht abgebrochen. Das Script wird fortgesetzt und der AE Job endet normal. "YES" - SAP-Job (Parent) wird abgebrochen. Das Script wird nicht fortgesetzt und der AE Job endet abnormal.
REPL[ICATE]=	Behandlung der Children von Jobs. Format des Wertes: Script-Literal Erlaubte Werte: "YES" und "NO" (Standardwert) "YES" - Children eines Jobs werden im Automation Engine System repliziert. Sie erscheinen im Aktivitätenfenster des UserInterfaces. Des Weiteren werden Statistiksätze und Reports im Automation Engine System erzeugt. "NO" - Es erfolgt keine Nachbildung im Automation Engine System.
BEG_LOGLINES=	Legt fest wie viele Zeilen vom Beginn des SAP Joblogs in den AE-Jobreport übernommen werden sollen.
END_LOGLINES=	Anzahl der Zeilen, ab Ende des SAP Joblogs, die in den AE-Jobreport geschrieben werden. Wird weder der Parameter END_LOGLINES noch BEG_LOGLINES angegeben, so wird standardmäßig das komplette Joblog verwendet. Wenn nur ein Parameter angeführt wird, so werden entweder nur Zeilen vom Beginn oder Ende des Joblogs gelesen. Wenn "0" als Wert für beide Parameter eingetragen ist, wird kein Joblog übertragen. Für beide Parameter sind nur numerische Werte erlaubt.
GET_SPOOL=	Spoolliste des gestarteten Jobs anfordern. Format des Wertes: Script-Literal Erlaubte Werte: "YES" oder "NO" (Standardwert) "YES" = Spoolliste anfordern. Diese wird dabei als Text-Datei in das Verzeichnis gespeichert, welches Sie in der INI-Datei des SAP-Agenten mit dem Parameter Download_dir= (Sektion [GLOBAL])festlegen. Der Name dieser Datei setzt sich folgendermaßen zusammen: <SAP-Job-Count>_<Step-Nummer>_<Spool-Nummer>.txt Zusätzlich wird diese Datei beim AE-Job als Job-Output registriert. "NO" = Spooliste wird nicht angefordert

Beispiel

Alle eingeplanten Jobs mit Jobnamen 'REORG_SPOOL' freigeben.

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

Siehe auch:

Allgemeines zur SAP-JCL

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