UTL - HFZUTIL Batch Utility user exit parameter list

Table 1. UTL data area
Offsets Type Access Len Name and description
Dec Hex
0 (0) CHAR R/O 4 VERSION

Parameter list version (currently 0002).

4 (4) CHAR R/O 44 (Reserved)
48 (30) CHAR R/W 1 PERFORM_ACTION

Perform the utility action on this fault entry (Y/N).

49 (31) CHAR R/W 100 IMPORT_DUMP_DSN

This value is applicable only when importing a single fault entry from a staging data set created using the HFZROBOT exec.

If the fault entry being imported was exported along with an associated dump data set, the original associated dump data set name is provided in ENV.ASSOCIATED_DUMP_DSN. An HFZUTIL user exit can then respond in the following ways:
  • It can ignore the associated dump data set by setting the UTL.IMPORT_DUMP_DSN field to "NULLFILE".
  • It can initialize UTL.IMPORT_DUMP_DSN to the original dump data set name provided in ENV.ASSOCIATED_DUMP_DSN. ❶
  • It can initialize UTL.IMPORT_DUMP_DSN to a different dump data set name. ❶
  • It can leave the UTL.IMPORT_DUMP_DSN field blank, in which case the appropriate data set name specified in the RFRDSN, SDUMPDSN, or XDUMPDSN options of the HFZOPTLM configuration-options module will be used.
The name specified in UTL.IMPORT_DUMP_DSN will be used for the dump data set allocated for, and associated with, the imported fault entry.
Note:
The data set name must be appropriate for the system on which the fault entry is being imported and the user ID under which HFZUTIL is running.