Options

You can use options to exert some control over the way that Fault Analyzer produces output. For example, there are options to:
  • Change the fault analysis report contents.
  • Change the action that Fault Analyzer takes at the time of the abend.

You can provide options at most stages of processing. If the option is not relevant to the current mode of processing (for example, you are trying to set the Exclude option when doing a batch reanalysis), it is disregarded. Fault Analyzer does not produce unnecessary warning messages in this situation.

Options can be set or changed in the following ways, listed in the order of their processing:

  1. Product defaults provided by Fault Analyzer.
  2. SMP/E USERMODs.

    For more information, see Customize Fault Analyzer by using USERMODs.

  3. IBM Application Delivery Foundation for z/OS (ADFz) Common Components IPVOPTLM configuration-options module.

    Fault Analyzer does not require the IPVOPTLM configuration-options module to exist. If it exists, Fault Analyzer will process it unless the NOIPVOPT value is set to 1 in the IDIOPTLM configuration-options module. See Ignoring IBM Application Delivery Foundation for z/OS Common Components options (NOIPVOPT).

    For information about the IPVOPTLM configuration-options module, see IBM Application Delivery Foundation for z/OS Common Components: Customization Guide and User Guide.

  4. Installation-wide defaults specified in the ADFz Common Components IPVCNF00 parmlib member.

    Fault Analyzer does not require the IPVCNF00 parmlib member to exist. If it exists, Fault Analyzer will process it unless the NOIPVOPT value is set to 1 in the IDIOPTLM configuration-options module. For details, see Ignoring IBM Application Delivery Foundation for z/OS Common Components options (NOIPVOPT).

    For information about the IPVCNF00 parmlib member, see IBM Application Delivery Foundation for z/OS Common Components: Customization Guide and User Guide.

  5. Configuration-options module IDIOPTLM.

    For more information, see Customize Fault Analyzer by using an IDIOPTLM configuration-options module.

  6. Options located via an IDICNFUM user-options module.

    This module is only applicable to real-time analysis, and, if found, replaces step 7.

    For more information, see User-options module IDICNFUM.

  7. Installation-wide defaults specified in the IDICNF00 parmlib member.

    The parmlib member is only read if a user-options module was not found in step 6.

    For more information, see Parmlib member IDICNF00.

  8. Options that are specified in a user-options file through the _IDI_OPTSFILE environment variable.

    If found, replaces step 9.

    For more information, see The _IDI_OPTSFILE environment variable.

  9. Options that are specified in a user-options file through the IDIOPTS DDname.

    Only read if a user-options file was not found in step 8.

    For more information, see User options file IDIOPTS.

  10. Options that are specified in the JCL EXEC statement PARM field when performing batch reanalysis.

    For more information, see The JCL EXEC statement PARM field.

  11. Options provided through the _IDI_OPTS environment variable.

    For more information, see The _IDI_OPTS environment variable.

  12. Options set via the Analysis Control user exit.

    For more information, see Analysis Control user exit.

  13. Settings of EPC data area fields with the End Processing user exit, as these might effectively override the RetainDump and MaxMinidumpPages options in effect.

    For more information, see End Processing user exit.

If you do not specify an option, it takes either the product default (as indicated on the syntax diagram for each option), or has no value at all.

Some options can retain only one value. If more than one instance of such an option is specified, only the last occurrence has an effect. For example, if
PARM='Detail(LONG) Detail(SHORT)'
is specified, then the active option is Detail(SHORT).

Some options can have more than one value. These are, for example, the DataSets, Exits, Include, and Exclude options. The way in which they accumulate information is described for each option.

Wherever you specify an option, it is subject to these syntax rules:
  • Only columns 1 - 71 are processed.
  • Options can be specified anywhere in a line. They do not have to start in column 1.
  • You can use a blank or a comma as a delimiter.
  • Options can be continued across any number of lines, except when specified in the JCL EXEC statement PARM field, where the z/OS®-imposed limit is 100 characters.
  • When continuing option values across multiple lines (for example, long HFS path names specified via the DataSets(IDIJAVA(...)) option), then either of the following is supported:
    • Specify the value up until, and including, column 71 and start in column 1 on the following line.
    • Specify the option value continuation character '+' at the end of the lines to be continued. One or more blank characters must precede the plus sign. Quoted values that are continued using the + sign must be specified with each part of the value surrounded by quotes.
    Example:
    DataSets(IDIJAVA('/this/might/be/a/really/long' +
                              '/path/name'))
  • Option names and keyword parameters are not case-sensitive. Option values are also not case-sensitive, unless explicitly stated for a given option.
  • Comments are permitted anywhere and can be nested. The characters /* identify the beginning of a comment, and */ identify the end.