DUP
Valid for
Syncfile
Description
Use DUP
to specify the source and target file sets to duplicate and the name of the event to execute. Optionally, you can exclude individual files and/or types of files from duplication, duplicate based on whether records have changed, and execute FUP or TACL commands.
Follows the EVENT
parameter. At least one DUP
entry is required.
Syntax
DUPsource_file_set
, TARGETtarget_file_set
{, EVENTevent_name
} [, NAMEidentifier
] [, EXCLUDEexclude_file
], [, INCLUDEFILECODE (include_codes
) [, EXCLUDEFILECODE (exclude_codes
)], [, CHANGED | ALWAYS] [, FUPOPTIONS "fup_options
"] [, GETAUDITED | IGNOREAUDITED] [, TACLCMDtacl_command
];
-
source_file_set
-
Required. Identifies the source file set. You can use standard wildcards.
-
TARGET
target_file_set
-
Required. Identifies the target file set. You can use standard wildcards.
-
EVENT
event_name
-
Required. Specifies an event that has been defined by the
EVENT
parameter. You can specify multiple events as:EVENT
event_name
, EVENTevent_name
,... -
NAME
identifier
-
Optional logical name to be assigned to the
DUP
. Enclose in quotes if the name contains spaces. IfNAME
is not specified, the logical name will default toID
_num
wherenum
is the ordinal number of theDUP
item within the parameter file. The logical name is displayed when Syncfile starts processing aDUP
. -
EXCLUDE
exclude_file
-
Specify
EXCLUDE
when you want to exclude certain files in the file set from duplication. -
INCLUDEFILECODE
(include_codes
) -
A comma delimited list to specify the file codes to be excluded from duplication. Wildcards are not accepted. The list must be enclosed in parenthesis, for example:
INCLUDEFILECODE (32767, 65000)
If an
INCLUDEFILECODE
list is specified, any file code that is not in the list will be excluded. -
EXCLUDEFILECODE
(exclude_codes
) -
A comma delimited list to specify the file codes to be included in the duplication. Wildcards are not accepted. The list must be enclosed in parenthesis, for example:
EXCLUDEFILECODE (0, 100, 700, 800)
If a file code is on the
EXCLUDEFILECODE
list it will be excluded, even if it is on theINCLUDEFILECODE
list. -
CHANGED | ALWAYS
-
-
CHANGED
is the default. Duplicates files only if the source file has changed more recently than the target file. -
ALWAYS
duplicates source files whether or not source records have been modified since the corresponding target file records.
-
-
FUPOPTIONS
"fup_options
" -
Enables options to be appended to the
FUP DUP
command. By default, Syncfile executes:FUP DUP
source
,target
, PURGE, SAVEALLYou can replace the
PURGE
andSAVEALL
options with others. For example: specifying:FUPOPTIONS "SOURCEDATE, NEW";
results in the command:FUP DUP
source
,target
, SOURCEDATE, NEW. -
GETAUDITED | IGNOREAUDITED
-
-
GETAUDITED
duplicates files that have the audit flag set to on. -
IGNOREAUDITED
duplicates files that have the audit flag set to off.IGNOREAUDITED
is the default.
-
-
TACLCMD
tacl_command
-
See "Specifying TACL commands".
Specifying TACL commands
The TACLCMD
tacl_command
option executes a user-supplied TACL macro to perform the duplication. The macro can execute virtually any set of Guardian functions. For example, you can write a TACL macro to make a copy of the file to duplicate to a temporary location; edit the temporary file and change occurrences of the string "$DATA3
" to "$D16
"; age the previous file on the secondary system to a backup location; and FTP the temporary file to the backup.
When specifying TACLCMD
, enclose the entire command to execute in quotes as shown below:
TACLCMD "RUN $DATA1.TACLMAC.DUPMACsource
target
"
As part of this command, you can specify the source and target file names as the source
and target
arguments. For example, the following command causes Syncfile to invoke TACL with $D16.TEST.CFG1
as the source and \BKUP.$DATA6.TEST.CFG1
as the target:
RUN $DATA1.TACLMAC.DUPMAC $D16.TEST.CFG1 \BKUP.$DATA6.TEST.CFG1
Enter <source>
and <target>
without substituting any file names to trigger Syncfile to take the source and target arguments from the DUP
statement. For example, the following command will duplicate $DATA1.GGSPARM.*
to $DATA5.GGSPARM.*
.
DUP $DATA1.GGSPARM.*, TARGET $DATA5.*.*, TACLCMD "RUN $DATA1.GGSPARM.TACL5 <SOURCE> <TARGET>", ALWAYS, EVENT DAILY 1330;