R3_ACTIVATE_JOBS

Führt zuvor eingeplante Jobs in SAP unter der Kontrolle von AE aus. Die Jobs, die gestartet werden sollen, werden aus einer Auswahl übernommen.

Transaktion: SM37
Schnittstelle: AE und Standard

AE-Schnittstelle

[AE] [Standard]

Syntax

R3_ACTIVATE_JOB[S]

Syntax Beschreibung/Format
NAME=

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

Name und Nummer identifizieren einen einzelnen SAP-Job eindeutig. Das Platzhalterzeichen "*" kann verwendet werden (z. B. "xxx*"), wenn mehrere Jobs ausgewählt werden.
Parameter

Weiteres Auswahlkriterium in Form eines Schlüsselwortes und einer Zuordnung.

Nicht spezifizierte Parameter erhalten Standardwerte. Für die Vergabe der Schlüsselworte werden Formate verwendet.
JOBCOUNT=

Nummer des SAP-Jobs.
Format: Script-Literal

Name und Nummer identifizieren einen einzelnen SAP-Job eindeutig.
GROUP=

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

Standardwert: "*"
USER=

Auswahl von Jobs durch Benutzer (z. B. "xxx*").
Format: Script-Literal oder AE-Name

Standardwert: "*"
NOFOUND=

Aktion, wenn keine Jobs gefunden werden.
Format: Script-Literal

Zulässige Werte NORMAL (Standardwert) und ABEND

NORMAL - Die Script-Ausführung wird fortgesetzt, der AE-Job endet normal.
ABEND - Die Script-Ausführung stoppt, der AE-Job endet vorzeitig.
ERROR=

Aktion, wenn einer der ausgewählten Jobs vorzeitig endet.
Format: Script-Literal

Zulässige Werte: ABEND (Standardwert) und IGNORE

ABEND - Die Script-Ausführung stoppt, der AE-Job endet vorzeitig.
IGNORE - Die Script-Ausführung wird fortgesetzt, der AE-Job endet normal.
SELECT=

Einmalige oder permanente Auswahl.
Format: Script-Literal

Zulässige Werte: ONCE (Standardwert) und EVERY

ONCE - Die Anzahl der ausgewählten Jobs wird einmalig abgerufen.
EVERY - Die Anzahl der ausgewählten Jobs wird nach jeder Job-Freigabe abgerufen. Freigegebene Jobs können so parallel ausgeführt werden.
START=

Wählt aus, ob der ursprüngliche Job oder ein Duplikat gestartet werden soll.
Format: Script-Literal

Zulässige Werte: "ORIGINAL" (Standardwert) und "DUPLICATE"
NEW_NAME=

Name des Jobs, der als Duplikat gestartet werden soll.
Format: Script-Literal

Wird nur verwendet, wenn START=DUPLICATE angegeben wurde. Dieser Parameter wird ignoriert, wenn der ursprüngliche Job gestartet werden soll.
START_D[ATE]=

Startdatum der ausgewählten geplanten Jobs.
Format: Script-Literal

Datumsformat: YYYYMMDD
Standardwert: "20000101"

Alle geplanten Jobs werden ausgewählt und beginnen ab dem angegebenen Startdatum, wenn dieser Parameter ohne den Parameter END_DATE verwendet wird.
START_T[IME]=

Endzeit der ausgewählten geplanten Jobs.
Format: Script-Literal

Zeitformat: HHMMSS
Standardwert: "000000"

Wenn dieser Parameter ohne den Parameter END_TIME verwendet wird, werden alle geplanten Jobs ausgewählt und ab der angegebenen Startzeit gestartet. 23:99 ist die Endzeit.
END_D[ATE]=

Enddatum der ausgewählten geplanten Jobs.
Format: Script-Literal

Datumsformat: YYYYMMDD
Standardwert: das aktuelle Datum

Dieser Parameter muss angegeben werden, ebenso wie dasselbe Datum, das mit dem Parameter START-DATE verwendet wurde, um alle geplanten Jobs eines Tages auszuwählen.
END_T[IME]=

Startzeit der ausgewählten geplanten Jobs.
Format: Script-Literal

Zeitformat: HHMMSS
Standardwert: "235959"
NO_DATE=

Jobs ohne Startdatum.
Format: Script-Literal oder AE-Name

Zulässige Werte: "" (Standardwert) und "X"
TARGET_S[ERVER]=

Zielsystem, das von einem freigegebenen SAP-Job verwendet werden soll.
Format: Script-Literal

Zulässige Werte: KEEP (Standardwert) und ATTRIBUTE

KEEP - Das im ursprünglichen Job angegebene Zielsystem wird beibehalten.
ATTRIBUTE - Das in den Hostattributen des Jobs angegebene Zielsystem wird verwendet.
BEG_LOGLINES= Legt fest, wie viele Zeilen in den AE-Job-Report übernommen werden sollen (ab Beginn des SAP-Joblogs).
END_LOGLINES=

Legt fest, wie viele Zeilen in den AE-Job-Report geschrieben werden sollen (beginnend vom Ende des SAP-Joblogs).

Wurden weder der Parameter END_LOGLINES noch BEG_LOGLINES angegeben, wird standardmäßig das komplette Joblog verwendet. Wird nur einer dieser beiden Parameter angegeben, werden die entsprechenden Job-Log-Zeilen (entweder vom Anfang oder vom Ende) eingelesen.
Es wird kein Joblog übertragen, wenn in beiden Parametern der Wert "0" angegeben wurde.

Für beide Parameter sind nur numerische Werte erlaubt.
GET_SPOOL=

Fordert die Spool-Liste des gestarteten Jobs an.
Format des Wertes: Script-Literal

Zulässige Werte: YES oder NO (Standard)

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

Der Name dieser Datei ist wie folgt aufgebaut:
<SAP-Jobzähler>_<Schrittnummer>_<Spool-Nummer>.txt

Diese Datei ist auch als Job-Ausgabe im AE-Job registriert. Weitere Informationen finden Sie unter Registrierte Job-Ausgabe.

NO = Spoolliste wird nicht angefordert

Beispiele

Freigabe aller geplanten Jobs des Benutzers "NI":

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

Im zweiten Beispiel werden alle zwischen 1.7.2001 12:00:00:00 Uhr und 2.7.2001 23:59:59:59 Uhr geplanten Jobs ausgewählt und gestartet.

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

In diesem Beispiel werden alle zwischen 1.7.2001 12:30:00 Uhr und 2.7.2001 12:30:00 Uhr eingeplanten Jobs ausgewählt und gestartet.

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

Standard-Schnittstelle

[AE] [standard]

Syntax

R3_ACTIVATE_JOB[S]

Syntax Beschreibung/Format
NAME=

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

Name und Nummer identifizieren einen einzelnen SAP-Job eindeutig. Das Platzhalterzeichen "*" kann verwendet werden (z. B. "xxx*"), wenn mehrere Jobs ausgewählt werden.
Parameter

Weiteres Auswahlkriterium in Form eines Schlüsselwortes und einer Zuordnung.

Nicht spezifizierte Parameter erhalten Standardwerte. Für die Vergabe der Schlüsselworte werden Formate verwendet.
JOBCOUNT=

Nummer des SAP-Jobs.
Format: Script-Literal

Name und Nummer identifizieren einen einzelnen SAP-Job eindeutig.
NOFOUND=

Aktion, wenn keine Jobs gefunden werden.
Format: Script-Literal

Zulässige Werte "NORMAL" (Standardwert) und "ABEND"

"NORMAL" - Die Script-Ausführung wird fortgesetzt, der AE-Job endet normal.
"ABEND" - Die Script-Ausführung stoppt, der AE-Job endet vorzeitig.
ERROR=

Aktion, wenn einer der ausgewählten Jobs vorzeitig endet.
Format: Script-Literal

Zulässige Werte: "ABEND" (Standardwert) und "IGNORE"

"ABEND" - Die Script-Ausführung stoppt, der AE-Job endet vorzeitig.
"IGNORE" - Die Script-Ausführung wird fortgesetzt, der AE-Job endet normal.
SELECT=

Einmalige oder permanente Auswahl.
Format: Script-Literal

Zulässige Werte: "ONCE" (Standardwert) und "EVERY"

"ONCE" - Die Anzahl der ausgewählten Jobs wird einmalig abgerufen.
"EVERY" - Die Anzahl der ausgewählten Jobs wird nach jeder Job-Freigabe abgerufen. Freigegebene Jobs können so parallel ausgeführt werden.
START=

Wählt aus, ob der ursprüngliche Job oder ein Duplikat gestartet werden soll.
Format: Script-Literal

Zulässige Werte: "ORIGINAL" (Standardwert) und "DUPLICATE"
NEW_NAME=

Name des Jobs, der als Duplikat gestartet werden soll.
Format: Script-Literal

Wird nur verwendet, wenn START=DUPLICATE angegeben wurde. Dieser Parameter wird ignoriert, wenn der ursprüngliche Job gestartet werden soll.
START_D[ATE]=

Startdatum der ausgewählten geplanten Jobs.
Format: Script-Literal

Datumsformat: YYYYMMDD
Standardwert: "20000101"

Alle geplanten Jobs werden ausgewählt und beginnen ab dem angegebenen Startdatum, wenn dieser Parameter ohne den Parameter END_DATE verwendet wird.
START_T[IME]=

Startzeit der ausgewählten geplanten Jobs.
Format: Script-Literal

Zeitformat: HHMMSS
Standardwert: "000000"

Wenn dieser Parameter ohne den Parameter END_TIME verwendet wird, werden alle geplanten Jobs ausgewählt und ab der angegebenen Startzeit gestartet. 23:99 ist die Endzeit.
END_D[ATE]=

Enddatum der ausgewählten geplanten Jobs.
Format: Script-Literal

Datumsformat: YYYYMMDD
Standardwert: das aktuelle Datum

Dieser Parameter muss angegeben werden, ebenso wie dasselbe Datum, das mit dem Parameter START-DATE verwendet wurde, um alle geplanten Jobs eines Tages auszuwählen.
END_T[IME]=

Startzeit der ausgewählten geplanten Jobs.
Format: Script-Literal

Zeitformat: HHMMSS
Standardwert: "235959"
TARGET_S[ERVER]=

Zielsystem, das von einem freigegebenen SAP-Job verwendet werden soll.
Format: Script-Literal

Zulässige Werte: "KEEP" (Standardwert) und "ATTRIBUTE"

"KEEP" - Das im ursprünglichen Job angegebene Zielsystem wird beibehalten.
"ATTRIBUTE" - Das in den Hostattributen des Jobs angegebene Zielsystem wird verwendet.
MON[ITOR]=

Statusüberwachung im Aktivierungs-Log.
Format: Script-Literal

Zulässige Werte: "YES" und "NO" (Standardwert)
WAIT=

Auf das Ende der Children eines SAP-Jobs warten.
Format: Script-Literal oder AE-Name

Zulässige Werte: "YES" oder "NO" (Standardwert)

"NO" - Es wird nicht auf das Ende aller Children gewartet.
"YES" - Es wird auf das Ende aller Children gewartet. Children werden im Aktivierungsreport protokolliert.
ABORTED=

Reaktion auf ein vorzeitiges Ende der Children von SAP-Jobs.
Format: Script-Literal oder AE-Name

Zulässige Werte: "YES" und "NO" (Standardwert)

"NO" - SAP-Job (Parent) wird nicht abgebrochen. Das Script wird fortgesetzt, der AE-Job endet normal.
"YES" - SAP-Job (Parent) wird abgebrochen. Das Script wird nicht fortgesetzt und der AE-Job endet vorzeitig.
REPL[ICATE]=

Behandlung der Children von Intercepted Jobs.
Format des Wertes: Script-Literal

Zulässige Werte: "YES" und "NO" (Standardwert)

"YES" = Children eines Jobs werden im AE-System repliziert. Sie werden in der Perspektive "Process Monitoring" angezeigt und statistische Datensätze und Reports werden im AESystem generiert.
"NO" = Es erfolgt keine Replikation im AE-System.
BEG_LOGLINES= Legt fest, wie viele Zeilen in den AE-Job-Report übernommen werden sollen (ab Beginn des SAP-Joblogs).
END_LOGLINES=

Legt fest, wie viele Zeilen in den AE-Job-Report geschrieben werden sollen (beginnend vom Ende des SAP-Joblogs).

Wurden weder der Parameter END_LOGLINES noch BEG_LOGLINES angegeben, wird standardmäßig das komplette Joblog verwendet. Wurde nur einer dieser beiden Parameter angegeben, werden die entsprechenden Joblogzeilen (entweder vom Anfang oder vom Ende) eingelesen.
Es wird kein Joblog übertragen, wenn in beiden Parametern der Wert "0" angegeben wurde.

Für beide Parameter sind nur numerische Werte erlaubt.
GET_SPOOL=

Fordert die Spool-Liste des gestarteten Jobs an.
Format des Wertes: Script-Literal

Zulässige Werte: "YES" oder "NO" (Standardwert)

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

Der Name dieser Datei ist wie folgt aufgebaut:
<SAP-Jobzähler>_<Schrittnummer>_<Spool-Nummer>.txt

Diese Datei ist auch als Job-Ausgabe im AE-Job registriert. Weitere Informationen finden Sie unter Registrierte Job-Ausgabe.

NO = Spoolliste wird nicht angefordert

Beispiel

Freigabe aller geplanten Jobs mit dem Job-Namen 'REORG_SPOOL':

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

Siehe auch:

seealso

SAP JCL