File Utility Programming (FUP) Reference Manual

FUP Commands
File Utility Program (FUP) Reference Manual—523323-015
2-73
DUP[LICATE] Guidelines for Safeguard Files

Transfer the CLEARONPURGE attribute (for more information, see SECURE
on page 2-172) to a local or remote target file. The target file does not need to
be on the node where FUP is running. To restore the CLEARONPURGE
attribute, use a SECURE command.

When DUP encounters a broken file, the broken flag is duplicated, and this
warning message appears:
filename: FILE IS BROKEN

When an SQL object file is duplicated, the expiration date (NOPURGEUNTIL) is
not preserved. The expiration date is set by either the NOPURGEUNTIL option of
the FUP ALTER command or by the SQLCI NOPURGEUNTIL attribute.

You can use the DUP command on queue files. For example, to increase the size
of the queue files:
-DUP oldqueuefile, newqueuefile [EXT (pri-extent-size, sec-
extent-size)] [SAVEALL]
You cannot use DUP to increase MAXEXTENTS. To alter the MAXEXTENTS of a
file, use the FUP ALTER command.

The maximum number of files in fileset-list that can be duplicated at a time is
2,147,483,647.

The restart file created by H01 version of FUP cannot be used with H02 version of
FUP and vice versa.

DUP command duplicates a key-sequenced file with increased limits with all the
increased limits.

For a key-sequenced file with increased limits (EKS file with increased limits),
specify sec-partition-number as an integer from 1 through 127.

DUP command when executed with from-fileset-list as a primary partition
name of a key-sequenced file with increased limits (EKS file with increased limits)
and PARTONLY option, duplicates the primary partition.

DUP command transfers data up to 56 KB over EXPAND after configuring
NETBLOCKSIZE option to 56.
DUP[LICATE] Guidelines for Safeguard Files

To duplicate a Safeguard protected file, you must have read access to the input file
(from-fileset-list) and create access to the destination volume and
subvolume (to-fileset).

Unless you have create access (using Safeguard) to it, the target file is not created
successfully. If you run a DUP command with the PURGE option but do not have
create access to the target file, the original file is purged, and the target file is not
created.