R3_GET_JOB_SPOOL

Liest die Spool-Liste eines Steps vom Typ "ABAP-Programm"

Transaktion: SM37
Schnittstelle: AE und Standard

Syntax

R3_GET_JOB_SPOOL

Syntax Beschreibung/Format
FILE=

Name einer Datei, in die das Ergebnis (die Spool-Liste des Steps) geschrieben werden soll.
Format des Werts: Script-Literal

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

Bei Verwendung dieses Parameters ist es nicht erforderlich, den Parameter Job immer nach Durchführung im CCMS löschen zu aktivieren. Der Parameter Job immer nach Durchführung im CCMS löschen muss bei Verwendung von R3_GET_JOB_SPOOL FILE="c:\temp\jobspool.txt" deaktiviert werden.

Im Parameter FILE kann "(REPORT,REP)" gesetzt werden. Dadurch wird der Inhalt eines SAP-Job-Spools im R3-Job-Report (REP) "automatisch" sichtbar.
NAME=

Name des SAP-Jobs, der den Step enthält.
Format des Werts: Script-Literal

Wird der Jobname nicht definiert, wird automatisch der Name des letzten SAP-Jobs verwendet, der über den AE-Job mit diesem Script-Element verarbeitet wurde.
JOBCOUNT=

Jobnummer des SAP-Jobs, der den Step enthält.
Format des Werts: Script-Literal

Wenn Sie die Jobnummer nicht definieren, verwendet das System automatisch den Wert des letzten SAP-Jobs, der über den AE-Job verarbeitet wurde.

Wenn Sie die Parameter NAME und JOBCOUNT verwenden, beachten Sie, dass der Spool nicht abgerufen werden kann, wenn der entsprechende Job im SAP-System gelöscht wurde (Einstellung "Job im CCMS nach Beendigung löschen" im AE-Job ).
STEP=

Anzahl der Steps im SAP-Job.
Format des Werts: Ganzzahl

Standardwert: 1
NOFOUND=

Vorgehensweise, wenn die Spool-Liste nicht gefunden wurde.
Format des Werts: Script-Literal

Zulässige Werte: NORMAL (Standardwert) und ABEND

NORMAL - Der AE-Job läuft weiter.
"ABEND" - Der AE-Job endet vorzeitig.
MAXLINES=

Maximale Anzahl von Zeilen, die in die Datei geschrieben werden.
Format des Werts: Ganzzahl

Standardwert: 9.999

Hinweis: Die hier vorgenommenen Einstellungen werden nicht berücksichtigt bei Verwendung von FORMAT = PDF oder BIN.
SPOOLNR=

Spool-Auftragsnummer.
Format des Werts: Script-Literal

Hinweis: Wenn NAME, JOBCOUNT oder SPOOLNR nicht definiert werden, verwendet das System automatisch den letzten SAP-Job, der über den AE-Job verarbeitet wurde.
FORMAT=

Ausgabeformat.
Format des Werts: Script-Literal

Zulässige Werte: TXT (Standard), RAW (statt Parameter RAW - siehe unten), PDF, BIN und HTM

Hinweis: Bei Verwendung der Einstellungen BIN und PDF wird die Spool-Liste nicht konvertiert und im Binärformat übertragen.
PAGES=

Seiten.
Format des Werts: Script-Literal

Syntax des Parameters: PAGES=Seite[;Seite[;...]]

Trennen Sie die Angaben für die einzelnen Seitenbereiche durch das Zeichen ";".

Beispiele

  • Seite 7: PAGES="7"
  • Seiten 5 bis 7: PAGES="5,7"
  • Seite 2 und die Seiten 5 bis 7: PAGES="2;5,7"

Anstatt der letzten Seite kann das Symbol $ verwendet werden:

  • Die Seiten 1 bis 3 und die letzte Seite: PAGES="1,3;$"
  • Alle Seiten: PAGES="1,$"
  • Die erste und die letzte Seite: PAGES="1;$"
  • Die beiden letzten Seiten: PAGES="$-1,$"

Hinweis: Die Parameter FORMAT (außer PDF), SPOOLNR und PAGES sind auch für die XBP 3.0-Schnittstelle (ab Version 1.1) verfügbar.
FILTER=

Filtereinstellung.
Format des Werts: Script-Literal

String, nach dem eine Auswahl getroffen werden soll. Platzhalterzeichen können nicht verwendet werden.
RAW=

Lieferung der Spool-Liste in ungekürzter Größe.
Format des Wertes: Script-Literal

Zulässige Werte: YES und NO (Standardwert)

YES - Die Spool-Liste wird in ungekürzter Größe (d. h. mit allen Formatierungszeichen) geliefert.
NO - Die Spool-Liste wird nicht in ungekürzter Größe geliefert.

Tipp: Verwenden Sie FORMAT=RAW anstelle dieses Parameters.
ENCODING=

Codierung für die erzeugte Ausgabedatei (Parameter FILE=).

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.

In den SAP Forms ist für dieses Feld eine Eingabehilfe verfügbar, welche alle unterstützten Codierungsformate auflistet.

Dieses Script-Element kann mit den folgenden Parameterkombinationen verwendet werden:

Der Parameter FILTER benötigt die AE-Schnittstelle und der Parameter RAW die Standardschnittstelle.

Die Spool-Liste kann nur dann übertragen werden, wenn das Kontrollkästchen "Job nach Durchführung im CCMS löschen" auf der Registerkarte Host-Attribute nicht aktiviert ist. Diese Einschränkung gilt nicht, wenn entweder der Parameter SPOOLNR definiert wurde oder die Standard-Schnittstelle XBP 3.0 (ab Version 1.1) ohne die Parameter NAME, JOBCOUNT und SPOOLNR verwendet wird. Weitere Informationen finden Sie unter SAP ABAP, Java und PI.

Hinweis für die Verwendung der Standardschnittstelle XBP 3.0 mit einer höheren Version als V1.1:
Standardschnittstelle: In der Regel wird die gesamte Spool-Liste an den SAP-Agenten gesendet. Die Standardfunktion der XBP-Schnittstelle bietet keine Möglichkeit, nur auf Teile der Spool-Liste zuzugreifen. Bitte beachten Sie, dass große Spool-Listen die Performance des SAP-Agenten beeinträchtigen können. Der Parameter MAXLINES= wird erst gelesen, wenn die gesamte Spool-Liste bereits übertragen wurde.

Hinweis: Beachten Sie, dass die erzeugten Dateien standardmäßig auf dem Rechner gespeichert werden, auf dem der Agent installiert ist (z. B. R3_GET_JOB_SPOOL; FILE=).

Beispiel

Im Beispiel wird zunächst ein Report aktiviert. Anschließend wird die Spool-Liste des Steps geholt, ohne den Jobnamen oder die Jobnummer als Parameter anzugeben. Dadurch wird automatisch der Job verwendet, der zuletzt über den Agent verarbeitet wurde.

R3_ACTIVATE_REPORT REPORT='RSPO0041',VAR='STANDARD',COVERPAGE=YES
R3_GET_JOB_SPOOL FILE='c:\temp\spoollist.txt',NOFOUND=ABEND,MAXLINES=20

Siehe auch:

seealso

SAP JCL