Show TOC

Properties for Service XPI Adapter: XILocate this document in the navigation structure

Use

To display the following properties, choose Start of the navigation path  SAP NetWeaver Administrator  Next navigation step Configuration Next navigation step Infrastructure Next navigation step Java System Properties End of the navigation path.

Choose the Services tab and filter for XPI Adapter: XI.

All the properties have the attribute onlinemodifialble: true.

Table 1: XI Protocol Specific Configuration
Name Description

xiadapter.adapterTypeNamespace

XI Adapter Namespace

Default: http://sap.com/xi/XI/System

Type: STRING

The adapter Type namespace typically has the form of a URL.

It is used to retrieve the XI adapter metadata from the CPA Cache service.

This property must not be changed.

xiadapter.inbound.numberRetries.default

Inbound Retries

Default: 3

Type: LONG

Only relevant for asynchronous messages. numberRetries defines how often an asynchronous message with quality of service Exactly Once (In Order) should be resent if there is a delivery error.

xiadapter.inbound.retryInterval.default

Inbound Retry Interval

Default: 300000 ms (5 minutes)

Type: LONG

retryInterval defines how many milliseconds the messaging system should wait before the next retry.

xiadapter.inbound.persistDuration.default

Inbound Persist Duration

Default: 86400000 ms (1 day)

Type: LONG

persistDuration specifies in milliseconds how long the message should be kept in the message database of the messaging system. With PI 7.1 and higher the default value was reduced to 1 day to minimize the number of messages stored on the database. If the persist duration is not sufficient for operational tasks it can be increased. Note that changing this  parameter will only take effect for messages sent after the change.

xiadapter.inbound.timeout.default

Inbound Synchronous Timeout

Default: 180000 ms

Type: LONG

Timeout is only relevant for synchronous messages. It defines how long the XI adapter waits for the synchronous response message before returning a MessageExpired exception.

xiadapter.outbound.numberRetries.default

Outbound Retries

Default: 3

Type: LONG

This, and the next two properties described below, control the guaranteed delivery of XI messages between the Integration Server and the Adapter Engine.

It is only relevant for asynchronous messages.

This property defines how often an asynchronous message with quality of service Exactly Once (In Order) should be resent if a delivery error.

xiadapter.outbound.retryInterval.default

Outbound Retry Interval

Default: 300000 ms (5 minutes)

Type: LONG

The property defines how long the messaging system waits between each retry.

xiadapter.outbound.persistDuration.default

Outbound Persist Duration

Default: 86400000 ms (1 day)

Type: LONG

The property specifies how long a message should be persisted in the message database of the messaging system.

With PI 7.1 and higher the default value was reduced to 1 day to minimize the number of messages stored on the database. If the persist duration is not sufficient for operational tasks it can be increased. Note that changing this parameter will only take effect for messages being send after the change.

As part of the Adapter Engine the XI adapter gets the required connection information for sending XI messages to the Integration Server (IS) from the Landscape System Directory (SLD) and the exchange profile (EP).

If the SLDAccess property of the XPI service CPA Cache is set to false, the connection information of the Integration Server can be explicitly set with the properties listed in the following table.

These properties must not be changed.

Table 2: Integration Server Default Properties
Name Description

xiadapter.isconfig.url

Integration Server URL

Default: http://localhost:50080/sap/xi/engine?Type=entry

Type: STRING

xiadapter.isconfig.username

Integration Server Service User Name

Default: <PIAF Adapter Framework Service User>

Type: STRING

xiadapter.isconfig.password

Integration Server Service User Password

Default: Password

secure: true

xiadapter.isconfig.sapClient

Integration Server Client

Default: 100

Type: LONG

xiadapter.isconfig.sapLanguage

Integration Server Logon Language

Default: de

Type: STRING

xiadapter.isconfig.sapSysId

Integration Server SAP System Id

Default: XYZ

Type: STRING

Table 3: Various Properties
Name Description

xiadapter.sld.polling.timeout.default

SLD Polling Timeout

Default: 3600000 ms

Type: STRING

xiadapter.MMFSplit.disableCaching

Disable Multi-Message Format Split Caching

Default: false

Type: BOOLEAN

xiadapter.internal

SAP-internal Settings

Type: STRING

xiadapter.version.minor

minor version

Default: 1

Type: STRING

xiadapter.senderAgreementCheck

Sender Agreement Check

Default: true

Type: BOOLEAN

Determines whether processed messages are checked for the existence of a corresponding sender agreement.

xiadapter.inboundUserCheckName

Inbound user check name

Type: STRING

This property can be used to overwrite the name that is checked against on the inbound side, in case of non-PP.

This user is usually the technical IS service user, and if SLDAccess is active in the CPACache service, the user name is automatically retrieved from the Exchange Profile. Therefore, it only makes only sense to change this property if SLDAccess is false and the non-PP inbound user name check should be performed.

xiadapter.routing

Routing properties

Comma-separated properties for routing settings

Type: STRING

xiadapter.mapping

Mapping properties

Comma-separated properties for mapping settings

Type: STRING

xiadapter.stage.conf

Storage Stage Setting

Default: MS=3

This property defines the persistence mode for the XI protocol handler.

Its value is given as a comma-separated list of persistence mode configurations at specific stages.

Stages:

  • BI - Before inbound processing
  • VI - After inbound schema validation
  • MS - Between receiver determination and mapping step
  • AM - Between mapping and schema validation
  • VO - After outbound schema validation

Modes:

  • 1 - Store on error
  • 2 - Store and continue
  • 3 - Store and return (to queue)

Example:

  • BI=1
  • MS=3

Type: STRING

 

xiadapter.xmlvalidation.schemafolder

Root of the XML Schema folder

Type: STRING

xiadapter.xmlvalidation.maxvalueofmaxoccurs

Max Value for maxOccurs

Default: 500

Type: STRING

 

xiadapter.xmlvalidation.maxvalueofminoccurs

Max Value for minOccurs

Default: 500

Type: STRING

xiadapter.logger.conf

Logging Stage Setting

This property defines the logging mode for the XI protocol handler.

Its value is given as a comma-separated list of logging mode configurations at specific stages.

Stages:

  • BI - Before inbound processing
  • MS - Between receiver determination and mapping step
  • AM - Between mapping and schema validation

Modes:

  • 2 - Synchronous messages are logged
  • 6 - Only synchronous error messages are logged
  • 10 - As mode 2, with the business content hidden
  • 14 - As mode 6, with the business content hidden

Example:

  • BI=6
  • AM=2

Type: STRING

The attributes in the following table define the global virus scan configuration.

Table 4: Virus Scan Settings
Name Description

xiadapter.virusscan.active

Active

Default: 0

Values:

  • 0 - inactive (default)
  • 1 - active

Type: STRING

The "active" property can be overwritten on a scenario basis.

xiadapter.virusscan.profile

Profile

Default: pi_Messaging

Values: The Name of the VirusScan Profile.

Type: STRING

xiadapter.virusscan.mode

Mode

Default: 1

Values:

  • 1 - Attachments (default)
  • 2 - Attachments + main payload

Type: STRING