User-options module HFZCNFUM

To replace the installation-wide default options during real-time analysis, you can create a user-options module containing the names of one or more partitioned data sets and members, each containing Z Abend Investigator options.

Z Abend Investigator tries to open the data set members in the order of their specification. The first data set and member found to be available is used instead of the HFZCNF00 parmlib member in the logical parmlib concatenation or in the alternative parmlib data set specified in the CNFDSN option of the HFZOPTLM installation-options module.

The user-options module must be named HFZCNFUM and must be a load module available via the standard MVS™ search path. If placed in a load library that is allocated to the JOBLIB DDname, this placement effectively provides job-level control of default options.

The load module can contain partitioned data set and member names only in standard MVS JCL syntax format:
data-set-name(member-name)
Each data set specification must be terminated by an X'00' byte. A second X'00' byte must follow the last data set specification to indicate the end of the list. If no data sets are specified, at least one X'00' byte is required.
For added flexibility in the use of user-options modules, the following symbolic names can be used in the specification of data set or member names:
&SYSUID.
The user ID that is associated with the abending job or CICS® transaction.
&JOBNM.
The job name of the abending job.
&PGMNM.
The program name on the EXEC statement in the abending job.

A job to create a sample user-options module is provided as member HFZSCNFU in the softcopy samples data set.

The data set and member selected by Z Abend Investigator is identified in message HFZ0001I. If you want to see the data set and member names that were not selected (after substitution of variables), include the HFZTRACE DDname in your job step. For example:
//HFZTRACE DD SYSOUT=*

(See HFZTRACE under CICS for an alternative method of activating this trace under CICS.)

The name of the selected user-options module data set and member saved by Z Abend Investigator in the history file and automatically reused as the default options file during reanalysis of the fault. For batch reanalysis, the data set and member is included in the generated JCL with the HFZBOPT DDname.