Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
IMPORT
Syntax Element
INFILE filename
HOLD
FREE
INMOD
modulename
Description
Fully qualified UNIX or Windows path name for an input file on networkattached
client systems
If the path name has embedded white space characters, the entire path name
must be enclosed in single or double quotes.
To specify the INFILE filename, the data is read from the specified source. To
specify the INMOD modulename, the data is passed to the specified module.
Default condition to not deallocate the input tape device specified by ddname
when the import operation completes on channel-attached client systems
Instead, the HOLD specification deallocates the device when the entire
Teradata TPump operation completes.
Deallocation of the tape input device specified by ddname when the import
operation completes on channel-attached client systems
When de-allocated, any attempt to open the input device, either in the same
Teradata TPump utility task or in another task within the same script,
produces an undefined ddname error.
The default is to not deallocate the device.
Optional user-written routine for preprocessing the input data
In z/OS, the modulename is the name of a load module. In UNIX and
Windows, it is the pathname for the INMOD executable code file.
The modulename must obey the applicable rules of the external system.
A modulename must obey the same construction rules as Teradata SQL
column names except that on channel-attached client systems:
• The “at” character (@) is allowed as an alphabetic character
• The underscore character (_) is not allowed
When both the INFILE fileid and the INMOD modulename parameters are
specified, the input file is read and the data is passed to the INMOD routine
for preprocessing.
If the INFILE fileid parameter is not specified, the INMOD routine must
provide the input data record.
Note: When an INMOD routine is used with the INFILE specification,
Teradata TPump performs the file read operation, and the INMOD routine
acts as a pass-through filter.
Because the FDL-compatible INMOD routine must always perform the file
read operation, an FDL-compatible INMOD routine cannot be used with the
INFILE specification of a Teradata TPump IMPORT command.
Note: On some versions of UNIX, ./ prefix characters may have to be added
to the modulename specification if the module is in the current directory.
Teradata Parallel Data Pump Reference 149