Start of Content Area

Procedure documentation Displaying XML Messages  Locate the document in its SAP Library structure

Use

You display XML messages to track inbound and outbound messages in the IDoc adapter. This gives you an overview of which messages were sent or received by the adapter. IDoc tracking (advanced functions) enables you to track IDocs and display them in the remote system.

Prerequisites

      You have called the transaction IDoc Adapter – Monitoring (IDX5). The system navigates to the screen XML Messages in IDoc/RFC Adapter.

      For IDoc tracking you need authorizations in the systems in which you are tracking the IDocs:

       To start the XI message monitor in the remote system

S_XMB_MONI with ACTVT = 03

       To start the IDoc monitor in the remote system

S_IDOCMONI with ACTVT = 03

       Authorization for function groups:

       BDMON

       BDMT

       IDOC_TRACING

       SXMB_MONI

Procedure

On the XML Messages in IDoc/RFC Adapter screen, you can select and list XML messages using various selection criteria. To do this, proceed as follows:

       1.      Select XML messages by specifying a creation date and creation time for the messages, or enter a specific message ID or transaction ID to determine a specific message to be selected. The transaction ID is the ID of the transaction in the IDoc adapter.

Note

The transaction ID is only unique for each sender or receiver.

       2.      You can specify additional selection criteria in the IDoc group box.

The following selection criteria are available:

Selection Criterion

Entry

System ID

Name of port in IDoc adapter

IDoc number

Number of the IDoc from the IDoc control record

IDoc Object

Name of a customer enhancement or IDoc basic type

Direction

Direction of IDoc transfer

Choose Execute.

The system sorts and lists the XML messages according to the time that they were created. Messages that were received and sent as IDocs are listed together and are identified by the same message ID.

The system also uses the list of messages to summarize the number of messages displayed for each direction. In addition to the specified selection criteria, the system also displays the client.

       3.      To display a summary of the information for each XML message, select the corresponding message in the list and choose (This graphic is explained in the accompanying text) Details.

       4.      If you want to navigate to the monitoring of the Integration Engine, select one of the listed messages by double clicking its message ID.

The Integration Engine monitoring displays additional information about the selected message. You can do the following:

       Display the content of the message

Compare existing versions with each other

       Reschedule messages with errors

       Display the children of a message that are the result of branching

       5.      If you want to navigate to the tRFC queue (transaction SM58), select one of the listed messages by double clicking its transaction ID.

This is only useful when the message direction is outbound.

       6.      If you want to display IDoc packages, select a message and choose This graphic is explained in the accompanying text Display IDoc Package.

Performing IDoc Tracking

       7.      To track IDocs, choose This graphic is explained in the accompanying textAdvanced Functions.

Fields for the IDoc number, status, and XI Message ID are added to the list.

       8.      To track where an IDoc is located or where it came from, select a line and choose IDoc Tracking.

       9.      To display an IDoc in the remote system, select the line and choose Monitor.

The message line shows which monitor is displayed.

Outbound:

       If the IDoc number and status are set, the IDoc has been sent to an SAP system.

You can display the IDoc remotely in the IDoc monitor of the SAP system.

See: IDoc Display

       If the XI message ID is set, the IDoc has been sent to an Integration Server.

You can display the message remotely in the monitor for processed XML messages.

See: Monitor for Processed XML Messages

       If none of the additional fields are set, you have the following options:

       The IDoc is in one of the qRFC outbound queues.

You can display the qRFC outbound queues.

       The IDoc is in a queue of the transactional RFC.

You can display the queue.

       It was not possible to connect to the system.

Inbound:

Tracking searches for the RFC destination for the sender system for each port. If none is found, the partner number and partner type specified in port maintenance are used. This information is used to call the IDoc monitor remotely.

See Maintaining Port.

   10.      You can display and edit the conversion of the XI message status in connection with the acknowledgment status to the IDoc status in table IDX_TRXSTATUS.

 

End of Content Area