IBM OS manual

Contents

Main Page Page Page Contents iv Page Page Notices Trademarks viii Preface What this book is about CICSPlex SM Concepts and Planning Who this book is for What you need to know to understand this book Notes on terminology x Bibliography CICS Transaction Server for OS/390 CICS books for CICS Transaction Server for OS/390 CICSPlex SM books for CICS Transaction Server for OS/390 Other CICS books xii CICS Transaction Server for OS/390: Planning for Installation If you have any questions about the CICS Transaction Server for OS/390 library, see Summary of changes Changes for the CICS Transaction Server for OS/390 Release 3 edition Changes for the CICS Transaction Server for OS/390 Release 2 edition Changes for the CICS Transaction Server for OS/390 Release 1 edition Page Chapter 1. Introducing transaction affinities transaction CICSPlex SM Concepts and Planning CICS Application Programming Guide CICSPlex SM Managing Workloads 2 The benets of dynamic routing What does dynamic routing cost? Transaction affinities Inter-transaction affinity Transaction-system affinity Affinity relations 4 Affinity lifetimes CICS programming techniques for transaction affinity Safe programming techniques Unsafe programming techniques Suspect programming techniques Avoiding the effects of transaction affinity 6 Protecting applications from one another Page Chapter 2. Introducing the Transaction Affinities Utility 10 1. 2. 3.4. Figure 2. Affinityutility program components Commands detected by the Transaction Affinities Utility The Scanner component The Detector component 12 What is detected Worsening of transaction affinities relations Worsening of transaction affinities lifetimes What is not detected 14 Controlling the Detector How the affinity data is collected Saving affinity data 16 The affinity data VSAM les The control record VSAM le Detector performance The Reporter component 18 The Builder component Page Page Chapter 3. Preparing to use the affinity utility program Creating the VSAM les Estimating the size of the MVS data space and VSAM les #transids #termids Dening the VSAM les to CICS 22 mygroup Tailoring your CICS startup job CICS Resource Denition Guide Restarting your CICS region Page Chapter 4. Running the Scanner Creating a summary report 26 Creating a detailed report Contents of a detailed report 28 Figure 5. Example of a detailed report produced by the Scanner Page Chapter 5. Running the Detector Displaying the Detector control screen 32 Starting the collection of affinity data CICS Customization Guide Pausing the collection of affinity data Resuming the collection of affinity data 34 Stopping the collection of affinity data CICS Customization Guide Changing the Detector options 36 multiple signon with same userid not 38 Detector errors Page Chapter 6. Running the Reporter Requesting a report from the Reporter Output from the Reporter 42 Affinity report Figure 8. Asample report output by the Reporter (Part 1 of 4) Figure 8. Asample report output by the Reporter (Part 2 of 4) 44 Page Producing affinity transaction group denitions 46 Using the affinity report Understanding the affinities Modifying affinity transaction groups 48 Compressing affinity data Using the IBM Cross System Product Affinity analysis for a CICS region containing CSP 3.3 applications 50 Detailed affinity analysis ENQUEUE/DEQUEUE GETMAIN SHARED Temporary storage queues 52 SPI commands Page Chapter 7. Running the Builder CICSPlex SM Managing Business Applications Syntax for input to the Builder CICS Transaction Server for OS/390 Installation Guide 56 Page HEADER statements Output from the Builder 58 Combined affinity transaction group denitions Combining basic affinity transaction groups 60 Data sets processed report Empty transaction groups report Group merge report Error report 62 manual. Figure 14. Sample group merge report Figure 15. Sample error report Page Appendix A. Details of what is detected ENQ/DEQ TS commands LOAD HOLD/RELEASE RETRIEVE WAIT/START 66 ADDRESS CWA GETMAIN SHARED/FREEMAIN LOAD/FREEMAIN CANCEL/DELAY/POST/START 68 SPI commands WAIT commands Page Appendix B. Correlating Scanner and Reporter output to source Reporter output Scanner output Examples Example 1Assembler-language Example 2VS COBOL II 72 For this, the calculations are: To determine the EXEC CICS command: 1. Look at the Assembler-language for which occurs for the rst MOVE For the Scanner output: The COBOL source after translation was: Page Appendix C. Useful tips when analyzing Transaction Affinities Utility reports COBOL affinities LOGON or SYSTEM when PCONV expected Unrecognized Transids Page Appendix D. Diagnostics Detector table manager diagnostics Function code values Table identier values 78 Reason code values Detector CAFB request queue manager diagnostics Function code values 80 Reason code values Date formatter diagnostics Index A B C D (continued) G H 82 I L T U V Page Sending your comments to IBM