CICS TS for Z/OS 4.2: Operations and Utilities Guide Chapter 15
Total Page:16
File Type:pdf, Size:1020Kb
CICS Transaction Server for z/OS Version 4 Release 2 IBM Operations and Utilities Guide SC34-7213-01 CICS Transaction Server for z/OS Version 4 Release 2 IBM Operations and Utilities Guide SC34-7213-01 Note Before using this information and the product it supports, read the information in “Notices” on page 223. This edition applies to Version 4 Release 2 of CICS Transaction Server for z/OS (product number 5655-S97) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 1989, 2014. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Preface .............. vii Chapter 5. How to shut down CICS .. 29 What this book is about .......... vii CICS shutdown ............. 29 Who should read this book?......... vii Normal shutdown (PERFORM SHUTDOWN) .. 30 What you need to know to understand this book vii Immediate shutdown (PERFORM SHUTDOWN How to use this book ........... vii IMMEDIATE)............. 31 Notes on terminology ........... vii Shutting down CICS normally ........ 32 Softcopy links ............. viii Shutting down CICS immediately ....... 33 Shutdown command options ........ 34 Changes in CICS Transaction Server for z/OS, Version 4 Release 2 ....... ix Part 2. The CICS utility programs 35 Part 1. Operating CICS regions ... 1 Chapter 6. Reading log streams using batch jobs (for example, DFHJUP) ... 37 Chapter 1. Overview of CICS operations 3 SUBSYS=(LOGR,DFHLGCNV,...) keyword .... 37 What happens when you start CICS ...... 3 Using the SETBRCUR, REPBRCUR and The types of CICS startup ......... 3 DELBRCUR options for log stream processing .. 44 CICS actions on an initial start ....... 4 Using DFHJUP to read log streams ...... 45 CICS actions on a cold start ........ 4 DD statements for DFHJUP or your own batch job 46 CICS actions on a warm start ........ 5 Utility control statements for DFHJUP ..... 47 CICS actions on an emergency restart ..... 8 CONTROL statement .......... 48 CICS startup and the z/OS Communications OPTION statement ........... 49 Server session ............. 9 Options............... 49 End of CICS startup ........... 9 END statement ............ 54 Controlling CICS operation ......... 9 COMMENTS statement ......... 54 DFHJUP return codes ........... 54 Chapter 2. Starting up CICS regions .. 11 Managing the size of log streams ....... 54 System log ............. 54 Specifying system initialization parameters before General logs ............. 55 startup ................ 11 Log data accessible to DFHJUP ........ 55 The START system initialization parameter ... 12 Example of log data that is accessible to DFHJUP 56 Starting CICS as a batch job ......... 12 Diagnostic information in DFHJUP output .... 56 Starting CICS as a started task ........ 13 Examples of using DFHJUP ......... 57 Overriding system initialization parameters during Example 1 .............. 57 startup ................ 15 Example 2 .............. 58 Entering corrections to parameters at the console 15 Example 3 .............. 59 System console messages for CICS startup .... 16 Example 4 .............. 59 CICS Transaction Server resource usage collection Examples of the use of the OPTION parameters 60 for software pricing............ 19 Version 4 Release 2 format ........ 61 COMPAT41 format ........... 62 Chapter 3. Operating CICS in a OPTION parameter values ........ 64 multiregion environment ....... 21 Chapter 7. Statistics utility program Chapter 4. Operating CICS from a (DFHSTUP) ............. 67 console device ........... 23 Setting the statistics recording status, end-of-day Entering commands from a console device .... 23 time and recording interval ......... 67 Entering commands from TSO ....... 24 Support for Katakana devices ........ 69 Using JCL to initiate CICS commands ..... 24 Job to run the DFHSTUP program ....... 69 Console device messages .......... 25 The DFHSTUP extract statistics reporting function 72 Console message-formatting ........ 25 The DFH0STXR sample program ...... 72 Replying to messages .......... 26 The DFH0STXD sample program ...... 74 Replying to messages from transactions started at Using the extract statistics reporting function .. 76 console devices ............ 26 Control parameters of the DFHSTUP program... 78 Suppressing and rerouting messages ..... 27 © Copyright IBM Corp. 1989, 2014 iii Chapter 8. Recovery statistics program DFH$MOLS control statement descriptions ... 130 (DFH$STER) ............ 87 Abend codes and error messages for DFH$MOLS 138 Recovery Manager domain recovery messages... 87 101: INVALID, DUPLICATE, OR MISSING Statistics sample program, DFH$STER ..... 88 CONTROL CARD INFORMATION ..... 138 Installing DFH$STER ........... 88 102: ERROR - INCOMPATIBLE CONTROL CARD OPTIONS REQUESTED ...... 138 Chapter 9. Trace utility print program 103: SORT ENDED WITH NON-ZERO RET CODE; RC='nn'; REPORT IS TERMINATED .. 138 (DFHTU670) ............ 89 104: NO DATA FOR THIS CICS DATA The CICS trace utility program, DFHTU670 ... 89 SECTION; REPORT IS TERMINATED .... 139 The trace selection parameters for DFHTU670 ... 90 105: UNKNOWN CLASS IN CICS DATA Identifying trace entries from their SECTION; REPORT IS TERMINATED .... 139 transaction-attach entries ......... 95 106: NO VALID MONITORING RECORDS Rules for coding trace selection parameters ... 95 WERE READ; REPORT IS TERMINATED ... 139 Using IPCS to print trace records written to GTF .. 97 107: NO MONITORING RECORDS WERE The GTFTRACE subcommand of IPCS and SELECTED FOR PROCESSING; REPORT IS associated parameters .......... 97 TERMINATED ............ 139 Sample batch job to print CICS GTF trace entries 98 108: X‘nnnn’ - CONNECTOR NOT DEFINED; Invoking the CICS formatting routine from TSO 99 REPORT IS TERMINATED ........ 139 109: NO DICTIONARY ESTABLISHED; Chapter 10. Dump utilities (DFHDU670 REPORT IS TERMINATED ........ 140 and DFHPD670) .......... 101 110: NO DICTIONARY ESTABLISHED FOR Selecting output for the transaction dump utility NEW APPLID xxxxxxxx; REPORT IS program (DFHDU670) .......... 101 TERMINATED ............ 140 Format of the SYSIN control statements ... 102 112: There is no message text, but MVS abends Job control statements for the transaction dump U112 without a dump. ......... 140 utility program (DFHDU670) ........ 105 113: UNABLE TO OPEN DDNAME ‘INPUT’; Using IPCS to format and analyze CICS dumps: REPORT IS TERMINATED ........ 140 Overview............... 106 114: UNABLE TO OPEN DDNAME ‘xxxxxxxx’; Preparing to use IPCS to format CICS SDUMPs 107 REPORT IS TERMINATED ........ 141 The SDUMP options needed to support the 116: NO FILE RESOURCE ENTRIES..... 141 CICS dump exit ........... 107 117: NO TSQUEUE RESOURCE ENTRIES ... 141 Specifying DFHIPCSP CICS exit control data 118: UNABLE TO EXPAND A COMPRESSED needed .............. 108 RECORD, RC='nn'; REPORT IS TERMINATED . 141 Making the required CICS dump exit routines 119: UNABLE TO OPEN DDNAME 'xxxxxxxx'; available .............. 109 REPORT IS TERMINATED ........ 141 Selecting parts of the CICS internal trace table .. 109 120: UNEXPECTED CSRCESRV QUERY Using CICS-supplied dump exit routines to format ERROR, RC='nn'; REPORT IS TERMINATED .. 142 CICS SDUMPs ............. 110 121: NO DPL RESOURCE ENTRIES ..... 142 The CICS dump exit parameters ...... 111 Exceptions to the scope of the DEF parameter 112 Chapter 13. Load module scanner Examples of the use of level numbers .... 112 (DFHEISUP) ............ 143 The CICS670 dump exit component keywords 113 Creating a filter input file for the load module The dump summary and error index ..... 114 scanner ............... 144 Sample jobs to process a CICS SDUMP using the Creating a summary report using the load module CICS dump exit ............ 115 scanner ............... 147 Creating a detailed report using the load module Chapter 11. Monitoring dictionary scanner ............... 149 utility program (DFHMNDUP) ..... 119 Activating trace for the load module scanner ... 153 Generating a performance dictionary record using DFHMNDUP ............. 119 Chapter 14. Batch-enabling sample Parameters for the DFHMNDUP program .... 121 programs for RLS access-mode data Sample job illustrating the use of DFHMNDUP 122 sets (DFH0BATx) .......... 155 Preparing data sets for batch operations using the Chapter 12. Sample monitoring data DFH0BATx sample programs ........ 156 print program (DFH$MOLS) ..... 125 Installing the DFH0BATx sample programs .. 158 Processing CICS monitoring data ....... 126 Preparing input for the DFH0BATx sample Sample job stream for DFH$MOLS ...... 127 programs .............. 158 DFH$MOLS control statements summary .... 128 Rules for coding DFH$MOLS control statements 130 iv CICS TS for z/OS 4.2: Operations and Utilities Guide Chapter 15. Identify macro-level Setting an initial start without operator programs utility program intervention ............. 195 (DFHMSCAN) ........... 161 Examining the override record ...... 195 Resetting a warm or emergency start .... 196 How DFHMSCAN works ......... 161 Improving the performance of a cold start... 196 JCL to run DFHMSCAN.......... 162 Producing a summary report from DFHMSCAN 162 Producing a detailed report from DFHMSCAN .. 163 Chapter 20. BMS macro generation Limitations of the DFHMSCAN program .... 164 utility program (DFHBMSUP) ..... 199 DD statements for DFHBMSUP ....... 199 Chapter 16. Stagger end-of-day time Return codes from DFHBMSUP ....... 199 sample utility program (DFH$STED).. 165 Example of using DFHBMSUP ....... 200 Example of DFHBMSUP