SapServer Configuration

The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

SapServer Configuration Settings

EnableClassicRFCTrace: Whether to enable trace files when working with the Classic RFC SDK.

This setting controls whether trace files are generated by the Classic RFC SDK. If set to True trace files will be generated by the RFC SDK in the current working directory. The default is False.

UseClientConnection: Use a client connection to retrieve function meta data.

If true (default), you will need to set the appropriate fields in SapConnection

If connecting using the NetWeaver SDK, then the client is necessary and this config will have no effect, even if this config is set to false. If connecting using the Classic SDK, the client connection is not necessary, but you must set parameters and tables meta data without getting from the server by the component.

Group: The logon group.

This specifies the logon group to be used to when using load balancing.

MessageServer: Service name of load balancer service.

This should be set to the service name of the load balancer service if using load balancing. In most cases this does not need to be set.

SncLibPath: The external security product's library.

This should contain the path to the external security product's library.

SncMode: The SNC activation indicator.

If set to true, the component will send the SNC parameters. By default, this is set to false.

SncName: The Initiator's SNC name.

The SNC name for the machine making the connection.

SncPartnerName: The communication partner's SNC name.

This should contain the SNC name of the SAP system the component is connecting to.

SncQop: The quality of protection level.

This indicates the quality of the protection level. The SAP server should list the data protection levels it will accept. Valid values are as follows:


Value	Meaning
-1 (default)	Not set
1	Apply authentication only. No data protection is provided.
2	Apply integrity protection. The data is signed and then verified upon receipt.
3	Apply privacy protection. The data is signed and encrypted, then decrypted and verified upon receipt.
8	Apply the default protection
9	Apply the maximum protection

SystemID: The system ID of the SAP system.

This contains the R3NAME (System ID/name of the SAP system) and should be used when connecting to a message server for load balancing.

A system ID is always a string with a maximum of three letters. You can find out the correct SAP System ID (SID) by looking at the "System ID" property of the system's entry in SAP Logon.

Base Configuration Settings


	GUIAvailable: Tells the component whether or not a message loop is available for processing events. In a GUI-based application, long-running blocking operations may cause the application to stop responding to input until the operation returns. The component will attempt to discover whether or not the application has a message loop and, if one is discovered, it will process events in that message loop during any such blocking operation. In some non-GUI applications an invalid message loop may be discovered that will result in errant behavior. In these cases, setting GuiAvailable to false will ensure that the component does not attempt to process external events.
	UseBackgroundThread: Whether threads created by the component are background threads. If set to True, when the component creates a thread the thread's IsBackground property will be explicitly set to True. By default this setting is False.
	UseManagedSecurityAPI: Tells the component whether or not to use the system security libraries or a managed implementation. By default the component will use the system security libraries to perform cryptographic functions. This means calls to unmanaged code will be made. In certain environments this is not desirable. To use a completely managed security implementation set this setting to True. Setting this to True tells the component to use the internal managed implementation instead of using the system's security API. Note that when this value is set the product's system dll is no longer required as a reference, as all unmanaged code is stored in this file.