-
IBM OS - page 1
CIC S® T ransa ct i o n Se rv er f o r OS /39 0® CI CS T r a ns a cti o n Af fini ti es U tili ty G ui d e Relea se 3 SC33-1777-02 IBM ...
-
IBM OS - page 2
...
-
IBM OS - page 3
CIC S® T ransa ct i o n Se rv er f o r OS /39 0® CI CS T r a ns a cti o n Af fini ti es U tili ty G ui d e Relea se 3 SC33-1777-02 IBM ...
-
IBM OS - page 4
Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page vii. Third edition (March 1999) This edition applies to Release 3 of CICS T ransaction Server for OS/390, program number 5655-147, and to all subsequent versions, releases, and modifications until otherwise indicated ...
-
IBM OS - page 5
Contents Notices ........................... v i i T rademarks .......................... viii Preface ........................... i x What this book is about ..................... i x Who this book is for ...................... i x What you need to know to understand this book ........... i x How to use this book ..................... i x Determin ...
-
IBM OS - page 6
Creating the VSAM files ..................... 2 1 Estimating the size of the MVS data space and VSAM files ........ 2 1 Defining the VSAM files to CICS .................. 2 2 T ailoring your CICS startup job ................... 2 3 Restarting your CICS region ................... 2 3 Chapter 4. Running the Scanner ................. 2 5 Creating ...
-
IBM OS - page 7
Reporter output ........................ 7 1 Scanner output ........................ 7 1 Examples ......................... 7 1 Appendix C. Useful tips when analyzing T ransaction Aff inities Utility reports .......................... 7 5 COBOL aff inities ........................ 7 5 LOGON or SYSTEM when PCONV expected ............. 7 5 Unrecogniz ...
-
IBM OS - page 8
vi CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 9
Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or ...
-
IBM OS - page 10
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Programming License Agreement, or any equivalent agreement between us. T rademarks The following terms are trademarks of International Business Machines Corporation in the United ...
-
IBM OS - page 11
Preface What this book is about This book describes the af finity utility program . It explains what the utility does, how to install it, and how to run the various components of the utility . Who this book is for This book is for CICS system programmers who may be planning to use CICS dynamic routing for workload balancing, and need to determine w ...
-
IBM OS - page 12
usually in step. However , due to the time required to print and distribute hardcopy books, the BookManager version is more likely to have had last-minute changes made to it before publication. Subsequent updates will probably be available in softcopy before they are available in hardcopy . This means that at any time from the availability of a rel ...
-
IBM OS - page 13
Bibliography CICS T ransaction Server for OS/390 CICS T ransaction Server for OS/390: Planning for Installation GC33-1789 CICS T ransaction Server for OS/390 Release Guide GC34-5352 CICS T ransaction Server for OS/390 Migration Guide GC34-5353 CICS T ransaction Server for OS/390 Installation Guide GC33-1681 CICS T ransaction Server for OS/390 Progr ...
-
IBM OS - page 14
CICSPlex SM books for CICS T ransaction Server for OS/390 General CICSPlex SM Master Index SC33-1812 CICSPlex SM Concepts and Planning GC33-0786 CICSPlex SM User Interface Guide SC33-0788 CICSPlex SM View Commands Reference Summary SX33-6099 Administration and Management CICSPlex SM Administration SC34-5401 CICSPlex SM Operations Views Reference SC ...
-
IBM OS - page 15
Summary of changes The aff inity utility program is an integral part of CICS T ransaction Server for OS/390 and is for use only with the CICS T ransaction Server for OS/390. T o use the utility on CICS for MVS/ESA 4.1 and earlier releases of CICS, install the IBM CICS T ransaction Affinities Utility MVS/ESA (program number 5696-582). Changes for th ...
-
IBM OS - page 16
xiv CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 17
Chapter 1. Introducing transaction af finities This chapter provides a brief introduction to the concept of transaction aff inities and the associated CICS programming techniques, and highlights the significance of transaction aff inities in a dynamic routing (known in previous releases of CICS as dynamic transaction routing) environment. For more ...
-
IBM OS - page 18
CICS T ransaction Server for OS/390 Release 3 introduces extended dynamic routing facilities, that allow the dynamic routing of: v T ransactions initiated at a terminal v EXEC CICS ST ART requests that are associated with a terminal v EXEC CICS ST ART requests that are not associated with a terminal v Dynamic program link (DPL) requests that are re ...
-
IBM OS - page 19
The benefits of dynamic routing Being able to route transactions to target regions dynamically offers many benefits in an online transaction processing (OL TP) system. The user can achieve: v Improved performance v Improved availability v Simplified systems management What does dynamic routing cost? Of course, the CICS-supplied code cannot deter ...
-
IBM OS - page 20
Note that, if you are dynamically routing non-terminal-related ST ART and DPL requests, you should review your application to determine whether or not the application is suitable for dynamic routing. The T ransaction Affinities Utility cannot detect aff inities in these circumstances. Inter-transaction af finity Inter-transaction aff inity is an af ...
-
IBM OS - page 21
Userid A group of transactions where all instances of the transactions that are initiated from a terminal and executed on behalf of the same userid must execute in the same target region for the lifetime of the aff inity . The af finity lifetime for userid relations can be pseudoconversation, signon, system, or permanent. Af finity lifetimes The af ...
-
IBM OS - page 22
Safe programming techniques The programming techniques in the safe category are the use of: v The communication area (COMMAREA) on CICS RETURN commands v A terminal control table user area (TCTUA) optionally available for each terminal defined to CICS v ENQMODEL definitions to give sysplex-wide scope to ENQs and DEQs Unsafe programming techniques ...
-
IBM OS - page 23
Protecting applications from one another The transaction isolation function offers storage protection between application programs, ensuring that one application does not accidentally overwrite the storage of another . T ransaction isolation ensures that user-key programs 1 execute in their own subspace, with appropriate access to any shared storag ...
-
IBM OS - page 24
What next? This chapter has briefly summarized the techniques and commands that can cause transaction aff inity . “Chapter 2. Introducing the T ransaction Affinities Utility” on page 9 gives an overview of the T ransaction Af finities Utility , and details of all the commands and command sequences that the T ransaction Aff inities Utility look ...
-
IBM OS - page 25
Chapter 2. Introducing the T ransaction Af finities Utility This chapter gives an overview of the T ransaction Affinities Utility , and describes the basic components: v “Commands detected by the T ransaction Affinities Utility” on page 1 1 v “The Scanner component” on page 12 v “The Detector component” on page 12 v “The Reporter comp ...
-
IBM OS - page 26
Figure 2 shows the affinity utility program. Each of the four components is described in more detail in the rest of this chapter . Report Report Scanner Detector Reporter Builder User AOR or TOR/AOR Collected Affinity Data Combined Affinity Transaction Groups Basic Affinity Transaction Groups Application Load Library T o CICSPlex SM 1. 2. 3. 4. Fig ...
-
IBM OS - page 27
Commands detected by the T ransaction Aff inities Utility Y ou can use the T ransaction Af finities Utility to detect instances of the EXEC CICS commands listed in T able 1. T able 1. Commands detected by the T ransaction Affinities Utility Inter-transaction aff inity commands T ransaction-system aff inity commands ENQ DEQ READQ TS WRITEQ TS DELETE ...
-
IBM OS - page 28
The Scanner component The Scanner is a batch utility that scans a load module library to detect those programs in the library that issue EXEC CICS commands that may cause transaction aff inity . It examines the individual object programs looking for patterns matching the argument zero 3 format for the commands in question. The Scanner detects the u ...
-
IBM OS - page 29
Y ou are recommended to run the Detector on stable CICS regions only . Do not apply maintenance to application programs while the Detector is running. Such maintenance may introduce or remove aff inities, thus rendering collected data inaccurate. What is detected The Detector detects the EXEC CICS commands listed in T able 1 on page 1 1 that can ca ...
-
IBM OS - page 30
v Log offs and sign of fs by intercepting messages DFHSN1200, DFHZC3462, and DFHZC5966. v Completion of CICS BTS activities and processes. For more information, see “Appendix A. Details of what is detected” on page 65. Worsening of transaction af finities relations In some cases, the Detector may not detect enough occurrences (at least 10) of a ...
-
IBM OS - page 31
v Command is a non-terminal-related ST ART or a DPL v ENQ or DEQ commands that specify a resource name for which an appropriate ENQMODEL definition is enabled, and that ENQMODEL has a non—blank ENQSCOPE The Detector does not detect CICS macro-level commands, MVS POST calls, or the hand posting of ECBs. If you continue a pseudoconversation by set ...
-
IBM OS - page 32
2. There is an affinity table for each of the following command groups that cause transaction-system aff inity: v INQUIRE, SET , ENABLE, DISABLE, EXTRACT , COLLECT ST A TS, PERFORM, DISCARD, CREA TE, and RESYNC commands v CICS BTS BROWSE commands are treated as inquire commands v W AITCICS, WAIT EVENT , and WAIT EXTERNAL commands 3. There are two a ...
-
IBM OS - page 33
The af finity data VSAM files The Detector uses three non-recoverable VSAM KSDS to hold saved aff inity data. Ensure the files are big enough to hold the maximum amount of aff inity data that might be collected. Three are required because of the wide range of key lengths that the different tables have. KSDS files are used because the Detector an ...
-
IBM OS - page 34
Detector performance The Detector is intended to be run against production CICS regions. However , over the period when the Detector is running, the CICS region suffers a performance degradation (dependent on the workload and number of aff inities) equivalent to the performance impact of vendor monitor products that use the same user exits. The Det ...
-
IBM OS - page 35
The basic groups are combined because of a CICSPlex SM rule stating that a given tranid may appear only in a single transaction group. It is quite possible that a tranid may appear in more than one basic group, and so these must be combined to form larger groups that satisfy CICSPlex SM. Chapter 2. Introducing the T ransaction Affinities Utility 19 ...
-
IBM OS - page 36
20 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 37
Chapter 3. Preparing to use the af finity utility program This chapter describes what needs to be done before you can use the aff inity utility program. v “Creating the VSAM files” v “Estimating the size of the MVS data space and VSAM files” v “Defining the VSAM files to CICS” on page 22 v “T ailoring your CICS startup job” on p ...
-
IBM OS - page 38
#transids is the number of transaction identifiers in the CICS region. #termids is the number of terminal identifiers in the CICS region. Note: The amount of storage needed in the data space for the Builder is about 25% of the storage needed for the Detector . The algorithm assumes that all aff inities are represented, and that all transactions p ...
-
IBM OS - page 39
v For file CAUCNTL only , if recovery is not required ensure that RECOVERY(NONE) and FWDRECOVLOG(NO) are specified. 3. INST ALL group mygroup to make these definitions known to CICS. T ailoring your CICS startup job T o enable the T ransaction Affinities Utility to be run against your CICS region, take account of the following when setting up yo ...
-
IBM OS - page 40
24 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 41
Chapter 4. Running the Scanner This chapter describes how to run the Scanner that scans load modules for instances of API commands that could cause inter-transaction affinity and transaction-system aff inity . Y ou can run the Scanner to produce either a summary report and module list to identify suspect modules or a detailed report of modules that ...
-
IBM OS - page 42
v The AFFMOD DD statement Specify the name of the sequential data set where the list of modules with potential transaction aff inities is to be sent. Y ou can edit the data set to alter the list of modules to be scanned before running the Scanner to produce a detailed report. v The DET AIL DD statement (dummy) Y ou do not need this for a summary ru ...
-
IBM OS - page 43
Creating a detailed report Y ou can request a detailed report from the Scanner by editing and running the job CAUJCLLD. Change the following statements as appropriate: v The P ARM statement PARM='$DETAIL[,ALL]' $DET AIL Specifies that a detailed scan and report is required. The extent of the scan is defined by either the ALL parameter o ...
-
IBM OS - page 44
v The STEPLIB DD statement Specify the name of the T ransaction Affinities Utility load library in which you have installed the Scanner program, CAULMS. v The INPUT DD statement Specify the name of the load library to be scanned. v The SYSPRINT DD statement Specify the destination for the detailed report. v The AFFMOD DD dummy statement Y ou do not ...
-
IBM OS - page 45
v A summary report of the modules, giving: – The total possible affinity commands – The total possible MVS post commands v Library totals, as for the summary report, but for only those modules selected for the detailed run. Figure 5 is an example of a detailed report produced by the Scanner . CICS TRANSACTION AFFINITIES UTILITY 1995/11/24 Page ...
-
IBM OS - page 46
30 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 47
Chapter 5. Running the Detector This chapter describes how to run the Detector that runs in a CICS region looking for instances of API commands that could cause transaction affinity . This chapter describes how to perform the following functions: v “Displaying the Detector control screen” on page 32 v “Starting the collection of aff inity dat ...
-
IBM OS - page 48
Displaying the Detector control screen T o display the control screen that you can use to run the Detector at a CICS terminal, first type the transaction identifier CAFF , then press Enter . In response, the Detector control screen, CAFF01 (shown in Figure 6), is displayed. Y ou can use this screen to review and change the state of the Detector , ...
-
IBM OS - page 49
5 The total number of aff inity records in the affinity data VSAM files. If the Detector was stopped by CICS crashing, and was in the middle of saving aff inity data, this figure may be inaccurate. However , the figure is corrected the next time the Detector is started. 6 The date and time when the Detector was last started, data ...
-
IBM OS - page 50
Each time the Detector is started, a new data space is created. For help with calculating the likely data space storage requirement, see “Estimating the size of the MVS data space and VSAM files” on page 21. Y ou specify this size on the Detector options screen, CAFF02. Y ou can also specify that data from aff inity data VSAM files (for examp ...
-
IBM OS - page 51
T able 5. Methods for resuming data collection by the Detector Where used Command or function key Control display , CAFF01 F8 function key 3270 terminal CAFF CONTINUE Console F cicsjob, CAFF CONTINUE 1 Application program EXEC CICS ST ART TRANSID(’CAFF’) FROM(’CONTINUE’) Note: 1 cicsjob is the name of your CICS startup job. ...
-
IBM OS - page 52
Note: If there are a large number of data records to be saved, the CAFF screen may be frozen for some appreciable time, until the records have been saved. Y ou may want to stop the Detector when it has detected all affinities. This is indicated by the “Date/time of last change” field changing very infrequently and, if the optional periodic sav ...
-
IBM OS - page 53
The Detector options screen, CAFF02, shows the options available to you. Y ou can change an option only when the Detector has stopped, unless one of the notes that follow says otherwise. Notes: 1 The control options: v Perform periodic saves Whether or not you want the aff inity data collected to be saved to the affinity data VSAM files if ...
-
IBM OS - page 54
ensure that this option is the same as that used in the previous run of the Detector (for which aff inity data is to be restored). v Size of dataspace The size that you want to use for the data space to store the aff inity data collected. The size of the data space is fixed for a run of the Detector . For information about estimating the size of t ...
-
IBM OS - page 55
Detector errors If the CAFF or CAFB transaction, or an exit program, encounters a serious error , the Detector stops by terminating CAFF and CAFB with one of the following termination codes: v A code in the AUxx range accompanied by messages on the CAFF transient data queue that indicate the cause of the error v A code not in the AUxx range, presum ...
-
IBM OS - page 56
40 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 57
Chapter 6. Running the Reporter This chapter describes how to run the Reporter that runs as a batch job to produce a report of the aff inities found by the Detector . The commands reported on are those listed in “Commands detected by the T ransaction Affinities Utility” on page 1 1. For information about interpreting the report output by the Re ...
-
IBM OS - page 58
v The CMDGRPS DD statement Specify the aff inity (command) types you want to see in the report. Only those aff inity types listed on this DD statement are shown in the report. (The types correspond exactly to the type options on the CAFF02 screen.) Y ou can specify any of the following aff inity types, with each type on a separate line, starting in ...
-
IBM OS - page 59
Af finity report Figure 8 shows an example report for two affinities, a TS queue af finity and a CW A aff inity . These were the only af finity types selected, as shown. CICS TRANSACTION AFFINITIES UTILITY 1995/11/24 Page 1 AFFINITY TYPE REPORTING OPTIONS Applid=CICSPDN1 Affinity Type Reporting Message ------------- --------- ---------------------- ...
-
IBM OS - page 60
Notes for Figure 8: 1 Incorrect aff inity types This lists any aff inity types that were specified incorrectly on the CMDGRPS DD statement of the CAUJCLRP job. 2 Aff inity types reported This lists any aff inity types that were selected for reporting; that is, those affinity types specified correctly on the CMDGRPS DD statement of ...
-
IBM OS - page 61
Note: The T rangroup value for an af finity transaction group may vary from one run to another of the Detector or Reporter . Aff inity The af finity relation. If appropriate, this also indicates whether the relation was worsened from a less restrictive relation. For more information about worsened relations, see “Worsening of transaction af finit ...
-
IBM OS - page 62
Usage The number of times that this particular EXEC CICS command (with the transaction, program, and offset values reported) taking part in the af finity , up to a limit of 5000. Note: The usage count is an indication of the relative importance of the aff inity , and is not a completely accurate usage count. For performance reasons, when the usage ...
-
IBM OS - page 63
2. MA TCH or ST A TE attributes are not generated on CREA TE TRANGRP commands, because those attributes are relevant only to the combined aff inity transaction groups. For more information about MA TCH and ST A TE attributes, see page 55. 3. The HEADER statement is generated so that the Builder can detect a new data set in its input concatenation. ...
-
IBM OS - page 64
Understanding the af finities The inter-transaction aff inities listed in the report highlight those transactions that have aff inities with other transactions. Understanding the aff inities present in the CICS region enables you to determine which of the them are most pervasive. If you decide that it is worth changing your application programs, it ...
-
IBM OS - page 65
to be convinced that it is related to a terminal or userid. Change this to LUNAME or USERID (and correct the lifetime) if you know that the aff inity really is terminal- or userid-related. Y ou may want to prevent worsening by specifying WORSEN=NO. v Remove aff inity lifetime worsening An LUNAME aff inity with a lifetime of LOGON, or a USERID affin ...
-
IBM OS - page 66
Using the IBM Cross System Product The following information about the IBM Cross System Product (CSP) 4GL application generator concentrates on tests carried out running CSP 3.3, but in general the information also applies to later releases of CSP . There are two components to CSP: v CSP/AD (Application Development) is used to develop the applicati ...
-
IBM OS - page 67
Detailed af finity analysis Each of the above command scenarios is dealt with below . A description of how the use of the command appears in the T ransaction Affinities Utility Reporter report is given, followed by an assessment of any aff inity problem it causes. However , it would be helpful first to expand on the structure of a CSP segmented ap ...
-
IBM OS - page 68
There may also be an EQ aff inity group in the report with a resource name of CSMT when CSP serializes writing of information to TD destination CSMT . This does not cause aff inity because each cloned CICS has its own CSMT . GETMAIN SHARED There is a GM aff inity group in the report for each pair of transactions that were observed performing GETMAI ...
-
IBM OS - page 69
an aff inity of LUNAME and a lifetime of PCONV . The presence of one group rather than a group for each application is actually not important. When dynamic routing, the aff inity still ends when the current pseudoconversation ends, so the effect is exactly the same. It is useful to have applied the PTF for CSP AP AR PN45100, because this adds delet ...
-
IBM OS - page 70
54 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 71
Chapter 7. Running the Builder This chapter describes how to run the Builder that runs as a batch job to build aff inity transaction groups suitable for input to the CICS system management product, the CICSPlex SM element of CICS T ransaction Server for OS/390 Release 3. This chapter contains the following information: v “Syntax for input to the ...
-
IBM OS - page 72
Specify the name of the T ransaction Affinities Utility load library where you have installed the Builder program, CAUBLD. v The REPGRPS DD statement Specify the (concatenation of) names of the sequential data sets containing the basic aff inity transaction groups to be input to the Builder . The Builder reads the lines of the input data sets, and ...
-
IBM OS - page 73
9. If a line comment contains the characters HEADER anywhere in it, it is not treated as a comment and is parsed like any ordinary line in case it is a HEADER statement. Otherwise comment lines are thrown away . 10. The only valid values for AFFINITY are GLOBAL, LUNAME, USERID, and BAPPL. NONE is not allowed. 1 1. Keywords and values (including sur ...
-
IBM OS - page 74
HEADER statements The HEADER statement is specific to the Builder , and is not a CICSPlex SM statement. It is produced by the Reporter , and is needed by the Builder to create unique transaction group names. The Reporter generates temporary transaction group names (for example, CW .00000001 and TS.00000001) while it is running, and stores these na ...
-
IBM OS - page 75
Notes: 1. The values of the SA VEDA TE and SA VETIME fields in the HEADER statement give the latest save date and save time from any of the input data sets. (See Figure 1 1 ( 1 ) and Figure 12 on page 61.) 2. The combined transaction groups can be input again to the Builder . For example, you may decide to: a. Use the Reporter , then the B ...
-
IBM OS - page 76
through “Aff inity relations” on page 4 show the relations and lifetimes that result from combining basic aff inity transaction groups. T o help you analyze the effect of combining basic transaction af finity groups, the Builder produces a report that lists the combinations that occurred. T able 7. Resultant af finity relations Relation A Relat ...
-
IBM OS - page 77
T able 1 1. Resultant affinity lifetimes (GLOBAL relation) Lifetime X Lifetime Y Resultant lifetime Z PERMANENT Any lifetime PERMANENT Any other lifetime combination SYSTEM Data sets processed report This report gives the names of all the input data sets (specified on the REPGRPS DD statement) that were read. This is produced even if errors occur ...
-
IBM OS - page 78
Error report This report gives the syntax or logic of any errors that were detected in the processing of the input files. Each error is accompanied by a message. For a description of the message, see the CICS Messages and Codes manual. CICS TRANSACTION AFFINITIES UTILITY 1995/11/28 Page 3 BUILDER GROUP MERGE REPORT Trangroup : AFF1GRP Affinity : L ...
-
IBM OS - page 79
CICS TRANSACTION AFFINITIES UTILITY 1996/02/08 Page 1 BUILDER REPGRPS ERROR REPORT Dataset = CICSPDN1.TRANGRPS.ERR1 Line Number Statement in error ----------- ------------------------------------------------------------------------------ 5 CREATE TRANGRP NAME(G3 ) AFFINITY(GLOBAL) AFFLIFE(LOGON ); DFHAU5038 INVALID AFFLIFE for AFFINITY. 6 CREATE TR ...
-
IBM OS - page 80
64 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 81
Appendix A. Details of what is detected This appendix describes what is detected by the Detector and Reporter for each aff inity type. Additionally , it highlights the differences, if any , with what the Scanner detects. (In general, the Scanner always detects more, because it covers paths that may not get exercised by the Detector , and because it ...
-
IBM OS - page 82
TS commands v The aff inity here is between all transactions that use the same TS queue. It applies to both MAIN and AUXILIARY TS. The match is made on the name of the TS queue. v The aff inity relation can be GLOBAL, BAPPL, LUNAME, or USERID. v Lifetime can be PCONV , LOGON, SIGNON, ACTIVITY , PROCESS,SYSTEM, and PERMANENT . A MAIN queue cannot be ...
-
IBM OS - page 83
v If the transaction to be ST ART ed is defined as remote or a remote SYSID was specified on the ST ART command so that the command is function shipped to a remote CICS region, no data is collected. v Commands in error are treated in the same way as commands that give a NORMAL response, so data is collected. Scanner dif ferences : Scanner detects ...
-
IBM OS - page 84
v The LOAD and FREEMAIN protocol applies only to programs defined as RELOAD(YES). Note that HOLD is irrelevant, as CICS Program Control never sees the FREEMAIN, or knows the storage location of the individual task’s copy , and so cannot release the program at task end. This implies that all LOADs must be examined as they are all effectively LOAD ...
-
IBM OS - page 85
v Lifetime can be PCONV , LOGON, SIGNON, ACTIVITY , PROCESS, SYSTEM, or PERMANENT . The PROTECT option determines whether SYSTEM or PERMANENT would be used. However , the Detector always worsens LOGON and SIGNON to SYSTEM or PERMANENT , because of limitations in the way that this aff inity is detected. The aff inity relation for DELA Y and POST may ...
-
IBM OS - page 86
70 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 87
Appendix B. Correlating Scanner and Reporter output to source This appendix describes how to match the EXEC CICS command in the Reporter report and/or the Scanner detail report with the actual program source code. It also gives some examples of the procedures described. Reporter output The reported offset of a command is the of fset from the start ...
-
IBM OS - page 88
Example 2–VS COBOL II The literal pool in VS COBOL II is part of the CGT . Having calculated the offset from the start of the program, you should subtract the start of the CGT from your calculated offset to get the of fset within the CGT . In the listing, there is an MVC instruction with the argument zero as the source, of the form: MVC D1(L,R1), ...
-
IBM OS - page 89
For this, the calculations are: Scanner offset = X'7A6' CICS stub length = X'28' Offset of CGT = X'B8' CGT base register = GPR 10 Offset within CGT = X'7A6' - X'28' - X'B8' = X'6C6' = 1734 (decimal) MVC instruction looks like: MVC d(l,r),1734(10) DFHEIV0 PGMLIT AT ... T o determi ...
-
IBM OS - page 90
001126 MOVE 2. Look at the COBOL source for the MOVE at line 001 126. This is for the EXEC CICS WRITEQ TS command starting on line 001 124. 74 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 91
Appendix C. Useful tips when analyzing T ransaction Af finities Utility reports Sometimes the report produced by the Reporter from data gathered from the Detector can contain some results that appear odd at first glance. This appendix gives tips for resolving such results. COBOL af finities If an application program is invoked using the native CAL ...
-
IBM OS - page 92
76 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 93
Appendix D. Diagnostics This appendix contains these sections: v “Detector table manager diagnostics” v “Detector CAFB request queue manager diagnostics” on page 80 v “Date formatter diagnostics” on page 80 Detector table manager diagnostics This section lists the meaning for each possible value of the call parameters that are included ...
-
IBM OS - page 94
T able identifier values AUTM_EDSR 1 AUTM_EDST 2 AUTM_EDR 3 AUTM_EDT 4 AUTM_TSQ 5 AUTM_TST 6 AUTM_LRP 7 AUTM_LRT 8 AUTM_SRS 9 AUTM_SRT 10 AUTM_CWA 11 AUTM_CWT 12 AUTM_GFA 13 AUTM_GFM 14 AUTM_LFA 15 AUTM_LFM 16 AUTM_ICR 17 AUTM_ICM 18 AUTM_SPI 19 AUTM_WAIT 20 AUTM_TT 21 AUTM_UT 22 AUTM_BLD_DNT 28 AUTM_BLD_GNT 29 AUTM_BLD_TT 30 AUTM_BLD_MERGED 31 78 ...
-
IBM OS - page 95
Reason code values AUTM_INVALID_FUNCTION 0 AUTM_NO_STORAGE 1 AUTM_ELEMENT_NOT_FOUND 2 AUTM_ELEMENT_EXISTS 3 AUTM_INVALID_TABLE 4 AUTM_IEFUSI_HIT 5 AUTM_TABLE_EXISTS 6 AUTM_TABLE_DOES_NOT_EXIST 7 AUTM_POOL_EXISTS 8 AUTM_POOL_DOES_NOT_EXIST 9 AUTM_INVALID_CURSOR 10 AUTM_DEFAULT_SIFD_ERROR 192 AUTM_DEFAULT_SIFA_ERROR 193 AUTM_DEFAULT_DSP_ERROR 194 AUT ...
-
IBM OS - page 96
Detector CAFB request queue manager diagnostics This section Lists the meaning for each possible value of the call parameters that are included in the error messages issued if an error occurs on a call to the Detector CAFB request queue manager , CAUCAFP . Function code values AUCP_ADD_CELL_FIRST 1 AUCP_ADD_CELL_LAST 2 AUCP_CREATE_CPOOL 3 AUCP_DEST ...
-
IBM OS - page 97
Index A activity 5 aff inity avoiding 6 combining basic aff inity transaction groups 59 control record VSAM file 17 data VSAM files 17 inter-transaction 4 lifetimes 4 overview 3 programming techniques 5 safe 6 suspect 6 unsafe 6 relations 4 transaction group definitions, producing 46 transaction-system 4 aff inity data VSAM files 17 aff inity t ...
-
IBM OS - 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 aff inities lifetimes 14 worsening of aff inities relations 14 diagnostics CAFB request queue manager 80 data formatter 80 table manager 77 dynamic transaction routing bene ...
-
IBM OS - page 99
T target region 2 temporary storage compression 49 T ransaction Affinities Utility Builder overview 18 commands detected 1 1 control record VSAM file 17 data VSAM files 17 date formatter diagnostics 80 Detector overview 12 overview 9 preparing to use 21 Reporter overview 18 Scanner overview 12 what is detected 13 what is not detected 14 transacti ...
-
IBM OS - page 100
84 CICS T ransaction Affinities Utility Guide ...
-
IBM OS - page 101
Sending your comments to IBM If you especially like or dislike anything about this book, please use one of the methods listed below to send your comments to IBM. Feel free to comment on what you regard as specific errors or omissions, and on the accuracy , organization, subject matter , or completeness of this book. Please limit your comments to t ...
-
IBM OS - page 102
IBMR Program Number: 5655-147 Printed in the United States of America on recycled paper containing 10% recovered post-consumer fiber . SC33-1777-02 ...
-
IBM OS - page 103
Spine information: IBM CI CS TS f o r OS /3 9 0 CI C S T r ans a cti o n Af finiti es U tility G ui d e Re lease 3 ...
Do you have a question concerning IBM OS?
Use the form below
If you did not solve your problem by using a manual IBM OS, ask a question using the form below. If a user had a similar problem with IBM OS it is likely that he will want to share the way to solve it.