Configure the OMEGAMON health checks

The OMEGAMON® products ship with two health checks for IBM® Health Checker for z/OS®. The started task check verifies that all of the started tasks configured for this runtime environment are running. The APF authorization check verifies that all of the load libraries concatenated in the product started tasks' STEPLIB DDNAME and RKANMODL DDNAME are APF-authorized. The APF authorization health check runs once at start up of the HZSPROC started task. The STC health check runs at the user-specified interval.

About this task

Customize the following parameters in the RTE configuration profile to configure the health checks.
RTE_HCK_REXX_AXRUSER_HILEV
This parameter specifies the high-level qualifier that is used by the system REXX health check code to allocate output data sets. Output data sets are allocated only if tracing or logging is performed. The default is AXRUSER. For example, for the APF health check, the REXX exec is named KCIRCAPF and output data sets are qualified with AXRUSER.KCIRCAPF. The HZSPROC started task must have allocate and write access to data sets created under this high-level qualifier. This high-level qualifier should be cataloged in the system catalog so that it is unique to the LPAR.
RTE_HCK_STC_INTERVAL
This parameter contains the interval, in minutes, for running the started task health check. The acceptable range is 10 - 1440 minutes (24 hours). The default is 30 minutes.
Important: You must also customize the GBL_DSN_HZSPROC_LOADLIB parameter in the global configuration profile. This parameter specifies the name of a load library that is usable by the Health Checker started task HZSPROC for assembling and linking health check modules. This library can be in the HZSPROC STEPLIB or it can be a library in LNKLIST.
You can start the health checks in one of two ways.
  • By modifying the HZSPRM default value in the HZSPROC PROC statement to add these checks. For example,
    //HZSPROC PROC HZSPRM='(00,CI)'
    This option implements these two health checks automatically, whenever the Health Checker task is started.
  • By issuing a console command after the z/OS Heath Checker started task is active. For example:
    F HZSPROC,ADD,PARMLIB=(CI)
    This option requires that the console command be issued each time the Health Checker task is started.
More information about the Health Checker is available in the IBM Health Checker for z/OS User's Guide.