sapproxy.ini

Parameters

The sapproxy.ini file contains two sections and a number of parameters, which are defined below. The two sections are:

• control
• Proxy

Control

The [control] section of the sapproxy.ini file is where you will define how many servers you will be connecting to. A sample [control] section of the sapproxy.ini file appears as follows:

The parameter contained in the [control] section of the sapproxy.ini file is explained as follows:

proxycount

This parameter defines how many SAP ERP systems the GuiXT Server will connect to. In our example, there is only a single SAP system involved. Client sites may have up to four proxies.

Proxy

The [ProxyX] section of the sapproxy.ini file is where you will inputy the actual connection parameters of the server. The [X] is a number indicating the proxy number for each connection. There must be a [ProxyX] section for each server specified in the [control] section. In other words, if you set proxycount=4 in the [control] section, you must have four [Proxy] section. These will be numbered as follows:

• [Proxy1]
• [Proxy2]
• [Proxy3]
• [Proxy4]

A sample [ProxyX] section of the sapproxy.ini file is displayed in the example below.

[control]
proxycount=1

[Proxy1]
ListenPort=3200
TargetServer=test
TargetServerPort=3200
ReservedPhysMem=25
GuiXT = 10
Options= -logtraffic:on -tracetraffic:on

The parameters contained in the [Proxy] section of the sapproxy.ini file are as follows:

ListenPort

This is the port that the GuiXT Server will listen to for information from SAP. This should be the same as the TargetServerPort described below.

TargetServer

This is where the SAP ERP system is specified. Users can either use a name, as in the preceding example (eg. ‘juneau’) or a connection string. For more information about connection strings, please see the Connection Strings section.

TargetServerPort

This is the system ID of the SAP ERP system to which the GuiXT Server will connect. The system ID is preceded by the number ‘32’. So if the SAP ERP system ID is ‘00’, the TargetServer number will be ‘3200’. A sample entry is shown below.

ReservedPhysMem

This entry designates the amount of actual physical memory that will be verified for any subsequent launches of the sapproxy.exe. Sapproxy always checks the memory before launching and norm,ally requires a large amount of free memory to launch. This is a useful option for users with smaller or more limited systems, as it tells Sapproxy that only the specified amount of memory needs to be checked in order to luanch sapproxy. A sample entry specifying 25M of memory is shown below.

ReservedPhysMem=25

GuiXT

This is where you will specify whether or not the GuiXT instance is or is not WS. If the implementation is not WS, the number will be ‘1’. If it is WS, the number will be ‘10’.

Other Options

In addition to the parameters introduced above, the sapproxy.ini file can contain other parameters as well. These are as follows:

Trace options

You can add trace options to the sapproxy.ini file. Trace options assist in debugging GuiXT Server. The syntax is as follows:

options=-logtraffic

This option is a Boolean that can be set to either 'on' or 'off'. Logtraffic will trace each and every network packet, writing the results as a log file. Logs will use the naming convention 'TL_*'. The 'logtraffic' option is added to the Sapproxy.ini under the keyword 'Options=logtraffic:on/off'. The default setting for logtraffic is 'off'.

To add trace options, please do the following:

1. Open the Sapproxy.ini in a supported text editor. We usually use Notepad.
2. Add the following keyword to the Sapproxy.ini file: options=-logtraffic:on. This keyword will trace each and every network packet, writing the results as log files. The logs will use the naming convention: TL_*
3. Once the log files are generated, send them to Synactive for review by a Support specialist.

Easy Access On/Off

This flag turns off the automatic addition of the NO_EASYACCESS flag. The NO_AEASYACCESS flag is used to eliminate the easy access bit in the DIAG. The default setting is 'on'. The option is written as shown below

-add_no_easyaccess:off 

ITS On/Off

This is used to disable the removal of the ITS flag. ITS was the predecessor to NetWeaver. GuiXT was able to run in ITS and this flag was used to prevent the flag from being removed. Since ITS is no longer common, this flag is unlikely to be used in most scenarios. The default setting is 'on' and it is written as follows:

-remove_its:off 

SAPConsole On/Off

This flag is used to turn the sapconsole detection on or off, causing the appropriate handling of sapconsole packets to occur. When the flag is set to 'on' then sapconsole mode is turned on. The default setting is 'auto'. It is written as follows:

-sapconsole:off/on

SecureConnectPasskey=XXXX

This setting is used to turn on the Secure Connect feature for Liquid UI. The passphrase may be anywhere from X to XX characters long and may contain alphabetic characters, numbers, and symbols. The syntax is as shown below.

SecureConnectPasskey=<passphrase>

To use this setting, please do the following.

1. On the GuiXT Server, open the sapproxy.ini file and type in the following: SecureConnectPasskey=test.
2. Savwe your changes and close the sappro0xy.ini file.
3. On your iOS device, open the Connection List and select the connection you wish to use.
4. In the 'Secure Connect' filed, type the same passphrase you entered on the GuiXT Server.
5. Click the Save button to save your changes.
6. In the COnnection List, click Done.
7. The connection will launch securely. YOu can tell that the connection is secure because the SAP system ID will be green.

Swap Easy Access On/Off

This option is used to turn off the automatic swapping of 'Easy Access'. The default setting is 'on'. THe option is written as shown below:

-swap_easyaccessoff

Send Direct Return On/Off

This option turns on the process of sending screens from server to client during ‘Input Script’ processing. The default state is 'off' but please note that this flag cannot be turned on if a given connection is determined to be from sapconsole. THis option is written as follows:

-senddirectreturn:on

Trace Connections

This option is used to trace and display information about each connection. The default setting is 'off'. THe option is written as shown below:

-traceconnections:on

Limit Trigger

This option is used to turn off the limit trigger. This is explained in more detail in the Server Debugging section. The option is written as follows:

-limit_trigger:off

Log Traffic

This option is used to log each packet sent and received by the server. The default setting is 'off'. The option is written as in the example below:

-logtraffic:on

Trace Traffic

This option is used to trace and log each network packet. The log can then be used to replay back the R/3 network flows. The default setting is 'off'. The option is written as follows:

-tracetraffic:on

Progress Indicator

This option turns off the progress indicator during Input Script processing. The default setting is 'on', and it iw written as shown below:

-progress_indicator:off

Async RFC

This option is used to suppress addition of this flag to the SAP application server. If active, the SAP server will send all RFCs and wait for response. It is written as follows:

-async_rfc:off

Remove Menu Entries

This option will remove menu entries sent to client when it is turned on. It is used only for sapconsole mode and the default setting is 'off'. It iw written as in the example below:

-removemenuentries:off

_INTR_

When this entry is included in the sapproxy.ini file, the GuiXT Server will send a blank screen to the SAP GUI client. The syntax is as follows:

TargetServer=_INTR_

This setting means that you will not have a live connection to a SAP server, similar to how the Offline product works. Also as in Offline, you can run scripts to create controls and other functions on this screen. This setting is useful for creating custom controls or functions without sending data to SAP. Click the X in the upper right corner of this screen to turn it off.

The _INTR_ entry takes a single optin, as follows.

• app: This option designates the dynpro. In the example, it is the ZGUIXT custom dynpro.

Beginning with the 3.4.xxx.0 release of GuiXT WS Server, the _INTR_ syntax has changed. The original syntax is shown below.

TargetServer=__INTR__ , app=ZGUIXT

From the 3.4.xx.0 release, the syntax will be as follows. Any new options will be included in the list of options.

TargetServer=__INTR__ , options=-app:ZGUIXT -n:1001 -sid:PRD 

Note: The two syntaxes cannot be mixed - you must use one or the other. If both are used, the 'options' syntax will always take precedence.

The options for the _INTR_ entry are as follows.

• -app: This designates the dynpro name.
• -n: THis designates the dynpro number.
• -sid: This designates the database name.