DISCARDFILE

Valid for

Extract, Replicat

Description

Use DISCARDFILE to create a file containing records discarded by the process. Records can be discarded for a number of reasons, such as attempting to update a missing record. Each entry in the discard file provides the field names, field values and operation attempted, along with associated transaction information.

If DISCARDFILE is not present in the Replicat parameter file, Replicat will create a default discard file. See Monitoring Processing for details on the naming and characteristics of the default discard file.

Syntax

DISCARDFILE file_name
[, APPEND | PURGE] | ROLLOVER]
[, EXTENTS (primary, secondary, maximum) | MEGABYTES megabytes]
[, OWNER (group_number, user_number)]
[, SECURE "rwep"]

file_name

A physical file name or an existing define name of class map.

APPEND | PURGE | ROLLOVER

APPEND - Appends records to an existing file. This is the default if no value is entered.
PURGE - Purges an existing file and creates a new one
ROLLOVER - Renames the discard files by appending a sequence number to the file name, according to these rules:

If the file name is 7 characters or less, 1 digit is appended.

If the file name is 8 characters, the file does not rollover and a warning is given that the nameis too long. This is true when the rollover is requested from GGSCi, as well as from the DISCARDFILE parameter.

EXTENTS (primary, secondary, maximum)

Sets the extent sizes and maximum extents for the file. The default setting is (4, 4, 100).

MEGABYTES megabytes

Sets the maximum size of the file in megabytes. The maximum size is 2 gigabytes.

OWNER (group_number, user_number)

Defines ownership of the discard file.

SECURE "rwep"

Secures the file using standard Guardian security for read, write, execute and purge operations.

Example

DISCARDFILE =DISCARD_FILE, OWNER 100,1, SECURE "NNNN", PURGE