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

R3_ACTIVATE_SESSIONS

Abspielen von Batch-Input-Mappen.

Transaktion: SM35

Schnittstelle: AE

Syntax

R3_ACTIVATE_SESSION[S]

NAME=...
[,STATUS=...]
[,NOFOUND=...]
[,ERROR=...]
[,ERRORLEVEL=...]
[,SELECT=...]
[,JOBNAME=...]
[,ORDER_BY=...]

Syntax	Beschreibung/Format
NAME=	Selektion von Mappen nach Namen (z.B. 'xxx*'). Format: Script-Literal
STATUS=	Selektion von Mappen nach Status (z.B. alle noch zu verbuchenden Mappen) Format: Script-Literal Erlaubte Werte: "" (Standardwert) und "E" "" - Mappe ist noch zu bearbeiten. "E" - fehlerhafte Mappe.
NOFOUND=	Behandlung, wenn durch die Selektion keine Mappen 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 eine Mappe aus der selektierten 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. Siehe: ERROR/ERRORLEVEL bei R3_ACTIVATE_SESSIONS
ERRORLEVEL=	Gibt die Anzahl an fehlerhaften Transaktionen in Prozent (%) an. Format: Script-Literal Standardwert: "101" Wird diese Anzahl je Mappe überschritten, so endet der AE Job abnormal.
SELECT=	Einmalig oder permanent selektieren. Format: Script-Literal Erlaubte Werte: Erlaubte Werte "ONCE" (Standardwert) und "EVERY" "ONCE" - Es wird die Treffermenge (= Anzahl freizugebender Mappen) einmalig ermittelt. "EVERY" - Nach jeder Freigabe einer Mappe wird die Treffermenge erneut ermittelt. Diese Technik erlaubt das Parallelisieren freigegebener Mappen.
JOBN[AME]=	Jede Mappe wird mit einem SAP-Job abgespielt. Format: Script-Literal Erlaubte Werte: "ATTRIBUTE" (Standardwert) und "SESSION" "ATTRIBUTE" = Inhalt des Textfeldes "Jobname" aus der Registerkarte Host-Attribute. Ist dieses leer, wird ein Standard-Jobname von AE gebildet. "SESSION" = Name der Mappe, die abgespielt wird.
ORDER[_BY]=	Kriterium nach der die Selektion der Mappen sortiert wird. Es können alle Feldnamen der SAP Tabelle APQI angegeben werden. Beispiel: ORDER_BY=GROUPID Der Parameter wird ab SAP-Version 4.6 unterstützt.

R3_ACTIVATE_SESSION[S]

[QID=...]
[,NOFOUND=...]
[,ERROR=...]
[,ERRORLEVEL=...]
[,JOBNAME=...]

Syntax	Beschreibung/Format
QID=	Queue-ID, mit der eine Batch-Input-Mappe eindeutig identifiziert wird. Format: Script-Literal Parameter wird verwendet, um eine einzelne Batch-Input-Mappe zu starten.
NOFOUND=	Behandlung, wenn durch die Selektion keine Mappen 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 eine Mappe aus der selektierten 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. Siehe: ERROR/ERRORLEVEL bei R3_ACTIVATE_SESSIONS
ERRORLEVEL=	Gibt die Anzahl an fehlerhaften Transaktionen in Prozent (%) an. Format: Script-Literal Standardwert: "101" Wird diese Anzahl je Mappe überschritten, so endet der AE Job abnormal.
JOBN[AME]=	Jede Mappe wird mit einem SAP-Job abgespielt. Format: Script-Literal Erlaubte Werte: "ATTRIBUTE" (Standardwert) und "SESSION" "ATTRIBUTE" = Inhalt des Textfeldes "Jobname" aus der Registerkarte Host-Attribute. Ist dieses leer, wird ein Standard-Jobname von AE gebildet. "SESSION" = Name der Mappe, die abgespielt wird.

Beschreibung

Die zu startenden Batch-Input-Mappen können über eine Selektion ermittelt werden. Mit dem Parameter QID= kann auch eine einzelne Batch-Input-Mappe gestartet werden. Aus dem Selektionsergebnis von R3_GET_SESSIONS, welches im Aktivierungsreport oder in einer Datei gespeichert wurde, lässt sich die Queue-ID einer einzelnen Batch-Input-Mappe herausfinden.

Mit dem Parameter ORDER_BY kann die Reihenfolge der Abarbeitung der Batch-Input-Mappen gesteuert werden, da die Selektion nach dem angegebenen Kriterium sortiert wird. Die Selektion wird nach den Kriterien sortiert, die diesen Parameter definiert haben.

Beispiele

Alle Mappen mit Namen 'FI*' abspielen, welche noch zu bearbeiten sind. Den Job abnormal beenden, wenn fehlerhafte Transaktionen enthalten sind.

R3_ACTIVATE_SESSIONS NAME='FI*',STATUS=,NOFOUND=NORMAL,ERROR=ABEND,ERRORLEVEL=0

Im zweiten Beispiel wird eine einzelne Batch-Input-Mappe gestartet, deren Queue-ID als Parameter angegeben wurde.

R3_ACTIVATE_SESSION QID='20020318171302022315'

Siehe auch:

Allgemeines zur SAP-JCL

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