Description

The HZSPWRIT macro is an interface used by check routines to write persistent data into the IBM® Health Checker for z/OS® Persistent Data data set, which is allocated using the HZSPDATA ddname in the startup proc or via the HZSPDATA statement in a HZSPRMxx parmlib member. Use HZSPWRIT only within the Init, Check, or Cleanup function for a local check, or within the InitRun or Run function for a remote check.

The data is associated with the writing check, and can be retrieved by the HZSPREAD macro, specifying the check owner and check name. The data remains even if the writing check is deleted.

If the check iteration completes with an abend (or a remote check iteration is designated unsuccessful) or an invocation of HZSPWRIT is not successful, then the persistent data for that iteration is not retained. Note that "unsuccessful" has no correlation with whether or not the check detected exception(s).