Understanding check state and status

Part of managing checks is understanding the check state and status shown for checks in the check messages in the message buffer, SDSF or the MODIFYhzsproc,DISPLAY output:
  • State: Indicates whether a check will run at the next specified interval.
  • Status: Describes the output of the check when it last ran.
For example:
  • In the message buffer, system information displayed with the check message includes check status:
    CHECK(IBMCNZ,CNZ_CONSOLE_MSCOPE_AND_ROUTCODE)                          
    START TIME: 06/08/2005 09:49:17.410704                                 
    CHECK DATE: 20040816  CHECK SEVERITY: LOW                              
                                                                            
    * Low Severity Exception *                                             
                                                                           
    CNZHF0003I One or more consoles are configured with a combination of   
    message scope and routing code values that are not reasonable.         
                            .
                            .
                            .                                              
     Check Reason:  Reduces the number of messages sent to a console in    
       the sysplex                                                         
    END TIME: 06/08/2005 09:49:17.451937  STATUS: EXCEPTION-LOW
  • In SDSF, information displayed about checks includes state and status:
    NAME                            CheckOwner       State              Status
    CNZ_AMRF_EVENTUAL_ACTION_MSGS   IBMCNZ           ACTIVE(ENABLED)    SUCCESSFUL
    CNZ_CONSOLE_MSCOPE_AND_ROUTCODE IBMCNZ           INACTIVE(ENABLED)  INACTIVE
    CNZ_SYSCONS_ROUTCODE            IBMCNZ           ACTIVE(ENABLED)    EXCEPTION-LOW
    GRS_CONVERT_RESERVES            IBMGRS           ACTIVE(DISABLED)   GLOBAL
  • If you enter the f hzsproc,display,checks command to display check information, you'll receive output like the following. (Note that the check states are explained in the output.)
    HZS0200I 10.56.19 CHECK SUMMARY     134                             
    CHECK OWNER      CHECK NAME                      STATE STATUS       
    IBMVSM           VSM_CSA_CHANGE                   AE   SUCCESSFUL   
    IBMRRS           RRS_RSTOFFLOADSIZE               AE   SUCCESSFUL   
    IBMRRS           RRS_DUROFFLOADSIZE               AE   SUCCESSFUL   
    IBMRRS           RRS_MUROFFLOADSIZE               AE   SUCCESSFUL   
    IBMRRS           RRS_RMDOFFLOADSIZE               AE   SUCCESSFUL   
    IBMRRS           RRS_RMDATALOGDUPLEXMODE          AE   SUCCESSFUL   
    IBMCNZ           CNZ_SYSCONS_PD_MODE              AE   SUCCESSFUL   
    IBMCNZ           CNZ_EMCS_INACTIVE_CONSOLES       ADG  SYS=J80      
    IBMCNZ           CNZ_SYSCONS_ROUTCODE             AE   EXCEPTION-LOW
    IBMCNZ           CNZ_SYSCONS_MSCOPE               AE   SUCCESSFUL   
    IBMCNZ           CNZ_EMCS_HARDCOPY_MSCOPE         AE   EXCEPTION-MED      
                                           .
                                           .
                                           .
      A - ACTIVE          I - INACTIVE
      E - ENABLED         D - DISABLED
      G - GLOBAL CHECK    + - ADDITIONAL WARNING MESSAGES ISSUED
Both of these examples show that the state and status for the highlighted check, CNZ_SYSCONS_ROUTECODE, are as follows:
  • The check state is AE or ACTIVE(ENABLED), which means that it will run at its next scheduled interval.
  • The check status is EXCEPTION-LOW, indicating that the check found a low severity exception.
Check states: Each check state has two parts:
  1. User controlled states
  2. IBM Health Checker for z/OS controlled states
Check status: For check status, see Check status.