Event Monitoring Points

CICS® monitoring data is collected at system-defined event monitoring points (EMPs) in the CICS code. Although you cannot relocate these monitoring points, you can choose which classes of monitoring data that you want to be collected. Programming information about CICS monitoring can be found in the CICS Application Programming Reference and the CICS Customization Guide.

If you want to gather more performance class data than is provided at the system-defined event monitoring points, you can code additional EMPs in your application programs, from within task-related user exit or from global user exits. At these points you can add or change up to 16384 bytes of user data within each performance record. Up to this maximum of 16384 bytes you can have, for each ENTRYNAME qualifier, any combination of the following:

You could use these additional EMPs to count the number of times a certain event occurs, or to time the interval between two events. If the performance class was active when a transaction was started, but was not active when a user EMP was issued, the operations defined in that user EMP would still run on that transaction's monitoring area. The DELIVER option would result in a loss of data at this point, because the generated performance record cannot be output while the performance class is not active. If the performance class was not active when a transaction was started, the user EMP would have no effect.

User EMPs can use the EXEC CICS MONITOR command. For programming information about this command, see the CICS Application Programming Reference.

Additional EMPs are defined in some IBM® program products, such as IMS™ DBCTL. From the CICS point of view, these are like any other user-defined EMP. EMPs in user applications and in IBM program products are defined by a decimal number. The numbers 1 through 199 are available for EMPs in user application, and the numbers from 200 through 255 are for use in IBM program products. In addition, the numbers can be qualified with an entry name so that you can use each number more than once. For example, PROGA.1, PROGB.1 and PROGC.1, identify three different EMPs because they have different entry names.

For each user-defined EMP there must be a corresponding monitoring control table (MCT) entry, which has the same entry name and identification number as the EMP that it describes.

You do not have to assign entry names and numbers to system-defined EMPs, and you do not have to code MCT entries for them.

Here are some ideas about how you might make use of user fields provided using the CICS monitoring facility:

Information Information

Feedback


Timestamp icon Last updated: Saturday, 8 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///users-guide/cpaug62.htm