Teradata Parallel Data Pump

Chapter 3: Teradata TPump Commands
LOGON
Syntax Element
username
password
'acctid'
Description
User identifier of up to a 30-character maximum
Optional password associated with the username, up to a 30-character
maximum
Teradata Database must be configured to recognize the password specified.
Optional account identifier associated with the username, up to a 30-character
maximum
The string specification must be enclosed in single quotes.
If this field is not specified, a default “acctid” is used.
Usage Notes
Both the LOGON command and the LOGTABLE command are required to set up the
Teradata TPump support environment. Use them in any order, but they must precede any
other commands. However, a RUN FILE command can be used to identify a file containing
the LOGON command before the LOGON and LOGTABLE commands.
LOGON and LOGTABLE commands typically occur as:
.logtable logtable001;
.logon tdpx/me,paswd;
When the LOGON command is executed, the initial Teradata TPump utility session is logged
on. The logon information is saved and re-used when processing the BEGIN LOAD command
to connect the appropriate number of sessions.
The parameters (tdpid, username, password, and “acctid”) are optional and are used in all
sessions established with Teradata Database. The LOGON command may only occur once.
The period (.) preceding LOGON is also optional.
The tdpid identifier specifies a particular Teradata Database. See the system or site
administrator for the identifier planned to use. If a tdpid is not specified and the site
administrator has not updated the System Parameter Block, the default identifier is Teradata
Database. The long form of this parameter, tdpx, should be used to avoid CLI errors that can
occur when the short form is used.
The tdpid parameter is optional if the site has only one TDP, if a TDP command was
previously executed, or if the default TDP was selected. This parameter is not case-sensitive.
Teradata TPump does not prompt for a username or password. If either or both of these are
required, Teradata TPump fails and reports the error. Both of these parameters may be
optional if a logon exit is used.
Where possible, do not use special characters in the acctid parameter string. Although acctid
may contain special characters, the special characters might be interpreted differently by
different output devices. Therefore, a script containing special characters might have to be
modified if the output is routed to another device. If the acctid contains an apostrophe (single
quote) character, use either the second form of the LOGON command, which is delimited by
quotes, or double the apostrophe character as follows:
168 Teradata Parallel Data Pump Reference