User-options module IDICNFUM

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 Fault Analyzer options.

Fault Analyzer 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 IDICNF00 parmlib member in the logical parmlib concatenation or in the alternative parmlib data set specified in the CNFDSN option of the IDIOPTLM configuration-options module.

The user-options module must be named IDICNFUM 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 IDISCNFU in the softcopy samples data set.

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

(See IDITRACE 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 Fault Analyzer 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 IDIBOPT DDname.