Purpose
The rfcconnect command takes a number of parameters.
The rfcconnect command can be used to connect with either a Message Server or with an Application Server. In addition, the password can be either in plain text or encrypted. The example string above contains a number of parameters. Some of the parameters are used regardless of whether the RFC connection is being made to a message server or to an application server.
Common Parameters
The parameters common to both Message Server and Application Server are as follows:
- IFDATABASE
- The SAP ERP system that is currently connected. This parameter must be specified in the connection string in order for the connection to occur.
- LANG
- The default language to be used. 'E' is the language code for English.
- CLIENT
- The client to which the user is connecting. The standard SAP client is always '000', therefore it is very important to specify which client the user will connect to.
- LCHECK
- Boolean parameter that signifies if a logon check is performed at the time of opening. '0' indicates that no check will be performed; '1' specifies that a check will be performed.
- USE_SAP_GUI
- Specifies whether the SAP GUI is to be used or not in the relevant connection. Set to '0' if SAP GUI is not to be used; set to '1' if SAP GUI is to be utilized. By default it should be set to '0'.
- USER
- The username of the RFC user.
- PASSWD
- The password for the specified RFC user. This can be in two separate formats - either an unencrypted plain text string or an encrypted string.
- GROUP
- Specifies the SAP group to which the user belongs.
Message Server
The unique parameters for the Message Server are as follows:
- MSHOST
- Specifies the SAP Message Server to which the connection is being made.
- R3NAME
- Specifies the name of the SAP ERP system to which the connection is being made. This is important as the message server needs to know to which specific SAP ERP system it must pass the connection.
Note: If a message server is used, there are also additional parameters that must be included in the message server configuration file. Please see the GuiXT Server documentation for additional information.
Connecting to Message Servers
If you want to connect to a message server, the string would look like the following example:
rfcconnect = [ "ifdatabase=XXX,mshost=message_server,r3name=sap_SYSTEM_NAME, group=group_name,lang=E,client=000,sysnr=00,lcheck=0, use_sapgui=0 ]; rfcuser="rfc_userName"; rfcpasswd="rfc_Password";
Application Server
The unique parameters for the application server are as follows:
- ASHOST
- Specifies the name of the target Server to which the connection is being made.
- SYSNR
- Specifies the system number of the target server to which the connection is being made. This is important as the application server needs to know to which specific SAP ERP system it must pass the connection.
Connecting to Application Servers
If you want to connect directly to an SAP application server, the rfcconnect statement would look like the example below:
rfcconnect = [ "ifdatabase=XXX,lang=E,client=100,ashost=system1,sysnr=00,lcheck=0,use_sapgui=0 ]; rfcuser="rfc_userName"; rfcpasswd="rfc_Password";
Single rfcconnect statement
If only a single server is to be the target, we can use a single rfcconnect command as shown in the following example:
rfcconnect ="ifdatabase=XXX,lang=E,client=100,ashost=system,sysnr=00,lcheck=0,use_sapgui=0"; rfcuser="user"; rfcpasswd="password";
rfcconnect arrays
If multiple servers are targeted, we can use a rfcconnect array as shown in the following example:
rfcconnect = [ "ifdatabase=AD4,client=600, ashost=TEST4.SAMPLE.NET,sysnr=00", "ifdatabase=AD2,client=600, ashost=TEST04.SAMPLE.NET,sysnr=02", "ifdatabase=AT4,client=600, ashost=TEST6.SAMPLE.NET,sysnr=04", "ifdatabase=AT7,client=600, ashost=TEST06.SAMPLE.NET,sysnr=02"];
Note: The rfcconnect arrays statement supports only ifdatabase, client, ashost, and sysnr parameters.
