SAP MII 12.1/12.2 Service Interface - Monitoring

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BA - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 1

SAP MII 12.1/12.2 Service

Interface - Monitoring

Applies to:

SAP Manufacturing Integration and Intelligence. For more information, visit the Manufacturing

homepage.

Summary

This article describes the SAP MII Monitoring Service.

Author(s): Krasimira Velikova

Company: SAP Labs, LLC

Created on: 10 August 2011

Author Bio

Krasimira Velikova is a Software Developer for SAP Labs. She is currently part of MII Installed

Based Maintenance and Support (IMS) Team.

https://www.sdn.sap.com/irj/sdn/bpx-manufacturing

https://www.sdn.sap.com/irj/sdn/bpx-manufacturing

SAP MII 12.1/12.2 Service Interface - Monitoring


© 2012 SAP AG 2

Table of Contents

Indexing .............................................................................................................................................................. 5

Missing ............................................................................................................................................................ 5 Request parameters .................................................................................................................................................... 5

Response ..................................................................................................................................................................... 5

Example ....................................................................................................................................................................... 5

ModeList .......................................................................................................................................................... 6 Request parameters .................................................................................................................................................... 6

Response ..................................................................................................................................................................... 6

Example ....................................................................................................................................................................... 6

Reindex ........................................................................................................................................................... 7 Request parameters .................................................................................................................................................... 7

Response ..................................................................................................................................................................... 7

Example ....................................................................................................................................................................... 7

Start 7 Request parameters .................................................................................................................................................... 7

Response ..................................................................................................................................................................... 7

Example ....................................................................................................................................................................... 7

Status .............................................................................................................................................................. 8 Request parameters .................................................................................................................................................... 8

Response ..................................................................................................................................................................... 8

Example ....................................................................................................................................................................... 8

Usage .............................................................................................................................................................. 8 Request parameters .................................................................................................................................................... 8

Response ..................................................................................................................................................................... 8

Example ....................................................................................................................................................................... 9

Monitoring ........................................................................................................................................................... 9

DataServers .................................................................................................................................................... 9 Request parameters .................................................................................................................................................... 9

Response ................................................................................................................................................................... 10

Example: Retrieve the all available usage statistic from the latest 30000 minutes. ................................................... 10

Example: Retrieve the usage statistic for a specific Data Server. .............................................................................. 11

FileUsage ...................................................................................................................................................... 12 Request parameters .................................................................................................................................................. 12

Response ................................................................................................................................................................... 12

Example: Get the available usage statistic from the latest’s 6000 hours. .................................................................. 13

Example: Get the available usage statistic for a specific folder for the latest’s 6000 hours. ...................................... 14

Example: Get the usage statistic for a specific file. .................................................................................................... 15

FileUsageSummary ....................................................................................................................................... 15 Request parameters .................................................................................................................................................. 15

Response ................................................................................................................................................................... 16

Example: Get the file usage summary for a folder for the latest 6000 hours .............................................................. 16

Logins ............................................................................................................................................................ 17 Request parameters .................................................................................................................................................. 17

Response ................................................................................................................................................................... 17



© 2012 SAP AG 3

Example: Get the login information for the latest 24hours. ........................................................................................ 17

LoginsSummary ............................................................................................................................................ 18 Request parameters .................................................................................................................................................. 18

Response ................................................................................................................................................................... 18

Example: Get login summary for the Administrator. ................................................................................................... 18

Example: Get the login summary for all users’ logins for the last 24 hours. ............................................................... 19

Messages ...................................................................................................................................................... 19 Request parameters .................................................................................................................................................. 19

Response ................................................................................................................................................................... 20

Example: Get the Message Listener activity summary for the last 24 hours. ............................................................. 20

ModeList ........................................................................................................................................................ 21 Request parameters .................................................................................................................................................. 21

Response ................................................................................................................................................................... 21

Example ..................................................................................................................................................................... 21

UserQuery ..................................................................................................................................................... 21 Request parameters .................................................................................................................................................. 21

Response ................................................................................................................................................................... 22

Example: Get the query monitor information for the last 24h ..................................................................................... 22

Example: Gets the query monitoring information for the Administrator user .............................................................. 22

BLSManager ..................................................................................................................................................... 23

ClearCache ................................................................................................................................................... 23 Request parameters .................................................................................................................................................. 23

Response ................................................................................................................................................................... 24

Example ..................................................................................................................................................................... 24

Delete ............................................................................................................................................................ 24 Request parameters .................................................................................................................................................. 24

Response ................................................................................................................................................................... 24

Example ..................................................................................................................................................................... 24

Details ........................................................................................................................................................... 24 Request parameters .................................................................................................................................................. 25

Response ................................................................................................................................................................... 25

Example ..................................................................................................................................................................... 25

FixHighExpiringTransactions ........................................................................................................................ 26 Request parameters .................................................................................................................................................. 26

Response ................................................................................................................................................................... 26

Example ..................................................................................................................................................................... 26

List 26 Request paramaters .................................................................................................................................................. 26

Response ................................................................................................................................................................... 27

Example ..................................................................................................................................................................... 27

ModeList ........................................................................................................................................................ 28 Reuquest parameters ................................................................................................................................................ 28

Response ................................................................................................................................................................... 28

Example ..................................................................................................................................................................... 28

Stats 29 Request parameters .................................................................................................................................................. 29



© 2012 SAP AG 4

Response ................................................................................................................................................................... 29

Example ..................................................................................................................................................................... 29

Terminate ...................................................................................................................................................... 32 Request parameters .................................................................................................................................................. 32

Response ................................................................................................................................................................... 32

Example ..................................................................................................................................................................... 32

ViewCache .................................................................................................................................................... 32 Response ................................................................................................................................................................... 32

Example ..................................................................................................................................................................... 33

ViewLog ........................................................................................................................................................ 33 Request parameters .................................................................................................................................................. 33

Response ................................................................................................................................................................... 33

Example ..................................................................................................................................................................... 33

ViewOutput .................................................................................................................................................... 34 Request parameters .................................................................................................................................................. 34

Response ................................................................................................................................................................... 34

Example ..................................................................................................................................................................... 34

Copyright........................................................................................................................................................... 35



© 2012 SAP AG 5

Indexing

The index types are the list of different items which are indexed whenever a file is saved.

When calling services the index type must be specified since object names are not guaranteed

to be unique across index types.

Index

Type

Available Description

credential 12.1 and

later

Credential alias uses in Transactions

connection 12.1 and

later

Connection alias uses in Transactions

dataserver 12.1 and

later

Data server uses in Query Templates

file 12.2 and

later

Transaction, Template and Manufacturing Data Object uses

The indexing service includes method for examine what is indexed as well as providing an

interface to kick off and monitor an indexer. The indexer rebuilds the index information. It will

run through all files in the database and re-index them. This should only be used if somehow

the indexes get out of sync.

Missing

You use this mode to retrieve a list of index objects for which the object itself does not exist.

For example for a data server it will retrieve a list of the data servers which are used in a

query template, but that do not exist.

Request parameters

Parameter Optional Description

Type No The index type

Response

Name Description

Name A missing object name

Example

Request

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=missing&type=dataserver&c

ontent-type=text/xml

Response

<?xml version="1.0" encoding="UTF-8" ?> <Rowsets DateCreated="2011-11-14T11:59:01" EndDate="2011-11-14T11:59:01" StartDate="2011-11-14T10:59:01" Version="12.1.10 Build(13)">

<Rowset> <Columns>

<Column Description="Name" MaxRange="1" MinRange="0" Name="Name" SQLDataType="12" SourceColumn="Name" />

</Columns> <Row>

<Name>ActivePortal</Name> </Row> <Row>

<Name>AlarmSuite</Name> </Row> <Row>

<Name>ISS_Tag</Name>

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=missing&type=dataserver&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=missing&type=dataserver&content-type=text/xml



© 2012 SAP AG 6

</Row> <Row>

<Name>InTrack</Name> </Row> <Row>

<Name>MIT_PIUDS</Name> </Row>

<Row> <Name>MIT_ProcessHistorian</Name>

</Row> <Row>

<Name>MIT_xMIIDemo</Name> </Row> <Row>

<Name>MSOLAP</Name> </Row> <Row>

<Name>OLAP</Name> </Row> <Row>

<Name>QualityPortal</Name> </Row>

</Rowset> </Rowsets>

ModeList

You use this mode to retrieve a list with the modes that indexing service supports.

Request parameters

It does not require any additional request parameters.

Response

Name Description

ModeName The mode name

Example

Request

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=modelist&content-

type=text/xml

Response


<Rowset> <Columns>

<Column Description="ModeName" MaxRange="1" MinRange="0" Name="ModeName" SQLDataType="1" SourceColumn="ModeName" />

</Columns> <Row>

<ModeName>Missing</ModeName> </Row> …… <Row>

<ModeName>Usage</ModeName> </Row>


http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=modelist&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=modelist&content-type=text/xml



© 2012 SAP AG 7

Reindex

You use this mode to delete all existing indexing information and re-index the system. In order

to be able to run this service the user has to have a permission to run the indexing service.

The action name is XMII_Indexer and the roles that have this action assigned by default are

SAP_XMII_Super_Administrator and SAP_XMII_Administrator.

Request parameters

This mode does not require any additional request parameters.

Response

The response is Successful or Error message.

Example

Request

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=reindex&content-

type=text/xml

Response


<Messages> <Message>Successful</Message>

</Messages> </Rowsets>

Start

You use this mode to start the indexing service if not already started. In order to be able to

run this service the user has to have a permission to run the indexing service. The action name

is XMII_Indexer and the roles that have this action assigned by default are


Request parameters


Response

The response is Successful or Error message.

Example

Request

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=start&content-

type=text/xml

Response




http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=reindex&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=reindex&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=start&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=start&content-type=text/xml



© 2012 SAP AG 8

Status

You use this mode to view the status of the indexer and a list of the files that were indexed.

This mode like Reindex and Start requires addition permissions to be run. . The action name is

XMII_Indexer and the roles that have this action assigned by default are


Request parameters


Response

Name Description

Name The indexed file name

Example

Request

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=status&content-

type=text/xml

Response


<Rowset> <Columns>


</Columns> <Row>

<Name>Indexed file Predefined/AuditServiceVerify.tqte</Name> </Row> <Row>

<Name>Indexed file Predefined/AuditServiceWriter.tqte</Name> </Row> <Row>

<Name>Indexed file Predefined/DefaultAlarmStatisticsFrequencyChart.tdch</Name> </Row> ………

</Rowset> <Messages>

<Message>Indexer is running</Message> <Message>Processed 1641 of 3674 files</Message>


Usage

You use this mode to display the files which use a specific data server, connection or credential

alias. It can be used to find where a missing indexed object is used.

Request parameters


Type No The index type

Name No The name of the data server, credential or connection

Response

Name Description

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=status&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=status&content-type=text/xml



© 2012 SAP AG 9

Name The absolute path name

Example

Request

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=usage&type=dataserver&na

me=MIT_xMIIDemo&content-type=text/xml

Response


<Rowset> <Columns>


</Columns> <Row>

<Name>MII 12.0 Unit Tests/ChartRegression/SpecificTests/Batch SPC/BatchSPCQuery.tqsq</Name>

</Row> </Rowset>

</Rowsets>

Monitoring

You use this service for retrieving statistics information for logins, file usage, server usage, etc.

It can be used to determine what type of load is on a system, what is being run and how often.

Monitoring data is automatically cleaned up every 30 days. You configure the retention period it through the System Administration Screen by setting a different value to

MonitoringRetentionDuration.

DataServers

You use this mode to view the usage summary of a specific Data Server or all available Data

Server. The usage statistic is provided per day. If you request the statistic information for all

servers you can use all date parameters (such as StartData, EndDate and Duration) to specify

the exact time frame for the usage report. If you request usage summary for a specific Data

Server you will get the summary of its usage for the configured monitoring retention period.

Request parameters


Server yes The Data Server which usage statistic you want to retrieve. If no

server is provided then the statistic of all available Data Servers

will be retrieved.

StartDate yes The start date for the Data Servers usage. DataServer usage

before that date will not be included in the result set. The

format is MM/dd/yyyy HH:mm:ss.

The default value, which is used when this parameter is not

provided, is EndDate – Duration

It is used only when no server parameter is provided.

EndDate yes The end date for the Data Servers usage. DataServer usage

after that date will not be included in the result set. The format

is MM/dd/yyyy HH:mm:ss. The default value is:

when no start date is provided it is current time,

when start date is provided it is StartDate +Duration

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=usage&type=dataserver&name=MIT_xMIIDemo&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Indexing&Mode=usage&type=dataserver&name=MIT_xMIIDemo&content-type=text/xml

http://help.sap.com/saphelp_mii121/helpdata/en/45/59840fe39065d1e10000000a1553f6/frameset.htm



© 2012 SAP AG 10


Duration yes The duration of the time frame in minutes. The default duration

is 60 minutes.


Response

Name Description

RecordedDate The date when the statistic record was created

ServerName The data server name

NumberHits The number of times when the data server was used on that

date

RowsReturned The number of returned rows

TimeToRun The time used to retrieve these rows

ErrorCount The number of errors that occurred when the data server was

used

CommErrorCount The number of communication errors.

Example: Retrieve the all available usage statistic from the latest 30000 minutes.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=DataServers&Duration=30

000&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="RecordedDate" MaxRange="1" MinRange="0" Name="RecordedDate" SQLDataType="93" SourceColumn="RecordedDate" /> <Column Description="ServerName" MaxRange="1" MinRange="0" Name="ServerName" SQLDataType="1" SourceColumn="ServerName" /> <Column Description="NumberHits" MaxRange="1" MinRange="0" Name="NumberHits" SQLDataType="-5" SourceColumn="NumberHits" /> <Column Description="RowsReturned" MaxRange="1" MinRange="0" Name="RowsReturned" SQLDataType="-5" SourceColumn="RowsReturned" /> <Column Description="TimeToRun" MaxRange="1" MinRange="0" Name="TimeToRun" SQLDataType="-5" SourceColumn="TimeToRun" /> <Column Description="ErrorCount" MaxRange="1" MinRange="0" Name="ErrorCount" SQLDataType="-5" SourceColumn="ErrorCount" /> <Column Description="CommErrorCount" MaxRange="1" MinRange="0" Name="CommErrorCount" SQLDataType="-5" SourceColumn="CommErrorCount" />

</Columns> <Row>

<RecordedDate>2011-12-06T00:00:00</RecordedDate> <ServerName>Simulator</ServerName> <NumberHits>4</NumberHits> <RowsReturned>136</RowsReturned> <TimeToRun>1296</TimeToRun> <ErrorCount>0</ErrorCount> <CommErrorCount>0</CommErrorCount>

</Row> <Row>

<RecordedDate>2011-12-06T00:00:00</RecordedDate> <ServerName>xMIIDemo</ServerName> <NumberHits>7</NumberHits> <RowsReturned>21</RowsReturned> <TimeToRun>76</TimeToRun> <ErrorCount>4</ErrorCount> <CommErrorCount>0</CommErrorCount>

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=DataServers&Duration=30000&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=DataServers&Duration=30000&content-type=text/xml



© 2012 SAP AG 11

</Row> <Row>

<RecordedDate>2011-12-01T00:00:00</RecordedDate> <ServerName>XacuteConnector</ServerName> <NumberHits>3</NumberHits> <RowsReturned>19</RowsReturned> <TimeToRun>275</TimeToRun>

<ErrorCount>0</ErrorCount> <CommErrorCount>0</CommErrorCount>

</Row> <Row>

<RecordedDate>2011-11-29T00:00:00</RecordedDate> <ServerName>XacuteConnector</ServerName> <NumberHits>16</NumberHits> <RowsReturned>62</RowsReturned> <TimeToRun>466</TimeToRun> <ErrorCount>0</ErrorCount> <CommErrorCount>0</CommErrorCount>

</Row> <Row>


</Row> </Rowset>

</Rowsets>

Example: Retrieve the usage statistic for a specific Data Server.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=DataServers&Server=Xacu

teConnector&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="RecordedDate" MaxRange="1" MinRange="0" Name="RecordedDate" SQLDataType="93" SourceColumn="RecordedDate" /> <Column Description="ServerName" MaxRange="1" MinRange="0" Name="ServerName" SQLDataType="1" SourceColumn="ServerName" /> <Column Description="NumberHits" MaxRange="1" MinRange="0" Name="NumberHits" SQLDataType="-5" SourceColumn="NumberHits" /> <Column Description="RowsReturned" MaxRange="1" MinRange="0" Name="RowsReturned" SQLDataType="-5" SourceColumn="RowsReturned" /> <Column Description="TimeToRun" MaxRange="1" MinRange="0" Name="TimeToRun" SQLDataType="-5" SourceColumn="TimeToRun" /> <Column Description="ErrorCount" MaxRange="1" MinRange="0" Name="ErrorCount" SQLDataType="-5" SourceColumn="ErrorCount" /> <Column Description="CommErrorCount" MaxRange="1" MinRange="0" Name="CommErrorCount" SQLDataType="-5" SourceColumn="CommErrorCount" />

</Columns> <Row>


http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=DataServers&Server=XacuteConnector&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=DataServers&Server=XacuteConnector&content-type=text/xml



© 2012 SAP AG 12

</Row> <Row>

<RecordedDate>2011-11-29T00:00:00</RecordedDate> <ServerName>XacuteConnector</ServerName> <NumberHits>16</NumberHits> <RowsReturned>62</RowsReturned> <TimeToRun>466</TimeToRun>

<ErrorCount>0</ErrorCount> <CommErrorCount>0</CommErrorCount>

</Row> <Row>


</Row> </Rowset>

</Rowsets>

FileUsage

You use this mode to get the statistical information about the usage of a file (such as

Transaction or Query). As Data Servers mode you can get all available statistics for a specific

time frame and/or path, or you can get the usage statistic for a specific file.

Request parameters


ID Yes The file id. If this parameter is specified then only the statistic

information for the requested file will be retrieved.

Path Yes The path. If this parameter is specified then only the statistic

information for the files from the specified folder will be

retrieved. This parameter takes effect only when no ID

parameter is provided.

StartDate yes The start date for the file usage. Any usage before that date will

not be included in the result set. The format is MM/dd/yyyy

HH:mm:ss.



This parameter takes effect only when no ID parameter is

provided.

EndDate yes The end date for the file usage. Any usage after that date will

not be included in the result set. The format is “MM/dd/yyyy

HH:mm:ss”. The default value is: when no start date is provided it is current time,

when start date is provided it is StartDate + Duration


provided.


is 60 minutes.


provided.

Response

Name Description

Name The file name



© 2012 SAP AG 13

NumberRuns The number times it was run

Minimum The minimum execution time

Maximum The maximum execution time

Average The average execution time.

Example: Get the available usage statistic from the latest’s 6000 hours.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&Duration=6000

&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="Name" MaxRange="1" MinRange="0" Name="Name" SQLDataType="12" SourceColumn="Name" /> <Column Description="NumberRuns" MaxRange="1" MinRange="0" Name="NumberRuns"

SQLDataType="-5" SourceColumn="NumberRuns" /> <Column Description="Minimum" MaxRange="1" MinRange="0" Name="Minimum" SQLDataType="-5" SourceColumn="Minimum" /> <Column Description="Maximum" MaxRange="1" MinRange="0" Name="Maximum" SQLDataType="-5" SourceColumn="Maximum" /> <Column Description="Average" MaxRange="1" MinRange="0" Name="Average" SQLDataType="-5" SourceColumn="Average" />

</Columns> <Row>

<Name>MII 12.0 Unit Tests/Actions/Data Queries/Aggregate/SimulatorAssetUtilQuery.tqta</Name> <NumberRuns>2</NumberRuns> <Minimum>65</Minimum> <Maximum>720</Maximum> <Average>392</Average>

</Row> <Row>

<Name>Demo/Transaction/Demo.trx</Name> <NumberRuns>18</NumberRuns> <Minimum>115</Minimum> <Maximum>2139</Maximum> <Average>548</Average>

</Row> <Row>

<Name>Demo/Transaction/DemoNS_short.trx</Name> <NumberRuns>58</NumberRuns> <Minimum>20</Minimum> <Maximum>118946</Maximum> <Average>4969</Average>

</Row> <Row>

<Name>Demo/Transaction/DemoNS.trx</Name> <NumberRuns>2</NumberRuns> <Minimum>85</Minimum> <Maximum>253</Maximum> <Average>169</Average>

</Row> <Row>


</Row> <Row>

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&Duration=6000&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&Duration=6000&content-type=text/xml



© 2012 SAP AG 14


</Row> </Rowset>

</Rowsets>

Example: Get the available usage statistic for a specific folder for the latest’s 6000 hours.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&Duration=6000

&Path=Demo/Transaction&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="Name" MaxRange="1" MinRange="0" Name="Name" SQLDataType="12" SourceColumn="Name" /> <Column Description="NumberRuns" MaxRange="1" MinRange="0" Name="NumberRuns" SQLDataType="-5" SourceColumn="NumberRuns" /> <Column Description="Minimum" MaxRange="1" MinRange="0" Name="Minimum" SQLDataType="-5" SourceColumn="Minimum" /> <Column Description="Maximum" MaxRange="1" MinRange="0" Name="Maximum" SQLDataType="-5" SourceColumn="Maximum" /> <Column Description="Average" MaxRange="1" MinRange="0" Name="Average" SQLDataType="-5" SourceColumn="Average" />

</Columns> <Row>


</Row> <Row>


</Row> <Row>

<Name>Demo/Transaction/DemoNS.trx</Name> <NumberRuns>2</NumberRuns> <Minimum>85</Minimum> <Maximum>253</Maximum> <Average>169</Average>

</Row> <Row>


</Row> <Row>


http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&Duration=6000&Path=Demo/Transaction&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&Duration=6000&Path=Demo/Transaction&content-type=text/xml



© 2012 SAP AG 15

</Row> </Rowset>

</Rowsets>

Example: Get the usage statistic for a specific file.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&ID=4099&conte

nt-type=text/xml

Response


<Rowset> <Columns>

<Column Description="Name" MaxRange="1" MinRange="0" Name="Name" SQLDataType="12" SourceColumn="Name" /> <Column Description="NumberRuns" MaxRange="1" MinRange="0" Name="NumberRuns" SQLDataType="-5" SourceColumn="NumberRuns" /> <Column Description="Minimum" MaxRange="1" MinRange="0" Name="Minimum" SQLDataType="-5" SourceColumn="Minimum" /> <Column Description="Maximum" MaxRange="1" MinRange="0" Name="Maximum" SQLDataType="-5" SourceColumn="Maximum" /> <Column Description="Average" MaxRange="1" MinRange="0" Name="Average" SQLDataType="-5" SourceColumn="Average" />

</Columns> <Row>


</Row> <Row>


</Row> <Row>


</Row> </Rowset>

</Rowsets>

FileUsageSummary

You use this mode to get a summary of the file usage summary for a specific time frame

and/or path.

Request parameters


Path Yes The path. If this parameter is specified then only the statistic

information for the files from the specified folder will be

retrieved. If this parameter is not specified then the result set

contains the summary of all file usage for the specified time

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&ID=4099&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsage&ID=4099&content-type=text/xml



© 2012 SAP AG 16

frame.



HH:mm:ss”.








is 60 minutes.

Response

Name Description

Name The file name

NumberRuns The number times it was run

Minimum The minimum execution time

Maximum The maximum execution time

Average The average execution time.

Example: Get the file usage summary for a folder for the latest 6000 hours

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=FileUsageSummary&Duration=6000&Path=Demo/Transaction&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="Name" MaxRange="1" MinRange="0" Name="Name" SQLDataType="12" SourceColumn="Name" /> <Column Description="NumberRuns" MaxRange="1" MinRange="0" Name="NumberRuns" SQLDataType="-5" SourceColumn="NumberRuns" /> <Column Description="Minimum" MaxRange="1" MinRange="0" Name="Minimum" SQLDataType="-5" SourceColumn="Minimum" />

<Column Description="Maximum" MaxRange="1" MinRange="0" Name="Maximum" SQLDataType="-5" SourceColumn="Maximum" /> <Column Description="Average" MaxRange="1" MinRange="0" Name="Average" SQLDataType="-5" SourceColumn="Average" />

</Columns> <Row>


</Row> <Row>

<Name>Demo/Transaction/DemoNS.trx</Name> <NumberRuns>2</NumberRuns> <Minimum>85</Minimum>





© 2012 SAP AG 17

<Maximum>253</Maximum> <Average>169</Average>

</Row> <Row>

<Name>Demo/Transaction/DemoNS_short.trx</Name> <NumberRuns>69</NumberRuns> <Minimum>20</Minimum>

<Maximum>196869</Maximum> <Average>9734</Average>

</Row> </Rowset>

</Rowsets>

Logins

You use this mode to view login information.

Request parameters


StartDate yes The start date for the login information. Any logins before that

date will not be included in the result set. The format is

“MM/dd/yyyy HH:mm:ss”.



EndDate yes The end date for the login information. Any logins after that

date will not be included in the result set. The format is

“MM/dd/yyyy HH:mm:ss”. The default value is:




is 60 minutes.

Response

Name Description

RecordedDate Self-explanatory

UserName Self-explanatory

TotalLogins Self-explanatory

Example: Get the login information for the latest 24hours.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=Logins&Duration=1440&co

ntent-type=text/xml

Response


<Rowset> <Columns>

<Column Description="RecordedDate" MaxRange="1" MinRange="0" Name="RecordedDate" SQLDataType="93" SourceColumn="RecordedDate" /> <Column Description="Username" MaxRange="1" MinRange="0" Name="Username" SQLDataType="1" SourceColumn="Username" /> <Column Description="TotalLogins" MaxRange="1" MinRange="0" Name="TotalLogins" SQLDataType="-5" SourceColumn="TotalLogins" />

</Columns> <Row>

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=Logins&Duration=1440&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=Logins&Duration=1440&content-type=text/xml



© 2012 SAP AG 18

<RecordedDate>2011-12-06T00:00:00</RecordedDate> <Username>Administrator</Username> <TotalLogins>1</TotalLogins>

</Row> <Row>

<RecordedDate>2011-12-05T00:00:00</RecordedDate> <Username>Administrator</Username>

<TotalLogins>72</TotalLogins> </Row>


LoginsSummary

You use this mode to view login summary per day for a specific user or all logins per day for a

requested time frame.

Request parameters


UserName Yes The name of the user you want to get login summary. If you

provide this parameter you will receive all available information

for his/her logins summarized per day. When this parameter is

not provided then the result query provides login summary for

all users for a determined time frame.



HH:mm:ss”.



It is used only when no UserName parameter is provided.







is 60 minutes.


Response

The following information is returned for every day from the specified time period:

Name Description


TotalLogins Self-explanatory

Example: Get login summary for the Administrator.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=LoginsSummary&UserNam

e=Administrator&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=LoginsSummary&UserName=Administrator&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=LoginsSummary&UserName=Administrator&content-type=text/xml



© 2012 SAP AG 19

Response


<Rowset> <Columns>

<Column Description="RecordedDate" MaxRange="1" MinRange="0" Name="RecordedDate" SQLDataType="93" SourceColumn="RecordedDate" /> <Column Description="TotalLogins" MaxRange="1" MinRange="0" Name="TotalLogins" SQLDataType="-5" SourceColumn="TotalLogins" />

</Columns> <Row>

<RecordedDate>2011-12-07T00:00:00</RecordedDate> <TotalLogins>12</TotalLogins>

</Row> <Row>


</Row> <Row>


</Row> …


Example: Get the login summary for all users’ logins for the last 24 hours.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=LoginsSummary&Duration

=1440&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="RecordedDate" MaxRange="1" MinRange="0" Name="RecordedDate" SQLDataType="93" SourceColumn="RecordedDate" /> <Column Description="TotalLogins" MaxRange="1" MinRange="0" Name="TotalLogins" SQLDataType="-5" SourceColumn="TotalLogins" />

</Columns> <Row>


</Row> <Row>


</Row> </Rowset>

</Rowsets>

Messages

You use this mode to retrieve Message Listener receive and process information.

Request parameters



http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=LoginsSummary&Duration=1440&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=LoginsSummary&Duration=1440&content-type=text/xml



© 2012 SAP AG 20


HH:mm:ss”.





HH:mm:ss”. The default value is:




is 60 minutes.

Response

Name Description


ServerName The message listener name

TotalReceived The number of received message

ProcessingErrors The number of errors that occurred during the processing

ProcessingException The number of exception that occurred during the processing

NoRuleDefined The number of received messages that

MappedCategory The message category

Example: Get the Message Listener activity summary for the last 24 hours.

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=Messages&Duration=1440

&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="RecordedDate" MaxRange="1" MinRange="0" Name="RecordedDate" SQLDataType="93" SourceColumn="RecordedDate" /> <Column Description="ServerName" MaxRange="1" MinRange="0" Name="ServerName" SQLDataType="1" SourceColumn="ServerName" /> <Column Description="TotalReceived" MaxRange="1" MinRange="0" Name="TotalReceived" SQLDataType="-5" SourceColumn="TotalReceived" /> <Column Description="ProcessingErrors" MaxRange="1" MinRange="0" Name="ProcessingErrors" SQLDataType="-5" SourceColumn="ProcessingErrors" /> <Column Description="ProcessingException" MaxRange="1" MinRange="0" Name="ProcessingException" SQLDataType="-5" SourceColumn="ProcessingException" /> <Column Description="NoRuleDefined" MaxRange="1" MinRange="0" Name="NoRuleDefined" SQLDataType="-5" SourceColumn="NoRuleDefined" /> <Column Description="MappedCategory" MaxRange="1" MinRange="0" Name="MappedCategory" SQLDataType="-5" SourceColumn="MappedCategory" />

</Columns>

<Row> <RecordedDate>2011-12-07T00:00:00</RecordedDate> <ServerName>XMIIIDOC01</ServerName> <TotalReceived>16</TotalReceived> <ProcessingErrors>0</ProcessingErrors> <ProcessingException>0</ProcessingException> <NoRuleDefined>0</NoRuleDefined> <MappedCategory>0</MappedCategory>

</Row>

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=Messages&Duration=1440&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=Messages&Duration=1440&content-type=text/xml



© 2012 SAP AG 21


ModeList

You can use this mode to view a list of modes supported by the Monitoring service.

Request parameters

It does not require any additional parameters.

Response

Name Description


Example

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=modelist&content-

type=text/xml

Response


<Rowset> <Columns>


</Columns> <Row>

<ModeName>DataServers</ModeName> </Row> …… <Row>

<ModeName>UserQuery</ModeName> </Row>


UserQuery

You use this mode to get the monitoring summary for the number of query runs and the

number of returned rows. You can retrieve this information for a specified user or for a

specified period.

Request parameters


UserName Yes The user name. If not user name is provided then this mode will

return the monitoring data for a specific time frame.

StartDate yes The start date for the query runs summary. Any query runs

before that date will not be included in the result set. The

format is “MM/dd/yyyy HH:mm:ss”.




EndDate yes The end date for the query runs summary. Any query runs after

that date will not be included in the result set. The format is

“MM/dd/yyyy HH:mm:ss”. The default value is: when no start date is provided it is current time,

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=modelist&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=modelist&content-type=text/xml



© 2012 SAP AG 22




is 60 minutes.


Response

Name Description


Username Self-explanatory

NumberRequests The number of run queries

RowsReturned The number of rows returned by these queries

Example: Get the query monitor information for the last 24h

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=UserQuery&Duration=144

0&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="RecordedDate" MaxRange="1" MinRange="0" Name="RecordedDate" SQLDataType="93" SourceColumn="RecordedDate" />

<Column Description="Username" MaxRange="1" MinRange="0" Name="Username" SQLDataType="1" SourceColumn="Username" /> <Column Description="NumberRequests" MaxRange="1" MinRange="0" Name="NumberRequests" SQLDataType="-5" SourceColumn="NumberRequests" /> <Column Description="RowsReturned" MaxRange="1" MinRange="0" Name="RowsReturned" SQLDataType="-5" SourceColumn="RowsReturned" />

</Columns> <Row>

<RecordedDate>2011-12-07T00:00:00</RecordedDate> <Username>Administrator</Username> <NumberRequests>3</NumberRequests> <RowsReturned>25</RowsReturned>

</Row> <Row>


</Row> </Rowset>

</Rowsets>

Example: Gets the query monitoring information for the Administrator user

Request

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=UserQuery&UserName=Ad

ministrator&content-type=text/xml

Response


http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=UserQuery&Duration=1440&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=UserQuery&Duration=1440&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=UserQuery&UserName=Administrator&content-type=text/xml

http://localhost:50000/XMII/Illuminator?service=Monitoring&Mode=UserQuery&UserName=Administrator&content-type=text/xml



© 2012 SAP AG 23

<Rowset> <Columns>

<Column Description="RecordedDate" MaxRange="1" MinRange="0" Name="RecordedDate" SQLDataType="93" SourceColumn="RecordedDate" /> <Column Description="Username" MaxRange="1" MinRange="0" Name="Username" SQLDataType="1" SourceColumn="Username" /> <Column Description="NumberRequests" MaxRange="1" MinRange="0" Name="NumberRequests"

SQLDataType="-5" SourceColumn="NumberRequests" /> <Column Description="RowsReturned" MaxRange="1" MinRange="0" Name="RowsReturned" SQLDataType="-5" SourceColumn="RowsReturned" />

</Columns> <Row>


</Row> <Row>


</Row> <Row>


</Row> <Row>


</Row> <Row>


</Row> </Rowset>

</Rowsets>

BLSManager

BSLManager service provides access to the Transaction Manager data as well as providing

some general interfaces.

The action required to access BLSManager is XMII_BLSManagerService. The roles that have

this action assigned by default are SAP_XMII_Super_Administrator and

SAP_XMII_Administrator.

ClearCache

You use this mode to clear the transaction cache. It does not require any additional

parameters. The response provides information if the operation was successful or not.

ClearCache mode requires additional permission, in order to clear the case the user has to

have XMII_Transaction_Delete in his profile.

Request parameters

This mode does not require any additional parameters.



© 2012 SAP AG 24

Response

The response contains successful or error message, no data is returned in the response.

Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=ClearCache&content-type=text/xml

Response




Delete

You use this mode to delete a transaction entry from the Transaction Manager database. The

response provides information if the operation was successful or not.

This mode requires additional permission, in order to be able to delete an entry the user must

have XMII_Transaction_Delete or XMII_Transaction_all actions assigned to his profile.

Request parameters


ID No The id of the transaction that should be deleted from the

Transaction Manager.

Force Yes You can use this parameter to indicate that the entry can be

deleted even if the transaction is in a running state. The

parameter value in this case should be “True”.

The default value is “False”, which means that the transaction

can be deleted only if its status is Succeeded, Failed,

Terminated or Pending.

Response


Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=Delete&id=139&content-type=text/xml

Response




Details

You use this mode to view the details of a transaction entry stored in the Transaction Manager

database.



© 2012 SAP AG 25

Request parameters


ID No The transaction id

Response

The following information is returned in a rowset:

Name Description

NAME The transaction name

SERVER The server where the transaction was ran

STATUS The transaction status

RUNTIME The transaction mode – synchronous or asynchronous

RUNNING_USER The user who ran the transaction

START_TIME The time when the transaction began its execution

END_TIME The time when the transaction ended its execution

DURATION The duration of transaction execution

LOG The transaction traces

Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=Details&id=138&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="NAME" MaxRange="1" MinRange="0" Name="NAME" SQLDataType="12" SourceColumn="NAME" /> <Column Description="SERVER" MaxRange="1" MinRange="0" Name="SERVER" SQLDataType="12" SourceColumn="SERVER" /> <Column Description="STATUS" MaxRange="1" MinRange="0" Name="STATUS" SQLDataType="12" SourceColumn="STATUS" /> <Column Description="RUNTIME" MaxRange="1" MinRange="0" Name="RUNTIME" SQLDataType="12"

SourceColumn="RUNTIME" /> <Column Description="RUNNING_USER" MaxRange="1" MinRange="0" Name="RUNNING_USER" SQLDataType="12" SourceColumn="RUNNING_USER" /> <Column Description="STARTTIME" MaxRange="1" MinRange="0" Name="STARTTIME" SQLDataType="93" SourceColumn="STARTTIME" /> <Column Description="ENDTIME" MaxRange="1" MinRange="0" Name="ENDTIME" SQLDataType="93" SourceColumn="ENDTIME" /> <Column Description="DURATION" MaxRange="1" MinRange="0" Name="DURATION" SQLDataType="-5" SourceColumn="DURATION" /> <Column Description="EXPIRATION" MaxRange="1" MinRange="0" Name="EXPIRATION" SQLDataType="93" SourceColumn="EXPIRATION" /> <Column Description="LOG" MaxRange="1" MinRange="0" Name="LOG" SQLDataType="12" SourceColumn="LOG" />

</Columns> <Row>

<NAME>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</NAME> <SERVER>PHLD00473530A_NKG_02</SERVER> <STATUS>Succeeded</STATUS> <RUNTIME>Sync</RUNTIME> <RUNNING_USER>SYSTEM</RUNNING_USER> <STARTTIME>2011-09-21T13:15:55</STARTTIME> <ENDTIME>2011-09-21T13:15:56</ENDTIME> <DURATION>1260</DURATION> <EXPIRATION>2011-09-21T21:15:56</EXPIRATION> <LOG><?xml version="1.0" encoding="UTF-8" ?><Rowsets DateCreated="2011-09-21T13:15:56" EndDate="2011-09-21T13:15:56" StartDate="2011-09-21T13:15:56"



© 2012 SAP AG 26

Version="12.1.9 Build(112)" TransactionID="138"><Messages></Messages></Rowsets></LOG>

</Row> </Rowset>

</Rowsets>

FixHighExpiringTransactions

You use this mode to check for high expiring transactions. Transactions that are found with

high expiring values will be corrected as well the expiration value for any transaction that calls

that transaction. It does not have any additional parameters and response provides

information if the operation was successful or not.

This mode requires additional permission; the user must have XMII_Transaction_Delete or

XMII_Transaction_all actions assigned to his profile.

It is available in SP08 and newer. See note 1517887 for additional details.

Request parameters

This mode does not require any additional paramters.

Response


Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=FixHighExpiringTransactions&content-type=text/xml

Response




List

You use this mode to see a list of pending and processed transactions stored in the Transaction

Manager database. This mode accepts a number of parameters that you can provide in order

to restrict the returned set. The response will contain only these entries that match the

provided parameters.

Request paramaters


Name Yes The transaction name. If you provide a transaction name the

result set will contain only the records for the requested

transaction.

UserName Yes The name of the user who ran the transaction

Status Yes The status of the transaction. The values that are accepted are

numbers and they are:

-2 for Invalid status

-1 for Pending status

0 for Running status

1 for Break status



© 2012 SAP AG 27

2 for Succeeded status

3 for Failed status

4 for Terminated status

StartDate Yes The start date. Transactions ran before that date will not be

included in the result set. The format is MM/dd/yyyy

HH:mm:ss.


provided, is EndDate - Duration

EndDate Yes The end date. Transactions ran after that date will not be

included in the result set. The format is MM/dd/yyyy

HH:mm:ss. The default value is:



Duration Yes The duration of the time frame in minutes. The default duration

is 60 minutes.

Response

Тhe following information is returned for every transaction that matches the provided criteria:

Name Description

ID The identifier assigned by the system for the transaction

NAME The transaction name

SERVER The server where the transaction was ran

STATUS The transaction status

RUNTIME The transaction mode – synchronous or asynchronous

RUNNING_USED The user who ran the transaction

STARTTIME The time when the transaction began its execution

ENDTIME The time when the transaction ended its execution

DURATION The duration of transaction execution

EXPIRATION The time when the transaction entry will expire and will be

removed from the transaction manager

Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=List&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="ID" MaxRange="1" MinRange="0" Name="ID" SQLDataType="4" SourceColumn="ID" /> <Column Description="NAME" MaxRange="1" MinRange="0" Name="NAME" SQLDataType="12" SourceColumn="NAME" /> <Column Description="SERVER" MaxRange="1" MinRange="0" Name="SERVER" SQLDataType="12" SourceColumn="SERVER" /> <Column Description="STATUS" MaxRange="1" MinRange="0" Name="STATUS" SQLDataType="12" SourceColumn="STATUS" /> <Column Description="RUNTIME" MaxRange="1" MinRange="0" Name="RUNTIME" SQLDataType="12" SourceColumn="RUNTIME" />



© 2012 SAP AG 28

<Column Description="RUNNING_USER" MaxRange="1" MinRange="0" Name="RUNNING_USER" SQLDataType="12" SourceColumn="RUNNING_USER" /> <Column Description="STARTTIME" MaxRange="1" MinRange="0" Name="STARTTIME" SQLDataType="93" SourceColumn="STARTTIME" /> <Column Description="ENDTIME" MaxRange="1" MinRange="0" Name="ENDTIME" SQLDataType="93" SourceColumn="ENDTIME" /> <Column Description="DURATION" MaxRange="1" MinRange="0" Name="DURATION" SQLDataType="-

5" SourceColumn="DURATION" /> <Column Description="EXPIRATION" MaxRange="1" MinRange="0" Name="EXPIRATION" SQLDataType="93" SourceColumn="EXPIRATION" />

</Columns> <Row>

<ID>86805</ID> <NAME>MyProject/TracerOutputTesting/TracerOutputTest.trx</NAME> <SERVER>PHLN00485290B_LKG_00</SERVER> <STATUS>Succeeded</STATUS> <RUNTIME>Sync</RUNTIME> <RUNNING_USER>SYSTEM</RUNNING_USER> <STARTTIME>2011-08-05T11:23:01</STARTTIME> <ENDTIME>2011-08-05T11:23:01</ENDTIME> <DURATION>0</DURATION> <EXPIRATION>2011-08-05T19:23:01</EXPIRATION>

</Row> <Row>

<ID>86804</ID> <NAME>MyProject/TracerOutputTesting/TracerOutputTest.trx</NAME> <SERVER>PHLN00485290B_LKG_00</SERVER> <STATUS>Succeeded</STATUS> <RUNTIME>Sync</RUNTIME> <RUNNING_USER>SYSTEM</RUNNING_USER> <STARTTIME>2011-08-05T11:22:00</STARTTIME> <ENDTIME>2011-08-05T11:22:00</ENDTIME> <DURATION>1</DURATION> <EXPIRATION>2011-08-05T19:22:00</EXPIRATION>

</Row> </Rowset>

</Rowsets>

ModeList

You use that mode to view a list of all service modes that BLSManager service provides. It

does not have any additional parameters.

Reuquest parameters

This mode does not require any additional parameters.

Response

Returns a rowset with the supported modes:

Name Description


Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=ModeList&content-type=text/xml

Response


<Rowset> <Columns>



© 2012 SAP AG 29


</Columns> <Row>

<ModeName>ClearCache</ModeName> </Row> ……

<Row> <ModeName>ViewOutput</ModeName>

</Row> </Rowset>

</Rowsets>

Stats

You use this mode to view performance statistic for a transaction. Performance statistics are

introduced with SP06. Transaction statistics can be generated by running transactions from

the runner servlet. Passing the parameter LogStatisticsToDB=true will force the log level to

DEBUG and the persistence of the transaction and all sub transactions to ALWAYS. This

allows MII BLS to track the runtime of links and actions and persist them to the database. This

information is tied to the data in the transaction manager table. When the entry is deleted

from the transaction manager the performance information is also deleted.

To run a transaction with statistics enabled: http://<server>:<port>/XMII/Runner?Transaction=<myproject/transname>&LogStatisticsToDB=true

Request parameters



Response

The following information will be returned for all the actions and links which were run in the

root transaction and in all sub-transactions.

Name Description

ID The transaction ID

TransactionName The transaction name

RootID The root transaction ID

ParentID The parent transaction ID

ActionName The action name

Destination Link destination (for links only)

Average Average execution time in milliseconds

Minimum Minimum execution time in milliseconds

Maximum Maximum execution time in milliseconds

Total Total execution time in milliseconds

Count Number of times it was run

Please note that the data is per transaction. So if a transaction was called multiple times the

values will be calculated for each run and not accumulated. Also there are no values recorded

for control actions since they are considered negligible. Another item of interest would be that

for actions like the transaction call action, their execution time is the total time to run the sub

transaction.

Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=stats&id=143&content-type=text/xml



© 2012 SAP AG 30

Response


<Rowset> <Columns>

<Column Description="ID" MaxRange="1" MinRange="0" Name="ID" SQLDataType="-5" SourceColumn="ID" /> <Column Description="TransactionName" MaxRange="1" MinRange="0" Name="TransactionName" SQLDataType="12" SourceColumn="TransactionName" /> <Column Description="RootID" MaxRange="1" MinRange="0" Name="RootID" SQLDataType="-5" SourceColumn="RootID" /> <Column Description="ParentID" MaxRange="1" MinRange="0" Name="ParentID" SQLDataType="-5" SourceColumn="ParentID" /> <Column Description="ActionName" MaxRange="1" MinRange="0" Name="ActionName" SQLDataType="12" SourceColumn="ActionName" />

<Column Description="Destination" MaxRange="1" MinRange="0" Name="Destination" SQLDataType="12" SourceColumn="Destination" /> <Column Description="Average" MaxRange="1" MinRange="0" Name="Average" SQLDataType="8" SourceColumn="Average" /> <Column Description="Minimum" MaxRange="1" MinRange="0" Name="Minimum" SQLDataType="8" SourceColumn="Minimum" /> <Column Description="Maximum" MaxRange="1" MinRange="0" Name="Maximum" SQLDataType="8" SourceColumn="Maximum" /> <Column Description="Total" MaxRange="1" MinRange="0" Name="Total" SQLDataType="8" SourceColumn="Total" /> <Column Description="Count" MaxRange="1" MinRange="0" Name="Count" SQLDataType="-5" SourceColumn="Count" />

</Columns> <Row>

<ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>SAP_JRA_Function_Availability</ActionName> <Destination>---</Destination> <Average>605</Average> <Minimum>605</Minimum> <Maximum>605</Maximum> <Total>605</Total> <Count>1</Count>

</Row> <Row>

<ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>SAP_JRA_Function_CheckExists</ActionName> <Destination>---</Destination> <Average>515</Average> <Minimum>515</Minimum> <Maximum>515</Maximum> <Total>515</Total> <Count>1</Count>

</Row> <Row>

<ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>SAP_JRA_End_Session_0</ActionName>

<Destination>---</Destination> <Average>106</Average> <Minimum>106</Minimum> <Maximum>106</Maximum> <Total>106</Total> <Count>1</Count>

</Row>



© 2012 SAP AG 31

<Row> <ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>SAP_JRA_Function_Availability</ActionName> <Destination>SAP_JRA_Function_Availability.Request{/BAPI_MATERIAL_AVAILABILITY/INPUT/

MATERIAL}</Destination> <Average>2</Average> <Minimum>2</Minimum> <Maximum>2</Maximum> <Total>8</Total> <Count>4</Count>

</Row> <Row>

<ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>Conditional_1</ActionName> <Destination>Conditional_1.Input1</Destination> <Average>2</Average> <Minimum>2</Minimum> <Maximum>2</Maximum> <Total>2</Total> <Count>1</Count>

</Row> <Row>

<ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>Conditional_0</ActionName> <Destination>Conditional_0.Input1</Destination> <Average>2</Average> <Minimum>2</Minimum> <Maximum>2</Maximum> <Total>2</Total> <Count>1</Count>

</Row> <Row>

<ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>SAP_JRA_Function_CheckExists</ActionName> <Destination>SAP_JRA_Function_CheckExists.Request{/BAPI_MATERIAL_EXISTENCECHECK/INPUT/MATERIAL}</Destination> <Average>2</Average> <Minimum>2</Minimum> <Maximum>2</Maximum> <Total>2</Total>

<Count>1</Count> </Row> <Row>

<ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>Tracer_MATERIAL_AVAILABILITY</ActionName> <Destination>---</Destination> <Average>0</Average> <Minimum>0</Minimum> <Maximum>0</Maximum> <Total>0</Total> <Count>1</Count>

</Row> <Row>



© 2012 SAP AG 32

<ID>143</ID> <TransactionName>ERPIntegration/JRA/MaterialAvailabilityJRASession.trx</TransactionName> <RootID>143</RootID> <ParentID>143</ParentID> <ActionName>SAP_JRA_Start_Session_0</ActionName> <Destination>---</Destination> <Average>0</Average>

<Minimum>0</Minimum> <Maximum>0</Maximum> <Total>0</Total> <Count>1</Count>

</Row> </Rowset>

</Rowsets>

Terminate

You use this mode to terminate a transaction. The response provides information if the

operation was successful or not.

This mode requires additional permission; the user must have XMII_Transaction_Delete or

XMII_Transaction_all actions assigned to his profile

Request parameters



Reason Yes The reason for the transaction termination

Response


Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=terminate&id=142&content-type=text/xml

Response


<Messages>

<Message>Successful</Message> </Messages>

</Rowsets>

ViewCache

You use this mode to view the content of the transaction cache.

Response

This service returns a list of all the transaction that is in the transaction cache. The information

provided for every one of these entries is:

Name Description

Name The name of the transaction

LastRunTime The last time when it was run

Expiration The time until the entry will remains in the transaction cache

Runs How many times the transaction was run



© 2012 SAP AG 33

Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=ViewCache&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="Name" MaxRange="1" MinRange="0" Name="Name" SQLDataType="12" SourceColumn="Name" /> <Column Description="LastRunTime" MaxRange="1" MinRange="0" Name="LastRunTime" SQLDataType="93" SourceColumn="LastRunTime" /> <Column Description="Expiration" MaxRange="1" MinRange="0" Name="Expiration" SQLDataType="93" SourceColumn="Expiration" /> <Column Description="Runs" MaxRange="1" MinRange="0" Name="Runs" SQLDataType="4" SourceColumn="Runs" />

</Columns> <Row>

<Name>MyProject/TracerOutputTesting/TracerOutputTest.trx</Name> <LastRunTime>2011-08-05T11:09:01</LastRunTime> <Expiration>2011-08-05T13:09:01</Expiration> <Runs>14</Runs>

</Row> </Rowset>

</Rowsets>

ViewLog

You use this mode to view the log of a transaction stored in the Transaction Manager.

Request parameters


ID No The transaction ID

Response

The result contains all log entries that were created during the execution of the transaction.

Name Description

Message A log entry

Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=viewlog&id=164&content-type=text/xml

Response


<Rowset> <Columns>

<Column Description="Message" MaxRange="1" MinRange="0" Name="Message" SQLDataType="12" SourceColumn="Message" />

</Columns> <Row>

<Message>[INFO] [Tracer_MATERIAL_AVAILABILITY]448.000</Message> </Row>



© 2012 SAP AG 34

<Row> <Message>[INFO] Statistics [Load = 0 ms msec, Parse = 1 ms, Execution = 1212 ms, Total = 1228 ms]</Message>

</Row> </Rowset>

</Rowsets>

ViewOutput

You use this mode to view the output of a transaction stored in the Transaction Manager. If

you want the output of the transaction to be stored you have to run it with request parameter

StoreTransactionOutput set to true. If you have executed the transaction with request

parameter OutputParameter set to the list of output parameter, the output parameter will be

shown in the output too.

Request parameters


ID No The transaction ID

Response

The response contains the transaction output. A rowset with the following information is

returned:

Name Description

Message A single line of the transaction output

Example

Request

http://localhost:50000/XMII/Illuminator?service=BLSManager&mode=viewoutput&id=164&con

tent-type=text/xml

Response

<?xml version="1.0" encoding="UTF-8" ?> <Rowsets DateCreated="2011-09-21T16:33:25" EndDate="2011-09-21T16:33:25" StartDate="2011-09-21T16:33:25" Version="12.1.9 Build(112)" TransactionID="164">

<Messages> <Message level="INFO">[INFO] [Tracer_MATERIAL_AVAILABILITY]448.000</Message> <Message level="INFO">[INFO] Statistics [Load = 0 ms msec, Parse = 1 ms, Execution = 1212 ms, Total = 1228 ms]</Message>

</Messages>

</Rowsets>



© 2012 SAP AG 35

Copyright

© Copyright 2012 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice.

Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.

Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.

IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.

Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.

Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries.

Oracle is a registered trademark of Oracle Corporation.

UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.

Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc.

HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.

Java is a registered trademark of Oracle Corporation.

JavaScript is a registered trademark of Oracle Corporation, used under license for technology invented and implemented by Netscape.

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries.

Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects S.A. in the United States and in other countries. Business Objects is an SAP company.

All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

Documents

SAP MII 12.1/12.2 Service Interface - Monitoring