Show TOC

Procedure documentationConnecting to SAP Systems Locate this document in the navigation structure

 

SAP System definitions describe the characteristics of a single SAP System. It is possible to create more than one SAP System definition to connect to more than one SAP System. The SAP System definition is used to:

  • Schedule/monitor SAP jobs via XBP, JXBP and BW-SCH interfaces.

  • Synchronize monitoring and alerting data with the SAP System via XAL and XMW interfaces.

  • Synchronize CCMS events, requires XBP 3.0.

Actions

SAP Systems support the following actions:

Action

Description

Export

Export the SAP System into a CAR file

Maintain Objects

Allows you maintain ABAP program variants, process chains, mass activities and set load-specific properties on the application servers

Edit

Edit the SAP System

Edit Security

Edit the security of the SAP System

Delete

Delete the SAP System

Duplicate

Make a copy of the SAP System to create a similar one

Expand All

Expand all SAP Systems in the current filter

New

Create a new SAP System

Filter > New Filter

Create a new SAP System filter

Filter > Edit Filter

Edit current SAP System filter

Filter > Delete

Delete current SAP System filter
Configuration

The configuration for each SAP System is managed through the   Environment → SAP Systems   view. No standard SAP Systems are provided with SAP CPS.

For each SAP System, you can configure the following:

  • General settings like name and RFC connect string.

  • One or more client connections for the XBP interface.

  • Zero or more job control rules.

  • Zero or one client connection for the XAL interface.

  • Zero or one client connection for the XMW interface.

  • Multiple Event Synchronization rules (requires XBP 3.0)

  • One JXBP connection (in isolated mode, you cannot have two or more of XBP, PI/XI or JXBP connections in the same SAP CPS object; see the license restrictions below)

  • One PI/XI connection (in isolated mode, you cannot have two or more of XBP, PI/XI or JXBP connections in the same SAP CPS object; see the license restrictions below)

For most interfaces a username, password and client number are required. If you do not set an XBP account, SAP CPS will not be able to connect to the ABAP stack of the SAP instance.

Likewise, you need to set up accounts in the JAVA stack for JXBP (Java Scheduler connectivity) and PI/XI (SAP Communication Channel connectivity).

Connection String

The connection string allows you to specify a subset of the settings you can specify in other SAP client tools:

  • TYPE - (optional) The type of SAP system to connect to, only R3 issupported.

  • ASHOST - The application server host to conect to, this should be the message server.

  • GROUP - (optional) Name of the SAP server group. This is a group of application servers in a load balancing connection. The default value is PUBLIC.

  • GWHOST - (optional) The gateway host to use for the connection.

  • MSHOST - The message server host of the SAP instance.

  • R3NAME - The SID of the SAP instance.

  • SYSNR - The system number of the SAPO instance, it is usually the last two numbers of the port.

  • TRACE - allows you to trace the RFC session, should be left on 0 unless SAP Support Services request you to change this value.

Note Note

Although it would be valid to specify a username and password as well as other settings, SAP CPS will discard them.

End of the note.

The following two combinations are frequently used:

Connection to a message server

MSHOST=<MS host> R3NAME=<SID> GROUP=<group>

Connection to a central or dialogue instance

ASHOST=<CI/DI-hostname> SYSNR=<Sys-Number> TRACE=0

Recommendation Recommendation

For better performance, you should connect to the Message Server of the SAP instance.

End of the recommendation.

Note Note

If you specify the Application Server Host in the connection string, you must not specify a Message Server hostname or the R3NAME.

End of the note.

When you create an SAP System definition, a process server and queue of the same name are automatically created with the required services, along with a queue provider that links the queue to the process server. When you delete an SAP System, the process server and queue are automatically removed. The process server and queue will share the same application when you create the SAP System, if you edit the SAP System later, you should change the application on the queue and scheduler manually, this allows you to easily export the SAP System via the application. Export requires the Import/Export Module which in turn requires the Module.ImportExport license key.

When you edit an SAP System, the required services are added automatically to the process server, so there is no need to change services on a process server.

The SAP configuration is read-only when the SAP process server starts up or is running, any changes in settings require a restart of the corresponding process server.

Note Note

By default, Mozilla Firefox browsers will offer to remember the password in the SAP System editor window. If you fill in two passwords on two tabs (XBP, XAL or XMW) in the SAP System editor, the Mozilla Firefox password manager assumes you want to change a password. You can either choose Cancel or disable Remember password for sites in the Mozilla Firefox Options/Preferences dialog, the latter is not recommended.

End of the note.

You may set a maximum setting for the number of RFC connections, please see the tuning for more information.

License Restrictions

If the license key ProcessServerService.SAP.limit license key is limited to 0, SAP CPS is in isolated mode and you can only create one SAP System with one XBP client/username combination per isolation group. If this is the case, you must create an isolation group for the SAP System, assign the isolation group to yourself and log on with that isolation group prior to creating the SAP System inside SAP CPS.

Finding SAP Systems

You can search for SAP Systems using filters and the Search SAP Systems box on the SAP Systems tab. This box is known as the intelliSearch box and located under your username on the top right-hand side of the user interface. Filters allow you to specify a list of objects with static criteria. IntelliSearch allows you to specify complex queries in a simple way using prefixes. Prefixes are used to specify which property you are searching in and have short and long syntaxes. For example, if you want to display all SAP Systems with the term import in the comment, you would use the search criteria as follows:

c:import

You can search more than one property, as follows:

c:import n:Bi

Note Note

No spaces should be entered before or after the colon (:).

End of the note.

See the Advanced Object Search for more information.

The following table illustrates the available prefixes for SAP Systems:

Prefixes

Description

n, name

searches the name property

c, com, comment

searches the comment property

d, desc, description

searches the description property

a, app, application

searches the application property
Deleting SAP Systems

You can only delete an SAP System when no other objects relate to them. For example, if there are jobs that have run in the queue of the SAP System, the SAP System cannot be deleted until all jobs that ran in that queue have been deleted. You can see all jobs that relate to the queue in Related Objects in the lower detail pane and on the show page of the queue. Besides, You cannot delete an SAP System if the process server is still running, please stop the process server before you delete the SAP System.

The table in related objects contains three columns:

  • Type - the type of object with a link to it

  • Related Object - the name of the object with a link to it

  • Used As - objects can sometimes be used in different roles

Security

Privilege

Description

SAPSystem.Create

Create SAP Systems

SAPSystem.Delete

Delete SAP Systems

SAPSystem.Edit

Edit SAP Systems

SAPSystem.View

Access SAP Systems

SAPSystem.BusinessAutomationAPI

Use the SAP Applications API

You can grant privileges on two levels, Access and Admin; a privilege granted on Admin level allows the grantee to grant the privilege to other users. These privileges can be granted system-wide, per partition or isolation group.

If you have the security module, which requires the Module.Security license key, you have an additional Security tab on the SAP System. It allows you to specify which users can access, edit, and delete the SAP System.

Prerequisites

  • A user with sufficient privileges in the Central scheduler http://<server>:<port>/scheduler.

  • The SAP R/3 connect string to the SAP System.

  • Client / username and password of the RFC user of the desired interfaces.

  • XBP versions supported in the SAP System (XBP 0.1, 1.0, 2.0, 3.0) (for parent child dependencies the report INITXBP2 must be run).

  • The SAP System must have a default client configured, please refer to the SAP documentation.

  • A license for the additional SAP process server.

  • An available shared partition if the license key System.sharedPartitions is set to a numeric value.

Procedure

To create a connection for starting jobs from SAP CPS only, without job interception, event handling, or Monitor synchronization, perform as follows:

  1. Choose   Environment → SAP Systems   in the Navigation bar.

  2. Choose New from the context menu.

  3. On the SAP System tab, enter a Name, Connect String, and a Time zone,

  4. On the XBP tab, fill in Client Number, Username, password, and check Default Client

  5. Choose Save & Close to save the changes and close the edit window.

To start ABAP programs from SAP CPS in an SAP System, refer to the following procedure:

Submitting a job or job chain

To trigger batch input sessions in an SAP System, refer to the following procedure:

Controlling Batch Input Sessions

To monitor or intercept (take control) of jobs in an SAP System, refer to the following procedure:

Intercepting SAP Jobs

To map SAP CPS events to events in an SAP System, refer to the following procedure:

Interacting with SAP Events

To map return codes to specific job log entries, refer to the following procedure:

Parsing Log Files to set Job Status of SAP Jobs

To import one or more monitors from an SAP System, refer to the following procedure:

Integrating SAP Monitors

To send SAP CPS monitoring data to an SAP System, refer to the following procedure:

Sending Monitoring Data to SAP Systems

To control communication channels in an SAP System, refer to the following procedure:

Controlling Communication Channels with SAP CPS via PI/XI

To monitor SAP CPS availability from the CEN refer to this procedure:

Monitoring SAP CPS Availability

Note Note

When you create or edit an SAP System definition, you have to restart the corresponding process server.

End of the note.

For every SAP System, at least one default client must exist.

Every SAP System created in SAP CPS requires the settings mentioned in Connection Details for Connecting to the ABAP Stack, even if you only want to synchronize monitors!

Values

For information on the necessary fields of the tabs that you need to fill-in in order to be able to connect to the ABAP stack of an SAP instance, see the Connection Details for Connecting to the ABAP Stack section of the documentation.

Example

You need to create a connection to an SAP System running SAP BW 6.40.

You have the following information:

  • The SAP R/3 connect string is: MSHOST=169.254.10.12 R3NAME=PR1 GROUP=SPACE

  • The Client is 200, username is masalan and password is masalan

  • XBP version supported is XBP 2.0 (INITXBP2 has run).

  • The default client of the SAP System is client 200.

  1. Choose   Environment → SAP Systems   in the Navigation bar.

  2. Choose the New button and enter the information below (listed per tab)

  3. Choose   Environment → Process Servers  

  4. From the context menu of the process server that belongs to the newly create SAP System connection, choose Start.

Tab

Field

Value

SAP System

Name

sapbw_prd

SAP System

Connect String

MSHOST=169.254.10.12 R3NAME=PR1 GROUP=SPACE

SAP System

Job Handling

All

SAP System

Time zone

Europe/Berlin

SAP System

Application

SAPBW

SAP System

Description

Production SAP BW system in Berlin

XBP

Client Number

200

XBP

Username

masalan

XBP

Password

******* (masalan in this example)

XBP

Audit level

0 - Change actions

XBP

SAP Language

EN

XBP

Description

Client for the XBP interface

XBP

Default Client

selected

XBP

Max RFC Connections