Skip to Content

Overview of the Granular Governor

You can use the Granular Governor feature to control the input message rate in IMS Connect. These messages are regulated based on criteria, such as transaction name, IP address, client ID, and user ID.

Related topics

Using the Workload Governor

icon_play (1).pngWatch the YouTube video about Enabling the Granular Governor ​​​​​

The following example shows a WebSphere application set up to reject messages if the message rate reaches 30 messages per second, and the Java-based application is set up to reject messages if the message rate reaches 20 messages per second. This continues for the other applications based on their setup. If the total message rate reaches 500 messages per second, all messages are rejected.

Message rate.png

To issue an alert or reject messages, you must set rules by a specific transaction name, client IP address, client ID, or user ID. The Granular Governor uses these rules when the message volume is higher or lower than the specified thresholds. On reaching the threshold limit, the Granular Governor rejects any new messages. This helps IMS Connect and the IMS mainframe systems remain stable and responsive during a period of high message volume or for critical transactions. 

To enable the Granular Governor

Click here to expand...

 

  1. Make sure that the Workload Governor is enabled. For more information, see Enabling the Workload Governor.
  2. Enter the Granular Governor rules in the PROCLIB member. For more information, see To define Granular Governor rules member.
  3. In the Governor Options section on the IMS Connect Options panel, update the member name. 
                           IMS Connect Options                          
                                                            More:   - +
 Governor Options                                                                                                             
   Transaction limit  . . 100_______ (transactions per second)      
   Warning threshold  . . 70 (0 to 99 percent of transaction limit)
   Cycle interval . . . . 5_ (5-60 seconds)                         
   Low warning limit  . . 0_________ (transactions per second)      
   Granular governor. . . IPRGGOVR   (Governor rules PROCLIB member)
                                                                                                                                                                                                                                      
Command ===>                                                           
  F1=Help       F2=Keys       F3=Exit       F4=Prompt     F7=Bkwd       
  F8=Fwd        F9=Retrieve  F10=Back      F11=Next      F12=Cancel     

To define Granular Governor rules member

Click here to expand...

Create rules in the PROCLIB member by using the following Energizer fields:

Field

Description

TRAN_NAME

Specifies the transaction name to be monitored for transaction rate throughput

IP_ADDR

Specifies the IP address to be monitored for transaction rate throughput

CLID_NAME

Specifies the client ID to be monitored for transaction rate throughput

IRM_USRID

Specifies the user ID to be monitored for transaction rate throughput

TRAN_LIMIT

Specifies the maximum number of transactions an IMS Connect can receive for the following workloads:

  • Transaction name
  • IP address
  • Client ID
  • User ID

WARN_TRSHLD

Specifies the warning level for the following workloads:

  • Transaction name
  • IP address
  • Client ID
  • User ID

The valid values are from 1 through 99.

LOW_WARN

Specifies the minimum number of transactions that can be expected per second. To disable the low warning threshold message rate, specify LOW_WARN=0.

The cycle interval from the Workload Governor applies to the Granular Governor.

Sample rules member content

Command ===>                                                          Scroll ===> CSR
****** ********************************* Top of Data *********************************
000001 TRAN_NAME=BNK2AP1,TRAN_LIMIT=100,WARN_TRSHLD=75,LOW_WARN=0
000002 TRAN_NAME=BNK2AP2,TRAN_LIMIT=150,WARN_TRSHLD=75,LOW_WARN=0
000003 TRAN_NAME=BNK3AP1,TRAN_LIMIT=150,WARN_TRSHLD=50,LOW_WARN=0
000004 CLID_NAME=HWSCLNT,TRAN_LIMIT=70,WARN_TRSHLD=75,LOW_WARN=0
000005 IRM_USRID=THOR24,TRAN_LIMIT=70,WARN_TRSHLD=75,LOW_WARN=0
000006 IP_ADDR=100.100.100.01,TRAN_LIMIT=50,WARN_TRSHLD=75,LOW_WARN=0
000007 IP_ADDR=100.100.100.02,TRAN_LIMIT=50,WARN_TRSHLD=75,LOW_WARN=0
000008 TRAN_NAME=BNK4IMS,TRAN_LIMIT=100,WARN_TRSHLD=75,LOW_WARN=0
000009 TRAN_NAME=BNK1IMS,TRAN_LIMIT=100,WARN_TRSHLD=75,LOW_WARN=0
000010 TRAN_NAME=BNK5IMS,TRAN_LIMIT=100,WARN_TRSHLD=75,LOW_WARN=0
****** *********************************Bottom of Data *******************************

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Energizer for IMS Connect 1.9