IBM SC34-4499-03 manual Keywords for a Gather package le, Packageformat gather

(DATA

(PACKAGEFORMAT gather) (TARGETROOT Filename) (RULE

(SOURCE Filename...) (TARGET Path)

[(EXITPRIOR String... EXITREPLACE String... EXITPOST String...)] )

)

.

.

[(EXITPRIOR String...)] [(EXITPOST String...)]

)

Keywords for a Gather package ®le

DATA This keyword is required. It must be the ®rst keyword in the package ®le, and it can be speci®ed only once.

All other keywords are nested within the DATA clause.

PACKAGEFORMAT gather

This keyword is required. It can be speci®ed only once. It tells the teamcpak command that this package ®le is for Gather.

TARGETROOT target_root_path

This keyword is required. It can be speci®ed only once.

Use this keyword to identify the target root directory. Source ®les are copied to this directory as speci®ed by the RULE statements.

Follow these guidelines when you select your TARGETROOT values:

vInclude the drive letter along with the target directory.

vSpecify a directory that contains few if any subdirectories that are unrelated to the data you are moving.

vIf you specify a drive's root directory (drive:\), run the teamcpak command using the defaults or only the -xor -x-a¯ags.

vDo not set the value of TARGETROOT to drive:\ under the following circumstances:

±The TARGETROOT drive is the same as the drive from which the

teamcpak command is run, and you have recovery set (that is, you have not speci®ed-o"-x").

±The logical drive for the TARGETROOT has less than 50% free space, and you have recovery set (that is, you have not speci®ed-o"-x").

RULE This keyword is required. You can use one or more RULE keywords within a Gather package ®le.

Each RULE clause represents a set of Gather operations targeted for one target subdirectory. A RULE clause must contain one SOURCE and one

Chapter 17. Using the Gather tool 209