IBM CICS Performance Analyzer Version 5 Release 3. Quick Start Guide

Transcription

1 IBM CICS Performance Analyzer Version 5 Release 3 Quick Start Guide Fundi Software 2017

2 Contents About this guide... 3 What is CICS Performance Analyzer for z/os?... 3 Part 1: Installation and setup... 4 Part 2: Requesting reports... 7 Part 3: Understanding CICS PA reports Part 4: Additional Information CICS PA JCL statements More information

3 About this guide This book contains a quick start guide for IBM CICS Performance Analyzer for z/os Version 5 Release 3. It is recommended that you print this guide for ease of use. After completing this guide, users should be able to perform the following tasks: Start the CICS Performance Analyzer ISPF dialog Define CICS systems and files Run a Report Set Run an individual report View report output This guide contains a short-cut through CICS Performance Analyzer (CICS PA) that allows you to get up and running quickly without examining each and every option in detail. What is CICS Performance Analyzer for z/os? IBM CICS Performance Analyzer for z/os (CICS PA) is a comprehensive performance reporting tool to help you develop, analyze, tune, and manage your CICS Transaction Server systems. CICS PA provides an ISPF menu-driven dialog to request generation of reports and extracts from System Monitoring Facility (SMF) files. The dialog has many features to help you to specify your 3

4 input files, filter the data, and tailor the reports and extracts to meet many different reporting requirements. CICS PA helps you analyze the performance of your CICS systems using the following SMF record types: CICS Monitoring Facility (CMF) performance class, exception class, and transaction resource class (SMF 110, subtype 1) CICS Transaction Server (CICS TS) statistics (SMF 110, subtype 2) and CICS Server statistics (SMF 110, subtypes 3, 4, and 5) IBM z/os System Logger for CICS journaling (SMF 88) IBM CICS Transaction Gateway (CICS TG) statistics (SMF 111) IBM DB2 accounting (SMF 101) IBM WebSphere MQ accounting (SMF 116) IBM OMEGAMON XE for CICS (SMF 112) containing transaction data for Adabas, CA- Datacom, CA-IDMS, and Supra database management systems These data sources provide input for generating reports, storing in HDBs, or exporting for analysis using IBM CICS Explorer, spreadsheets or SQL. Part 1: Installation and setup Complete the following steps to install and set up the product for reporting: 1. Install CICS PA. CICS PA is typically installed by your systems administrator using the instructions provided in the Program Directory. 2. Install the Report Set samples. A Report Set defines a selection of reports and extracts with options that can be run against a single pass of the data. CICS PA is supplied with several sample Report Sets to help you get started. a. Edit JCL member CPARSSJC provided in the SCPASAMP library. This member extracts the samples and all related objects to a set of CICS PA control data sets. b. Review the comments in this JCL member and then replace the following data set name prefixes as follows. If you are unsure about which prefixes to use, discuss it with your systems administrator: 4

5 Data set name prefix cpa.v5r3m0.scpasamp cpa.v5r3m0.rssamp Purpose Replace with the installation location of the CICS PA sample library. The output location for your Report Set samples. Replace with a data set name of your choice (and according to your site standards). For example, in ISPF edit, typing: CHANGE ALL cpa.v5r3m0.rssamp MYUID.CICSPA.QSG will install the samples in MYUID.CICSPA.QSG (replace MYUID with your own User ID) We recommend that you use a data set exclusively for this exercise to avoid unintentionally changing any CICS PA objects you or others may have already created. c. Submit the JCL. d. Verify the job completed successfully. Several control data sets are created. Each control data set has a suffix that indicates the type of data set: Data set suffix RSET FORM OBJL REPOSTRY Meaning Report Sets Forms Object Lists Repository 3. Start the CICS PA ISPF dialog. For example, if your installation location is CICSPA.V5R3M0, use the following TSO command: EX CICSPA.V5R3M0.SCPAEXEC(CPAOREXX) CICSPA.V5R3M0 ENU The Primary Option Menu is displayed. 5

6 V5R3M0 Option ===> CICS Performance Analyzer - Primary Option Menu 0 CICS PA Profile Customize your CICS PA dialog profile 1 Systems Specify Systems, SMF Files, and Groups 2 Report Sets Request and submit reports and extracts 3 Report Forms Define Report Forms 4 Object Lists Define Object Lists 5 Historical Database Collect and process historical data 6 Statistics Report CICS Statistics 7 Profiling Request Transaction Profiling 8 Resource Definitions Define CICS PA resources X Exit Terminate CICS PA 4. Select CICS PA Primary Menu option 0 CICS PA Profile. Select each option in turn to customize your settings as follows: a. Select option 1 CICS PA Settings. This option allows you to customize the CICS PA dialog and JCL used for generating reports and extracts. To make the task of generating and submitting CICS PA reports easier, we highly recommend that you specify the following options: CICS PA Load Library (SCPALINK) where CICS PA was installed (e.g. CICSPA.SCPALINK ) Personal Profile Library is used by CICS PA to save your CICS PA Profile settings. The library will be automatically created for you by CICS PA. Set Read SMF File to EOF to YES if your SMF file has been presorted (modified from the original) and is no longer in chronological order. Otherwise, leave this option set to NO. Job Statement Information to avoid updating the job card in the CICS PA generated JCL every time you submit a job. Press PF3 to save and exit. b. Select option 2 Reporting Allocation Settings. Specify unit and space parameters for sort, work, or extract data sets that CICS PA might need to create during batch report processing. Press PF3 to save and exit. c. Select option 3 CICS PA Control Data Sets. Enter data set names in the Report Sets, Report Forms, Object Lists, and Repository fields that correspond to the data sets created by completing step 2 on page 4. If you installed the Report Set samples to MYUID.CICSPA.QSG as per the example, can use the following settings: 6

7 Command ===> CICS PA Control Data Sets Specify the names of the CICS PA Control Data Sets. Report Sets..... MYUID.CICSPA.QSG.RSET + Report Forms..... MYUID.CICSPA.QSG.FORM + Object Lists..... MYUID.CICSPA.QSG.OBJL + Repository MYUID.CICSPA.QSG.REPOSTRY + Missing Data Sets Option: 1 1. Allocate now 2. Allocate when required Press PF3 to save and exit. d. Select option 5 File Selection. Select option 1. Personal only. However, you may later choose to use Shared System Definition to take advantage of their greater flexibility. Press PF3 to save and exit. Tip: You can use the standard ISPF commands SETTINGS, CUAATTR, and PFSHOW. It is recommended that you select the ISPF setting Tab to point-and-shoot fields, set point-andshoot fields to a differentiating color, and, until you are familiar with using the CICS PA dialog, show function key settings. Part 2: Requesting reports Complete the following steps to create reports using SMF files. 1. Obtain an SMF file. CICS PA will use this SMF file to generate its reports. The data set name will be required in subsequent steps. The SMF file should contain both CICS CMF and Statistics records (SMF 110). te: If you are unfamiliar with SMF data files and how to prepare them for CICS PA reporting, refer to the topic Preparing SMF data for CICS PA processing in the CICS Performance Analyzer User's Guide. Liaise with your data administrator as required. 2. Define a CICS system in CICS PA and specify an associated SMF file. Before requesting CICS PA reports, you must first define the systems that you want to report against. To define systems and files for reporting, the steps are: a. From the CICS PA Primary Option Menu, select option 1 Systems. 7

8 b. Select option 1 Personal Systems. c. Select option 1 Define Systems, SMF Files and Groups. If this is the first time you are using CICS PA, no systems will be displayed. d. On the command line, enter the NEW command. e. Specify the name and type of system: i. Enter an asterisk (*) in the System Name field to process all systems in the SMF file. ii. For System Type, select 1. CICS System and then press Enter. Command ===> New System Select the name and type of system. System Name.. * System Type CICS System 2. MVS Image 3. DB2 Subsystem 4. MQ Subsystem 5. System Logger Tip: System names can also be a masked pattern, for example, CICSP*. Then all CICS systems with names that match the pattern will share the system definition, SMF files, and so on. The CICS System definition panel is displayed. iii. Enter the fully qualified data set name for your SMF file. Be sure to enclose the data set name in quotes. Command ===> CICS System Row 1 of 1 More: > Scroll ===> PAGE CICS System definition: APPLID * MVS Image.. VRM. : Description..... Quick Start Guide MCT Suffix MCT Load Library... SDFHLOAD Library... Dictionary DSN.... / Exc SMF Data Set Name + UNIT + SEQ VOLSER + 'CICSGSG.CMF.FILE1' iv. Press PF3 to save and exit. The new system is displayed on the Personal System Definitions list. v. Press PF3 until you return to the Primary Option Menu. 8

9 3. Request reports on the SMF file. You are now ready to report on the SMF file. Two methods are described in this quick start guide. The first reporting method is to run a Report Set. Most CICS PA reports are generated using a Report Set. Report Sets provide a full set of report customization and options and allow multiple reports to be generated with a single pass of the SMF data, making processing very efficient. The second reporting method is to run a single ad-hoc report using a Report Form to analyze a problem or a specific issue. For these adhoc requests, CICS PA allows the user to run individual Report Forms directly from its definition, thus bypassing the need to specify the Form in a Report Set in order to generate a report. These methods are described below. a. Generate reports using a Report Set. i. From the CICS PA Primary Option Menu, select 2 Report Sets. The Report Sets you installed by completing step 2 on page 4 are displayed. Command ===> Report Sets Row 1 to 10 of 10 Scroll ===> CSR Report Sets Data Set.. : MYUID.CICSPA.QSG.RSET / Name Description Changed ID BFORAFTR Before and after comparison 2015/10/20 10:45 CICSPA CONSOLDT Region consolidation analysis 2015/10/20 10:45 CICSPA CPUINCRS Unexpected increase in CPU 2015/10/20 10:45 CICSPA FILEACCS File access problem analysis 2015/10/20 10:45 CICSPA MAXTASK MXT exceeded analysis 2015/10/20 10:45 CICSPA PLUGIN CICS PA Plugin HDB Load & Export 2015/10/20 10:45 CICSPA S RESPINCR Unexpected increase in Response 2015/10/20 10:45 CICSPA SOS Short-on-Storage analysis 2015/10/20 10:45 CICSPA THRDSAFE Transaction threadsafe analysis 2015/10/20 10:45 CICSPA TSQUEUE Temporary Storage anlysis 2015/10/20 10:45 CICSPA These sample report sets can be used in the following scenarios: Report Set Sample BFORAFTR CONSOLDT CPUINCRS FILEACCS Scenario The CICS applications programmer makes updates to an application as part of a modernization project and needs to compare CPU usage for transactions before and after the changes. You want to consolidate regions for improved performance. Some of the transactions on one or more CICS systems are experiencing increases in CPU time. A CICS system is experiencing file access issues. 9

10 Report Set Sample MAXTASK PLUGIN RESPINCR SOS THRDSAFE TSQUEUE Scenario A CICS region has reached the MXT limit specified for the region and you want to know what reports to run to determine the causes of the MXT condition. The CICS performance specialist wants to make performance summary, statistics alert, and performance alert data available to systems and application programmers. Some of the transactions on one or more CICS systems are experiencing increases in response time. A CICS region is experiencing a Short on Storage (SOS) condition. The report helps identify the cause of the SOS condition, which might be resource constraints, a large number of tasks, or flaws in application design. The CICS systems programmer has to provide details of transactions that are incurring TCB switches (dispatch mode delays). A CICS region is experiencing temporary storage queue issues. ii. Select the Report Set you wish to run using line action S. In the examples that follow, we have used RESPINCR: Unexpected increase in Response. The contents of the Report Set is displayed. EDIT Report Set - RESPINCR Row 1 of 44 Command ===> RUN Scroll ===> PAGE Description... Unexpected increase in Response Enter "/" to select action. ** Reports ** Active - Options Yes Global Yes - Selection Criteria Performance Exception - Performance Reports Yes List List Extended Yes Summary Yes Totals Wait Analysis Yes Transaction Profiling Cross-System Work Transaction Group BTS Workload Activity Transaction Tracking List Transaction Tracking Summary - Exception Reports List Summary - Transaction Resource Usage Reports File Usage Summary Temporary Storage Usage Summary DPL Usage Summary Transaction Resource Usage List - Statistics Reports Yes List Summary Yes 10

11 Only reports with Yes in the active column will be run. You can enable or disable a report by changing the value in the Active column. iii. Type RUN on the command line to run the Report Set. The Run Report Set panel is displayed. Command ===> Run Report Set RESPINCR Specify run options then press Enter to continue submit. System Selection using Personal System Definitions CICS APPLID.. * + Image.. + Group.. + DB2 SSID... + Image.. + Group.. + MQ SSID Image.. + Group.. + Logger Image.. + Group.. + Override System Selections specified in Report Set Read SMF File to EOF Report Interval Missing SMF Files Option: YYYY/MM/DD HH:MM:SS.TH 2 1. Issue error message From 2. Leave DSN unresolved in JCL To 3. Disregard offending reports Enter "/" to select option / Edit JCL before submit iv. In the CICS APPLID field, enter an asterisk (*) to select our previous CICS system definition. v. In the Missing SMF Files option select 2. Leave DSN unresolved in JCL in case the JCL requires manual modification. vi. vii. viii. Optional: Enter a Report Interval. The interval allows you to narrow the reporting time range. This can be particularly useful if you have a large SMF file. Select Edit JCL before submit. Press Enter to generate the JCL. If you selected Edit JCL before submit, the generated JCL is displayed in an ISPF edit session. Command ===> SUB Scroll ===> PAGE ***************************** Top of Data ************************ //MYUIDSPA JOB (ACCOUNT),'NAME' //* CICSPA V5R3 Report JCL //CICSPA EXEC PGM=CPAMAIN //STEPLIB DD DISP=SHR, // DSN=CPA.V5R3M0.SCPALINK //CPAHDBRG DD DISP=SHR, // DSN=MYUID.CICSPA.QSG.REPOSTRY //SYSPRINT DD SYSOUT=* //* SMF Input Files //SMFIN001 DD DSN=PROD1.DAILY.SMF, // DISP=SHR //* External Work Data Sets //CPAXW001 DD DSN=&&CPAXW001,DISP=(NEW,DELETE), // UNIT=SYSDA,SPACE=(CYL,(10,10)) //* Sort Work Data Sets //CPASWK01 DD DSN=&&CPASWK01,DISP=(NEW,DELETE), // UNIT=SYSDA,SPACE=(CYL,(10,10)) //CPASWK02 DD DSN=&&CPASWK02,DISP=(NEW,DELETE), // UNIT=SYSDA,SPACE=(CYL,(10,10)) //CPASWK03 DD DSN=&&CPASWK03,DISP=(NEW,DELETE), // UNIT=SYSDA,SPACE=(CYL,(10,10)) 11

12 //CPASWK04 DD DSN=&&CPASWK04,DISP=(NEW,DELETE), // UNIT=SYSDA,SPACE=(CYL,(10,10)) //SYSOUT DD SYSOUT=* //* Command Input //SYSIN DD * * Report Set =RESPINCR * Description=Unexpected increase in Response * Reports for System=* CICSPA IN(SMFIN001), APPLID(*), LINECNT(60), FORMAT(':','/'), PRECISION(4), LISTX(OUTPUT(BADRESP), EXTERNAL(CPAXW001), LIMIT(RESPONSE(20)), FIELDS(TRAN(ASCEND), RESPONSE(DESCEND), USERID, TASKNO, STOP(TIMET), RESPONSE, DISPATCH(TIME), DISPATCH(COUNT), CPU(TIME), SUSPEND(TIME), SUSPEND(COUNT), DISPWAIT(TIME), DISPWAIT(COUNT), IRWAIT(TIME)), TITLE1( 'Response time increase - top 20 worst Response times SUMMARY(OUTPUT(RESPPEAK), ')), te: To learn more about CICS PA JCL statements, see page 17 for details. ix. Enter SUB on the command line to submit the job. x. Press PF3 to return to the Report Set definition. te that the JCL is not saved. xi. Press PF3 until you return to the Primary Option Menu. Before we review the results of running the Report Set, we will now also request a single report so we can see the differences between the two. b. Generate a report using a Report Form. In this example, we will run a report based on the CPUSPSUM sample report form: i. From the CICS PA Primary Option Menu, select option 3 Report Forms. 12

13 File Confirm Samples Options Help Report Forms Row 1 to 19 of 52 Command ===> Scroll ===> CSR Report Forms Data Set.. : CPA530.WAXS.RSSAMP.FORM / Name Type Description Changed ID BADCHMDS LISTX Top 20 Worst Change TCB Modes 2015/10/20 10:53 CICSPA BADCPU LISTX Top 20 Worst CPU Times 2015/12/15 00:00 CICSPA BADFCRQ LISTX Top 20 Worst File Requests 2015/12/15 00:00 CICSPA BADRESP LISTX Top 20 Worst Response Times 2015/12/15 00:00 CICSPA BADTSRQ LISTX Top 20 Worst Tsqueue Requests 2015/12/15 00:00 CICSPA BADTSSWT LISTX Top 20 Worst Shared TS Waits 2015/12/15 00:00 CICSPA CHMDSLST LIST Transaction Change TCB Modes 2016/06/14 11:51 CICSPA CHMDSRNG SUMMARY Change TCB Mode Distribution 2015/12/15 00:00 CICSPA CHMDSSUM SUMMARY Transaction Change TCB Modes 2016/06/14 11:52 CICSPA ii. Select Samples in the CICS PA action bar, and then select 1. Populate Report Forms data set with sample forms. The Sample Form Search panel is displayed. This panel is used to filter the 200+ sample forms based on various user specified criteria. In this exercise you will list all the sample forms by not specifying any search criteria. iii. iv. Press Enter to list all the sample forms. On the command line enter F CPUSPSUM to locate the required Form. Command ===> F CPUSPSUM Sample Report Forms Row 1 to 14 of 241 Scroll ===> CSR Select one or more Sample Report Forms then press EXIT. Name Type Description Saved ABNDLST LIST Transaction Abend List ABNDSUM SUMMARY Transaction Abend Summary ACCTSUM SUMMARY Accounting Summary HDB Extract ACCT5SUM SUMMARY Accounting Summary HDB Extract... v. Select CPUSPSUM using line action s, and then press Enter. vi. Press PF3 to save this Form in the Forms dataset. File Confirm Samples Options Help Report Forms 1 members added Command ===> Scroll ===> CSR Report Forms Data Set.. : CPA530.WAXS.RSSAMP.FORM / Name Type Description Changed ID BADCHMDS LISTX Top 20 Worst Change TCB Modes 2015/10/20 10:53 CICSPA BADCPU LISTX Top 20 Worst CPU Times 2015/12/15 00:00 CICSPA BADFCRQ LISTX Top 20 Worst File Requests 2015/12/15 00:00 CICSPA BADRESP LISTX Top 20 Worst Response Times 2015/12/15 00:00 CICSPA BADTSRQ LISTX Top 20 Worst Tsqueue Requests 2015/12/15 00:00 CICSPA BADTSSWT LISTX Top 20 Worst Shared TS Waits 2015/12/15 00:00 CICSPA CHMDSLST LIST Transaction Change TCB Modes 2016/06/14 11:51 CICSPA CHMDSRNG SUMMARY Change TCB Mode Distribution 2015/12/15 00:00 CICSPA CHMDSSUM SUMMARY Transaction Change TCB Modes 2016/06/14 11:52 CICSPA CPUSPLST LIST Transaction CPU Analysis (V5) 2015/12/15 00:00 CICSPA S CPUSPSUM SUMMARY Transaction CPU Analysis (V5) 2015/12/15 00:00 CICSPA CPUSUM SUMMARY Transaction CPU Analysis 2015/12/15 00:00 CICSPA w that the form is saved in the Report Form data set, you can run it any time you like. 13

14 vii. Select Report Form CPUSPSUM using line action s. The Report Form is displayed. The report will contain the data displayed in the Field Name column. File Edit Confirm Upgrade Profiling Options Help EDIT SUMMARY Report Form - CPUSPSUM Row 1 of 16 More: > Command ===> RUN Scroll ===> PAGE Description... Transaction CPU Analysis (V5) Version (VRM): 690 Selection Criteria: Performance Page width Field Sort / Name + K O Type Fn Description TRAN K A Transaction identifier TASKCNT Total Task count RESPONSE AVE Transaction response time DISPATCH TIME AVE Dispatch time DISPATCH COUNT AVE Dispatch time CPU TIME AVE CPU time SUSPEND TIME AVE Suspend time SUSPEND COUNT AVE Suspend time KY8CPU TIME AVE CICS Key 8 TCB CPU time KY9CPU TIME AVE User task Key 9 Mode CPU time CPUONCP TIME AVE CPU time on standard CP CPUONSP CPU time on Specialty Processor CPUONCPE TIME AVE CPU time on standard CP that is SP eligible CPUISSPE CPU time that is offload eligible EOR End of Report EOX End of Extract ******************************* Bottom of data ******************************* viii. ix. Type RUN on the command line and then press Enter. The Run Report Form panel is displayed. In the CICS APPLID field, enter an asterisk (*) to select our previous CICS system definition. x. Optional: Enter a Report Interval. The interval allows you to narrow the reporting time range, useful if you have a large SMF file. xi. Select Edit JCL before submit. 14

15 Command ===> Run Report Form - CPUSPSUM System Selection: Report Output: APPLID.. * + DDname SUMM0001 Image.. + Print Lines per Page.. 60 (1-255) Group.. + Report Focus: sssss Report Interval sssssss Alert.. + YYYY/MM/DD HH:MM:SS.TH Severity + From To Summary Options: Report Formatting Options: Interval.. 01:00:00 (hh:mm:ss) Time Zone..... Totals Level 0 (blank or 0-8) Date Delimiter... / Time Delimiter... : Precision (4-6) Enter "/" to select option Use External Sort / Edit JCL before submit Repository.. : CICSPA.HDB.REPOSTRY xii. Press the Enter key TWICE to generate the JCL. The FIELDS operand lists the fields in the report and their options. Command ===> SUB Scroll ===> CSR ********************************* Top of Data ************ //MYUIDCPA JOB (ACCOUNT),'NAME' //* CICSPA V5R3 Report JCL //CICSPA EXEC PGM=CPAMAIN //STEPLIB DD DISP=SHR, // DSN=CPA.V5R3M0.SCPALINK //CPAHDBRG DD DISP=SHR, // DSN=CICSPA.HDB.REPOSTRY //SYSPRINT DD SYSOUT=* //* SMF Input Files //SMFIN001 DD DSN=PROD1.DAILY.SMF, // DISP=SHR //* Command Input //SYSIN DD * * Form =CPUSPSUM * Description=Transaction CPU Analysis (V5) * Reports for System=* CICSPA IN(SMFIN001), NOAPPLID, LINECNT(60), FORMAT(':','/'), PRECISION(4), SUMMARY(OUTPUT(SUMM0001), LINECNT(60), TOTALS(0), INTERVAL(01:00:00), FIELDS(TRAN(ASCEND), TASKCNT, RESPONSE(AVE), DISPATCH(TIME(AVE)), DISPATCH(COUNT(AVE)), CPU(TIME(AVE)), SUSPEND(TIME(AVE)), SUSPEND(COUNT(AVE)), KY8CPU(TIME(AVE)), KY9CPU(TIME(AVE)), CPUONCP(TIME(AVE)), CPUONSP, CPUONCPE(TIME(AVE)), CPUISSPE), xiii. Enter SUB on the command line and then press Enter. In the next section we will use SDSF to view the report output. 15

16 Part 3: Understanding CICS PA reports The following diagram shows the output from the RESPINCR sample Report Set ran earlier. SDSF JOB DATA SET DISPLAY - JOB LDT2#CPA (JOB63801) LINE 1-17 (17) COMMAND INPUT ===> SCROLL ===> CSR NP DDNAME StepName ProcStep DsID Owner C Dest Rec-Cnt Page-Cnt Byte-Cnt JESMSGLG JES2 2 LDT2 T LOCAL 28 1,840 JESJCL JES2 3 LDT2 T LOCAL 28 1,357 JESYSMSG JES2 4 LDT2 T LOCAL ,237 SYSPRINT CICSPA 102 LDT2 T LOCAL ,344 SYSOUT CICSPA 103 LDT2 T LOCAL 37 2,538 BADRESP CICSPA 104 LDT2 T LOCAL 1, ,475 RESPPEAK CICSPA 105 LDT2 T LOCAL 98 12,115 RESPRNGC CICSPA 106 LDT2 T LOCAL 4, ,129 RESPRNGM CICSPA 107 LDT2 T LOCAL 4, ,052 RESPRNGP CICSPA 108 LDT2 T LOCAL 4, ,797 RESPWLMP CICSPA 109 LDT2 T LOCAL 12 1,247 WAIT0001 CICSPA 110 LDT2 T LOCAL 1, ,134 TRANMNGR CICSPA 111 LDT2 T LOCAL 83 9,762 DISPOVRV CICSPA 112 LDT2 T LOCAL 30 4,517 TCBMODES CICSPA 113 LDT2 T LOCAL ,565 TCBPOOLS CICSPA 114 LDT2 T LOCAL 99 14,332 MONTORNG CICSPA 115 LDT2 T LOCAL 30 4,596 Besides the usual JES output data sets, the following CICS PA files were created. DDName SYSPRINT SYSOUT BADRESP RESPPEAK RESPRNGC RESPRNGM RESPRNGP RESPWLMP WAIT0001 TRANMNGR DISPOVRV TCBMODES TCBPOOLS MONTORNG Description CICS PA messages DFSORT messages Top 20 Worst Response times Response Time Peak Percentiles Response Time Distribution (Count) Response Time Distribution (Count+Percentage) Response time distribution (Percentage) Response time distribution by Service Class (SRVCLASS) Wait Analysis Transaction Manager Global statistics Dispatcher statistics overview Dispatcher statistics TCB Modes Dispatcher statistics TCB Pools Monitoring Global statistics CICS PA produces two types of reports: reports that use Report Forms, and pre-formatted reports which do not. The Wait Analysis report is an example of a pre-formatted CICS PA report that does not use a Report Form. Pre-formatted reports generally require complex calculation or have relationships not easily represented in a Report Form. The Wait Analysis report provides a detailed breakdown of Suspend Wait time. More information on the Wait Analysis report can be found by reading the topic Wait Analysis Report in the CICS Performance Analyzer Report Reference. 16

17 V5R3M0 CICS Performance Analyzer Wait Analysis Report WAIT0001 Printed at 11:08:58 1/23/2017 Data from 11:30:40 1/18/2017 to 15:59:48 1/19/2017 Page 1 Response time increase - Wait analysis Tran=BDEP Summary Data Time Count Ratio Total Average Total Average # Tasks 5 Response Time Dispatch Time % of Response CPU Time % of Dispatch Suspend Wait Time % of Response Dispatch Wait Time % of Suspend QR TCB Redispatch Wait Time % of Dispwait Resource Manager Interface (RMI) elapsed time % of Response Resource Manager Interface (RMI) suspend time % of Suspend Suspend Detail Suspend Time Count Total Average %age Graph Total Average ISIOWTT IPCONN link wait time % ************** IRIOWTT MRO link wait time % *** ICDELAY Interval Control (IC) wait time % DSCHMDLY Redispatch wait time caused by change-tcb mode % N/A Other Wait Time % FCIOWTT File I/O wait time % TCIOWTT Terminal wait for input time % GVUPWAIT Give up control wait time % DSPDELAY First dispatch wait time % Form based reports are generated based on a Form created by the user. Forms allow the user to customize the report by selecting the fields to include in the report, the order of the fields and functions to perform on the fields. In our exercise, the Response Time Peak Percentiles (RESPPEAK) report is an example of a Form based report. V5R3M0 CICS Performance Analyzer Performance Summary RESPPEAK Printed at 11:08:59 1/23/2017 Data from 11:30:40 1/18/2017 to 15:59:48 1/19/2017 Page 1 Response time increase - Response time peak percentiles Avg 60% 65% 70% 75% 80% 85% 90% 95% 98% 99% Max Tran #Tasks Response Response Response Response Response Response Response Response Response Response Response Response Time Time Time Time Time Time Time Time Time Time Time Time BDEP BPMT CATA CATD CATR CCVA CCVC w that you have completed this guide, feel free to run some of the other sample reports to get a feel for the types of information that CICS PA has to offer. Part 4: Additional Information CICS PA JCL statements JCL generated by CICS PA may contain some of the following statements. For more information, refer to the topics JOB, EXEC and DD statements and Using the CICS PA commands in the CICS PA User s Guide. JOB The job statement is derived from the Job Statement Information in your CICS PA Settings profile option (option 0.1 from the primary option menu). 17

18 PGM=CPAMAIN Executes CICS PA program STEPLIB DD This is the library containing the CICS PA modules. It is specified in CICS PA Load Library in the CICS PA Settings profile options. CPAHDBRG DD This identifies the Repository data set. This is a VSAM KSDS that is the repository for shared information such as historical databases, application groups and shared system definitions. The Repository data set name is specified in your CICS PA Control Data Sets profile option 0.3. It can also be specified when required for historical database, shared systems, statistics, profiling, or resource definitions. SYSPRINT DD CICS PA message data set. This DD statement defines the file used by CICS PA for its messages and run time information. It must be specified and should be checked for error messages. SMFINnnn DD One or more DD statements define the SMF data sets to be processed by CICS PA. This ddname corresponds to the INPUT(ddname) or IN(ddname) report operand. The CICS PA dialog automatically generates these DD statements based on the CICS APPLIDs selected for reporting and their associated SMF files or log streams specified in system definitions. SYSIN DD The CICSPA report command input built from the requested (active) reports and extracts in the Report Set. INPUT(ddname) The ddname of the corresponding SMF file as specified in the JCL. In this example, the ddname is SMFIN001. APPLID(xxxxxxxx) The CICS system APPLID specified in the Report Set Run panel. In this example, the APPLID was the non-specific * so the report will include all CICS systems in the SMF file. LINECNT(nnn) The number of report lines per page specified in the Report Set global option Print Lines per Page. The default is 60. FORMAT(time,date) The delimiters to use when formatting the time and date in reports and extracts. The values are specified in the Report Set global options Time Delimiter and Date Delimiter. The defaults are the colon (:) and forward slash (/) respectively. PRECISION(n) The precision to use in the report for numeric fields. Possible values are 4, 5, and 6. The default value is 4. 18

19 PRECISION(4) is precision PRECISION(5) is precision PRECISION(6) is (microsecond) precision LIST(...),SUMMARY( ),WAITANAL( ), Requested (active) reports in the Report Set. More information Once you have completed this guide, refer to the CICS Performance Analyzer topics found online in the IBM Knowledge Center for more information. We recommend that you start with the CICS PA Getting Started Guide for a quick introduction to the CICS PA core features. 19