Manuals
/
IBM
/
Computer Equipment
/
Credit Card Machine
IBM
OS manual vi CICS Transaction Affinities Utility Guide
Models:
OS
1
8
103
103
Download
103 pages
52.71 Kb
5
6
7
8
9
10
11
12
<
>
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 8
Image 8
vi
CICS Transaction Affinities Utility Guide
Page 7
Page 9
Page 8
Image 8
Page 7
Page 9
Contents
Release
CICS Transaction Affinities Utility Guide
CICS Transaction Server for OS/390
Page
Release
CICS Transaction Affinities Utility Guide
CICS Transaction Server for OS/390
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
Target region
Requesting region
Routing region
Transaction affinities
The benets of dynamic routing
What does dynamic routing cost?
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 lifetimes
What is not detected
Worsening of transaction affinities relations
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
Estimating the size of the MVS data space and VSAM les
Chapter 3. Preparing to use the affinity utility program
Creating the 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
$DETAIL
Creating a detailed report
v The PARM statement
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 options
Chapter 5. Running the Detector
v Changing the state
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 2 of
Affinity report
Figure 8. A sample report output by the Reporter Part 1 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
52 CICS Transaction Affinities Utility Guide
GETMAIN SHARED
Temporary storage queues
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
GETMAIN SHARED/FREEMAIN
LOAD/FREEMAIN
ADDRESS CWA
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
Unrecognized Transids
LOGON or SYSTEM when PCONV expected
COBOL affinities
76 CICS Transaction Affinities Utility Guide
Function code values
Appendix D. Diagnostics
Detector table manager diagnostics
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
SC33-1777-02
IBMR
Program Number
Release
CICS Transaction Affinities Utility Guide
Spine information
CICS TS for OS/390