R3_GET_SESSIONS

Das Script-Element R3_GET_SESSIONS wählt Batch-Input-Sessions aus und listet das Ergebnis im Aktivierungsreport oder einer Datei auf. Für jeden gefundenen SAP-Job gibt es eine Zeile. Der Aufbau der Zeilen im Aktivierungsreport und in der Datei ist unterschiedlich. Im Aktivierungsreport sind die Informationen innerhalb einer Zeile durch Semikolons getrennt. Zusätzlich werden am Anfang der Zeile ein Zeitstempel und eine AE-Meldungsnummer ausgegeben. In einer Datei sehen Sie Spalten. 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 Positionen enthalten den Namen der relevanten Batch-Input-Session. Die folgenden 21 Positionen enthalten die Queue-ID. Die letzten 13 Positionen geben den Ersteller der Batch-Input-Session (Benutzer) aus. Standardmäßig werden die erzeugten Dateien auf dem Rechner gespeichert, auf dem der Agent installiert ist (z. B. R3_GET_JOB_SPOOL; FILE=).

Tipp: Sie können die Ergebnisse Ihrer Auswahl mit Script-Funktionen analysieren.

  • Verwenden Sie PREP_PROCESS_REPORT auf der Seite Post-Prozess, um den Aktivierungsreport zu analysieren. Weitere Informationen finden Sie unter Prozess-Seiten und PREP_PROCESS_REPORT.
  • Verwenden Sie PREP_PROCESS_FILE, wenn das Auswahlergebnis in einer Datei gespeichert wurde. Weitere Informationen finden Sie unter PREP_PROCESS_FILE.

Transaktion: SM35
Schnittstelle: AE

Syntax

R3_GET_SESSIONS

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

Parameter

  • R3_GET_SESSIONS
    Wählt Batch Input-Sessions aus und listet das Ergebnis im Aktivierungsreport oder einer Datei auf

  • NAME=
    Wählt Batch-Input-Sessions nach Name aus. Sie können die Wildcardzeichen "*" und "?" verwenden. "*" steht dabei für beliebige, "?" für genau ein Zeichen.
    Format: Script-Literal

  • CREDATE_FROM=
    Wählt Batch-Input-Sessions nach Erstellungsdatum (Enddatum der Auswahl) aus
    Format: Script-Literal
    Datumsformat: JJJJMMTT

  • CREDATE_TO=
    Wählt Batch-Input-Sessions nach Erstellungsdatum (Enddatum der Auswahl) aus
    Format: Script-Literal
    Datumsformat: JJJJMMTT

  • STATUS=
    Wählt Batch-Input-Sessions nach ihrem Status aus
    Format: Script-Literal
    Zulässige Werte:

    • " " (Standardwert)
      Wählt Batch-Input-Sessions aus, die noch verarbeitet werden müssen.

    • R
      Laufend. Wählt Batch-Input-Sessions aus, die derzeit verarbeitet werden

    • F
      Abgeschlossen. Wählt Batch-Input-Sessions aus, die die Verarbeitung abgeschlossen haben

    • E
      Fehler. Wählt Batch-Input-Sessions aus, bei deren Verarbeitung Fehler aufgetreten sind (Error).

  • FILE=
    (Optional) Name einer Datei, in welche die Auswahlergebnisse (gefundene Batch-Input-Session) geschrieben werden sollen. Mit diesem Parameter können Sie das Ergebnis in eine bestimmte Datei schreiben (nicht in den Aktivierungsreport). Für jede gefundene Batch-Input-Session gibt es eine Zeile. Die ersten 13 Positionen enthalten die Namen der Sessions und die weiteren 21 Positionen die Queue-ID.
    Format: Script-Literal

  • NOFOUND=
    (Optional) Vorgehensweise, wenn die Batch-Input-Sessions nicht gefunden werden konnten
    Format: Script-Literal
    Zulässige Werte:

    • NORMAL (Standard)
      Das Script wird fortgesetzt, der AE-Job endet normal

    • ABEND
      Das Script bricht ab, der AE-Job endet vorzeitig

  • ORDER_BY=
    (Optional) Verwenden Sie diesen Parameter, um die Batch-Input-Sessions nach bestimmten Kriterien zu sortieren. Sie können zu diesem Zweck alle Feldnamen der APQI SAP-Tabelle verwenden.
    Beispiel:  ORDER_BY=GROUPID

  • ENCODING=

    • (Optional) Codierung, die für die generierte Ausgabedatei (FILE= Parameter) verwendet werden soll.

    Beispiel: UTF-8

    Standardwert: ISO-8859-1

    Wird ein nicht unterstütztes bzw. ungültiges Codierungsformat angegeben, führt dies zum Abbruch des Jobs mit einer entsprechenden Fehlermeldung.

    SAP Forms bietet für dieses Feld eine Eingabehilfe, welche alle unterstützten Codierungsformate auflistet.

Beispiele

Das erste Beispiel wählt alle Batch-Input-Sessions aus, die heute verarbeitet werden sollen und den Namen "NI" haben.

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

Der Aktivierungsreport zeigt Zeilen an, die den folgenden ähnlich sind:

20220313/135601.000 - U2004943 ;AE_TEST;20220312NI;NI

Das zweite Beispiel wählt alle Batch-Input-Sessions zwischen dem 1.1.2015 und dem 1.1.2022, bei deren Verarbeitung Fehler aufgetreten sind. Das Ergebnis der Auswahl wird in einer Datei gespeichert.

R3_GET_SESSIONS NAME='*',CREDATE_FROM='20200101',CREDATE_TO='20220101',STATUS='E',FILE='sessions.txt'

Die ersten Zeilen der Datei sehen möglicherweise wie folgt aus:

COL=LENGTH,LENGTH_TAB='13=GROUPID,21=QID,13=CREATOR'
AE_TEST     20220314095728031322 NI           
AE_TEST     20220314095823023148 NI           
AE_TEST     20220314100932031323 NI

Siehe auch:

seealso

SAP JCL