Automation Engine Script Guide > AE JCL for Applications > SAP > R3_GET_MONITOR

R3_GET_MONITOR

Reads data from an SAP monitor.

Transaction: RZ20

Interface: Standard

Syntax

R3_GET_MON[ITOR]

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

Syntax

Description/Format

MONITOR_SET=

Name of monitor set (maximum 60 characters).
Format: Name or script literal

MONITOR=

Name of  monitor (maximum 60 characters).
Format: Name or scriptA particular Automation Engine object type. literal

FILE=

Name of the file in which the result (current monitor data) should be stored.
Format: Name or script literal

ENCODING=

Encoding for the generated output file (Parameter FILE=).

For example: UTF-8

Default value: ISO-8859-1

When you specify an encoding that is not supported or invalid, the jobAn Automation Engine object type for a process that runs on a target system. will abort with an error message.

The SAP Forms provide an input assistant for this field which lists all the supported encodings.

Comments

This script element is used to read data from an SAP monitor and store it in a file.

The SAP agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host puts individual lines that are supplied by an SAP monitor into fixed columns. It stores column names and column size as the first line in the file and provides data for the current monitor. The following columns are available:

PATH - Path specification of a value,
NAME - Name of the value,
VALUE - Current value,
STATUS - Status: 1 = green, 2 = yellow, 3 = red,
DATE - Date of test,
TIME - Time of test,
MESSAGE - Message which is displayed with a protocol attribute.

Note that the time stamp is returned in UTC and can differ from your local time. Use the script element CONV_TIMESTAMP in order to convert date and time to another TimeZone (see PROP_PROCESS).

You can also prepare and edit monitor data using script elements for the data sequences. R3_GET_MONITOR is used in the eventAction that is triggered if particular conditions apply. It can be an Automation Engine object type or an entry in a Policy Orchestrator EventBase. job "EVENT.R3MONITOR" in clientA closed environment within an Automation Engine system where you can create and run objects. A client name consists of a 4-digit number that must be indicated when a user logs on to the Automation Engine system. Users and their rights are also defined in clients. A particular Automation Engine object type. 0000. You can create a data sequenceAn internal listing of Console outputs or lines of Variable objects, etc. The lines of a data sequence can be accessed by using a PROCESS loop or the script element GET_PROCESS_LINE. The script elements PREP_PROCESS* generate data sequences. from an SAP monitor by using the script functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… PREP_PROCESS.

The data sequence is processed by the script statements :PROCESS and :ENDPROCESS. In combination with the script function GET_PROCESS_LINE, you can access each individual line of the data sequence and its columns.

Note that by default, created files are saved on the computer on which the agent is installed  (for example, R3_GET_JOB_SPOOL; FILE=).

 

See also:

 


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

Copyright © 2016 Automic Software GmbH