Configuring Message Logging (Within AAE Pipeline)

Procedure

Configuring Message Logging at Specific Processing Steps

You configure this kind of message logging in SAP NetWeaver Administrator.

  1. Start SAP NetWeaver Administrator from the following page: http://<host>:<port>.

  2. Choose SAP NetWeaver Adminstrator.

  3. Choose (tab) Start of the navigation pathConfiguration Next navigation step Infrastructure Next navigation step Java System PropertiesEnd of the navigation path.

  4. To specify message logging, in tab Services search for XPI Adapter: XI.

    This is the service for pipeline processing of the XI message protocol.

  5. On the Properties tab (under Extended Details ) search for xiadapter.logger.conf.

  6. To specify message logging behavior, choose Modify, and in field Enter Custom Values enter the corresponding value according to the following syntax:

    <processing step> = <condition>

    You can separate multiple expressions like that by commas.

As processing step, you can specify one of the following steps (indicated by a two character string as shown in the table) within the pipeline processing for asynchronous and synchronous request messages (Message Type Send or Call; Message Class ApplicationMessage):

Processing Step

Description

Message preparation

(parameter BI)

After sender adapter processing, the message is handed over to the messaging system and prepared for further processing.

Receiver determination

(parameter MS)

The receivers of the messages are evaluated based on the configuration settings in the corresponding integrated configuration in Integration Directory.

Mapping

(parameter AM)

The mapping is performed based on the configuration settings in the corresponding integrated configuration in Integration Directory.

The message is logged after the specified step.

For synchronous response messages (Message Type Rtrn; Message Class ApplicationResponse or ApplicationError), the mapping is executed before the message is handed over to the messaging system (before the Message preparation step) and Receiver determination is skipped as the receiver is already known – the sender of the synchronous request message. To be able to store the message before and after the mapping step, in case the logging is configured for AM step, the response message will be logged just before the mapping (as it comes from the synchronous receiver). Below are the possible steps for synchronous response messages:

Processing Step

Description

Mapping

(parameter AM)

The mapping is performed based on the configuration settings in the corresponding integrated configuration in Integration Directory. (message is logged before this step)

Message preparation

(parameter BI)

The message is prepared and handed over to the messaging system for further processing.

Processing Steps for Synchronous Messages
Processing Steps for Asynchronous Messages

To specify the logging condition, you use integer values. The following table lists the possible digits:

Digit

Condition

1

Asynchronous messages are logged.

2

Synchronous messages are logged.

3

Synchronous and asynchronous messages are logged.

5

Only asynchronous error messages are logged.

6

Only synchronous error messages are logged.

7

Synchronous and asynchronous error messages are logged.

9

As setting 1, with the business content (payload) hidden.

10

As setting 2, with the business content (payload) hidden.

11

As setting 3, with the business content (payload) hidden.

13

As setting 5, with the business content (payload) hidden.

14

As setting 6, with the business content (payload) hidden.

15

As setting 7, with the business content (payload) hidden.

As default, no value is assigned, which means that messages are not logged.

Configuring Message Logging in Case of Errors

Setting 6 ( Only synchronous error messages are logged ) for property xiadapter.logger.conf only covers behavior after steps BI, MS and AM.

To activate logging in case of errors in any case, you can do the following:

  1. Start SAP NetWeaver Administrator from the following page: http://<host>:<port>.

  2. Choose SAP NetWeaver Adminstrator .

  3. Choose (tab) Start of the navigation pathConfiguration Next navigation step Infrastructure Next navigation step Java System PropertiesEnd of the navigation path.

  4. In tab Services search for XPI Service: Messaging System.

  5. On the Properties tab (under Extended Details ) search for messaging.system.statusLoggerConf.

  6. To specify message logging behavior, choose Modify , and in field Enter Custom Values enter the corresponding value according to the following syntax:

    <log state>, <content handling>

    As log state , you can specify one of the following values:

    Value

    Description

    Error

    Log message in case of errors.

    None

    No logging of messages

    To specify the handling of business content, you use one of the following values:

    Value

    Description

    Full

    If logging is enabled, log message with business content.

    Headers

    If logging is enabled, log message without business content.

    As default, the value Error , Full is assigned, which means that messages are logged including business content in case of errors.

    The location SC is used for the logged message version. This log message is also visible in PI overview monitoring.