IBM OS manual Bappl

Page 98

Detector	(continued)
saving data 17
starting data collection				33
stopping data collection				35
table manager diagnostics					77
what is detected			13
what is not detected 14
worsening of affinities lifetimes						14
worsening of affinities relations						14
diagnostics
CAFB request queue manager						80
data formatter 80
table manager			77
dynamic transaction routing
bene®ts		3
compared to static routing					1
cost	3
overview		1

G

global affinity relation 4

H

HEADER statements, Builder 58

HOLD commands 66

I

installing the affinity utility program creating the VSAM ®les 21 data space size 21 overview 21

restarting your CICS region 23 tailoring your CICS startup job 23

L

lifetime of affinities
activity	5
logon 5
overview	4
permanent		5
process	5
pseudoconversation				5
signon	5
system	5
worsening		14
log off, detection of			14
logon affinity lifetime			5
LUname affinity relation				4

P

permanent affinity lifetime 5 process 5

programming techniques for transaction affinity safe 6

suspect 6 unsafe 6

protecting applications from one another 7 pseudoconversation affinity lifetime 5 pseudoconversation end, 13

R

relation of affinities
BAPPL	4
global	4
LUname 4
overview		4
userid	4
worsening		14
RELEASE commands				66
Reporter	41
affinity transaction group de®nitions, producing 46
affinity transaction groups, modifying							48
compressing affinity data					49
output	42
output report 43
output report (example)					43
overview		18
running	31, 41
understanding the affinities						48
using the report			47
reports
affinity report, Reporter					43
analyzing, useful tips				75
creating a detailed report, Scanner							27
creating a summary report, Scanner							25
data sets processed report, Builder							61
detailed, contents of				28
detailed report, Scanner					27
empty transaction groups report, Builder 61
error report, Builder				62
group merge report, Builder						61
requesting region			2
routing region		2

S

safe programming techniques				6
saving data	16
Scanner
creating a detailed report				27
input parameters			27
output contents			28
creating a summary report				25
input parameters			25
output contents			26
overview	12
running	25
sign off, detection of		14
signon affinity lifetime			5
static transaction routing
compared to dynamic routing					1
summary report (Scanner)
creating	25
output contents		26
output example		27
suspect programming techniques					6
system affinity lifetime			5

82 CICS Transaction Affinities Utility Guide

Image 98

Contents IBM Page IBM Third edition March Contents Appendix A. Details of what is detected Reporter output Scanner output Examples Vi Cics Transaction Affinities Utility Guide Vii Trademarks Preface Argument zero Cics books for Cics Transaction Server for OS/390 BibliographyCics Transaction Server for OS/390 CICSPlex SM books for Cics Transaction Server for OS/390 Other Cics booksSummary of changes Xiv Cics Transaction Affinities Utility Guide Introducing transaction affinities Affinities, see the Cics Application Programming GuideTarget region Requesting regionRouting region Transaction affinities Benets of dynamic routingWhat does dynamic routing cost? Affinity relations Inter-transaction affinityTransaction-system affinity GlobalAffinity lifetimes Cics programming techniques for transaction affinitySuspect programming techniques Safe programming techniquesUnsafe programming techniques Avoiding the effects of transaction affinityProtecting applications from one another What next? Introducing the Transaction Affinities Utility Important noteAffinity utility program components Commands detected by the Transaction Affinities Utility Scanner component Detector componentWhat is detected Detector componentsWhat is not detected Worsening of transaction affinities relationsControlling the Detector How the affinity data is collectedSaving affinity data Affinity data Vsam les Control record Vsam leBuilder component Detector performanceReporter component Report presenting the affinity data in a readable formIntroducing the Transaction Affinities Utility Cics Transaction Affinities Utility Guide Estimating the size of the MVS data space and Vsam les Preparing to use the affinity utility programCreating the Vsam les Dening the Vsam les to Cics #termidsPreparing to use the affinity utility program Cics Transaction Affinities Utility Guide Running the Scanner Creating a summary reportAffmod DD statement Creating a detailed report Cics Transaction Affinities UtilityContents of a detailed report Is an example of a detailed report produced by the Scanner Cics Transaction Affinities Utility Guide Changing the options Running the DetectorChanging the state Displaying the Detector control screen CAFF01When you can start collecting affinity data Starting the collection of affinity dataWhen you can resume collecting affinity data Pausing the collection of affinity dataWhen you can pause affinity data collection Resuming the collection of affinity dataWhen you can stop collecting affinity data Stopping the collection of affinity dataChanging the Detector options CAFF02Restore data on start „1… The control options Perform periodic savesTransid prex „4… Last update by useridSize of dataspace „2… Detect affinity typesDetector errors Cics Transaction Affinities Utility Guide CAUAFF1, CAUAFF2, and CAUAFF3 DD statements Running the ReporterRequesting a report from the Reporter Caucntl DD statementsTrangrps DD statement Output from the ReporterCmdgrps DD statement Affinity report System„3… Affinities reports „1… Incorrect affinity types„2… Affinity types reported TrangroupAffinity RecoverableCommand LifetimeBTS Task Producing affinity transaction group denitionsTerminal Total TransactionsUsing the affinity report Afflifesystem Descaddress CWARemove false affinities Understanding the affinitiesModifying affinity transaction groups Remove affinity relation worseningCompressing affinity data ENQUEUEs/DEQUEUEs Using the IBM Cross System ProductSPI commands Shared storageDetailed affinity analysis ENQUEUE/DEQUEUEGetmain Shared SPI commands Cics Transaction Affinities Utility Guide CONTEXT=plexname Running the BuilderDSPSIZE=16number Affgrps DD statement Syntax for input to the BuilderRepgrps DD statement Builder input syntax Combined affinity transaction group denitions Header statementsOutput from the Builder Combining basic affinity transaction groups Relation a Relation B Resultant relation C Group merge report Data sets processed reportEmpty transaction groups report Error report Sample group merge reportSample error report Cics Transaction Affinities Utility Guide Appendix A. Details of what is detected ENQ/DEQTS commands Load HOLD/RELEASEAddress CWA CANCEL/DELAY/POST/START SPI commands Wait commandsCics Transaction Affinities Utility Guide Examples Reporter outputScanner output Example 2±VS Cobol Which occurs for the rst Move Move Unrecognized Transids Logon or System when Pconv expectedCobol affinities Cics Transaction Affinities Utility Guide Function code values Appendix D. DiagnosticsDetector table manager diagnostics Table identier values Reason code values Reason code values Detector Cafb request queue manager diagnosticsDate formatter diagnostics This sectionIndex Bappl Vsam Cics Transaction Affinities Utility Guide Sending your comments to IBM Ibmr IBM