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
DISCARDFILEfile_name
[, APPEND | PURGE] | ROLLOVER] [, EXTENTS (primary
,secondary
,maximum
) | MEGABYTESmegabytes
] [, 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