Automation Engine Script-Leitfaden > AE JCL für Anwendungen > SAP > R3_GET_MONITOR

R3_GET_MONITOR

Liest Daten eines SAP-Monitors.

Transaktion: RZ20

Schnittstelle: Standard

Syntax

R3_GET_MON[ITOR]

MONITOR_SET=...
,MONITOR=...
,FILE=...

Syntax	Beschreibung/Format
MONITOR_SET=	Name der Monitorsammlung (maximal 60 Zeichen). Format: Name oder Script-Literal
MONITOR=	Name eines Monitors (maximal 60 Zeichen). Format: Name oder Script-Literal
FILE=	Name einer Datei, in welcher das Ergebnis (aktuelle Monitordaten) gespeichert werden soll. Format: Name oder Script-Literal
ENCODING=	Encoding für die erzeugte Ausgabedatei (Parameter FILE=). Beispiel: UTF-8 Standardwert: ISO-8859-1 Wird ein nicht unterstütztes bzw. ungültiges Encoding angegeben, so 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 Encodings auflistet.

Kommentare

Das Script-Sprachmittel dient dazu, Daten aus dem SAP-Monitoring auszulesen und in eine Datei zu speichern.

Der SAP-Agent teilt die einzelnen Zeilen, welche ein SAP-Monitor liefert, in feste Spalten auf. Er hinterlegt Spaltennamen und Spaltenbreiten als erste Zeile in der Datei mit den aktuellen Monitordaten. Es gibt folgende Spalten:

PATH - Pfadangabe eines Wertes,
NAME -Name des Wertes,
VALUE - Aktueller Wert,
STATUS - Status: 1 = grün, 2 = gelb, 3 = rot,
DATE - Datum der Prüfung,
TIME - Zeitpunkt der Prüfung,
MESSAGE - Nachricht, die bei einem Protokollattribut angezeigt wird.

Beachten Sie, dass der Zeitstempel in UTC zurückgegeben wird und daher von Ihrer lokalen Zeit abweicht! Das Script-Sprachmittel CONV_TIMESTAMP bietet die Möglichkeit, Datum und Uhrzeit in eine andere Zeitzone umzurechnen (siehe PREP_PROCESS).

Insbesondere sei auch auf die Möglichkeit hingewiesen, Monitordaten mit den Script-Sprachmitteln für Datensequenzen bereitzustellen und zu bearbeiten. Dabei wird R3_GET_MONITOR im Ereignis-Job "EVENT.R3MONITOR" aus dem Mandanten 0000 verwendet. Mit der Script-Funktion PREP_PROCESS kann nun eine Datensequenz mit den Daten eines SAP-Monitors erzeugt werden.

Die Datensequenz wird durch die Script-Anweisungen :PROCESS und :ENDPROCESS verarbeitet. In Kombination mit der Script-Funktion GET_PROCESS_LINE kann auf jede einzelne Zeile der Datensequenz und deren Spalten zugegriffen werden.

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

Siehe auch:

Allgemeines zur SAP-JCL

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support