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

R3_GET_SESSIONS

Selektiert Batch-Input-Mappen und listet das Ergebnis im Aktivierungsreport oder in einer Datei auf.

Transaktion: SM35

Schnittstelle: AE

Syntax

R3_GET_SESSIONS

NAME=...
CREDATE_FROM=...
CREDATE_TO=...
STATUS=...
[,FILE=...]
[,NOFOUND=...]
[,ORDER_BY=...]

Syntax	Beschreibung/Format
NAME=	Selektion von Batch-Input-Mappen nach Namen. Format: Script-Literal Die Wildcardzeichen "" und "?" können verwendet werden. "" steht dabei für beliebige, "?" für genau ein Zeichen.
CREDATE_FROM=	Selektion von Batch-Input-Mappen nach ihrem Erstellungsdatum (Start-Datum der Selektion). Format: Script-Literal Datums-Format: YYYYMMDD
CREDATE_TO=	Selektion von Batch-Input-Mappen nach ihrem Erstellungsdatum (Ende-Datum der Selektion). Format: Script-Literal Datums-Format: YYYYMMDD
STATUS=	Selektion von Batch-Input-Mappen nach ihrem Status. Format: Script-Literal Erlaubte Werte: " " (Standardwert), "R", "F" und "E" " " - Batch-Input-Mappen, welche noch zu verarbeiten sind. "R" - Batch-Input-Mappen, welche gerade verarbeitet werden (Running). "F" - Batch-Input-Mappen, deren Verarbeitung beendet ist (Finished). "E" - Batch-Input-Mappen, bei deren Verarbeitung Fehler aufgetreten sind (Error).
FILE=	Name einer Datei, in welcher das Selektionsergebnis (gefundene Batch-Input-Mappen) geschrieben werden soll. Format: Script-Literal Das Selektionsergebnis wird nicht im Aktivierungsreport ausgegeben, wenn dieser Parameter verwendet wird. Für jede gefundene Batch-Input-Mappe gibt es eine Zeile. Die ersten 13 Stellen enthalten jeweils den Namen der Batch-Input-Mappe, weitere 21 Stellen die Queue-ID.
NOFOUND=	Vorgehensweise, wenn keine Batch-Input-Mappen gefunden wurden. Format des Wertes: 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.
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.
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 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. Laut dieser Festlegung sind die einzelnen Zeilen unterteilt. Die ersten 13 Stellen enthalten jeweils den Namen der Batch-Input-Mappe, weitere 21 Stellen die Queue-ID. In 13 weiteren Stellen wird der Benutzer ausgegeben, der die Batch-Input-Mappe erzeugt hat.

Mit dem Parameter ORDER_BY kann die Reihenfolge der Batch-Input-Mappen nach einem Kriterium sortiert werden.

Im Aktivierungsreport sind die Informationen innerhalb einer Zeile durch Semikolon getrennt. Zusätzlich wird 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.

Mit Automation Engine-Version 2.63E wird der Erzeuger der Batch-Input-Mappen zusätzlich am Ende jeder Zeile des Aktivierungsreports oder der Datei ausgegeben. Das kann unter Umständen zu Problemen in bestehenden AE-Scripts führen, wenn die Datensequenz, welche mit PREP_PROCESS_* erzeugt wurde, nicht in Spalten unterteilt ist. Das ist beispielsweise der Fall, wenn die gesamte Zeile mit String-Funktionen bearbeitet wird.

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

Beispiele

Im ersten Beispiel werden alle Batch-Input-Mappen mit dem Namen "NI" selektiert, die heute noch zu verarbeiten sind.

:SET &TODAY# = SYS_DATE(YYYYMMDD)
R3_GET_SESSIONS NAME='NI',CREDATE_FROM='&TODAY#',CREDATE_TO='&TODAY#',STATUS=" "

Im Aktivierungsreport werden Zeilen wie diese ausgegeben:

20020313/135601.000 - U2004943 ;AE_TEST;20020312NI;NI

Das zweite Beispiel selektiert alle Batch-Input-Mappen zwischen dem 1.1.2000 und dem 1.1.2002, bei deren Verarbeitung Fehler aufgetreten sind. Das Ergebnis der Selektion wird in eine Datei gespeichert.

R3_GET_SESSIONS NAME='*',CREDATE_FROM='20000101',CREDATE_TO='20020101',STATUS='E',FILE='sessions.txt'

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

COL=LENGTH,LENGTH_TAB='13=GROUPID,21=QID,13=CREATOR'
AE_TEST     20020314095728031322 NI
AE_TEST     20020314095823023148 NI
AE_TEST     20020314100932031323 NI

Siehe auch:

Allgemeines zur SAP-JCL

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