Writing to a discarded data file

This output file is used to hold data that cannot be reloaded.

The discard file name is specified by using the DISCARD_FILECTL subcommand. This discard file must be a valid file name, and can be predefined or dynamically allocated. The segments that are written to the discard file are in standard variable length record format. For more information about the discard file record layout, see Discard file record layout.

The DISCARD_FILECTL subcommand and the EXCEPTION_LIMIT keyword must be provided to write segments that cannot be reloaded to the discard file. When only the EXCEPTION_LIMIT keyword is provided, the segments that cannot be reloaded are bypassed and are not written to a discard file. For more information about assigning an exception limit, see Assigning-an-exception-limit and Fast Path/EP products reference information.

When segments are written to the discard file, an informational message is written to the PFPPRINT DD, indicating the total number of input area segments that have been discarded and written to the discard file.

Examples of writing to a discard file by providing the DISCARD_FILECTL subcommand, along with the EXCEPTION_LIMIT keyword is shown in figure Sample syntax for assigning an exception limit value and in the following figure. For more information about the DISCARD_FILECTL subcommand, see DISCARD_FILECTL.