RFC (Remote Function Call) Options - Universal Connector for SAP

Description

The RFC (Remote Function Call) options are always used to configure a fault tolerant RFC connection. All RFC options have default values that are used if additional values are not provided.

Command Line Syntax

The following figure illustrates the command line syntax of the RFC options, using their command line, long form.

-rfc_cfit <symbol>
-rfc_codepage <codepage>
-rfc_delta <option>
-rfc_listen_interval <interval>
-rfc_logon_retry_count <count> 
-rfc_logon_retry_interval <interval> 
-rfc_mysapsso2 <path>
-rfc_no_compress <option>
-rfc_on_cce <option>
-rfc_pcs <size>
-rfc_retry_count <count>
-rfc_retry_interval <interval>
-rfc_timeout <interval>
-rfc_trace <level>
-rfc_trace_dir <path>
-rfc_x509cert <path>
-saprouter <parameters>
-snc_lib <path>
-snc_mode <mode>
-snc_myname <token>
-snc_partnername <token>
-snc_qop <level>
-snc_sso <level>

RFC Options List

The following table describes all RFC options and provides the command line, long form of each option illustrated in the RFC options command line syntax, above.

Configuration Option Name	Command Line Long Form	Description
CFIT	-rfc_cfit	Substitute symbol to use if the ON_CCE option value is 2 (replace the character).
CODEPAGE	-rfc_codepage	As documented by SAP: The CODEPAGE option is similar to the PCS option. It is needed only if you want to connect to a non-Unicode back-end using a non-ISO-Latin-1 username or password. The RFC library will then use that codepage for the initial handshake, thus preserving the characters in username/password.
DELTA	-rfc_delta	Specification for whether or not to use delta-manager when serializing / deserializing table parameters passed by using TABLES clause.
LISTEN_INTERVAL	-rfc_listen_interval	Number of seconds that will elapse between RFC listen calls.
LOGON_RETRY_COUNT	-rfc_logon_retry_count	Number of unsuccessful RFC logon retry attempts that can occur before USAP terminates the logon process and ends unsuccessfully.
LOGON_RETRY_INTERVAL	-rfc_logon_retry_interval	Number of seconds that will elapse between a failed RFC logon attempt and the retry of that logon attempt.
MYSAPSSO2	-rfc_mysapsso2	Path to a file containing the credentials to log on with an SSO2 ticket (Single-Sign_On) - instead of USER&PASSWORD - or with an "Assertion" ticket (starting with back-end release 7.00).
NO_COMPRESSION	-rfc_no_compress	Specification for whether or not the RC protocol compress tables.
ON_CCE	-rfc_on_cce	Specification for what the NW RFC library will do when it encounters a character that either does not exist in the target codepage, is a broken character or is a control character (0x00 - 0x19).
PCS	-rfc_pcs	As documented by SAP: The PCS option specifies a Partner Character Size. It is rarely needed, as during the initial handshake, the RFC library obtains the correct value from the back-end and uses it from then on. However, a rare use case could be that the back-end is Unicode and you want to use a non-ISO-Latin-1 username or password for the initial logon. As the initial handshake is done with ISO-Latin-1, the characters in username/passwd would break, resulting in a refused logon. In that case, set PCS=2 and the RFC library will use Unicode for the initial handshake.
RETRY_CALL_COUNT	-rfc_retry_count	Number of unsuccessful RFC call retry attempts that can occur before USAP terminates the RFC call retry process and ends unsuccessfully.
RETRY_CALL_INTERVAL	-rfc_retry_interval	Number of seconds that will elapse between a failed RFC call and the retry of that call.
RFC_INI_DIR	-rfc_ini_dir	The path in which the SAP NW RFC library will search for the sapnwrfc.ini file.
RFC_TRACE	-rfc_trace	Trace level of all connections / destinations.
RFC_TRACE_DIR	-rfc_trace_dir	The directory in which the SAP NW RFC library will write its trace files to.
SAPROUTER	-saprouter	SAPRouter string for the NW RFC connection.
SNC_LIB	-snc_lib	Full path and name of a third-party security library to use for SNC communication (authentication, encryption, and signatures).
SNC_SECUDIR	-snc_secudir	The path to the security folder to be used by SAP cryptography.
SNC_MODE	-snc_mode	Specification for whether or not SNC should be activated for the SAP RFC connection.
SNC_MYNAME	-snc_myname	Token/identifier representing the external RFC program.
SNC_PARTNERNAME	-snc_partnername	Token/identifier representing the back-end system.
SNC_QOP	-snc_qop	Quality of protection level.
SNC_SSO	-snc_sso	Specification for whether or not to use SNC single sign-on if SNC is enabled.
TIMEOUT_INTERVAL	-rfc_timeout	Number of seconds that can elapse before USAP considers an RFC call to have timed out.
TRACE_DIRECTORY	-rfc_trace_dir	Directory where RFC trace files will be written.
USE_SYMBOLIC_NAMES	-rfc_use_symbolic_names	Specification for whether the NW RFC library, during group-logon, should use symbolic service names defined in /etc/services (such as sapgw33, or hard-coded port numbers derived from the instance number (such as 3300).
X509CERT	-rfc_x509cert	Path to a file containing the credentials to log on with an X509 certificate ticket instead of USER&PASSWORD.