History file properties

To display attributes and statistics for the currently selected fault history file, first select File > Fault History File Properties from the action bar.

This opens the Fault History File Properties display.
Figure 1. Sample Fault History File Properties display
┌─────────────────────── Fault History File Properties ───────────────────────┐
│ Fault History File Properties                              Line 1 Col 1 76  │
│ Command ===> ____________________________________________ Scroll ===> CSR   │
│                                                                             │
│ Enter the Exit command (PF3) to return to the fault history file display.   │
│                                                                             │
│ History File Name . . . . . : DA.DCAT                                       │
│ History File Type . . . . . : PDSE (Library type 1)                         │
│ Primary Space . . . . . . . : 1,000 Cylinders (180,000 Pages)               │
│ Secondary Space . . . . . . :   200 Cylinders ( 36,000 Pages)               │
│ Allocated Space . . . . . . : 4,347 Cylinders (782,460 Pages)               │
│ Used Space. . . . . . . . . : 599,907 Pages                                 │
│ Allocated Extents . . . . . : 27                                            │
│ Data Set Utilization. . . . : 76.67%                                        │
│ History File Access . . . . : Update                                        │
│ Fault ID Prefix . . . . . . : F                                             │
│ Logical History File Size . : 600,000 Pages (76.68% of Allocated Space)     │
│ History File Utilization. . : 99.98%                                        │
│ Minimum Fault Entries . . . : 25,ThenAUTO                                   │
│ Current Fault Entries . . . : 4,192                                         │
│ Number of Entries With                                                      │
│   Minidump. . . . . . . . . : 4,092 (97.61% of Total)                       │
│ Maximum Minidump Size . . . : 2,840 Pages                                   │
│ Enter the Exit command (PF3) to return to the fault history file display.   │
└─────────────────────────────────────────────────────────────────────────────┘
The following information is available from this display:
Allocated Extents
The total number of extents allocated for the history file. Shown only if the user has data set READ access to the history file.
Allocated Space
The total allocated data set space in original allocation units. For PDSE history files the equivalent number of pages is also shown. Shown only if the user has data set READ access to the history file.
Average Minidump Size
The average size of all minidumps saved in this history file or view is indicated as the number of minidump pages.
Current Fault Entries
The current number of fault entries in the history file.
Data Set Utilization
Pages used as percentage of pages allocated. Only available for PDSE history files. Shown only if the user has data set READ access to the history file.
Fault ID Prefix
The fault ID prefix assigned to all fault entries in a history file. This prefix can be changed with the IDIUTIL batch utility using the SETFAULTPREFIX control statement (see Managing history files (IDIUTIL utility)). Alternatively, this setting can be changed using the Fault Analyzer ISPF interface (see Change fault history file settings).
History File Access
Read or Update.
History File Name
The name of a history file explicitly displayed, or a history file that is contained in a view.
History File Type
This name is indicated as one of the following:
  • PDSE (Library)
  • PDSE (Library type 1)
  • PDSE (Library type 2)
  • PDS (Partitioned Data Set)
History File Utilization
Used space as a percentage of history file size. (Only shown for PDSE history files.) Shown only if the user has data set READ access to the history file.
Logical History File Size
If available, the current logical history file size. Shown only if the user has data set READ access to the history file.
Minimum Fault Entries
The number of fault entries that must exist in the PDSE history file before it is maintained automatically, regardless of how many data set extents have been allocated to achieve this. Once the history file is maintained automatically, then the number of fault entries is limited only by the currently available data set space. No more data set extents are generally allocated and no out-of-space conditions are expected.

The minimum number of fault entries can be changed with the IDIUTIL batch utility SetMinFaultEntries control statement (see Managing history files (IDIUTIL utility)). Alternatively, this setting can be changed using the Fault Analyzer ISPF interface (see Change fault history file settings).

Maximum Fault Entries
The maximum number of fault entries to be maintained in this history file, before automatic deletion of the oldest entries.

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 maximum number of data set extents has been reached or the volume is full) prior to the history file containing nnn fault entries.

If "n/a", then no maximum fault entries has been assigned to the history file.

For PDS history files, the maximum number of fault entries can be changed with the IDIUTIL batch utility SetMaxFaultEntries control statement, and for PDSE history files, the IDIUTIL batch utility SetMinFaultEntries control statement (see Managing history files (IDIUTIL utility)). Alternatively, this setting can be changed using the Fault Analyzer ISPF interface (see Change fault history file settings).

Maximum Minidump Size
The largest minidump saved in this history file or view is indicated as the number of minidump pages.
Minimum Minidump Size
The smallest minidump saved in this history file or view is indicated as the number of minidump pages.
Number of Entries With Associated MVS Dump
The number of entries in the history file or view with an associated MVS dump data set. The percentage of the total entries is also shown.
Number of Entries With Minidump
The number of entries in the history file or view that include a saved minidump. The percentage of the total entries is also shown.
Number of History Files
If a view is displayed, the number of history files that are contained in the view. Information about individual history files follows.
Primary Space
The primary data set space allocation in original allocation units. For PDSE history files the equivalent number of pages is also shown. Shown only if the user has data set READ access to the history file.
Secondary Space
The secondary data set space allocation in original allocation units. For PDSE history files the equivalent number of pages is also shown. Shown only if the user has data set READ access to the history file.
Total Number of Entries
The total number of entries in the view.
Used Space
For a PDSE history file, this is the total number of pages used. For a PDS history file, this is the total number of original allocation units used. Shown only if the user has data set READ access to the history file.
View Name
If a view is displayed, the name of the view.