R3_GET_SYSTEMLOG

Das Script-Element R3_GET_SYSTEMLOG liest das System-Log eines SAP-Systems während eines definierten Zeitraums als Text und speichert es in einer Datei. Wenn Sie den Namen eines Anwendungsservers definieren, liefert das Script-Element das System-Log dieses Servers. Andernfalls liest das System das zentrale SAP-System-Log. 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 das Systemlog mit Hilfe der Script-Elemente für Datensequenzen vorbereiten und bearbeiten. Zu diesem Zweck wird R3_GET_SYSTEMLOG im Ereignis-Job EVENT.R3SYSLOG in Mandant 0000 verwendet.

• Verwenden Sie die Script-Funktion PREP_PROCESS, um eine Datensequenz mit den Daten des Systemlogs zu erstellen. Weitere Informationen finden Sie unter PREP_PROCESS.
• Verwenden Sie eine Prozessschleife, um die Datensequenz Zeile für Zeile zu verarbeiten. Weitere Informationen finden Sie unter :PROCESS... :TERM_PROCESS... :ENDPROCESS.
• Lesen von Daten in einzelnen Zeilen oder Spalten der Datensequenz. Weitere Informationen finden Sie unter GET_PROCESS_LINE.

Transaktion: SM21

Schnittstelle: Standard

Syntax

R3_GET_SYSTEMLOG

FILE=...
[,SERVER=...]
[,FROM_DATE=...]
[,FROM_TIME=...]
[,TO_DATE=...]
[,TO_TIME=...]

Parameter

• R3_GET_SYSTEMLOG
  Liest das Systemlog eines SAP-Systems über einen vorgegebenen Zeitraum.

• FILE=
  Name einer Datei, in der das gelesene SAP-Systemlog gespeichert werden soll
  Format: Name oder Script-Literal

• SERVER=
  (Optional) Name eines SAP-Anwendungsservers. Der Name dieses SAP-Anwendungsservers muss im Format Host_SID_SYSNR angegeben werden, wobei Host der Computername, SID die System-ID von SAP und SYSNR die Nummer der SAP-Instanz ist.

• FROM_DATE=
  (Optional) Startdatum der Auswahl aus dem Systemlog
  Format: JJJJMMTT
  Standardwert: 20010101

• TO_DATE=
  (Optional) Enddatum der Auswahl aus dem Systemlog.
  Format: JJJJMMTT
  Standardwert: aktuelles Datum

• TO_TIME=
  (Optional) Enddatum der Auswahl aus dem Systemlog.
  Format: HHMMSS
  Standardwert: 235959

• 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.

Beispiel

Im folgenden Beispiel wird das zentrale SAP-Systemlog der vergangenen Woche gelesen. Das Startdatum für die Auswahl des Systemlogs wird mit der Script-Funktion SUB_DAYS berechnet. Grundlage dieser Berechnung ist das Tagesdatum.

: RSET &TODAY#           = SYS_DATE ( 'YYYYMMDD' )
: RSET &LAST_WEEK#       = SUB_DAYS ( 'YYYYMMDD:&TODAY#' , 7)
R3_GET_SYSTEMLOG FILE = 'c:\t46_systemlog.txt', SERVER=, FROM_DATE='&LAST_WEEK#'

Siehe auch: