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