Input variables

The following REXX variables are input to HZSLFMSG:
Table 1. HZSLFMSG input variables
Variable name Description
HZS_HANDLE IBM® Health Checker for z/OS® sets this variable to the correct value when it calls a REXX check. Your REXX check must not modify HZS_HANDLE. The HZS_HANDLE is used to synchronize the check and IBM Health Checker for z/OS, because they do not run in the same address space. If the HZSLFMSG function is used within a REXX procedure, make sure you used for example the EXPOSE procedure option to make HZS_HANDLE accessible to the procedure code.
HZSLFMSG_REQUEST= { 'CHECKMSG' | 'DIRECTMSG' | 'HZSMSG' | 'STOP' | 'DOM'}
 
  • CHECKMSG indicates that the message text is provided in the message table identified by the MSGTBL parameter when the check was added to IBM Health Checker for z/OS.
  • DIRECTMSG indicates that the messages for this check are issued directly from the check routine - this check does not have a message table associated with it. The message text for this message is provided in the HZSLFMSG_REQUEST='DIRECTMSG' input variables.
  • HZSMSG indicates that the message text is provided by IBM Health Checker for z/OS.
  • STOP indicates that the system is to stop calling this check. The message text is provided by IBM Health Checker for z/OS.
  • DOM indicates that all the check exception WTOs from previous iterations of this check be DOMed. HZSLFMSG_REQUEST=DOM for a check added as DOM(CHECK) gives you control over when exception messages WTOs for a check are DOMed. For information on using this function, see Controlling check exception message WTOs and their automation consequences.
    HZSLFMSG_REQUEST='DOM' is only allowed:
    • From within a check routine
    • Before any check exception messages have been sent in the current check iteration
    • For checks added with parameter DOM(CHECK).
    There are no HZSLFMSG_REQUEST=DOM input variables.