IBM OS Starting the collection of affinity data, When you can start collecting affinity data

Page 49

„5… The total number of affinity records in the affinity data VSAM ®les. If the Detector was stopped by CICS crashing, and was in the middle of saving affinity data, this ®gure may be inaccurate. However, the ®gure is corrected the next time the Detector is started.

„6… The date and time when the Detector was last started, data was saved, and a change was made to an affinity table. The date is given in the format speci®ed by the DATFORM system initialization parameter.

„7… The total time that the Detector has been in the running and paused states since it was last started.

„8… The name, and current percentage occupied, of the MVS dataspace being used. (This is not displayed while in STOPPED state.)

„9… The message line used to display diagnostic messages.

„10… The keys that you can use to select functions to affect the operation of the Detector, or to get help information about it. This line displays all possible functions, not all of which are appropriate (or selectable) for a given state of the Detector.

Starting the collection of affinity data

When you can start collecting affinity data

You can start collecting affinity data only when the Detector is currently stopped.

To start collecting affinity data, use one of the methods shown in Table 3.

Table 3. Methods for starting data collection by the Detector

Where used

Command or function key

 

 

Control display, CAFF01

F5 function key „1…

 

 

3270 terminal

CAFF START

 

 

Console

F cicsjob, CAFF START „2…

 

 

Application program

EXEC CICS START TRANSID('CAFF') FROM('START') „3…

 

 

Notes:

„1… If you press the F5 function key of the CAFF01 screen, you are asked to con®rm that you want to start the recording of affinity data.

„2… cicsjob is the name of your CICS startup job.

„3… You can use this command from a program initiated during the third stage of CICS initialization: that is, a program speci®ed in the second part of the PLTPI list for the CICS region. For more information about using PLTPI programs, see the CICS Customization Guide.

Using one of the methods listed in Table 3 causes the Detector to record transaction affinities in the CICS region, until you pause or stop data collection by the Detector. Data is collected for only the affinity types that you have chosen to be detected (by specifying Y for the affinity type on the CAFF02 screen).

Chapter 5. Running the Detector 33

Page 48 Page 50
Image 49
Page 48 Page 50
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 Transaction Server for OS/390 BibliographyCics books for Cics Transaction Server for OS/390 Other Cics books CICSPlex SM books for Cics Transaction Server for OS/390Summary of changes Xiv Cics Transaction Affinities Utility Guide Affinities, see the Cics Application Programming Guide Introducing transaction affinitiesRouting region Requesting regionTarget region What does dynamic routing cost? Benets of dynamic routingTransaction affinities Transaction-system affinity Inter-transaction affinityAffinity relations GlobalCics programming techniques for transaction affinity Affinity lifetimesUnsafe programming techniques Safe programming techniquesSuspect programming techniques Avoiding the effects of transaction affinityProtecting applications from one another What next? Important note Introducing the Transaction Affinities UtilityAffinity utility program components Commands detected by the Transaction Affinities Utility Detector component Scanner componentDetector components What is detectedWorsening of transaction affinities relations What is not detectedHow the affinity data is collected Controlling the DetectorSaving affinity data Control record Vsam le Affinity data Vsam lesReporter component Detector performanceBuilder component Report presenting the affinity data in a readable formIntroducing the Transaction Affinities Utility Cics Transaction Affinities Utility Guide Creating the Vsam les Preparing to use the affinity utility programEstimating the size of the MVS data space and Vsam les #termids Dening the Vsam les to CicsPreparing to use the affinity utility program Cics Transaction Affinities Utility Guide Creating a summary report Running the ScannerAffmod DD statement Cics Transaction Affinities Utility Creating a detailed reportContents of a detailed report Is an example of a detailed report produced by the Scanner Cics Transaction Affinities Utility Guide Changing the state Running the DetectorChanging the options CAFF01 Displaying the Detector control screenStarting the collection of affinity data When you can start collecting affinity dataWhen you can pause affinity data collection Pausing the collection of affinity dataWhen you can resume collecting affinity data Resuming the collection of affinity dataStopping the collection of affinity data When you can stop collecting affinity dataCAFF02 Changing the Detector options„1… The control options Perform periodic saves Restore data on startSize of dataspace „4… Last update by useridTransid prex „2… Detect affinity typesDetector errors Cics Transaction Affinities Utility Guide Requesting a report from the Reporter Running the ReporterCAUAFF1, CAUAFF2, and CAUAFF3 DD statements Caucntl DD statementsCmdgrps DD statement Output from the ReporterTrangrps DD statement System Affinity report„2… Affinity types reported „1… Incorrect affinity types„3… Affinities reports TrangroupCommand RecoverableAffinity LifetimeTerminal Producing affinity transaction group denitionsBTS Task Total TransactionsAfflifesystem Descaddress CWA Using the affinity reportModifying affinity transaction groups Understanding the affinitiesRemove false affinities Remove affinity relation worseningCompressing affinity data SPI commands Using the IBM Cross System ProductENQUEUEs/DEQUEUEs Shared storageENQUEUE/DEQUEUE Detailed affinity analysisGetmain Shared SPI commands Cics Transaction Affinities Utility Guide DSPSIZE=16number Running the BuilderCONTEXT=plexname Repgrps DD statement Syntax for input to the BuilderAffgrps DD statement Builder input syntax Output from the Builder Header statementsCombined affinity transaction group denitions Combining basic affinity transaction groups Relation a Relation B Resultant relation C Empty transaction groups report Data sets processed reportGroup merge report Sample group merge report Error reportSample error report Cics Transaction Affinities Utility Guide ENQ/DEQ Appendix A. Details of what is detectedLoad HOLD/RELEASE TS commandsAddress CWA CANCEL/DELAY/POST/START Wait commands SPI commandsCics Transaction Affinities Utility Guide Scanner output Reporter outputExamples Example 2±VS Cobol Which occurs for the rst Move Move Cobol affinities Logon or System when Pconv expectedUnrecognized Transids Cics Transaction Affinities Utility Guide Detector table manager diagnostics Appendix D. DiagnosticsFunction code values Table identier values Reason code values Date formatter diagnostics Detector Cafb request queue manager diagnosticsReason code values This sectionIndex Bappl Vsam Cics Transaction Affinities Utility Guide Sending your comments to IBM Ibmr IBM
Top Page Image Contents