Load Balancing (-BAL)

Specify the Load Balancing (-BAL) adapter command to logon with SAP R/3 load balancing. The load balancing principle allows a login to a server that will dynamically route processes based on the availability of the application servers. Using load balancing typically results in improved performance and addresses the potential for failure from connecting to one specific application server. Additional information about load balancing can be found in the SAP RFC SDK.

Note: Using the SAP R/3 load balancing principle requires the existence of a logon group in the SAP system. Consult your Basis team for assistance and information about this logon group.

 -BAL -H HOST -S R3NAME -G GRP

Option: Description
-H HOST: Specify the server host name.
-S R3NAME: Specify the R/3 name of the system.
-G GRP: Specify the logon group.
Group typically has the default value of PUBLIC.

Note: When using -BAL, the values passed using -H, -S, and -G are always the values for -BAL. Therefore, never use the connection adapter commands for Host ID, System Number, or Gateway Host, which also use -H, -S, and -G for their values.

In addition, an entry must be added to the Services file, which is located in c:\winnt\system32\drivers\etc\services using the following syntax:

sapms R3NAME 36SYSNR/tcp

For example:

s apmsTSI 3600/tcp

The following is an example of the R/3 adapter command string for load balancing:

-c 800 -u JSharp -p S836GJ -bal -h MSG40 -s TSI -g PUBLIC

If it is necessary to connect to a gateway, you can specify GWHOST=gwhost directly within the adapter commands.

The Saprfc.ini file also supports the use of load balancing. The following is the example distributed by SAP as a sample entry in the Saprfc.ini file.

/*===================================================================*/
/*  Type B:  R/3 system - load balancing feature                     */
/*===================================================================*/
DEST=BIN
TYPE=B
R3NAME=TSI
MSHOST=MSG40
GROUP=PUBLIC
RFC_TRACE=0
ABAP_DEBUG=0
USE_SAPGUI=0

The following is an example of the R/3 adapter command string to accommodate using the Saprfc.ini file with load balancing:

-d BIN -c 800 -u JSharp -p S836GJ