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> ]
;<!--Draft comment: Anuradha Chepuri <br/>OGN - 3891 - April 2025 - updated new syntax for DUP. Added QUALEXPR below.--><!--Draft comment: Anuradha Chepuri <br/>Removing this as per new syntax.<dl><dt class="dlterm">***source_file_set***</dt><p><p>Required. Identifies the source file set. You can use standard wildcards.</p></p><dt class="dlterm">**TARGET *target_file_set***</dt><p><p>Required. Identifies the target file set. You can use standard wildcards.</p></p><dt class="dlterm">**EVENT *event_name***</dt><p><p>Required. Specifies an event that has been defined by the <code class="codeph">EVENT</code> parameter. You can specify multiple events as: </p><pre class="oac_no_warn" dir="ltr">EVENT *event_name*, EVENT *event_name*,...</pre></p> </dl>-->

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

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

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;