Cisco TEO Adapter Guide for SAP ABAP Release 2.3.3 October 2012 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
CONTENTS New and Changed Information Latest Release vii Previous Releases Preface vii vii ix Organization ix Conventions x Product Documentation xi Documentation Formats xi Guides and Release Notes xi Online Help xi Open Source License Acknowledgements xi Obtaining Documentation and Submitting a Service Request CHAPTER 1 Understanding the SAP ABAP Adapter Objects Accessing the SAP ABAP Adapter Properties xi 1-1 1-1 Viewing SAP ABAP Adapter Properties 1-2 Viewing General Information 1-2 Con
Contents CHAPTER 3 Managing SAP ABAP Targets Accessing Targets View 3-1 3-1 Creating SAP System Targets 3-2 Creating an SAP System Target—ABAP Connection 3-2 Creating an SAP System Target—ABAP+Java Connection 3-9 Managing SAP Targets 3-20 Enabling an SAP Target 3-20 Disabling an SAP Target 3-20 Deleting an SAP Target 3-21 Modifying SAP System Targets 3-21 Modifying Display Name and Description 3-21 Modifying ABAP Application Server Connection Information 3-22 Modifying SAP Database 3-24 Modifying Ja
Contents Defining an SAP ABAP Activity 5-3 Defining CCMS Performance Attribute Activity 5-6 Selecting Monitoring Tree Elements 5-8 Viewing CCMS Performance Attribute Activity Results Defining CCMS Status Attribute Activity 5-11 Viewing CCMS Status Attribute Activity Results 5-13 Defining Complete CCMS Alert Activity 5-14 Viewing Complete CCMS Alert Activity Results 5-16 Defining Correlate CCMS Alerts Activity 5-17 Viewing Correlate CCMS Alerts Activity Results 5-19 Defining Get SAP Server Down Time
Contents Cisco TEO Adapter Guide for SAP ABAP vi OL-24780-02
New and Changed Information New and changed information for the most recent releases of the Cisco TEO Adapter for SAP ABAP is as follows: • Latest Release • Previous Releases Latest Release Table 1 September 2012—Cisco TEO Adapter Guide for SAP ABAP 2.3.3 Changes Feature Location Changed adapter prerequisite for SAP .NET Chapter 1, “Understanding the SAP ABAP Connector 3.0 dll files to version 3.0.7.0 or higher.
New and Changed Information Table 2 April 2012—Cisco TEO Adapter Guide for SAP ABAP 2.3 Changes Feature Location New feature for supporting duplicate SAP system IDs “Creating an SAP Target” section in “Chapter 3, “Managing SAP ABAP Targets” Updated CCMS Alert Trigger Properties field descriptions and screen captures. Chapter 4, “Managing Triggers” Updated “Modifying a Trigger” section Updated “Defining an SAP ABAP Activity” section.
Preface The Cisco TEO Adapter for SAP ABAP provides the functionality in Tidal Enterprise Orchestrator (TEO) to support task automation and problem resolution in SAP ABAP environments. It also provides the ability to retrieve CCMS data, call remote-enabled functions, and to simplify user administration in SAP. This guide provides information on the objects supported by the SAP ABAP Adapter.
Preface Conventions This guide uses the following conventions: Convention Indication bold font Commands and keywords and user-entered text appear in bold font. italic font Document titles, new or emphasized terms, and arguments for which you supply values are in italic font. [ ] Elements in square brackets are optional. {x | y | z } Required alternative keywords are grouped in braces and separated by vertical bars.
Preface Product Documentation Documentation Formats Documentation is provided in the following electronic formats: • Adobe® Acrobat® PDF files • Online help You must have Adobe® Reader® installed to read the PDF files. Adobe Reader installation programs for common operating systems are available for free download from the Adobe Web site at www.adobe.com. Guides and Release Notes You can download the TEO product documentation from Cisco.com. Release Notes can be found on Cisco.com and the product CD.
Preface Cisco TEO Adapter Guide for SAP ABAP xii OL-24780-02
CH A P T E R 1 Understanding the SAP ABAP Adapter Objects The SAP ABAP Adapter provides the functionality in Tidal Enterprise Orchestrator (TEO) to support task automation and problem resolution in SAP ABAP environments. It also provides the ability to retrieve CCMS data, call remote-enabled functions, and to simplify user administration in SAP. This chapter provides information on accessing and viewing the objects provided by the SAP ABAP Adapter.
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Step 2 Select SAP ABAP Adapter and use one of the following methods to open the SAP ABAP Properties dialog box: • Right-click and choose Properties. • In the Details pane, click any of the hyperlinks on the General tab. Viewing SAP ABAP Adapter Properties You use the SAP ABAP Adapter properties dialog box to view the functionality provided by the adapter.
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Field Description Release date Date and time the adapter was available in the product. Install date Date and time the adapter was installed. Configuring Adapter Options Use the Options tab to configure archiving CCMS alerts as Reporting Database events. Step 1 On the SAP ABAP Adapter Properties dialog box, click the Options tab.
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Configuring Availability Monitoring Use the Availability monitor tab to specify how often the server where the adapter is installed should be contacted to monitor for availability, how many attempts should be made before sending a notification, and the DNS suffix for the server. Step 1 On the SAP ABAP Adapter Properties dialog box, click the Availability monitor tab.
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Modifying RFC Trace Settings Use the RFC Trace tab to modify the RFC trace settings for debugging SAP ABAP adapter issues. Note Step 1 It is recommended that you contact Cisco Technical Support for guidance in modifying these settings. On the SAP ABAP Adapter Properties dialog box, click the RFC Trace tab.
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Viewing Adapter Prerequisites Use the Prerequisites tab to view the objects that are required by the adapter on the TEO server. Note The SAP ABAP Adapter requires SAP .NET Connector 3.0 for .NET 4.0 on x64 version 3.0.7.0 or higher. The following dll files must be copied to the TEO server: • sapnco.dll • sapnco_utils.
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Step 2 Review the following information about the adapter prerequisites: Column Description Name Name of the required hardware or software for the supported adapter. Importance Indicates whether the item is Required or Optional for the adapter. State Indicates whether the system has the required hardware or software installed (Satisfied or Not satisfied).
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Viewing Adapter-Supported Objects Use the Provides tab to view the name and type of object provided by the adapter. Step 1 On the SAP ABAP Adapter Properties dialog box, click the Provides tab.
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Viewing Adapter History Use the History tab to view a history of changes that have been made to the adapter. Step 1 On the SAP ABAP Adapter Properties dialog box, click the History tab. Figure 1-8 Step 2 SAP ABAP Adapter Properties—History Tab View the following information: Field Description Created by Display only. User name of the person who created the object. Created time Display only.
Chapter 1 Understanding the SAP ABAP Adapter Objects Viewing SAP ABAP Adapter Properties Cisco TEO Adapter Guide for SAP ABAP 1-10 OL-24780-02
CH A P T E R 2 Managing SAP Runtime Users Many operating systems and application activities require a user security context for proper execution. The Runtime Users feature is used to create a runtime user record to store the information about the user security context. You assign runtime users to a process or activities within a process to specify the proper security context to be used to execute the process or activity. The SAP ABAP Adapter provides the SAP User user credentials.
Chapter 2 Managing SAP Runtime Users Accessing Runtime Users View Accessing Runtime Users View Use the Definitions—Runtime Users view to display the credentials of the runtime users and to specify new runtime user credentials, update the credentials of users, or delete users. Figure 2-1 Definitions—Runtime Users View Creating an SAP User The SAP User holds the credentials (user name and password) that will be used to connect to an SAP target (application server or system).
Chapter 2 Managing SAP Runtime Users Creating an SAP User Figure 2-2 Note Step 2 New SAP User Properties—General Tab The Required Value icon displayed on a tab or page indicates that the field is required and is either missing a value or contains an invalid value. Specify the information in the following text fields: Field Description Display name Enter the name to be assigned to the user account. This is the name that will display in the Runtime Users view. Type Display only. Type of object.
Chapter 2 Managing SAP Runtime Users Managing SAP Runtime User Accounts Step 3 Click OK to close the dialog box. Managing SAP Runtime User Accounts Use the Definitions—Runtime Users view to manage the SAP Runtime User records. You use the Runtime User Properties dialog box to modify the SAP User accounts, view the objects in the product that use the user account, and view a history of changes made to the account.
Chapter 2 Managing SAP Runtime Users Managing SAP Runtime User Accounts Step 4 Field Description User name Enter the user name assigned to the SAP user account that will be used to connect to the SAP targets. Password Check the check box and enter a new password for the user account. Client Enter the SAP client number assigned to the user account. Description Optional. Enter a text description of the runtime user account. Click OK to close the dialog box.
Chapter 2 Managing SAP Runtime Users Managing SAP Runtime User Accounts Step 5 Click OK to close the dialog box. Viewing User History Use the History tab to view a history of changes that have been made to the SAP User runtime user accounts. Step 1 In the Definitions view, click Runtime Users to display defined runtime users in the Runtime Users pane. Step 2 Double-click the [Runtime User] record, or right-click and choose Properties.
Chapter 2 Managing SAP Runtime Users Managing SAP Runtime User Accounts Step 4 To view the audit history for the object, right-click the item in the list box and choose Properties. Step 5 Click OK to close the dialog box. Deleting a Runtime User Account Use the Definitions—Runtime Users view to delete an SAP User runtime user account. Step 1 In the Definitions view, click Runtime Users to display the defined runtime users in the Runtime Users pane.
Chapter 2 Managing SAP Runtime Users Managing SAP Runtime User Accounts Cisco TEO Adapter Guide for SAP ABAP 2-8 OL-24780-02
CH A P T E R 3 Managing SAP ABAP Targets The SAP targets enable you to run a process on a specific SAP application server, SAP system, or SAP database. The targets can be defined once and reused in several processes. This chapter guides you through accessing, creating and managing SAP targets.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Creating SAP System Targets Before you can create or run processes in your SAP environment, you must create the targets on which the processes will run. You use the New SAP System wizard to create SAP system targets, SAP application server targets and SAP database targets. This section guides you through creating an SAP System target and the SAP database target.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-3 System Setup The System Setup panel is used to specify the SAP system name, the type of system components to be configured, and the monitoring level for the SAP system. Note The Required Value icon displayed on a tab or page indicates that the field is required and is either missing a value or contains an invalid value. Note You can only create one target for each SAP system.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Field Description Monitor as production system This check box is checked by default. Certain processes will run only on production systems. If you want to monitor the system as a non-production system (development or sandbox), uncheck the check box. Organization Enter the group or organization within the company that owns the target.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Field Logon group Description Choose this option to establish a connection using a logon group, which contains a group of SAP system instances. When a user logs on to a logon group, the message server directs the users to the server of this group that currently has the lightest load. Specify the information in the following fields: Router string (optional) • System ID—Enter the SAP system ID (SID).
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-5 Server Availability The Server Availability panel is used to specify the SAP application servers that you want to monitor for availability and the ability to log in a user. Step 7 Step 8 Specify the following information: Field Description Servers available for monitoring All detected servers are checked by default. Verify that the check box next to each server that you want to monitor is checked.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-6 Note Database Connection The fields that display on this panel depend on the type of database that is being configured. Step 9 Choose the Database type from the drop-down list to display the fields for the specific type of database. Step 10 Specify the information for the type of database that is being configured. The fields that display depend on the database type.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Field Description Default timeout for activities (seconds) Enter the number of seconds before the activity times out. The default timeout period is 120 seconds. Default runtime user Choose the user account that contains the credentials to connect to the database from the drop-down list. Connection string Step 11 To view the properties for the selected runtime user, click the Properties tool.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Creating an SAP System Target—ABAP+Java Connection You can create a target for an SAP system that uses both an ABAP and Java connection to the SAP application servers. This section guides you through creating this type of target and configuring the SAP database that is associated with the SAP system. Note Step 1 The SAP Java Adapter requires certain SAP Java libraries, which are available on the SAP Installation CD.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-9 System Setup The Required Value icon displayed on a tab or page indicates that the field is required and is either missing a value or contains an invalid value. Note The System Setup panel is used to specify the SAP system name, the type of system components to be configured, and the monitoring level for the SAP system. You can only create one target for each SAP system.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Field Description Monitor as production system This check box is checked by default. Certain processes will run only on production systems. If you want to monitor the system as a non-production system (development or sandbox), uncheck the check box. Organization Enter the group or organization within the company that owns the target. Note Step 4 Click Next.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Field Logon group Description Choose this option to establish a connection using a logon group, which contains a group of SAP system instances. When a user logs on to a logon group, the message server directs the users to the server of this group that currently has the lightest load. Specify the information in the following fields: Router string (optional) • System ID—Enter the SAP system ID (SID).
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-11 Server Availability The Server Availability panel is used to specify the SAP application servers that you want to monitor for availability and the ability to log in a user. Step 7 Step 8 Specify the following information: Field Description Servers available for monitoring All detected servers are checked by default. Verify that the check box next to each server that you want to monitor is checked.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-12 Database Connection Step 9 Choose the Database type from the drop-down list to display the fields for the specific type of database. Step 10 Specify the information for the type of database that is being configured. The fields that display depend on the database type. Field Description Server Enter the name of the SAP application server where the database resides.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Field Description Default runtime user Choose the user account that contains the credentials to connect to the database from the drop-down list. Connection string Step 11 • To view the properties for the selected runtime user, click the Properties tool. • To create a new runtime user, click New > Runtime User.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-14 Step 13 Step 14 New SAP Java Application Server Wizard—General Information Panel Specify a name and description for the Java server in the following text fields: Field Description Display name Enter the name of the server that will be displayed in the Targets pane. Description Enter a text description for the server. Click Next.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Use the JMX Connection panel to specify the connection information to connect to the Java application server. You connect to the Java application server using a JMX connection. You can also configure to connect to the application server using a Telnet connection.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-16 Step 17 New SAP Java Application Server Wizard—Telnet Connection Specify the Telnet connection information for connecting to the Java application server: Field Description Telnet port Enter the Telnet port number used to connect to the Java application server. Use credentials of the following runtime user Choose the default runtime user that contains the credentials to connect to the target from the drop-down list.
Chapter 3 Managing SAP ABAP Targets Creating SAP System Targets Figure 3-17 Completing the New SAP Java Application Server Wizard Step 19 Verify that the information is correct and click Finish to add the SAP Java application server. Step 20 After adding the Java application server, click Next on the Java Connection panel. Figure 3-18 Step 21 Completing the New SAP System Wizard Verify that the information is correct and click Finish to complete the procedure.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Managing SAP Targets Use the Definitions—Targets view to manage the SAP targets. From this view, you can enable and disable the SAP target, delete the SAP target, and view and modify the SAP target properties. Enabling an SAP Target A target is enabled by default after it is created. If a target is manually disabled, it must be enabled before it is available for execution.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Deleting an SAP Target Before deleting a target, open the SAP Target Properties dialog box and click the Used By tab to view where objects are being used by the target. This ensures that deleting the target does not affect any processes or activities. Step 1 In the Definitions—Targets view, right-click the SAP System target and choose Delete. Figure 3-19 Step 2 Confirm Delete Click Yes to confirm the deletion.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Step 3 Use the General tab to view or modify the following information: Field Description Display name Name of the SAP system that displays in the Targets pane. Type Display only. Type of target. Owner User name of the owner of the target. This is typically the person who created the target. Click the Browse tool to change the owner. Organization Name of the company that supports the target.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Figure 3-21 Step 4 Step 5 SAP System Properties—ABAP Tab Use the ABAP tab to perform any of the following tasks: • To view or modify the properties of the current SAP ABAP Connection target (SAP ABAP application server), click the Properties tool. See Modifying an SAP ABAP Connection Target, page 3-32 for instructions.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Modifying SAP Database You can modify the connection information for the database that is associated with the SAP system, including specifying a different database for the SAP system, modifying the properties of the current database, or creating a new database. Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the SAP System target, or right-click and choose Properties.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Modifying Java Application Server Connection Information You can modify the Java application server or change the default runtime user record that connects to the application server. Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the SAP System target, or right-click and choose Properties. Step 3 On the SAP System Properties dialog box, click the Java Connection tab.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Figure 3-24 b. SAP Java Application Server Properties—Connection Tab Use the Connection tab to modify the following JMX connection information: Field Description Application server IP address or name of the SAP Java application server. JMX Connection JMX port JMX port number used to connect to the Java application server.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Step 5 Click the Telnet tab to modify or enable a Telnet connection to the SAP Java application server. Figure 3-25 c.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Viewing Member Of Properties You can view the target groups to which a target belongs using the Member Of tab on the SAP System Properties dialog box. Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the SAP System target, or right-click and choose Properties. Step 3 On the SAP System Properties dialog box, click the Member Of tab.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Viewing Extended Properties You can view the list of extended target properties defined for a specific target type using the Extended Properties tab on the SAP System Properties dialog box. Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the SAP System target, or right-click and choose Properties.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Viewing Used By Properties You can view the objects that are directly associated with the selected target (for example, an SAP system or process) using the Used By tab on the SAP System Properties dialog box. Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the SAP System target, or right-click and choose Properties.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Viewing Target History You can view the history of changes that have been made to the target using the History tab on the SAP System Properties dialog box. Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the SAP System target, or right-click and choose Properties. Step 3 On the SAP System Properties dialog box, click the History tab.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Modifying an SAP ABAP Connection Target Use the Definitions—Targets view to display and modify the SAP ABAP Connection target. Modifying Display Name and Description Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the SAP ABAP Connection target, or right-click and choose Properties.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Step 4 Field Description Description Text field for entering information that describes the target. Enabled Check or uncheck the check box to enable or disable the target. The check box is checked by default to indicate the target is enabled. Click OK to save your changes and close the dialog box.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Step 4 Use the Connection tab to view or modify the following connection information:. Field Description Connection using Choose the connection method from the drop-down list. The fields that display depend on the connection method selected. Application server Choose this option to connect to the SAP system using the SAP application server connection information.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Modifying Server Monitoring TEO monitors each ABAP application server for availability and the ability to log in a user. If a server becomes unavailable, an incident is sent to the appropriate person. It also sends incidents when multiple servers become unavailable, which may indicate a network outage.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Field Deselect All Override Adapter Settings Step 5 Description If all the check boxes are checked and you want to clear all of them, click Deselect All. This check box is checked by default.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Figure 3-33 Step 4 SAP ABAP Connection Properties—Options Tab Use the Options tab to modify any of the following information: Field Description Enable discovery and alert monitoring Check the check box to enable discovery of SAP servers and alert monitoring. Uncheck the check box if you do not want TEO to perform discovery and polling.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Field Delay discovery Description Default is set to 0. Specify the value and time unit to delay discovery of MTEs. Using this option reduces the maximum process memory usage and forces a better distribution of load by delaying discovery of SAP systems, which have a large number of MTEs. There is an increase in TEO CPU utilization and memory during SAP discovery. Ignore discovery errors This check box is checked by default.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Figure 3-34 Step 3 Select CCMS Monitor On the Select CCMS Monitor dialog box, click the MTE in the list and click OK to add it to the list of CCMS Monitors that will be used for discovery. Viewing Member Of Properties You can view the target groups in which a target is a member using the Member Of tab on the SAP ABAP Connection Properties dialog box.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Figure 3-35 SAP ABAP Connection Properties—Member Of Tab Step 4 In the list box, view the target groups that the target is a member. Step 5 To view the properties of a specific target group, right-click the target group and choose Properties. Step 6 Click OK to close the dialog box.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Figure 3-36 SAP ABAP Connection Properties—Extended Properties Tab Step 4 In the list box, view the extended target properties that are assigned to the target. Step 5 To modify a target property, right-click and choose Edit. Note Step 6 For additional information on Extended Target Properties, see the Tidal Enterprise Orchestrator Reference Guide. Click OK to close the dialog box.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Figure 3-37 SAP ABAP Connection Properties—Used By Tab Step 4 Use the Used By tab to view the objects that used the target. Step 5 To view the properties of a specific object, right-click the object and choose Properties. Step 6 Click OK to close the dialog box. Viewing Target History You can view the history of changes that have been made to the target using the History tab on the SAP ABAP Connection Properties dialog box.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Figure 3-38 SAP ABAP Connection Properties—History Tab Step 4 Use the History tab to view the changes that have been made to the target. Step 5 To view the audit history for a specific action, right-click and select Properties. Step 6 Click OK to close the dialog box.
Chapter 3 Managing SAP ABAP Targets Managing SAP Targets Cisco TEO Adapter Guide for SAP ABAP 3-44 OL-24780-02
CH A P T E R 4 Managing Triggers Triggers are used to determine how or when the process will be executed. The SAP ABAP Adapter provides the following triggers that can be used to execute a process: • CCMS Alert—This trigger is used to execute a process when a CCMS alert is generated. • SAP Server Down—This trigger is used to execute a process when a specific server is down. This chapter guides you through accessing, creating and managing triggers.
Chapter 4 Managing Triggers Accessing Trigger Properties Figure 4-1 Process Properties—Triggers Tab Information about the triggers display in the following columns: Column Description Display name Name assigned to the trigger. Target Name of the target that is executed by the trigger. Step 3 On the Triggers tab, select the trigger and click Properties. Step 4 The Properties dialog box for the specific trigger type displays.
Chapter 4 Managing Triggers Creating CCMS Alert Trigger Creating CCMS Alert Trigger Use the CCMS Alert trigger to specify the properties of the monitoring tree element (MTE) that must be met before an alert is generated. When the specified CCMS alert is generated, the process is executed. Step 1 On the Definitions—Processes view, use one of the following methods to open the Process Editor: • Select an existing process, right-click and choose Edit.
Chapter 4 Managing Triggers Creating CCMS Alert Trigger Figure 4-3 Step 6 CCMS Alert Properties—CCMS Alert Tab On the CCMS Alert tab, specify the following information: Field Description Monitoring Tree Element Click Browse to connect to the SAP system and select the monitoring tree element to auto-populate the fields on this dialog box. You can also enter the information in the text fields. Note Step 7 Click the Insert Wildcard wildcard in the field.
Chapter 4 Managing Triggers Creating CCMS Alert Trigger Figure 4-4 Step 8 CCMS Alert Properties—Target Tab On the Targets tab, specify the target on which to monitor for events that will trigger the process: Field Description Monitor on this target Click this radio button and then click the Browse tool to launch the Select Targets dialog box and select the specific target to be monitored for the event. To view the properties for the target, click the Properties tool.
Chapter 4 Managing Triggers Creating CCMS Alert Trigger Step 9 Click the Conditions tab. Figure 4-5 Step 10 CCMS Alert Properties—Conditions Tab On the Conditions tab, specify the conditions when the trigger should execute based on an evaluation of the defined conditions. Defining a Basic Condition: a. On the Basic page, click New to add a new property for the condition that must be met. b.
Chapter 4 Managing Triggers Managing Triggers Step 11 Click OK to complete the trigger definition and close the dialog box. Managing Triggers This section provides information on managing trigger properties. Use the Triggers tab on the process Properties dialog box to manage the triggers. Enabling a Trigger A trigger is enabled by default after it is created. If a trigger is manually disabled, it must be enabled before it is available for execution.
Chapter 4 Managing Triggers Managing Triggers Deleting a Trigger Deleting a trigger, removes it completely from the process definition. Step 1 On the process Properties dialog box, click the Triggers tab. Step 2 Select the trigger in the list and click Delete.
CH A P T E R 5 Using the SAP ABAP Activities The SAP ABAP activities enable you to create processes specific to your SAP ABAP environment. When defining an activity in the process workflow, the properties pane contains property pages that are specific to the selected activity. This chapter provides instructions for defining an activity using the SAP ABAP activities, instructions for completing the property pages for each specific SAP ABAP activity, and instructions on viewing the activity results.
Chapter 5 Using the SAP ABAP Activities SAP ABAP Activities SAP ABAP Activities The SAP ABAP Adapter provides activities for managing and monitoring your SAP ABAP environment. The following table displays the activities that are available in the product. Activity Name Description CCMS Performance Attribute Defines the criteria for CCMS performance metrics. See Defining CCMS Performance Attribute Activity, page 5-6. CCMS Status Attribute Defines the criteria for the CCMS status messages.
Chapter 5 Using the SAP ABAP Activities Defining an SAP ABAP Activity Defining an SAP ABAP Activity Use the following steps to define an SAP ABAP activity in the Process Editor. The property pages that display depend on the activity. Refer to the appropriate section for instructions on completing the activity property pages. Step 1 On the Toolbox pane, navigate to the appropriate SAP ABAP section, click the activity and drag it onto the Workflow pane. The Activity Properties dialog box displays.
Chapter 5 Using the SAP ABAP Activities Defining an SAP ABAP Activity Field Description Execute on this target reference Click this radio button and then click the Reference tool to select the target reference property on which to execute the activity. You can also click the click the Browse tool to launch the Select Target dialog box and choose a specific target on which to execute the activity.
Chapter 5 Using the SAP ABAP Activities Defining an SAP ABAP Activity Step 6 Click the Knowledge Base tab to specify a knowledge base article for the activity. The following information displays: Field Description Knowledge base Knowledge base article associated with the activity. Summary Brief description of the issue. Possible Cause Explanation of the condition that may be causing the issue. Possible resolution List of actions that can be performed to attempt to resolve the issue.
Chapter 5 Using the SAP ABAP Activities Defining CCMS Performance Attribute Activity Defining CCMS Performance Attribute Activity Use the CCMS Performance Attribute activity to define the criteria for CCMS performance metrics. Step 1 On the Toolbox, click the CCMS Performance Attribute activity and drag it onto the Workflow pane.
Chapter 5 Using the SAP ABAP Activities Defining CCMS Performance Attribute Activity Figure 5-2 Step 4 Step 5 Step 6 CCMS Performance Attribute Properties—CCMS Performance Attribute Tab Click Browse to open the SAP ABAP Connection dialog box and populate the fields with pre-defined monitoring tree elements (see Selecting Monitoring Tree Elements, page 5-8) or enter the information in the following fields: Field Description Context Application server for the SAP system that will be monitored by thi
Chapter 5 Using the SAP ABAP Activities Defining CCMS Performance Attribute Activity Selecting Monitoring Tree Elements Monitoring tree elements are used to provide metrics for certain CCMS functions. Use the SAP ABAP Connection dialog box to connect to the SAP system and select monitoring tree elements. Step 1 In the Monitoring Tree area on the activity-specific page, click Browse.
Chapter 5 Using the SAP ABAP Activities Defining CCMS Performance Attribute Activity On the Select Monitoring Tree Element dialog box, a folder list of monitoring tree elements for the specified SAP system displays: Field Description Monitoring Tree Displays the list of monitoring tree elements in a folder list. Description Display only. Text description of the folder or monitoring tree element. Step 3 Expand the appropriate folder and select the monitoring tree element.
Chapter 5 Using the SAP ABAP Activities Defining CCMS Performance Attribute Activity Figure 5-5 CCMS Performance Attribute Properties—Values Tab The following information displays: Step 5 Column Description Object name Object in SAP that is being monitored by the process. Short name Short text that is assigned to the MTE class. Class name SAP class name assigned to the group of MTEs. Context Application server for the SAP system that is being monitored. SysID System ID of the MTE.
Chapter 5 Using the SAP ABAP Activities Defining CCMS Status Attribute Activity Defining CCMS Status Attribute Activity Use the CCMS Status Attribute activity to define the criteria for CCMS status messages. Step 1 On the Toolbox, click the CCMS Status Attribute activity and drag it onto the Workflow pane. Figure 5-6 Step 2 Step 3 CCMS Status Attribute Properties—General Tab On the General tab, enter the following information: Field Description Display name Name of the activity.
Chapter 5 Using the SAP ABAP Activities Defining CCMS Status Attribute Activity Figure 5-7 Step 4 Step 5 Step 6 CCMS Status Attribute Properties—CCMS Status Attribute Tab Click Browse to open the SAP ABAP Connection dialog box and populate the fields with pre-defined monitoring tree elements (see Selecting Monitoring Tree Elements, page 5-8) or enter the information in the following fields: Field Description Context Application server for the SAP system that will be monitored by this process.
Chapter 5 Using the SAP ABAP Activities Defining CCMS Status Attribute Activity Viewing CCMS Status Attribute Activity Results When the CCMS Status Attribute activity is executed, results are displayed in the Operations workspace activity instance view. Step 1 In the Operations workspace, expand the Activity Views folder and then click the view that represents how the process was executed (for example, View Adhoc if the process was manually executed).
Chapter 5 Using the SAP ABAP Activities Defining Complete CCMS Alert Activity Step 5 Click Close to close the dialog box. Defining Complete CCMS Alert Activity Use the activity to acknowledge a CCMS alert, specified by its unique number and other SAP properties. Step 1 On the Toolbox, click the CCMS Status Attribute activity and drag it onto the Workflow pane.
Chapter 5 Using the SAP ABAP Activities Defining Complete CCMS Alert Activity Figure 5-10 Step 4 Specify the information in the following fields: Field Description Unique number Unique number of the alert within the SAP system. System ID Name of the SAP system that raised the alert. Monitoring segment name Name of monitoring segment. Alert time Time when CCMS alert is raised. Note Step 5 Step 6 Complete CCMS Alert Properties—Acknowledge Alert Tab Click the Reference process.
Chapter 5 Using the SAP ABAP Activities Defining Complete CCMS Alert Activity Viewing Complete CCMS Alert Activity Results When the Complete CCMS Alert activity is executed, results are displayed in the Operations workspace activity instance view. Step 1 In the Operations workspace, expand the Activity Views folder and then click the view that represents how the process was executed (for example, View Adhoc if the process was manually executed).
Chapter 5 Using the SAP ABAP Activities Defining Correlate CCMS Alerts Activity Defining Correlate CCMS Alerts Activity Use the Correlate CCMS Alerts activity to specify the properties of CCMS alerts that should be correlated. Step 1 On the Toolbox, click the Correlate CCMS Alerts activity and drag it onto the Workflow pane.
Chapter 5 Using the SAP ABAP Activities Defining Correlate CCMS Alerts Activity Figure 5-13 Step 4 Correlate CCMS Alerts Properties—CCMS Alert Criteria Tab Complete the following fields: Field Description Correlate alerts that occur within Enter a value and select the time unit to indicate the length of time to wait before or after the process start time. Number of alerts to correlate Click the radio button to specify which alerts to wait for before the process continues.
Chapter 5 Using the SAP ABAP Activities Defining Correlate CCMS Alerts Activity Field Step 5 Step 6 Description Object name Object in SAP that will be monitored by this process (for example, CPU in the host system, database, or SAP services, such as background processing). Enter the (*) wildcard to monitor all objects. Short name Short text that is assigned to the MTE class. Enter the (*) wildcard to monitor all short names.
Chapter 5 Using the SAP ABAP Activities Defining Correlate CCMS Alerts Activity Figure 5-14 Correlate CCMS Alerts Properties—Correlated Alerts Tab The following information displays for each alert: Step 5 Column Description Name Name of the alert. Occurred Time the alert occurred. Type Type of alert (Information, Warning, Error, Success audit, or Failure audit). Click Close to close the dialog box.
Chapter 5 Using the SAP ABAP Activities Defining Get SAP Server Down Time Activity Defining Get SAP Server Down Time Activity Use the Get SAP Server Down Time activity to retrieve the time a specified SAP server could not be accessed by TEO. This activity supports the server availability monitoring feature, which monitors servers for availability and the ability to log in a user. Step 1 On the Toolbox, click the Get SAP Server Down Time activity and drag it onto the Workflow pane.
Chapter 5 Using the SAP ABAP Activities Defining Get SAP Server Down Time Activity Figure 5-16 Get SAP Server Down Time Properties—Server Tab Step 4 In the Server name field, enter the name of the SAP server to analyze. Step 5 Complete the appropriate information in the following tabs: Step 6 • Target—Specify whether the defined process target should be used or overridden. • Knowledge Base—Select the appropriate knowledge base article to associate with the process.
Chapter 5 Using the SAP ABAP Activities Defining Get SAP Server Down Time Activity Figure 5-17 Get SAP Server Down Time Properties—Results Tab The following information displays for the specified server: Step 5 Column Description Application Server Name Name of the SAP application server that was analyzed. Host Name of the SAP server host. Response Time The response time for the server. Down Time Time the server became unavailable. Down Time Period Length of time the server was unavailable.
Chapter 5 Using the SAP ABAP Activities Defining SAP RFC Function Activity Defining SAP RFC Function Activity Use the SAP RFC Function activity to define the properties of any remote-enabled function (custom method) within the monitored SAP system. You can use this activity to execute commonly used transactions that will be run against an SAP system or application server. Step 1 On the Toolbox, click the SAP RFC Function activity and drag it onto the Workflow pane.
Chapter 5 Using the SAP ABAP Activities Defining SAP RFC Function Activity Figure 5-19 Step 4 Click the Browse button to open the Select SAP RFC Function dialog box and select the custom method to be used for execution. Figure 5-20 Step 5 Select SAP RFC Function You can filter the display of RFC functions by Name or Category. Click the Filter by link and then choose the filter criteria from the drop-down list.
Chapter 5 Using the SAP ABAP Activities Defining SAP RFC Function Activity Step 7 Complete the required fields that display. Any of the following fields may display depending on the selected method: Field Description Method name Name of the selected RFC method. Time out if not completed within Check the check box to enter a time out interval within which the RFC call must complete.
Chapter 5 Using the SAP ABAP Activities Defining Create User Activity Viewing SAP RFC Function Activity Results When the SAP RFC Function activity is executed, results are displayed in the Operations workspace activity instance view. Step 1 In the Operations workspace, expand the Activity Views folder and then click the view that represents how the process was executed (for example, View Adhoc if the process was manually executed).
Chapter 5 Using the SAP ABAP Activities Defining Create User Activity Step 2 Step 3 On the General tab, enter the following information: Field Description Display name Name of the activity. Type Display only. Type of activity generated. Description Text description of the activity. Click the Create User tab.
Chapter 5 Using the SAP ABAP Activities Defining Create User Activity Field Description User type In the drop-down list, choose the appropriate user type to be associated with the user. • Dialog—Individual, interactive system access. • System—Background processing and communication within a system (such as RFC users for ALE, Workflow, TMS, and CUA). • Communication—Dialog-free communication for external RFC calls. • Service—Dialog user available to a larger, anonymous group of users.
Chapter 5 Using the SAP ABAP Activities Defining Delete User Activity Defining Delete User Activity Use the Delete User activity to delete the specified user from the target SAP system. Step 1 On the Toolbox, click the Delete User activity and drag it onto the Workflow pane. Figure 5-23 Step 2 Step 3 Delete User Properties—General Tab On the General tab, enter the following information: Field Description Display name Name of the activity. Type Display only. Type of activity generated.
Chapter 5 Using the SAP ABAP Activities Defining Delete User Activity Figure 5-24 Delete User Properties—Delete User Tab Step 4 In the User name field, enter the user name to be deleted. Step 5 Complete the appropriate information in the following tabs: • Note Step 6 Target—Specify whether the defined process target should be used or overridden. This activity does not support Central User Administration (CUA) operations, so it will have limited capabilities if performed against a CUA target.
Chapter 5 Using the SAP ABAP Activities Defining Get Profile List Activity Defining Get Profile List Activity Use the Get Profile List activity to retrieve a list of available profiles. Step 1 On the Toolbox, click the Get Profile List activity and drag it onto the Workflow pane. Figure 5-25 Step 2 Step 3 Get Profile List Properties—General Tab On the General tab, enter the following information: Field Description Display name Name of the activity. Type Display only. Type of activity generated.
Chapter 5 Using the SAP ABAP Activities Defining Get Profile List Activity Figure 5-26 Get Profile List Properties—Get Profile List Tab Step 4 In the Profile name field, enter the profile names to be retrieved. Wildcards are supported. Step 5 Complete the appropriate information in the following tabs: • Note Step 6 Target—Specify whether the defined process target should be used or overridden.
Chapter 5 Using the SAP ABAP Activities Defining Get User Information Activity Defining Get User Information Activity Use the Get User Information activity to retrieve the properties of a specified user. Step 1 On the Toolbox, click the Get User Information activity, and drag it onto the Workflow pane. Figure 5-27 Step 2 Step 3 Get User Information Properties—General Tab On the General tab, enter the following information: Field Description Display name Name of the activity. Type Display only.
Chapter 5 Using the SAP ABAP Activities Defining Get User Information Activity Figure 5-28 Get User Information Properties—Get User Information Tab Step 4 In the User name field, enter the user name for the user whose information is to be retrieved. Step 5 Complete the appropriate information in the following tabs: • Note Step 6 Target—Specify whether the defined process target should be used or overridden.
Chapter 5 Using the SAP ABAP Activities Defining Get User Information Activity Viewing Get User Information Activity Results When the Get User Information activity is executed, results are displayed in the Operations workspace activity instance view. Step 1 In the Operations workspace, expand the Activity Views folder and then click the view that represents how the process was executed (for example, View Adhoc if the process was manually executed).
Chapter 5 Using the SAP ABAP Activities Defining Get User Information Activity Step 5 Field Description User type User type associated with the user: • Dialog—Individual, interactive system access. • System—Background processing and communication within a system (such as RFC users for ALE, Workflow, TMS, and CUA). • Communication—Dialog-free communication for external RFC calls. • Service—Dialog user available to a larger, anonymous group of users.
Chapter 5 Using the SAP ABAP Activities Defining Lock User Activity Defining Lock User Activity Use the Lock User activity to lock the specified user from the target SAP system. Step 1 On the Toolbox, click the Lock User activity, and drag and drop it onto the Workflow pane. Figure 5-30 Step 2 Step 3 Lock User Properties—General Tab On the General tab, enter the following information: Field Description Display name Name of the activity. Type Display only. Type of activity generated.
Chapter 5 Using the SAP ABAP Activities Defining Lock User Activity Figure 5-31 Lock User Properties—Lock User Tab Step 4 In the User name field, enter the user name for the user who is to be locked from the SAP system. Step 5 Complete the appropriate information in the following tabs: • Note Step 6 Target—Specify whether the defined process target should be used or overridden.
Chapter 5 Using the SAP ABAP Activities Defining Remove All User Profiles Activity Defining Remove All User Profiles Activity Use the Remove All User Profiles activity to delete all the profiles from a user. Step 1 On the Toolbox, click the Remove All User Profiles activity and drag it onto the Workflow pane. Figure 5-32 Step 2 Step 3 Remove All User Profiles Properties—General Tab On the General tab, enter the following information: Field Description Display name Name of the activity.
Chapter 5 Using the SAP ABAP Activities Defining Remove All User Profiles Activity Figure 5-33 Remove All User Profiles Properties—User Tab Step 4 In the User name field, enter the name of the user from which all user profiles should be removed. Step 5 Complete the appropriate information in the following tabs: • Note Step 6 Target—Specify whether the defined process target should be used or overridden.
Chapter 5 Using the SAP ABAP Activities Defining Unlock User Activity Defining Unlock User Activity Use the Unlock User activity to unlock the specified user from the target SAP system. Step 1 On the Toolbox, click the Unlock User activity and drag it onto the Workflow pane. Figure 5-34 Step 2 Step 3 Unlock User Properties—General Tab On the General tab, enter the following information: Field Description Display name Name of the activity. Type Display only. Type of activity generated.
Chapter 5 Using the SAP ABAP Activities Defining Unlock User Activity Figure 5-35 Unlock User Properties—Unlock User Tab Step 4 In the User name field, enter the user name for the user account to be unlocked in the SAP system. Step 5 Complete the appropriate information in the following tabs: • Note Step 6 Target—Specify whether the defined process target should be used or overridden.
Chapter 5 Using the SAP ABAP Activities Defining Update User Activity Defining Update User Activity Use the Update User activity to update existing user properties. Step 1 On the Toolbox, click the Update User activity and drag it onto the Workflow pane. Figure 5-36 Step 2 Step 3 Update User Properties—General Tab On the General tab, enter the following information: Field Description Display name Name of the activity. Type Display only. Type of activity generated.
Chapter 5 Using the SAP ABAP Activities Defining Update User Activity Figure 5-37 Update User Properties—Update User Tab Step 4 In the User name field, enter the name of the user account that needs to be updated. Step 5 Select the check box next to the field name for the items in the user profile that need to be updated and then enter the new information in the field. If the field does not require updating, do not select the check box. Field Description User name User name for the user account.
Chapter 5 Using the SAP ABAP Activities Defining Update User Activity Step 6 Field Description User type In the drop-down list, choose the appropriate user type to be associated with the user. Dialog—Individual, interactive system access. • System—Background processing and communication within a system (such as RFC users for ALE, Workflow, TMS, and CUA). • Communication—Dialog-free communication for external RFC calls. • Service—Dialog user available to a larger, anonymous group of users.
INDEX CCMS Performance Attribute results (Values) A CCMS Status Attribute activity ABAP application server 3-3, 3-10 connection, modify specifying 3-23 3-4 accessing 4-1 Complete CCMS Alert activity configuring SAP system targets 3-2 5-2 Complete CCMS Alert results about SAP Runtime Users 2-4 configure accessing availability monitoring Runtime Users view 2-2 SAP System target SAP ABAP Adapter properties 1-1 5-14 5-16 1-4 3-2 connection information 3-1, 4-1 activities 5-3 ABAP
Index Correlate CCMS Alerts activity Create User activity 5-27 Delete User activity 5-30 Get Profile List activity 5-17 Java application server Get User Information activity modify SAP ABAP activity, general 5-3 SAP RFC Function activity 5-24 Update User activity 5-44 L 5-38 Lock User properties 5-30 5-38 M 5-30 deleting managing SAP targets SAP User triggers 3-26 Lock User activity 5-42 Delete User properties 3-15 5-40 3-2 Unlock User activity 3-25 JMX connection 5-34 Re
Index SAP system number P 3-4, 3-11, 3-34 SAP System target prerequisites 1-6 defining properties 3-2 system components, specifying CCMS Performance Attribute 5-6 SAP targets CCMS Status Attribute 5-11, 5-17 accessing 3-1 Complete CCMS Alert 5-14 enabling 3-20 Create User 5-28 Delete User 5-30 Get Profile List managing deleting 5-21 history 5-38 SAP RFC Function SAP system target 2-7 2-6 properties Remove All User Profiles SAP User 3-20 SAP User 5-32, 5-34 Get SAP Server
Index Telnet connection modifying 3-27 triggers deleting 4-8 disabling 4-7 triggers, enabling 4-7 U Unlock User activity 5-42 Unlock User properties Update User activity 5-42 5-44 Update User properties 5-44 V viewing adapter history 1-9 adapter prerequisites 1-6 adapter-supported objects 1-8 CCMS Performance Attribute results 5-9 CCMS Status Attribute Activity results Complete CCMS Alert results 5-16 Correlate CCMS Alerts results 5-19 Get SAP Server Down Time results Get User In
