Managed connection factory properties are used by the adapter at run time to create an outbound connection instance with the SAP server.
You set the managed connection factory properties using either the Adapter Connection wizard or the administrative console (after deployment).
Descriptive name | Property name | Purpose |
---|---|---|
ABAP debug property | ABAPDebug | This property specifies whether the adapter invokes the ABAP Debugger for the appropriate function module when the adapter begins processing a business object. |
Application server host property | ApplicationServerHost | When the adapter is configured to run without load balancing, this property specifies the IP address or the name of the application server that the adapter logs on to. |
Client property | Client | This property is the client number of the SAP system to which the adapter makes a connection. |
Code page number property | codepage | This value must correspond to the value specified in the Language property. |
Gateway host property | GatewayHost | This property is the name of the SAP system that will be used as the gateway for the resource adapter. |
Gateway service property | GatewayService | This property is the identifier of the gateway on the gateway host that carries out the RFC services. |
Language property | Language | This property is the language in which the adapter logs on. |
Message server host property | MessageServerHost | When the adapter is configured for load balancing, this property specifies the name of the host on which the message server is running. |
Partner character set property | partnerCharset | This property specifies PartnerCharset encoding. When an encoding is specified, it is used; otherwise the default encoding is used. |
Password property | Password | This property is the password of the user account of the adapter on the SAP server. |
RFC trace on property | RFCTraceOn | This property specifies whether to generate a text file detailing the RFC activity for each event listener. |
System ID property | SAPSystemID | This property specifies the system ID of the SAP system for which logon load balancing is allowed. |
System number property | SystemNumber | This property is the system number of the application server. |
User name property | userName | This property is the user account for the adapter on the SAP server. |
This property specifies whether the adapter invokes the ABAP Debugger for the appropriate function module when the adapter begins processing a business object.
When the property is set to true, the adapter opens the SAP graphical user interface in debug mode.
You must have proper authorization to use the debugger. Create a dialog user ID because a CPI-C user ID cannot open an SAP graphical user interface session. You need authorization to run in debug mode as well as any authorizations required by the ABAP code being debugged. For example, if a BAPI_CUSTOMER_CREATEFROMDATA1 is being debugged, you need authorization to create customers.
You can add breakpoints only after the debugger opens.
Required? | No |
---|---|
Default | False |
Restrictions | This property is supported on the Windows platform only. |
Possible values | True or False |
When the adapter is configured to run without load balancing, this property specifies the IP address or the name of the application server that the adapter logs on to.
Required? | Yes (when load balancing is not used) |
---|---|
Default | None |
Property type | String |
Restrictions | |
Example | sapServer |
This property is the client number of the SAP system to which the adapter makes a connection.
Required? | Yes |
---|---|
Default | 100 |
Property type | String |
Range of values | 000 - 999 |
This property establishes a connection to the appropriate language. It must correspond to the value specified in the Language property.
Refer to the SAP documentation for the exact Language and Codepage values.
Required? | No |
---|---|
Default | Based on the value of the Language property |
Property type | Integer |
Example | If Language is set to JA (Japanese), Codepage number is set to 8000. |
This property is the name of the SAP system that will be used as the gateway for the resource adapter. The gateway enables communication between work processes on the SAP system and external programs. An IP address or the name of the Gateway host can be used.
Required? | Yes |
---|---|
Default | None |
Property type | String |
Restrictions | Maximum length of 20 characters. If the computer name is longer than 20 characters, define a symbolic name in the THOSTS table. |
Example |
This property is the identifier of the gateway on the gateway host that carries out the RFC services. These services enable communication between work processes on the SAP server and external programs. The service typically has the format of sapgw00, where 00 is the system number.
Required? | Yes |
---|---|
Default | sapgw00 |
Property type | String |
Restrictions | Maximum of 20 characters. |
This property specifies the language in which the adapter logs on.
Required? | Yes |
---|---|
Default | Based on the system locale |
Property type | String |
Possible values | |
Related properties | Code page number property |
When the adapter is configured for load balancing, this property specifies the name of the host on which the message server is running. Its purpose is to inform all the servers (instances) belonging to this SAP system of the existence of the other servers. It contains the information about load balancing for RFC clients so that an RFC client can be directed to an appropriate application server.
Required? | Yes (if load balancing is used) |
---|---|
Default | None |
Property type | String |
Restrictions | Only one message server can run on each SAP system. |
Example | SAPERP05 |
This property specifies PartnerCharset encoding. When an encoding is specified, it is used; otherwise the default encoding is used.
Required? | No |
---|---|
Default | None |
Property type | String |
Possible values | TBD |
Example | TBD |
This property is the password for the user account of the adapter on the SAP server.
The password is not globalized.
Required? | Yes |
---|---|
Default | None |
Property type | String |
Restrictions | The restrictions on the password depend on the version
of WebSphere® Application Server.
|
Example |
This property specifies whether to generate a text file detailing the RFC activity for each event listener. A value of true activates tracing, which generates a text file.
Examples of the information in the file are RfcCall FUNCTION BAPI_CUSTOMER_GETLIST, followed by the information for the parameters in the interface, or RFC Info rfctable, followed by the data from one of the interface tables.
This file is created in the directory in which the adapter process was started. The file has a prefix of rfx and a file type of trc (for example, rfc03912_02220.trc).
Use these text files in a development environment only, because the files can grow rapidly.
Required? | No |
---|---|
Default | False |
Possible values | True or False |
This property specifies the system ID of the SAP system for which logon load balancing is allowed.
Required? | Yes (when load balancing is used) |
---|---|
Default | None |
Property type | String |
Restrictions | Value must be three characters |
Example | DYL |