IBM SC34-4499-03 Examples of the teamcpak gather command, Syntax rules for a Gather package le

Examples of the teamcpak gather command

The following are examples of the teamcpak gather command.

teamcpak gather d:\demoapp demoapp.pkf

teamcpak gather a.exe b.exe \help\*.hlp demoapp.pkf

In the ®rst example, an input source directory is speci®ed. In the second example, a list of ®les is speci®ed. In both cases, the ®les are to be copied into target directories as speci®ed in the demoapp.pkf ®le.

teamcpak -i -o " -t -m -x" gather myfiles.lst

The ®le my®les.lst contains a list of ®les to be transformed by the Gather tool, and the name of the package ®le to be used in the gather. The-o"-t-m-x"parameter passes three ¯ags to the Gather tool:

v-tspeci®es that, if the target directories already exist, they be destroyed and recreated.

v-mspeci®es that processing continues even if a source ®le cannot be found.

v-xspeci®es that, if the program does not end successfully, the ®le system is left as is, with no attempt to restore it.

Writing a package ®le for the Gather tool

Use the package ®le to specify the target directories and the rules for copying ®les for a gather operation. You can also specify user exit programs to run before, during, or after the gather operation.

A sample package ®le named gather.pkf is shipped with TeamConnection. You can customize it for your own gather operations.

Syntax rules for a Gather package ®le

Follow these syntax rules when you write a package ®le:

vPackage ®les are free format. Text is not positional, and many statements can exist on the same line.

vComments can appear anywhere within the ®le. Use the characters# and # as delimiters, as shown in the following example:

# This is a comment #

vPackage ®le keywords must be pre®xed with a left parenthesis and must have a corresponding balanced right parenthesis to end the scope of the keyword.

vIf the value for a keyword is a string that contains blanks or parentheses, enclose the string in double quotes.

The following shows the syntax of a package ®le for the Gather tool. Keywords must appear in the order shown. The ®rst letter of an argument is capitalized; you must supply these values.

208User's Guide