Assigning an exception limit
To override the RELOAD command default of no input segment errors, assign an exception limit value that is greater than zero to the EXCEPTION_LIMIT keyword.
As long as the exception limit value assigned is greater than the number of segment exceptions encountered, the segment exceptions are bypassed and reloading of the area data set continues. For detailed information about the segment exceptions that could cause segments to be bypassed, see the Fast Path/EP Series Reference Manual documentation.
The EXCEPTION_LIMIT keyword enables the reload process to tolerate a defined number of segment exceptions on an input area. This functionality allows the loading of the database to continue. The segments that are bypassed can be written to a discard file if the EXCEPTION_LIMIT keyword and the DISCARD_FILECTL subcommand are provided. If only the EXCEPTION_LIMIT keyword is provided, the segments are bypassed, but are not written to a discard file. For information about writing to a discard file, see Writing-to-a-discarded-data-file.
The value that you assign to the EXCEPTION_LIMIT keyword represents the number of segment exceptions that will be tolerated for an input area. The default value, EXCEPTION_LIMIT=0, indicates that no segment exceptions will be tolerated, and the reload process will terminate when a segment exception is encountered. The EXCEPTION_LIMIT keyword can be assigned a numeric value up to 2,147,483,647. Reload processing will terminate when the number of segment exceptions encountered exceeds the value assigned to the EXCEPTION_LIMIT keyword. If you want the RELOAD command to load all valid segments, you can assign the value of 'INFINITE' to the EXCEPTION_LIMIT keyword. EXCEPTION_LIMIT=INFINITE causes all segment exceptions encountered to be bypassed.
When the number of segment exceptions encountered exceeds the value assigned to the EXCEPTION_LIMIT keyword, the following actions occur:
- An informational message is written to the PFPPRINT DD, indicating that the number of exceptions detected has exceeded the assigned value.
- RELOAD command processing terminates.
An example of assigning a value to the EXCEPTION_LIMIT keyword is shown in the following figure.
IAREA=areanam1,OAREA=areanam1,
EXCEPTION_LIMIT=20
DISCARD_FILECTL DSNAME='BMCPFP.reljob.DISCARD',DISP=(NEW,CATLG),
SPACE=(CYL,1,1,RLSE),UNIT=DISK
For more information about the EXCEPTION_LIMIT keyword, see the Fast Path/EP Series Reference Manual documentation.
Related topic