Overview

SAP Connections provide all the SAP server information necessary for Universal Controller to execute an SAP Task on an SAP system. These instructions assume the user is familiar with SAP.

Creating an SAP Connection

Step 1	From the Agents & Connections navigation pane, select System > SAP Connections. The SAP Connections list displays. Below the list, SAP Connection Details for a new SAP Connection displays.
Step 2	Enter / select Details for a new SAP Connection, using the field descriptions below as a guide. Required fields display an asterisk ( * ) after the field name. Default values for fields, if available, display automatically. To display more of the Details fields on the screen, you can either: Use the scroll bar. Temporarily hide the list above the Details. Click the New button above the list to display a pop-up version of the Details.
Step 3	Click a Save button. The SAP Connection is added to the database, and all buttons and tabs in the SAP Connection Details are enabled.

Note

To open an existing record on the list, either:

Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)
Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.
Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).

SAP Connection Details

The following SAP Connection Details is for an existing SAP Connection. See the field descriptions, below, for a description of all fields that display in the SAP Connection Details.

For information on how to access additional details - such as Metadata and complete database Details - for SAP Connections (or any type of record), see Records.

SAP Connection Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the SAP Connection Details.

Field Name	Description
Details	This section contains detailed information about the SAP Connection.
Name	Name (maximum 40 alphanumeric characters) used within the Controller to identify this resource. It is the responsibility of the user to develop a workable naming scheme for resources.
Version	System-supplied; version number of the current record, which is incremented by the Controller every time a user updates a record. Click the Versions tab to view previous versions. For details, see Record Versioning.
Description	Description of this record. Maximum length is 255 characters.
Member of Business Services	User-defined; Allows you to select one or more Business Services that this record belongs to. (You also can Check All or Uncheck All Business Services for this record.) You can select up to 62 Business Services for any record type, and enter a maximum of 2048 characters for each Business Service. If the Business Service Visibility Restricted Universal Controller system property is set to true, depending on your assigned (or inherited) Permissions or Roles, Business Services available for selection may be restricted.
Connection Type	Type of SAP connection. Options: Specific Application Server Connection to a specific SAP application server (type A RFC connection). Load Balancing Connection to an SAP system where the application server is determined by load balancing (type B RFC connection).
Application Server	If Connection Type = Specific Application Server; ASHOST parameter; Host name of an SAP application server. If the path to the server goes through SAP routers, prefix the host name with the SAP router string.
Client	CLIENT parameter; SAP Client number. This field is not required if Connection Type is Load Balancing. Note Originally, the Client field was not available for a Load Balancing Connection Type; therefore, you may have applied the CLIENT parameter on each SAP task as an SAP Command option or used a "destination" connection via the `sapnwrfc.ini` file. For this reason, the Client field is optional when the Connection Type is Load Balancing even though. normally, you would want to specify it.
System Number	If Connection Type = Specific Application Server; SYSNR parameter.
Gateway	If Connection Type = Specific Application Server; GWHOST parameter; Host name of the SAP gateway.
Gateway Service	If Connection Type = Specific Application Server; GWSERV parameter; Service name of the SAP gateway.
System ID	If Connection Type = Load Balancing; R3NAME/SYSID parameter; System ID of the SAP system to which you want to connect.
Message Server	If Connection Type = Load Balancing; MSHOST parameter; Host name of the message server.
Group	If Connection Type = Load Balancing; GROUP parameter; Application servers group name.
Use Symbolic Names	If Connection Type = Load Balancing; USE_SYMBOLIC_NAMES parameter; Specification for whether or not to use symbolic service names. Options: No Yes
Single Sign-On Ticket	Path to a file that contains the actual value for the MYSAPSSO2 parameter.
X.509 Certificate	Path to a file that contains the actual value for the X509CERT parameter.
SAProuter	SAPROUTER parameter.
SNC Options	This section contains detailed information about the SAP Secure Network Communications (SNC).
SNC Mode	SNC_MODE parameter; Specification for whether or not SNC is activated. Options: Off On
SNC Library	SNC_LIB parameter; Path to the third-party security library for SNC.
SNC My Name	SNC_MYNAME parameter; Token/identifier representing the external RFC program.
SNC Partner Name	SNC_PARTNERNAME parameter; Token/identifier representing the back-end system.
SNC Quality of Protection	SNC_QOP parameter; Quality of protection level. Options: Authentication Only Integrity Protection Privacy Protection Default Protection Maximum Protection
SNC Single Sign-On	SNC_SSO parameter; Specification for whether or not to use single sign-on for SNC. Options: No Yes
Buttons	This section identifies the buttons displayed above and below the SAP Connection Details that let you perform various actions.
Save	Saves a new SAP Connection record in the Controller database.
Save & New	Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.
Save & View	Saves a new record in the Controller database and continues to display that record.
New	Displays empty (except for default values) Details for creating a new record.
Update	Saves updates to the record.
Copy	Creates a copy of this SAP Connection, which you are prompted to rename.
Delete	Deletes the current record.
Refresh	Refreshes any dynamic data displayed in the Details.
Close	For pop-up view only; closes the pop-up view of this SAP Connection.
Tabs	This section identifies the tabs across the top of the SAP Connection Details that provide access to additional information about the SAP Connection.
SAP Tasks tab	Lists all SAP tasks that use this SAP connection.
Versions tab	Stores copies of all previous versions of the current record. See Record Versioning.