zPET - IBM Z and z/OS Platform Evaluation and Test - Group home

Health Checker for z/OS auto start

  

Health Checker will be started automatically by the system at IPL time in z/OS V2R1. Two new keys (system parameters) HZS and HZSPROC in IEASYSxx are provided to identify HZSPRMxx parmlib member suffixes and Health Checker started procedure name to be used at the IPL-time:

Syntax:

HZS={xx|(xx,...,zz)}

HZSPROC=xxx

Health Checker for z/OS setup in our systems

We added the following statement in IEASYSxx for Health Checker for z/OS auto start: 

   HZS=(LC,IA,CY)   /*Parmlib HZSPRMLC, HZSPRMIA, HZSPRMCY will be used by HZSPROC */

   HZSPROC=HZSPROC1  /*Health Checker start procedure HZSPROC1 will be used */

 

Health Checker started procedure HZSPROC1:

   //HZSPROC1 JOB JESLOG=SUPPRESS

   //HZSPROC PROC HZSPRM='PREV'                          

   //HZSSTEP EXEC  PGM=HZSINIT,REGION=0K,TIME=NOLIMIT,  

   //     PARM='SET PARMLIB=&HZSPRM'                     

   //HZSPDATA DD  DSN=HCHECK.&SYSNAME..HZSPDATA,DISP=OLD 

   //       PEND                                         

   //       EXEC HZSPROC

 

By default, the system uses the name HZSPROC for the IBM Health Checker for z/OS procedure. Instead of this default, we use procedure HZSPROC1. As a result, we had to specify HZSPROC1 in the HZSPROC system parameter of the IEASYSxx parmlib member, e.g. HZSPROC=HZSPROC1

During IPL we saw the following messages showing Health Checker on z/OS auto start and specified HZSPRMxx were used. 

   HZS0100I IPL-TIME START OF IBM HEALTH CHECKER FOR Z/OS IS BEGINNING  

   HZS0115I IPL-TIME START OF HZSPROC1 IS COMPLETE 

   ….

   IEE252I MEMBER HZSPRMLC FOUND IN SYS1.PARMLIB

   IEE252I MEMBER HZSPRMIA FOUND IN SYS1.PARMLIB

   IEE252I MEMBER HZSPRMCY FOUND IN SYS1.PARMLIB

 

We displayed Health Checker status by issuing the command ‘F HZSPROC1,DISPLAY’

Command output:                                         

   HZS0203I 01.38.45 HZS INFORMATION 948                         

   POLICY(DEFAULT)                                                 

   OUTSTANDING EXCEPTIONS: 17                                      

    (SEVERITY NONE: 0  LOW: 8  MEDIUM: 7  HIGH: 2)             

   ELIGIBLE CHECKS: 164 (CURRENTLY RUNNING: 0)                    

   INELIGIBLE CHECKS: 32  DELETED CHECKS: 0                       

   ASID: 0013  LOG STREAM: HZS.HEALTH.CHECKER.HISTORY - CONNECTED 

    LOG STREAM WRITES PER HOUR: 492                               

    LOG STREAM AVERAGE BUFFER SIZE: 2576 BYTES                    

   HZSPDATA DSN: HCHECK.Z1.HZSPDATA                                

   HZSPDATA RECORDS: 72                                            

   PARMLIB: LC,IA,CY                                               

   ORIGINAL PARMLIB SOURCE: SYSPARM                                

   OPTIONS: NONE   

                                                

Notes:

HZSPRM='PREV' behaves like HZPRM='SYSPARM' when the system encounters it at initial IPL time. Therefore, the ORIGINAL PARMLIB SOURCE is SYSPARM in above example. If you recycled the same started procedure after IPL, the value of the ORIGINAL PARMLIB SOURCE will become PREV.

Author: zPET Team