Outbound adapter properties for SAP

True
False

You must have appropriate authorization to use the debugger. Create a dialog user ID because a CPI-C user ID cannot open an SAP GUI session. You must have authorization to run in debug mode as well as any authorizations that are required by the ABAP code that is being debugged. For example, if a BAPI_CUSTOMER_CREATEFROMDATA1 is being debugged, you must have authorization to create customers.

You can add breakpoints only after the debugger opens.

Always set this property to False in a production environment.

This property is supported on Windows systems only.

When an application attempts to log on to the SAP server, the application must have a Client number associated with it. The Client property value identifies the client (the adapter) that is attempting to log onto the SAP server.

For a full listing of languages and associated code page numbers that are supported by SAP, see SAP Note 7360.

The value that is assigned to the Codepage number defines the code page to be used and has a one-to-one relationship with the value set for the Language code property. The Codepage number establishes a connection to the appropriate language.

Each language code value has a code page number value associated with it. For example, the language code for English is EN. If you select EN (English) as your language code, the code page number is automatically set to the numeric value that is associated with EN (English). The SAP code page number for EN (English) is 1100.

If Language code is set to JA (Japanese), Codepage number is set to 8000.

This property applies to Query interface for SAP Software only.

On non-Unicode systems, the default function used to retrieve data from SAP tables (RFC_READ_TABLE) might produce an exception. To avoid the problem, you can create another function on the SAP server and indicate, during configuration, that the adapter must use this custom function to retrieve data. This property specifies the name of the custom function.

You must create the function on the SAP server before you specify this property on the Adapter Connection wizard. Follow the steps listed in SAP note 758278 to make a copy of RFC_READ_TABLE and modify the copy in line with the note.

0 (off)
1 (on)

If RFC trace on is set to False (not selected), you are not permitted to set a value in the Folder for RFC trace files property.

True
False

This property is the host name of the SAP gateway. The gateway enables communication between work processes on the SAP system and external programs.

The host identified is used as the gateway for the resource adapter.

Maximum length of 20 characters. If the computer name is longer than 20 characters, define a symbolic name in the THOSTS table.

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 SAP system number.

Maximum of 20 characters.

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.

True
False

When you set this property to True, the Adapter for SAP Software ignores the checking of error codes in the BAPI RETURN structure after BAPI has run, and returns this structure to the user as it is. The RETURN structure is part of every BAPI and contains the status of the BAPI execution.

If you accept the default value of False, the Adapter for SAP Software processes the RETURN structure and throws an exception if an error code is found.

For a full listing of languages and associated code page numbers that are supported by SAP, see SAP Note 7360.

Each of the supported languages is preceded by a two-character language code. The language itself is displayed in parentheses.

If you enter a language code manually, you do not need to enter the language in parentheses.

The language codes that are listed represent the SAP default set of 41 languages for non-Unicode systems plus Arabic.

The value that you select determines the value of the Codepage number property.

If the system locale is English, the value for this property is EN (English).

If the number of hits in the table on the SAP server exceeds the value of the ResultSetLimit property, the adapter returns the error: MatchesExceededLimitException. The adapter uses this property to help avoid out-of-memory issues.

This property specifies the name of the host that will inform all the servers (instances) belonging to this SAP system of the existence of the other servers to be used for load balancing.

The message server host contains the information about load balancing for RFC clients so that an RFC client can be directed to an appropriate application server.

UTF-8

The restrictions on the password depend on the version of SAP Web Application Server.

• For SAP Web Application Server version 6.40 or earlier, the password:
  • Must be uppercase
  • Must be 8 characters in length
• For versions of SAP Web Application Server later than 6.40, the password:
  • Is not case-sensitive
  • Can be up to 40 characters in length

0 - No error
1 - Errors and warnings
2 - Execution path, errors and warnings
3 - Full Execution path, errors and warnings
4 - Execution path, info messages, errors and warnings
6 - Full execution path, info messages, errors and warnings
7 - Debug messages, full execution path, info messages, errors and warnings
8 - Verbose debug messages, full execution path, info messages, errors and warnings

True
False

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.

If RFC trace on is set to False (not selected), you cannot set values in the Folder for RFC trace files or RFC trace level properties.

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.

The trace file is created in the directory where the adapter process has been started. The trace file has a .trc file extension and the file name will start with the letters rfc followed by a unique identifier. For example, rfc03912_02220.trc.

When you want to deliver BAPI calls to a queue on the SAP server, you must specify the name of the queue. During configuration, you select an existing queue from a drop-down list. If no queues exist on the SAP server, you can type the name of a queue.

The system number further identifies the Gateway service.

True
False

When you set this property to True, the Adapter for SAP Software calls a BAPI_TRANSACTION_COMMIT with the WAIT parameter set, so that other resource managers are committed only when the update has been completed in SAP.

If you accept the default value of False, message flow processing might continue before the update has been completed in SAP. Therefore, after calling a BAPI, the updated data might not be available when you next access the system.

It is recommended that you set up a CPIC user account in the SAP application and that you give this account the necessary privileges to manipulate the data required by the business objects supported by the adapter. For example, if the adapter must perform certain SAP business transactions, the adapter's account in the SAP application must have the permissions set to allow it to perform these transactions.