OC DISPLAY,PREFERENCES command

You can display the criteria used to select the preferred agent to monitor a given CICSplex by issuing a command.

Issue the following command against any OMEGAMON AI for CICS agent address space that is part of your monitoring runtime environment:

/F agent,OC DISPLAY,PREFERENCES

This command generates output in the agent’s RKLVLOG output similar to the following example:

KCP9030: ATC PROCESSING THE FOLLOWING COMMAND:      
DISPLAY,PREFERENCES                                 
KCP9341I: DISPLAYING THE CICSPLEX AGENT PREFERENCES:
KCP9342I: PLEXNAME  SMFID  XM  TIMEOUT              
KCP9343I: *DFLT     *      *         5              
KCP9343I: TESTPLEX  SYST   11  NO                   
KCP9343I: PRODPLEX  SYSP   15        5

In this example, there are preferences defined specifically for two CICSplexes, TESTPLEX and PRODPLEX, plus a default set of criteria, named *DFLT, that will be used to select the agent that should report CICSplex-level information and samples data for short-term historical collection about the CICSplex. The attributes specify the LPAR and XM number of the preferred agent to monitor the given CICSplex. There is also a timeout attribute that indicates how long the monitoring environment will wait for the preferred agent to come online before any other online agent within the environment can assume responsibility for monitoring this CICSplex. The timeout value is specified in minutes, or can be NO, indicating the wait period should never time out and that only the preferred agent should be used to monitor this CICSplex.

The preference for the TESTPLEX CICSplex is the agent found on the SYST LPAR identified with XM number 11. PRODPLEX's preferred agent can be found on the SYSP LPAR with XM number 15. PRODPLEX will wait for up to 5 minutes for its preferred agent to come online, while TESTPLEX will wait indefinitely. The default set attributes apply to all CICSplexes that do not have a specific preferred agent defined; these indicate that any agent on any LPAR can be used as the monitor of a new CICSplex.

When a new CICS® region is detected by an agent within the monitoring environment, it is immediately classified into a CICSplex. If this is the first region within this CICSplex to be monitored, a check is made against this table to determine which agent should be the preferred collector of CICSplex-level information. If that agent is online within this runtime environment, it is selected. If not, the timeout period begins, which, if exceeded and the preferred agent is not online, allows any other online agent within your environment to assume responsibility for monitoring this CICSplex. Once an agent has assumed responsibility for monitoring a given CICSplex, it will continue to do so provided it remains online, even if the originally preferred agent later comes online.

The CICSplex agent preferences can be updated through the enhanced 3270 user interface.