SAP Adapter Properties
The SAP adapter properties form is comprised of common properties and properties specific to the adapter.
Common properties are located at the top of the form. These fields define the attributes associated with the entry. See Common Properties and Actions for information about properties not listed here, as well as instructions on using the form and importing and exporting entries.
In addition to common properties, the following properties are available to configure the SAP adapter:
Adapter Home
adapterHome
The directory containing the adapter /conf directory. This property is required if the adapter is run in process.
Character Locale
charTypeLocale
The operating system locale used to interpret the encoding of data being sent to and from SAP. This property is optional. The default value is the C locale.
This property is related to the encoding property. The encoding property specifies the Java identifier for the encoding; the charTypeLocale specifies the operating system locale for the same type of encoding.
Client
client
The client number to be used when connecting to SAP. This property is required.
Classification Prefix
classificationPrefix
A parameter name prefix that implies any parameter beginning with this prefix is a classification characteristic. This property is optional.
Database Host
dbHost
The name of the machine on which the SAP library is running. This property is required. The default value is localhost.
Database Port
dbPort
The port number to which the SAP library is listening. This property is required.
Document Number
documentNumber
The SAP field name for a document number. Used by Update-Document-Info-Record, Add-Document-Link, and Delete-Document-Link. This property is optional. The default value is DOC_NUMBER.
Document Part
documentPart
The SAP field name for a document part. Used by Update-Document-Info-Record, Add-Document-Link, and Delete-Document-Link. This property is optional. The default value is DOC_PART.
Document Type
documentType
The SAP field name for document type. Used by Update-Document-Info-Record, Add-Document-Link, and Delete-Document-Link. This property is optional. The default value is DOC_TYPE.
Document Version
documentVersion
The SAP field name for the document version. Used by Update-Document-Info-Record, Add-Document-Link, and Delete-Document-Link. This property is optional. The default value is DOC_VERS.
Encoding
encoding
The character encoding applied to data sent to SAP. This property is optional. The default value is ISO8859_1.
This property is related to the charTypeLocale property. Refer to the example under charTypeLocale for more information.
Language
language
The language code to be used when connecting to SAP. This property is required.
Log File
logFile
The name of a file to contain various output messages. This property is required.
Message Locale
messageLocale
The operating system locale that to use in localizing text messages. This property is optional. The default value for Java and C messages is the JVM default locale. For example, enUS.ISO8859-1.
Maximum Number of Connections in Pool
maxNoOfConnectionsInPool
The maximum connections allowed in the pool. If the pool is exhausted, the connection request waits for the time specified in the Maximum Wait Time property for the release of at least one connection. If no connection is released during this waiting period, an exception is thrown.
This property is optional. A value of 5 is used if the property is not specified.
 |
This field accepts an integer value that falls between the range of 1 through 100. However, this range is configurable by editing the property form.
|
Maximum Threads
socketAccess.maxThreadCount
The maximum number of concurrent request threads allowed against each adapter instance. The value is a positive integer. Setting this value to an integer greater than 100 allows more concurrent connections, but also requires more resources (memory and CPU cycles).
Maximum Wait Time
maxWaitTime
Specifies the maximum time (in seconds) to wait in a connection request for a free connection when the specified pool is exhausted. This property is optional.
|
|
This field accepts an integer value that falls between the range of 1 through 60. However, this range is configurable by editing the property form.
|
Password
password
The password to be used when connecting to SAP. This property is required.
SAP R/3 Host
r3Host
Specifies the hostname to be used when connecting to SAP. This property is only used by the Execute-RPC webject. This property is required.
|
|
HPUX might require IP addresses instead of host names for this property.
|
Run SAP Library
runSaplib
Specifies whether or not the SAP library is automatically invoked by the SAP adapter. This property is optional. The default value is TRUE.
SAP Library Connection Attempts
saplibConnectAttempts
The maximum number of times SAP adapter attempts to connect with the SAP library. The interval between attempts is 2 seconds. This property is optional. The default value is 30.
System Number
systemNumber
The system number to be used when connecting to SAP. This property is required.
User
user
The user name to be used when connecting to SAP. This property is required.
Verbose
verbose
Controls the amount of log output. Set this property to true to increase the output volume. This property is optional.
The default for this property is false.
Dynamic Properties Configuration
Configuration information for a service or adapter can be updated while the service or adapter is running, allowing you to update properties without requiring a restart.
The Time To Live property specifies the time that elapses, in minutes, before the properties for a service or adapter are automatically reloaded. Properties are only automatically reloaded if they are being accessed. By default, the properties do not expire.
Additional Properties
If a property is not defined on the form, you can add it in the Additional Properties field. When adding additional properties, the property name format includes the name of the adapter entry (the service name) followed by the property name. For example:
<service_name>.dbuser
In the appropriate fields, specify the property used by the service or adapter and the value of that property. Click Add next to the new property name to open a text box in which you can modify the property value.
If the value becomes too long to view in its entirety, an Edit action appears. Click Edit to open a new browser window with a larger text area.