Manuals
/
IBM
/
Computer Equipment
/
Credit Card Machine
IBM
OS manual CICS Transaction Affinities Utility Guide
Models:
OS
1
100
103
103
Download
103 pages
52.71 Kb
96
97
98
99
100
101
102
103
<
>
Install
CICSPlex SM Problem Determination
Appendix D. Diagnostics
Commands detected by the Transaction Affinities Utility
Detector errors
Cancel/Delay/Post/Start
v Restore data on start
How to
What is
„4… Last update by userid
Page 100
Image 100
84
CICS Transaction Affinities Utility Guide
Page 99
Page 101
Page 100
Image 100
Page 99
Page 101
Contents
CICS Transaction Server for OS/390
CICS Transaction Affinities Utility Guide
Release
Page
CICS Transaction Server for OS/390
CICS Transaction Affinities Utility Guide
Release
Third edition March
Contents
Chapter 1. Introducing transaction affinities
Chapter 2. Introducing the Transaction Affinities Utility
Chapter 3. Preparing to use the affinity utility program
Appendix A. Details of what is detected
Appendix B. Correlating Scanner and Reporter output to source
Appendix C. Useful tips when analyzing Transaction Affinities Utility
Contents
vi CICS Transaction Affinities Utility Guide
Notices
Trademarks
BookManager
CICS
CICS/ESA
How to use this book
Preface
What this book is about
Who this book is for
Notes on terminology
Argument zero
Bibliography
CICS Transaction Server for OS/390
CICS books for CICS Transaction Server for OS/390
CICS Transaction Server for OS/390 Planning for Installation
CICSPlex SM books for CICS Transaction Server for OS/390
Other CICS books
CICSPlex SM View Commands Reference Summary
CICSPlex SM Administration
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
xiv CICS Transaction Affinities Utility Guide
Chapter 1. Introducing transaction affinities
Routing region
Requesting region
Target region
What does dynamic routing cost?
The benets of dynamic routing
Transaction affinities
Inter-transaction affinity
Transaction-system affinity
Affinity relations
Global
Affinity lifetimes
CICS programming techniques for transaction affinity
Userid
System
Safe programming techniques
Unsafe programming techniques
Suspect programming techniques
Avoiding the effects of transaction affinity
Protecting applications from one another
What next?
8 CICS Transaction Affinities Utility Guide
Chapter 2. Introducing the Transaction Affinities Utility
Important note
Figure 2. Affinity utility program components
10 CICS Transaction Affinities Utility Guide
Commands detected by the Transaction Affinities Utility
The Scanner component
The Detector component
What is detected
Worsening of transaction affinities relations
What is not detected
Worsening of transaction affinities lifetimes
Controlling the Detector
How the affinity data is collected
Saving affinity data
The affinity data VSAM les
The control record VSAM le
Detector performance
The Reporter component
The Builder component
v A report presenting the affinity data in a readable form
Chapter 2. Introducing the Transaction Affinities Utility
20 CICS Transaction Affinities Utility Guide
Creating the VSAM les
Chapter 3. Preparing to use the affinity utility program
Estimating the size of the MVS data space and VSAM les
Dening the VSAM les to CICS
Chapter 3. Preparing to use the affinity utility program
24 CICS Transaction Affinities Utility Guide
Chapter 4. Running the Scanner
Creating a summary report
v The JOB accounting parameters v The PARM statement
$SUMMARY
v The AFFMOD DD statement
v The PARM statement
Creating a detailed report
$DETAIL
Contents of a detailed report
v The DETAIL DD statement
v The STEPLIB DD statement
v The INPUT DD statement
± The total possible affinity commands
± The total possible MVS post commands
v A summary report of the modules, giving
Figure 5 is an example of a detailed report produced by the Scanner
30 CICS Transaction Affinities Utility Guide
v Changing the state
Chapter 5. Running the Detector
v Changing the options
Displaying the Detector control screen
When you can start collecting affinity data
Starting the collection of affinity data
Pausing the collection of affinity data
When you can pause affinity data collection
When you can resume collecting affinity data
Resuming the collection of affinity data
When you can stop collecting affinity data
Stopping the collection of affinity data
Changing the Detector options
v Restore data on start
„1… The control options v Perform periodic saves
„4… Last update by userid
v Size of dataspace
v Transid prex
„2… Detect affinity types
Detector errors
40 CICS Transaction Affinities Utility Guide
Chapter 6. Running the Reporter
Requesting a report from the Reporter
v The JOB accounting parameters
v The PARM parameter of the EXEC statement For example
Output from the Reporter
v The CMDGRPS DD statement
v The TRANGRPS DD statement
v The SYSPRINT DD statement
Figure 8. A sample report output by the Reporter Part 1 of
Affinity report
Figure 8. A sample report output by the Reporter Part 2 of
Notes for Figure „1… Incorrect affinity types
„2… Affinity types reported
„3… Affinities reports
Trangroup
Recoverable
Command
Affinity
Lifetime
Producing affinity transaction group denitions
Terminal
BTS Task
Total Transactions
Using the affinity report
Understanding the affinities
Modifying affinity transaction groups
v Remove false affinities
v Remove affinity relation worsening
Compressing affinity data
v Remove affinity lifetime worsening
v Change LUNAME affinity relation to USERID
v Add WAIT affinities
Using the IBM Cross System Product
SPI commands
Affinity analysis for a CICS region containing CSP 3.3 applications
ENQUEUEs/DEQUEUEs
Detailed affinity analysis
ENQUEUE/DEQUEUE
Temporary storage queues
GETMAIN SHARED
52 CICS Transaction Affinities Utility Guide
SPI commands
54 CICS Transaction Affinities Utility Guide
Chapter 7. Running the Builder
v The PARM parameter of the EXEC statement
DSPSIZE=16number
MATCH=LUNAMEUSERID
Syntax for input to the Builder
v The REPGRPS DD statement
v The AFFGRPS DD statement
v The SYSPRINT DD statement
HEADER statement. Otherwise comment lines are thrown away
HEADER statements
Output from the Builder
Combined affinity transaction group denitions
58 CICS Transaction Affinities Utility Guide
Combining basic affinity transaction groups
Builder produces a report that lists the combinations that occurred
Data sets processed report
Empty transaction groups report
Group merge report
Lifetime
Error report
Figure 14. Sample group merge report
Figure 15. Sample error report
64 CICS Transaction Affinities Utility Guide
Appendix A. Details of what is detected
ENQ/DEQ
TS commands
LOAD HOLD/RELEASE
RETRIEVE WAIT/START
66 CICS Transaction Affinities Utility Guide
ADDRESS CWA
LOAD/FREEMAIN
GETMAIN SHARED/FREEMAIN
CANCEL/DELAY/POST/START
SPI commands
WAIT commands
70 CICS Transaction Affinities Utility Guide
Appendix B. Correlating Scanner and Reporter output to source
Reporter output
Scanner output
Examples
Example 2±VS COBOL
DFHEIV0
To determine the EXEC CICS command
For the Scanner output
The COBOL source after translation was
The equivalent Assembler-language is
001126 MOVE
74 CICS Transaction Affinities Utility Guide
COBOL affinities
LOGON or SYSTEM when PCONV expected
Unrecognized Transids
76 CICS Transaction Affinities Utility Guide
Detector table manager diagnostics
Appendix D. Diagnostics
Function code values
Table identier values
Reason code values
Detector CAFB request queue manager diagnostics
Date formatter diagnostics
Reason code values
This section
Index A
continued
Page
84 CICS Transaction Affinities Utility Guide
Sending your comments to IBM
Program Number
IBMR
SC33-1777-02
Release
CICS Transaction Affinities Utility Guide
Spine information
CICS TS for OS/390