SAP Java Connector Properties

Configure SAP Java Connector (JCo) connection properties.

For a comprehensive list of SAP JCo properties you can use to create an instance of a client connection to a remote SAP system, see http://help.sap.com/javadocs/NW04/current/jc/com/sap/mw/jco/JCO.html#createClient(java.util.Properties).

General connection parameters
Name Description Supported values
Client Number Specifies the SAP client. Three-digit client number; preserve leading zeros if they appear in the number
Logon User Specifies the login user ID. User name for logging in to the SAP system

If using X.509 certificate authentication, remove the JCo properties jco.client.passwd and jco.client.user defined for the SAP connection profile in Sybase Control Center (SCC).

Password Specifies the login password. Password for logging in to the SAP system
Language Specifies a login language.

ISO two-character language code (for example, EN, DE, FR), or SAP-specific single-character language code. As a result, only the first two characters are ever used, even if a longer string is entered. The default is EN.

System Number Indicates the SAP system number. SAP system number
Host Name Identifies the SAP application server. Host name of a specific SAP application server
Message Server Identifies the SAP message server. Host name of the message server
Gateway Host Identifies the SAP gateway host.

Host name of the SAP gateway

Example: GWHOST=hs0311

Gateway Service Identifies the SAP gateway service.

Service name of the SAP gateway

Example: GWSERV=sapgw53

R/3 Name Specifies R/3 name. Name of the SAP system
Server Group Identifies the group of SAP application servers. Group name of the application servers
External Server Program Identifies the program ID of the external server program.

Path and name of the external RFC server program, or program ID of a registered RFC server program

Example: TPNAME=/sap/srfcserv

External Server Program Host Identifies the host of the external server program. This information determines whether the RFC client connects to an RFC server started by the SAP gateway or to an already registered RFC server.
Note: If the gateway host and external server program host are different, make sure that the SAP gateway has access to start the server program through a remote shell.

Host name of the external RFC server program

Example: TPHOST=hs0311

Remote Host Type Identifies the type of remote host.

2: R/2

3: R/3

E: external

RFC Trace Specifies whether or not to enable RFC trace.

0: disable

1: enable

Initial Codepage

Identifies the initial code page in SAP notation.

A code page is used whenever character data is processed on the application server, appears on the front end, or is rendered by a printer.

Four-digit SAP code page number
Enable ABAP Debugging

Enables or disables ABAP debugging. If enabled, the connection is opened in debug mode and the invoked function module can be stepped through in the debugger.

For debugging, an SAP graphical user interface (SAPGUI) must be installed on the same machine the client program is running on. This can be either a normal Windows SAPGUI or a Java GUI on Linux/UNIX systems.

0: no debugging

1: attach a visible SAPGUI and break at the first ABAP statement of the invoked function module

Remote GUI Specifies whether a remote SAP graphical user interface (SAPGUI) should be attached to the connection. Some older BAPIs need an SAPGUI because they try to send screen output to the client while executing.

0: no SAPGUI

1: attach an "invisible" SAPGUI, which receives and ignores the screen output

2: attach a visible SAPGUI

For values other than 0 a SAPGUI needs to be installed on the machine, where the client program is running. This can be either a Windows SAPGUI or a Java GUI on Linux/Unix systems.

Get SSO Ticket Generates an SSO2 ticket for the user after login to allow single sign-on. If RfcOpenConnection() succeeds, you can retrieve the ticket with RfcGetPartnerSSOTicket() and use it for additional logins to systems supporting the same user base.

0: do not generate SSO2 ticket

1: generate SSO2 ticket

Use Cookie Version 2 Indicates whether or not to use the specified SAP Cookie Version 2 (SSO2) as the login ticket instead of user ID and password.

User: $MYSAPSSO2$

Password: Base64-encoded ticket

Login with single sign-on is based on secure network connection (SNC) encryption and can only be used in combination with an SNC.

Use X509 Indicates whether or not to use the specified X509 certificate as the login certificate instead of user ID and password.

User: $X509CERT$

Password: Base64-encoded ticket

Login with X509 is based on secure network connection (SNC) encryption and can only be used in combination with an SNC.

Logon Check Enables or disables login check at open time.

0: disable

1: enable

If you set this to 0, RfcOpenConnection() opens a network connection, but does not perform the login procedure. Therefore, no user session is created inside the back-end system. This parameter is intended only for executing the function module RFC_PING.

Additional GUI Data Provides additional data for graphical user interface (GUI) to specify the SAProuter connection data for the SAPGUI when it is used with RFC.

/H/ router string : the entire router string for the SAPGUI

/P/ password : specify this value if the password for the SAPGUI connection is not the same as the password for the RFC connection.

GUI Redirect Host Identifies which host to redirect the remote graphical user interface to. Host name
GUI Redirect Service Identifies which service to redirect the remote graphical user interface to. Name of the service
Remote GUI Start Program Indicates the program ID of the server that starts the remote graphical user interface. Program ID of the server
SNC Mode Enables or disables secure network connection mode.

0: off

1: on

SNC Partner Identifies the secure network connection partner. Secure network connection name of the application server (for example, p:CN=R3, O=XYZ-INC, C=EN)
SNC Level Specifies the secure network connection security level.

1: digital signature

2: digital signature and encryption

3: digital signature, encryption, and user authentication

8: default value defined by backend system

9: maximum value that the current security product supports

SNC Name Indicates the secure network connection name. This property overrides the default secure network connection partner. Token or identifier representing the external RFC program
SNC Service Lib Path Identifies the path to the SAP crytpographic library that provides secure network connection service. Full path and name of third-party security library. You must download and install the library from the SAP Service Marketplace.
R/2 Destination Identifies a configured R/2 system defined in the sideinfo configuration.
Logon ID Defines the string for SAPLOGON on 32-bit Windows. String key to read parameters from the saplogon.ini file created by the SAPLogon GUI program on Windows
External Authentication Data Provides data for external authentication (PAS). This is an old login mechanism similar to SSO; Sybase recommends that you do not use this approach.  
External Authentication Specifies type of external authentication (PAS). See External Authentication Data property.