home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / cicspa2.zip / 5764-091.INF (.txt) next >
OS/2 Help File  |  1995-09-28  |  190KB  |  3,999 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. CICS for OS/2 Performance Analyser User's Guide ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5. ΓòÉΓòÉΓòÉ 2. Version Notice ΓòÉΓòÉΓòÉ
  6.  
  7. Sixth Edition, September 1995 
  8.  
  9. This edition applies to Version 1.2.1 of CICS for OS/2 Performance Analyser, 
  10. program number 5764-091 and to all subsequent releases and modifications until 
  11. otherwise indicated in new editions. 
  12.  
  13. A form for reader's comments is provided at the back of this publication. If 
  14. the form has been removed, address your comments to: 
  15.  
  16. IBM United Kingdom Laboratories
  17. Transaction Systems Marketing Support (MP207)
  18. Hursley Park
  19. Hursley
  20. Hampshire, SO21 2JN, England
  21.  
  22. When you send information to IBM, you grant IBM a non-exclusive right to use or 
  23. distribute the information in any way it believes appropriate without incurring 
  24. any obligation to you.  You may continue to use the information that you 
  25. supply. Copyright International Business Machines Corporation 1995. All rights 
  26. reserved. 
  27. Note to U.S. Government Users - Documentation related to restricted rights - 
  28. Use, duplication or disclosure is subject to restrictions set forth in GSA ADP 
  29. Schedule Contract with IBM Corporation. 
  30.  
  31.  
  32. ΓòÉΓòÉΓòÉ 3. Notices. ΓòÉΓòÉΓòÉ
  33.  
  34. The following paragraph does not apply in any country where such provisions are 
  35. inconsistent with local law. 
  36.  
  37. INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" 
  38. WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT 
  39. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A 
  40. PARTICULAR PURPOSE. 
  41. Some states do not allow disclaimer of express or implied warranties in certain 
  42. transactions, therefore this statement may not apply to you. 
  43.  
  44. References in this publication to IBM products, programs, or services do not 
  45. imply that IBM intends to make these available in all countries in which IBM 
  46. operates. 
  47.  
  48. Any reference to an IBM licensed program or other IBM product in this 
  49. publication is not intended to state or imply that only IBM's program or other 
  50. product may be used.  Any functionally equivalent program that does not 
  51. infringe any of the intellectual property rights may be used instead of the IBM 
  52. product. Evaluation and verification of operation in conjunction with other 
  53. products, except those expressly designated by IBM, is the user's 
  54. responsibility. 
  55.  
  56. IBM may have patents or pending patent applications covering subject matter in 
  57. this document.  The furnishing of this document does not give you any license 
  58. to these patents.  You can send license inquiries, in writing, to the IBM 
  59. Director of Licensing, IBM Corporation, 500 Columbus Avenue, Thornwood, New 
  60. York 10594, USA. 
  61.  
  62. The information contained in this document has not be submitted to any formal 
  63. IBM test and is distributed AS IS.  The use of the information or the 
  64. implementation of any of these techniques is a customer responsibility and 
  65. depends on the customer's ability to evaluate and integrate them into the 
  66. customer's operational environment.  While each item has been reviewed by IBM 
  67. for accuracy in a specific situation, there is no guarantee that the same or 
  68. similar results will be obtained elsewhere.  Customers attempting to adapt 
  69. these techniques to their own environments do so at their own risk. 
  70.  
  71. The following terms are trademarks of the International Business Machines 
  72. Corporation in the United States and/or other countries: 
  73.  
  74. CICS 
  75. CICS for OS/2 
  76. IBM 
  77. Operating System/2 
  78. OS/2 
  79. Personal System/2 
  80. PS/2 
  81. DB2/2 
  82.  
  83. The following terms are trademarks of other companies: 
  84.  
  85. BTRIEVE 
  86.  
  87. BTRIEVE Technologies 
  88.  
  89. INTEL,Pentium 
  90.  
  91. Intel Corporation 
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ 4. Preface ΓòÉΓòÉΓòÉ
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 4.1. What is CICS for OS/2 Performance Analyser? ΓòÉΓòÉΓòÉ
  98.  
  99. CICS for OS/2 Performance Analyser (5764-091) is a statistics and monitoring 
  100. package for CICS for OS/2. It has been built to provide information on how CICS 
  101. transactions and resources are being used in a CICS for OS/2 Version 2.0 
  102. system. 
  103.  
  104. It has six primary uses: 
  105.  
  106.  1. To provide routine performance management information in order to track the 
  107.     number and response times of transactions over some standard interval of 
  108.     time. 
  109.  
  110.  2. To provide information that will assist in the resolution of CICS for OS/2 
  111.     performance problems. 
  112.  
  113.  3. To provide information for capacity planning purposes. 
  114.  
  115.  4. To provide application and transaction level trace so that the impact of 
  116.     the application design can be understood at the CICS Application 
  117.     Programming Interface(API) level. 
  118.  
  119.  5. To provide user clocks that enable the implementation of high level 
  120.     application timing probes, and buckets to accumulate the individual 
  121.     durations. By inserting the calls to this function around the code to be 
  122.     measured, the impact of calls to CICS or non-CICS for OS/2 resources to be 
  123.     understood. 
  124.  
  125.  6. To allow other remote CICS systems to interrogate the transaction 
  126.     statistics and user clock data held on a CICS for OS/2 Server. 
  127.  
  128. For a wider system view, the reader is encouraged to purchase the Systems 
  129. Performance Monitor/2 (SPM/2) product which provides more complete system wide 
  130. information on storage usage, paging, swap file size etc. For an introduction 
  131. to its function in a CICS for OS/2 environment, see CICS OS/2 V2.0 Sizing and 
  132. Performance IBM Corp. GG24-4190-00. 
  133.  
  134.  
  135. ΓòÉΓòÉΓòÉ 4.2. Pre-requisites ΓòÉΓòÉΓòÉ
  136.  
  137. CICS OS/2 Performance Analyser requires Service Level 04, or later, of CICS 
  138. OS/2 Version 2.0.1 (Single or Multi-user). 
  139.  
  140. To check the level of your system, look at the first message provided by CICS 
  141. for OS/2 while it is coming up. For Service Level 04 it should say: 
  142.  
  143. For the Multi-user version 
  144.  
  145. FAA0000I CICS OS/2 Version 2.0.1 
  146.  
  147. FAA0000I Service Level 00 UN00000 .Released 27-Jan-95 
  148.  
  149. FAA0003I Multi-user system initialization starting 
  150.  
  151. For the Single-user version will be similar, except it will refer to the 
  152. Single-user system instead. 
  153.  
  154. If CICS for OS/2 is not running you can look at old start-ups recorded in 
  155. CICSMSG.LOG which normally resides in the CICS200\BIN directory or enter 
  156. SYSLEVEL on the command line and look for the CICS for OS/2 entry. (In this 
  157. case, be careful not to be misled by a possible CICSOS2.$BK entry which will be 
  158. displayed as well if you have a back-up of an old CICS OS/2 level). 
  159.  
  160.  
  161. ΓòÉΓòÉΓòÉ 4.3. How this Document is Organised ΓòÉΓòÉΓòÉ
  162.  
  163. The document is organised as follows: 
  164.  
  165. Performance monitoring 
  166.  
  167.                     Provides a background to the various factors which can 
  168.                     effect the performance of CICS in any transaction system. 
  169.  
  170. CICS for OS/2 Version 2 and OS/2 
  171.  
  172.                     Describes the various factors which can effect the 
  173.                     performance of CICS for OS/2 (both at the OS/2 and CICS for 
  174.                     OS/2 level) 
  175.  
  176. Performance Analyser Installation 
  177.  
  178.                     Provides the instructions on how to install Performance 
  179.                     Analyser 
  180.  
  181. How to use Performance Analyser 
  182.  
  183.                     Describes how to use Performance Analyser 
  184.  
  185. Getting CICS for OS/2 statistics from another CICS system 
  186.  
  187.                     Describes how Performance Analyser can be used in a local 
  188.                     and/or distributed CICSplex to request statistics and 
  189.                     monitoring data from a central or distributed location 
  190.                     using Distributed Program Link. 
  191.  
  192. Transaction Level Trace 
  193.  
  194.                     Describes the transaction level trace function provided 
  195.                     with Performance Analyser. 
  196.  
  197. Application Level Trace 
  198.  
  199.                     Describes the application level trace function provided 
  200.                     with Performance Analyser. 
  201.  
  202. User Clocks 
  203.  
  204.                     Describes how to use the User Clock function provided with 
  205.                     Performance Analyser to measure execution times of 
  206.                     application code. 
  207.  
  208. Using the supplied sample program (PA2BR14) 
  209.  
  210.                     Describes how to use the the supplied sample echo program 
  211.                     (PA2BR14) to return data dependent on its invocation. This 
  212.                     can be used in a number of different ways to exercise a 
  213.                     CICS for OS/2 system. 
  214.  
  215. Trap information 
  216.  
  217.                     Describes how to use the information passed in PA2STAS.DAT 
  218.                     after a trap 
  219.  
  220. Performance Analyser statistics file 
  221.  
  222.                     Describes the format and content of the Performance 
  223.                     Analyser statistics file 
  224.  
  225. Usage Examples 
  226.  
  227.                     Examples of the usage of Performance Analyser with sample 
  228.                     output 
  229.  
  230. If you are familiar with OS/2 and CICS for OS/2 performance parameters and just 
  231. wish to get Performance Analyser installed and into productive use, you can 
  232. skip over the first two chapters and go straight to the installation 
  233. instructions.  Otherwise it is suggested you read them in order to gain an 
  234. appreciation of the parameters you can use to tune a CICS for OS/2 system 
  235. before attempting to use Performance Analyser. 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 5. Bibliography ΓòÉΓòÉΓòÉ
  239.  
  240. o OS/2 2.11 Unleashed! D.Moskowitz and D.Kerr, et al. SAMS Publishing ISBN 
  241.   0-672-30445-7 
  242.  
  243. o The Design of OS/2 H.M.Deitel,M.S.Kogan Addison Wesley ISBN 0-201-54889-5 
  244.  
  245. o OS/2 Features, Functions and Applications J.I.Krantz, A.M.Mizell, 
  246.   R.L.Williams Wiley ISBN 0-471-60709-6 
  247.  
  248. o BTRIEVE Programmer's Manual BTRIEVE Technologies Part No 100-003056-001 
  249.  
  250. o BTRIEVE for OS/2 Installation and Operation BTRIEVE Technolologies Part No 
  251.   100-003055-001 
  252.  
  253. o CICS OS/2 V2.0 Sizing and Performance IBM Corp. GG24-4190-00 
  254.  
  255. o CICS OS/2 V2.0 Performance Report IBM Corp. Available from MKTOOLS 
  256.  
  257. o CICS for OS/2 Version 2.0.1 Installation IBM Corp. SC33-0879 
  258.  
  259. o CICS for OS/2 Version 2.0.1 Intercommunication IBM Corp. SC33-0826 
  260.  
  261. o CICS for OS/2 Version 2.0.1 Customization IBM Corp. SC33-0880 
  262.  
  263. o CICS for OS/2 Version 2.0.1 Operation IBM Corp. SC33-0881 
  264.  
  265. o CICS for OS/2 Version 2.0.1 Problem Determination IBM Corp. SC33-1005 
  266.  
  267. o CICS for OS/2 Version 2.0.1 Application Programming IBM Corp. SC33-0883 
  268.  
  269. o CICS for OS/2 Version 2.0.1 Intercommunication IBM Corp. SC33-0826 
  270.  
  271. o CICS Family: Interproduct Communication IBM Corp. SC33-0824 
  272.  
  273. o CICS Family: Client\Server Programming IBM Corp. SC33-1435 
  274.  
  275. o CICS Clients Version 1 Administration IBM Corp. SC33-1436 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 6. Performance monitoring ΓòÉΓòÉΓòÉ
  279.  
  280.  
  281. ΓòÉΓòÉΓòÉ 6.1. Performance Overview ΓòÉΓòÉΓòÉ
  282.  
  283. The basic constraints on a CICS for OS/2 system are the same as any other 
  284. system; available memory, engine(processor) speed, disk access time, network 
  285. speed and capacity, and, in a distributed system, the response time of the 
  286. partner system.  Other items can impact performance, the primary one being bad 
  287. application design (for example, holding database locks across user "think" 
  288. time). 
  289.  
  290. If you over stress any resource, the result is a performance problem! OS/2 is a 
  291. paging operating system which means that if memory is over-committed, a page 
  292. will be written to the swap file before a requested page can be loaded. 
  293. Normally, while paging is in progress, not much else other than device 
  294. interrupts, is doing useful work in the system.  This leads to the first 
  295. performance rule: "There is no substitute for memory." 
  296. The resource that normally does not run out is engine power.  For some reason, 
  297. people who purchase machines will always try and buy the fastest engine 
  298. available and minimise the cost by cutting down on memory!  Unfortunately, this 
  299. leads to a clash with the second law of performance: "All machines wait at the 
  300. same speed." 
  301.  
  302. The first law can be generalised to: "There is no substitute for resources" 
  303.  
  304. This, however, flies in the face of providing an economic solution to whatever 
  305. business problem has to be solved and maximising performance therefore comes 
  306. down to balancing the relative availability  of resources (for example, the 
  307. priority of a transaction).  The salient point to remember, however, is that in 
  308. any constrained situation, what is given to one request is removed from some 
  309. other request. 
  310.  
  311. The OS/2 operating system does its part in trying to allocate resources to 
  312. maximise the usefulness of the machine.  It has various parameters, explained 
  313. later, that allow the designer of a CICS for OS/2 transaction system to 
  314. influence the allocation of the engine to the various concurrent pieces of work 
  315. running in the system. 
  316.  
  317. CICS for OS/2 itself has set of resource related parameters which govern the 
  318. throughput of the transaction system (task classes, maximum active tasks, 
  319. priorities, and program residency options). Each of these allow the giving or 
  320. throttling of resources to a specific action within the system. 
  321.  
  322. System File Manager, the keyed file access system, used by CICS for OS/2, also 
  323. has the same sort of parameters, the most important of these being the size of 
  324. the System File Manager cache.  This major parameter allows you to trade disk 
  325. access time for memory.  This then relates directly to end user response time, 
  326. because if a record is in memory the access time is almost instantaneous, 
  327. compared with having to access the index and the related data pages on a disk. 
  328.  
  329.  
  330. ΓòÉΓòÉΓòÉ 7. CICS for OS/2 Version 2 and OS/2 ΓòÉΓòÉΓòÉ
  331.  
  332. CICS for OS/2 Version 2 has been designed and built to exploit the features of 
  333. both OS/2 Version 2 operating system and the underlying INTEL 386/486 hardware 
  334. architectures. This has allowed the designers the ability to create a system 
  335. which can run multiple CICS transactions concurrently whilst also having 
  336. hardware storage protection between them. 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 7.1. OS/2 Version 2 architecture ΓòÉΓòÉΓòÉ
  340.  
  341. OS/2's model for its multi-tasking architecture is made up of a hierarchy of 
  342. objects called sessions, processes and threads. Sessions are the highest and 
  343. threads the lowest.  The session is the unit of user I/O device sharing. 
  344. Processes run programs and are the unit of sharing of memory, files, threads 
  345. and so on.  Threads are the basic unit of execution and a single process can 
  346. have multiple threads that execute concurrently within it. 
  347.  
  348. Each session contains a logical mouse, keyboard and video buffer and may have 
  349. one or more processes attached to the session. CICS for OS/2 uses sessions to 
  350. implement Full Screen terminals, for the attachment of ASCII devices, for 
  351. example, a 3151 through COM1,2,..9. Each CICS for OS/2 transaction runs on a 
  352. separate OS/2 process using the hardware/software protection level provided by 
  353. the INTEL architecture. Beneath the processes are the threads, the number 
  354. varying by what function the process is performing.  A table showing how many 
  355. threads belong to which processes can be found in CICS for OS/2 thread 
  356. requirements. 
  357.  
  358.  
  359. ΓòÉΓòÉΓòÉ 7.2. OS/2 Priorities ΓòÉΓòÉΓòÉ
  360.  
  361. OS/2 is built with four performance classes of execution for a thread or 
  362. process. They are (in ascending order of priority): 
  363.  
  364. o Idle-time (lowest) 
  365.  
  366. o Regular 
  367.  
  368. o Foreground Server 
  369.  
  370. o Time-critical (highest) 
  371.  
  372. The mapping of these performance classes into numeric values is a little odd. 
  373. In ascending order of execution, they are 1, 2, 4 and 3 respectively. Within 
  374. each of these classes, there are 31 levels, ascending from 1 to 31. You will 
  375. find when you look at the process data provided by Performance Analyser values 
  376. such as 3.1.  The first number (3) is the OS/2 performance class and the second 
  377. (1) is the level.  Thus, 3.1 means Time-critical, level 1.  Foreground Server 
  378. has also been known as Server Level and Fixed High; it was conceived for the 
  379. purpose of running server work at a higher priority than local work. 
  380.  
  381.  
  382. ΓòÉΓòÉΓòÉ 7.3. CICS and Priority ΓòÉΓòÉΓòÉ
  383.  
  384. CICS, no matter which software and hardware platform, has always had a built-in 
  385. priority scheme.  Each transaction is run with a CICS priority in the range 0 
  386. through 255, 0 for the lowest through 255 for the highest. Various resources 
  387. may be defined with a priority, also ranging between 0 and 255, for example: 
  388.  
  389. o An end-user terminal 
  390.  
  391. o A network system entry 
  392.  
  393. o A transaction 
  394.  
  395.   and (in some implementations) 
  396.  
  397. o An end user 
  398.  
  399. The transaction priority is the sum of the relevant priorities from the list 
  400. above (if the total is greater than 255, 255 is used). 
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ 7.4. Major CICS for OS/2 Version 2 Parameters ΓòÉΓòÉΓòÉ
  404.  
  405. CICS for OS/2 can be started either by a CICSRUN command or by invoking the 
  406. start up executable, FAAOMPSI.EXE, with the various start up options. 
  407. FAAOMPSI.EXE checks the start up options and transfers control to the CICS for 
  408. OS/2 main line program FAAOMPML. FAAOMPML is known as the Global Process 
  409. because it is involved with the serialisation of resources across the whole of 
  410. CICS for OS/2. FAAOMPSI then exits from its invoking window. 
  411.  
  412. FAAOMPML starts the number of processes, FAAOTPTK.EXE, that you requested in 
  413. the CICS for OS/2 System Initialisation Table (SIT).  The two relevant 
  414. parameters are: 
  415.  
  416.  1. Maximum number of tasks 
  417.  
  418.  2. Minimum free tasks 
  419.  
  420. Maximum number of tasks is exactly what it says; it is the maximum number of 
  421. processes that MAY be started in this CICS for OS/2 invocation. (Each CICS task 
  422. needs a process to run on). 
  423.  
  424. To explain the other parameter, consider the following example. 
  425.  
  426. Assume a CICS for OS/2 system is setup with the defaults as distributed from 
  427. Manufacturing, Maximum number of tasks of six, Minimum free tasks of two and 
  428. that the two video terminals (namely V123 and V124) have Autoconnect=Y and 
  429. Autoconnect=N, respectively. 
  430.  
  431. When CICS for OS/2 starts up, the messages shown in CICS for OS/2 Start Up will 
  432. appear on the console window. 
  433.  
  434. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  435. Γöé FAA1670I Non-Facility task, task ID = @02@                            Γöé
  436. Γöé FAA1670I Non-Facility task, task ID = @03@                            Γöé
  437. Γöé FAA1670I Terminal task, task ID = V123                              Γöé
  438. Γöé    . . . . . . . . . . . . . .                                 Γöé
  439. Γöé FAA5661I Process  74 initialisation complete                           Γöé
  440. Γöé FAA5661I Process  75 initialisation complete                           Γöé
  441. Γöé FAA5661I Process  73 initialisation complete                           Γöé
  442. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  443.  
  444. CICS for OS/2 Start Up 
  445.  
  446. This says that CICS has brought up three processes which OS/2 has numbered 
  447. internally as 73, 74 and 75.  Process 73 is dedicated to the video terminal 
  448. V123, and processes 74 and 75 are available as non-facility processes to run 
  449. transactions that are not specifically tied to a named video terminal, for 
  450. example, a transaction invoked by the External Call Interface (ECI) or one 
  451. which is invoked via an inbound APPC request. 
  452.  
  453. Note that there are two non-facility tasks, named @02@ and @03@. This is the 
  454. value you specified in Minimum Number of Free Tasks.  This means that if more 
  455. requests for transaction initiations enter the system than can be handled by 
  456. @02@ and @03@, CICS for OS/2 will start up to three more processes giving a 
  457. maximum of six (that is, the value specified for Maximum Number of Tasks). 
  458. Currently, the stimuli which will activate this are:- 
  459.  
  460. o the connection of a new terminal via the Program Network Architecture (PNA) 
  461.   interface 
  462.  
  463. o the invocation of the External Transaction Interface (ETI). 
  464.  
  465. o the acquiring of a terminal which is defined and is in a non-acquired state. 
  466.  
  467. This mapping between the names and the process numbers can be more easily seen 
  468. by changing to the Time Stamp View on CICSMSG.LOG which is shown in CICS for 
  469. OS/2 Start Up (Time Stamp View). 
  470.  
  471. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  472. Γöé 8-04-94  4:06:38p @02@ @02@ FAA1670I Non-Facility task, task ID = @02@              Γöé
  473. Γöé 8-04-94  4:06:38p @03@ @03@ FAA1670I Non-Facility task, task ID = @03@              Γöé
  474. Γöé 8-04-94  4:06:38p @01@ V123 FAA1670I Terminal task, task ID = V123                Γöé
  475. Γöé       . . . . . . . . . . . . .  . .                            Γöé
  476. Γöé 8-04-94  4:06:49p @02@ @02@ FAA5661I Process  74 initialization complete             Γöé
  477. Γöé 8-04-94  4:06:49p @03@ @03@ FAA5661I Process  75 initialization complete             Γöé
  478. Γöé 8-04-94  4:06:49p @01@ V123 FAA5661I Process  73 initialization complete             Γöé
  479. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  480.  
  481. CICS for OS/2 Start Up (Time Stamp View)
  482.  
  483. Another background process is the Trace process (FAAOMPTR) which is always 
  484. present though it will not be doing anything unless trace is activated by the 
  485. /t start up option or by invoking the CETR transaction.  Details of these three 
  486. processes (FAAOMPSI, FAAOMPML and FAAOMPTR) can be seen by running the OS/2 
  487. utility, PSTAT, from an OS/2 command prompt. (See OS/2 tools for more 
  488. information). 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 7.5. CICS for OS/2 and Priority ΓòÉΓòÉΓòÉ
  492.  
  493. The global process (FAAOMPML) controls the total CICS for OS/2 system. It runs 
  494. in the Time Critical class with a priority of 3.1.  You are unable to change 
  495. this value. 
  496.  
  497. CICS for OS/2 allows you to specify a CICS priority (0 through 255) on the 
  498. following resources: 
  499.  
  500. o A transaction entry in the Program Control Table (PCT) 
  501.  
  502. o An end user terminal entry in Terminal Control Table (Terminal Entry) (TCT) 
  503.  
  504. o A connection entry in the Terminal Control Table (System Entry) (TCS). 
  505.  
  506. o A non-facility  process by way of the Default Process priority entry in the 
  507.   Systems Initialisation Table (SIT), 
  508.  
  509. o The CICS System priority entry in the SIT. 
  510.  
  511. The calculation to work out the task priority begins with the addition of the 
  512. priority of the transaction to be run and the facility that is used to initiate 
  513. the transaction: break. 
  514.  
  515. A task running on a terminal or an inbound EPI Transaction priority + terminal 
  516.                               priority 
  517.  
  518. A task serving an inbound communications request: Transaction priority + 
  519.                               connection priority 
  520.  
  521. A task serving an inbound ECI or ETI request (with no terminal specified) 
  522.                               Transaction priority + default process priority 
  523.  
  524. This is subject to a maximum priority of 255.  Thus 
  525.  
  526.       Actual task priority = minimum(Task priority,255)
  527.  
  528. Finally the task priority is scaled against the CICS System priority entry in 
  529. the SIT.  This allows the base priority at which all transactions run in CICS 
  530. for OS/2 to be varied so giving some control over balancing CICS for OS/2 
  531. against other sub-systems in the machine. 
  532.  
  533. The complete algorithm is thus: 
  534.  
  535.      Task priority = CICS System priority + Actual task priority
  536.             - (CICS System priority * Actual task priority / 255)
  537.  
  538. This last step makes sure that there is scaling between the CICS System 
  539. priority and 255. 
  540.  
  541. The final result is then mapped onto the OS/2 performance classes as shown in 
  542. Performance classes. 
  543.  
  544.         ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  545.         Γöé  Task Priority   Γöé  Performance Class  Γöé
  546.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  547.         Γöé   0 through  85  Γöé    Idle-time     Γöé
  548.         Γöé  86 through 170  Γöé    Regular      Γöé
  549.         Γöé  171 through 255  Γöé    Fixed-high    Γöé
  550.         ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  551.  
  552. Performance classes 
  553.  
  554. Note. The Idle-time class should be avoided except for real background 
  555. transactions which only need to run when spare cycles are available. CICS for 
  556. OS/2 resource definition defaults terminal and connection priorities to 86 so 
  557. that even if a transaction has priority 0 (the default) it will run in OS/2's 
  558. Regular class. 
  559.  
  560.  
  561. ΓòÉΓòÉΓòÉ 7.6. CICS for OS/2 and Task Classes ΓòÉΓòÉΓòÉ
  562.  
  563. CICS for OS/2 gives the systems programmer the ability to throttle certain 
  564. transactions by assigning them to one of eleven Task Classes. The number of 
  565. concurrent transactions that will be allowed to run in a Task Class is defined 
  566. in the Systems Initialisation Table (SIT). Therefore, if the system has a 
  567. transaction that uses a large amount of resources, it could be placed in a 
  568. Transaction Class that has an upper limit of 1, so only one of these 
  569. transactions would be allowed to run at once. The task class for the 
  570. transaction is defined on the Program Control Table (PCT) entry with a value of 
  571. 1 to 10.  The eleventh is the default which is no Task class. 
  572.  
  573.  
  574. ΓòÉΓòÉΓòÉ 7.7. System File Manager and priority ΓòÉΓòÉΓòÉ
  575.  
  576. System File Manager currently runs at an OS/2 priority class of 4 and level 0; 
  577. that is at the bottom of Foreground server. This, using the table in the 
  578. previous section, translates into a CICS priority of 171.  Experience with 
  579. mainframe CICS systems has almost always shown that the priority of a data 
  580. owning entity should be run at a higher priority than the application.  This 
  581. means that until System File Manager allows you to alter its priority, 
  582. applications should be run at a CICS priority between 86 and 170. 
  583.  
  584.  
  585. ΓòÉΓòÉΓòÉ 7.8. Threads ΓòÉΓòÉΓòÉ
  586.  
  587. CICS for OS/2 uses more than one thread for each of the processes defined 
  588. earlier.  CICS for OS/2 thread requirements provides a guide of how many 
  589. additional threads will be required to run a CICS for OS/2 system. 
  590.  
  591.        ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  592.        Γöé      Γöé       Γöé                     Γöé
  593.        Γöé  Process Γöé Function   Γöé Number of threads required        Γöé
  594.        Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  595.        Γöé      Γöé       Γöé                     Γöé
  596.        Γöé FAAOMPML Γöé Mainline   Γöé 2 Standard                Γöé
  597.        Γöé      Γöé       Γöé 1 Message log              Γöé
  598.        Γöé      Γöé       Γöé 1 External Call Interface(ECI)      Γöé
  599.        Γöé      Γöé       Γöé 1 ICE manager              Γöé
  600.        Γöé      Γöé       Γöé 1 Scheduler               Γöé
  601.        Γöé      Γöé       Γöé 3 PNA (if enabled)            Γöé
  602.        Γöé      Γöé       Γöé 1+2*NetBios adapters (if enabled)    Γöé
  603.        Γöé      Γöé       Γöé                     Γöé
  604.        Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  605.        Γöé FAAOMPTR Γöé Trace    Γöé 2 Standard                Γöé
  606.        Γöé      Γöé       Γöé                     Γöé
  607.        Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  608.        Γöé FAAOTPTK Γöé Application Γöé 3 for each (if Terminal Facility)    Γöé
  609.        Γöé      Γöé       Γöé                     Γöé
  610.        Γöé      Γöé       Γöé 2 for each (if Non-Facility)       Γöé
  611.        Γöé      Γöé       Γöé  +1 if ever used as a PNA Terminal    Γöé
  612.        Γöé      Γöé       Γöé                     Γöé
  613.        Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  614.        Γöé BTRIEVE/ Γöé Keyed file  Γöé 3 Standard                Γöé
  615.        Γöé System  Γöé engine    Γöé n Worker (as specified)         Γöé
  616.        Γöé File   Γöé       Γöé m I/O  (as specified)          Γöé
  617.        Γöé Manager  Γöé       Γöé 1 Archive and/or Durability(if enabled) Γöé
  618.        Γöé      Γöé       Γöé                     Γöé
  619.        ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  620.  
  621. CICS for OS/2 thread requirements 
  622.  
  623. OS/2 Version 2 has a default CONFIG.SYS entry for THREADS which is equal to 
  624. 256.  After looking at your system, using PSTAT or SPM/2, you may wish to 
  625. increase this default value to a higher value using the information detailed 
  626. above. 
  627.  
  628.  
  629. ΓòÉΓòÉΓòÉ 7.9. OS/2 parameters ΓòÉΓòÉΓòÉ
  630.  
  631. MAXWAIT               CONFIG.SYS value which sets the amount of time, in 
  632.                       seconds, a process waits before the system assigns it a 
  633.                       higher priority. When a regular class thread is denied 
  634.                       the processor for this number of seconds, it receives a 
  635.                       temporary increase in priority for a minimum time slice. 
  636.                       (Default is 3 seconds) 
  637.  
  638. MinSlice              This is the first parameter of the TIMESLICE CONFIG.SYS 
  639.                       value and is the minimum amount of time in milliseconds a 
  640.                       thread can process before yielding the processor to 
  641.                       another thread of the same priority level. (Default is 32 
  642.                       milliseconds) 
  643.  
  644. MaxSlice              This is the second parameter of the TIMESLICE CONFIG.SYS 
  645.                       value and is the maximum amount of time in milliseconds a 
  646.                       thread can process before yielding the processor to 
  647.                       another thread of the same priority level. (Default is 32 
  648.                       milliseconds) 
  649.  
  650. PRIORITY_DISK_IO      When PRIORITY_DISK_IO=YES is specified in CONFIG.SYS, an 
  651.                       application running with the focus will receive disk I/O 
  652.                       priority over applications running in the background. 
  653.                       This means foreground applications should have a better 
  654.                       response time than those running in the background.  For 
  655.                       a CICS for OS/2 Application server, it is recommended 
  656.                       this parameter should be set to NO, and set to YES for a 
  657.                       developer's machine. (Default is YES) 
  658.  
  659. SWAPPATH              SWAPPATH has three parameters, the first is the location 
  660.                       of the swap file.  The normal recommendation is to place 
  661.                       it in the root directory of the most frequently partition 
  662.                       on least frequently used drive.  If you only have one 
  663.                       drive, the same advice holds true, place it in the root 
  664.                       directory of the most frequently used partition.  The 
  665.                       second parameter sets a warning threshold level in 
  666.                       kilobytes.  This value should be at least 5120.  The 
  667.                       third value is little known, because it is not set in the 
  668.                       default CONFIG.SYS, and specifies the initial size (in 
  669.                       kilobytes) of the swap file at boot time.  If you are 
  670.                       using FAT on the volume where your swap file is, 
  671.                       fragmentation caused by the growth and reduction of the 
  672.                       swap file can cause between 10 and 15 percent 
  673.                       degradation. 
  674.  
  675. THREADS               The THREADS parameter gives the maximum number of threads 
  676.                       that can concurrently run on the system.  If you do not 
  677.                       have enough, the system will normally hang! This number 
  678.                       will have to service the total of OS/2, Communications 
  679.                       Manager/2, NetBIOS, TCP/IP, BTRIEVE, DB2/2. The maximum 
  680.                       is 4096 with a default entry at OS/2 installation of 256. 
  681.                       If there is no entry in CONFIG.SYS, then the number of 
  682.                       threads defaults to 64. 
  683.  
  684. RESTARTOBJECTS        When CICS for OS/2 is running as a server, it is probably 
  685.                       unattended, so when you restart you will not want objects 
  686.                       to be restarted, so specify SET 
  687.                       RESTARTOBJECTS=STARTUPFOLDERSONLY. 
  688.  
  689.  
  690. ΓòÉΓòÉΓòÉ 7.10. OS/2 tools ΓòÉΓòÉΓòÉ
  691.  
  692. OS/2 Version 2 comes with some tools to help you view what is happening on your 
  693. system.  The simplest of these is Pulse which you will find in the Productivity 
  694. folder in the OS/2 System folder on your desktop.  It gives a small graphical 
  695. display of how busy the engine is in your machine.  The second has been 
  696. mentioned already, PSTAT. An extract from the help information is reproduced 
  697. here but the full write up should be viewed on your machine by entering 
  698.  
  699.      help pstat
  700. on a command line. 
  701.  
  702. PSTAT displays information about: 
  703.  
  704. o Current processes and threads 
  705.  
  706. o System semaphores 
  707.  
  708. o Shared memory for each process 
  709.  
  710. o Dynamic-link libraries 
  711.  
  712. PSTAT helps you find out which threads are running in the system, along with 
  713. their current status and current priorities.  With it you can find out the 
  714. process ID that has been assigned to each process.  This can be used as input 
  715. to the OS/2 TRACE utility program if you need to dive more deeply into the 
  716. system.  The binary trace output is then formatted using the OS/2 TRACEFMT 
  717. command. 
  718.  
  719. There are also quite a few Bulletin Board utilities for swap file activity, 
  720. NetBIOS usage etc.  One starting point for finding these bulletin boards is a 
  721. list at the back of "OS/2 2.11 Unleashed" by David Moskowitz and David Kerr, et 
  722. al. 
  723.  
  724. Every location should have at least one copy of the IBM System Performance 
  725. Monitor/2. 
  726.  
  727.  
  728. ΓòÉΓòÉΓòÉ 8. Performance Analyser Installation ΓòÉΓòÉΓòÉ
  729.  
  730.  
  731. ΓòÉΓòÉΓòÉ 8.1. Installation of the code ΓòÉΓòÉΓòÉ
  732.  
  733. The following procedure assumes you have CICS for OS/2 Version 2 installed in 
  734. the default CICS200 directory on drive cicsdrv, and the PATH and LIBPATH 
  735. statements in CONFIG.SYS were automatically updated by the CICS for OS/2 
  736. Version 2 installation. If you install Performance Analyser elsewhere you will 
  737. have to point CICSWRK or LIBPATH to the directory where you put the DLLs, and 
  738. PATH to where you put the EXEs. 
  739.  
  740.  1. Check your CICS for OS/2 Version 2 is at the right level. 
  741.  
  742.  2. Create a temporary directory on the target machine; this is referred to 
  743.     later as tmpdrv:\tmpdir. 
  744.  
  745.  3. Copy the file CICSPA2.ZIP to this directory. 
  746.  
  747.  4. At a command prompt in this directory, unzip CICSPA2.ZIP. 
  748.  
  749.  5. The following files will be created. 
  750.  
  751.    FAAPLTPI.DLL             Performs an EXEC CICS START to the Performance 
  752.                             Analyser initialisation transaction PA21. 
  753.  
  754.    FAAPLTPI.CCS             Sample source to illustrate the EXEC CICS START 
  755.                             command needed to invoke the internal 
  756.                             initialisation transactionPA21. 
  757.  
  758.    PA2PLTPI.DLL             Performance Analyser program that does an 
  759.                             asynchronous search of CICS for OS/2 resources 
  760.                             invoked from transaction PA21. 
  761.  
  762.    FAAPLTSD.DLL             Executes an EXEC CICS LINK to program PA2PLTSD, the 
  763.                             Performance Analyser monitoring and statistics 
  764.                             output program PA2PLTSD.DLL. 
  765.  
  766.    FAAPLTSD.CCS             Sample source to illustrate the above. 
  767.  
  768.    PA2PLTSD.DLL             Performance Analyser program which creates the 
  769.                             monitoring and statistics output file PA2STATS.DAT. 
  770.  
  771.    FAAEXP17.DLL             CICS for OS/2 exit to capture ABEND information and 
  772.                             statistics. If you are already using this exit, do 
  773.                             NOT copy the one supplied with this package into 
  774.                             your system 
  775.  
  776.    FAADKSIN.DLL             CICS for OS/2 exit to capture application level 
  777.                             trace, timings and statistics. This is supplied 
  778.                             only as a DLL. The optional binary trace file 
  779.                             created is named PA2STATS.TRC, and may be formatted 
  780.                             whilst CICS for OS/2 is running by invoking 
  781.                             PA2DKSIN.EXE. 
  782.  
  783.    PA2BTRST.EXE             Used to obtain information and statistics on keyed 
  784.                             files held in the System File Manager at start up. 
  785.  
  786.    PA2BTREN.EXE             Used to obtain information and statistics on keyed 
  787.                             files held in the System File Manager using 
  788.                             transaction PA2B and at shutdown time when PA2PLTSD 
  789.                             is run. 
  790.  
  791.    FAAAEFIE.BTR             CICS for OS/2 import file containing the 
  792.                             Performance Analyser run-time BMS maps and 
  793.                             transaction definitions in group PA2GROUP. 
  794.                             Installation Verification Program (IVP) definitions 
  795.                             are in group PA2EXMPL 
  796.  
  797.    PA2CLOCK.DLL             Updates user clock data 
  798.  
  799.    PA2CLOCK.H               C header file for use with user clocks 
  800.  
  801.    PA2CLOCK.LIB             Library file for use with user clocks 
  802.  
  803.    PA2ABEND.DLL             Installation Verification program 
  804.  
  805.    PA2ABEND.CCS             Source for the above 
  806.  
  807.    PA2BR14.DLL              Echo test program that provides a CICS superset of 
  808.                             the mainframe IEFBR14 program.  It is simple echo 
  809.                             program that can be invoked in various ways (PA22) 
  810.  
  811.    PA2BR14.CCS              Source for the above 
  812.  
  813.    PA2KCBIN.DLL             A program that enables a remote CICS system to 
  814.                             request statistics from a CICS for OS/2 system 
  815.                             using Distributed Program Link. See Getting CICS 
  816.                             for OS/2 statistics from another CICS system. 
  817.  
  818.    PA2XXBIN.H               C language header file showing the record layout of 
  819.                             the COMMAREA passed to and returned from 
  820.                             PA2KCBIN.DLL. 
  821.  
  822.    PA2ALLEN.H               C language header file containing the #defines for 
  823.                             the above. 
  824.  
  825.    5764-091.INF             VIEWable on-line documentation. 
  826.  
  827.                             In addition, the following 3270 BMS transaction 
  828.                             programs are supplied. They are the Performance 
  829.                             Analyser applications that can be used to display 
  830.                             the various statistics captured by the exits. The 
  831.                             transaction IDs for each program is shown in 
  832.                             parenthesis. 
  833.  
  834.    PA2MMDSP.DLL             Performance Analyser main menu (PA2) 
  835.  
  836.    PA2BTDSP.DLL             Btrieve statistics (PA2B) 
  837.  
  838.    PA2BUDSP.DLL             Bucket statistics (PA2E) 
  839.  
  840.    PA2FCDSP.DLL             File Control statistics(PA2F) 
  841.  
  842.    PA2GCDSP.DLL             File Control statistics (cont'd) (PA2G) 
  843.  
  844.    PA2ICDSP.DLL             Interval Control statistics (PA2I) 
  845.  
  846.    PA2KCDSP.DLL             Task Control statistics (PA2K) 
  847.  
  848.    PA2LGDSP.DLL             CICS for OS/2 log display (PA2L) 
  849.  
  850.    PA2PCDSP.DLL             Program Control statistics (PA2P) 
  851.  
  852.    PA2RCDSP.DLL             Transaction rate display (PA2R) 
  853.  
  854.    PA2TDDSP.DLL             Transient Data statistics (PA2D) 
  855.  
  856.    PA2TSDSP.DLL             Temporary Storage statistics (PA2Q) 
  857.  
  858.    PA2XCDSP.DLL             OS/2 Process Control statistics (PA2X) 
  859.  
  860.                             The following are also 3270 BMS transaction 
  861.                             programs providing Performance Analyser Trace and 
  862.                             Statistics control functions. 
  863.  
  864.    PA2OCDSP.DLL             Application level trace control (PA2O) 
  865.  
  866.    PA2OTDSP.DLL             Transaction level trace control (PA2Y) 
  867.  
  868.    PA2MCDSP.DLL             Drives output of PA2PLTSD.DLL to create 
  869.                             PA2STATS.DAT (PA2M) 
  870.  
  871.                             The choice of 3270 BMS transactions is deliberate. 
  872.                             It allows the interrogation of a CICS for OS/2 
  873.                             server from any CICS system that supports 
  874.                             transaction routing. 
  875.  
  876.                             A separate capability to the the online monitoring 
  877.                             and statistics function are the stand alone 
  878.                             Application and Transaction level trace formatters 
  879.                             with timings. 
  880.  
  881.    PA2DKSIN.EXE             Input file is PA2STATS.TRC, and the readable output 
  882.                             file is named PA2STATS.RPT. If the output file 
  883.                             already exists, then new output is appended at the 
  884.                             end of it. 
  885.  
  886.    PA2TRSIN.EXE             Input file is PA2STATS.TRN, and the readable output 
  887.                             file is also PA2STATS.RPT. If the output file 
  888.                             already exists, then new output is appended at the 
  889.                             end of it. 
  890.  
  891.  6. CICSPA2.ZIP may now be deleted. 
  892.  
  893.  7. If you do NOT have programs which do real PLTPI and/or PLTSD processing, 
  894.     then go to step 6 Otherwise, you must add the following EXEC CICS 
  895.     statements into your source and recompile. 
  896.  
  897.     a. An EXEC CICS START to transaction PA21 in FAAPLTPI 
  898.  
  899.     b. An EXEC CICS LINK for program PA2PLTSD in program FAAPLTSD. See the two 
  900.     sample .CCS source modules (FAAPLTPI.CCS  and FAAPLTSD.CCS) for examples of 
  901.     these additions. 
  902.  
  903.     Go to step 7. 
  904.  
  905.  8. Rename the files FAAPLTPI.DLL and FAAPLTSD.DLL in the cicsdrv:\CICS200\BIN 
  906.     subdirectory. For example, 
  907.  
  908.              ren FAAPLT*.DLL *.BAK
  909.  
  910.     Copy the Performance Analyser versions of these 2 files to 
  911.     cicsdrv:\CICS200\BIN subdirectory. 
  912.  
  913.  9. Rename the file FAADKSIN.DLL (if present) in the cicsdrv:\CICS200\BIN 
  914.     subdirectory. For example, 
  915.  
  916.              ren FAADKSIN.DLL *.BAK
  917.  
  918.     Copy the Performance Analyser versions of this file to cicsdrv:\CICS200\BIN 
  919.     subdirectory. 
  920.  
  921.          ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  922.          Γöé  WARNING!!!!                                Γöé
  923.          Γöé                                      Γöé
  924.          Γöé  When installing a CSD on a CICS for OS/2 system which has Performance   Γöé
  925.          Γöé  Analyser installed the following modules may be overwritten by the CSD  Γöé
  926.          Γöé  installation:                               Γöé
  927.          Γöé                                      Γöé
  928.          Γöé             FAADKSIN.DLL                    Γöé
  929.          Γöé             FAAPLTPI.DLL                    Γöé
  930.          Γöé             FAAPLTSD.DLL                    Γöé
  931.          Γöé                                      Γöé
  932.          Γöé  MAKE SURE YOU TAKE BACKUP COPIES OF THESE FILES BEFORE INSTALLING A CSD  Γöé
  933.          ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  934.  
  935. 10. Copy the PA2*.EXE and PA2*.DLL files into the cicsdrv:\CICS200\BIN 
  936.     subdirectory. 
  937.  
  938. 11. Copy FAAEXP17.DLL into the cicsdrv:\CICS200\BIN subdirectory, if you do NOT 
  939.     have one already specified in your system. 
  940.  
  941. 12. If you are going to use buckets, copy PA2CLOCK.H to 
  942.     cicsdrv:\CICS200\INCLUDE and PA2CLOCK.LIB to cicsdrv:\CICS200\LIB. 
  943.  
  944. 13. Copy 5764-091.INF to an appropriate directory and, optionally, set up a 
  945.     desktop object using VIEW.EXE as the file name and path\5764-091.INF as the 
  946.     optional parameter (where path points to the directory where you placed the 
  947.     INF file. 
  948.  
  949.     You must now add the appropriate BMS maps and PCT entries for Performance 
  950.     Analyser. You have two options; use the supplied CICS for OS/2 import file 
  951.     (in which case go to step 12) or create them yourself (in which case go to 
  952.     step 19). 
  953.  
  954. 14. Back-up your current import file (FAAAEFIE.BTR) in the 
  955.     cicsdrv:\CICS200\BIN\DATA directory, if necessary, by renaming it or by 
  956.     using the Backup Existing Data option on the Application Import Screen of 
  957.     the import transaction CAIM. 
  958.  
  959. 15. Copy the supplied import file (FAAAEFIE.BTR) to cicsdrv:\CICS200\BIN\DATA 
  960.  
  961. 16. Bring up CICS for OS/2. 
  962.  
  963. 17. If you have a pre-release version of Performance Analyser (that is, prior 
  964.     to V1.0) you should delete all Performance Analyser PCT/PPT references 
  965.     using CEDA. Also, delete all Performance Analyser map items from the 
  966.     map-file using CSCA. 
  967.  
  968. 18. Enter the CAIM transaction and fill in: 
  969.  
  970.    o PA2GROUP as the GROUP NAME 
  971.  
  972.    o N for Include conversion templates 
  973.  
  974.    o N for Include SNT 
  975.  
  976.    o Y for Data files 
  977.  
  978.    o N for Input from Backup 
  979.  
  980.    o Y or N for Backup existing data, depending what you want on the 
  981.     Application Import Screen. 
  982.  
  983.     This will import the necessary screen maps and PCT entries for Performance 
  984.     Analyser 
  985.  
  986. 19. If you wish to import the supplied samples, enter the CAIM transaction 
  987.     again and fill in PA2EXMPL as the GROUP NAME on the screen with the same 
  988.     parameters as described in the previous step. 
  989.  
  990. 20. Go to step 23. 
  991.  
  992. 21. Perform any customisation on the supplied BMS mapset and then translate by 
  993.     entering the following command from an OS/2 command line: 
  994.  
  995.               cicsmap tmpdrv:\tmpdir\PA2KC
  996.  
  997.     (where tmpdrv:\tmpdir is the path to the temporary directory created in 
  998.     step 2). 
  999.  
  1000. 22. Bring up CICS for OS/2. 
  1001.  
  1002. 23. Create a PPT entry for the map (PA2KC). 
  1003.  
  1004. 24. Create PCT entries for each of the PA2x transactions (ie PA2, PA2B, PA2F 
  1005.     etc). 
  1006.  
  1007.     It is recommended you use a GROUPNAME of PA2GROUP for future compatibility. 
  1008.  
  1009. 25. Shutdown CICS. 
  1010.  
  1011. 26. If you are using CICSRGRP environment variable, which is normally set in 
  1012.     CICSENV.CMD, to control the loading of specific groups then add PA2GROUP 
  1013.     and PA2EXMPL to your current list. 
  1014.  
  1015. 27. This completes the installation of Performance Analyser. 
  1016.  
  1017. The next section provides details on how to verify that it is functioning 
  1018. correctly. 
  1019.  
  1020.  
  1021. ΓòÉΓòÉΓòÉ 8.2. Installation Verification Procedure ΓòÉΓòÉΓòÉ
  1022.  
  1023.  1. Bring up CICS for OS/2. 
  1024.  
  1025.  2. Check CICSMSG.LOG or the CICS for OS/2 Version 2.0 window that message 
  1026.     FAA5706I was output during start-up. 
  1027.  
  1028.           FAA5706I Internal trace function enabled
  1029.     If it was not, you have not placed FAADKSIN.DLL in a directory which is on 
  1030.     the CICSWRK path or on LIBPATH. 
  1031.  
  1032.  3. Check CICSMSG.LOG or the CICS for OS/2 Version 2.0 window that message 
  1033.     FAA5627I was output during start-up. 
  1034.  
  1035.          FAA5627I User exit 17(transaction abend/system error) loaded
  1036.     If it was not, you have not placed FAAEXP17.DLL in a directory which is on 
  1037.     the CICSWRK path or on LIBPATH. 
  1038.  
  1039.  4. Check CICSMSG.LOG or the CICS for OS/2 Version 2.0 window that a FAAuser 
  1040.     message was output during start-up saying "PLTPI processing complete".  If 
  1041.     it was not, you have not placed FAAPLTPI.DLL in a directory which is on the 
  1042.     CICSWRK path or on LIBPATH, or your version has removed this EXEC CICS 
  1043.     WRITE OPERATOR command. 
  1044.  
  1045.  5. Check CICSMSG.LOG or the CICS for OS/2 Version 2.0 window that a FAAuser 
  1046.     message was output during start-up saying "Performance Analyser/2 started". 
  1047.     If it was not, you have not placed PA2PLTPI.DLL in a directory which is on 
  1048.     the CICSWRK path or on LIBPATH, or you have no PCT entry for PA21 pointing 
  1049.     at program PA2PLTPI, or you have not inserted the EXEC CICS START 
  1050.     TRANSID("PA21") in your customised FAAPLTPI. 
  1051.  
  1052.  6. Enter transaction code PA2K on the 3270 terminal.  You should receive 
  1053.     information similar to that shown in PA2K output example. 
  1054.  
  1055.  
  1056.         PA2K output example
  1057.  
  1058.     If you do not, and receive message "FAA5405E Transaction identification 
  1059.     PA2K not valid - please resubmit" you have no PCT entry for PA2K.  If you 
  1060.     receive message "FAA5407E Program PA2KCDSP is not available, RC = 0034", 
  1061.     you have not placed PA2KCDSP.DLL in a directory which is on the CICSWRK 
  1062.     path or on LIBPATH. 
  1063.  
  1064.  7. Shutdown CICS down using CQIT (NOT CQIT I). 
  1065.  
  1066.  8. Use an editor or file browser to look at statistics in 
  1067.     cicsdrv:\CICS200\BIN\PA2STATS.DAT.  If this file does not exist, you have 
  1068.     not updated your FAAPLTSD.DLL with a LINK to program PA2PLTSD or FAAPLTSD 
  1069.     and/or PA2PLTSD are not present in a directory which is on the CICSWRK path 
  1070.     or on LIBPATH, or you did a CQIT I which bypasses CICS Program Load Table 
  1071.     (PLTSD) shutdown processing. 
  1072.  
  1073.  
  1074. ΓòÉΓòÉΓòÉ 9. How to use Performance Analyser ΓòÉΓòÉΓòÉ
  1075.  
  1076. There are seven primary functions that are available with Performance Analyser: 
  1077.  
  1078.  1. Real-time display of CICS for OS/2 server statistics via terminal input 
  1079.     using a subset of the supplied transactions. Real-time statistics display 
  1080.     describes their use. 
  1081.  
  1082.  2. Generation of a formatted statistics file for off-line analysis. Generation 
  1083.     of a formatted statistics file describes the various ways this file can be 
  1084.     created. 
  1085.  
  1086.  3. Provision of statistical data for a particular CICS for OS/2 server to a 
  1087.     another remote CICS system.  Getting CICS for OS/2 statistics from another 
  1088.     CICS system explains how this function is achieved using Distributed 
  1089.     Program Link. 
  1090.  
  1091.  4. Tracing the execution of CICS transactions providing both "time-of-day" 
  1092.     stamps and elapsed time measurements for them. Application Level Trace 
  1093.     explains how to control this function. 
  1094.  
  1095.  5. Tracing the execution of a CICS application and to provide both 
  1096.     "time-of-day" stamps and elapsed time measurements for the EXEC CICS calls 
  1097.     and internal CICS for OS/2 functions. Application Level Trace explains how 
  1098.     to control this function. 
  1099.  
  1100.  6. Insertion of "User Clocks" in application programs.  This allows for the 
  1101.     measurement of code execution times and counting of the number of times a 
  1102.     particular section of code is run.  User Clocks provides details on how to 
  1103.     implement this function. 
  1104.  
  1105.  7. Running of a sample CICS echo program (PA2BR14) to return data independent 
  1106.     of its method of invocation. This can be used in a number of different ways 
  1107.     to exercise a CICS for OS/2 system.  Its use is is explained in Using the 
  1108.     supplied sample program (PA2BR14). 
  1109.  
  1110. Performance Analyser has a set of "built-in" transactions which can be invoked 
  1111. from any CICS 3270 terminal attached to a CICS OS/2 server with Performance 
  1112. Analyser enabled.  These transactions, which are shown together with their 
  1113. equivalent program names in Performance Analyser transactions supplied in 
  1114. PA2GROUP group and Performance Analyser transactions supplied in PA2EXMPL 
  1115. group, provide access to many of the functions described above. 
  1116.  
  1117.        ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1118.        Γöé     Γöé        Γöé                           Γöé
  1119.        Γöé TRANID Γöé Program Name  Γöé  Function                      Γöé
  1120.        Γöé     Γöé        Γöé                           Γöé
  1121.        Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1122.        Γöé  PA2  Γöé PA2MMDSP.DLL  Γöé  Performance Analyser main menu           Γöé
  1123.        Γöé     Γöé        Γöé                           Γöé
  1124.        Γöé  PA2B  Γöé PA2BTDSP.DLL  Γöé  Display System File Manager statistics       Γöé
  1125.        Γöé  PA2D  Γöé PA2TDDSP.DLL  Γöé  Display Transient Data statistics         Γöé
  1126.        Γöé  PA2E  Γöé PA2BUDSP.DLL  Γöé  Display Buckets data                Γöé
  1127.        Γöé  PA2F  Γöé PA2FCDSP.DLL  Γöé  Display File Control statistics          Γöé
  1128.        Γöé  PA2G  Γöé PA2GCDSP.DLL  Γöé  Display Browse portion of File Control statistics Γöé
  1129.        Γöé  PA2I  Γöé PA2ICDSP.DLL  Γöé  Display Interval Control statistics        Γöé
  1130.        Γöé  PA2K  Γöé PA2KCDSP.DLL  Γöé  Display Task Control statistics          Γöé
  1131.        Γöé  PA2L  Γöé PA2LGDSP.DLL  Γöé  Display CICS OS/2 Log File             Γöé
  1132.        Γöé  PA2P  Γöé PA2PCDSP.DLL  Γöé  Display Program Control statistics         Γöé
  1133.        Γöé  PA2Q  Γöé PA2TSDSP.DLL  Γöé  Display Temporary Storage Queues statistics    Γöé
  1134.        Γöé  PA2R  Γöé PA2RCDSP.DLL  Γöé  Display Transaction rate over last hour      Γöé
  1135.        Γöé  PA2X  Γöé PA2XCDSP.DLL  Γöé  Display OS/2 Process statistics          Γöé
  1136.        Γöé  PA2M  Γöé PA2MCDSP.DLL  Γöé  Generate statistics file dynamically        Γöé
  1137.        Γöé  PA2O  Γöé PA2OCDSP.DLL  Γöé  Performance Analyser application trace control   Γöé
  1138.        Γöé  PA2Y  Γöé PA2OTDSP.DLL  Γöé  Performance Analyser transaction trace control   Γöé
  1139.        Γöé  PA21  Γöé PA2PLTPI.DLL  Γöé  Performance Analyser asynchronous initialisation  Γöé
  1140.        Γöé     Γöé        Γöé  (for internal use by Performance Analyser)     Γöé
  1141.        ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1142.  
  1143. Performance Analyser transactions supplied in PA2GROUP group 
  1144.  
  1145.         ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1146.        Γöé     Γöé        Γöé                           Γöé
  1147.        Γöé TRANID Γöé Program Name  Γöé  Function                      Γöé
  1148.        Γöé     Γöé        Γöé                           Γöé
  1149.        Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1150.        Γöé     Γöé        Γöé                           Γöé
  1151.        Γöé  PA22  Γöé PA2BR14.DLL  Γöé  Invoke Performance Analyser sample echo program  Γöé
  1152.        Γöé     Γöé        Γöé  (Performance Analyser equivalent of IEFBR14)    Γöé
  1153.        Γöé     Γöé        Γöé                           Γöé
  1154.        ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1155.  
  1156. Performance Analyser transactions supplied in PA2EXMPL group 
  1157.  
  1158. Transaction PA2 displays the Performance Analyser main menu (see Performance 
  1159. Analyser main menu). This can be used to invoke the majority of the other 
  1160. transactions or, alternatively, all transactions can be run directly. 
  1161.  
  1162.  
  1163. Performance Analyser main menu
  1164.  
  1165.  
  1166. ΓòÉΓòÉΓòÉ 9.1. Real-time statistics display ΓòÉΓòÉΓòÉ
  1167.  
  1168. Real-time display of CICS for OS/2 server statistics is achieved by issuing any 
  1169. of the "DISPLAY" transactions listed in Performance Analyser transactions 
  1170. supplied in PA2GROUP group (either directly or via the main menu as shown in 
  1171. Performance Analyser main menu ) from an active terminal. 
  1172.  
  1173. This will result in a pre-formatted screen being displayed containing 
  1174. statistical data relating to a particular functional area of the CICS for OS/2 
  1175. server. Explanation of PA2STATS.DAT file entries in Performance Analyser 
  1176. statistics file provides an explanation of the data displayed. 
  1177.  
  1178. PA2R output example is an example of PA2R issued on a local terminal.  It shows 
  1179. the transaction activity on the Server over the last hour. 
  1180.  
  1181. This figure also shows the "boiler-plate" items of the Performance Analyser 
  1182. display, namely:- 
  1183.  
  1184. o In the top left-hand corner, the time of day. 
  1185.  
  1186. o In the top right-hand corner, the elapsed time since CICS for OS/2 was 
  1187.   started. 
  1188.  
  1189. o In the top centre, the title and subject of the output 
  1190.  
  1191. o In the bottom right, there are two fields; the first marked MCT which is the 
  1192.   value of the Maximum Con-current Tasks that have executed on the system since 
  1193.   this run started and ServerId is the APPLID by which the system is known. 
  1194.   (ie as defined in the Systems Initialisation Table(SIT)). 
  1195.  
  1196.  
  1197. PA2Routputexample
  1198.  
  1199. PA2P output example is an example of PA2P. It provides statistics on invoked 
  1200. programs. 
  1201.  
  1202.  
  1203. PA2P output example
  1204.  
  1205. PA2B output example is an example of PA2B. It provides statistics on System 
  1206. File Manager usage. 
  1207.  
  1208.  
  1209. PA2B output example
  1210.  
  1211. PA2R output example is another example of PA2K. This time the transaction was 
  1212. issued on a remote terminal.  Notice the different characters used to indicate 
  1213. the transaction activity on the Server. The reason for the difference between 
  1214. the two is that transaction routing flows all data in EBCDIC and there is no 
  1215. equivalent character in EBCDIC to the ASCII full-box and half-box so these have 
  1216. been replace by ":" and "." respectively. 
  1217.  
  1218.  
  1219. PA2R output example
  1220.  
  1221.  
  1222. ΓòÉΓòÉΓòÉ 9.2. Generation of a formatted statistics file ΓòÉΓòÉΓòÉ
  1223.  
  1224. The same statistics data that is displayed in real-time with the supplied 
  1225. transactions, can also be saved in a file for later, off-line analysis. The 
  1226. file is called PA2STATS.DAT.  It is an ASCII file that can be viewed with a 
  1227. standard PC editor/browser or printed on a line printer. It is used as an 
  1228. "append" file (that is, each time new data is collected it is added to the end 
  1229. of the file). The file will thus continue to grow until specific action is 
  1230. taken to delete it.  The file is closed after use so that it may be accessed by 
  1231. other processes in the system. 
  1232.  
  1233. The file itself can be added to in one of three ways: 
  1234.  
  1235.  1. By selecting PA/2 Statistics Report from the Performance Analyser main 
  1236.     menu. An optional reason string can be passed in the field supplied. 
  1237.  
  1238.  2. By executing the supplied 3270 transaction PA2M. An optional reason string 
  1239.     can concatenated after the transaction code. 
  1240.  
  1241.  3. By LINKing to the program PA2PLTSD. An optional reason string can be passed 
  1242.     in the COMMAREA. 
  1243.  
  1244. An example of a PA2STATS.DAT file generated by Performance Analyser is shown in 
  1245. An example of a PA2STATS.DAT file in Performance Analyser statistics file 
  1246. whilst Explanation of PA2STATS.DAT file entries also in Performance Analyser 
  1247. statistics file provides an explanation of the various entries within the file. 
  1248.  
  1249.  
  1250. ΓòÉΓòÉΓòÉ 10. Getting CICS for OS/2 statistics from another CICS system ΓòÉΓòÉΓòÉ
  1251.  
  1252. A requirement that is often needed in a distributed CICSplex is the ability to 
  1253. request statistical data from a central or distributed location. Performance 
  1254. Analyser provides this function with a DLL (PA2KCBIN) that can be linked to 
  1255. using a CICS Distributed Program Link (DPL) from a remote CICS system and which 
  1256. will then return the requested Performance Analyser statistics to the calling 
  1257. system.  This data is currently limited to statistics on tasks, processes and 
  1258. bucket data. 
  1259.  
  1260.  
  1261. ΓòÉΓòÉΓòÉ 10.1. PA2KCBIN ΓòÉΓòÉΓòÉ
  1262.  
  1263. This DLL can be linked from any CICS system using 
  1264.  
  1265.            EXEC CICS LINK
  1266.                      PROGRAM('PA2KCBIN')
  1267.                      COMMAREA(Commarea)
  1268.                      LENGTH(CommareaLen)
  1269.                      SYSID(Remotesysid)
  1270.                      SYNCONRETURN   (See Note)
  1271.  
  1272. Note: SYNCONRETURN can be optionally used on those systems that can send it. 
  1273. Its use will halve the network flows thus considerably improving the 
  1274. performance of the command. 
  1275.  
  1276. The only input parameter required is the ASCII letter in the field 
  1277. CommPtr->entry_type. Three #defines are provided in PA2ALLEN.H: 
  1278.  
  1279. PCT_TYPE_RECORD               for task control statistics 
  1280.  
  1281. PID_TYPE_RECORD               for OS/2 process statistics 
  1282.  
  1283. BUK_TYPE_RECORD               for user clock statistics 
  1284.  
  1285. There is no default and a PA2Q abend will occur if neither of these two are 
  1286. provided. 
  1287.  
  1288. The COMMAREA you pass needs to be large enough for all the statistics 
  1289. available. The field CommPtr->end will contain an N if it is not, otherwise it 
  1290. will contain a Y. 
  1291.  
  1292. There are three abend codes associated with PA2KCBIN namely: 
  1293.  
  1294. PA2L           meaning the COMMAREA passed is not long enough even to return 
  1295.                the header 
  1296.  
  1297. PA2Q           meaning the input parameter is not recognised 
  1298.  
  1299. PA2S           meaning addressability to the Performance Analyser control 
  1300.                blocks has been lost. 
  1301.  
  1302. A C language include file, PA2XXBIN.H, is included in the package and defines 
  1303. the structure of the returned COMMAREA. Note, if there is no conversion, 
  1304. integers are in INTEL format, backwards as compared with an IBM mainframe 
  1305. format. For example, a time of 1.75 seconds (ie 1750 milli-seconds) will be 
  1306. returned as a four byte entry of D6 06 00 00.  This is interpreted as the 
  1307. hexadecimal number '000006D6' which equates to 1750 decimal. 
  1308.  
  1309.  
  1310. ΓòÉΓòÉΓòÉ 11. Transaction Level Trace ΓòÉΓòÉΓòÉ
  1311.  
  1312. Performance Analyser includes a transaction level trace facility.  This enables 
  1313. the tracing of the execution of a CICS transaction and provides "time-of-day" 
  1314. stamps and elapsed time measurements for the start and end of all transactions. 
  1315.  
  1316. The function is controlled using the supplied transaction PA2Y. It can be 
  1317. entered directly (either on its own or with the parameters ON or OFF) or via 
  1318. the Performance Analyser main menu in which case an input field is provided to 
  1319. enter the ON or OFF parameters if required.  (See Performance Analyser main 
  1320. menu). 
  1321.  
  1322. PA2Y                Gives the status of the transaction level trace 
  1323.  
  1324. PA2Y ON             Starts the transaction level trace if it is not already 
  1325.                     running 
  1326.  
  1327. PA2Y OFF            Stops the transaction level trace if it is not already 
  1328.                     stopped 
  1329.  
  1330. PA2TRSIN can then be run to format the binary trace file PA2TRSIN.TRC into the 
  1331. readable form PA2STATS.RPT. PA2TRSIN must be run in the cicsdrv:\CICS200\BIN 
  1332. sub-directory. 
  1333.  
  1334. Running the Transaction Level Trace in this fashion provides  system 
  1335. programmers with an insight as to the way the system is behaving, for example 
  1336. how much multi-tasking is going on. 
  1337.  
  1338. The fields within the trace are as follows: 
  1339.  
  1340. Time                Time of day printed as Hours:Minutes:Seconds.Hundredths 
  1341.  
  1342. PID                 The OS/2 process id. If it is blank, the process id is the 
  1343.                     same as the line above 
  1344.  
  1345. Type                Entry or Exit with the transaction name printed further to 
  1346.                     the right 
  1347.  
  1348. Component time      Time difference (in seconds and hundredths) between the 
  1349.                     Entry and Exit record. 
  1350.  
  1351.  
  1352. ΓòÉΓòÉΓòÉ 12. Application Level Trace ΓòÉΓòÉΓòÉ
  1353.  
  1354. Performance Analyser includes an application level trace facility.  This 
  1355. enables the tracing of the execution of a CICS application and provides both 
  1356. "time-of-day" stamps and elapsed time measurements for the EXEC CICS calls and 
  1357. internal CICS for OS/2 functions. 
  1358.  
  1359. The function is controlled using the supplied transaction PA2O. It can be 
  1360. entered directly (either on its own or with the parameters ON or OFF) or via 
  1361. the Performance Analyser main menu in which case an input field is provided to 
  1362. enter the ON or OFF parameters if required.  (See Performance Analyser main 
  1363. menu). 
  1364.  
  1365. PA2O                Gives the status of the application level trace 
  1366.  
  1367. PA2O ON             Starts the application level trace if it is not already 
  1368.                     running 
  1369.  
  1370. PA2O OFF            Stops the application level trace if it is not already 
  1371.                     stopped 
  1372.  
  1373. PA2DKSIN can then be run to format the binary trace file PA2STATS.TRC into the 
  1374. readable form PA2STATS.RPT. PA2DKSIN must be run in the cicsdrv:\CICS200\BIN 
  1375. sub-directory. 
  1376.  
  1377. Running the Application Level Trace in this fashion provides  application 
  1378. programmers with an insight as to the way their code is behaving in the system. 
  1379. An actual trace output file is shown in An example of a PA2STATS.RPT file. 
  1380. Comments have been added so that you can understand what information is 
  1381. available and what can be inferred from the entries. 
  1382.  
  1383. The fields within the trace are as follows: 
  1384.  
  1385. Time                Time of day printed as Hours:Minutes:Seconds.Hundredths 
  1386.  
  1387. PID                 The OS/2 process id. If it is blank, the process id is the 
  1388.                     same as the line above 
  1389.  
  1390. Type                Entry or Exit or blank. If it is blank the resource and 
  1391.                     transaction name will be printed further to the right 
  1392.  
  1393. Description         Explanation of the atomic unit of the task being performed 
  1394.  
  1395. Component time      Time difference (in seconds.hundredths) between an Entry 
  1396.                     and an Exit record for an atomic unit. On a resource line 
  1397.                     this field is the resource name 
  1398.  
  1399. EXEC time           Time difference (in seconds.hundredths) between an Entry 
  1400.                     and an Exit record for an EXEC CICS call. On a resource 
  1401.                     line this field is the transaction name 
  1402.  
  1403. In order that a systems programmer can see what is happening at initialisation, 
  1404. trace can be initialised by creating a text file PA2STATS.INI and inserting /tr 
  1405. in it.  This should then be saved in the cicsdrv:\CICS200\BIN sub-directory; 
  1406. Performance Analyser will read the file and act upon the setting at start-up. 
  1407. Similarly, inserting /xn will start the transaction level trace. 
  1408.  
  1409. Other options are for internal debugging purposes. Any data that is seen by 
  1410. using them is liable to change without warning. They are: 
  1411.  
  1412. o /du to dump working areas 
  1413. o /de to list in CICSMSG.LOG, the resources and its corresponding group that 
  1414.   are being installed. 
  1415.  
  1416.  
  1417. AnexampleofaPA2STATS . RPTfile
  1418.  
  1419.                Performance Analyser for
  1420.                   CICS for OS/2 Version 2
  1421.                        5764-091
  1422.  
  1423.                  High level timing trace
  1424.               All elapsed times in millisecs
  1425.  
  1426.     Time      PID  Type    Description           Component   EXEC
  1427.                                                       time   time
  1428.  
  1429. 15:27:10.38    62  Entry GLBL NetBios/PNA request
  1430.  
  1431. 62 is global process 
  1432.  
  1433. 15:27:12.57        Exit  GLBL NetBios/PNA request     2188
  1434.  
  1435. Still on the global process since the PID is blank 
  1436.  
  1437.                    Entry GLBL NetBios/PNA request
  1438.  
  1439. Time is still 15:27:12.57 since the Time field is blank 
  1440.  
  1441. 15:27:12.75        Exit  GLBL NetBios/PNA request      187
  1442.  
  1443. Component time is 187 milliseconds being the difference of 15:27:12.75 and 
  1444. 15:27:12.57 
  1445.  
  1446.                    Entry GLBL NetBios/PNA request
  1447. 15:27:12.82        Exit  GLBL NetBios/PNA request       63
  1448.  
  1449. Start up 3 threads for NetBios (See thread information, CICS for OS/2 thread 
  1450. requirements). 
  1451.  
  1452. 15:27:43.32        Entry GLBL GIVEMAIN request
  1453. 15:27:43.38        Exit  GLBL GIVEMAIN request          62
  1454.                    Entry GLBL GIVEMAIN request
  1455.                    Exit  GLBL GIVEMAIN request           0
  1456.                    Entry GLBL GIVEMAIN request
  1457. 15:27:43.41        Exit  GLBL GIVEMAIN request          32
  1458. 15:27:44.41        Entry GLBL GETMAIN request
  1459.                    Exit  GLBL GETMAIN request            0
  1460.  
  1461. First process switch from the global process, 62, to an application process, 67 
  1462.  
  1463. 15:27:44.88    67  Entry Initialise
  1464.                    Exit  Initialise                      0
  1465. 15:27:44.91    66  Entry Initialise
  1466.  
  1467. Switch to application process 66 
  1468.  
  1469.                    Exit  Initialise                      0
  1470. 15:27:45.41    62  Entry GLBL GETMAIN request
  1471.                    Exit  GLBL GETMAIN request            0
  1472.                    Entry GLBL TASK initialisation
  1473.                    Exit  GLBL TASK initialisation        0
  1474. 15:27:45.44        Entry GLBL TASK initialisation
  1475.                    Exit  GLBL TASK initialisation        0
  1476. 15:27:45.63    65  Entry Initialise
  1477.  
  1478. Switch to application process 65 
  1479.  
  1480.                    Exit  Initialise                      0
  1481. 15:27:48.44    62  Entry GLBL TASK initialisation
  1482.                    Exit  GLBL TASK initialisation        0
  1483. 15:27:48.50    65  Entry Load Program
  1484. 15:27:48.54    66  Entry Load Program
  1485.                                                   FAAOISII   INIT
  1486. 15:27:48.60    67  Entry Load Program
  1487.                                                   FAAOISII   INIT
  1488.                65                                 FAAOISII   INIT
  1489. 15:27:49.29    66  Exit  Load Program                   94
  1490.                67  Exit  Load Program                   32
  1491. 15:27:49.41    65  Exit  Load Program                  251
  1492.  
  1493. Loading program FAAOISII under internal transaction INIT on all three processes 
  1494. 65, 66, and 67 
  1495.  
  1496. 15:27:49.47    66  Entry Init prog COBOL call
  1497. 15:27:49.75    67  Entry Init prog COBOL call
  1498. 15:27:50.19    66  Exit  Init COBOL prog call          719
  1499.  
  1500. Setting up COBOL environment 
  1501.  
  1502.                    Entry EXEC CICS ADDRESS
  1503. 15:27:50.22        Exit  EXEC CICS ADDRESS                     31
  1504.  
  1505. EXEC time is 31 milliseconds being the difference of 15:27:50.22 and 
  1506. 15:27:50.19 
  1507.  
  1508.                    Entry EXEC CICS RETURN
  1509.                    Exit  EXEC CICS RETURN                       0
  1510. 15:27:50.29        Entry POP ALL
  1511.                    Exit  POP ALL                         0
  1512.                    Entry Delete program
  1513. 15:27:50.35    67  Exit  Init COBOL prog call          594
  1514.  
  1515. Setting up COBOL environment for FAAOISII 
  1516.  
  1517.                    Entry EXEC CICS ADDRESS
  1518.                    Exit  EXEC CICS ADDRESS                      0
  1519.                    Entry EXEC CICS RETURN
  1520. 15:27:50.38        Exit  EXEC CICS RETURN                      31
  1521.                    Entry POP ALL
  1522.  
  1523. Clear all CICS handles 
  1524.  
  1525.                    Exit  POP ALL                         0
  1526. 15:27:50.41    66  Exit  Delete program                125
  1527.                    Entry Load Program
  1528.                                                   FAAPLTPI   INIT
  1529. 15:27:50.66    65  Entry Init prog COBOL call
  1530. 15:27:50.69        Exit  Init COBOL prog call           31
  1531. 15:27:50.72    66  Exit  Load Program                  312
  1532.                65  Entry EXEC CICS ADDRESS
  1533. 15:27:50.75        Exit  EXEC CICS ADDRESS                     31
  1534.                    Entry EXEC CICS READ
  1535.                                                   FAACTFTB   INIT
  1536. 15:27:50.85        Entry FM GET EQUAL
  1537. 15:27:50.88    66  Entry Init prog C call
  1538.  
  1539. Setting up C environment 
  1540.  
  1541. 15:27:50.97        Exit  Init prog C call               94
  1542.                    Entry EXEC CICS ADDRESS
  1543. 15:27:51.00        Exit  EXEC CICS ADDRESS                     31
  1544.                    Entry EXEC CICS START
  1545.                                                   PA21       INIT
  1546.  
  1547. START transaction PA21 from transaction INIT 
  1548.  
  1549. 15:27:51.32    65  Exit  FM GET EQUAL                  187
  1550.                    Exit  EXEC CICS READ                       281
  1551.                    Entry EXEC CICS HANDLE
  1552. 15:27:51.35        Exit  EXEC CICS HANDLE                      31
  1553. 15:27:51.38        Entry EXEC CICS START
  1554.                                                   CLOG       INIT
  1555.  
  1556. START transaction CLOG from transaction INIT 
  1557.  
  1558. 15:27:51.47    66  Exit  EXEC CICS START                      187
  1559.                    Entry EXEC CICS WRITE OPERATOR
  1560. 15:27:51.50        Exit  EXEC CICS WRITE OPERATOR              31
  1561.                    Entry EXEC CICS XCTL
  1562. 15:27:51.57    65  Exit  EXEC CICS START                      188
  1563.                    Entry Load Program
  1564.                                                   FAAMGSON   INIT
  1565. 15:27:52.07    66  Exit  EXEC CICS XCTL                       532
  1566. 15:27:52.10        Entry POP ALL
  1567.                    Exit  POP ALL                         0
  1568.                    Entry Delete program
  1569.  
  1570. Deleting program so was not marked resident 
  1571.  
  1572. 15:27:52.13        Exit  Delete program                 31
  1573. 15:27:52.16    65  Exit  Load Program                  563
  1574. 15:27:52.19        Entry Init prog COBOL call
  1575.                    Exit  Init COBOL prog call            0
  1576. 15:27:52.22        Entry EXEC CICS READ
  1577.                                                   FAAMGFMG   INIT
  1578.                    Entry FM GET EQUAL
  1579. 15:27:52.25    62  Entry GLBL File Manager request
  1580. 15:27:52.29    66  Entry Load Program
  1581.                                                   FAAOIS04   INIT
  1582.  
  1583. Program FAAOISS04 will run on each application process as the second part of 
  1584. PLT processing 
  1585.  
  1586. 15:27:52.32        Exit  Load Program                    0
  1587. 15:27:52.35        Entry Init prog COBOL call
  1588.                    Exit  Init COBOL prog call            0
  1589.                    Entry EXEC CICS RETURN
  1590. 15:27:52.38        Exit  EXEC CICS RETURN                      31
  1591.                    Entry POP ALL
  1592.                    Exit  POP ALL                         0
  1593. 15:27:52.41        Entry GET message
  1594.                    Entry FM GET EQUAL
  1595.                67  Entry Delete program
  1596. 15:27:52.44        Exit  Delete program                 31
  1597. 15:27:52.47        Entry Load Program
  1598.                                                   FAAOIS04   INIT
  1599.  
  1600. Second load of program FAAOISS04 
  1601.  
  1602. 15:27:52.57        Exit  Load Program                   94
  1603.                    Entry Init prog COBOL call
  1604. 15:27:52.60        Exit  Init COBOL prog call           31
  1605.                    Entry EXEC CICS RETURN
  1606. 15:27:52.63        Exit  EXEC CICS RETURN                      31
  1607.                    Entry POP ALL
  1608.                    Exit  POP ALL                         0
  1609. 15:27:52.66        Entry GET message
  1610.                    Entry FM GET EQUAL
  1611. 15:27:52.72    62  Exit  GLBL File Manager request     438
  1612.                    Entry GLBL File Manager request
  1613.                65  Exit  FM GET EQUAL                  469
  1614. 15:27:52.75        Exit  EXEC CICS READ                       500
  1615.                    Entry EXEC CICS RETURN
  1616.                    Exit  EXEC CICS RETURN                       0
  1617.                    Entry POP P tab
  1618. 15:27:52.82        Exit  POP P tab                      63
  1619. 15:27:52.88        Entry EXEC CICS LINK
  1620.                    Exit  EXEC CICS LINK                         0
  1621. 15:27:52.91        Entry EXEC CICS RETURN
  1622.                    Exit  EXEC CICS RETURN                       0
  1623.                    Entry POP ALL
  1624. 15:27:52.94        Exit  POP ALL                        31
  1625.                    Entry Delete program
  1626. 15:27:53.19        Exit  Delete program                250
  1627.                    Entry Load Program
  1628.                                                   FAAOIS04   INIT
  1629.  
  1630. Third load of program FAAOISS04 
  1631.  
  1632. 15:27:53.32        Exit  Load Program                  125
  1633.                    Entry Init prog COBOL call
  1634. 15:27:53.35        Exit  Init COBOL prog call           31
  1635.                    Entry EXEC CICS RETURN
  1636. 15:27:53.38        Exit  EXEC CICS RETURN                      31
  1637.                    Entry POP ALL
  1638.                    Exit  POP ALL                         0
  1639. 15:27:53.41        Entry GET message
  1640.                    Entry FM GET EQUAL
  1641. 15:27:53.47    62  Exit  GLBL File Manager request     750
  1642.                    Entry GLBL File Manager request
  1643.                66  Exit  FM GET EQUAL                 1062
  1644.                    Exit  GET MESSAGE                  1062
  1645. 15:27:53.54    62  Exit  GLBL File Manager request      63
  1646.                    Entry GLBL File Manager request
  1647.                67  Exit  FM GET EQUAL                  875
  1648.                    Exit  GET MESSAGE                   875
  1649. 15:27:54.07        Entry EXEC CICS ASKTIME
  1650. 15:27:54.10        Exit  EXEC CICS ASKTIME                     31
  1651.                    Entry Task Initiation    PA21
  1652.  
  1653. PA21 now starting 
  1654.  
  1655.                    Entry Delete program
  1656. 15:27:54.13        Exit  Delete program                 31
  1657. 15:27:54.16    62  Exit  GLBL File Manager request     625
  1658.                65  Exit  FM GET EQUAL                  750
  1659. 15:27:54.19        Exit  GET MESSAGE                   781
  1660. 15:27:54.25        Entry EXEC CICS ASKTIME
  1661. 15:27:54.29    67  Entry Load Program
  1662.                                                   PA2PLTPI   PA21
  1663. 15:27:54.72    66  Entry EXEC CICS ASKTIME
  1664.                    Exit  EXEC CICS ASKTIME                      0
  1665. 15:27:54.75        Entry Task Initiation    CRSR
  1666.  
  1667. CRSR now starting on process 66 
  1668.  
  1669.                    Entry Delete program
  1670.                65  Exit  EXEC CICS ASKTIME                    500
  1671. 15:27:54.79        Entry Task Initiation    CLOG
  1672.  
  1673. CLOG now starting on process 65 
  1674.  
  1675. 15:27:54.82        Entry Delete program
  1676. 15:27:54.88        Exit  Delete program                 62
  1677.                    Entry Load Program
  1678.                                                   FAALSPDL   CLOG
  1679. 15:27:55.16        Exit  Load Program                  282
  1680. 15:27:55.22        Entry Init prog COBOL call
  1681.                    Exit  Init COBOL prog call            0
  1682. 15:27:55.25    66  Exit  Delete program                500
  1683.                    Entry Load Program
  1684.                                                   FAAOIPTD   CRSR
  1685. 15:27:55.29    65  Entry EXEC CICS ASSIGN
  1686.                    Exit  EXEC CICS ASSIGN                       0
  1687.                    Entry EXEC CICS ASSIGN
  1688.                    Exit  EXEC CICS ASSIGN                       0
  1689. 15:27:55.32        Entry EXEC CICS SEND
  1690.                    Entry FM GET EQUAL
  1691. 15:27:55.35    62  Entry GLBL File Manager request
  1692.  
  1693. File Manager call in middle of a EXEC CICS SEND, must be a SEND MAP 
  1694.  
  1695. 15:27:55.50    67  Exit  Load Program                 1218
  1696. 15:27:55.54        Entry Init prog C call
  1697. 15:27:55.57    66  Exit  Load Program                  313
  1698. 15:27:55.69        Entry Init prog COBOL call
  1699. 15:27:55.72    67  Exit  Init prog C call              187
  1700.                    Entry EXEC CICS ADDRESS
  1701. 15:27:55.75        Exit  EXEC CICS ADDRESS                     31
  1702.                    Entry EXEC CICS CHANGE TASK
  1703.                    Exit  EXEC CICS CHANGE TASK                  0
  1704.                    Entry EXEC CICS WRITE OPERATOR
  1705. 15:27:55.85    66  Exit  Init COBOL prog call          156
  1706.                    Entry EXEC CICS ADDRESS
  1707.                    Exit  EXEC CICS ADDRESS                      0
  1708. 15:27:55.88    67  Exit  EXEC CICS WRITE OPERATOR             125
  1709. 15:27:55.91        Entry EXEC CICS STARTBR
  1710.                                                   FAACTFTB   PA21
  1711.  
  1712. Performance Analyser START BROWSE of resource data 
  1713.  
  1714.                    Entry FM GET EQUAL KEY
  1715.                66  Entry EXEC CICS ASSIGN
  1716. 15:27:55.94        Exit  EXEC CICS ASSIGN                      31
  1717.                    Entry EXEC CICS STARTBR
  1718.                                                   FAACTFTB   CRSR
  1719.  
  1720. CRSR browsing resource data at same time 
  1721.  
  1722. 15:27:56.29        Entry FM GET EQUAL KEY
  1723. 15:27:56.32    67  Exit  FM GET EQUAL KEY               62
  1724.                    Entry FM GET GTEQ KEY
  1725.                    Exit  FM GET GTEQ KEY                 0
  1726.  
  1727. EXEC CICS STARTBR caused 2 calls to the File Manager, a GET EQUAL and a GET 
  1728. GTEQ 
  1729.  
  1730.                    Exit  EXEC CICS STARTBR                     62
  1731. 15:27:56.35        Entry EXEC CICS READNEXT
  1732.                                                   FAACTFTB   PA21
  1733.                    Entry FM GET GTEQ
  1734. 15:27:56.38    66  Exit  FM GET EQUAL KEY               93
  1735.                    Entry FM GET GTEQ KEY
  1736. 15:27:56.41        Exit  FM GET GTEQ KEY                32
  1737.                    Exit  EXEC CICS STARTBR                    125
  1738. 15:27:56.44        Entry EXEC CICS ENDBR
  1739.  
  1740. END BROWSE follows START BROWSE immediately, probably checking for a a record 
  1741. and when not there exiting 
  1742.  
  1743.                                                   FAACTFTB   CRSR
  1744. 15:27:56.47    62  Exit  GLBL File Manager request     781
  1745.                66  Exit  EXEC CICS ENDBR                       31
  1746.                    Entry EXEC CICS RETURN
  1747. 15:27:56.50        Exit  EXEC CICS RETURN                      31
  1748.                    Entry POP ALL
  1749.                    Exit  POP ALL                         0
  1750. 15:27:56.54    65  Exit  FM GET EQUAL                  875
  1751.                66  Entry clear POST
  1752.                    Exit  Internal clear POST             0
  1753.                    Entry EXEC CICS SYNCPOINT
  1754. 15:27:57.00    65  Exit  EXEC CICS SEND                      1343
  1755.                    Entry EXEC CICS RETURN
  1756. 15:27:57.04        Exit  EXEC CICS RETURN                      32
  1757.  
  1758. Implicit SYNCPOINT at end of transaction, no CICS recoverable resources 
  1759. involved 
  1760.  
  1761.                66  Exit  EXEC CICS SYNCPOINT                  500
  1762.                    Exit  Task Termination             1938
  1763. 15:27:57.07    65  Entry POP ALL
  1764.                    Exit  POP ALL                         0
  1765.                    Entry clear POST
  1766. 15:27:57.10        Exit  Internal clear POST            31
  1767.                    Entry EXEC CICS SYNCPOINT
  1768.  
  1769. Implicit SYNCPOINT at end of transaction, no CICS recoverable resources 
  1770. involved 
  1771.  
  1772.                    Exit  EXEC CICS SYNCPOINT                    0
  1773. 15:27:57.13        Exit  Task Termination             1999
  1774. 15:27:57.19    67  Exit  FM GET GTEQ                   844
  1775. 15:27:57.22        Exit  EXEC CICS READNEXT                   875
  1776.                    Entry EXEC CICS WRITE OPERATOR
  1777. 15:27:57.25        Exit  EXEC CICS WRITE OPERATOR              31
  1778.                    Entry EXEC CICS READNEXT
  1779.                                                   FAACTFTB   PA21
  1780.                    Entry FM GET NEXT
  1781. 15:27:57.29        Exit  FM GET NEXT                    32
  1782.                    Exit  EXEC CICS READNEXT                    32
  1783.  .. .. .. .. .. ..
  1784.  .. .. .. .. .. ..
  1785.  
  1786.                    Entry EXEC CICS READNEXT
  1787.                                                   FAACTFTB   PA21
  1788. 15:28:00.29        Entry FM GET NEXT
  1789.                65  Entry EXEC CICS ASKTIME
  1790.                    Exit  EXEC CICS ASKTIME                      0
  1791. 15:28:00.32        Entry Task Initiation    CLOG
  1792.  
  1793. CLOG now starting on process 65 
  1794.  
  1795.                    Entry Load Program
  1796.                                                   FAALSPDL   CLOG
  1797. 15:28:00.35        Exit  Load Program                   31
  1798.                    Entry Init prog COBOL call
  1799. 15:28:00.38        Exit  Init COBOL prog call           31
  1800.                    Entry EXEC CICS RECEIVE
  1801.                    Exit  EXEC CICS RECEIVE                      0
  1802. 15:28:00.41        Entry EXEC CICS XCTL
  1803. 15:28:00.63        Exit  EXEC CICS XCTL                       218
  1804.                    Entry POP ALL
  1805.                    Exit  POP ALL                         0
  1806. 15:28:00.66    67  Exit  FM GET NEXT                   375
  1807.                    Exit  EXEC CICS READNEXT                   375
  1808.                    Entry EXEC CICS WRITE OPERATOR
  1809. 15:28:00.88        Exit  EXEC CICS WRITE OPERATOR             218
  1810. 15:28:00.91        Entry EXEC CICS READNEXT
  1811.                                                   FAACTFTB   PA21
  1812.                    Entry FM GET NEXT
  1813.                65  Entry Delete program
  1814. 15:28:01.29        Exit  Delete program                375
  1815. 15:28:01.32        Entry Load Program
  1816.                                                   FAALSPSN   CLOG
  1817.                    Exit  Load Program                    0
  1818. 15:28:01.35        Entry Init prog COBOL call
  1819.                    Exit  Init COBOL prog call            0
  1820. 15:28:01.38        Entry EXEC CICS SIGNOFF
  1821.                    Exit  EXEC CICS SIGNOFF                      0
  1822.                    Entry EXEC CICS SEND
  1823. 15:28:01.41        Entry FM GET EQUAL
  1824.  
  1825. File Manager call in middle of a EXEC CICS SEND, must be a SEND MAP 
  1826.  
  1827.                62  Entry GLBL File Manager request
  1828. 15:28:01.47    67  Exit  FM GET NEXT                   562
  1829.                    Exit  EXEC CICS READNEXT                   562
  1830.  .. .. .. .. .. ..
  1831.  .. .. .. .. .. ..
  1832.  
  1833.                    Entry EXEC CICS READNEXT
  1834.                                                   FAACTFTB   PA21
  1835. 15:28:02.38        Entry FM GET NEXT
  1836.                62  Exit  GLBL File Manager request     937
  1837. 15:28:02.41    65  Exit  FM GET EQUAL                  969
  1838. 15:28:03.16    67  Exit  FM GET NEXT                   782
  1839.                    Exit  EXEC CICS READNEXT                   782
  1840.                    Entry EXEC CICS WRITE OPERATOR
  1841. 15:28:03.19        Exit  EXEC CICS WRITE OPERATOR              31
  1842. 15:28:03.22        Entry EXEC CICS READNEXT
  1843.                                                   FAACTFTB   PA21
  1844.                    Entry FM GET NEXT
  1845. 15:28:03.25    65  Exit  EXEC CICS SEND                      1844
  1846. 15:28:03.57        Entry EXEC CICS RETURN
  1847.                    Exit  EXEC CICS RETURN                       0
  1848.                    Entry POP ALL
  1849. 15:28:03.60        Exit  POP ALL                        31
  1850.                    Entry clear POST
  1851. 15:28:03.63        Exit  Internal clear POST            31
  1852.                    Entry EXEC CICS SYNCPOINT
  1853.  
  1854. Implicit SYNCPOINT at end of transaction, no CICS recoverable resources 
  1855. involved 
  1856.  
  1857.                    Exit  EXEC CICS SYNCPOINT                    0
  1858.                    Exit  Task Termination             3281
  1859. 15:28:03.69    67  Exit  FM GET NEXT                   469
  1860.                    Exit  EXEC CICS READNEXT                   469
  1861.                    Entry EXEC CICS WRITE OPERATOR
  1862. 15:28:03.72        Exit  EXEC CICS WRITE OPERATOR              31
  1863.                    Entry EXEC CICS READNEXT
  1864.                                                   FAACTFTB   PA21
  1865.  .. .. .. .. .. ..
  1866.                    Entry EXEC CICS READNEXT
  1867.                                                   FAACTFTB   PA21
  1868. 15:28:17.69        Entry FM GET NEXT
  1869.                65  Entry EXEC CICS ASKTIME
  1870. 15:28:18.16        Exit  EXEC CICS ASKTIME                    469
  1871.                    Entry Task Initiation    CLOG
  1872. 15:28:18.19        Entry Delete program
  1873. 15:28:18.25        Exit  Delete program                 62
  1874.                    Entry Load Program
  1875.                                                   FAALSPDL   CLOG
  1876. 15:28:18.38        Exit  Load Program                  125
  1877. 15:28:18.41        Entry Init prog COBOL call
  1878. 15:28:18.44        Exit  Init COBOL prog call           31
  1879.                    Entry EXEC CICS XCTL
  1880. 15:28:18.50    67  Exit  FM GET NEXT                   812
  1881.                    Exit  EXEC CICS READNEXT                   843
  1882.                    Entry EXEC CICS WRITE OPERATOR
  1883. 15:28:18.54        Exit  EXEC CICS WRITE OPERATOR              32
  1884.                    Entry EXEC CICS READNEXT
  1885.                                                   FAACTFTB   PA21
  1886. 15:28:18.57        Entry FM GET NEXT
  1887. 15:28:19.10    65  Exit  EXEC CICS XCTL                       656
  1888. 15:28:19.13        Entry POP ALL
  1889.                    Exit  POP ALL                         0
  1890.                    Entry Delete program
  1891. 15:28:19.19        Exit  Delete program                 63
  1892. 15:28:19.22        Entry Load Program
  1893.                                                   FAALSPSN   CLOG
  1894.                    Exit  Load Program                    0
  1895. 15:28:19.25        Entry Init prog COBOL call
  1896.                    Exit  Init COBOL prog call            0
  1897. 15:28:19.32        Entry EXEC CICS HANDLE
  1898.                    Exit  EXEC CICS HANDLE                       0
  1899.                    Entry EXEC CICS HANDLE
  1900.                    Exit  EXEC CICS HANDLE                       0
  1901. 15:28:19.35    67  Exit  FM GET NEXT                   781
  1902.                    Exit  EXEC CICS READNEXT                   812
  1903.                    Entry EXEC CICS WRITE OPERATOR
  1904. 15:28:19.38        Exit  EXEC CICS WRITE OPERATOR              31
  1905.                    Entry EXEC CICS READNEXT
  1906.                                                   FAACTFTB   PA21
  1907. 15:28:19.41        Entry FM GET NEXT
  1908.                65  Entry EXEC CICS RECEIVE
  1909. 15:28:19.44        Exit  EXEC CICS RECEIVE                     31
  1910.                    Entry EXEC CICS SIGNON
  1911.                    Entry FM GET EQUAL
  1912.  
  1913. File Manager call in middle of a EXEC CICS SIGNON 
  1914.  
  1915. 15:28:19.79    67  Exit  FM GET NEXT                   375
  1916.                    Exit  EXEC CICS READNEXT                   407
  1917.                    Entry EXEC CICS WRITE OPERATOR
  1918. 15:28:19.82        Exit  EXEC CICS WRITE OPERATOR              31
  1919.                    Entry EXEC CICS READNEXT
  1920.                                                   FAACTFTB   PA21
  1921. 15:28:19.85        Entry FM GET NEXT
  1922. 15:28:20.16    65  Exit  FM GET EQUAL                  688
  1923. 15:28:20.19    67  Exit  FM GET NEXT                   344
  1924. 15:28:20.22        Exit  EXEC CICS READNEXT                   375
  1925.                    Entry EXEC CICS WRITE OPERATOR
  1926. 15:28:20.25    65  Exit  EXEC CICS SIGNON                     781
  1927.                    Entry EXEC CICS ASKTIME
  1928.                67  Exit  EXEC CICS WRITE OPERATOR              31
  1929. 15:28:20.29        Entry EXEC CICS READNEXT
  1930.                                                   FAACTFTB   PA21
  1931. 15:28:20.60        Entry FM GET NEXT
  1932. 15:28:20.63    65  Exit  EXEC CICS ASKTIME                    375
  1933.                    Entry EXEC CICS WRITEQ TS/TD
  1934.                                                   CSCS       CLOG
  1935. 15:28:20.66        Entry FM GET GLEQ MLOCK
  1936.                62  Entry GLBL File Manager request
  1937.  
  1938. File Manager call switched to Global Task, must be non-recoverable 
  1939.  
  1940. 15:28:20.69        Exit  GLBL File Manager request      31
  1941.                65  Exit  FM GET GLEQ MLOCK              31
  1942.                    Entry FM INSERT
  1943. 15:28:20.72    62  Entry GLBL File Manager request
  1944. 15:28:21.04        Exit  GLBL File Manager request     313
  1945.                65  Exit  FM INSERT                     344
  1946.                    Exit  EXEC CICS WRITEQ TS/TD               375
  1947. 15:28:21.07        Entry Load Program
  1948.                                                   FAAMGSON   CLOG
  1949. 15:28:21.10    67  Exit  FM GET NEXT                   468
  1950.                    Exit  EXEC CICS READNEXT                   780
  1951.                    Entry EXEC CICS WRITE OPERATOR
  1952. 15:28:21.16        Exit  EXEC CICS WRITE OPERATOR              63
  1953. 15:28:21.19        Entry EXEC CICS READNEXT
  1954.                                                   FAACTFTB   PA21
  1955.                    Entry FM GET NEXT
  1956. 15:28:21.66    65  Exit  Load Program                  594
  1957. 15:28:21.75    67  Exit  FM GET NEXT                   562
  1958.                    Exit  EXEC CICS READNEXT                   562
  1959.                    Entry EXEC CICS WRITE OPERATOR
  1960. 15:28:21.79    65  Entry Init prog COBOL call
  1961. 15:28:21.82        Exit  Init COBOL prog call           31
  1962.                    Entry EXEC CICS READ
  1963.                                                   FAAMGFMG   CLOG
  1964.  
  1965. CICS for OS/2 getting message text 
  1966.  
  1967. 15:28:21.85    67  Exit  EXEC CICS WRITE OPERATOR              94
  1968.                    Entry EXEC CICS READNEXT
  1969.                                                   FAACTFTB   PA21
  1970. 15:28:21.91        Entry FM GET NEXT
  1971.                65  Entry FM GET EQUAL
  1972. 15:28:21.94    62  Entry GLBL File Manager request
  1973. 15:28:22.25    67  Exit  FM GET NEXT                   343
  1974. 15:28:22.29        Exit  EXEC CICS READNEXT                   407
  1975.  .. .. .. .. .. ..
  1976.  .. .. .. .. .. ..
  1977.  
  1978.                    Entry EXEC CICS READNEXT
  1979.                                                   FAACTFTB   PA21
  1980. 15:28:23.22        Entry FM GET NEXT
  1981. 15:28:23.25    62  Exit  GLBL File Manager request    1281
  1982. 15:28:23.60    65  Exit  FM GET EQUAL                 1656
  1983.                    Exit  EXEC CICS READ                      1719
  1984.                    Entry EXEC CICS RETURN
  1985. 15:28:23.63        Exit  EXEC CICS RETURN                      31
  1986. 15:28:23.94        Entry POP P tab
  1987. 15:28:23.97        Exit  POP P tab                      31
  1988. 15:28:24.00        Entry EXEC CICS LINK
  1989.                    Exit  EXEC CICS LINK                         0
  1990.                    Entry EXEC CICS SEND
  1991. 15:28:24.35        Exit  EXEC CICS SEND                       344
  1992.                    Entry EXEC CICS RETURN
  1993. 15:28:24.38        Exit  EXEC CICS RETURN                      31
  1994.                    Entry POP ALL
  1995.                    Exit  POP ALL                         0
  1996.                    Entry clear POST
  1997. 15:28:24.41    67  Exit  FM GET NEXT                  1188
  1998.                    Exit  EXEC CICS READNEXT                  1188
  1999.                    Entry EXEC CICS WRITE OPERATOR
  2000. 15:28:24.44        Exit  EXEC CICS WRITE OPERATOR              31
  2001.                    Entry EXEC CICS READNEXT
  2002.                                                   FAACTFTB   PA21
  2003. 15:28:24.47        Entry FM GET NEXT
  2004.                65  Exit  Internal clear POST            94
  2005.                    Entry EXEC CICS SYNCPOINT
  2006.  
  2007. Implicit SYNCPOINT at end of transaction, no CICS recoverable resources 
  2008. involved 
  2009.  
  2010. 15:28:24.82        Exit  EXEC CICS SYNCPOINT                  344
  2011.                    Exit  Task Termination             6531
  2012. 15:28:24.88    67  Exit  FM GET NEXT                   406
  2013.                    Exit  EXEC CICS READNEXT                   437
  2014.  .. .. .. .. .. ..
  2015.  .. .. .. .. .. ..
  2016.  
  2017.                    Entry EXEC CICS ENDBR
  2018.                                                   FAACTFTB   PA21
  2019. 15:28:29.63        Exit  EXEC CICS ENDBR                        0
  2020. 15:28:30.07        Entry EXEC CICS RETURN
  2021.                    Exit  EXEC CICS RETURN                       0
  2022.                    Entry POP ALL
  2023. 15:28:30.10        Exit  POP ALL                        31
  2024.                    Entry clear POST
  2025.                    Exit  Internal clear POST             0
  2026.                    Entry EXEC CICS SYNCPOINT
  2027.  
  2028. Implicit SYNCPOINT at end of transaction, no CICS recoverable resources 
  2029. involved 
  2030.  
  2031. 15:28:30.13        Exit  EXEC CICS SYNCPOINT                   31
  2032.                    Exit  Task Termination            32190
  2033. 15:28:41.38    65  Entry EXEC CICS ASKTIME
  2034. 15:28:41.41        Exit  EXEC CICS ASKTIME                     32
  2035.                    Entry Task Initiation    CECI
  2036.                    Entry Delete program
  2037. 15:28:41.47        Exit  Delete program                 62
  2038.                    Entry Load Program
  2039.                                                   FAAATPCI   CECI
  2040. 15:28:41.79        Exit  Load Program                  313
  2041. 15:28:42.22        Entry Init prog COBOL call
  2042. 15:28:42.25        Exit  Init COBOL prog call           31
  2043.                    Entry EXEC CICS HANDLE
  2044.                    Exit  EXEC CICS HANDLE                       0
  2045. 15:28:42.29        Entry EXEC CICS ASSIGN
  2046.                    Exit  EXEC CICS ASSIGN                       0
  2047.                    Entry EXEC CICS ASSIGN
  2048. 15:28:42.32        Exit  EXEC CICS ASSIGN                      31
  2049.                    Entry EXEC CICS HANDLE
  2050.                    Exit  EXEC CICS HANDLE                       0
  2051. 15:28:42.38        Entry EXEC CICS GETMAIN
  2052.                    Exit  EXEC CICS GETMAIN                      0
  2053.                    Entry EXEC CICS GETMAIN
  2054. 15:28:42.41        Exit  EXEC CICS GETMAIN                     32
  2055.                    Entry EXEC CICS GETMAIN
  2056.                    Exit  EXEC CICS GETMAIN                      0
  2057. 15:28:42.44        Entry EXEC CICS GETMAIN
  2058.                    Exit  EXEC CICS GETMAIN                      0
  2059.                    Entry EXEC CICS GETMAIN
  2060. 15:28:42.47        Exit  EXEC CICS GETMAIN                     31
  2061.                    Entry EXEC CICS GETMAIN
  2062.                    Exit  EXEC CICS GETMAIN                      0
  2063.                    Entry EXEC CICS GETMAIN
  2064. 15:28:42.50        Exit  EXEC CICS GETMAIN                     31
  2065.                    Entry EXEC CICS GETMAIN
  2066.                    Exit  EXEC CICS GETMAIN                      0
  2067.  
  2068. Eight GETMAINs taking 94 milliseconds on this machine 
  2069.  
  2070. 15:28:42.54        Entry EXEC CICS RECEIVE
  2071.                    Exit  EXEC CICS RECEIVE                      0
  2072. 15:28:42.57        Entry EXEC CICS SEND
  2073.                    Entry FM GET EQUAL
  2074. 15:28:42.60    62  Entry GLBL File Manager request
  2075. 15:28:42.72        Exit  GLBL File Manager request     125
  2076.                65  Exit  FM GET EQUAL                  156
  2077. 15:28:43.41        Exit  EXEC CICS SEND                       844
  2078.                    Entry EXEC CICS RECEIVE
  2079. 15:28:43.60        Exit  EXEC CICS RECEIVE                    187
  2080. 15:28:43.66        Entry EXEC CICS SEND
  2081. 15:28:43.94        Exit  EXEC CICS SEND                       281
  2082. 15:28:43.97        Entry Load Program
  2083.                                                   PA2ABEND   CECI
  2084. 15:28:44.57        Exit  Load Program                  594
  2085. 15:28:44.69        Entry Init prog C call
  2086. 15:28:44.72        Exit  Init prog C call               31
  2087. 15:28:44.97        Entry EXEC CICS WRITE OPERATOR
  2088. 15:28:45.00        Exit  EXEC CICS WRITE OPERATOR              31
  2089. 15:28:45.07        Entry EXEC CICS ABEND
  2090.                    Entry FM GET EQUAL
  2091. 15:28:45.10    62  Entry GLBL File Manager request
  2092. 15:28:45.13        Exit  GLBL File Manager request      31
  2093.                65  Exit  FM GET EQUAL                   62
  2094.                                                   CSMT       CECI
  2095.                    Entry FM GET GLEQ MLOCK
  2096. 15:28:45.16    62  Entry GLBL File Manager request
  2097.  
  2098. Message to CSMT queue, unrecoverable queue since switch to Global Task 
  2099.  
  2100.                    Exit  GLBL File Manager request       0
  2101. 15:28:45.19    65  Exit  FM GET GLEQ MLOCK              63
  2102.                    Entry FM INSERT
  2103. 15:28:45.22    62  Entry GLBL File Manager request
  2104.                    Exit  GLBL File Manager request       0
  2105. 15:28:45.25    65  Exit  FM INSERT                      62
  2106. 15:28:46.10        Exit  EXEC CICS ABEND                     1031
  2107.                    Entry POP P tab
  2108.                    Exit  POP P tab                       0
  2109. 15:28:46.13        Entry EXEC CICS ASSIGN
  2110.                    Exit  EXEC CICS ASSIGN                       0
  2111.                    Entry EXEC CICS RECEIVE
  2112. 15:28:46.19        Exit  EXEC CICS RECEIVE                     63
  2113.                    Entry EXEC CICS GETMAIN
  2114. 15:28:46.22        Exit  EXEC CICS GETMAIN                     31
  2115.                    Entry EXEC CICS LINK
  2116.                    Exit  EXEC CICS LINK                         0
  2117. 15:28:46.25        Entry EXEC CICS SEND
  2118. 15:28:46.94        Exit  EXEC CICS SEND                       688
  2119.                    Entry EXEC CICS RECEIVE
  2120. 15:28:47.91        Exit  EXEC CICS RECEIVE                    969
  2121. 15:28:48.00        Entry EXEC CICS SEND
  2122. 15:28:48.69        Exit  EXEC CICS SEND                       688
  2123.                    Entry EXEC CICS RECEIVE
  2124. 15:28:49.16        Exit  EXEC CICS RECEIVE                    469
  2125. 15:28:49.22        Entry EXEC CICS SEND
  2126. 15:28:49.63        Exit  EXEC CICS SEND                       406
  2127.  
  2128. Conversational program, 3 RECEIVE/SEND pairs 
  2129.  
  2130.                    Entry Load Program
  2131.                                                   PA2ABEND   CECI
  2132. 15:28:49.75        Exit  Load Program                  125
  2133. 15:28:49.79        Entry Init prog C call
  2134.                    Exit  Init prog C call                0
  2135. 15:28:50.04        Entry EXEC CICS WRITE OPERATOR
  2136. 15:28:50.07        Exit  EXEC CICS WRITE OPERATOR              31
  2137. 15:28:50.13        Entry EXEC CICS ABEND
  2138.                    Entry FM GET EQUAL
  2139. 15:28:50.16    62  Entry GLBL File Manager request
  2140.                    Exit  GLBL File Manager request       0
  2141. 15:28:50.50    65  Exit  FM GET EQUAL                  375
  2142.                                                   CSMT       CECI
  2143.                    Entry FM GET GLEQ MLOCK
  2144.  
  2145. Message to CSMT queue, unrecoverable queue since switch to Global Task 
  2146.  
  2147. 15:28:50.54    62  Entry GLBL File Manager request
  2148.                    Exit  GLBL File Manager request       0
  2149.                65  Exit  FM GET GLEQ MLOCK              32
  2150.                    Entry FM INSERT
  2151. 15:28:50.57    62  Entry GLBL File Manager request
  2152. 15:28:50.66        Exit  GLBL File Manager request      94
  2153. 15:28:50.69    65  Exit  FM INSERT                     156
  2154. 15:28:50.91        Exit  EXEC CICS ABEND                      782
  2155.                    Entry POP P tab
  2156. 15:28:50.94        Exit  POP P tab                      31
  2157.                    Entry EXEC CICS ASSIGN
  2158.                    Exit  EXEC CICS ASSIGN                       0
  2159. 15:28:51.00        Entry EXEC CICS FREEMAIN
  2160.                    Exit  EXEC CICS FREEMAIN                     0
  2161.                    Entry EXEC CICS RECEIVE
  2162. 15:28:51.07        Exit  EXEC CICS RECEIVE                     63
  2163.                    Entry EXEC CICS GETMAIN
  2164.                    Exit  EXEC CICS GETMAIN                      0
  2165. 15:28:51.10        Entry EXEC CICS LINK
  2166.                    Exit  EXEC CICS LINK                         0
  2167. 15:28:51.13        Entry EXEC CICS SEND
  2168. 15:28:51.82        Exit  EXEC CICS SEND                       688
  2169.                    Entry EXEC CICS RECEIVE
  2170. 15:28:52.60        Exit  EXEC CICS RECEIVE                    781
  2171.                    Entry EXEC CICS SEND
  2172. 15:28:52.91        Exit  EXEC CICS SEND                       313
  2173.  
  2174. Still a conversational program, 2 RECEIVE/SEND pairs 
  2175.  
  2176.                    Entry EXEC CICS RETURN
  2177.                    Exit  EXEC CICS RETURN                       0
  2178. 15:28:52.94        Entry POP ALL
  2179.                    Exit  POP ALL                         0
  2180.                    Entry clear POST
  2181.                    Exit  Internal clear POST             0
  2182. 15:28:52.97        Entry EXEC CICS SYNCPOINT
  2183.  
  2184. Implicit SYNCPOINT at end of transaction, no CICS recoverable resources 
  2185. involved 
  2186.  
  2187.                    Exit  EXEC CICS SYNCPOINT                    0
  2188. 15:28:53.00        Exit  Task Termination            11593
  2189. 15:29:25.04        Entry EXEC CICS ASKTIME
  2190.                    Exit  EXEC CICS ASKTIME                      0
  2191. 15:29:25.07        Entry Task Initiation    PA2M
  2192.                    Entry Delete program
  2193. 15:29:25.13        Exit  Delete program                 62
  2194.                    Entry Load Program
  2195.                                                   PA2MCDSP   PA2M
  2196. 15:29:25.47        Exit  Load Program                  344
  2197.                    Entry Init prog C call
  2198. 15:29:25.54        Exit  Init prog C call               63
  2199.                    Entry EXEC CICS ADDRESS
  2200.                    Exit  EXEC CICS ADDRESS                      0
  2201. 15:29:25.57        Entry EXEC CICS RECEIVE
  2202.                    Exit  EXEC CICS RECEIVE                      0
  2203.                    Entry Load Program
  2204.                                                   PA2PLTSD   PA2M
  2205. 15:29:25.94        Exit  Load Program                  375
  2206.  
  2207. Actually LINKing to PA2PLTSD from PA2MCDSP 
  2208.  
  2209.                    Entry Init prog C call
  2210. 15:29:25.97        Exit  Init prog C call               31
  2211. 15:29:26.25        Entry EXEC CICS ENQ
  2212.                62  Entry GLBL EXTRA ENQ request
  2213.  
  2214. Make sure only one printout at a time 
  2215.  
  2216. 15:29:26.34        Exit  GLBL EXTRA ENQ request         86
  2217. 15:29:26.36    65  Exit  EXEC CICS ENQ                        110
  2218. 15:29:26.37        Entry EXEC CICS DUMP
  2219.  
  2220. Dump taken because of /du option on Performance Analyser. See page Application 
  2221. Level Trace. 
  2222.  
  2223. 15:29:27.69        Exit  EXEC CICS DUMP                      1321
  2224.                    Entry EXEC CICS WRITE OPERATOR
  2225. 15:29:27.72        Exit  EXEC CICS WRITE OPERATOR              31
  2226. 15:29:28.04        Entry EXEC CICS ADDRESS
  2227. 15:29:28.07        Exit  EXEC CICS ADDRESS                     31
  2228.                    Entry EXEC CICS ADDRESS
  2229.                    Exit  EXEC CICS ADDRESS                      0
  2230.                    Entry EXEC CICS WRITE OPERATOR
  2231.  
  2232. Start message 
  2233.  
  2234. 15:29:28.10        Exit  EXEC CICS WRITE OPERATOR              31
  2235. 15:29:30.19        Entry EXEC CICS WRITE OPERATOR
  2236.  
  2237. End message 
  2238.  
  2239. 15:29:30.22        Exit  EXEC CICS WRITE OPERATOR              31
  2240.                    Entry EXEC CICS DEQ
  2241. 15:29:30.25    62  Entry GLBL EXTRA ENQ request
  2242.                    Exit  GLBL EXTRA ENQ request          0
  2243.                65  Exit  EXEC CICS DEQ                         31
  2244.                    Entry EXEC CICS RETURN
  2245. 15:29:30.29        Exit  EXEC CICS RETURN                      32
  2246. 15:29:30.32        Entry POP P tab
  2247. 15:29:30.35        Exit  POP P tab                      31
  2248.                    Entry EXEC CICS LINK
  2249. 15:29:30.38        Exit  EXEC CICS LINK                        31
  2250.                    Entry EXEC CICS SEND
  2251.                    Entry FM GET EQUAL
  2252. 15:29:30.41    62  Entry GLBL File Manager request
  2253. 15:29:30.94        Exit  GLBL File Manager request     531
  2254. 15:29:30.97    65  Exit  FM GET EQUAL                  594
  2255. 15:29:31.41        Exit  EXEC CICS SEND                      1032
  2256.  
  2257. SEND MAP because call to System File Manager in middle of SEND 
  2258.  
  2259. 15:29:31.44        Entry EXEC CICS RETURN
  2260.                    Exit  EXEC CICS RETURN                       0
  2261.                    Entry POP ALL
  2262.                    Exit  POP ALL                         0
  2263.                    Entry clear POST
  2264. 15:29:31.47        Exit  Internal clear POST            31
  2265.                    Entry EXEC CICS SYNCPOINT
  2266.  
  2267. Implicit SYNCPOINT at end of transaction, no CICS recoverable resources 
  2268. involved 
  2269.  
  2270.                    Exit  EXEC CICS SYNCPOINT                    0
  2271.                    Exit  Task Termination             6406
  2272. 15:29:33.82        Entry EXEC CICS ASKTIME
  2273.                    Exit  EXEC CICS ASKTIME                      0
  2274. 15:29:33.85        Entry Task Initiation    PA2M
  2275.                    Entry Load Program
  2276.                                                   PA2MCDSP   PA2M
  2277.                    Exit  Load Program                    0
  2278. 15:29:33.88        Entry Init prog C call
  2279.                    Exit  Init prog C call                0
  2280. 15:29:33.91        Entry EXEC CICS ADDRESS
  2281.                    Exit  EXEC CICS ADDRESS                      0
  2282.                    Entry EXEC CICS SEND
  2283. 15:29:34.19        Exit  EXEC CICS SEND                       281
  2284.                    Entry EXEC CICS RETURN
  2285. 15:29:34.25        Exit  EXEC CICS RETURN                      62
  2286.                    Entry POP ALL
  2287.                    Exit  POP ALL                         0
  2288. 15:29:34.29        Entry clear POST
  2289.                    Exit  Internal clear POST             0
  2290.                    Entry EXEC CICS SYNCPOINT
  2291.  
  2292. Implicit SYNCPOINT at end of transaction, no CICS recoverable resources 
  2293. involved 
  2294.  
  2295.                    Exit  EXEC CICS SYNCPOINT                    0
  2296. 15:29:34.32        Exit  Task Termination              469
  2297. 15:29:37.85        Entry EXEC CICS ASKTIME
  2298. 15:29:37.88        Exit  EXEC CICS ASKTIME                     31
  2299.                    Entry Task Initiation    CQIT
  2300.                    Entry Delete program
  2301. 15:29:37.91        Exit  Delete program                 32
  2302.                    Entry Load Program
  2303.                                                   FAAOISQT   CQIT
  2304. 15:29:38.13        Exit  Load Program                  218
  2305.                    Entry Init prog COBOL call
  2306. 15:29:38.16        Exit  Init COBOL prog call           32
  2307.                    Entry EXEC CICS ADDRESS
  2308. 15:29:38.19        Exit  EXEC CICS ADDRESS                     31
  2309.                    Entry EXEC CICS ASSIGN
  2310. 15:29:38.22        Exit  EXEC CICS ASSIGN                      31
  2311.                    Entry EXEC CICS RECEIVE
  2312.                    Exit  EXEC CICS RECEIVE                      0
  2313.                    Entry EXEC CICS PERFORM SHUTDOWN
  2314.                                                   I          CQIT
  2315.  
  2316. Transaction CQIT doing a SHUTDOWN IMMEDIATE 
  2317.  
  2318. 15:29:38.35        Exit  EXEC CICS PERFORM SHUTDOWN           125
  2319.                    Entry EXEC CICS ABEND
  2320.                    Entry FM GET EQUAL
  2321. 15:29:40.32    62  Entry GLBL TASK termination
  2322. 15:29:40.35        Exit  GLBL TASK termination          31
  2323.                    Entry GLBL TASK termination
  2324.  
  2325. (C) Copyright IBM Corp. 1994. All rights reserved.
  2326.  
  2327.  
  2328. ΓòÉΓòÉΓòÉ 13. User Clocks ΓòÉΓòÉΓòÉ
  2329.  
  2330. A function that is often required when gathering and monitoring system 
  2331. statistics is the ability to measure the time taken to execute a section of 
  2332. application code and the number of times the code was run.  This requirement is 
  2333. satisfied in Performance Analyser by a function called User Clocks. Up to four 
  2334. clocks can be defined in any transaction, numbered, fairly obviously, 1 through 
  2335. 4. 
  2336.  
  2337. Included with Performance Analyser is the source file, PA2ABEND.CCS, (some of 
  2338. which is reproduced in Part of sample user clocks code (PA2ABEND.CCS)) and its 
  2339. compiled version PA2ABEND.DLL.  It demonstrates how to implement user clocks 
  2340. and also shows what happens if a a mistake is made in the starting and stopping 
  2341. of the clocks. When CICS is running, issue 
  2342.  
  2343.         CECI LINK PROGRAM(PA2ABEND)
  2344. in a 3270 window and press the Enter key (normally the Right Ctrl key) to get 
  2345. it to execute. 
  2346.  
  2347.   PA2CLOCK(PA2BEGIN,1);   /* start clock 1 */
  2348.  
  2349.   PA2CLOCK(PA2BEGIN,2);   /* start clock 2 */
  2350.  
  2351.   PA2CLOCK(PA2BEGIN,3);   /* start clock 3 */
  2352.  
  2353.   PA2CLOCK(PA2END,4);     /* stop clock 4, before started */
  2354.                           /* get stop before start message in FAASTATS.ERR */
  2355.  
  2356.   PA2CLOCK('X',2);        /* pass non valid function value */
  2357.                           /* get non valid function message in FAASTATS.ERR */
  2358.  
  2359.   PA2CLOCK(PA2BEGIN,7);   /* start clock 7, out of range 1-4 */
  2360.                           /* get out of range message in FAASTATS.ERR */
  2361.  
  2362.   /* Perform a CICS statement to put some time on clocks 1,2,and 3 */
  2363.  
  2364.   EXEC CICS WRITE OPERATOR
  2365.     TEXT(Message)
  2366.     TEXTLENGTH((long)strlen(Message));
  2367.  
  2368.   PA2CLOCK(PA2END,2);     /* end clock 2, to get some real data */
  2369.  
  2370.   PA2CLOCK(PA2BEGIN,3);   /* start clock 3, without having stopped it first */
  2371.                           /* get not stopped and not reset clock message in */
  2372.                                                             /* FAASTATS.ERR */
  2373.   .  .  .  .  .  .  .  .
  2374.   .  .  .  .  .  .  .  .
  2375.   EXEC CICS ABEND ABCODE("PA2X");
  2376.  
  2377.                           /* get not stopped clock 1 and 3 before end of */
  2378.                           /* transaction message in FAASTATS.ERR */
  2379.  
  2380. Part of sample user clocks code (PA2ABEND.CCS)
  2381.  
  2382. Clocks 1 and 3 will be stopped at the end of the transaction automatically even 
  2383. if they are not stopped explicitly (although an error message will be generated 
  2384. in FAASTATS.ERR) 
  2385.  
  2386. The FAASTATS.ERR file will also be included in the statistics and monitoring 
  2387. data produced by the transaction PA2M in the file PA2STATS.DAT. The sample code 
  2388. above produces the bucket statistics shown in Bucket statistics produced by 
  2389. PA2ABEND. 
  2390.  
  2391.      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2392.      Γöé Bucket  Γöé Xactn Γöé Times  Γöé  Times  Γöé  Total  Γöé Average Γöé
  2393.      Γöé number  Γöé name  Γöéstarted Γöé stopped Γöé  (secs) Γöé (secs)  Γöé
  2394.      Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2395.      Γöé Clock(1)Γöé CECI  Γöé   1  Γöé   0  Γöé  9.91  Γöé  9.906  Γöé
  2396.      Γöé Clock(2)Γöé CECI  Γöé   1  Γöé   1  Γöé  0.03  Γöé  0.031  Γöé
  2397.      Γöé Clock(3)Γöé CECI  Γöé   2  Γöé   0  Γöé  9.94  Γöé  4.969  Γöé
  2398.      ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2399.  
  2400. Bucket statistics produced by PA2ABEND 
  2401.  
  2402. From this it can be seen that the EXEC CICS WRITE OPERATOR took between 1 and 2 
  2403. timer units from the result of the Clock(2) value. Clock(1) and Clock(3) totals 
  2404. are almost the same (ie approximately 9.91 secs). They look long, and imply 
  2405. that the time between the clock being started and then stopped automatically at 
  2406. the end of the transaction is due to user "think time" and that the task is 
  2407. therefore conversational.  Also, the effect of starting Clock(3) twice can be 
  2408. seen; the times started value is 2 and therefore affects the average (ie it is 
  2409. half that of Clock(1)). 
  2410.  
  2411. In order to resolve the PA2CLOCKinvocations, you will have to add PA2CLOCK.LIB 
  2412. to your link edit library list. 
  2413.  
  2414.  
  2415. ΓòÉΓòÉΓòÉ 14. Using the supplied sample program (PA2BR14) ΓòÉΓòÉΓòÉ
  2416.  
  2417. IEFBR14 is a well known mainframe program which just returns to the caller when 
  2418. invoked.  PA2BR14 supplies this function which can be invoked in several ways. 
  2419.  
  2420.  1. By an EXEC CICS LINK (either locally or remote).  The supplied COMMAREA is 
  2421.     returned. 
  2422.  
  2423.  2. By an EXEC CICS LINK SYNCONRETURN.  A syncpoint is taken and the supplied 
  2424.     COMMAREA is returned to the remote invoker. 
  2425.  
  2426.  3. By an EXEC CICS SEND or CONVERSE over an LU6.2 link. Either Distributed 
  2427.     Transaction Processing (APPC) or Transaction Routing from a remote 3270 
  2428.     terminal or a CICS for OS/2 terminal/client can be used. 
  2429.  
  2430.     The supplied transaction (PA22) in PA2EXMPL group can be invoked from a 
  2431.     3270 terminal. 
  2432.  
  2433.  4. By an EXEC CICS WRITEQ.  This will read the queue and return. If a trigger 
  2434.     level is set up in the DCT then another transaction may be invoked. 
  2435.  
  2436.  5. By an EXEC CICS START with data.  This will return the data and start 
  2437.     another transaction, the ID of which is the same as the first four 
  2438.     characters of the returned data.  PA22 can be used with CECI to test this 
  2439.     out. 
  2440.  
  2441.  6. By an EXEC CICS START with no data.  This will start itself again and thus 
  2442.     go into a loop.  This can be useful for assessing the maximum throughput of 
  2443.     a system. 
  2444.  
  2445.  
  2446. ΓòÉΓòÉΓòÉ 15. Trap information ΓòÉΓòÉΓòÉ
  2447.  
  2448. Following a trap and if the application trace is running, Performance Analyser 
  2449. will output the last 64 calls made to the server in the PA2STATS.DAT file. If 
  2450. the trace is not running, only the trap call will be output. 
  2451.  
  2452. Figure Function callswill be of use in interpreting the last 64 calls. 
  2453.  
  2454.  
  2455. Function calls
  2456.  
  2457.  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2458.  Γöé Function Γöé   Meaning               Γöé
  2459.  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2460.  Γöé  10   Γöé   EXEC CICS SET TRANSACTION      Γöé
  2461.  Γöé  11   Γöé   EXEC CICS INQUIRE TRANSACTION    Γöé
  2462.  Γöé  20   Γöé   Transaction routing         Γöé
  2463.  Γöé  22   Γöé   Delete shipped terminal       Γöé
  2464.  Γöé  28   Γöé   EXEC CICS SET CONNECTION      Γöé
  2465.  Γöé  29   Γöé   EXEC CICS INQUIRE CONNECTION    Γöé
  2466.  Γöé  30   Γöé   EXEC CICS SET FILE         Γöé
  2467.  Γöé  31   Γöé   EXEC CICS INQUIRE FILE       Γöé
  2468.  Γöé  40   Γöé   EXEC CICS READ           Γöé
  2469.  Γöé  41   Γöé   EXEC CICS WRITE           Γöé
  2470.  Γöé  42   Γöé   EXEC CICS REWRITE          Γöé
  2471.  Γöé  43   Γöé   EXEC CICS DELETE          Γöé
  2472.  Γöé  44   Γöé   EXEC CICS UNLOCK          Γöé
  2473.  Γöé  45   Γöé   EXEC CICS STARTBR          Γöé
  2474.  Γöé  46   Γöé   EXEC CICS READNEXT         Γöé
  2475.  Γöé  47   Γöé   EXEC CICS READPREV         Γöé
  2476.  Γöé  48   Γöé   EXEC CICS RESETBR          Γöé
  2477.  Γöé  49   Γöé   EXEC CICS ENDBR           Γöé
  2478.  Γöé  51   Γöé   EXEC CICS CONVERSE         Γöé
  2479.  Γöé  52   Γöé   EXEC CICS ISSUE           Γöé
  2480.  Γöé  53   Γöé   EXEC CICS SEND           Γöé
  2481.  Γöé  54   Γöé   EXEC CICS RECEIVE          Γöé
  2482.  Γöé  55   Γöé   Task control WRITE         Γöé
  2483.  Γöé  56   Γöé   Task control READ          Γöé
  2484.  Γöé  57   Γöé   Task control ERASE         Γöé
  2485.  Γöé  58   Γöé   Terminal WSU initialise       Γöé
  2486.  Γöé  60   Γöé   EXEC CICS SET EXEC CICS TASK    Γöé
  2487.  Γöé  61   Γöé   EXEC CICS INQUIRE TASK       Γöé
  2488.  Γöé  62   Γöé   EXEC CICS CHANGE TASK        Γöé
  2489.  Γöé  63   Γöé   EXEC CICS SET PROGRAM        Γöé
  2490.  Γöé  64   Γöé   EXEC CICS INQUIRE PROGRAM      Γöé
  2491.  Γöé  70   Γöé   EXEC CICS GETMAIN          Γöé
  2492.  Γöé  71   Γöé   EXEC CICS SET TRACEDEST       Γöé
  2493.  Γöé  72   Γöé   EXEC CICS ENTER           Γöé
  2494.  Γöé  73   Γöé   EXEC CICS INQUIRE TRACEDEST     Γöé
  2495.  Γöé  74   Γöé   EXEC CICS FREEMAIN         Γöé
  2496.  Γöé  76   Γöé   ENQ internal            Γöé
  2497.  Γöé  77   Γöé   DEQ internal            Γöé
  2498.  Γöé  79   Γöé   EXEC CICS DUMP           Γöé
  2499.  Γöé  80   Γöé   EXEC CICS SET TERMINAL       Γöé
  2500.  Γöé  81   Γöé   EXEC CICS INQUIRE TERMINAL     Γöé
  2501.  Γöé  82   Γöé   EXEC CICS WRITE OPERATOR      Γöé
  2502.  Γöé  83   Γöé   EXEC CICS INQUIRE SYSTEM      Γöé
  2503.  Γöé  90   Γöé   EXEC CICS ASKTIME          Γöé
  2504.  Γöé  91   Γöé   Pop all               Γöé
  2505.  Γöé  92   Γöé   Start transaction          Γöé
  2506.  Γöé  93   Γöé   End transaction           Γöé
  2507.  Γöé  94   Γöé   EXEC CICS ABEND           Γöé
  2508.  Γöé  96   Γöé   Get message             Γöé
  2509.  Γöé  97   Γöé   Initial COBOL program call     Γöé
  2510.  Γöé  98   Γöé   EXEC CICS SYNCPOINT         Γöé
  2511.  Γöé  99   Γöé   Initialise             Γöé
  2512.  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2513.  
  2514.  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2515.  Γöé Function Γöé   Meaning               Γöé
  2516.  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2517.  Γöé  100   Γöé   EXEC CICS LINK           Γöé
  2518.  Γöé  101   Γöé   EXEC CICS XCTL           Γöé
  2519.  Γöé  102   Γöé   EXEC CICS ASSIGN          Γöé
  2520.  Γöé  103   Γöé   EXEC CICS HANDLE          Γöé
  2521.  Γöé  105   Γöé   EXEC CICS ADDRESS          Γöé
  2522.  Γöé  110   Γöé   EXEC CICS RETURN          Γöé
  2523.  Γöé  111   Γöé   EXEC CICS PUSH           Γöé
  2524.  Γöé  112   Γöé   EXEC CICS POP            Γöé
  2525.  Γöé  113   Γöé   Pop P table             Γöé
  2526.  Γöé  114   Γöé   Link/Xctl              Γöé
  2527.  Γöé  115   Γöé   Delete program           Γöé
  2528.  Γöé  116   Γöé   EXEC CICS LOAD           Γöé
  2529.  Γöé  120   Γöé   EXEC CICS TS/TD WRITEQ       Γöé
  2530.  Γöé  121   Γöé   EXEC CICS TS/TD READQ        Γöé
  2531.  Γöé  122   Γöé   EXEC CICS TS/TD DELETEQ       Γöé
  2532.  Γöé  123   Γöé   EXEC CICS START           Γöé
  2533.  Γöé  124   Γöé   EXEC CICS RETRIEVE         Γöé
  2534.  Γöé  125   Γöé   EXEC CICS CANCEL          Γöé
  2535.  Γöé  130   Γöé   EXEC CICS SET TDQUEUE        Γöé
  2536.  Γöé  131   Γöé   EXEC CICS INQUIRE TDQUEUE      Γöé
  2537.  Γöé  160   Γöé   EXEC CICS SIGNON          Γöé
  2538.  Γöé  161   Γöé   EXEC CICS SIGNOFF          Γöé
  2539.  Γöé  170   Γöé   Clear post             Γöé
  2540.  Γöé  171   Γöé   EXEC CICS POST           Γöé
  2541.  Γöé  172   Γöé   EXEC CICS WAIT           Γöé
  2542.  Γöé  173   Γöé   EXEC CICS DELAY           Γöé
  2543.  Γöé  174   Γöé   EXEC CICS FORMATTIME        Γöé
  2544.  Γöé  180   Γöé   EXEC CICS ENQ            Γöé
  2545.  Γöé  181   Γöé   EXEC CICS DEQ            Γöé
  2546.  Γöé  182   Γöé   EXEC CICS SUSPEND          Γöé
  2547.  Γöé  197   Γöé   Initialise C program call      Γöé
  2548.  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2549.  Γöé  200   Γöé   EDF closing             Γöé
  2550.  Γöé  297   Γöé   Initialise EBCDIC program call   Γöé
  2551.  Γöé  397   Γöé   Initialise PLI program call     Γöé
  2552.  Γöé  201   Γöé   EXEC CICS ALLOCATE         Γöé
  2553.  Γöé  202   Γöé   EXEC CICS EXTRACT          Γöé
  2554.  Γöé  203   Γöé   EXEC CICS CONNECT          Γöé
  2555.  Γöé  204   Γöé   EXEC CICS FREE           Γöé
  2556.  Γöé  206   Γöé   EXEC CICS PERFORM SHUTDOWN     Γöé
  2557.  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2558.  
  2559.  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2560.  Γöé Function Γöé   Meaning               Γöé
  2561.  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2562.  Γöé  512   Γöé   File Manager OPEN          Γöé
  2563.  Γöé  513   Γöé   File Manager CLOSE         Γöé
  2564.  Γöé  514   Γöé   File Manager INSERT         Γöé
  2565.  Γöé  515   Γöé   File Manager UPDATE         Γöé
  2566.  Γöé  516   Γöé   File Manager DELETE         Γöé
  2567.  Γöé  517   Γöé   File Manager GET EQUAL       Γöé
  2568.  Γöé  518   Γöé   File Manager GET NEXT        Γöé
  2569.  Γöé  519   Γöé   File Manager GET PREV        Γöé
  2570.  Γöé  520   Γöé   File Manager GET GT         Γöé
  2571.  Γöé  521   Γöé   File Manager GET GTEQ        Γöé
  2572.  Γöé  522   Γöé   File Manager GET GL         Γöé
  2573.  Γöé  523   Γöé   File Manager GET GLEQ        Γöé
  2574.  Γöé  524   Γöé   File Manager GET FIRST       Γöé
  2575.  Γöé  525   Γöé   File Manager GET LAST        Γöé
  2576.  Γöé  526   Γöé   File Manager CREATE         Γöé
  2577.  Γöé  531   Γöé   File Manager BEGIN TRANSACTION   Γöé
  2578.  Γöé  532   Γöé   File Manager END TRANSACTION    Γöé
  2579.  Γöé  533   Γöé   File Manager ABORT TRANSACTION   Γöé
  2580.  Γöé  534   Γöé   File Manager GET POSITION      Γöé
  2581.  Γöé  535   Γöé   File Manager GET DIRECT       Γöé
  2582.  Γöé  536   Γöé   File Manager STEP NEXT       Γöé
  2583.  Γöé  539   Γöé   File Manager UNLOCK         Γöé
  2584.  Γöé  567   Γöé   File Manager GET EQUAL KEY     Γöé
  2585.  Γöé  568   Γöé   File Manager GET NEXT KEY      Γöé
  2586.  Γöé  569   Γöé   File Manager GET PREV KEY      Γöé
  2587.  Γöé  570   Γöé   File Manager GET GT KEY       Γöé
  2588.  Γöé  571   Γöé   File Manager GET GTEQ KEY      Γöé
  2589.  Γöé  572   Γöé   File Manager GET GL KEY       Γöé
  2590.  Γöé  573   Γöé   File Manager GET GLEQ KEY      Γöé
  2591.  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2592.  Γöé  617   Γöé   File Manager GET EQUAL LOCK     Γöé
  2593.  Γöé  618   Γöé   File Manager GET NEXT LOCK     Γöé
  2594.  Γöé  619   Γöé   File Manager GET PREV LOCK     Γöé
  2595.  Γöé  620   Γöé   File Manager GET GT LOCK      Γöé
  2596.  Γöé  621   Γöé   File Manager GET GTEQ LOCK     Γöé
  2597.  Γöé  622   Γöé   File Manager GET GL LOCK      Γöé
  2598.  Γöé  623   Γöé   File Manager GET GLEQ LOCK     Γöé
  2599.  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2600.  Γöé  817   Γöé   File Manager GET EQUAL MLOCK    Γöé
  2601.  Γöé  818   Γöé   File Manager GET NEXT MLOCK     Γöé
  2602.  Γöé  819   Γöé   File Manager GET PREV MLOCK     Γöé
  2603.  Γöé  820   Γöé   File Manager GET GT MLOCK      Γöé
  2604.  Γöé  821   Γöé   File Manager GET GTEQ MLOCK     Γöé
  2605.  Γöé  822   Γöé   File Manager GET GL MLOCK      Γöé
  2606.  Γöé  823   Γöé   File Manager GET GLEQ MLOCK     Γöé
  2607.  Γöé  825   Γöé   File Manager MBEGIN TRANSACTION   Γöé
  2608.  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2609.  
  2610.  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2611.  Γöé Function Γöé   Meaning               Γöé
  2612.  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2613.  Γöé 1024   Γöé   Task initialise terminal      Γöé
  2614.  Γöé 1281   Γöé   Global log message         Γöé
  2615.  Γöé 1282   Γöé   Global BTRIEVE request       Γöé
  2616.  Γöé 1284   Γöé   Global extra-partition TD request  Γöé
  2617.  Γöé 1285   Γöé   Global extra-partition ENQ request Γöé
  2618.  Γöé 1286   Γöé   Global task purge request      Γöé
  2619.  Γöé 1290   Γöé   Global task initialisation     Γöé
  2620.  Γöé 1291   Γöé   Global task termination       Γöé
  2621.  Γöé 1292   Γöé   Global terminal attach       Γöé
  2622.  Γöé 1293   Γöé   Global terminal detach       Γöé
  2623.  Γöé 1294   Γöé   Global log thread error       Γöé
  2624.  Γöé 1295   Γöé   Global ETI request         Γöé
  2625.  Γöé 1296   Γöé   Global ETI result          Γöé
  2626.  Γöé 1301   Γöé   Global getmain request       Γöé
  2627.  Γöé 1302   Γöé   Global freemain request       Γöé
  2628.  Γöé 1303   Γöé   Global program load         Γöé
  2629.  Γöé 1304   Γöé   Global start task          Γöé
  2630.  Γöé 1305   Γöé   Global PNA request         Γöé
  2631.  Γöé 1306   Γöé   Global givemain request       Γöé
  2632.  Γöé 1307   Γöé   Global querymain request      Γöé
  2633.  Γöé 1308   Γöé   Global performance request     Γöé
  2634.  Γöé 1309   Γöé   Open task global queue semaphore  Γöé
  2635.  Γöé 1310   Γöé   Internal request          Γöé
  2636.  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2637.  Γöé 4096   Γöé   TRAP                Γöé
  2638.  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2639.  
  2640.  
  2641. ΓòÉΓòÉΓòÉ 16. Performance Analyser statistics file ΓòÉΓòÉΓòÉ
  2642.  
  2643. This appendix provides details on the content of the Performance Analyser 
  2644. statistics file, PA2STATS.DAT. 
  2645.  
  2646. PA2STATS.DAT is an ASCII file that can be viewed with a standard PC 
  2647. editor/browser or printed on a line printer. It is used as an "append" file 
  2648. (that is, each time new data is collected it is added to the end of the file). 
  2649. The file will thus continue to grow until specific action is taken to delete 
  2650. it.  The file is closed after use so that it may be accessed by other processes 
  2651. in the system. 
  2652.  
  2653. An example of a PA2STATS.DAT file generated by Performance Analyser is shown in 
  2654. An example of a PA2STATS.DAT file whilst Explanation of PA2STATS.DAT file 
  2655. entries provides a full description of the file content. 
  2656.  
  2657.  
  2658. ΓòÉΓòÉΓòÉ 16.1. Sample PA2STATS.DAT file ΓòÉΓòÉΓòÉ
  2659.  
  2660.  
  2661. An example of a PA2STATS.DAT file
  2662.  
  2663.                Performance Analyser for
  2664.                   CICS for OS/2 Version 2
  2665.                        5764-091
  2666.  
  2667.                        Statistics
  2668.  
  2669.    Run started               Mon May 09 15:27:09 1994
  2670.    Statistics taken at       Mon May 09 15:29:27 1994
  2671.    Length of Run so far                  0:02:18 (hh:mm:ss)
  2672.  
  2673. Hardware
  2674.  
  2675.   IBM PS/2 Model 80
  2676.                  Engine     Rated  Bus types
  2677.                             speed
  2678.                             (Mhz)
  2679.                     386        20  PS/2 32-bit
  2680.  
  2681. Operating System Software
  2682.  
  2683.   OS/2 Version 2.0 Revision 0
  2684.  
  2685. Operating System parameters
  2686.  
  2687.                 Maxwait  MinSlice  MaxSlice
  2688.                  (secs)   (msecs)   (msecs)
  2689.  
  2690.                       3        32        32
  2691.  
  2692. System File Manager
  2693.  
  2694.   Version 6.15
  2695.  
  2696. CICS Run-time Environment variables
  2697.  
  2698.   BMSMAP=D:\CICS200\BIN
  2699.  
  2700.   BTRINTF=/H:D:\CICS200\BIN
  2701.  
  2702.   CICSRD=D:\CICS200\BIN\DATA\FAACTFTB.BTR
  2703.  
  2704.   CICSRGRP=FAASYS,PA2GROUP,PA2EXMPL
  2705.  
  2706.   CICSTEXT=D:\CICS200\BIN\DATA
  2707.  
  2708.   CICSTRACE=D:\CICS200\UTIL\FAATAFEN.TRC
  2709.  
  2710.   CICSWRK=D:\CICS200\BIN;
  2711.  
  2712. Reason for monitoring and statistics
  2713.                                  SAMPLE OUTPUT
  2714. CICS values
  2715.  
  2716.                  APPLID     Local   Default      File
  2717.                             SYSID     SYSID   Manager
  2718.  
  2719.                ANDYKOS2      ANDY
  2720.  
  2721.                     Max       Min    System   Process
  2722.                    Task      Free  Priority  Priority
  2723.  
  2724.                       6         2         0        86
  2725.  
  2726. Task Class Limits
  2727.  
  2728.              Class Class Class Class Class Class Class Class Class Class
  2729.                (1)   (2)   (3)   (4)   (5)   (6)   (7)   (8)   (9)  (10)
  2730.                  1     1     1     1     1     1     1     1     1     1
  2731.  
  2732. Transactions run
  2733.  
  2734.   Transaction     Times   Percent   Average  Shortest   Longest  Standard
  2735.          name       Run     total    (secs)    (secs)    (secs) Deviation
  2736.  
  2737.          CECI         1     14.29     11.59     11.59     11.59      0.00
  2738.          CLOG         3     42.86      4.10      2.34      6.66      1.07
  2739.          CRSR         1     14.29      2.28      2.28      2.28      0.00
  2740.          PA21         1     14.29     36.03     36.03     36.03      0.00
  2741.          PA2M         1     14.29      0.00      0.00      0.00      0.00
  2742.  
  2743.   Totals              7
  2744.  
  2745.   Transaction     Times     Times Syncpoint Syncpoint Syncpoint
  2746.          name       Run   abended              (secs) File Mngr
  2747.                                                      operations
  2748.  
  2749.          CECI         1         2         1      0.00         0
  2750.          CLOG         3         0         3      0.34         0
  2751.          CRSR         1         0         1      0.50         0
  2752.          PA21         1         0         1      0.03         0
  2753.          PA2M         1         0         0      0.00         0
  2754.  
  2755.   Totals              7         2         6                   0
  2756.  
  2757.   Transaction attributes
  2758.  
  2759.   Transaction  Priority   Program      Task     Group     Sysid
  2760.          name                         Class
  2761.  
  2762.          CECI         0  FAAATPCI         0  FAASYS
  2763.          CLOG         0  FAALSPDL         0  FAASYS
  2764.          CRSR         0  FAAOIPTD         0  FAASYS
  2765.          PA21         0  PA2PLTPI         3  PA2GROUP
  2766.          PA2M         0  PA2MCDSP         0  PA2GROUP
  2767.   Communications
  2768.  
  2769.         Xactn     Times     Times      Send     Times   Receive ..
  2770.          name       Run      Send    (secs)   Receive    (secs) ..
  2771.  
  2772.          CECI         1         7      3.91         7      2.59 ..
  2773.          CLOG         3         3      3.91         2      0.03 ..
  2774.          PA2M         1         0      0.00         1      0.00 ..
  2775.  
  2776.  
  2777.                   ..        Times  Converse     Times     Issue
  2778.                   ..     Converse    (secs)     Issue    (secs)
  2779.  
  2780.                   ..            0      0.00         0      0.00
  2781.                   ..            0      0.00         0      0.00
  2782.                   ..            0      0.00         0      0.00
  2783.  
  2784. User Buckets
  2785.  
  2786. Bucket  Xactn     Times     Times     Total   Average
  2787. number   name   started   stopped     (secs)   (secs)
  2788.  
  2789. Clock(1) CECI         2         0      8.31     4.157
  2790. Clock(2) CECI         2         2      0.47     0.235
  2791. Clock(3) CECI         4         0      8.34     2.086
  2792.  
  2793. File Control
  2794.  
  2795. File    Xactn      Read     Write   Rewrite    Delete    Unlock
  2796. name     name
  2797.  
  2798. FAACTFTB CRSR         0         0         0         0         0
  2799. FAACTFTB INIT         1         0         0         0         0
  2800. FAACTFTB PA21         0         0         0         0         0
  2801. FAAMGFMG CLOG         1         0         0         0         0
  2802. FAAMGFMG INIT         1         0         0         0         0
  2803.  
  2804.   Totals              3         0         0         0         0
  2805.  
  2806. Equivalent File Manager operations
  2807.  
  2808. File    Xactn      Read     Write   Rewrite    Delete    Unlock
  2809. name     name
  2810.  
  2811. FAACTFTB CRSR         0         0         0         0         0
  2812. FAACTFTB INIT         1         0         0         0         0
  2813. FAACTFTB PA21         0         0         0         0         0
  2814. FAAMGFMG CLOG         1         0         0         0         0
  2815. FAAMGFMG INIT         1         0         0         0         0
  2816.  
  2817.   Totals              3         0         0         0         0
  2818.  
  2819. File    Xactn     Start      Read      Read     Reset       End
  2820. name     name    Browse      Next  Previous    Browse    Browse
  2821.  
  2822. FAACTFTB CRSR         1         0         0         0         1
  2823. FAACTFTB INIT         0         0         0         0         0
  2824. FAACTFTB PA21         1        73         0         3         1
  2825. FAAMGFMG CLOG         0         0         0         0         0
  2826. FAAMGFMG INIT         0         0         0         0         0
  2827.  
  2828.   Totals              2        73         0         3         2
  2829.  
  2830.  
  2831. Equivalent File Manager operations
  2832.  
  2833. File    Xactn     Start      Read      Read     Reset       End
  2834. name     name    Browse      Next  Previous    Browse    Browse
  2835.  
  2836. FAACTFTB CRSR         2         0         0         0         0
  2837. FAACTFTB INIT         0         0         0         0         0
  2838. FAACTFTB PA21         2        73         0         6         0
  2839. FAAMGFMG CLOG         0         0         0         0         0
  2840. FAAMGFMG INIT         0         0         0         0         0
  2841.  
  2842.   Totals              4        73         0         6         0
  2843.  
  2844.  
  2845. Transient data
  2846.  
  2847. Queue   Xactn     Readq    Writeq   Deleteq
  2848. name     name
  2849.  
  2850. CSCS     CLOG         0         1         0
  2851.  
  2852.   Totals              0         1         0
  2853.  
  2854. Equivalent File Manager operations
  2855.  
  2856. Queue   Xactn     Readq    Writeq   Deleteq
  2857. name     name
  2858.  
  2859. CSCS     CLOG         0         2         0
  2860.  
  2861.   Totals              0         2         0
  2862.  
  2863.  
  2864. Interval control
  2865.  
  2866. Started Xactn     Start  Retrieve    Cancel
  2867. Xactn    name
  2868. name
  2869.  
  2870. CLOG     INIT         1         0         0
  2871. PA21     INIT         1         0         0
  2872.  
  2873.   Totals              2         0         0
  2874.  
  2875. Program control
  2876.  
  2877. Program Xactn     Times      Load      Link      Load      Xctl
  2878. name     name    loaded      time
  2879.  
  2880. FAAATPCI CECI         1       0.3         2         0         0
  2881. FAALSPDL CLOG         3       0.4         0         0         2
  2882. FAALSPSN CLOG         2       0.0         1         0         0
  2883. FAAMGSON CLOG         1       0.9         0         0         0
  2884. FAAMGSON INIT         1       0.5         0         0         0
  2885. FAAOIPTD CRSR         1       0.4         0         0         0
  2886. FAAOIS04 INIT         3       0.2         0         0         0
  2887. FAAOISII INIT         3       1.7         1         0         0
  2888. FAAPLTPI INIT         1       0.3         0         0         1
  2889. PA2ABEND CECI         2       0.7         0         0         0
  2890. PA2MCDSP PA2M         1       0.3         0         0         0
  2891. PA2PLTPI PA21         1       1.2         0         0         0
  2892. PA2PLTSD PA2M         1       0.3         0         0         0
  2893.  
  2894.   Totals             21                   4         0         3
  2895.  
  2896.  
  2897. Abend control
  2898.  
  2899. Program Xactn     Abend    Number
  2900. name     name      code
  2901.  
  2902. PA2ABEND CECI      PA2X         2
  2903.  
  2904.   Totals                        2
  2905.  
  2906.  
  2907.  
  2908. Process control
  2909.  
  2910. Process number    Trans  Priority  Priority   Percent   Percent      Type
  2911.                     Run     Class     Level      busy     split
  2912.  
  2913.       62              0         3         1      0.00     26.71    Global
  2914.       65              5         2         0     17.32     41.77
  2915.       66              1         2         0      1.65      2.45
  2916.       67              1         4        31     26.11     29.71
  2917.  
  2918.   Totals              7
  2919.  
  2920.  
  2921.  
  2922. Global Process statistics
  2923.  
  2924. Process number File Mngr Extra TD       ETI  Terminal  TerminalNetBiosPNA
  2925.                requests  requests  requests  attaches  detaches  requests
  2926.  
  2927.       62             16         0         0         0         0         3
  2928.  
  2929.  
  2930. System File Manager
  2931.  
  2932. File name          File  Pagesize     Start     Start       End       End
  2933.                   flags              Number    Unused    Number    Unused
  2934.                                     Records Pre-Alloc   Records Pre-Alloc
  2935.                                                 Pages               Pages
  2936. FAAAEFBU       1.......       512        88         0        88         0
  2937. FAAAEFIE       1.......       512        20         0        20         0
  2938. FAACTFTB       1.......       512        84         0        84         0
  2939. FAAHLFT1       1.......       512        88         0        88         0
  2940. FAAHLFT2       1.......       512      1481         0      1481         0
  2941. FAAHLFT3       1.......       512       105         0       105         0
  2942. FAAMGFMG       11......       512      1415         0      1415         0
  2943. FAAMSFSC       1.......       512         5         0         5         0
  2944. FAAMSFSY       1.......       512        76         0        76         0
  2945. FAATSFP1       1.......       512         0         0         0         0
  2946. FAATSFU1       1.......       512         4         0         6         0
  2947.  
  2948.  
  2949. File name        Location
  2950.  
  2951. FAAAEFBU         .\DATA\FAAAEFBU.BTR
  2952. FAAAEFIE         .\DATA\FAAAEFIE.BTR
  2953. FAACTFTB         .\DATA\FAACTFTB.BTR
  2954. FAAHLFT1         .\DATA\FAAHLFT1.BTR
  2955. FAAHLFT2         .\DATA\FAAHLFT2.BTR
  2956. FAAHLFT3         .\DATA\FAAHLFT3.BTR
  2957. FAAMGFMG         .\DATA\FAAMGFMG.BTR
  2958. FAAMSFSC         .\DATA\FAAMSFSC.BTR
  2959. FAAMSFSY         .\DATA\FAAMSFSY.BTR
  2960. FAATSFP1         .\DATA\FAATSFP1.BTR
  2961. FAATSFU1         F:\FAATSFU1.BTR
  2962.  
  2963. Performance control
  2964.  
  2965. Bucket size      Bucket   Percent
  2966.                    used      used
  2967.    65535          13876     21.17
  2968.  
  2969. Bucket error messages
  2970.  
  2971. PA2CLOCK Clock number 4 not started before a stop, ignored, in transaction CECI
  2972. PA2CLOCK Non valid action X passed to clock number 2, ignored, in transaction CECI
  2973. PA2CLOCK Clock number 7 out of range 1-4 in transaction CECI
  2974. PA2CLOCK Clock number 3 not stopped before a start, not reset, in transaction CECI
  2975. PA2CLOCK Clock number 1 not stopped before a start, not reset, in transaction CECI
  2976. PA2CLOCK Clock number 3 not stopped before a start, not reset, in transaction CECI
  2977. PA2CLOCK Clock number 4 not started before a stop, ignored, in transaction CECI
  2978. PA2CLOCK Non valid action X passed to clock number 2, ignored, in transaction CECI
  2979. PA2CLOCK Clock number 7 out of range 1-4 in transaction CECI
  2980. PA2CLOCK Clock number 3 not stopped before a start, not reset, in transaction CECI
  2981. FAADKSIN Clock number 1 not stopped before end of transaction CECI, added
  2982. FAADKSIN Clock number 3 not stopped before end of transaction CECI, added
  2983.  
  2984. (C) Copyright IBM Corp. 1994. All rights reserved.
  2985.  
  2986.  
  2987. ΓòÉΓòÉΓòÉ 16.2. Explanation of PA2STATS.DAT file entries ΓòÉΓòÉΓòÉ
  2988.  
  2989.  
  2990. ΓòÉΓòÉΓòÉ 16.2.1. Times ΓòÉΓòÉΓòÉ
  2991.  
  2992. Run started                   Date and time when this CICS for OS/2 run started 
  2993.  
  2994. Statistics taken at           Date and time when requested 
  2995.  
  2996. Length of Run so far          Difference of the above 
  2997.  
  2998.  
  2999. ΓòÉΓòÉΓòÉ 16.2.2. Hardware ΓòÉΓòÉΓòÉ
  3000.  
  3001. Type                          Description (eg IBM PS/2 Model 80) 
  3002.  
  3003. Engine                        INTEL or equivalent (eg 386) 
  3004.  
  3005. Rated speed (Mhz)             Processor speed (eg 20Mhz) 
  3006.  
  3007. Bus types                     Processor bus type (eg PS/2 32-bit) 
  3008.  
  3009.  
  3010. ΓòÉΓòÉΓòÉ 16.2.3. Operating System Software Level ΓòÉΓòÉΓòÉ
  3011.  
  3012. Operating System Software Level Description (eg OS/2 Version 2.0 Revision 0) 
  3013.  
  3014.  
  3015. ΓòÉΓòÉΓòÉ 16.2.4. Operating System parameters ΓòÉΓòÉΓòÉ
  3016.  
  3017. Maxwait(secs)                 CONFIG.SYS value which sets the amount of time a 
  3018.                               process waits before the system assigns it a 
  3019.                               higher priority.  When a regular class thread is 
  3020.                               denied the processor for this number of seconds 
  3021.                               it receives a temporary increase in priority for 
  3022.                               a minimum time slice. (Default is 3 seconds) 
  3023.  
  3024. MinSlice(msecs)               First parameter of the TIMESLICE CONFIG.SYS value 
  3025.                               and is the minimum amount of time a thread can be 
  3026.                               processed before yielding the processor to a 
  3027.                               thread of the same priority level. (Default is 32 
  3028.                               milliseconds) 
  3029.  
  3030. MaxSlice(msecs)               Second parameter of the TIMESLICE CONFIG.SYS 
  3031.                               value and is the maximum amount of time a thread 
  3032.                               can be processed before yielding the processor to 
  3033.                               a thread of the same priority level. (Default is 
  3034.                               32 milliseconds) 
  3035.  
  3036.  
  3037. ΓòÉΓòÉΓòÉ 16.2.5. System File Manager Level ΓòÉΓòÉΓòÉ
  3038.  
  3039. System File Manager Level     Description (eg Version 6.15) 
  3040.  
  3041.  
  3042. ΓòÉΓòÉΓòÉ 16.2.6. CICS Run-time Environment variables ΓòÉΓòÉΓòÉ
  3043.  
  3044. Performance Analyser reports on the seven CICS for OS/2 specific environment 
  3045. variables BMSMAP, BTRINTF, CICSRD, CICSRGRP, CICSTEXT, CICSTRACE and CICSWRK. 
  3046. If they are not specified, (null) will be output to be compatible with OS/2. 
  3047.  
  3048. BMSMAP=             Points to the directory where user generated BMS maps are 
  3049.                     held in in the file FAAMSFSC.BTR.  The default value built 
  3050.                     in by CICSENV is cicsdrv:\CICS200\BIN\DATA. 
  3051.  
  3052. BTRINTF=            Points to System File Manager home directory 
  3053.  
  3054. CICSRD=             Points to a specific CICS resource definition file, the 
  3055.                     default value built by CICSENV is 
  3056.                     cicsdrv:\CICS200\BIN\DATA\FAACTFTB.BTR. 
  3057.  
  3058. CICSRGRP=           Is the list of resource groups to be loaded for this run of 
  3059.                     CICS for OS/2. The CICS for OS/2 system, as shipped, is 
  3060.                     contained in the group FAASYS.  For example, if 
  3061.                     CICSRGRP=FAASYS,MYGROUPB,MYGROUPA all the resource entries 
  3062.                     in group FAASYS will be loaded, then all the resources from 
  3063.                     group MYGROUPA, and finally all the resources from 
  3064.                     MYGROUPB.  This means that if the same name appears for the 
  3065.                     same resource type in multiple groups, the highest entry 
  3066.                     found in the ASCII collating sequence will be used.  If 
  3067.                     CICSRGRP is not specified, all resources defined to the 
  3068.                     system will be installed by group in ascending ASCII 
  3069.                     collating sequence. 
  3070.  
  3071. CICSTEXT=           Names the directory that CICS for OS/2 will search for help 
  3072.                     text. The default value built by CICSENV is 
  3073.                     cicsdrv:\CICS200\BIN\DATA. 
  3074.  
  3075. CICSTRACE=          Names a specific file for the binary trace output when it 
  3076.                     is invoked either via the CETR transaction or the /t 
  3077.                     start-up option.  The default value built by CICSENV is 
  3078.                     cicsdrv:\CICS200\UTIL\FAATAFEN.TRC. 
  3079.  
  3080. CICSWRK=            Names a set of directories where CICS for OS/2 will search 
  3081.                     for .DLLs and .EXEs before trying the CONFIG.SYS values for 
  3082.                     LIBPATH and PATH respectively.  The default value built by 
  3083.                     CICSENV is cicsdrv:\CICS200\BIN. 
  3084.  
  3085.  
  3086. ΓòÉΓòÉΓòÉ 16.2.7. Reason for monitoring and statistics ΓòÉΓòÉΓòÉ
  3087.  
  3088. Reason for monitoring         A string used as a means of labelling output for 
  3089.                               future reference. The value may be set either by 
  3090.                               the PA2M invocation or passed in a COMMAREA of a 
  3091.                               LINK statement to PA2PLTSD (for example, "See if 
  3092.                               System File Manager values have changed"). 
  3093.  
  3094.  
  3095. ΓòÉΓòÉΓòÉ 16.2.8. CICS values ΓòÉΓòÉΓòÉ
  3096.  
  3097. APPLID                        Eight character logical unit name, also used as 
  3098.                               the server name for CICS for OS/2 clients to 
  3099.                               connect to, where it is specified in FAARQ.SYS 
  3100.  
  3101. Local SYSID                   Four character system identifier CICS uses to 
  3102.                               distinguish remote resources from local ones 
  3103.  
  3104. Default SYSID                 Four character system identifier used as the 
  3105.                               remote target for unknown transaction identifiers 
  3106.  
  3107. File Manager                  Eight character name of the .DLL to be used for 
  3108.                               an alternative file manager instead of System 
  3109.                               File Manager. 
  3110.  
  3111. Max Task                      Maximum number of allowable tasks, see Major CICS 
  3112.                               for OS/2 Version 2 Parameters. 
  3113.  
  3114. Min Free                      Minimum number of free tasks, see Major CICS for 
  3115.                               OS/2 Version 2 Parameters. 
  3116.  
  3117. System Priority               CICS base priority, see CICS for OS/2 and 
  3118.                               Priority. 
  3119.  
  3120. Process Priority              CICS non-facility process priority, see CICS for 
  3121.                               OS/2 and Priority. 
  3122.  
  3123. Note. All of these values are set in the Systems Initialisation Table (SIT). 
  3124.  
  3125.  
  3126. ΓòÉΓòÉΓòÉ 16.2.9. Task Class limits ΓòÉΓòÉΓòÉ
  3127.  
  3128. Class(1,2,3,...,10)           Limit of the number of transactions defined in 
  3129.                               that class that can run concurrently 
  3130.  
  3131. Note. All of these values are set in the Systems Initialisation Table (SIT). 
  3132.  
  3133.  
  3134. ΓòÉΓòÉΓòÉ 16.2.10. Transactions run ΓòÉΓòÉΓòÉ
  3135.  
  3136. First table 
  3137.  
  3138. Transaction name              Four character transaction name 
  3139.  
  3140. Times Run                     Number of times the transaction was executed 
  3141.  
  3142. Percent of total              Number of times executed/Total number of 
  3143.                               transactions run expressed as a percentage 
  3144.  
  3145. Average(secs)                 Total time in system in seconds/Number of times 
  3146.                               executed 
  3147.  
  3148. Shortest(secs)                Shortest time in system in seconds 
  3149.  
  3150. Longest(secs)                 Longest time in system in seconds 
  3151.  
  3152. Standard Deviation            Standard deviation of the time in system 
  3153.  
  3154. Note. Almost all of this information in this table is available via the on-line 
  3155. transaction PA2K. 
  3156.  
  3157. Second table 
  3158.  
  3159. Transaction name              Four character transaction name 
  3160.  
  3161. Times Run                     Number of times executed 
  3162.  
  3163. Times Abended                 Number of times transaction abended (see Abend 
  3164.                               statistics below) 
  3165.  
  3166. Syncpoint                     Number of times SYNCPOINT command executed either 
  3167.                               explicitly or implicitly 
  3168.  
  3169. Syncpoint(secs)               Total time taken in SYNCPOINT for this 
  3170.                               transaction 
  3171.  
  3172. Syncpoint File Manager operations Number of calls to the File Manager within 
  3173.                               SYNCPOINT 
  3174.  
  3175.  
  3176. ΓòÉΓòÉΓòÉ 16.2.11. Transaction attributes ΓòÉΓòÉΓòÉ
  3177.  
  3178. First table 
  3179.  
  3180. Transaction name              Four character transaction name 
  3181.  
  3182. Priority                      CICS transaction priority 
  3183.  
  3184. Program                       Name of program that the PCT entry for this 
  3185.                               transaction points to 
  3186.  
  3187. Task Class                    Class defined for this transaction. 0 means none 
  3188.                               defined 
  3189.  
  3190. Group                         Groupname that was used to bring this transaction 
  3191.                               resource into the system 
  3192.  
  3193. Sysid                         System identifier if defined. If it is different 
  3194.                               from that defined in the SYSID in the SIT the 
  3195.                               transaction will be considered to be remote 
  3196.  
  3197. Note. All of these values are set in the Program Control Table (PCT) for the 
  3198. transaction. 
  3199.  
  3200.  
  3201. ΓòÉΓòÉΓòÉ 16.2.12. User Buckets ΓòÉΓòÉΓòÉ
  3202.  
  3203. This table will only be output if data exists to be reported. 
  3204.  
  3205. Transaction name              Transaction name 
  3206.  
  3207. Clock(number)                 Number of clock, ranges between 1 and 4 
  3208.  
  3209. Times started                 Number of times user clock started within 
  3210.                               transaction 
  3211.  
  3212. Times stopped                 Number of times user clock stopped within 
  3213.                               transaction 
  3214.  
  3215.                               The analyser will do its best if you do not stop 
  3216.                               a clock specifically. (See explanation of Bucket 
  3217.                               error messages in User Clocks) 
  3218.  
  3219. Total(secs)                   Total time in seconds attributed to clock 
  3220.  
  3221. Average(secs)                 Total time in seconds attributed to clock divided 
  3222.                               by the number of times the user clock was started 
  3223.                               within the transaction 
  3224.  
  3225. Note. The information in this table is available via the on-line transaction 
  3226. PA2E 
  3227.  
  3228.  
  3229. ΓòÉΓòÉΓòÉ 16.2.13. Communications ΓòÉΓòÉΓòÉ
  3230.  
  3231. First table 
  3232.  
  3233. Transaction name              Transaction name 
  3234.  
  3235. Times Send                    Number of EXEC CICS SEND statements executed 
  3236.  
  3237. Send(secs)                    Total time executing EXEC CICS SEND statements 
  3238.  
  3239. Times Receive                 Number of EXEC CICS RECEIVE statements executed 
  3240.  
  3241. Receive(secs)                 Total time executing EXEC CICS RECEIVE statements 
  3242.  
  3243. Times Converse                Number of EXEC CICS CONVERSE statements executed 
  3244.  
  3245. Converse(secs)                Total time executing EXEC CICS CONVERSE 
  3246.                               statements 
  3247.  
  3248. Times Issue                   Number of EXEC CICS ISSUE statements executed 
  3249.  
  3250. Issue(secs)                   Total time executing EXEC CICS ISSUE statements 
  3251.  
  3252. Second table.  This table will only be printed if APPC has been used within the 
  3253. transaction. 
  3254.  
  3255. Xactn name                    Transaction name 
  3256.  
  3257. Times Allocate                Number of EXEC CICS ALLOCATE statements executed 
  3258.  
  3259. Allocate(secs)                Total time executing EXEC CICS ALLOCATE 
  3260.                               statements 
  3261.  
  3262. Times Extract                 Number of EXEC CICS EXTRACT statements executed 
  3263.  
  3264. Extract(secs)                 Total time executing EXEC CICS EXTRACT statements 
  3265.  
  3266. Times Connect                 Number of EXEC CICS CONNECT statements executed 
  3267.  
  3268. Connect(secs)                 Total time executing EXEC CICS CONNECT statements 
  3269.  
  3270. Times Free                    Number of EXEC CICS FREE statements executed 
  3271.  
  3272. Free(secs)                    Total time executing EXEC CICS FREE statements 
  3273.  
  3274.  
  3275. ΓòÉΓòÉΓòÉ 16.2.14. File control ΓòÉΓòÉΓòÉ
  3276.  
  3277. File name                     File name used for operation 
  3278.  
  3279. Xactn name                    Transaction name that uses the file 
  3280.  
  3281. Read                          Number of EXEC CICS READ statements executed, by 
  3282.                               transaction 
  3283.  
  3284. Write                         Number of EXEC CICS WRITE statements executed, by 
  3285.                               transaction 
  3286.  
  3287. Rewrite                       Number of EXEC CICS REWRITE statements executed, 
  3288.                               by transaction 
  3289.  
  3290. Delete                        Number of EXEC CICS DELETE statements executed, 
  3291.                               by transaction 
  3292.  
  3293. Unlock                        Number of EXEC CICS UNLOCK statements executed, 
  3294.                               by transaction 
  3295.  
  3296. Note. The information in this table is available via the on-line transaction 
  3297. PA2F. 
  3298.  
  3299.  
  3300. ΓòÉΓòÉΓòÉ 16.2.15. Equivalent File Manager Operations ΓòÉΓòÉΓòÉ
  3301.  
  3302. Each operation from the table above normally results in one or more calls to 
  3303. the File Manager.  By dividing the equivalent operations from this table by the 
  3304. number of operations from the corresponding table above, a view can be taken 
  3305. how much work is being generated to the file manager by each of the EXEC CICS 
  3306. calls. 
  3307.  
  3308.  
  3309. ΓòÉΓòÉΓòÉ 16.2.16. File control ΓòÉΓòÉΓòÉ
  3310.  
  3311. This table will only be printed if the browse API has been used within the 
  3312. transaction. 
  3313.  
  3314. Start Browse                  Number of EXEC CICS STARTBR statements executed, 
  3315.                               by transaction 
  3316.  
  3317. Read Next                     Number of EXEC CICS READNEXT statements executed, 
  3318.                               by transaction 
  3319.  
  3320. Read Previous                 Number of EXEC CICS READPREV statements executed, 
  3321.                               by transaction 
  3322.  
  3323. Reset Browse                  Number of EXEC CICS RESETBR statements executed, 
  3324.                               by transaction 
  3325.  
  3326. End Browse                    Number of EXEC CICS ENDBR statements executed, by 
  3327.                               transaction 
  3328.  
  3329. The information in this table is available via the on-line transaction PA2G 
  3330.  
  3331.  
  3332. ΓòÉΓòÉΓòÉ 16.2.17. Equivalent File Manager Operations ΓòÉΓòÉΓòÉ
  3333.  
  3334. Each operation from the table above normally results in one or more calls to 
  3335. the File Manager.  By dividing the equivalent operations from this table by the 
  3336. number of operations from the corresponding table above, a view can be taken 
  3337. how much work is being generated to the file manager by each of the EXEC CICS 
  3338. calls. 
  3339.  
  3340.  
  3341. ΓòÉΓòÉΓòÉ 16.2.18. Temporary storage ΓòÉΓòÉΓòÉ
  3342.  
  3343. Queue name                    Eight character queue name 
  3344.  
  3345. Xactn name                    Transaction name that used the queue 
  3346.  
  3347. Readq                         Number of EXEC CICS READQ TS statements executed, 
  3348.                               by transaction 
  3349.  
  3350. Writeq                        Number of EXEC CICS WRITEQ TS statements 
  3351.                               executed, by transaction 
  3352.  
  3353. Deleteq                       Number of EXEC CICS DELETEQ TS statements 
  3354.                               executed, by transaction 
  3355.  
  3356. Note. The information in this table is available via the on-line transaction 
  3357. PA2Q (Q for queue). 
  3358.  
  3359.  
  3360. ΓòÉΓòÉΓòÉ 16.2.19. Equivalent File Manager Operations ΓòÉΓòÉΓòÉ
  3361.  
  3362. Each operation from the table above normally results in one or more calls to 
  3363. the File Manager.  By dividing the equivalent operations from this table by the 
  3364. number of operations from the corresponding table above, a view can be taken 
  3365. how much work is being generated to the file manager by each of the EXEC CICS 
  3366. calls. 
  3367.  
  3368.  
  3369. ΓòÉΓòÉΓòÉ 16.2.20. Transient data ΓòÉΓòÉΓòÉ
  3370.  
  3371. Queue name                    Four character queue name 
  3372.  
  3373. Xactn name                    Transaction name that uses the queue 
  3374.  
  3375. Readq                         Number of EXEC CICS READQ TD statements executed, 
  3376.                               by transaction 
  3377.  
  3378. Writeq                        Number of EXEC CICS WRITEQ TD statements 
  3379.                               executed, by transaction 
  3380.  
  3381. Deleteq                       Number of EXEC CICS DELETEQ TD statements 
  3382.                               executed, by transaction 
  3383.  
  3384. Note.The information in this table is available via the on-line transaction 
  3385. PA2D (D for Destination Control Table (DCT)). 
  3386.  
  3387.  
  3388. ΓòÉΓòÉΓòÉ 16.2.21. Equivalent File Manager Operations ΓòÉΓòÉΓòÉ
  3389.  
  3390. Each operation from the table above normally results in one or more calls to 
  3391. the File Manager.  By dividing the equivalent operations from this table by the 
  3392. number of operations from the corresponding table above, a view can be taken 
  3393. how much work is being generated to the file manager by each of the EXEC CICS 
  3394. calls. 
  3395.  
  3396.  
  3397. ΓòÉΓòÉΓòÉ 16.2.22. Interval control ΓòÉΓòÉΓòÉ
  3398.  
  3399. Transaction                   Transaction name that gets started, followed by 
  3400.                               transaction that started it 
  3401.  
  3402. Start                         Number of EXEC CICS START statements executed, by 
  3403.                               transaction 
  3404.  
  3405. Retrieve                      Number of EXEC CICS RETRIEVE statements executed, 
  3406.                               by transaction 
  3407.  
  3408. Cancel                        Number of EXEC CICS CANCEL statements executed, 
  3409.                               by transaction 
  3410.  
  3411. Note. The information in this table is available via the on-line transaction 
  3412. PA2I. 
  3413.  
  3414.  
  3415. ΓòÉΓòÉΓòÉ 16.2.23. Program control ΓòÉΓòÉΓòÉ
  3416.  
  3417. Program name                  Name of program that is doing a LINK,LOAD or XCTL 
  3418.  
  3419. Xactn name                    Transaction name that this program is running 
  3420.                               under 
  3421.  
  3422. Times loaded                  Number of times ProgramName.DLL was loaded 
  3423.  
  3424. Load time                     Total time in seconds to load ProgramName.DLL 
  3425.  
  3426. Link                          Number of EXEC CICS LINK statements executed by 
  3427.                               this program in this transaction 
  3428.  
  3429. Load                          Number of EXEC CICS LOAD statements executed, by 
  3430.                               this program in this transaction 
  3431.  
  3432. Xctl                          Number of EXEC CICS XCTL statements executed, by 
  3433.                               this program in this transaction 
  3434.  
  3435. Note. The information in this table is available via the on-line transaction 
  3436. PA2P. 
  3437.  
  3438.  
  3439. ΓòÉΓòÉΓòÉ 16.2.24. Abend control ΓòÉΓòÉΓòÉ
  3440.  
  3441. Program name                  Name of program that abended 
  3442.  
  3443. Xactn name                    Transaction name that abended 
  3444.  
  3445. Abend code                    ABEND code issued 
  3446.  
  3447. Number                        Number of times that program abended with that 
  3448.                               ABEND code 
  3449.  
  3450.  
  3451. ΓòÉΓòÉΓòÉ 16.2.25. Process usage ΓòÉΓòÉΓòÉ
  3452.  
  3453. Process number                OS/2 process number 
  3454.  
  3455. Trans Run                     Number of transactions run on this process. 
  3456.                               (Note that no transactions will be run on the 
  3457.                               Global Process). 
  3458.  
  3459. Priority class                OS/2 priority, of the form c.l where c (in 
  3460.                               ascending priority) is 1,2,4,3 which are the OS/2 
  3461.                               performance classes (Idle-time, Regular, 
  3462.                               Foreground Server and Time-critical) and l is the 
  3463.                               level within that class (ascending from 0 to 31) 
  3464.  
  3465. Priority level                OS/2 priority level, see above 
  3466.  
  3467. Percent busy                  Total time that transactions were active on this 
  3468.                               process divided by total length of the run 
  3469.  
  3470. Percent split                 Total time that this process was active divided 
  3471.                               by the total length of the run 
  3472.  
  3473. Type                          Differentiates the Global Process from other CICS 
  3474.                               application processes 
  3475.  
  3476. Note. The information in this table is available via the on-line transaction 
  3477. PA2X.  Extra information is also displayed by PA2X 
  3478.  
  3479. Depth                         Depth of program level nesting 
  3480.  
  3481. Active Xactn                  Active transaction name running on this process 
  3482.  
  3483. Task number                   CICS task number 
  3484.  
  3485. Active Program                Active program of the transaction running on this 
  3486.                               process 
  3487.  
  3488.  
  3489. ΓòÉΓòÉΓòÉ 16.2.26. Global Process statistics ΓòÉΓòÉΓòÉ
  3490.  
  3491. Process number                OS/2 process number 
  3492.  
  3493. System File Manager requests  Number of System File Manager requests processed 
  3494.                               by the Global Task for an unrecoverable resource 
  3495.  
  3496. Extra TD requests             Number of Extra-Partition Transient Data requests 
  3497.  
  3498. ETI requests                  Number of External Transaction Initiation 
  3499.                               requests 
  3500.  
  3501. Terminal attaches             Number of terminal attaches 
  3502.  
  3503. Terminal detaches             Number of terminal detaches 
  3504.  
  3505. NetBIOS PNA requests          Number of requests to initiate a NetBIOS or PNA 
  3506.                               request. 
  3507.  
  3508.  
  3509. ΓòÉΓòÉΓòÉ 16.2.27. System File Manager ΓòÉΓòÉΓòÉ
  3510.  
  3511. First table. 
  3512.  
  3513. File name                     CICS file name 
  3514.  
  3515. File flags                    Flags as defined by the System File Manager 
  3516.  
  3517.                                                               1.......  The file allows variable length records
  3518.                                                               .1......  System File Manager truncates trailing blanks in variable
  3519.                                                                         length records
  3520.                                                               ..1.....  System File Manager pre-allocated pages for the file
  3521.                                                               ...1....  System File Manager compresses the data in the file
  3522.                                                               ....1...  System File Manager created the file as a key-only file
  3523.                                                               ......1.  System File Manager maintains a 10% free space threshold
  3524.                                                               .......1  System File Manager maintains a 20% free space threshold
  3525.                                                               ......11  System File Manager maintains a 30% free space threshold
  3526.  
  3527. Pagesize                      Length of a page as defined in the File Control 
  3528.                               Table (FCT) 
  3529.  
  3530. Start Number Records          Number of records in file at start of the CICS 
  3531.                               run 
  3532.  
  3533. Start Unused Pre-Alloc Pages  Number of unused pages in a file which was 
  3534.                               pre-allocated, by invoking the BTRIEVE CREATE 
  3535.                               command, at start of the CICS run 
  3536.  
  3537. End Number Records            Number of records in file when the statistics 
  3538.                               were gathered 
  3539.  
  3540. End Unused Pre-Alloc Pages    Number of unused pages in a pre-allocated file 
  3541.                               when the statistics were gathered 
  3542.  
  3543. The information in this table is available via the on-line transaction PA2B. 
  3544.  
  3545. Second table 
  3546.  
  3547. File name                     CICS file name 
  3548.  
  3549. Location                      Path to data.  Either a fully qualified path 
  3550.                               name, for example, d:\mydata\persons.btr or an 
  3551.                               addition to the current directory. 
  3552.  
  3553.  
  3554. ΓòÉΓòÉΓòÉ 16.2.28. Performance control ΓòÉΓòÉΓòÉ
  3555.  
  3556. Bucket size                   Size of control block allocated for storing the 
  3557.                               monitoring and statistics data 
  3558.  
  3559. Bucket used                   Length of statistics and monitoring data acquired 
  3560.                               so far 
  3561.  
  3562. Percent used                  Length of statistics and monitoring data acquired 
  3563.                               so far divided by the Size of control block for 
  3564.                               storing the monitoring and statistics data 
  3565.  
  3566.  
  3567. ΓòÉΓòÉΓòÉ 16.2.29. Bucket and other error messages ΓòÉΓòÉΓòÉ
  3568.  
  3569. Bucket and other error messages Relate to the use of user probes and other 
  3570.                               error situations whilst running Performance 
  3571.                               Analyser 
  3572.  
  3573.  
  3574. ΓòÉΓòÉΓòÉ 17. Usage Examples ΓòÉΓòÉΓòÉ
  3575.  
  3576.  
  3577. ΓòÉΓòÉΓòÉ 17.1. Example 1 ΓòÉΓòÉΓòÉ
  3578.  
  3579. This example is based on a real problem generated during the writing of 
  3580. Performance Analyser. 
  3581.  
  3582.  
  3583. ΓòÉΓòÉΓòÉ 17.1.1. Scenario ΓòÉΓòÉΓòÉ
  3584.  
  3585. Statistics file for Example 1 - prior to modification shows part of the 
  3586. statistics generated when Performance Analyser was being tested.  The 
  3587. transaction codes starting with the letters PA2 all belong to Performance 
  3588. Analyser and it can be seen that the length of the PA21 transaction (8.66 
  3589. seconds) seems too long. A re-run gave a time of 8.38 seconds and some sort of 
  3590. problem was suspected. 
  3591.  
  3592. Look at the statistics and see if you can spot what was wrong with the way PA21 
  3593. was first written. 
  3594.  
  3595.  
  3596. ΓòÉΓòÉΓòÉ 17.1.2. Statistics ΓòÉΓòÉΓòÉ
  3597.  
  3598. (Note: the lines of dots signify deleted lines where the information is 
  3599. irrelevant to the problem). 
  3600.  
  3601.  
  3602. Statistics file for Example 1 - prior to modification
  3603.  
  3604. Transactions run
  3605.  
  3606.   Transaction     Times   Percent   Average  Shortest   Longest  Standard
  3607.          name       Run     total    (secs)    (secs)    (secs) Deviation
  3608.  
  3609.          CLOG         5     62.50      1.96      1.16      3.06      0.30
  3610.          CRSR         1     12.50      1.50      1.50      1.50      0.00
  3611.          PA21         1     12.50      8.66      8.66      8.66      0.00
  3612.          PA2M         1     12.50      0.00      0.00      0.00      0.00
  3613.  
  3614.   Totals              8
  3615.  
  3616.   Transaction     Times     Times Syncpoint Syncpoint Syncpoint
  3617.          name       Run   abended              (secs) File Mngr
  3618.                                                      operations
  3619.  
  3620.          CLOG         5         0         5      0.06         0
  3621.          CRSR         1         0         1      0.00         0
  3622.          PA21         1         0         1      0.03         0
  3623.          PA2M         1         0         0      0.00         0
  3624.  
  3625.   Totals              8         0         7                   0
  3626.  
  3627. Communications
  3628.  
  3629.         Xactn     Times     Times      Send     Times   Receive....
  3630.          name       Run      Send    (secs)   Receive    (secs)....
  3631.                                                                ....
  3632.          CLOG         5         5      3.13         4      0.09....
  3633.          PA2M         1         0      0.00         1      0.00....
  3634.  
  3635.                     ....   Times  Converse     Times     Issue
  3636.                     ....Converse    (secs)     Issue    (secs)
  3637.                     ....
  3638.                     ....       0      0.00         0      0.00
  3639.                     ....       0      0.00         0      0.00
  3640.  
  3641. File Control
  3642.  
  3643. File    Xactn      Read     Write   Rewrite    Delete    Unlock
  3644. name     name
  3645.  
  3646. FAACTFTB CRSR         0         0         0         0         0
  3647. FAACTFTB INIT         1         0         0         0         0
  3648. FAACTFTB PA21         0         0         0         0         0
  3649. FAAMGFMG CLOG         3         0         0         0         0
  3650. FAAMGFMG INIT         1         0         0         0         0
  3651.  
  3652.   Totals              5         0         0         0         0
  3653.  
  3654.  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  3655.  
  3656. File    Xactn     Start      Read      Read     Reset       End
  3657. name     name    Browse      Next  Previous    Browse    Browse
  3658.  
  3659. FAACTFTB CRSR         1         0         0         0         1
  3660. FAACTFTB INIT         0         0         0         0         0
  3661. FAACTFTB PA21        11        22         0         0        11
  3662. FAAMGFMG CLOG         0         0         0         0         0
  3663. FAAMGFMG INIT         0         0         0         0         0
  3664.  
  3665.   Totals             12        22         0         0        12
  3666.  
  3667.  
  3668. Equivalent File Manager operations
  3669.  
  3670. File    Xactn     Start      Read      Read     Reset       End
  3671. name     name    Browse      Next  Previous    Browse    Browse
  3672.  
  3673. FAACTFTB CRSR         2         0         0         0         0
  3674. FAACTFTB INIT         0         0         0         0         0
  3675. FAACTFTB PA21        22        22         0         0         0
  3676. FAAMGFMG CLOG         0         0         0         0         0
  3677. FAAMGFMG INIT         0         0         0         0         0
  3678.  
  3679.   Totals             24        22         0         0         0
  3680.  
  3681.  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  3682. Interval control
  3683.  
  3684. Started Xactn     Start  Retrieve    Cancel
  3685. Xactn    name
  3686. name
  3687.  
  3688. CLOG     INIT         1         0         0
  3689. PA21     INIT         1         0         0
  3690.  
  3691.   Totals              2         0         0
  3692.  
  3693. Program control
  3694.  
  3695. Program Xactn     Times      Load      Link      Load      Xctl
  3696. name     name    loaded      time
  3697.  
  3698. FAALSPDL CLOG         5      0.81         0         0         4
  3699. FAALSPSN CLOG         4      0.03         3         0         0
  3700. FAAMGSON CLOG         3      0.50         0         0         0
  3701. FAAMGSON INIT         1      0.28         0         0         0
  3702. FAAOIPTD CRSR         1      0.25         0         0         0
  3703. FAAOIS04 INIT         3      0.22         0         0         0
  3704. FAAOISII INIT         3      1.34         1         0         0
  3705. FAAPLTPI INIT         1      0.19         0         0         1
  3706. PA2MCDSP PA2M         1      0.31         0         0         0
  3707. PA2PLTPI PA21         1      0.31         0         0         0
  3708. PA2PLTSD PA2M         1      0.44         0         0         0
  3709.  
  3710.   Totals             24                   4         0         5
  3711.  
  3712.  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  3713.  
  3714.  
  3715. ΓòÉΓòÉΓòÉ 17.1.3. Deductions ΓòÉΓòÉΓòÉ
  3716.  
  3717. On scanning this data you should be able to see that: 
  3718.  
  3719.  1. From the Transaction Run section: 
  3720.  
  3721.    o PA21 ran once 
  3722.  
  3723.    o It did not abend, because there is no Abend data, so we did not spend time 
  3724.      taking a default dump. 
  3725.  
  3726.    o Syncpoint was one timer blip of 0.03 seconds so did not spend a large 
  3727.      amount of time committing large amounts of data to disk. 
  3728.  
  3729.  2. PA21 does not appear in the Communications section so PA21 it cannot be a 
  3730.     conversational transaction (even if it did, it still might not be). 
  3731.  
  3732.  3. From the Interval Control section: 
  3733.  
  3734.    o PA21 was STARTed once from INIT. 
  3735.  
  3736.    o There is no Temporary Storage (TS) activity (Retrieves = 0), so the START 
  3737.      did not have data and hence it is not a TS problem. 
  3738.  
  3739.  4. From the Program Control section, the load time was 0.31 seconds and this 
  3740.     is not dissimilar to most of the other programs listed. 
  3741.  
  3742.  5. The first File Control table shows no activity in PA21. 
  3743.  
  3744.  6. The second shows 11 Start Browse, 22 Read Next, and 11 End Browse! 
  3745.  
  3746. This last observation seemed a bit odd and on examining the code it was found 
  3747. that the browsing code was inside another loop! The code was slightly 
  3748. restructured and the statistics shown in Statistics file for Example 1 after 
  3749. modification to code were obtained from the same machine. 
  3750.  
  3751.   Transaction     Times   Percent   Average  Shortest   Longest  Standard
  3752.          name       Run     total    (secs)    (secs)    (secs) Deviation
  3753.  
  3754.          PA21         1     14.29      4.03      4.03      4.03      0.00
  3755.  
  3756.  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  3757.  
  3758. File    Xactn     Start      Read      Read     Reset       End
  3759. name     name    Browse      Next  Previous    Browse    Browse
  3760.  
  3761. FAACTFTB PA21         1        12         0         0         1
  3762.  
  3763. Equivalent File Manager operations
  3764.  
  3765. File    Xactn     Start      Read      Read     Reset       End
  3766. name     name    Browse      Next  Previous    Browse    Browse
  3767.  
  3768. FAACTFTB PA21         2        12         0         0         0
  3769.  
  3770. Statistics file for Example 1 after modification to code 
  3771.  
  3772. As can be seen, the number of calls to CICS was cut by two thirds with a 
  3773. similar reduction in the number of calls to System File Manager and the 
  3774. occupancy time was halved! 
  3775.  
  3776.  
  3777. ΓòÉΓòÉΓòÉ 17.2. Example 2 ΓòÉΓòÉΓòÉ
  3778.  
  3779. This example came from running a test on Performance Analyser to check for 
  3780. storage leakage when running ECI calls to a CICS for OS/2 Server. 
  3781.  
  3782.  
  3783. ΓòÉΓòÉΓòÉ 17.2.1. Scenario ΓòÉΓòÉΓòÉ
  3784.  
  3785. A client machine was used to invoke a CICS for OS/2 server to execute a program 
  3786. ECHO.  When the request was received by CICS for OS/2 the CICS mirror (FAAMIR) 
  3787. was invoked using transaction code CPMI. The LINK was executed and the program 
  3788. ECHO was LOADED and run. Use of the supplied transaction PA2P provided the 
  3789. screen shown in PA2P output for Example 2. 
  3790.  
  3791.  
  3792. ΓòÉΓòÉΓòÉ 17.2.2. Statistics ΓòÉΓòÉΓòÉ
  3793.  
  3794.  
  3795. PA2P output for Example 2
  3796.  
  3797.  
  3798. ΓòÉΓòÉΓòÉ 17.2.3. Deductions ΓòÉΓòÉΓòÉ
  3799.  
  3800. The mirror was invoked 1,939 times during the run. 
  3801.  
  3802. o ECHO was linked to 1,938 times (only 1,936 are shown since the application 
  3803.   was active and 2 invocations were in process at the time of the screen 
  3804.   capture) 
  3805.  
  3806. o FAATCPIN was linked to 1 time 
  3807.  
  3808. which adds up to 1,939. 
  3809.  
  3810. ECHO took an average load time of 2.38 seconds. 
  3811.  
  3812.  
  3813. ΓòÉΓòÉΓòÉ 17.3. Example 3 ΓòÉΓòÉΓòÉ
  3814.  
  3815. This example came from running an overnight test on Performance Analyser to 
  3816. check performance when running Distributed Program Links to a mainframe. 
  3817.  
  3818.  
  3819. ΓòÉΓòÉΓòÉ 17.3.1. Scenario ΓòÉΓòÉΓòÉ
  3820.  
  3821. A client machine was used to invoke a CICS for OS/2 server to execute a program 
  3822. ECHOHOST. When the request was received by the CICS for OS/2 server, CICS 
  3823. mirror (FAAMIR) was invoked using transaction code CPMI.  The LINK was executed 
  3824. but in this case ECHOHOST was marked remote, so the request was packaged up and 
  3825. forwarded to the remote host where it was executed. Use of the supplied 
  3826. transaction PA2K and PA2P provided the screens shown in PA2K output for Example 
  3827. 3 and PA2P output for Example 3. 
  3828.  
  3829.  
  3830. ΓòÉΓòÉΓòÉ 17.3.2. Statistics ΓòÉΓòÉΓòÉ
  3831.  
  3832.  
  3833. PA2K output for Example 3
  3834.  
  3835.  
  3836. PA2P output for Example 3
  3837.  
  3838.  
  3839. ΓòÉΓòÉΓòÉ 17.3.3. Deductions ΓòÉΓòÉΓòÉ
  3840.  
  3841. The mirror was invoked 37,741 times during the run. 
  3842.  
  3843. o ECHO was linked to 854 times 
  3844.  
  3845. o ECHOHOST was linked to 36,885 times 
  3846.  
  3847. ECHOHOST had an average response time of 1.64 seconds across the link.  From 
  3848. the Task Control (PA2K) output this was the majority of the total internal 
  3849. transaction time of 1.98 seconds. 
  3850.  
  3851.  
  3852. ΓòÉΓòÉΓòÉ 17.3.4. Trace output ΓòÉΓòÉΓòÉ
  3853.  
  3854. Example 3 Statistics file shows part of a trace taken on the CICS for OS/2 
  3855. server machine using the PA2O transaction.  It shows the sequence of events in 
  3856. the execution of ECHOHOST along with timings (in milliseconds). 
  3857.  
  3858.  
  3859. Example 3 Statistics file
  3860.  
  3861. 08:34:49.57    86  Entry EXEC CICS ASKTIME
  3862.                    Exit  EXEC CICS ASKTIME                      0
  3863. 08:34:49.60        Entry Task Initiation    CPMI
  3864.                    Entry Load Program
  3865.                                                   FAAMIR     CPMI
  3866.                    Exit  Load Program                    0
  3867.                    Entry Init prog COBOL call
  3868.                    Exit  Init COBOL prog call            0
  3869.                    Entry EXEC CICS HANDLE
  3870. 08:34:49.63        Exit  EXEC CICS HANDLE                      31
  3871.                    Entry EXEC CICS GETMAIN
  3872.                    Exit  EXEC CICS GETMAIN                      0
  3873.                    Entry Load Program
  3874.                                                   ECHOHOST   CPMI
  3875. 08:34:49.94        Exit  Load Program                  313
  3876.                    Entry EXEC CICS LINK
  3877.                    Exit  EXEC CICS LINK                         0
  3878.                    Entry EXEC CICS SYNCPOINT
  3879.                    Exit  EXEC CICS SYNCPOINT                    0
  3880. 08:34:49.97        Entry EXEC CICS HANDLE
  3881.                    Exit  EXEC CICS HANDLE                       0
  3882.                    Entry EXEC CICS FREEMAIN
  3883.                    Exit  EXEC CICS FREEMAIN                     0
  3884. 08:34:50.00        Entry EXEC CICS RETURN
  3885.                    Exit  EXEC CICS RETURN                       0
  3886.                    Entry POP ALL
  3887.                    Exit  POP ALL                         0
  3888.                    Entry clear POST
  3889. 08:34:50.04        Exit  Internal clear POST            32
  3890.                    Entry EXEC CICS SYNCPOINT
  3891.                    Exit  EXEC CICS SYNCPOINT                    0
  3892.                    Exit  Task Termination              438
  3893. 08:34:50.35        Entry EXEC CICS ASKTIME
  3894.                    Exit  EXEC CICS ASKTIME                      0
  3895.                    Entry Task Initiation    CPMI
  3896.                    Entry Load Program
  3897.                                                   FAAMIR     CPMI
  3898.                    Exit  Load Program                    0
  3899.                    Entry Init prog COBOL call
  3900. 08:34:50.38        Exit  Init COBOL prog call           31
  3901.                    Entry EXEC CICS HANDLE
  3902.                    Exit  EXEC CICS HANDLE                       0
  3903.                    Entry EXEC CICS GETMAIN
  3904.                    Exit  EXEC CICS GETMAIN                      0
  3905.                    Entry Load Program
  3906.                                                   ECHOHOST   CPMI
  3907. 08:34:50.50    88  Entry EXEC CICS ASKTIME
  3908.                    Exit  EXEC CICS ASKTIME                      0
  3909.                    Entry Task Initiation    CPMI
  3910.                    Entry Load Program
  3911.                                                   FAAMIR     CPMI
  3912.                    Exit  Load Program                    0
  3913.                    Entry Init prog COBOL call
  3914. 08:34:50.54        Exit  Init COBOL prog call           32
  3915. 08:34:50.57        Entry EXEC CICS HANDLE
  3916.                    Exit  EXEC CICS HANDLE                       0
  3917.                    Entry EXEC CICS GETMAIN
  3918.                    Exit  EXEC CICS GETMAIN                      0
  3919.                    Entry Load Program
  3920.                                                   ECHOHOST   CPMI
  3921. 08:34:50.72    86  Exit  Load Program                  313
  3922.                    Entry EXEC CICS LINK
  3923.                    Exit  EXEC CICS LINK                         0
  3924.                    Entry EXEC CICS SYNCPOINT
  3925.                    Exit  EXEC CICS SYNCPOINT                    0
  3926.                    Entry EXEC CICS HANDLE
  3927. 08:34:50.75        Exit  EXEC CICS HANDLE                      31
  3928.                    Entry EXEC CICS FREEMAIN
  3929.                    Exit  EXEC CICS FREEMAIN                     0
  3930. 08:34:50.79        Entry EXEC CICS RETURN
  3931.                    Exit  EXEC CICS RETURN                       0
  3932.                    Entry POP ALL
  3933.                    Exit  POP ALL                         0
  3934. 08:34:50.82        Entry clear POST
  3935.                    Exit  Internal clear POST             0
  3936.                    Entry EXEC CICS SYNCPOINT
  3937.                    Exit  EXEC CICS SYNCPOINT                    0
  3938.                    Exit  Task Termination              438
  3939. 08:34:51.44    88  Exit  Load Program                  844
  3940.                    Entry EXEC CICS LINK
  3941. 08:34:51.47        Exit  EXEC CICS LINK                        31
  3942.                    Entry EXEC CICS SYNCPOINT
  3943.                    Exit  EXEC CICS SYNCPOINT                    0
  3944.                    Entry EXEC CICS HANDLE
  3945.                    Exit  EXEC CICS HANDLE                       0
  3946.                    Entry EXEC CICS FREEMAIN
  3947. 08:34:51.50        Exit  EXEC CICS FREEMAIN                    31
  3948. 08:34:51.54        Entry EXEC CICS RETURN
  3949.                    Exit  EXEC CICS RETURN                       0
  3950.                    Entry POP ALL
  3951. 08:34:51.57        Exit  POP ALL                        31
  3952.                    Entry clear POST
  3953.                    Exit  Internal clear POST             0
  3954.                    Entry EXEC CICS SYNCPOINT
  3955.                    Exit  EXEC CICS SYNCPOINT                    0
  3956.                    Exit  Task Termination             1032
  3957. 08:34:53.00    86  Entry EXEC CICS ASKTIME
  3958.  
  3959.  
  3960. ΓòÉΓòÉΓòÉ 18. Known Errors ΓòÉΓòÉΓòÉ
  3961.  
  3962. The following are known errors in Version 1.0.1 of Performance Analyser. 
  3963.  
  3964.  1. PA2L transaction added to view CICSMSG.LOG from a CICS 3270 display 
  3965.  
  3966.     Note. Left and right scrolling may lose itself due to an error in the OS/2 
  3967.     toolkit being used. This will be fixed in a later release. Viewing from top 
  3968.     or bottom will reset the viewing display. 
  3969.  
  3970.  
  3971. ΓòÉΓòÉΓòÉ 19. Additions since original shipment ΓòÉΓòÉΓòÉ
  3972.  
  3973. The following additions to Performance Analyser have been made since its first 
  3974. Shipment in September 1994. 
  3975.  
  3976.  1. Maximum con-current tasks is displayed on all the Performance Analyser 
  3977.     screens. 
  3978.  
  3979.  2. ServerId available on transaction routed CICS 3270 displays as well as 
  3980.     local CICS 3270 displays. 
  3981.  
  3982.  3. Transaction level trace added. 
  3983.  
  3984.  4. PA2L transaction added to view CICSMSG.LOG from a CICS 3270 display. 
  3985.  
  3986.  5. Elapsed times in the application trace are printed in seconds.hundredths 
  3987.     rather than milliseconds to improve readability. 
  3988.  
  3989.  6. Highlighted start and end transaction events in the application trace. 
  3990.  
  3991.  7. Transaction name added to end transaction events in the application trace. 
  3992.  
  3993.  8. EXEC CICS RESP values added to Exit EXEC CICS events in the application 
  3994.     trace. 
  3995.  
  3996.  9. Eyecatchers added to end of line proportional to the elapsed time between 
  3997.     this CICS for OS/2 event and the next. Each '*' represents 5 timer units 
  3998.     (.15 seconds) up to a maximum of 1.5 seconds, in the application trace. 
  3999.