ATF Enhanced Summary reports from IMS log

Transcription

1 Last changed: The following changes to V4R4 take effect when the fix for APAR PI65825 is applied. Support is added to allow extract and reporting of data from the OMEGAMON XE for IMS on z/os V5.3 ATF Enhanced Summary record introduced by APAR OA This support is in the form of: In the ISPF dialog interface: The new ATF Enhanced Summary Reports category for LOG type report sets, which contains the following options: Transit Options Extract Transaction Analysis DLI Call Analysis DB2 Call Analysis MQ Call Analysis New IMSPALOG options that are specified using the batch interface: Requirement ATFEXTR: Command to specify the ATF ES extract ATFANALYSIS: Command to specify the ATF ES Transaction Analysis report ATFDLICALL: Command to specify the ATF ES DLI Call Analysis report ATFDB2CALL: Command to specify the ATF ES DB2 Call Analysis report ATFMQCALL: Command to specify the ATF ES MQ Call Analysis report To use these options with V4R4 you must apply the fix for APAR PI Background OMEGAMON v530 introduced functionality to create an ATF Enhanced Summary record in the IMS Log. This enhanced summary record includes a fixed part followed by up to six repeating sections. APAR PI65825 introduces a facility to produce an extract and a series of reports based on data from these new records. Related information A simpler version of the ATFEXTR batch command was provided in the fix for APAR PI (For details, including the structure of extended ATF Summary records and the format of CSV extract files, see the ATFEXTR extract command technote.) This version is superseded by PI65825, which adds the ability to specify a report interval and selection criteria as well as a dialog interface. Page 1 of 14

2 ATF Enhanced Summary Reports category in Report Set dialog The ATF Enhanced Summary Reports category for LOG type report sets contains the following options: Transit Options Extract Log Record Code. IMS PA uses this code to identify OMEGAMON ATF Enhanced Summary records in IMS log files. Specify a hexadecimal value in the range A0-FF that uniquely identifies this type of record. IPIRSSO SAMPLOG - ATF ES Transit Options Command ===> Specify ATF Enhanced Summary Transit options: OMEGAMON ATF ES Log Code A0 (Hex A0-FF) ATF ES Transit Options dialog The ATF Enhanced Summary Extract creates a series of files in CSV format so that ATF data can be loaded into a database such as DB2 for later analysis. One CSV file is always produced for the fixed or header part of the record, as well as one CSV file for each repeating section that is requested. IPIRSSX SAMPLOG - ATF ES Extract Command ===> Specify report options. Processing Options (Transit options): Report Interval OMEGAMON ATF ES Log Code : A0 YYYY/MM/DD HH:MM:SS:TH From To Extract Data Sets: Opt Section Extract Data Set Name Disp 1. / HEADER 2. _ DATABASE 3. _ DLI DB 4. _ DLI TM 5. _ DB2 6. _ MQ 7. _ OTHER Extract Options: _ Include Field Labels Delimiter.., (blank is valid) Selection Criteria: Object Type Inc/Exc Object + List Validation Warning Transaction Code _ Program _ Database _ User ID _ IMS Subsystem ID _ ATF ES Extract dialog Page 2 of 14

3 The options are: Report Interval Within the context of the Global Report Interval, records with time stamps on or after the From Date/Time and before the To Date/Time are included in the extract. Rules governing the date and time are the same as those for the Global Report Interval (see Log Global Options). Extract Data Sets Use / in the Opt field to specify which repeating sections in the log record are to be written to CSV extract files. For each section that is selected specify the name of the extract data set. The Disp field applies if the extract data set is already cataloged. Specify either OLD or SHR to overwrite the data set contents with the new extract data, or specify MOD to append the new extract data. If the extract data set is not cataloged then DISP=NEW will be used regardless of this setting. If IMS PA is to create the data set at run time, the default allocation attributes specified for Summary Extracts in Reporting Allocation Settings will be used when generating the JCL. Any combination of section names can be specified, but there must be one DD statement provided in the JCL corresponding to each CSV section that is specified. The fixed section extract (HEADER) is always produced. Therefore, the Opt field is preselected and cannot be cleared. Include Field Labels Select / to include field labels as the first record written to the extract data set. Use field labels when importing extracts into spreadsheets, to identify the columns and to aid reporting. Leave this option blank if you do not want field labels. Tip: Omit labels when importing extracts into DB2, where the load utility would treat them as raw data, not column headings. Delimiter Specify the character used to separate the data fields in the extract records. The same delimiter is used to separate the field labels, if present. The default is, (comma). Selection Criteria Records can be included in or excluded from the report based on their Region ID, Transaction Code, Program (PSB), Database, User ID, and IMS Subsystem ID values. This enables you to include in your extract only the information that you are interested in. You can specify a single value, a masking pattern, or an Object List. If no values are specified all records are included. Extract options The format of the extract command is: Page 3 of 14

4 IMSPALOG ATFEXTR( FROM(YYYY/MM/DD,00:00:00:00), TO(YYYY/MM/DD,23:59:59:99), LABELS, DELIMIT(','), SECTIONS( DBD, DLIDB, DLITM, DB2, MQ, OTHER), INCL(TRANCODE()), INCL(PROGRAM()), INCL(DATABASE()), INCL(USERID()), INCL(IMSID())) Transaction Analysis report The ATF Enhanced Summary Transaction Analysis report can show performance by Transaction or Database depending on the options selected. The report is available in both List and Summary format. The List report is the default format. It is available in two formats: Transaction - where all transactions are listed with Elapsed times and CPU time broken down by dependent region. Transaction-Database - where all databases used by the transaction are listed with DLI Gets and Updates broken down into call counts, Elapsed time, and CPU time. The Summary report is available in two formats: Transaction - where all transactions are summarized by transaction and program with Elapsed time and CPU time averaged by dependent region. Database - where all database usage is summarized with DLI Gets and Updates broken down into call counts, Elapsed time, and CPU time. Page 4 of 14

5 IPIRSSF SAMPLOG - ATF ES Transaction Analysis Command ===> Specify report options. Processing Options (Transit options): Report Interval OMEGAMON ATF ES Log Code : A0 YYYY/MM/DD HH:MM:SS:TH From To Report Output DDnames: / List List.... ATFTRNLS _ Summary Summary.. ATFTRNSM _ Database Selection Criteria: Object Type Inc/Exc Object + List Validation Warning Transaction Code _ Program _ Database _ User ID _ IMS Subsystem ID _ ATF ES Transaction Analysis dialog The options are: Report Interval Within the context of the Global Report Interval, records with time stamps on or after the From Date/Time and before the To Date/Time are included in the report. Rules governing the date and time are the same as those for the Global Report Interval (see Log Global Options). Enter / to select which of the reports are required. List If Database is not selected, the List report breaks down activity by Elapsed time and CPU time by transaction. If Database is selected, the List report breaks down activity by DLI activity by database within transaction. Summary If Database is not selected, the Summary report summarizes activity to show Transaction counts with average Elapsed time and CPU time by dependent region. If Database is selected, the Summary report shows Database activity by Read and Update calls. Report Output DDnames Specify the DDnames to be used for the List and Summary report output. The defaults are ATFTRNLS for the List report and ATFTRNSM for the Summary report. Selection Criteria Records can be included in or excluded from the report based on their Transaction Code, Program (PSB), Database, User ID, and IMS Subsystem ID values. This enables you to include in your extract only the information that you are interested in. You can specify a single value, a masking pattern, or an Object List. If no values are specified all records are included. Page 5 of 14

6 Report options The format of the report command is: IMSPALOG ATFANALYSIS FROM(YYYY/MM/DD,00:00:00:00), TO(YYYY/MM/DD,23:59:59:99), LIST, SUMMARY, DATABASE, LISTDDN(ATFDLILS), SUMMDDN(ATFDLISM), INCL(TRANCODE()), INCL(PROGRAM()), INCL(DATABASE()), INCL(USERID()), INCL(IMSID())) Sample report content OMEGAMON ATF Transaction-Database List Report from 09Jun :23:35.27 Page 1 Time Trancode Process Elap DLI CPU DLI Database Gets Elap Get CPU Get Updates Elap Upd CPU Upd 14:23: FPSAMP DBFSAMD DBFSAMD DBFSAMD :24: FPSAMP DBFSAMD DBFSAMD :25: FPSAMP DBFSAMD DBFSAMD DBFSAMD :25: FPSAMP DBFSAMD DBFSAMD DBFSAMD :26: FPSAMP DBFSAMD DBFSAMD DBFSAMD :26: FPSAMP DBFSAMD DBFSAMD DBFSAMD :27: FPSAMP DBFSAMD DBFSAMD DBFSAMD :27: FPSAMP DBFSAMD DBFSAMD DBFSAMD :26: FPSAMP DBFSAMD :28: FPSAMP DBFSAMD DBFSAMD DBFSAMD ********************************************************** Bottom of Data *************************************************** OMEGAMON ATF Transaction-Database List report Page 6 of 14

7 OMEGAMON ATF Transaction Summary Report from 01Jun :41:45.96 to 01Jun :50:57.85 Page 1 Tran Average Elapsed Time Average CPU Time Trancode Program Count InputQ Process DLI DB2 DEP DLI DB2 MQ CTL DLISAS Total ADDINV DFSSAM ADDPART DFSSAM CEXSCONV CEXSPGM CEXSNONC CEXSPGM CEXTCONV CEXTPGM CEXTNONC CEXTPGM DGSCO001 IVPREXX DLETINV DFSSAM DLETPART DFSSAM DSPALLI DFSSAM DSPINV DFSSAM DVPTRAN2 DVPPGM IVTCV DFSIVP IVTCX DFSIVP IVTFD DFSIVP IVTFM DFSIVP IVTNO DFSIVP IVTNV DFSIVP MQATREQ1 MQATPGM PART DFSSAM *Total* ********************************************************** Bottom of Data ****************************************************** OMEGAMON ATF Transaction Summary report DLI Call Analysis report The ATF Enhanced Summary DLI Call Analysis report can show database activity within transactions. The report is available in both List and Summary format. IPIRSSL SAMPLOG - ATF ES DLI Call Analysis Command ===> Specify report options. Processing Options (Transit options): Report Interval OMEGAMON ATF ES Log Code : A0 YYYY/MM/DD HH:MM:SS:TH From To Report Output DDnames: / List List.... ATFDLILS _ Summary Summary.. ATFDLISM _ Database Selection Criteria: Object Type Inc/Exc Object + List Validation Warning Transaction Code _ Program _ Database _ User ID _ IMS Subsystem ID _ ATF ES DLI Call Analysis dialog The options are: Report Interval Within the context of the Global Report Interval, records with time stamps on or after the From Date/Time and before the To Date/Time are included in the report. Rules governing the date and time are the same as those for the Global Report Interval (see Log Global Options). Page 7 of 14

8 Enter / to select which of the reports are required. List The List report breaks down database activity within transaction by call type, showing Elapsed time and DLI time. Summary If Database is not selected, the Summary report summarizes DLI activity by transaction, with DLI call counts showing average Elapsed time and CPU time. If Database is selected, the Summary report summarizes DLI activity by database, with transaction counts showing average Elapsed time and CPU time. Report Output DDnames Specify the DDnames to be used for the List and Summary report output. The defaults are ATFDLILS for the List report and ATFDLISM for the Summary report. Selection Criteria Records can be included in or excluded from the report based on their Transaction Code, Program (PSB), Database, User ID, and IMS Subsystem ID values. This enables you to include in your extract only the information that you are interested in. You can specify a single value, a masking pattern, or an Object List. If no values are specified all records are included. Report options The format of the report command is: IMSPALOG ATFDLICALL( FROM(YYYY/MM/DD,00:00:00:00), TO(YYYY/MM/DD,23:59:59:99), LIST, SUMMARY, DATABASE, LISTDDN(ATFDLILS), SUMMDDN(ATFDLISM), INCL(TRANCODE()), INCL(PROGRAM()), INCL(DATABASE()), INCL(USERID()), INCL(IMSID())) Page 8 of 14

9 Sample report content OMEGAMON ATF DLI List Report from 09Jun :23:35.27 Page Elapsed Time CPU Time Call Summary Time Trancode Program Process DLI Total DLI Database Type Count Elapsed DLI 14:23: FPSAMP1 DBFSAMP DBFSAMD2 GHU REPL DBFSAMD4 GHU REPL DBFSAMD1 FLD :24: FPSAMP2 DBFSAMP DBFSAMD2 GHU DBFSAMD3 GHU :25: FPSAMP1 DBFSAMP DBFSAMD2 GHU REPL DBFSAMD3 GHU ISRT REPL DBFSAMD1 FLD :25: FPSAMP2 DBFSAMP DBFSAMD2 GHU REPL DBFSAMD3 GNP GHU ISRT REPL DBFSAMD1 FLD :26: FPSAMP2 DBFSAMP DBFSAMD2 GHU REPL DBFSAMD3 GHU ISRT REPL DBFSAMD1 FLD :26: FPSAMP1 DBFSAMP DBFSAMD2 GHU REPL DBFSAMD3 GHU ISRT REPL DBFSAMD1 FLD OMEGAMON ATF DLI List report OMEGAMON ATF DLI Summary by Database Report from 09Jun :23:35.27 to 09Jun :28:40.20 Page 1 Tran ---- Call Average Total Calls Database Count Trancode Type Count Elapsed CPU Elapsed CPU /Second DBFSAMD1 6 FPSAMP1 FLD FPSAMP2 FLD Subtotal DBFSAMD2 6 FPSAMP1 GHU REPL FPSAMP2 GHU REPL Subtotal DBFSAMD3 4 FPSAMP1 GNP GHU ISRT REPL FPSAMP2 GU GNP GHU ISRT REPL Subtotal DBFSAMD4 2 FPSAMP1 GHU REPL Subtotal *Total* GU GNP GHU ISRT REPL FLD ********************************************************** Bottom of Data *************************************************** OMEGAMON ATF DLI Summary by Database report Page 9 of 14

10 DB2 Call Analysis report The ATF Enhanced Summary DB2 Call Analysis report can show DB2 SQL call activity within transactions. The report is available in both List and Summary format. IPIRSSD SAMPLOG - ATF ES DB2 Call Analysis Command ===> Specify report options. Processing Options (Transit options): Report Interval OMEGAMON ATF ES Log Code : A0 YYYY/MM/DD HH:MM:SS:TH From To Report Output DDnames: / List List.... ATFDB2LS _ Summary Summary.. ATFDB2SM Selection Criteria: Object Type Inc/Exc Object + List Validation Warning Transaction Code _ Program _ User ID _ IMS Subsystem ID _ ATF ES DB2 Call Analysis dialog The options are: Report Interval Within the context of the Global Report Interval, records with time stamps on or after the From Date/Time and before the To Date/Time are included in the report. Rules governing the date and time are the same as those for the Global Report Interval (see Log Global Options). Enter / to select which of the reports are required. The List report breaks down DB2 activity within transaction by call type, showing Elapsed time and DB2 time. The Summary report shows DB2 activity summarized by transaction and SQL call type, showing call count and average Elapsed time and CPU time. Report Output DDnames Specify the DDnames to be used for the List and Summary report output. The defaults are ATFDB2LS for the List report and ATFDB2SM for the Summary report. Selection Criteria Records can be included in or excluded from the report based on their Transaction Code, Program (PSB), User ID, and IMS Subsystem ID values. This enables you to include in your extract only the information that you are interested in. You can specify a single value, a masking pattern, or an Object List. If no values are specified all records are included. Page 10 of 14

11 Report options The format of the report command is: IMSPALOG ATFDB2CALL( FROM(YYYY/MM/DD,00:00:00:00), TO(YYYY/MM/DD,23:59:59:99), LIST, SUMMARY, LISTDDN(ATFDB2LS), SUMMDDN(ATFDB2SM), INCL(TRANCODE()), INCL(PROGRAM()), INCL(DATABASE()), INCL(USERID()), INCL(IMSID())) Sample report content OMEGAMON ATF DB2 List Report from 14Jul :05:00.42 Page Elapsed Time CPU Time Call Summary Time Trancode Program Process DB2 Total DB2 Type Count Elapsed DB2 10:07: MQATREQ1 MQATPGM OTHER SELECT INSERT UPDATE DELETE OPEN TOTAL :07: MQATREQ1 MQATPGM OTHER SELECT INSERT UPDATE DELETE OPEN TOTAL ********************************************************** Bottom of Data *************************************************** OMEGAMON ATF DB2 List report Page 11 of 14

12 OMEGAMON ATF DB2 Summary Report from 14Jul :03:08.14 to 14Jul :08:05.79 Page 1 Tran - Average Elapsed Average CPU --- Call Average Total Trancode Program Count Process DB2 Total DB2 Type Count Elapsed CPU Elapsed CPU CEXSCONV CEXSPGM OTHER SELECT INSERT UPDATE DELETE OPEN TOTAL CEXTCONV CEXTPGM OTHER SELECT INSERT UPDATE DELETE OPEN TOTAL CEXTNONC CEXTPGM OTHER SELECT INSERT UPDATE DELETE OPEN TOTAL MQATREQ1 MQATPGM OTHER SELECT INSERT UPDATE DELETE OPEN TOTAL *Total* OTHER SELECT INSERT UPDATE DELETE OPEN TOTAL ********************************************************** Bottom of Data ******************************************************** OMEGAMON ATF DB2 Summary report Page 12 of 14

13 MQ Call Analysis report The ATF Enhanced Summary MQ Call Analysis report can show MQ call activity within transactions. The report is available in both List and Summary format. IPIRSSQ SAMPLOG - ATF ES MQ Call Analysis Command ===> Specify report options. Processing Options (Transit options): Report Interval OMEGAMON ATF ES Log Code : A0 YYYY/MM/DD HH:MM:SS:TH From To Report Output DDnames: / List List.... ATFMQLS _ Summary Summary.. ATFMQSM Selection Criteria: Object Type Inc/Exc Object + List Validation Warning Transaction Code _ Program _ User ID _ IMS Subsystem ID _ ATF ES MQ Call Analysis dialog The options are: Report Interval Within the context of the Global Report Interval, records with time stamps on or after the From Date/Time and before the To Date/Time are included in the report. Rules governing the date and time are the same as those for the Global Report Interval (see Log Global Options). Enter / to select which of the reports are required. The List report breaks down MQ activity within transaction by call type, showing Elapsed time and MQ time. The Summary report shows MQ activity summarized by transaction and call type, showing call count and average Elapsed time and CPU time. Report Output DDnames Specify the DDnames to be used for the List and Summary report output. The defaults are ATFMQLS for the List report and ATFMQSM for the Summary report. Selection Criteria Records can be included in or excluded from the report based on their Transaction Code, Program (PSB), User ID, and IMS Subsystem ID values. This enables you to include in your extract only the information that you are interested in. You can specify a single value, a masking pattern, or an Object List. If no values are specified all records are included. Page 13 of 14

14 Report options The format of the report command is: IMSPALOG ATFMQCALL( FROM(YYYY/MM/DD,00:00:00:00), TO(YYYY/MM/DD,23:59:59:99), LIST, SUMMARY, LISTDDN(ATFMQLS), SUMMDDN(ATFMQSM), INCL(TRANCODE()), INCL(PROGRAM()), INCL(DATABASE()), INCL(USERID()), INCL(IMSID())) Sample report content OMEGAMON ATF MQ List Report from 14Jul :03:08.14 Page Elapsed Time CPU Time Call Summary Time Trancode Program Process MQ Total MQ Type Count Elapsed MQ 10:07: MQATREQ1 MQATPGM MQGET MQPUT MQCONN MQOPEN MQCLOS MQDISC :07: MQATREQ1 MQATPGM MQGET MQPUT MQCONN MQOPEN MQCLOS MQDISC :07: MQATREQ1 MQATPGM MQGET MQPUT MQCONN MQOPEN MQCLOS MQDISC :07: MQATREQ1 MQATPGM MQGET MQPUT MQCONN MQOPEN MQCLOS MQDISC ********************************************************** Bottom of Data *************************************************** OMEGAMON ATF MQ List report OMEGAMON ATF MQ Summary Report from 14Jul :03:08.14 to 14Jul :08:05.79 Page 1 Tran - Average Elapsed Average CPU --- Call Average Total Trancode Program Count Process MQ Total MQ Type Count Elapsed CPU Elapsed CPU MQATREQ1 MQATPGM MQPUT MQCONN MQCLOS MQSUB *Total* MQPUT MQCONN MQCLOS MQSUB ********************************************************** Bottom of Data **************************************************** OMEGAMON ATF MQ Summary report Page 14 of 14