Grouping CICS regions in AppDynamics UI

You can now group CICS regions to be displayed as one node on the AppDynamics UI. This allows you to group your CICS regions into logical groups, such as grouping all the TORs into one tier and all of the AORs into one tier to help reduce the clutter on the AppDynamics flow map.

Procedure

Complete the following steps to define a group name for CICS regions.

  1. Add the following statement to the AGMSYSIN parameter data:
    TYPE=G,GRPNAME=MY_GROUP_NAME
  2. To pick up the changes to AGMSYSIN, use AGMU,STOP command followed by AGMU,START command. There is no need to recycle the CICS region.
    In order for the new group name to successfully register with the AppDynamics Controller, and be properly displayed on the UI, follow this process:
    • Stop the Distributed Gateway.
    • On the AppDynamics UI, click Tiers & Nodes in the left application panel and delete the old node names in the Tiers and Nodes list for all business transactions that contain the current CICS region.
    • Start the Distributed Gateway.
    Note:
    • MY_GROUP_NAME is the name of the group, a string of 56 characters or less.
    • Each CICS region in the group needs to specify this same name in its AGMSYSIN.
    • If you do not specify a group name, the CICS region name will be displayed on the UI.
    • You can use the modify command on the console to issue AGMU,FILTER=GROUP,LIST command in a CICS TS region to display the group name that is being used.
    • If you change group names without deleting the old node names on the UI, and without restarting the Distributed Gateway, the Business Transaction Flow on the UI might have unpredictable results.