Connecting to SAP Systems
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
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
For better performance, you should connect to the Message Server of the SAP instance.
End of the recommendation.
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 allowsyou 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
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 ordisable 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 oneSAP 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 thatisolation 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 boxand 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 ina 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
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 RelatedObjects 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.
Granting and Revoking System Privileges
Granting or Revoking Object Privileges
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:
Choose Environment → SAP Systems in the Navigation bar.
Choose New from the context menu.
On the SAP System tab, enter a Name, Connect String, and a Time zone,
On the XBP tab, fill in Client Number, Username, password, and check Default Client
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
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 sectionof 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.
Choose Environment → SAP Systems in the Navigation bar.
Choose the New button and enter the information below (listed per tab)
Choose Environment → Process Servers
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 |