Monitoring resources temporarily
Often, your reasons for monitoring a CICS® resource are temporary. For example, a problem might arise with a particular MRO connection that you solve using real-time analysis for a limited period of time. Also, even if you know that you want monitoring of a resource to be regular and permanent, you are recommended to start by monitoring the resource temporarily, so that you can fine-tune the real-time analysis definitions and assess their results.
- Create a CICS system group.
- From the WUI main menu, click Administration views > Topology administration views > System groups to open the System group definitions tabular view.
- If the current context is not PLXPROD1, specify PLXPROD1 in the Context field and click Refresh.
- Click the Create... action button.
- Type in the following information:
- System group name
- CSGAORS1
- Description
- AORs CICSPA01 and CICSPA02
- Click Yes to confirm. The System group definitions tabular view is redisplayed showing an entry for the new group, CSGAORS1. At this point, the group exists, but is empty.
- Add CICS systems to the CICS system
group
- Open the CICS system definitions tabular view (Administration views > Topology administration views > System definitions) and select the entries for CICSPA01 and CICSPA02.
- Click Add to CICS system group..., and in the Group which member will join field, type in CSGAORS1.
- Click the Yes to 2 remaining button to confirm.
- Create an evaluation definition.
This step, and the two that follow, show which definitions you have to create to tell CICSPlex® SM about the resource condition you're interested in, and what to do when it occurs. The order in which you create the definitions isn't particularly important, though the order shown here is probably the most logical.
Start with the evaluation definition which tells CICSPlex SM about the resource you're interested in. Then define the action definition, which tells CICSPlex SM how to notify you when the condition you've identified occurs. Finish with the analysis definition, which is basically a link between the evaluation definition and the action definition.
- From the main menu, click Administration views > RTA MAS resource monitoring > Evaluations to open the Evaluation definitions tabular view.
- Click the Create... button and provide the following information:
- Name
- RTEPAY02
- Description
- DB2 thread aborts (TRANID AB*)
- Sample interval
- 300
- Resource table
- DB2THRD
- Instance identifier of evaluated resource
- AB*
- Method of evaluating results in result set
- MAX
- Separate task indicator
- NO
- Field being evaluated
- ABORTCNT
- Evaluation type
- Threshold
- Lower bound of range for HW
- 20
- Lower bound of range for HS
- 40
- Lower bound of range for VHS
- 80
The Sample interval value is the interval at which CICSPlex SM must check the state of the resource. In this example, the number of DB2 thread aborts is to be checked every 300 seconds.
The evaluation threshold values (Lower bound of range for HW, and so on) tell CICSPlex SM which severity to apply to the event notification. In this example, when the number of DB2 thread aborts reaches 20, the severity value of the event will be HW; when it reaches 40, the severity value of the event will be HS; and when it reaches 80, the severity value of the event will be VHS.
- Create an action definition.
- From the main menu, click Administration views > RTA MAS resource monitoring > Actions to open the Action definitions tabular view.
- Click the Create... button and provide the following information:
- Action
- RTAPAY02
- Description
- DB2 thread aborts — High
- Generate event
- YES
- Name of view that may provide useful information
- DB2THRD
- Action priority
- 100
- Message to send when event occurs
- DB2 thread aborts too high
- Generate external message
- YES
- External message sent when event occurs
- DB2 thread aborts too high
- Generate SNA generic alert
- NO
- MVS Automatic restart
- NO
You will see the message "DB2 thread aborts too high" when any of the threshold values you have specified is reached. Notice that the field External message sent when event is cleared is left empty. This is because there is no "reverse" condition of a DB2 thread abort.
- Click Yes to confirm. The Action definitions tabular view is redisplayed and includes an entry for the new definition RTAPAY02.
- Create an analysis definition.
- From the main menu, click Administration views > RTA MAS resource monitoring > Definitions to open the RTA definitions tabular view.
- Click the Create.. button and provide the following information:
- Name
- RTDPAY02
- Description
- DB2 thread aborts
- Execute evaluation modification string
- NO
- Analysis interval
- 300
- Action definition name
- RTAPAY02
- Evaluation expression
- RTEPAY02
The Analysis interval (300 seconds in this example) controls how often CICSPlex SM looks at the results of the evaluation definition to determine whether the condition has occurred. This interval should not be smaller than the sample interval you specify in the evaluation definition itself, because there is nothing to be gained by assessing the results of the evaluation more frequently than the evaluation itself occurs.
- Click Yes to confirm. The RTA definitions tabular
view is redisplayed and includes an entry for the new definition RTDPAY02.
At this point, all the definitions you need have been created, but they must be activated by installing the analysis definition RTDPAY02 in the CICS system group CSGAORS1.
- Determine whether or not CICS system CICSPAO1 is already associated
with an analysis specification.
To do this; from the WUI main menu, click Administration views > RTA system availability monitoring > Specifications to system links. This opens the RTA specifications to CICS system links tabular view, which lists the associations between CICS systems and RTA specifications.
If CICSPAO is not associated with an analysis specification, complete steps 7 and 8. If CICSPAO1 is associated with an analysis specification, go to step 9.
- Create an analysis specification.
- From the WUI main menu, click Administration views > RTA system availability monitoring > Specifications to open the RTA specifications tabular view
- Click the Create... button and type in the following information
- RTA specification name
- RTSPAY02
- Description
- DB2 thread aborts
- Click Yes to confirm. The RTA specifications tabular view is redisplayed and includes an entry for RTSPAY02.
- Set
the scope of the analysis specification. The next step is to identify the CICS systems that are to use this specification.
- Select the entry for RTSPAY02 in the RTA specifications tabular view and click the Associate CICS group... button.
- In the CICS system group field, type CSGAORS1, and select Force to make all systems in CICS system group CSGAORS1 use this analysis specification.
- Click Yes to confirm.
- Verify that real-time analysis is active. Before you install the definitions, verify that the CICS systems defined in the CICS system group CSGAORS1 have real-time analysis active.
- From the main menu, click Administration views > RTA system availability monitoring > CICS system definitions to open the CICS system definitions tabular view.
- Click the entry for for CICSPAO1:
- If the Real time analysis status field specifies YES or MRM, skip the next step.
- If the Real time analysis status field specifies NO or SAM, return to the CICS system definitions tabular view, select the CICS system and click the Update... button. In the Real time analysis status field, type YES or MRM and click Yes to confirm.
- Install the analysis definition manually.
- From the WUI main menu, click Administration views > RTA MAS resource monitoring > Definitions to open the RTA definitions tabular view.
- Select the entry for RTDPAY02 and click the Install... button.
- In the Scope value field type in the name of the CICS system group (CSGAORS1, in this example). The analysis definition takes immediate effect in any of the CICS systems in the group that are currently running.
If you want to check where the analysis definition is currently active, go back to the WUI main menu and click Real Time Analysis (RTA) views > Real Time Analysis (RTA) installed analysis and status definitions. This view lists the analysis definitions that are currently installed in the CICS systems of the current scope.
The analysis definition you've just installed will remain active until you deactivate it, or until the CICS systems stop. If you decide, perhaps after some fine-tuning of intervals, that you're happy with the output you're getting from this analysis definition, you might want to install it automatically, so that it takes effect at CICS system-startup time and you don't have to install it manually again. How to do this is described in the next example.