Home
Fault Analyzer installation and administration
Managing history files (IDIUTIL utility)
The IDIUTIL batch utility can be used to perform history file management functions, such as listing and deleting history file fault entries.
IDIUTIL control statements
SETMAXFAULTENTRIES control statement
The SetMaxFaultEntries control statement specifies a PDS history file data set name and the maximum number of fault entries to be set.

Fault Analyzer installation and administration
- Migrating from an earlier version of Fault Analyzer
- Preparing to customize Fault Analyzer
- Customizing the operating environment for Fault Analyzer
- Using the Fault Analyzer IDIS subsystem
  Fault Analyzer uses a subsystem known as IDIS for services that can otherwise not be performed or which might cause incomplete analysis if not started.
- Modifying your ISPF environment
- Customize Fault Analyzer by using USERMODs
- Customize Fault Analyzer by using an IDIOPTLM configuration-options module
- Setting up history files
  Fault Analyzer requires at least one PDS or PDSE data set to be allocated as a fault history file.
- Setting and changing default options for the site
- Providing compiler listings or Fault Analyzer side files
- Customizing the CICS environment
- Customizing the DB2 environment
- Customizing the IMS environment
- Customizing the Fault Analyzer Japanese feature
- Customizing the Fault Analyzer Korean feature
- Verifying Fault Analyzer customization
- Managing history files (IDIUTIL utility)
  The IDIUTIL batch utility can be used to perform history file management functions, such as listing and deleting history file fault entries.
  - IDIUTIL control statements
    - FILES control statement
      The FILES control statement specifies a list of PDS or PDSE history file data set names.
    - LISTHF control statement
      The LISTHF (LIST History File) control statement specifies a set of optional qualifiers to select which fault entries should be listed.
    - DELETE control statement
      The DELETE control statement specifies qualifiers to select which fault entries should be deleted.
    - SETFAULTPREFIX control statement
      The SETFAULTPREFIX control statement specifies the PDS or PDSE history file data set name followed by the new prefix.
    - SETMAXFAULTENTRIES control statement
      The SetMaxFaultEntries control statement specifies a PDS history file data set name and the maximum number of fault entries to be set.
    - SETMINFAULTENTRIES control statement
      The SetMinFaultEntries control statement specifies a PDSE history file data set name and the minimum number of fault entries to be set.
    - IMPORT control statement
      The IMPORT control statement specifies the "to" PDS or PDSE history file data set name followed by the "from" data set name.
    - EXPORT control statement
      The EXPORT control statement can be used to create a portable copy of a fault entry, which includes both the fault entry itself and any associated dump data set.
    - EXITS control statement
      The EXITS control statement follows the same format as the Exits keyword for real-time analysis and reanalysis. The difference is that the exit points are for LISTHF, DELETE, and IMPORT.
  - Examples
- Providing application-specific explanations and descriptions
- Maintaining Fault Analyzer
- Disabling Fault Analyzer
- Customizing Fault Analyzer by using user exits
- Installing non-ISPF interfaces to access Fault Analyzer history files

SETMAXFAULTENTRIES control statement

The SetMaxFaultEntries control statement specifies a PDS history file data set name and the maximum number of fault entries to be set.

Figure 1. Syntax

Description

max-number specifies the maximum number of fault entries that can be maintained in the history file. Additional data set extents are allocated as needed to achieve this number of fault entries. An out-of-space condition occurs if there is no space available in the data set (that is, the number of data set extents has reached the maximum, or the volume is full) prior to the history file containing max-number fault entries.

max-number must be 1 - 2147483647.

Note: If the maximum number of fault entries specified exceeds the current number of fault entries in the history file, then the oldest fault entries that are not locked are deleted until the history file only contains the number of fault entries specified.

This option is available for PDS history files only; use SetMinFaultEntries for PDSE history files.

Note: By default, this function is available to all users with UPDATE access to the history file. However, its usage can be restricted as explained in Restricting change of history file settings.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the IBM Software Support site.