WebSphere Message Brokers
File: rbp_sap_j2c_conn_fact_props
Writer: Karen Cameron

Reference topic

This build: July 31, 2007 21:40:41

Managed connection factory properties

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).

The following table lists the managed connection factory properties. A complete description of each property is provided in the sections that follow the table.
Table 1. Managed connection factory properties for WebSphere Adapter for SAP Software
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.

ABAP debug property

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.

Note: This property should always be set to False in a production environment.
Required? No
Default False
Restrictions This property is supported on the Windows platform only.
Possible values True or False

Application server host property

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

Client property

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

Code page number property

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.

Gateway host property

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  

Gateway service property

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.

Language property

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

Message server host 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

Partner character set property

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

Password property

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.
  • For WebSphere Application Server version 6.40 or earlier, the password:
    • Must be uppercase
    • Must be 8 characters in length
  • For versions of WebSphere Application Server later than 6.40, the password:
    • Is not case-sensitive
    • Can be up to 40 characters in length
Example  

RFC trace on property

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

System ID property

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

System number property

This property is the system number of the application server. The value is a two-digit number, often 00.

Required? Yes
Default 00
Property type String
Range of values 00-99

User name property

This property is the user account of the adapter on the SAP server.

Required? Yes
Default None
Property type String
Restrictions Maximum length of 12 characters. The user name is not case-sensitive.
Example SapUser
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:40:41

rbp_sap_j2c_conn_fact_props This topic's URL is: