R3_ACTIVATE_SESSIONS

Verwenden Sie das Script-Element R3_ACTIVATE_SESSIONS, um Batch-Eingabe-Sessions zu verarbeiten. Sie können die zu startenden Batch-Eingabe-Sessions unter Verwendung verschiedener Auswahlen abrufen, oder den Parameter QID= verwenden, um eine bestimmte einzelne Batch-Eingabe-Session zu starten. Sie können die Warteschlangen-ID einzelner Sessions aus den Auswahlergebnissen von R3_GET_SESSIONS abrufen, die im Aktivierungsreport oder in einer Datei gespeichert sind.

Transaktion: SM35
Schnittstelle: AE

Diese Seite beinhaltet Folgendes:

Syntaxoption 1

R3_ACTIVATE_SESSION[S]

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

Parameter

R3_ACTIVATE_SESSION[S]
Verarbeitet Batch-Eingabe-Sessions
NAME=
Wählt Sessions nach Namen aus (wie z. B. 'xxx*')
Format: Script-Literal
STATUS=
(Optional) Wählt Sitzungen nach Status aus
Format: Script-Literal
Erlaubte Werte: :
- ""( Standard)
  Session, die verarbeitet werden soll
- E
  Fehlerhafte Session
NOFOUND=
(Optional) Aktion, die ausgeführt werden soll, wenn keine Sessions ausgewählt wurden
Format: Script-Literal
Erlaubte Werte:
- NORMAL (Standard)
  Script-Ausführung wird fortgesetzt, der AE-Job endet normal
- ABEND
  Script-Ausführung stoppt, der AE-Job endet vorzeitig

ERROR=
(Optional) Aktion, die ausgeführt werden soll, wenn eine der ausgewählten Sessions frühzeitig endet
Format: Script-Literal
Zulässige Werte:
- ABEND (default)
  Script-Ausführung endet, der AE-Job endet vorzeitig
- IGNORE
  Die Script-Ausführung wird fortgesetzt, der AE-Job endet vorzeitig
Weitere Informationen finden Sie unter
ERRORLEVEL=
(Optional) Definiert die Anzahl der fehlerhaften Transaktionen in Prozent (%)
Format: Script-Literal
Standardwert: 101, der Job endet frühzeitig, wenn diese Anzahl überschritten wird
SELECT=
(Optional) Wählt einmal oder dauerhaft aus
Format: Script-Literal
Erlaubte Werte:
- ONCE(Standard)
  Die Anzahl der ausgewählten Sessions wird einmalig abgerufen
- EVERY
  Die Anzahl der ausgewählten Sessions wird nach jeder Session-Freigabe abgerufen. Damit können Sie freigegebene Sitzungen parallelisieren.
JOBN[AME]=
(Optional) Jede Session wird mit einem SAP-Job verarbeitet
Format: Script-Literal
Erlaubte Werte:
- ATTRIBUTE (Standard)
  Inhalt des Textfelds Jobname in den Hostattributen. Wenn kein Text vorhanden ist, wird ein Standard-AEJobname angelegt. Weitere Informationen finden Sie unter SAP ABAP, Java und PI.
- SESSION
  Name der Session, die verarbeitet werden soll
ORDER[_BY]=
(Optional) Dieser Parameter wird ab SAP-Version 4.6 unterstützt. Verwenden Sie ihn, um die Reihenfolge festzulegen, in der die Batch-Input-Sessions verarbeitet werden sollen. Die Auswahl wird nach den Kriterien sortiert, die Sie in diesem Parameter angegeben haben. Es können alle Feldnamen der APQI SAP-Tabelle verwendet werden.
Beispiel: ORDER_BY=GROUPID

Beispiel

Das folgende Beispiel verarbeitet alle Sessions mit dem Namen 'FI*'. Der Job wird vorzeitig beendet, wenn er ungültige Transaktionen enthält.

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

Syntaxoption 2

R3_ACTIVATE_SESSION[S]

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

Parameter

R3_ACTIVATE_SESSION[S]
Verarbeitet Batch-Eingabe-Sessions
QID=
Queue-ID, die eine Batch-Eingabe-Session eindeutig identifiziert. Verwenden Sie den Parameter, um eine einzelne Batch-Eingabe-Session zu starten.
Format: Script-Literal
NOFOUND=
(Optional) Aktion, die ausgeführt werden soll, wenn keine Sessions ausgewählt wurden
Format: Script-Literal
Erlaubte Werte:
- NORMAL (Standard)
  Script-Ausführung wird fortgesetzt, der AE-Job endet normal
- ABEND
  Script-Ausführung stoppt, der AE-Job endet vorzeitig
ERROR=
(Optional) Aktion, die ausgeführt werden soll, wenn eine der ausgewählten Sessions frühzeitig endet
Format: Script-Literal
Zulässige Werte:
- ABEND (default)
  Script-Ausführung endet, der AE-Job endet vorzeitig
- IGNORE
  Die Script-Ausführung wird fortgesetzt, der AE-Job endet vorzeitig
Weitere Informationen finden Sie unter
ERRORLEVEL=
(Optional) Definiert die Anzahl der fehlerhaften Transaktionen in Prozent (%)
Format: Script-Literal
Standardwert: 101, der Job endet frühzeitig, wenn diese Anzahl überschritten wird
JOBN[AME]=
(Optional) Jede Session wird mit einem SAP-Job verarbeitet
Format: Script-Literal
Erlaubte Werte:
- ATTRIBUTE (Standard)
  Inhalt des Textfelds Jobname in den Hostattributen. Wenn kein Text vorhanden ist, wird ein Standard-AEJobname angelegt. Weitere Informationen finden Sie unter SAP ABAP, Java und PI.
- SESSION
  Name der Session, die verarbeitet werden soll

Beispiel

Das folgende Beispiel startet eine einzelne Batch-Eingabe-Session, in der die Queue-ID als Parameter angegeben wird:

R3_ACTIVATE_SESSION QID='20020318171302022315'

ERROR/ERRORLEVEL-Parameter

Bei der Ausführung von R3_ACTIVATE_SESSIONS ruft die AE zunächst die Liste der Sessions ab, die vom SAP-System verarbeitet werden sollen. Jede dieser Sessions wird mit einem einzelnen SAP-Job verarbeitet, der als Replayer bezeichnet wird. Ein Replayer verwendet das Programm RSBDCBTC ABAP, um Sessions zu verarbeiten.

ERROR

Bezieht sich auf das Ergebnis (Status) des Replayers. Das Ergebnis kann "A" für abgebrochen oder "F" für erfolgreich beendet sein.
ERROR=IGNORE

Die Session, die als nächstes in der Liste steht, wird auf jeden Fall verarbeitet. Das Ergebnis des vorhergehenden Replayers wird ignoriert.
ERROR=ABEND

Die Verarbeitung von Sessions wird sofort gestoppt, wenn ein Replayer mit Status "A" endet. Der AE-Job bricht ab.
ERRORLEVEL

Bezieht sich immer auf die Session selbst und wird nach Ende des Replayers geprüft. ERRORLEVEL definiert den prozentualen Anteil der nicht erfolgreich verarbeiteten Transaktionen einer Session. Wird der Wert für die Session überschritten, wird die Verarbeitung des AE-Jobs abgebrochen. Es werden keine weiteren Sessions aus der Trefferliste verarbeitet. Erfolgreich verarbeitete Transaktionen werden nur geprüft, wenn ein ERRORLEVEL angegeben wird.

Siehe auch:

seealso

SAP JCL