Liquid UI Web Server requires information about the server’s location to establish a connection with a SAP ERP system. Connection strings specify the target SAP ERP system for the RFC user. These strings can directly point to a SAP ERP system or a back-end system through a message server when load-balancing is employed. Connection strings are defined within the config.js file and entered into the SAP Router field when creating an SAP connection. Various formats can be used for connection strings, as outlined below:
- /H/[serverName]
-
This connection string is used when there is a single server to connect to. The value that replaces the [serverName] can be either a Liquid UI Server or a SAP application Server. If our server is named 'Coffee', the string would appear as follows.
/H/Coffee
- /H/[serverName]/G/[groupName]
-
This format is used when you are connecting to a single server, with multiple user groups. For example, if we are using the 'Roast' group on the 'Coffee' server, the connection string is shown below.
/H/Coffee/G/ROAST
- [serverName]:[portNumber]
-
This format is used when you are connecting to a single server with a specific port. For example, if port 3600 is used on the 'Coffee' server, the connection string is shown below.
Coffee:3600
- /H/[serverName]/S/[messageServerName]
-
This format is used when connecting to a single server through a message server. The connection string is shown below.
/H/Coffee/G/ROAST
- /H/[serverName]/S/[messageServerName]/G/[groupName]
-
This format is used when connecting to a specific server with multiple user groups through a message server. For example, if using 'Decaf' to connect to the 'Coffee' server in the 'Roast' group, the connection string is shown below.
/H/Coffee/S/Decaf/G/Roast
Connection strings can be used to establish a direct connection to a specific SAP ERP system or to point to a back-end system through a message server. Refer to the Load Balancing section within this document for more details on load balancing.
If you are using the rfcconnect command, you can use this command to directly enter a connection string. A typical rfcconnect string will look as shown in the following example:
rfcconnect = "SYSNR=00 IFDATABASE=TRX LANG=E CLIENT=800 ASHOST=juneau SYSNR=00 LCHECK=0 USE_SAPGUI=0 USER=ayam PASSWD=x05y9a787q/rmAYe7CqiUmcsXVyK3N427ummcQ04LPs=" ;
In addition to a single rfcconnect entry, it is also possible to enter an array that contains multiple rfcconnect strings. Such an array would look as in the following example:
rfcconnect = [ "IFDATABASE=GD4 CLIENT=600 ASHOST=HMLUSDA4.SAMPLE.NET SYSNR=00", "IFDATABASE=GD2 CLIENT=600 ASHOST=SAMPLE4.SAMPLE.NET SYSNR=02", "IFDATABASE=GT4 CLIENT=600 ASHOST=SAMPLE6.SAMPLE.NET SYSNR=04", "IFDATABASE=TRX CLIENT=800 ASHOST=SAMPLE1 SYSNR=00", "IFDATABASE=GT7 CLIENT=600 ASHOST=SAMPLE6.SAMPLE.NET SYSNR=02"];
Message Server Parameters
Message strings can be used to connect with either a Message Server or an Application Server. The connection strings above contains several parameters. When used with the rfcconnect command to connect to either a message server or an application server, these parameters are specified with variable names in the string or array format as demonstrated above. Some of the parameters are used regardless of whether the RFC connection is being made to a message server or to an application server. However, certain unique parameters are specific to a Message Server or to an Application Server. thse parameters are explained in the following section.
- MSHOST
-
This parameter specifies the name of the message server to which you are connecting.
- R3NAME
-
This parameter defines the name of the SAP Application Server to which you will connect. This is important as the message server needs to know the specific SAP application server to which the connection will be passed.
- GROUP
-
This parameter defines the group to which your user ID belongs. Group membership is used as a parameter to determine which SAP Application Servers you will access.
Application Server Parameters
The parameters specific to an application server are explained in the following section.
- ASHOST
-
This parameter specifies the name of the SAP application server being used for the connection.
- SYSNR
-
This parameter defines the system number of the SAP instance to which the user will connect. A single connection can include multiple instances. The system number is typically a two-digit number and can be obtained from the SAP ERP system properties.
- GROUP
-
This parameter defines the group to which your user ID belongs. Group membership is used as a parameter to determine which SAP Application Servers you will access.
Common Server Parameters
The parameters that are common to both a message server and an application server are explained in the following section.
- IFDATABASE
-
This parameter specifies the SAP ERP system that is currently connected. This parameter must be specified in the connection string for the connection to occur.
- LANG
-
This parameter defines the default language to be used. 'E' is the language code for English. The language code is typically a single alphabetic character and can be obtained from the SAP ERP system properties.
- CLIENT
-
This parameter defines the client to which you will be connecting. The standard SAP client is always '000', therefore it is very important to specify which client the user will connect to.
- LCHECK
-
This parameter is a Boolean parameter that signifies if a logon check is performed at the time of opening. '0' indicates no check will be performed; '1' specifies that a check will be performed.
- USE_SAPGUI
-
In the relevant connection, this parameter determines whether or not the SAP GUI should be utilized. For no SAP GUI usage, set the value to '0'; for SAP GUI usage, set the value to '1'. The default setting is '0'.
- USER
-
This parameter contains the user name for the specified RFC user ID.
- PASSWORD
-
This parameter contains the encrypted password for the specified RFC user ID.
- CLIENT
-
This parameter defines the group to which your user ID belongs. Group membership is used as a parameter to determine which SAP Application Servers you will access.