Change fault history file settings

To change a history file's settings from the ISPF interface, ensure that the history file is selected on the Fault Entry List display, or is included in the currently selected View.

You can change the fault ID prefix or the minimum or maximum number of fault entries. First, select File > Change Fault History File Settings from the action bar.

If a View is currently selected, then an option is provided to select a history file from the list of history files that are contained in the View.

Next, the Change Fault History File Settings display, as the example shown in Sample Change Fault History File Settings display, is presented.
Figure 1. Sample Change Fault History File Settings display
┌─────────────────────────────────────────────────────────────────────────────┐
│ Change Fault History File Settings                         Line 1 Col 1 76  │
│ Command ===> ____________________________________________ Scroll ===> CSR   │
│                                                                             │
│ History File Name . . . . . : DA.DCAT                                       │
│ Data Set 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                                            │
│ Current Number of Fault                                                     │
│   Entries . . . . . . . . . : 4192                                          │
│                                                                             │
│ Press Enter to change history file settings, or press PF3/PF12 to cancel.   │
│                                                                             │
│ Fault Entry Prefix. . . . . : F       (1-3 alphabetic characters)           │
│ Logical History File Size                                                   │
│ (Pages) . . . . . . . . . . : 600000  (0-4238460)                           │
│ Minimum Fault Entries (*) . : 25      (25-9999999)                          │
│                                                                             │
│ (*) When the total number of fault entries exceeds this value, then the     │
│     history file is auto-managed.                                           │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
The following fields are provided on this display:
History File Name
The history file name whose settings are to be changed.
Data Set Type
The selected history file type as one of the following:
  • PDSE (Library)
  • PDSE (Library type 1)
  • PDSE (Library type 2)
  • PDS
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.
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.
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.
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.
Current Number of Fault Entries
The number of fault entries currently in the selected history file.
Fault Entry Prefix
A one to three alphabetic character prefix which, together with the appended fault entry number, forms the fault ID for this history file. All new fault entries created in the history file are given this prefix, and by using different prefixes for different history files, this can make the fault IDs easier to recognize.

The initial fault entry prefix value shown always reflects the current setting for the history file.

Logical History File Size (Pages)
This field is only displayed for a PDSE history file and only if the user has data set READ access to the history file.

The value specifies the logical history file size as a number of 4K pages, and is used by Fault Analyzer to aid in space management of the history file. Until the minimum number of fault entries has been created in the history file, this setting will be shown as 0.

If you change a non-zero value using the procedure described in Changing the size of a PDSE history file, set the value to 0. This will automatically set the logical history file size to the current allocated number of pages at the time of creating the next fault entry which exceeds the minimum number of fault entries specified for the history file.

The maximum allowed value represents the theoretical maximum number of pages that could possibly be allocated, assuming the maximum number of data set extents is reached, with all remaining extents being of the secondary space size. Do not specify a value that is close to this size, because it will likely result in out-of-space conditions on the history file.

A warning will be displayed if the value specified is less than the Used Space value or greater than the Allocated Space value.

Minimum Fault Entries
The minimum number of fault entries that must exist in the PDSE history file before automatic space management occurs. This number must be between 25 and 9999999.
Note: This field is only displayed if the Data Set Type field specifies PDSE (Library).
Maximum Fault Entries
The maximum number of fault entries to maintain in the PDS history file as a number between 25 and 9999999.
Note: This field is only displayed if the Data Set Type field specifies PDS.
The initial minimum or maximum number of fault entries value shown typically reflects the current setting for the history file. However, in the following cases, the value is instead a recommended value:
  • The history file is a PDS and no maximum number of fault entries has been set. In this case, the initial maximum number of fault entries value is set to 100.
  • The history file is a PDSE and no minimum number of fault entries has been set. In this case, the initial minimum number of fault entries value is set to 100.
  • The history file is a PDSE and the minimum number of fault entries has either not been set, or is less than 25. In this case, the initial minimum number of fault entries value is set to 25.

A PDSE history file is always enabled for auto-management if changing the minimum number of fault entries value, regardless of whether it was auto-managed before or not.

After changing any settings, press Enter to save.

To exit without saving, press PF3 or PF12.

The functionality provided by this display is equivalent to the use of the IDIUTIL batch utility SetFaultPrefix, SetMaxFaultEntries, and SetMinFaultEntries control statements.

Note: The action-bar option File > Change Fault History File Settings is not selectable if the user's administrator authorization to the history file currently being displayed, or to all history files in the current View, has been restricted. For details about restricting authorization, see Restricting change of history file settings.