R3_ACTIVATE_REPORT

Mit dem Script-Element R3_ACTIVATE_REPORT können Sie einen ABAP-Schritt ändern. Wenn Sie einen SAP-Job auswählen, können Sie den Namen des Berichts, die Variante und verschiedene Archivierungs- und Druckparameter eines ABAP-Schritts zurücksetzen.

Tipps:

  • Aktivieren Sie das Kontrollkästchen Job-Steps kombinieren im Verbindungsobjekt, um mehrere R3_ACTIVATE_REPORT-Script-Elementin einem Job zu kombinieren. Weitere Informationen finden Sie im Abschnitt "Schnittstellen"

  • Statt eine Variante zu verwenden, können Sie Auswahlkriterien mithilfe eines Scripts zuweisen. Weitere Informationen finden Sie unter R3_SET_SELECT_OPTION .

Transaktion: SM36, SM37
Schnittstelle: AE und Standard

Syntax

R3_ACTIVATE_REP[ORT]

    REPORT=...
    [,VARIANT=...]
    [,DESTINATION=...]
    [,COPIES=...]
    [,LIST_NAME=...]
    [,LIST_TEXT=...]
    [,IMMEDIATELY=...]
    [,RELEASE=...]
    [,NEW_LIST_ID=...]
    [,EXPIRATION=...]
    [,LINE_COUNT=...]
    [,LINE_SIZE=...]
    [,LAYOUT=...]
    [,COVERPAGE=...]
    [,SAP_COVER_PAGE=...]
    [,OS_COVER_PAGE=...]
    [,RECEIVER=...]
    [,DEPARTMENT=...]
    [,AUTHORITY=...]
    [,DATA_SET=...]
    [,TYPE=...]
    [,SPOOL_PRIORITY=...]
    [,TEXTONLY=...]
    [,FRAMES=...]
    [,SUPPRESS_SHADING=...]
    [,WITH_STRUCTURE=...]
    [,DEFAULT_SPOOL_SIZE=...]
    [,PRINTER_MAIL_ADDRESS=...]
    [,SPOOL_PAGE_FROM=...]
    [,SPOOL_PAGE_TO=...]
    [,ARCHIVE_MODE=...]
    [,ARCHIVE_SAPOBJECT=...]
    [,ARCHIVE_OBJECT=...]
    [,ARCHIVE_INFO=...]
    [,ARCHIVE_TEXT=...]
    [,MONITOR=...]
    [,WAIT=...]
    [,ABORTED=...]
    [,REPL[ICATE]=...]
    [,BEG_LOGLINES=...]
    [,END_LOGLINES=...]
    [,GET_SPOOL=...]

  • R3_ACTIVATE_REP[ORT]
    Ändert einen ABAP-Schritt

  • REP[ORT]=
    Name des Reports
    Format: Script-Literal
  • VAR[IANT]=
    (Optional) Name der Variante
    Format: Script-Literal

Druckparameter

  • DEST[INATION]=
    (Optional) Name des Ausgabegeräts. Dies ist in den meisten Fällen der Name eines Druckers, kann aber auch der eines Telefaxgerätes o. ä. sein.
    Format: Script-Literal
    Achtung! Aus technischen Gründen, die durch die SAP XBP-Schnittstelle verursacht werden, können Sie die langen SAP-Druckernamen nicht verwenden. Geben Sie daher den 4-stelligen technischen Namen an.
  • COPIES=
    (Optional) Anzahl der Dokumentkopien, die gedruckt werden sollen
    Format: Ganzzahl
    Standardwert: 0
  • LIST_N[AME]=
    (Optional) Name der Spool-Anfrage. Er kann aus beliebigen Buchstaben, Zahlen, Sonderzeichen und Leerzeichen bestehen.
    Format: Script-Literal
    Standardwert: Der vorgeschlagene Name besteht aus den 8 Buchstaben des Reportnamens, dem Trennzeichen '_' und den ersten 3 Buchstaben des Benutzernamens.
  • LIST_T[EXT]=
    (Optional) Beschreibender Text für die Startseite der Spool-Anfrage.
    Format: Script-Literal
    Erlaubte Werte: beliebige Buchstaben, Zahlen, Sonderzeichen und Leerzeichen
  • IMM[EDIATELY]=
    (Optional) Erstellt sofort eine Ausgabe
    Erlaubte Werte: NO (Standard) und YES
  • REL[EASE]=
    (Optional) Gibt an, ob der Spool-Auftrag sofort nach dem Drucken auf dem Ausgabegerät oder erst nach Ablauf der Spool-Verweildauer gelöscht wird.
    Format: Script-Literal
    Erlaubte Werte: NO (Standardwert) und YES
  • NEW_LIST_ID=
    (Optional) Neue Spool-Anfrage
    Format: Script-Literal
    Erlaubte Werte: YES (Standardwert) und NO
  • EXPIR[ATION]=
    (Optional) Gibt an, wie viele Tage ein Spool-Auftrag im Spool-System gehalten wird, bevor er gelöscht wird.
    Format: Ganzzahl
    Standardwert: 0
  • LINE_COUNT=
    (Optional) Anzahl der Zeilen pro Listenseite.
    Format: Ganzzahl
    Nicht-Druckformat: Wenn dieser Parameter eine Null enthält oder leer ist, ist die Anzahl der Seiten der jeweiligen Liste nicht begrenzt. Die Seitenlänge der Liste wird dann allein durch ihren Inhalt bestimmt.
    Druckformat: Die maximale Zeilenzahl pro Seite hängt vom gewählten Format ab. Um die Zeilenanzahl zu ändern, wählen Sie das Layoutformat entsprechend aus.
    Standard: 0
  • LINE_SIZE=
    (Optional) Definiert die aktuelle Zeilenbreite der Liste.
    Druckformat: Die maximale Linienbreite hängt vom ausgewählten Layout ab. Um die Zeilenbreite zu ändern, wählen Sie das Layoutformat entsprechend aus.
    Format: Ganzzahl
    Standardwert: 0
  • LAYOUT=
    (Optional) Definiert das Ausgabeformat der Spool-Anfrage. LAYOUT definiert hauptsächlich das Seitenformat, wie z. B. die maximale Anzahl von Zeilen und Spalten auf einer gedruckten Seite.
    Format: Script-Literal
  • COVER[PAGE]=
    (Optional) Bestimmt, ob am Anfang ein Deckblatt mit Report-Auswahlen gedruckt wird. Wenn ein Deckblatt erzeugt wird, wird es in den Job-Report übernommen. Es dokumentiert die Parameter, die für diese Ausführung verwendet wurden.
    Format: Script-Literal
    Erlaubte Werte: NO (Standardwert) und YES
  • SAP_COVER[_PAGE]=
    (Optional) SAP-Deckblatt
    Format:     Script-Literal
    Erlaubte Werte:
    • "" (Standardwert)
      Es wird kein Deckblatt gedruckt
    • X
      Es wird ein Deckblatt gedruckt
    • D
      Es hängt von der Einstellung des jeweiligen Ausgabegerätes (Drucker) ab, ob ein Deckblatt gedruckt wird.
  • OS_COVER[_PAGE]=
    (Optional) Startseite des Host-Spools
    Format: Script-Literal
    Erlaubte Werte:
    • "" (Standardwert)
      Es wird kein Deckblatt gedruckt
    • X
      Es wird ein Deckblatt gedruckt
    • D
      Es hängt von der Einstellung des jeweiligen Ausgabegerätes (Drucker) ab, ob ein Deckblatt gedruckt wird.
  • RECEIVER=
    (Optional) Name des Empfängers der Spool-Anfrage. Dieser Name wird auf dem Deckblatt gedruckt.
    Format: Script-Literal
    Standard: Aktueller Benutzername
  • DEPART[MENT]=
    (Optional) Abteilungsname der Spool-Anfrage, wie sie auf das Deckblatt gedruckt wird.
    Format: Script-Literal
  • AUTHORITY=
    (Optional) Enthält die Berechtigung für die Spool-Anfrage. Der Inhalt des Spool-Auftrags wird nur autorisierten Benutzern angezeigt.
    Format: Script -Literal
    Maximale Zeichenanzahl: 12
  • DATA_SET=
    (Optional) Name des Spool-Datensatzes
    Format: Script-Literal
  • TYPE=
    (Optional) Typ der Spool-Anfrage
    Format: Script-Literal
  • SPOOL_PRI[ORITY]=
    (Optional) Priorität der Spool-Anfrage
    Format: Ganzzahl
    Standardwert: 5
  • TEXTO[NLY]=
    (Optional) Einfacher Text. Dieser Parameter steuert die Ausgabe der Nicht-ASCII-Zeichen einer Druckliste.
    Format: Script-Literal
    Zulässige Werte: NO (Standardwert) und YES
  • FRAMES=
    (Optional) Legt fest, ob Frame-Zeichen verwendet werden.
    Format: Script-Literal
    Erlaubte Werte: YES (Standardwert) und NO
  • SUPPRESS_SHADING=
    (Optional) Definiert, ob Farben und Schattierungen gedruckt werden
    Erlaubte Werte: NO (Standard) und YES
  • WITH_STRUCTURE=
    Definiert, ob strukturierte Informationen in den Report aufgenommen werden sollen
    Erlaubte Werte: NO (Standard) und YES
  • DEFAULT_SPOOL_SIZE=
    (Optional) Spool-Anfrage hat eine maximale Zeilenbreite von 255 Zeichen.
    Zulässige Werte:
    • NO (Standardwert)
      Die Länge der Zeile ist nicht begrenzt
    • YES
      Nach der 255. Spalte wird ein Zeilenumbruch erzwungen.
  • PRINTER_MAIL_ADDRESS=
    (Optional) E-Mail-Adresse eines E-Mail-Druckers
    Format: Script-Literal
  • SPOOL_PAGE_FROM=
    SPOOL_PAGE_TO=
    (Optional) Die Nummer der Seite, ab der und bis zu der gedruckt werden soll.
    Format: String
    Standardwert: Alle Seiten werden gedruckt.

Ablageparameter

  • ARCHIVE_M[ODE]=
    (Optional) Archivierungsmodus
    Format: Script-Literal
    Erlaubte Werte:
    • 1 (Standardwert)
      Das Dokument soll gedruckt werden.
    • 2
      Das Dokument wird nur im optischen Archiv gespeichert.
    • 3
      Das Dokument wird gedruckt und im optischen Archiv gespeichert.
  • ARCHIVE_S[APOBJECT]=
    (Optional) Objekttyp des Unternehmensobjekts, da archivierte Objekte nach Objekttypen klassifiziert sind.
    Format: Script-Literal
  • ARCHIVE_I[NFO]=
    (Optional) Informationsfeld, das den Informationscode für die Archivierungsanfrage bereitstellt
    Format: Script-Literal
  • ARCHIVE_T[EXT]=
    (Optional) Textinformationsfeld, das einen beschreibenden Text für die Archivierungsanfrage bereitstellt
    Format: Script-Literal
    Erlaubte Werte: beliebige Buchstaben, Zahlen, Sonderzeichen und Leerzeichen

Steuerungsparameter

  • MON[ITOR]=
    (Optional) das Logging der Statusüberwachung im Aktivierungslog.
    Format: Script-Literal
    Erlaubte Werte: NO (Standardwert) und YES

Parameter, die Parent/Child-Beziehungen bearbeiten

  • WAIT=
    (Optional) Wartet, bis SAP-Job-Child-Prozesse enden
    Format: Script-Literal oder AE-Name
    Erlaubte Werte:
    • NO (Standardwert)
      Es wird nicht gewartet, bis alle Child-Prozesse beendet sind
    • YES
      Es wird auf das Ende aller Children gewartet. Child-Prozesse werden im Aktivierungsreport protokolliert.
  • ABORTED=
    (Optional) Reaktion auf ein ungewöhnliches Ende von SAP-Job-Child-Prozessen
    Format: Script-Literal oder AE Name
    Erlaubte Werte:
    • YES (default)
      SAP-Job (Parent) wurde abgebrochen Das Script wird nicht fortgesetzt und der AE-Job endet vorzeitig.
    • NO
      Der SAP-Job (Parent) wurde nicht abgebrochen. Das Script wird fortgesetzt, der AE-Job endet normal. 
  • REPL[ICATE]=
    (Optional) Verarbeitet die Child-Prozesse von Intercepted Jobs.
    Format: Script-Literal
    Erlaubte Werte:
    • NO (default)
      Es erfolgt keine Replikation im AE-System.
    • YES
      Die Child-Prozesse eines Jobs werden im AE-System repliziert. Sie werden in der Perspektive "" angezeigt. Process Monitoring Statistische Aufzeichnungen und Reports werden ebenfalls im AE-System generiert.
  • BEG_LOGLINES=
    (Optional) Dieser Parameter bestimmt die Anzahl der Zeilen, die an den AE-Jobreport weitergegeben werden sollen, gezählt ab dem Anfang des SAP-Job-Logs.
    Erlaubte Werte: Zahlen
    Standardwert: Sind weder der Parameter END_LOGLINES noch BEG_LOGLINES angegeben, wird standardmäßig das komplette Job-Log verwendet. Wenn nur einer dieser beiden Parameter angegeben ist, wird der entsprechende Wert angewendet
    Es wird kein Job-Log übertragen, wenn für beide Parameter der Wert 0 angegeben ist.
  • END_LOGLINES=
    (Optional) Die Anzahl der Zeilen, die in den AE-Jobreport geschrieben werden sollen, gezählt ab dem Ende des SAP-Job-Logs.
    Erlaubte Werte: Zahlen
    Standardwert: Sind weder der Parameter END_LOGLINES noch BEG_LOGLINES angegeben, wird standardmäßig das komplette Job-Log verwendet. Wenn nur einer dieser beiden Parameter angegeben ist, wird der entsprechende Wert angewendet
    Es wird kein Job-Log übertragen, wenn für beide Parameter der Wert 0 angegeben ist.
  • GET_SPOOL=
    (Optional) Fordert die Spool-Liste des gestarteten Jobs an
    Format: Script-Literal
    Erlaubte Werte:
    • NO (Standard)
      Die Spool-Liste wird nicht angefordert.

      • Die Spool-Liste wird für ALLE Child-Jobs angefordert, wenn Sie dieses Script-Element in einem SAP-Job mehrfach verwenden, und wenn Sie alle einzelnen Jobschritte mit der Option Job-Steps kombinieren im Verbindungsobjekt kombinieren, selbst wenn der Parameter GET_SPOOL="YES" nur für einen R3_ACTIVE_REPORT gesetzt ist. Weitere Informationen finden Sie unter Verbindung (CONN).

      Spool-Einträge von Children werden nur dann angefordert, wenn der Parameter REPLICATE= entweder auf YES oder auf ALL gesetzt ist.

    • YES
      Die Spool-Liste wird angefordert. Sie wird als Textdatei in dem Verzeichnis abgelegt, das in der SAP-Agent-INI-Datei mit dem Parameter "Download_dir=" (Abschnitt [GLOBAL]) definiert wurde. Weitere Informationen finden Sie unter Agent SAP.

      • Der Name der Textdatei ist wie folgt aufgebaut:
      <SAP-Jobzähler>_<Step-Nummer>_<Spool-Nummer>.txt

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

Beispiel

R3_ACTIVATE_REPORT REPORT='ZSUSER00',VARIANT='ALL_USERS',COVERPAGE='YES',DESTINATION='LT77',IMMEDIATELY='YES'

Siehe auch:

seealso

SAP JCL