SAP Job Scheduling Management Health Check

Transcription

1 Job Scheduling Management Health Check Setup and User Guideline SAP Job Scheduling Management Health Check with SAP Solution Manager March 2016

2 SAP SE Dietmar-Hopp-Allee Walldorf Germany T +49/6227/ F +49/6227/ Copyright SAP SE. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. Microsoft, WINDOWS, NT, EXCEL, Word, PowerPoint and SQL Server are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iseries, pseries, xseries, zseries, z/os, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix and Informix Dynamic Server TM are trademarks of IBM Corp. in USA and/or other countries. ORACLE is a registered trademark of ORACLE Corporation. UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group. Citrix, the Citrix logo, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, MultiWin and other Citrix product names referenced herein are trademarks of Citrix Systems, Inc. JAVA is a registered trademark of Sun Microsystems, Inc. J2EE is a registered trademark of Sun Microsystems, Inc. JAVASCRIPT is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. SAP, SAP Logo, R/2, RIVA, R/3, SAP ArchiveLink, SAP Business Workflow, WebFlow, SAP EarlyWatch, BAPI, SAPPHIRE, Management Cockpit, mysap, mysap.com, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. MarketSet and Enterprise Buyer are jointly owned trademarks of SAP Markets and Commerce One. All other product and service names mentioned are the trademarks of their respective owners. Disclaimer Some components of this product are based on Java. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java Source Code delivered with this product is only to be used by SAP s Support Services and may not be modified or altered in any way. HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C, World Wide Web Consortium, Massachusetts Institute of Technology.

3 TABLE OF CONTENTS 1 INTRODUCTION CONCEPT OF JOB SCHEDULING MANAGEMENT HEALTH CHECK BENEFITS OF JOB SCHEDULING MANAGEMENT HEALTH CHECK JSM Health Check on Jobs JSM Health Check for Business Process Monitoring Job and BW Process Chain SETUP PREREQUISITES SAP Solution Manager System Relevant SAP Notes Check changeability of Repository and cross-client Customizing Check System Change Options Users and authorizations Set up Business Process Monitoring Job and BW Process Chain ACTIVATION WITH SAP SOLUTION MANAGER SAP Notes providing latest corrections for activation report Activate SAP Business Information Warehouse objects Activation using report RAGS_JSM_CONFIG_CUSTOMIZE Alternative: Activation using report RS_BCT_SM_SETUP_JSM_HC Activation results Maintain table for target-source mapping for aggregation and data reorganization Check if the Extractor Framework (EFWK) and housekeeping job are working Check E2E Resources used by the Extractor Framework Activate data extraction process in Extractor Framework (EFWK) Web Service Activation Check Job Scheduling Management Health Check Report TROUBLESHOOTING PROBLEMS DURING ACTIVATION PROCESS Error during activation of BW objects (step in section 2.2.2) Problem with EFWK Administration Work Center (step in section 2.2.6) JSM extractors are missing in the list of available extractors (step in section 2.2.6) PROBLEMS AFTER ACTIVATION PROCESS No data available for the JSM Health Check Report Error loading template when report is executed Distribution and bookmark not available in Web Templates...34 March

4 1 Introduction The Job Scheduling Management (JSM) Health Check is an analytical functionality within SAP Solution Manager. It provides reporting dashboards based on key performance indicators (KPI) related to job execution data collected from selected managed SAP systems and simple job / BW process chain monitoring data collected by Business Process Monitoring in SAP Solution Manager. These KPIs provide an overall picture about the actual system workload caused by background processing in order to identify possible optimization potential in specified managed systems connected to the SAP Solution Manager. The reporting dashboards make use of the SAP Business Information Warehouse (BW) component available in SAP Solution Manager (SolMan) as an SAP Netweaver 7.0 system and offer views on different aggregation levels and timeframes. The JSM Health Check is a standalone toolset which can be set up for regular, ad-hoc analysis or even in situations where you face serious issues in your job scheduling landscape (i.e. bottleneck situations). For SAP Solution Manager 7.1 integration with the Job Management Work Center regarding administration and access to the dashboards is available. 1.1 Concept of Job Scheduling Management Health Check The JSM Health Check uses the Extractor Framework (EFWK) of SAP Solution Manager Diagnostics (SMD) to extract and to aggregate job execution data from managed systems and simple job / BW process chain monitoring data collected by Business Process Monitoring in SAP Solution Manager (BPMon) into InfoCubes located in the BW component of SAP Solution Manager. All jobs in selected managed systems with a final status ( finished or cancelled ) as well as the available simple job / BW process chain monitoring data in SAP Solution Manager are considered for the JSM Health Check and collected on an hourly basis, the available aggregation for job execution data from daily for weekly and monthly views is done once a day automatically. The available data can be displayed via predefined Dashboards (Web Templates which execute queries on respective InfoCubes). Two different sets of extractors are available to extract job execution data from the managed systems as well as job monitoring data from Business Process Monitoring. The first set contains an extractor for taking only the job execution header information from table TBTCO into account, while another is combining data from job execution header (TBTCO) and job execution item (TBTCP) table. The second set contains extractors taking simple job and the BW process chain monitoring data available in Business Process Monitoring into account (see figure1). Figure 1 Job Scheduling Management Health Check Concept 4 March 2016

5 Dashboards (BW Report) Web Template InfoCube Data Source Daily View on Jobs 0SM_JSM_HC_XBP_DAILY_JOBS 0SM_JSM_H Table TBTCO in managed systems Daily View on Jobs (Step) 0SM_JSM_HC_XBP_DAILY_STEPS 0SM_JSM_H Table: TBTCO and TBTCP in managed systems Weekly View on Jobs 0SM_JSM_HC_XBP_WEEKLY_JOBS 0SM_JSM_D Aggregated from InfoCube 0SM_JSM_H Weekly View on Jobs (Steps) 0SM_JSM_HC_XBP_WEEKLY_STEPS 0SM_JSM_D Aggregated from InfoCube 0SM_JSM_H Monthly View on Jobs 0SM_JSM_HC_XBP_MONTHLY_JOBS 0SM_JSM_W Aggregated from InfoCube 0SM_JSM_D Monthly View on Jobs (Steps) 0SM_JSM_HC_XBP_MONTHLY_STEPS 0SM_JSM_W Aggregated from InfoCube 0SM_JSM_D Business Process Monitoring Job* Business Process Monitoring BW Process Chain* 0SM_JSM_HC_BPMON 0SM_JSM_S Table DSWP_BPM_JOSCHG in SolMan 0SM_JSM_HC_BPMON_CHAIN 0SM_JSM_C Table DSWP_BPM_JOSCHG in SolMan * The monitored jobs and BW process chains need to be setup in Business Process Monitoring session first. The dashboards for job / job step execution data (Daily/Weekly/Monthly view) illustrate the following information graphically as well as in tabular views in KPI sets for job execution data from managed systems - Job Status Analysis: Finished vs. Canceled (number of jobs as well as accumulated duration of jobs, top long runners; etc.) - Workload Distribution (per job duration; per start delay; by creation or scheduling user; by execution server; etc.) The graphical views enable an easy overview about the job execution status and distribution in the managed systems. The tabular views provide more detailed information via drilldown functionality. In addition these tabular views can also be exported as MS excel files. With such reports, the JSM Health Check provides you an overview about the job scheduling situation and system workload caused by background jobs in the managed systems, thus enhances the transparency of the existing job schedule and jobs which are causing problems or which can be improved. The dashboards for Business Process Monitoring Job and BW Process Chain provide daily views of maximum duration and maximum delay in the selected business process and step of a solution. In SAP Solution Manager 7.1 the dashboards are fully integrated in the Job Management Work Center. In SAP Solution Manager 7.0 the end user can execute the dashboards directly via Web Templates URL, i.e. as favorites in the system or as Favorite Shortcuts directly from an Internet Browser (after additional configuration). March

6 1.2 Benefits of Job Scheduling Management Health Check JSM Health Check on Jobs The JSM Health Check on jobs / job step execution data (Daily/Weekly/Monthly view) benefits your system by: Identifying o Longest running jobs o Jobs that run and / or cancel most often o Jobs with longest start delay times Showing distribution of background jobs o Across application servers o Across creating / scheduling users With the information, you can reduce the overall system workload caused by background jobs, ensure even workload distribution across system servers, identify system bottlenecks such as lack of work processes, as well as handle end user scheduled jobs that bypass central scheduling and cause high workload. More advantages of the JSM Health Check on Jobs are: Works as a standalone tool Enables ad hoc analysis Easy to implement and easy to use Provides transparency on job execution data in a central tool in SAP Solution Manager Incorporates configurable automatic housekeeping which controls data growth Examples of JSM Health Check Reports: As mentioned in section 1.1, the JSM Health Check Reports includes graphical views (BW-based bar charts) as well as tabular views; the screen shots below show examples from the reports. 6 March 2016

7 Figure 2 Report Examples based on job execution data JSM Health Check for Business Process Monitoring Job and BW Process Chain The JSM Health Check for job and BW process chain monitoring data provides daily views of maximum duration and maximum start delay within a Business Process Monitoring solution. They help identify long running and long start delay time of your jobs and BW process chains that may have business impact on a solution. These reports are standalone tools for ad hoc monitoring which provide transparency on job execution time and delay via the SAP Solution Manager. Important to know: JSM Health Check for Business Process Monitoring is using data which are generated by Job Monitoring via classic Business Process Monitoring only. The Job Monitoring objects have to be set up and running before any data can be extracted. Unified Job Monitoring (using Monitoring and Alerting Infrastructure MAI) does not provide any data for these JSM Health Checks. March

8 Examples of JSM Health Check Reports: Figure 3 Example BPMon simple job report 8 March 2016

9 Figure 4 Example BPMon BW process chain report Note that BPMon job and BW process chain reports are similar to the one from Trend Analysis Reporting in Business Process Monitoring BW based reporting functionality with respect to setup of background processing monitoring in BPMon for key figures Maximum Duration and Start Delay. However, the JSM Health Check BPMon reports are based on actual execution duration of jobs and BW process chains, whereas Trend Analysis bases on measured duration at the time of alert creation. The measured duration of a job or a chain at the time an alert is raised can differ from the actual execution duration. For example, a monitored job usually finishes within 30 min duration. A yellow alert threshold for this job within the key figure Maximum Duration in background processing monitoring is set at 45 min and a red alert threshold, 1 hour. Data collection takes place every hour on the hour. The following scenario raise a red alert when it took 2 hours to finish the job. At 1:30 AM the job started At 2 AM the data collection took place. The measured duration (30 min) was less than any threshold values. No alert was raised. At 3 AM the data collector took place again. The job was still running. Data collector detected that current duration (1.5 hour) exceeded red threshold. It raised a red alert with measured duration 1.5 hour. No further alert was raised for this job. At 3:30 AM the job finally finished The measured duration is 1.5 hour (for Trend Analysis report) and actual duration is 2 hours (for JSM Health Check BPMon job report). March

10 2 Setup The JSM Health Check is developed for SAP Solution Manager 7.1 which includes setup support in the Job Management Work Center. For Solution Manager 7.0 a downport is available with SPS23. The setup process for the JSM Health Check with Solution Manager 7.1 will be described in sections 2.2. Note: The following activation steps can be either performed directly in the productive SAP Solution Manager system or the activation steps can be applied first in the development SAP Solution Manager system and get afterwards transported (via quality assurance system) to the productive SAP Solution Manager. DISCLAIMER: Please use this Setup Guide for Job Scheduling Management Health Check at your own risk. All our recommendations regarding the activation of this functionality are based on our general experience and maybe are not valid for your specific implementation, especially when you are already using the SAP BW component in SAP Solution Manager. In this case, please consult and involve the people already working with BW in the target system to make sure that all functions in BW keep working. 2.1 Prerequisites SAP Solution Manager System The JSM Health Check is implemented in software component BW Content (BI_CONT or ST-BCO). If there is no BW client maintained in your system, please define it in the SAP Solution Manager Configuration. In general, it is recommended using the same client as BW client as is used as Solution Manager client. The client assignment cannot be changed later on after the initial configuration. As technical prerequisites for using the JSM Health Check, the following components are required on the respective backend system. Software Component Requirements SAP Solution Manager 7.0 SAP Solution Manager 7.1 Recommended SolMan 7.0 with SP27 & ST-BCO 400 SP0 (or higher) and ST-A/PI 01M* (or higher) on the respective backend system (SAP BASIS 620 or higher with SAP Note implemented) SolMan 7.1 with SP02 & ST-BCO 710 SP0 (or higher) and ST-A/PI 01M* (or higher) on the respective backend system (SAP BASIS 620 or higher with SAP Note implemented) Minimum SolMan 7.0 with SP23 & BI_CONT 7.04 SP07 (or higher) and ST-A/PI 01M* (or higher) on the respective backend system (SAP BASIS 620 or higher) SolMan 7.1 with SP01 & BI_CONT 7.05 SP01 (or higher) and ST-A/PI 01M* (or higher) on the respective backend system (SAP BASIS 620 or higher) Info: BW is previously known as BI. Both BW and BI refer to the SAP Business Information Warehouse. Note: If you want to set-up the data extraction on job step level, combining the data from table TBTCO and TBTCP as mentioned in section 1.1, it is necessary to fulfill the recommended software component requirements. 10 March 2016

11 2.1.2 Relevant SAP Notes Mandatory SAP Notes - SAP Note : BW content for SAP Solution Manager This note summarizes the details (affected releases) related to the transfer of the SAP Solution Manager BW objects from software component BI_CONT to ST-BCO, as mentioned in section SAP Note : BPM for BW Process Chains and Steps - Prerequisites Please review the section 2.) Required Notes: and implement the mentioned notes in the monitored BW system. This is to ensure that the monitoring for BW process chains works. - SAP Note : JSM Health Check / JSM Interactive Reporting: Some queries do not show the available data After implementing SAP Note some queries of the web templates do not display the data available in the cubes 0SM_JSM_H, 0SM_JSM_D and 0SM_JSM_W. The filter criteria of the related queries need to be adapted accordingly. Follow the instructions in the SAP Note to implement the changes. - SAP Note : Catch-up run of extractor extract data only for the last one hour The corrections will stabilize the data extraction for the JSM Health Check. Follow the instructions in the SAP Note to apply the changes. Once the changes are applied the data extraction will check the last 168 hours for missing extractor runs. For all missing extractor runs, a catch up run will be triggered. - SAP Note : Data in the hourly cube should be kept longer to enable issue analysis Follow the instructions in the SAP Note to change the deletion settings for the hourly InfoCube (0SM_JSM_H). Afterwards the data will be kept for 8 days instead of 1 day. This change ensures that detail job data are kept for a longer time and allows the comparison of hourly and daily data. Optional SAP Notes - SAP Note : True Type Fonts delivered with IGS The recommendation in this SAP Notes needs to be implemented if you predict that a font different than the IGS standard font (with limited options) will be used. - SAP Note : GFWCHART configuration file This SAP Note provides a solution for issues related to fonts in the IGS graphic charts and the layout of the coordination axis. - SAP Note : JSM Health Check / JSM Interactive Reporting: Bookmark and Distribute Functionalities Does Not Work This SAP Note explains how the Bookmark and Distribute functionalities can be enabled in the JSM Health Check reports (Web Templates) Note: After application of SAP notes / , the application server has to be restarted. March

12 2.1.3 Check changeability of Repository and cross-client Customizing Note: In a productive system the settings for the Repository and cross-client Customizing might not be changeable. If this is the case, the activation steps have to be performed in the development system first. The changed objects have to be transported to the productive system in a second step. Before starting the activation process, the changeability of the Repository and cross-client Customizing has to be checked. Modifications of these items must be allowed, because several changes affecting cross-client topics are applied to the system configuration during the activation. Make sure that in transaction SCC4 the settings for the selected BW client are set to status Changes to Repository and cross-client Customizing is allowed (see figures 5 & 6). Otherwise change it. After completing the activation process it can be reset to its original status. Figure 5 Double click on the selected BW client in transaction SCC4 Figure 6 Changes to Repository and cross-client Customizing should be allowed 12 March 2016

13 2.1.4 Check System Change Options Note: In a productive system the settings for System Change Options might not be changeable. If this is the case, the activation steps have to be performed in the development system first. The changed objects have to be transported to the productive system in a second step. In order to ensure objects related to the BW Reporting functionality can be activated, three namespaces have to be set to status modifiable in transaction SE03. Following the node Set System Change Option, you have to check if the namespaces /B10/ (Generation Namespace for SAP BI Content), /BI0/ (Business Information Warehouse SAP Namespace) and /BIC/ (Business Information Warehouse: Customer Namespace) are modifiable. If not, change them to modifiable (see figures 7 & 8). Figure 7 Transaction SE03 used to set system change options March

14 Figure 8 Check if relevant BW namespaces are modifiable - If not, change them accordingly Users and authorizations Please configure the necessary roles / authorizations via transaction PFCG as described below. These minimum authorizations are needed in order to activate JSM Health Check and get a picture of the results. In case the authorization configuration cannot be done in productive systems, please first do the configurations in development system and then transport the changes to the productive systems. For the activated BW objects, please use the BW Transport Connection available in the BW Administration Workbench (RSA1). 1. Role Z_SAP_BW_CCMS_SETUP - Create role Z_SAP_BW_CCMS_SETUP from standard role SAP_BW_CCMS_SETUP. - Extend authorizations: extend the object class AAAB, object S_TCODE, field TCD with RSRV, SICF and SU March 2016

15 Figure 9 Screen shot: Role Z_SAP_BW_CCMS_SETUP (1) - Extend authorization: fill object class BC_A, object S_TABU_DIS, field DICBE with *. Figure 10 Screen shot: Role Z_SAP_BW_CCMS_SETUP (2) - Insert authorization: fill object class BC_Z, object S_APPL_LOG, field ACTVT with 03, field ALG_0 with RSRV and ALG_S with Dialog. March

16 Figure 11 Screen shot: Role Z_SAP_BW_CCMS_SETUP (3) 2. Role Z_JSM_HC_USER - The following role must be manually created in the customer namespace, since there is no corresponding standard role available. The role assigns the necessary authorizations for the database access during the activation of JSM Health Check. Figure 12 Screen shot: Role Z_JSM_HC_USER 3. Profile S_DEVELOP - This profile is necessary for activating the JSM Health Check. 4. If you are using SAP Solution Manager 7.1, please add the role SAP_SMWORK_JOB_MAN to the user to be able to access the JSM Work Center. 16 March 2016

17 2.1.6 Set up Business Process Monitoring Job and BW Process Chain Important to know: JSM Health Check for Business Process Monitoring is using data which are generated by Job Monitoring via classic Business Process Monitoring only. The Job Monitoring objects have to be set up and running before any data can be extracted. Unified Job Monitoring (using Monitoring and Alerting Infrastructure MAI) does not provide any data for these JSM Health Checks. This step is only required for JSM Health Check for BPM Job and BW Process Chain reports. If you only want to use JSM Health Check for Jobs (Daily/Weekly/Monthly), this section can be skipped. Please refer to the section 6.1 Configure Background Job Monitoring of setup guide Business Process Monitoring with SAP Solution Manager Releases 7.1 SP05+ for detailed steps to setup simple job and BW process chain monitoring. This guide can be downloaded from Figure 13 - Business Process Operations in SAP Support Portal 2.2 Activation with SAP Solution Manager 7.1 The following sections describe the activation process of the JSM Health Check in SAP Solution Manager 7.1 step by step. If any problems arise during activation, please refer to the Troubleshooting chapter 3 at the end of the document. Report RAGS_JSM_CONFIG_CUSTOMIZE supports the different steps of the activation. Note: The activation of BW objects is performed in BW client, all other steps in Solution Manager client. March

18 2.2.1 SAP Notes providing latest corrections for activation report The following SAP Notes provide the latest corrections for the activation report RAGS_JSM_CONFIG_CUSTOMIZE. It is highly recommended to implement the corrections before the activation is performed. If all or some of the activation steps were performed already, follow the instructions in the SAP Notes to update the settings in the Solution Manager. SAP Notes: Catch-up run of extractor extract data only for the last one hour Data in the hourly cube should be kept longer to enable issue analysis Activate SAP Business Information Warehouse objects Activation using report RAGS_JSM_CONFIG_CUSTOMIZE In order to activate the necessary BW objects for the JSM Health Check execute the report RAGS_JSM_CONFIG_CUSTOMIZE by checking BW Content Activation and entering RFC destination to BW (this will create a background job for report RS_BCT_SM_SETUP_JSM_HC). Figure 14 Screen shot: Report RAGS_JSM_CONFIG_CUSTOMIZE Alternative: Activation using report RS_BCT_SM_SETUP_JSM_HC Alternatively report RS_BCT_SM_SETUP_JSM_HC can be executed in background or dialog mode with transaction SE38. It may take a few minutes until the execution completes. If you execute the report in dialog mode, the following selection screen is displayed (figure 15), please leave the entry field empty and press the execution button (F8) to start the activation process: Figure 15 Screen shot: Report to generate BW objects 18 March 2016

19 Info: If you run the report in Dialog Mode instead of running it in the background, there will be a pop-up with warning message Active BI Content might be overwritten. Continue? In this case click Yes to continue. In addition, there may be a popup for Select Source Systems, just click on yes to continue (it has no effect in our case) Activation results Once all objects are configured you should receive message All steps successfully performed as shown in figure 16. If the activation was done in background the information can be found in the spool of the job which executed report RS_BCT_SM_SETUP_JSM_HC. Figure 16 Screen shot: successful messages after activation of BW objects Note: to verify the RFC connection to BI client for the field RFC to BW, you can check the relevant entry in table E2E_WA_CONFIG (do selection with TYPE SAP_BID, double-click on the selected item, and then check the STRING). The result can be checked in the Data Warehousing Workbench: 1. Go to Data Warehousing Workbench via transaction code RSA1; 2. Select the InfoProvider on the left side; 3. Expand the SAP Solution Manager, then expand the subtree SAP Solution Manager - Job Scheduling Management ; 4. You will see the JSM objects, similar as shown in the screen shot below. March

20 Figure 17 Screen shot: Data Warehousing Workbench Maintain table for target-source mapping for aggregation and data reorganization In this step we maintain the aggregation levels for the housekeeping job in table E2E_BI_AGGREGATE, as well as maintain the table E2E_BI_DELETE for deletion jobs. This step is only required for JSM Health Check on Jobs (Daily/Weekly/Monthly view). The tables E2E_BI_AGGREGATE and E2E_BI_DELETE are maintained by executing report RAGS_JSM_CONFIG_CUSTOMIZE. Figure 18 Screen shot: execute report RAGS_JSM_CONFIG_CUSTOMIZE Note: to verify the RFC connection to BI client for the field RFC to BW, you can check the relevant entry in table E2E_WA_CONFIG (do selection with TYPE SAP_BID, double-click on the selected item, and then check the STRING). 20 March 2016

21 The standard job data life time in the InfoCubes related to the JSM Health Check are configured by the report in table E2E_BI_DELETE in the following way: Figure 19 Screen shot: Reorganization parameters with 0SM_JSM_H 0SM_JSM_D 0SM_JSM_W $DELTA=8$ (8 days) $DELTA=30$ (1 month) $DELTA=180$ (6 months) Explanation of the above example: 0CALDAY stands for the current day, for example If DELTA = 8, this means the threshold date is current day minus 8 days ( ). In this case, all data in 0SM_JSM_H that is older than will be deleted. This configuration ensures that the data at lowest level will only be available for 8 days, so that the data volume will be kept low. These entries can be changed any time manually according to your special needs Check if the Extractor Framework (EFWK) and housekeeping job are working The JSM Health Check on Jobs has three dashboards views with different aggregation levels and timeframes (i.e. daily view, weekly view, monthly view) based on the data collected by the extractors. To enable this functionality, the EFWK and housekeeping jobs must be working to start the automatic aggregation and reorganization process. Please follow the steps below to check the jobs in transaction SM37 in the SolMan client. If the jobs are not scheduled in the system yet, schedule and activate them. March

22 1. The report E2E_EFWK_RESOURCE_MGR starts extraction cycle of EFWK and executes due data extractor according to scheduling; this job should run every minute. Figure 20 Screen shot of SM37: check BW Extractor job This job should be scheduled during configuration of SAP Solution Manager. It starts data extraction process from configured managed systems and saves data in the JSM Health Check hourly InfoCube 0SM_JSM_H. 22 March 2016

23 2. The housekeeping report E2E_HK_CONTROLLER performs data aggregation and reorganization within the EFWK regarding the configuration in the underlying tables E2E_BI_AGGREGATE and E2E_BI_DELETE; this job should run daily (e.g. one time shortly after midnight): Figure 21 Screen shot of SM37: check the housekeeping job For more information about the aggregation levels and data reorganization, please refer to the sections Check E2E Resources used by the Extractor Framework In this step you need to check table E2E_RESOURCES which contains RFC resources available for data extraction within EFWK with transaction SE16. Normally all systems should be defined here that have been configured in managed system setup in the configuration of SAP Solution Manager. If an entry is missing you can manually create it as well, but maybe you should check before the managed systems setup. March

24 Figure 22 Screen shot: check E2E Resources The naming convention for the RFCRESOURCE is SM_SIDCLNT000_READ (replace SID with the system ID, the 000 with the client number). Please make sure that the list includes the needed system, as well as the entries NONE, SOLMANDIAG and SOLMAN_DIALOG_WORKPROCESSES. Note: if BW client is different from Solution Manager client (i.e. RFC destination to BI is not NONE ), then there should be an entry in this table for RFC destination to BW client under RFCRESOURCE (see field String in table E2E_WA_CONFIG where type = SAP_BID). Information about the field RESOURCECAP: It defines the maximum number of dialog work processes which can be used for data extraction purposes Activate data extraction process in Extractor Framework (EFWK) In this step, we have to configure the system specific data extraction process for the JSM Health Check by updating table E2E_ACTIVE_WLI for active worklist items within the EFWK. This table contains the scheduling information for all extractors being executed. For Job Daily/Weekly/Monthly view, we have to add the scheduling of the JSM Health Check extractors here to trigger data transfer between SAP Solution Manager and managed systems. We recommend scheduling either the extractor for job or for job step execution data for one specific system you want to include in the JSM Health Check. The extractor for job execution data only collects information from table TBTCO; the extractor for job step execution data collects job step data in addition, by joining the tables TBTCO and TBTCP. For BPMon Job and BW Process Chain reports, the extractors collect information from the table DSWP_BPM_JOSCHG in the Solution Manager. This table is filled for Job Monitoring objects in classic Business Process Monitoring. Unified Job Monitoring does not fill table DSWP_BPM_JOSCHG. In SAP Solution Manager 7.1, all extractor entries should be created automatically by Solution Manager Setup. The maintenance on the active worklist items table E2E_ACTIVE_WLI is therefore performed via the administration view in the EFWK Administration Work Center. 24 March 2016

25 1. Within the JSM Workcenter, go to tab Administration in the left window, the select option Manage Data Collection for Analytics in the right window to enter the EFWK Workcenter. Figure 23 Screen shot: Maintain extractors 2. As shown in the screen shot below, filter by *jsm* in the Extractor Overview list. Select the corresponding extractor; then click on the change button to enter the change mode. Figure 24 Screen shot: select the extractor to be activated March

26 3. Click on the Activate button for the reports you want to use, then the extractor is activated, which is indicated by the light bulb in the Active Status column. Figure 25 Screen shot: activate the extractor Web Service Activation Before the web template for JSM Health Check can be used in the system, the BEx (Business Explorer) and Mime (MIME in Web Reporting) Web services have to be activated. For this call transaction SICF. There, select SERVICE as Hierarchy type. After executing this selection the following screen will appear: Figure 26 Screen shot: Activation of web services 26 March 2016

27 Expand node default_host sap bw and check if service BEx (Business Explorer) and MIME are active (black font). If they are not active (grey font), activate via right-mouse-click on item BEx or MIME, choosing option Activate. At this point, all activation steps have been executed successfully Check Job Scheduling Management Health Check Report After extractor execution, the JSM Health Check Report can be checked in the Job Management Work Center of SAP Solution manager 7.1. Before this, you have to define the views you want to see on each aggregation level in the JSM Work Center. Therefore, select within the JSM Work Center the tab Administration in the left window, then the option Manage Reports for Job Scheduling Management in the right window. Figure 27 Screen shot: Maintain views March

28 Maintain in the pop-up window the views you want to use according to the scheduling of the extractors, select in views you want to see either without step for data from the job header information extractor, or otherwise with step for those extraction job header and item information. For Job Daily/Weekly/ Monthly view For BPM Job and BW Process Chain Figure 28 Screen shot: Select views Confirm your configuration by pressing the OK-button. Now you can access the dashboards directly via the JSM Work Center. As shown in the screen shot below, go to the Report view; select the BW Reports as Reporting Views. Figure 29 Screen shot: JSM Health Check Reports To open the report, click on the Report link. The corresponding report will be opened in your browser (select the managed system to view the JSM Health Check results). 28 March 2016

29 Please expand the collapsed data to see the statistics and diagrams for job status and workload distribution in the managed system. March

30 3 Troubleshooting When activating or working with the JSM Health Check, you could sometimes face technical issues for which we want provide you according to our experience a short description how to handle and solve it. If you face technical issues which are not included in this chapter, please feel free to create a customer message on component SV-SMG-PSM, providing a detailed description of your issue. 3.1 Problems during activation process Error during activation of BW objects (step in section 2.2.2) Symptom: As described in section 2.2.2, you executed report RS_BCT_SM_SETUP_JSM_HC in the BW client in order to generate BW objects for the JSM Health Check. After the execution, the report returns error messages as shown in the following screen shot. Figure 30 Screen shot: Error messages from the report to generate BW objects Solution: In the transaction RSOR, manually activate the InfoArea 0SM_JSM and all the related objects in the process. 30 March 2016

31 3.1.2 Problem with EFWK Administration Work Center (step in section 2.2.6) Symptom: You want to perform the step described in section 2.2.6, but the EFWK Administration work center is not working. Solution: Directly change the ACTIVE field in the table E2E_ACTIVE_WLI via transaction SE16. Set this field to X to activate the extractors JSM extractors are missing in the list of available extractors (step in section 2.2.6) Symptom: You want to activate the JSM Extractors as described in section The EFWK Administration work center is working, however the JSM extractors are missing in the list of available extractors. Solution: There are some steps missing in managed system setup of the Solution Manager. Perform the following steps: Execute transaction SOLMAN_SETUP in the Solution Manager system. Go to Managed System Configuration, select the relevant managed system and press Configure System. In step 8 Configure Automatically select Extractors Setup and press Execute Selected (see below picture). This will refresh the available extractors for the managed system relevant for the product version. Figure 31 Screen shot: Setup extractors for the managed system In case of errors check the details of the error message. March

32 3.2 Problems after activation process No data available for the JSM Health Check Report Symptom: The JSM Health Check has been set up, but you do not see the results in the report because there is no data in the InfoCube. Solution: 1. Start Solution Manager Administration Work Center, select the tab Infrastructure. Then select Framework -> Extractor Framework. In the Extractor Overview list, filter by *JSM*. Select the related extractor, and check the status. As next step, select the related extractor, check the status. 2. In case the extractor is banned, you may check if the problem can be solved by releasing the extractor. 32 March 2016

33 3. If the problem persists or in case of error status you can check the extractor logs and extractor details by clicking on the extractor entry. 4. Try to analyze and solve the problem based on the content of the error logs. 5. After you have solved the problem, deactivate and reactivate the extractor so that the extractor will be restarted Error loading template when report is executed Symptom: A report is started in the Job Management Workcenter e.g. Daily view on jobs. The execution fails with error message Error loading template 0SM_JSM_HC_XBP_* (message BRAIN 276). Solution: The Web Template for the report had not been activated successfully. The Web Template can be checked and activated in transaction RSOR as follows: 1. Start transaction RSOR 2. Navigate to Object types 3. Expand node Web Template (Format SAP BW 3.x) and double-click on Select Objects. 4. Select Web Template e.g. 0SM_JSM_HC_XBP_DAILY_JOBS and transfer the selection. If the Web Template and the used queries are active, there is a green icon in column Active version available. If some of the objects are not active yet, they can be activated in the following way: Select the Web Template Choose 'Install' for activation in a productive system or 'Installation and Transport' for activation in a development system. Refresh the display (F5) Afterwards there should be a green icon in column 'Active version available'. Repeat the same procedure for the other Web Templates. March

34 3.2.3 Distribution and bookmark not available in Web Templates Symptom: It is intended to distribute a JSM Health Check report to defined recipients on a regular basis. This is possible in two ways. Either a Bookmark is created for the report or the report is distributed using the BEx Broadcaster. Both functionalities cannot be used because the entries Distribute and Bookmark are missing in the context menu of the executed report. Solution: Follow the instructions in SAP Note to activate the missing actions in the context menu. Follow this procedure to distribute a report with defined content: 1. Execute the report e.g. Weekly view on jobs 2. Expand the graphics and tables which should be included in the distributed report 3. Right-click in the report (e.g. on the legend of a graphic) to get the context menu displayed 4. Select Distribute By 5. Create a new setting and schedule in the Broadcaster. The wizard will guide you through the steps. 34 March 2016

35 There are three output formats available: a. Online link to current data : The will provide a link to the JSM Health Check report. The recipient must have a user ID in the Solution Manager with appropriate authorizations to display the report. b. HTML : The have an attachment providing a precalculated version of the report. c. MHTML : Similar to HTML but in a different format. March