/*********************************************************************
/* *
/* SAPNWRFC.INI *
/* *
/*********************************************************************
/*===================================================================*
/* DEFAULT Section *
/* *
/* The default section defines some default or global properties *
/* regarding connection management and tracing. Here is a sample *
/* configuration. *
/* *
/*===================================================================*
# DEFAULT
# Trace all connections/destinations, which do not explicitly define
# their own trace level, with level 1. If this value is not set, the
# default is 0. Possible values are 0(off), 1(brief), 2(verbose), 3(full)
RFC_TRACE=0
# The following three parameters are evaluated only once at process
# startup, not when reloading the sapnwrfc.ini file at a later point.
# By default, all trace files are written into the current working
# directory of the process. If you want to change that location, use
RFC_TRACE_DIR=C:\Projects\
# By default, the NW RFC library creates one trace file per thread, in
# order to avoid multiple threads interleaving their trace output.
# If you want one trace file for the entire process, specify
#RFC_TRACE_TYPE=PROCESS
# When tracing data that contains non-ISO-8859-1 characters, the trace
# file becomes corrupted. In that case use the following parameter to
# change the file encoding of the trace file. Possible values are
# UTF-16 and UTF-8. If the parameter is not specified, the default platform
# encoding is used, which is CP1252 or ISO-8859-1 on most Windows systems,
# and UTF-8 on most Linux systems.
# On Windows UTF-16 shows better performance than UTF-8, because no additional
# conversion is required. On Linux, UTF-8 is recommended.
RFC_TRACE_ENCODING=UTF-16
/*===================================================================*
/* Destination Sections *
/* *
/*===================================================================*
DEST=MYSAP2005
TYPE=A
ASHOST=MYSAP2005
SYSNR=01
/*===================================================================*
/* *
/* The following is a list of all supported parameters. *
/*===================================================================*
# 1. General Connection parameters
# These can be used with client and server programs
# SAPROUTER : If the connection needs to be made through a firewall
via a SAPRouter, specify the SAPRouter parameters in the
following format:
/H/hostname/S/portnumber/H/
# SNC_LIB : Full path and name of third-party security library to
use for SNC communication (authentivation, encryption and signatures)
Alternatively you can set the environment variable SNC_LIB.
# SNC_MYNAME : Token/identifier representing the external RFC program
# SNC_PARTNERNAME : Token/identifier representing the backend system
# SNC_QOP : One of the following values:
1 Digital signature
2 Digital signature and encryption
3 Digital signature, encryption and user authentication
8 Default value defined by back-end system
9 Maximum value that the current security product supports
# TRACE : One of 0(off), 1(brief), 2(verbose), 3(full)
# PCS : "Partner character size". In 99.9% of the cases you
don't need to bother with that. During the initial handshake
the RFC library obtains the correct value from the backend and
uses it from then on. One rare usecase is as follows: you know
that the backend is Unicode and 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.
# CODEPAGE : Similar to PCS above. You only need it if you want to connect
to a non-Unicode backend 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.
A few common values are:
1401: ISO-Latin-2
1500: ISO-Latin-5/Cyrillic
1600: ISO-Latin-3
1610: ISO-Latin-9/Turkish
1700: ISO-Latin-7/Greek
1800: ISO-Latin-8/Hebrew
1900: ISO-Latin-4/Lithuanian/Latvian
8000: Japanese
8300: Traditional Chinese
8400: Simplified Chinese
8500: Korean
8600: Thai
8700: ISO-Latin-6/Arabic
However, please note that these values can be customized in the backend.
Better consult the backend sysadmin first, as otherwise things may go
terribly wrong...
# NO_COMPRESSION : By default the RFC protocol compresses tables, when they reach a
size of 8KB or more. On very rare occasions you may want to turn this
off, for example if you are transporting huge integer/binary tables with
"random" data, where compression would have no effect except for burning CPU...
# ON_CCE : "On Character Conversion Error". What shall the NW RFC lib do, when it encounters
a character that does not exist in the target codepage, a broken character
or a control character (0x00 - 0x19)? This parameter can
take three values:
0: Abort with an error message (default behaviour). Note that in this case
control characters (e.g. tabulator, carriage return or linefeed characters)
are not considered "illegal" and will therefore not cause an abort.
1: Copy the character in a "round-trip compatible way". The resulting output
character may be "garbage" in the target codepage, but when converted back
to the source codepage, it will be the original character.
2: Replace the character with a substitute symbol (usually a # character).
Note that in this case the control characters are replaced as well. If you need
the control characters, then you'll have to use option 0 or 1, depending on whether
you want the NW RFC Lib to abort the call in case of broken characters or not.
# CFIT : "Conversion Fault Indicator Token". The substitute symbol used if ON_CCE=2.
Needs to be given as hexadecimal value of a Unicode codepoint.
The default is 0x0023 ("# character").
# 2. Parameters used in client programs
# USER : Username
# PASSWD : Password
# CLIENT : The Client or "Mandant" to which to logon.
# LANG : Logon Language. Either specify the two-character ISO-Code (like EN for English,
KO for Korean) or the one-character SAP-specific code (like E for English,
3 for Korean). Note that the ISO-codes are case-insensitiv, while the SAP
codes are not! So 'D' logs you on in German, while 'd' logs you on in
Serbian, if that language is installed in your system...
# MYSAPSSO2 : Use this parameter instead of USER&PASSWD to log on with an SSO2 ticket (Single-Sign_On)
or with an "Assertion" ticket (starting with backend release 7.00).
# GETSSO2 : Set this to 1, if the backend should generate an SSO2 ticket for your user.
If RfcOpenConnection() succeeds, you can retrieve the ticket with
RfcGetPartnerSSOTicket() and use it for further logons to systems supporting
the same user base.
!!! Note: No longer supported! SAP systems shall no longer issue tickets during user logon!!!
# X509CERT : Use this parameter instead of USER&PASSWD, if you want to logon with an X.509
certificate. The certificate needs to be Base64 encoded and needs to be
mapped to a valid user in the backend's user configuration.
# EXTIDDATA : Old logon mechanism similar to SSO. No longer recommended.
# EXTIDTYPE : See EXTIDDATA.
# LCHECK : If you set this to 0, RfcOpenConnection() only opens a network connection but
does not perform the logon procedure. I.e. no user session will be created
inside the backend system. Note that such a connection is not particularly
useful: the only function module you can execute over it is RFC_PING...
# USE_SAPGUI: Specifies whether a SAPGui should be attached to the connection. Some (old) BAPIs
need this, because they try to send screen output to the client while
executing. Possible values are:
0: no SAPGui (default)
1: attach a visible SAPGui.
2: attach a "hidden" SAPGui, which just receives and ignores the screen output.
Note that 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 normal
Windows SAPGui or a Java Gui on Linux/Unix systems.
Note on USE_SAPGUI=2: this type has a negative performance impact. If you
are using only one function module that needs a Gui, and a large number of
"normal" function modules, you should consider the following alternatives:
a) Open the connection with USE_SAPGUI=1, and immediately after each RFC call
that may invoke SAPGui, make an RFC call to the FM SYSTEM_INVISIBLE_GUI on
the same connection to hide the SAPGui. Call your other FMs as usual.
b) Open two connections, one without USE_SAPGUI parameter and one with USE_SAPGUI=2.
Use the first connection for executing all "normal" FMs and the second connection
whenever you need to call the FM that uses the Gui.
# ABAP_DEBUG: Can be used for R/3 systems with release < 6.20, where "external breakpoints" are not
yet available. The connection is opened in debug mode and the invoked function
module can be steped through in the debugger. Possible values:
0: no debugging (default)
1: attach a visible SAPGui and break at the first ABAP statement of the
invoked function module.
Note that for debugging a SAPGui needs to be installed on the machine,
where the client program is running. This can be either a normal Windows
SAPGui or a Java Gui on Linux/Unix systems.
For backend releases >= 6.20 use "external breakpoints" instead (see note
668256), as this is more convenient and allows the debugger to run on any
host, not only the host on which the RFC client program is running.
# In addition you need parameters from one of the following two groups:
# 2.1 Parameters for direct application server logon
# ASHOST : Hostname of the application server.
# SYSNR : The backend's system number. (E.g. "01")
# 2.2 Parameters for load balancing
# MSHOST : Hostname of the message server, which is doing the loadbalancing.
# MSSERV : Not needed in most cases. Specify this parameter only, if the
message server does not listen on the standard service "sapms<SysID>",
or if this service is not defined in the services file and you need to
specify the network port directly. Note: on Unix the services are
defined in /etc/services, while on Windows they are defined in
C:\WINDOWS\system32\drivers\etc\services.
# R3NAME or SYSID : The backend's system ID. (E.g. "H9C"). If this parameter is not
specified, the value of DEST is used instead.
# GROUP : The logon group from which the application server should be chosen.
If this parameter is not specified, "PUBLIC" is used.
# 3. Parameters used in server programs
# GWHOST : Hostname of the RFC gateway at which to register. Usually some
application server host.
# GWSERV : Either specify "sapgw<SysNr>" or the port number directly, if
that service is not defined in the services file. (Also see MSSERV.)
# TPNAME or PROGRAM_ID : The program ID used to identify the SM59 RFC destination, for which
we want to receive requests.
No comments:
Post a Comment