SAP Connections

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.