This end user interface (EUI) example
describes how to
use CICSPlex® SM’s real-time analysis functions to produce data that will help
in the selection of a target region during workload balancing. In particular, 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 goes 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-balancing
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 balanced among these target regions by the routing region CICSPT03.
From the current view, issue the command EVALDEF. From the EVALDEF view, issue the command CRE. Complete the first Create Evaluation Definition panel as shown here, and press Enter:
------------------- Create Evaluation Definition for PLXPROD1------------------ COMMAND ===> Name ===> RTEPAY15 Description ===> TSQ NUMITEMS > 50 Sample Interval ===> 300 Interval between samples in seconds TableName ===> MTSQGBL Resource Table Name or * Instance Pattern ===> * Specific or generic pattern Result Set Action ===> ANY Operation(ALL,ANY,SUM,MIN,MAX,AVG,CNT) Separate Task ===> NO Run as a separate task (YES, NO) Evaluation Column ===> PUTQAUX Column name to evaluate or * either Operator ===> GT (EQ,NE,LT,GT,LE,GE) Value ===> 50 Severity ===> HS (VLS,LS,LW,HW,HS,VHS) or set Thresholds: Provide 3 low and/or 3 high values, N=Normal VLS LS LW (N) HW HS VHS View ===> MTSQGBL View invoked for this Evaluation Type DOWN or UP to view other Evaluation Definition screens. Press Enter to create Evaluation Definition. Type END or CANCEL to cancel without creating.
-------------------- Create Action Definition for PLXPROD1 -------------------- COMMAND ===> Action Name ===> RTAPAY15 Description ===> NUMITEMS IN TSQ > 50 Event ===> YES Generate Event (Yes/No) Event View ===> TSQ View for Event Priority ===> 255 Event Priority (1 to 255) Event Text ===> AUX TSQUEUE PUTQ ITEMS > 50 External Msg ===> YES Generate External Message (Yes/No) Enter Msg ===> AUX TSQUEUE PUTQ ITEMS > 50 Exit Msg ===> AUX TSQUEUE PUTQ ITEMS < 50 Alert ===> NO Generate Alert (Yes/No) CMAS Name ===> CMAS to Issue Alert Enter Text ===> Exit Text ===> Restart ===> NO Cancel for ARM Restart (Yes/No) Press Enter to create the Action Definition. Type END or CANCEL to cancel without creating.
From the current view, issue the command RTADEF. From the RTADEF view, issue the command CRE. Complete the Create Analysis Definition panel as shown here, and press Enter:
------------------------ Create Analysis Definition for PLXPROD1 -------------- COMMAND ==> Name ===> RTDPAY15 Description ===> TSQ NUMITEMS FOR WLM / RTA Perform Ops ===> NO Perform EVALDEF operations changes (YES, NO) Sample Interval ===> 300 Interval between samples in seconds (1-86400) Action Name ===> RTAPAY15 Action definition name or generic VLS LS LW HW HS VHS Entry Intervals ===> 0001 0001 0001 0001 0001 0001 Exit Intervals ===> 0001 0001 0001 0001 0001 0001 Evaluation expression: ===> RTEPAY15 ===> ===> ===> ===> ===> ===> Press Enter to create the Analysis Definition. Type END or CANCEL to cancel without creating.
From the current view, issue the command RTAGROUP. From the RTAGROUP view, issue the command CRE. Complete the Create Analysis Group panel as shown here, and press Enter.
------------------------- Create Analysis Group for PLXPROD1----------- COMMAND ===> Group Name ===> RTGPAY09 Description ===> RTA/WLM Group Press Enter to create Analysis Group. Type END or CANCEL to cancel without creating.
The RTAGROUP view is redisplayed.
From the current view, issue the command RTADEF. In the RTADEF view, tab to the entry for RTDPAY15 and issue ADD in the line-command field. The Add RTADEF to Analysis Group panel is displayed. Complete the panel as shown here, and press Enter.
------------------ Add RTADEF to Analysis Group for PLXPROD1 ----------------- COMMAND ===> Name RTDPAY15 Description TSQ NUMITEMS FOR WLM/RTA Analysis Group ===> RTGPAY09 Analysis Group or Generic Active Period ===> Period Name or Generic Press Enter to add RTADEF to Analysis Group. Type END or CANCEL to cancel without adding.
The RTADEF view is redisplayed.
From the current view, issue the command RTASPEC. From the RTASPEC view, issue the command CRE. Complete the Create Analysis Specification panel as shown here, and press Enter.
----------------------- Create Analysis Specification for PLXPROD1 ------------ COMMAND ===> RTA Spec Name ===> RTSPAY09 Description ===> Workload balancing with RTA System availability management: Action or Generic Severity SAM => => SOS => => SYSDUMP => => TRANDUMP => => MAXTASK => => STALL => => Press Enter to create the RTA Specification. Type END or CANCEL to cancel without creating.
You can ignore the System availability management fields.
From the current view, issue the command RTAGROUP. In the RTAGROUP view, tab to the entry for RTGPAY09 and issue ADD from the line-command field. Complete the panel as shown here and press Enter.
-------------Add Analysis Group to Analysis Specification for EYUPLX01 --------- COMMAND ===> Analysis Group RTGPAY09 Description RTA/WLM Group Specification Name ===> RTSPAY09 Specification Name or Generic Press Enter to add RTA Group to RTA Specification. Type END or CANCEL to cancel without adding.
Tab to the entry for RTSPAY09 in the RTASPEC view and issue the command ADD from the line-command field. In the Scope field of the Add Scope for Specification panel, type CSGTGTS3. In the Option field, type FORCE. Press Enter. The RTASPEC view is redisplayed.
From the current view, issue the command CICSSYS. In the CICSSYS view, tab to the entry for CICS® system CICSPA01 and issue UPD from the line-command field. Page forward to the Update system - Analysis Attributes panel. Complete the panel as shown here, and press Enter:
--------------- Update System - Analysis Attributes - for PLXPROD1------------- COMMAND ===> System Name CICSPA01 Description Target region 1 on System A Analysis active ===> YES Activate at RTA startup Analysis specification Current RTASPEC Specification source Type of link to RTASPEC System group name System group if implicit source System availability management: Action or Action Severity Severity Generic Inherit Inherit SAM ===> ===> NO ===> ===> NO SOS ===> ===> NO ===> ===> NO SYSDUMP ===> ===> NO ===> ===> NO TRANDUMP ===> ===> NO ===> ===> NO MAXTASK ===> ===> NO ===> ===> NO STALL ===> ===> NO ===> ===> NO Type DOWN or UP to view other System Screens. Press ENTER to Update the System. Type END or CANCEL to cancel without updating.
When you press Enter, 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 balancing among the target regions in CSGTGTS3. You have to update the specification to add the real-time analysis data to the standard target region-selection criteria.
Issue the command WLMSPEC from the current view. On the WLMSPEC view, tab to the entry for WLMPAY02. From the WLMSPEC view, issue the command UPD. Complete the Update WLM Specification panel as shown here, and press Enter:
-------------------- Update WLM Specification for PLXPROD1 -------------------- COMMAND ===> WLM Spec Name ===> WLSPAY02 Description ===> Workload using RTA for target region selection Affinity Relation ===> Default Affinity Relation (USERID, LUNAME, GLOBAL, BAPPL) Affinity Lifetime ===> Default Affinity Lifetime (SIGNON, LOGON, SYSTEM, PERMANENT, PCONV, DELIM ACTIVITY, PROCESS) Match Key ===> USERID Default Primary search criterion (USERID,LUNAME) Create Affinity ===> Create Auto Affinity (YES, NO, N/A) Target Scope ===> CSGTGTS3 Default CICS System,Group or Generic Event Name ===> RTDPAY15 RTADEF, STATDEF, or Generic Abend Health ===> 0 Target ABEND Health Factor (0 - 99) Abend Load ===> 0 Target ABEND Load Factor (0 - 99) Algorithm Type ===> QUEUE Algorithm Type (GOAL, QUEUE) Press Enter to update WLM Specification. Type END or CANCEL to cancel without updating.
Notice that the Event Name value is the name of the analysis definition you created in step 4.
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.