Chapter 17. Using the Gather tool

The Gather tool automates the movement of software and data from one directory to another on the same machine to prepare a package for electronic distribution. It can copy or erase ®les; it can create or delete directories.

This tool takes a list of input ®les and moves them into a directory structure as directed by a package speci®cation ®le. You specify the target root directory path in this ®le, along with a collection of rules that instruct which ®les to copy to which directories. How these ®les and directories are actually handled is controlled via option ¯ags.

By writing different package speci®cation ®les, you can take the same input ®les and transfer them into different target directory structures.

Take the robot application as an example. We previously showed one possible directory structure, with each subdirectory containing ®les with the same extension:

e:\robot

\dll

hand.dll

optics.dll

\exe

hand.exe

optics.exe

By writing a different package ®le, you might put both .dll and .exe ®les in the same target directory:

f:\robot

\bin

hand.dll

optics.dll

hand.exe

optics.exe

You can build both target directories concurrently.

Using the teamcpak command for the Gather tool

To start the Gather tool, use the teamcpak command. This command is found in the directory where the TeamConnection family server is installed. If it is started from a build script, it does not need to be in the execution path of the machine from which the build is started.

The complete command syntax for teamcpak gather looks like the following; you must supply a value for the words that start with a capital letter, such as String. You must specify the command parameters in the order shown.

© Copyright IBM Corp. 1992, 1995, 1996, 1997, 1998

205

Page 225
Image 225
IBM SC34-4499-03 manual Using the Gather tool, Using the teamcpak command for the Gather tool, 205