Entering content frame

Function documentation Self-Monitoring Monitor for the XMW Interface Locate the document in its SAP Library structure

Use

As of SAP Web AS 6.20, Support Package 12, an additional instrumentation interface is available to developers. This interface has the name XMW (eXternal Monitoring Write). Data is transferred to the CCMS monitoring architecture using XML documents with the XMW interface. This data is displayed like all other data in the alert monitor of the monitoring architecture.

In detail, the interface offers the following options:

·        Creating any monitoring trees with their monitoring tree elements (MTEs)

·        Setting properties and methods of individual MTEs

·        Reporting values, messages, or the status for the monitor attributes created

Note

For more information about the XMW interface, see the SAP Service Marketplace, in the System Management and Alert Monitoring area (http://service.sap.com/monitoring). Choose Developers’ Zone there, and then choose XMW: Transferring Data to the Monitoring Architecture Using XML from the list of documents.

The most important error messages and status information for the XMW interface is displayed in the subtree XML_Selfmonitoring in the system-wide subtree of the CCMS Selfmonitoring monitor.

This graphic is explained in the accompanying text

Features

The monitor contains the following MTEs:

MTE Name
(MTE Class)

Meaning

XML_Selfmonitoring
(XML_SelfMonitoring)

Subtree with the self-monitoring of the XMW interface

Inbound Processing
(XML_Processing)

Subtree with the data of the XML log, which displays both errors that occur during the processing of the XML documents and errors when calling the corresponding function modules of the monitoring architecture.

XML Log
(XML_Log)

XML log; this can contain the following messages:

·        Start and end times of the HTTP POST requests and the data collection methods for transferring the XML documents

·        Formal errors during the conversion of the XML document (without the use of the CCMS DTD), such as tags that were not closed

·        Errors during the final conversion of the XML document using the CCMS DTD, such as unexpected and out-of-sequence elements; these errors are generated internally in the SAP system and are associated with every inbound XML document

·        Errors during the processing of the data in the XML files in the CCMS function modules (function group SALI); the error message of the corresponding function module is displayed

<Name of the data collection method>
(XML_SelfMoniSummary)

Subtree created for each data collection method that requests XML documents for processing in the monitoring architecture with the help of a CCMS agent; in the above figure, you can see this subtree for the delivered method CCMS_XML_FILE_POLL

Agent
(XML_Agent)

Values of the parameters for the relevant methods for the monitoring object

Source Directory
(XML_Directory)

Files to select
(XML_FileSelect)

File specification
(XML_FileSpecification)

Last data supplier run
(XML_LastDSRun)

Last run of the data collection method; the time stamps (in the time zone of the executing system) are identical to the time stamps of the associated messages in the XML Log

Most recent file timestamp

Time of the most recent change to the XML files that are monitored with this method. Only files with a change time newer than the time of the last data collection method run are processed during the next run of the method

HTTP

Subtree for the last HTTP POST request

Last data supplier run

Time stamp of the last HTTP POST request; the time stamps are identical to the time stamps of the associated messages in the XML Log

The most important node here is the log attribute XML Log. To display all messages of this monitoring attribute, select the node and choose Display Details (This graphic is explained in the accompanying text). Note that, by default, only the messages from the last 30 minutes are displayed. If you want to change this period, choose the Time Interval This graphic is explained in the accompanying text button.

Note

If you are using the data transfer with HTTP POST, the messages of the XML log are also transferred to the HTTP clients using the HTTP response. Otherwise, the HTTP response contains the XML document as a string, as it was transferred to the CCMS class for processing.

Activities

To start the monitor, follow the procedure below:

...

       1.      Start the Alert Monitor using transaction RZ20 or choose CCMS ® Control/Monitoring ® Alert Monitor.

       2.      On the CCMS Monitor Sets screen, expand the SAP CCMS Technical Expert Monitor set.

       3.      Start the CCMS Selfmonitoring monitor from the list by double-clicking it.

 

Leaving content frame