Cheat sheet: examples of MODIFY hzsproc commands

The following examples of MODIFY (F hzsproc) commands are useful for making dynamic, temporary changes to checks. See Using HZSPRMxx and MODIFY hzsproc command for complete syntax information.
Table 1. F hzsproc command examples
Action Command example
Run checks Run all checks that have an owner that is 6 characters long beginning with IBM®:
F hzsproc,RUN,CHECK=(ibm???,*)
This is a one time action issued against the checks involved.
Activate checks Activate checks that belong to any of the categories A or B: 
F hzsproc,ACTIVATE,CHECK=(*,*),CATEGORY=(ANY,A,B)
See Using the category filter to manage checks. This is a one time action issued against the checks involved.
Deactivate checks Deactivate checks that belong both to categories B and C:
F hzsproc,DEACTIVATE,CHECK=(*,*),CATEGORY=(ALL,B,C)
This is a one time action issued against the checks involved.
Disable checks You cannot disable a check, the system will disable a check in response to check routine or environmental problems. See IBM Health Checker for z/OS controlled states.
Enable checks You cannot enable a check, the system enables a check after you solve whatever problem led the system to disable it in the first place. See IBM Health Checker for z/OS controlled states.
Delete a check Delete a check:
F hzsproc,DELETE,CHECK=(IBMRACF,RACF_GRS_RNL)
This is a one time action issued against the check or checks involved. When you delete a check using the MODIFY command, your check will come back to run again whenever ADDNEW processing occurs. (ADDNEW processing refreshes all checks.) If you want a check to be deleted and stay deleted, use the DELETE parameter on a policy statement. See Why does my check reappear after I delete it? Understanding delete processing.
Refresh checks Refresh (delete one or more checks and add all eligible checks):
F hzsproc,REFRESH,CHECK=(*,*)
This command deletes specific checks and then adds ALL checks eligible to run.
Undelete a check Undelete a check:
F hzsproc,ADDNEW
This is a one time action issued against all checks that are eligible to run.
Update a check
  • Update a check to high severity:
    F hzsproc,UPDATE,CHECK=(IBMRACF,RACF_GRS_RNL),SEVERITY=HIGH
  • Update all checks with a check owner that starts with "a" and a name that starts with "b" to have:
    • WTOTYPE of informational
    • INTERVAL of one hour
    F hzsproc,UPDATE,CHECK=(a*,b*),WTOTYPE=INFORMATIONAL,INTERVAL=01:00
These updates lasts until the check involved is refreshed.
Clearing a check parameter error There are lots of checks that do not accept parameters (see IBM Health Checker for z/OS checks). If you do have a check that you have defined with parameters when it does not accept parameters, you can clear the parameter error by issuing the following command to update the check with a null parameter string:
F hzsproc,UPDATE,CHECK=(checkowner,checkname),PARM()
Add HZSPRMxx parmlib members
  • Start of changeCheck the syntax of the specified HZSPRMxx parmlib members that you want to add without applying the contents of the statements:
    F hzsproc,ADD,PARMLIB=(suffix1,suffix2,...,suffixn,CHECK)
    End of change
  • Add HZSPRMxx parmlib members to the list of members that IBM Health Checker for z/OS® is using:
    F hzsproc,ADD,PARMLIB=(suffix1,suffix2,...,suffixn)
  • Replace the list of parmlib members that IBM Health Checker for z/OS is using:
    F hzsproc,REPLACE,PARMLIB=(suffix1,suffix2,...,suffixn)
    REPLACE,PARMLIB does the following:
    • Sets the list of HZSPRMxx parmlib member suffixes to the list specified on the REPLACE parameter.
    • Wipes out any existing policy statements.
    • Processes the statements in the parmlib members in the list, applying them to existing checks.
    • Processes the policy statements and applies the statements to new checks.
Activate a policy or Switch between policies Activate an IBM Health Checker for z/OS:
F hzsproc,ACTIVATE,POLICY=policyname
Parent topic: Managing checks with the MODIFY hzsproc command