Using real-time analysis to select a target region for workload routing
Use CICSPlex® SM's real-time analysis functions to produce data that will help in the selection of a target region during workload routing.
The number of items on the temporary storage queue will be monitored for each target region to which work can be routed. When the number of items rises above 50, a real-time analysis event notification (severity HS) and an external message will be issued. When an event notification is issued, CICSPlex SM's workload-routing function is notified and uses the information, in addition to the standard queue algorithm criteria, in selecting the best target region.
A CICS system group CSGTGTS3 has already been created and contains
four target regions (CICSPA01, CICSPA02, CICSPA03, and CICSPA04).
The target regions are currently running. Work is currently being
routed among these target regions by the routing region CICSPT03.
- Create a real-time analysis evaluation definition:
- From the main menu, click . This opens the Evaluation
definitions tabular view, listing any evaluation definitions
already created in PLXPROD1.
If the current context is not PLXPROD1, specify PLXPROD1 in the Context field and click Refresh.
- Click the Create... button, and provide the following
information:
Name RTEPAY15 Description TSQ NUMITEMS > 50 Sample interval 300 Resource table name MTSQGBL Instance identifier of evaluated resource * Method of evaluating results in result set ANY Separate task indicator NO Name of field being evaluated PUTQAUX Evaluation type VALUE Evaluation logical operator GT Evaluation data value 50 Severity assigned when result meets criteria HS Name of a view that may provide extra information MTSQGBL - Click Yes to create the new evaluation definition.
- From the main menu, click . This opens the Evaluation
definitions tabular view, listing any evaluation definitions
already created in PLXPROD1.
- Create a real-time analysis action definition:
- From the main menu, click . This opens the Action definitions view.
- Click the Create... button, and provide the following information:
Action RTAPAY15 Description NUMITEMS IN TSQ > 50 Generate event option YES Name of view that may provide useful information TSQ Action priority 255 Message to send when event occurs AUX TSQUEUE PUTQ ITEMS > 50 Generate external message option YES External message sent when event occurs AUX TSQUEUE PUTQ ITEMS > 50 External message sent when event is cleared AUX TSQUEUE PUTQ ITEMS < 50 Generate SNA generic alert option NO MVS automatic restart NO - Click Yes to create the new RTA action definition. The Action definitions tabular view is redisplayed.
- Create an analysis definition:
- From the main menu, click . This opens the RTA definitions view.
- Click the Create... button, and provide the following information:
Name RTDPAY15 Description TSQ NUMITEMS FOR WLM /RTA Execute evaluation modification string NO Analysis interval 300 Action definition name RTAPAY15 Count of true evaluations before VLS raised 0001 Count of false evaluations before VLS resolved 0001 Count of true evaluations before LS raised 001 Count of false evaluations before LS resolved 001 Count of true evaluations before LW raised 001 Count of false evaluations before LW resolved 001 Count of true evaluations before HW raised 001 Count of false evaluations before HW resolved 001 Count of true evaluations before HS raised 001 Count of false evaluations before HS resolved 0001 Count of true evaluations before VHS raised 0001 Count of false evaluations before VHS resolved 0001 Count of false evaluations before VHS resolved 0001 Evaluation expression RTEPAY15 - Click Yes to create the new analysis definition. The Analysis definitions tabular view is redisplayed.
- Create an analysis group:
- From the main menu, click. This opens the RTA groups tabular view.
- Click the Create... button, and provide the following information:
RTA group RTGPAY09 Description RTA/WLM Group - Click Yes to create the new analysis group. The RTA groups tabular view is redisplayed.
- Add the analysis definition to the analysis group:
- From the main menu, click . This opens the RTA definitions view.
- Click the record check box beside the entry for RTDPAY15 and click the Add to RTA group... button. The Add to RTA group view is displayed
- In the Resource group name field type RTGPAY09 and click Yes. The RTA definitions tabular view is redisplayed
- Create an analysis specification:
- From the main menu, click . This opens the RTA specifications tabular view.
- Click the Create... button, and provide the following information:
RTA specification name RTSPAY09 Description Workload routing with RTA - Click Yes and the RTA specifications tabular view is redisplayed, listing the new RTA specification.
- Add the analysis group to the analysis specification:
- From the main menu, click . This opens the RTA groups tabular view.
- Click the record check box beside the entry for RTGPAY09 and click the Add to RTA specification... button. The Add to RTA specification view is displayed
- In the RTA specname field, type RTSPAY09 and click Yes. The RTA groups tabular view is redisplayed
- Set the scope of the analysis specification.:
- From the main menu, click . This opens the RTA specifications tabular view.
- Click the record check box beside the entry for RTGPAY09 and click the Associate CICS group... button. The Associate CICS group view is displayed
- In the CICS system group field, type CSGTGTS3 and select the Force option. Click Yes and the RTA specifications tabular view is redisplayed.
- Activate real-time analysis in the target regions in CSGTGTS3:
- From the main menu, click . This opens the CICS system definitions tabular view.
- Click the record check box beside the entry for CICS system CICSPA01,
click the Update... button, and provide the following information:
CICS system definition name CICSPA01 Description Target region 1 on System A Real time analysis status YES Severity for system availability monitoring event NO Severity for short-on-storage (SOS) event NO Severity for system dump event NO Severity for transaction dump event NO Severity for CICS-at-maximum-tasks event NO Severity for CICS-stalled event NO - Click Yes to confirm the change. The CICS system definition is updated and the change, which is permanent, takes immediate effect. You do not have to restart CICS® system CICSPA01. Repeat this step for the target regions CICSPA02, CICSPA03, and CICSPA04.
- The workload specification WLSPAY02 is already being used for
workload routing among the target regions in CSGTGTS3. You must update
the specification to add the real-time analysis data to the standard
target region selection criteria. To update the workload specification:
- From the main menu, click . This opens theWLM specifications tabular view.
- Click the record check box beside the entry for WLSPAY02, click
the Update... button, and provide the following information:
Name WLSPAY02 Description Workload using RTA for target region selection Primary search criterion USERID Default target scope CSGTGTS3 RTA event name RTDPAY15 Acceptable level of abend probability 0 Acceptable abend load threshold 0 Algorithm type QUEUE - Click Yes to update the specification.
Notice that the RTA event field value is the name of the analysis definition you created in step 3.
When the routing region CICSPT03 and the target regions in CICS system group CSGTGTS3 are next started, the routing region routes transactions among the target regions using both the standard queue algorithm criteria and the analysis definition RTDPAY15 to select a target region.