SAP MII

Among others, SAP Manufacturing Integration and Intelligence (MII) is used to integrate plants and enterprise systems. SAP MII is able to integrate with various system types, communicating via RFC, HTTP or SOAP calls (depending on the communication partner).

The following entities are important:

  • Transactions are used to execute synchronous or asynchronous processes within MII. Often the counterpart on SAP ERP side is communication via IDoc.
  • JCo Messages are used to transfer data in XML format. If SAP ERP is the communication partner usually BAPI calls are made via RFC.
  • Schedulers are responsible to schedule and run transactions, queries, and other objects in SAP MII.
  • Data servers / Message Listeners are used to communicate with plants and SAP ERP systems. They can be regarded as end points / ports for the message processing.

Technical Prerequisites

SAP MII messages can be monitored with older versions of SAP Focused Run.

To be able to monitor SAP MII queues you need:

  • SAP Focused Run 2.0 FP02

The following minimum system requirements apply to the managed SAP MII system:

  • SAP MII:
    • SAP MII 14.0
    • SAP MII 15.0
    • SAP MII 15.1

Note that metrics "Number of failed JCo messages", "Number of intermediate JCo messages", "Number of successful JCo messages", and "Average time to process JCo messages" require to have at least:

  • SAP MII 14.0, SP09
  • SAP MII 15.0, SP07
  • SAP MII 15.1, SP02

See also SAP note 2377889 - System requirements for SAP MII monitoring via Interface & Connection Monitoring.

Advanced Integration Monitoring Setup

Please, select...

To be able to monitor interfaces of an on-premise system you first have to add it to Interface & Cloud Monitoring and select the monitoring categories you want to monitor for the system. 

  1. Open the Advanced Integration Monitoring Application by clicking on the 'Integration & Cloud Monitoring' tile in transaction FRUN
  2. Click on the pinwheel in the upper right corner of the 'Integration & Cloud Monitoring' application
  3. In the configuration panel expand the 'Technical Systems' tray and click on the pen icon in the upper right corner. This will open the 'Integration and Cloud Monitoring - Systems' view. 
  4. If your system is not on the list yet, click the 'Add' button to add it. If it is on the list, click on the system ID of the system. 

In the next step, you see all monitoring categories which are available for the system, depending on the system type and the installed software components. Some recommended standard monitoring categories are preselected.

Select the monitoring categories in scope.

Available Monitoring Categories

The available monitoring categories are:

  • MII Messages: MII messages send and received from the SAP MII system
  • MII Queue: Status of the MII queues in the SAP MII system

Please, select...

After selecting your monitoring categories you have to maintain filters to define what exactly you want to monitor. Some monitoring categories come with standard filters that usually just select all items of this monitoring category. SAP Focused Run can handle this high amount of monitoring data, so you can stick to this standard filters. Or you can set up filters of your own. 

Please note that the filters you set in the 'Monitoring' step filter the data which is collected from the managed system or cloud service. You can also set up filters later in the 'Alerting' step, which will filter the data already in Focused Run.

You can create more than one filter for a monitoring category.

  1. Select the view 'Monitoring'
  2. To add a new filter click the '+' button on the upper right corner of the table
  3. Select the Category for the filter. The drop down list will contain all activated categories for the system
  4. Enter a filter name
  5. Select the target client for the ABAP system / the end-point for the cloud services
Which filter fields are available depends on the selected category.

Available Filter Options

MII Messages

For SAP MII message monitoring, you can collect all MII messages sent or received in the managed system. You can also use the following filter parameters, to restrict the data collection:

  • Message Type: RFC, IDOC or WebService.
  • Status Group: ERROR, PROCESSING, SUCCESSFUL
  • Status: select the desired status from the input help
  • Server name: Name of the server the transaction is running on
  • Category: Queue in which the message is saved in the buffer for sequential processing. Only available if the message has processing type Category.
  • Message Name: Name of the RFC (synchronous or asynchronous), IDoc type, or Web Service message.

MII Queue

For SAP MII queue monitoring, you can collect all MII queues in the managed system. You can also use the following filter parameters, to restrict the data collection:

  • Document Type: The type of workflow that is used to dispatch messages for processing (e.g. MATMAS03 or INVCON02_INV_PEG)
  • Status: FAILED, PASSED, QUEUED, RETRY

Please, select...

The setup of the filters for the monitoring categories only makes sure that the data is collected, however, alerts are not created automatically. To create alerts and notifications you have to create an alert individually. 

  1. Go the the view 'Alerting'
  2. Click on the '+' button in the upper right corner of the alerts table. A new panel will appear below the table for you to enter the alert information
  3. Select the monitoring category
  4. Select the metric name. The available metrics depend on the monitoring category.
  5. Enter a name for the alert

In the next sub-step, you have to maintain the filter. For most monitoring categories the available filter fields will be the same as for the 'Monitoring' configuration described above. 

For some metrics, you have additional filter fields or you have to maintain metric parameters. You can check the collected data in Focused Run to determine which filter values to use for alerting. Most of the fields can be found in the Collection Context of the collected data.

Please note that the filters on 'Alerting' level filter the data that is already available in Focused Run. They do not influence the data collection itself. You can only filter for data that is collected. Be aware of this if you created strict filters in the 'Monitoring' step.

  1. Enter a name for the filter
  2. Maintain the necessary filter fields

In the last sub-step you have to activate the alert:

  1. Check the check box next to 'Active'
  2. You can adjust the calculation frequency and the severity
  3. Available threshold types depend on the metric selected. If the threshold type allows it you can adjust the threshold value which triggers the alert.
  4. Select the notification variant and the outbound connector variant from the drop-down list.

For single exceptions, the threshold type is always 'Already Rated'. This means depending on the calculation frequency the number of exceptions is checked and an alert is created if this number is bigger than 0. If you want to reduce the number of alert for these metrics, you could increase the value for the calculation frequency to increase the time between checks.

Available Metrics

For interfaces of type MII the following metrics are collected:

MII Messages

  • MII messages in status "Error" for longer than N minutes: Indicates new MII messages in the status group ERROR were collected during the collection interval
    Metric parameters: 
    • STATUS_GROUP (not changeable) = ERROR
    • OLDER_THAN_MINUTES = Only consider MII messages older than [minutes] 
  • Number of MII messages in status "Backlog" for longer than N minutes: The number of MII messages in the status group PROCESSING found during the collection interval
    Metric parameters:  
    • STATUS_GROUP (not changeable) = PROCESSING
    • OLDER_THAN_MINUTES = Only consider MII messages older than [minutes]

MII Queue

  • Number of Message Queue entries in status FAILED: Indicates a high number of SAP MII queues are in status FAILED (Error indicator)
    Metric parameters:
    • Document Type: The type of workflow that is used to dispatch messages for processing (e.g. MATMAS03 or INVCON02_INV_PEG)
    • Status: Select FAILED from the input help
    • Status Group (not changeable) = FAILED
  • Number of Message Queue entries in status QUEUED: Indicates a high number of SAP MII queues are in status QUEUES (Backlog indicator)
    Metric parameters:
    • Document Type: The type of workflow that is used to dispatch messages for processing (e.g. MATMAS03 or INVCON02_INV_PEG)
    • Status: Select QUEUED from the input help
    • Status Group (not changeable) = QUEUED