Purpose
Returns a fixed character string to the requestor.
Syntax
Syntax Elements
- string
- Text to be returned to the requestor.
- command
- A BTEQ format command to be returned to the requestor. The format command must be terminated by a semicolon.
ANSI Compliance
ECHO is a Teradata extension to the ANSI SQL:2011 standard.
Required Privileges
None.
ECHO Not Supported for Embedded SQL
The Teradata preprocessor does not support ECHO.
ECHO Not Supported for SQL Procedures
SQL procedures do not support ECHO.
How ECHO Works
When the system encounters an ECHO request, it sends an ECHO parcel containing string to the client system, where it is then interpreted.
ECHO and BTEQ
ECHO is used most frequently in macros to perform BTEQ commands during macro execution.
ECHO cannot be used with the following BTEQ commands.
- =
- EXPORT
- IMPORT
- LOGOFF
- LOGON
- QUIT
- REPEAT
- RUN
If command is not a BTEQ format command, BTEQ logs the illegal command as an error.
Example: ECHO
The following ECHO request could be used in a macro that creates a report through BTEQ. When the system encounters the request during macro execution, the width of a printed page is set to 72 characters.
... ECHO 'SET WIDTH 72;'...