Manuals
/
IBM
/
Computer Equipment
/
Credit Card Machine
IBM
Release, CICS Transaction Affinities Utility Guide, Spine information, CICS TS for OS/390
Models:
OS
1
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 103
Image 103
Spine information:
IBM
CICS TS for OS/390
CICS Transaction Affinities Utility Guide
Release 3
Page 102
Page 103
Image 103
Page 102
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 3. Preparing to use the affinity utility program
Contents
Chapter 1. Introducing transaction affinities
Chapter 2. Introducing the Transaction Affinities Utility
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
CICS/ESA
Trademarks
BookManager
CICS
Who this book is for
How to use this book
Preface
What this book is about
Argument zero
Notes on terminology
CICS Transaction Server for OS/390 Planning for Installation
Bibliography
CICS Transaction Server for OS/390
CICS books for CICS Transaction Server for OS/390
CICSPlex SM Administration
CICSPlex SM books for CICS Transaction Server for OS/390
Other CICS books
CICSPlex SM View Commands Reference Summary
Changes for the CICS Transaction Server for OS/390 Release 1 edition
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
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
Global
Inter-transaction affinity
Transaction-system affinity
Affinity relations
System
Affinity lifetimes
CICS programming techniques for transaction affinity
Userid
Avoiding the effects of transaction affinity
Safe programming techniques
Unsafe programming techniques
Suspect programming techniques
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
v A report presenting the affinity data in a readable form
Detector performance
The Reporter component
The Builder component
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
$SUMMARY
Chapter 4. Running the Scanner
Creating a summary report
v The JOB accounting parameters v The PARM statement
v The AFFMOD DD statement
v The PARM statement
Creating a detailed report
$DETAIL
v The INPUT DD statement
Contents of a detailed report
v The DETAIL DD statement
v The STEPLIB DD statement
Figure 5 is an example of a detailed report produced by the Scanner
± The total possible affinity commands
± The total possible MVS post commands
v A summary report of the modules, giving
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
Resuming 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
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
„2… Detect affinity types
„4… Last update by userid
v Size of dataspace
v Transid prex
Detector errors
40 CICS Transaction Affinities Utility Guide
v The PARM parameter of the EXEC statement For example
Chapter 6. Running the Reporter
Requesting a report from the Reporter
v The JOB accounting parameters
v The SYSPRINT DD statement
Output from the Reporter
v The CMDGRPS DD statement
v The TRANGRPS 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
Trangroup
Notes for Figure „1… Incorrect affinity types
„2… Affinity types reported
„3… Affinities reports
Lifetime
Recoverable
Command
Affinity
Total Transactions
Producing affinity transaction group denitions
Terminal
BTS Task
Using the affinity report
v Remove affinity relation worsening
Understanding the affinities
Modifying affinity transaction groups
v Remove false affinities
v Add WAIT affinities
Compressing affinity data
v Remove affinity lifetime worsening
v Change LUNAME affinity relation to USERID
ENQUEUEs/DEQUEUEs
Using the IBM Cross System Product
SPI commands
Affinity analysis for a CICS region containing CSP 3.3 applications
ENQUEUE/DEQUEUE
Detailed affinity analysis
Temporary storage queues
GETMAIN SHARED
52 CICS Transaction Affinities Utility Guide
SPI commands
54 CICS Transaction Affinities Utility Guide
MATCH=LUNAMEUSERID
Chapter 7. Running the Builder
v The PARM parameter of the EXEC statement
DSPSIZE=16number
v The SYSPRINT DD statement
Syntax for input to the Builder
v The REPGRPS DD statement
v The AFFGRPS DD statement
HEADER statement. Otherwise comment lines are thrown away
58 CICS Transaction Affinities Utility Guide
HEADER statements
Output from the Builder
Combined affinity transaction group denitions
Combining basic affinity transaction groups
Builder produces a report that lists the combinations that occurred
Lifetime
Data sets processed report
Empty transaction groups report
Group merge report
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
66 CICS Transaction Affinities Utility Guide
TS commands
LOAD HOLD/RELEASE
RETRIEVE WAIT/START
ADDRESS CWA
LOAD/FREEMAIN
GETMAIN SHARED/FREEMAIN
CANCEL/DELAY/POST/START
WAIT commands
SPI commands
70 CICS Transaction Affinities Utility Guide
Examples
Appendix B. Correlating Scanner and Reporter output to source
Reporter output
Scanner output
DFHEIV0
Example 2±VS COBOL
The equivalent Assembler-language is
To determine the EXEC CICS command
For the Scanner output
The COBOL source after translation was
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
This section
Detector CAFB request queue manager diagnostics
Date formatter diagnostics
Reason code values
Index A
continued
Page
84 CICS Transaction Affinities Utility Guide
Sending your comments to IBM
Program Number
IBMR
SC33-1777-02
CICS TS for OS/390
Release
CICS Transaction Affinities Utility Guide
Spine information