Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
ROUTE
ROUTE
Purpose
The ROUTE command identifies the destination of various outputs produced by Teradata
TPump.
Syntax
.ROUTE
MESSAGES
FILE fileid1
TO
ECHO FILE fileid2
WITH
TO
ECHO OFF
WITH
FILE fileid1
ECHO fileid2
TO
WITH
TO
FILE fileid1
ECHO OFF
TO
WITH
;
3021A031
where
Syntax Element
MESSAGES
fileid1 and fileid2
ECHO
Description
Preferred location where the messages be redirected (normally written to
DDNAME SYSPRINT in z/OS or stdout in UNIX); that is, sent to an
additional destination, or both
Alternate message destination in the external system
UNIX and Windows
Fileid is the path name for a file. If the path name has embedded white
space characters, enclose the entire path name in single or double quotes.
z/OS
A DDNAME. See the z/OS fileid topic in the “Usage Notes” section.
Additional destination, with a fileid specification
Use the ECHO keyword to specify, for example, that messages be captured
in a file (fileid2) while still being written to the terminal.
Note: The ECHO OFF specification cancels the additional file
specification of a previously established ECHO destination.
Usage Notes
In z/OS, fileid is a true DDNAME; and in UNIX, it is a file pathname. If DDNAME is specified,
Teradata TPump writes data records to the specified destination. A DDNAME must obey the
same rules for its construction as Teradata SQL column names except that the “at” sign (@) is
Teradata Parallel Data Pump Reference 179