Skip to Content
Author's profile photo Kerem Koseoglu

SAP GUI For Java Connection Strings

A question I get often is about the way I connect to SAP ECC from my Mac.

Obviously, many users prefer to install Windows to their Macbooks and run SAP GUI For Windows over it.

However; SAP has an alternative less known GUI for Linux / Mac systems: SAP GUI For Java. You can download it from for free using an S-user, install it to your Mac like a regular application and connect to any SAP ECC system. No need to install Windows at all.

The way you define a new SAP Connection in SAP GUI For Java differs slightly from SAP GUI For Windows. Let’s assume that you have the following connection information:

  • Address:
  • System No: 02

In SAP GUI For Java, you need to get to the “Advanced” tab, click “Expert mode” and enter the following connection string:


Obviously, the address goes between /H/ and /S/ and the system number goes to the end of the string. If your system ID is 00, you need to enter 3200. If your system ID is 07, you need to enter 3207. In our case, your system ID is 02 so you need to enter 3202.

That’s all there is! Using this connection string, you should be good to go.

Your connection string can contain additional parameters; such as your user name, client number, etc. Here are some sample connection strings:


Here are some sample connection strings going over routers (IP’s changed for security reasons):


The only disadvantage of SAP GUI For Java is for ABAP programmers: Smartforms designer, Workflow tools and graphical screen designer tools are Windows-only and won’t run under SAP GUI For Java. Personally, I have a casual Windows installation with SAP GUI for Windows living under VMWare Fusion. Whenever I need to use one of those tools (maybe once a month); I run Windows inside the virtual machine without leaving Mac OS, get my job done, shut down Windows and continue working on the Mac with SAP GUI For Java.

Assigned tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Ben Donley
      Ben Donley

      This blog entry is super useful because it's been hard for me to find the official documentation on PlatinGUI aka SAP GUI for Java connection strings. This blog entry has good google juice but the closest thing I could find to thorough documentation of all the parameters is here:

      It looks like that's coming out of a manual for 7.10, so it's out of date. Am I confused or is there an official manual that's pretty hard to search via ?

      Author's profile photo Gökhan Özcan
      Gökhan Özcan


      Dear Ben,

      Full set of fields (parameters) that could be included in the connection string can be found in "5.3.2 Connection Data" section of official Platin Manual.

      As of version 7.50, applicable fields and their descriptions are listed below.

      Parameter Description
      conn Connection String of the SAP system.
      clnt SAP client to fill in on logon screen (for example, "001")
      user User name to fill in on logon screen (for example, "guest")
      lang Language to fill in on logon screen (for example, "EN")
      tran Transaction to start after logon (for example, "BIBS")
      systemName When specifying an application server you can provide the system ID of the R/3 system to allow contacting its message server. This allows you to turn off expert mode after data entry.
      sncon If set to "true", Secure Network connections (SNC) is used for this connection (provided that a suitable SNC provider is installed). To be valid this parameter requires sncname to be specified.
      sncname SNC name of the SAP system (for example, "p/secude:CN=example, O=organization, C=DE"). To be valid this parameter requires requires sncon to be specified.
      sncqop SNC quality of protocol: one of the following numbers:

      1. : Authentication
      2. : Integrity
      3. : Encryption
      4. : Maximum available
      manualLogin Do not use the automatic login feature of SNC. Require manual login.
      cpg SAP codepage number (for example, "8000" for Japanese Shift-JIS). The default codepage is denoted by "0"
      wan If set to "true", WAN optimisations (for low speed connections) are enabled
      wp Reserved for the workplace
      ssot Reserved for the use of single sign-on in the workplace
      sso2 Reserved for the use of single sign-on in the workplace
      rfcid Reserved for dialog RFC usage

      Kind regards,

      Author's profile photo José Canet Tarazona
      José Canet Tarazona

      Dear Dr. Kerem Koseoglu, your post has been really interesting to me. Because I've been looking for a post during several years about how configure SAP Gui for Java, and only in your I understood what's the correct way to do it.

      Great post.

      Author's profile photo Andre Fischer
      Andre Fischer

      Nice blog. As non-Mac User it helps me when people with a Mac are joining my code jam events.

      Best Regards,




      Author's profile photo Wayne McDermott
      Wayne McDermott

      Thank you!

      Author's profile photo Mohamed Hamada
      Mohamed Hamada

      Hello Kerem, Thank you so much, your post is very useful and it is also rarely to find someone who explain such topic easily and detailed like you. many thanks, it was very useful to me.

      Author's profile photo Anjikumar Pasumarthy
      Anjikumar Pasumarthy

      Very helpful..!!