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	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`