R3_GET_SYSTEMLOG

The R3_GET_SYSTEMLOG script element reads the system log of an SAP system during a defined period of time as text and stores it in a file. If you define the name of an application server, the script element supplies the system log of this server. Otherwise, the system reads the central SAP system log. By default, created files are stored on the computer on which the agent is installed (for example, R3_GET_JOB_SPOOL; FILE=).

Tip: You can prepare and edit the system log using the script elements for the data sequences. R3_GET_SYSTEMLOG is used in the EVENT.R3SYSLOG event job in client 0 for this purpose.

Use the PREP_PROCESS script function to create a data sequence with the data of the system log. For more information, see PREP_PROCESS.
Use a process loop to process the data sequence line by line. For more information, see :PROCESS... :TERM_PROCESS... :ENDPROCESS.
Read data in individual lines or columns of the data sequence. For more information, see GET_PROCESS_LINE.

Transaction: SM21
Interface: Standard

Syntax

R3_GET_SYSTEMLOG

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

Parameters

R3_GET_SYSTEMLOG
Reads the system log of an SAP system during a specified period of time
FILE=
Name of a file to which the read SAP system log should be stored
Format: name or script literal
SERVER=
(Optional) Name of an SAP application server. The name of this SAP application server must be specified in the format Host_SID_SYSNR where Host is the computer name, SID is the system ID from SAP, and SYSNR is the number of the SAP instance.
FROM_DATE=
(Optional) Start date of the selection from the system log
Format: YYYYMMDD
Default value: 20010101
TO_DATE=
(Optional) End date of the selection from the system log.
Format: YYYYMMDD
Default value: current date
TO_TIME=
(Optional) End time of the selection from the system log.
Format: HHMMSS
Default value: 235959
ENCODING=
(missing or bad snippet)

Example

The following example reads the central SAP system log of the previous week. The start date for the system log selection is calculated using the script function SUB_DAYS. The current date is the basis of this calculation.

: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#'