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

DUP <source_file_set>, TARGET <target_file_set>
{, EVENT event_name}
[, NAME identifier
[, EXCLUDE exclude_file],
[, INCLUDEFILECODE (include_codes)
[, EXCLUDEFILECODE (exclude_codes)],
[, CHANGED | ALWAYS]
[, FUPOPTIONS "fup_options"]
[, QUALEXPR "where <qualexpr>"]
[, GETAUDITED | IGNOREAUDITED]
[, TACLCMD <tacl_command> ]
;
NAME identifier

Optional logical name to be assigned to the DUP. Enclose in quotes if the name contains spaces. If NAME is not specified, the logical name will default to ID_num where num is the ordinal number of the DUP item within the parameter file. The logical name is displayed when Syncfile starts processing a DUP.

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 the INCLUDEFILECODE 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, SAVEALL

You can replace the PURGE and SAVEALL options with others. For example: specifying: FUPOPTIONS "SOURCEDATE, NEW"; results in the command: 

FUP DUP source, target, SOURCEDATE, NEW.
QUALEXPR

QUALEXPR specifies the text for a FUP qualified expression.

The generic fup syntax is: DUP <source> <qualexpr>, <target>, <fupoptions>

FUPOPTIONS and QUALEXPR cannot be passed down through TACLCMD.

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.DUPMAC source 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;