OC DISPLAY,PLEXRULES command

You can display the rules that the OMEGAMON AI for CICS agent is using to assign CICSplex names to CICS® regions by issuing a command.

Issue the following command to assign CICSplex names to CICS regions:
/F agent,OC DISPLAY,PLEXRULES
This command generates output in the RKLVLOG output similar to the following example: 
KCP9030: ATC PROCESSING THE FOLLOWING COMMAND:
DISPLAY,PLEXRULES
KCP9337I: DISPLAYING THE CICSPLEX NAME RULES:
KCP9338I: PLEXNAME  JOBNAME  SYSPLEX  SMFID  APPLID  GAPPLID  XCFGROUP
KCP9339I: CICSPLX1  CICSM*   SYSPLEX1 SYSA   CICS*   TST*     *
KCP9339I: CICSPLX2  CICSRGN2 *        *      *       *        *
KCP9339I: CICSPLX3  *        *        *      *       TSTGAPPL *
KCP9339I: CICSPLX4  *        *        *      *       *        XCRGRP01
KCP9339I: OMEGPLEX  *        *        *      *       *        *
In this example, there are four CICSplex classification rules that the OMEGAMON AI for CICS agent searches for in the order listed by the KCP9339I messages:
  • CICSPLX1
  • CICSPLX2
  • CICSPLX3
  • CICSPLX4
  • OMEGPLEX
The first classification rule indicates that the CICS region is assigned to CICSPLX1 CICSplex, if the following attributes match:
  • JOBNAME must begin with CICSM
  • SYSPLEX ID must be SYSPLEX1
  • SMF ID must be SYSA
  • VTAM APPLID must begin with CICS
  • GENERIC APPLID must begin with TST

The second classification rule indicates that the CICS region is assigned to CICSPLX2 CICSplex only if the first attribute matches; the JOBNAME must be CICSRGN2 .

The third classification rule indicates that the CICS region is assigned to the CICSPLX3 CICSplex, only if the GAPPLID attribute matches; the generic APPLID must be TSTGAPPL.

The fourth classification rule uses the CICSplex name supplied by CPSM regardless of the CICS region's attributes. The OMEGAMON AI for CICS agent assigns a CICS region with a JOBNAME of CICSRGN1 to the CICSplex since this rule is the first matching rule. The agent assigns a CICS region with a JOBNAME of CICSRGN2 to the CICSPLX2 CICSplex because the second rule is the first one that matches.

The final classification rule indicates that the CICS region is assigned to the CICSPLX4 CICSplex, if and only when the XCFGROUP attribute matches; the XCFGROUP must be XCFGRP01 .