Start of Content Area

Background documentation Properties for Service XPI Adapter: XI  Locate the document in its SAP Library structure

 

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 iif 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.xmlvalidation.schemafolder

Root of the XML Schema folder

Type: STRING

xiadapter.xmlvalidation.maxvalueofmaxoccurs

Max Value for maxOccurs

Default: 500

Type: LONG

xiadapter.xmlvalidation.maxvalueofminoccurs

Max Value for minOccurs

Default: 500

Type: LONG

 

 

End of Content Area