Monitoring transaction response times
This example shows you how to use the WUI to monitor the response times of a particular transaction (PAY1), in a single CICS® system (CICSPA01), which is a local MAS in CICSplex PLXPROD1.
- Ensure
that both CICS monitoring and CICS performance class monitoring
are active in CICS system CICSPA01. CICSPlex® SM can gather detailed, transaction-related monitor data only if CICS monitoring and performance class monitoring are switched on. You can check whether they are active using the CICS region view as follows:
- From the WUI main menu, click CICS regions to open the CICS regions tabular view.
- If the current context is not PLXPROD1, specify PLXPROD1 in the Context field and click Set.
- Click CICSSPA01 to open a detailed view showing the current trace, dump, and statistics settings for of this region. Scroll down to the Monitor status field and ensure that it is set to ON. If it is not, change the setting using the drop down menu.
- Scroll to the bottom of this screen and click Monitoring, dump and trace details. Scroll down to the Performance class monitoring status field, which you will find in the Monitoring values section, and ensure that it is set to PERF. If it is not, change it.
- If you have changed either of the values, click the Apply changes button at the bottom of the screen
- Create a monitor definition.
- From the main menu, click Administration views > Monitor administration view > Monitor definitions to open the Monitor definition tabular view.
- Click the Create button at the bottom of the screen. Note: If you want to use an existing definition as a template, select a definition from the list first.
- Provide the following information:
- Monitor definition name
- MODPAY01
- Description
- Transaction PAY1
- Name or generic name of resource being monitored
- PAY1
- Monitoring resource class
- MTRAN
- Inclusion in CPSM monitoring option
- YES
- Resource status facility population
- NO
- Click Yes to confirm. The Monitor definition tabular view is redisplayed showing an entry for the monitor definition MODPAY01.
- Create a monitor specification.
- From the main menu, click Administration views > Monitor administration views > Monitor specifications to open the Monitor specification tabular view.
- Click the Create button at the bottom of the screen. Note: If you want to use an existing definition as a template, select a definition from the list first.
- Provide the following information:
- Specification name
- MOSPAY01
- Description
- Payroll resources
- Monitor activation status
- ACTIVE
- Data retention period
- 30
- Sample for transaction monitoring
- 120
Transactions are to be sampled every 120 seconds. The resource sample interval (that is, 120 seconds), when converted to minutes, should be evenly divisible into the monitor interval for the CICSplex.Note: You can look at the monitor interval for the CICSplex by opening the CICSplex definitions view (Administration views > CMAS configuration administration views > CICSplex definitions) and clicking on the entry for PLXPROD1. - Click Yes to confirm. The Monitor specification tabular view is redisplayed, showing an entry for monitor specification MOSPAY01.
- Associate the monitor specification with the CICS system.
- In the Monitor specifications view, select the entry for MOSPAY01, and click Associate CICS system.
- In the CICS system field, type in CICSPA01, and click Yes to confirm.
- Ensure that CICSPlex SM monitoring is switched
on in the CICS system.
- From the WUI main menu, click CICSPlex SM operations views > MASs known to CICSplex to open the MASs known to CICSplex tabular view.
- Check the value in the Monitoring status field for the
entry for CICSPA01:
- If this field is set to YES, you need to deactivate and then reactivate monitoring so that the new monitor specification takes effect. To do this, click CICSPA01 to display the MASs known to CICSplex detailed view. Change the Monitoring status field to NO and click the Apply changes button. Then repeat the process, setting the field back to YES.
- If this field is set to NO, you need activate monitoring. To do this, set the field to YES and click the Apply changes button.
If you don't set the Monitoring status field to YES, no monitoring will occur because the CICS system's Monitoring status field value overrides the Monitoring status value in the monitor specification.
- Look at the monitor data.
After a short time has elapsed (for this example, at least two minutes, which is the resource sample interval), you can look at the data that CICSPlex SM is gathering. To do this, from the WUI main menu, click Monitoring views > Transaction monitoring views > Monitor data for transactions and click on the entry for PAY1. This opens a detailed view showing information (including response times) for transaction PAY1 in CICS system CICSPA01.
Whenever you click Refresh, the view is redisplayed, though the frequency with which the data changes is determined by the resource sample interval. The monitor data is also written to an SMF data set (unless production of CMF records has been suppressed).
- Deactivate monitoring of transaction PAY1.
Monitoring of transaction PAY1 continues until CICSPA01 stops, unless you switch it off before then.
If you want to stop monitoring at any time, click Monitoring views > Active monitor specifications, select the entry for MODPAY01 and click the Remove... button. The monitor definition MODPAY01 is removed from CICS system CICSPA01, though it still exists in the data repository, and can be reinstalled at any time. The data gathered during monitoring of transaction PAY1 in CICSPA01 is kept for 30 minutes after you deactivate MODPAY01. (Remember that 30 minutes is the length of the retention period you specified in the monitor specification MOSPAY01.)