1. Knowledge base
  2. zap Audit
  3. Installation / Preparation

What SAP connection data is required?

All the information you need to know to get zap Audit data extraction up and running.

The easiest way is to use connection data already used with your SAP Logon. Otherwise, you have to determine how you want to connect to your SAP system. There are two types of SAP server:

  • SAP message server
  • SAP application server

Specify the server type of your SAP server. If this information is not available, please contact your SAP manager.

Make sure you download the SAP JCo Library (read the guide) and have the necessary access rights in SAP (read guide).

SAP Logon (SAP GUI)

If SAP Logon pad is installed on the computer on which zap Audit is running on, connection data will be presented in zap Audit automatically. You will find all the used connections in the list. Choose one of them to auto-fill the data:

EN14_logon_sap_marked


If SAP Logon is installed on your system, your SAP connection data will be stored in a local file. You can find this file in your user directory in this file
path C:\Users\YourAccountName\AppData\Roaming\SAP\Common\saplogon.ini

Note: The AppData folder is usually hidden by Windows.

Note: S4/HANA stores this data in an XML file in this file
path C:\Users\YourAccountName\AppData\Roaming\SAP\Common\LogonServerConfigCache\

SAP message server

Specify the following connection parameters:

  • Message server (mshost): Find out the server name of your message server. You can either use the IP (e.g. 12.123.04.123) or the name of the server (e.g. companyBW02.sap.com) If you do not have this information, please contact your SAP manager or check the Message Server Monitor by entering transaction "SMMS" on your SAP system.
  • Message server port: This parameter identifies the message server port where requests are saved. In the standard system, SAP uses ports 36NN for the message server. While NN is the instance/system number of the system. Usually, it is a port between 3600 and 3610. If you do not know the exact port number, you can try out all the standard ports one by one until you find the correct one. Alternatively, enter the transaction "RZ11" and search for the parameter "ms/server_port". If in doubt, contact your SAP administrator.
    If your Windows services file (C:\Windows\System32\drivers\etc\services) is up to date, you can also enter "sapms<SID>’" as port name (e.g. sapmsA40 or sapmsTKR). Then the port will be automatically mapped to the correct one. The SID is the system ID (r3name) of your SAP.
  • SAP system name (r3name): Determine the system ID (SID) of your SAP system. If you do not have this information, please contact your SAP manager.
  • Group of message servers: Find out the SAP group of your message server. If you do not have this information, please contact your SAP manager or enter the transaction "SMLG" in your SAP system.
  • SAP Router String: A route string describes the stations of a connection required between two hosts. In general, it is used by the firewall for external access to your network. It has the following syntax:

/H/host/S/service/W/pass/H/

Info:

/H/ indicates the host name
/S/ is used for specifying the service (port); it is an optional entry, the default value is 3299
/W/ indicates the password for the connection between the predecessor and successor on the route and is also optional (default is "", no password)

  • SAP Client: Determines the client ID which consists of a three-digit number. If you do not have this information, please contact your SAP manager or enter transaction ‘SCC4’ on your SAP system.

 

SAP application server

The following connection parameters are needed:

  • SAP Application server: Determine the server name of the application server. This consists of either an IP, a domain or a host name. If you do not have this information, contact your SAP manager or open your SAP Logon. Right-click on a connection to the target system > Properties. There you can read the required information (see screenshot).
LogonSAPdata_en

Alternatively, you can log in with SAP Logon. Click above on System > Status... This opens a window. Click on the “More Kernel Info (Shift + F5)” button at the bottom right. Under “System Information”, you will see the IP address of your SAP system.

  • SAP-System number: Determines the two-character instance number of your application server. If you do not have this information, contact your SAP manager or enter transaction "SM51". The SAP system number corresponds to the instance number in the above screenshot.
  • SAP system name (r3name): The system ID of your SAP system. If you do not have this information, please contact your SAP manager.
  • SAP Client: The client ID consists of a three-digit number. If you do not have this information, please contact your SAP manager or enter transaction “SCC4” on your SAP system.
  • SAP Router String: A route string describes the stations of a connection required between two hosts and has the following syntax:

/H/host/S/service/W/pass

Info:

/H/ indicates the host name
/S/ is used for specifying the service (port); it is an optional entry, the default value is 3299
/W/ indicates the password for the connection between the predecessor and successor on the route and is also optional (default is “”, no password)

The router string corresponds to the SAProuter String in the above screenshot.