UTL - IDIUTIL Batch Utility user exit parameter list

Table 1. UTL data area

This table has 6 columns and 2 header rows. In the first header row, the "Offsets" heading spans columns 1 and 2. The "Offsets" heading has 2 subheadings in the second header row: "Dec" in column 1 and "Hex" in column 2.

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 IDIROBOT 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 IDIUTIL 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 IDIOPTLM 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.
83 (131) CHAR R/O 1 DUP_TYPE

This field is applicable only when using the ListHFDup exit.

Possible values are:
Blank
Base fault entry
N
Normal duplicate
F
CICSfast duplicate
I
Imagefase ducplicate
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 IDIUTIL is running.