TD

Teradata DBMS
Quick Reference Guide

Version 2 Release 5.0
December 2002
Syntax Conventions ..................
Teradata SQL Statements .............
Teradata SQL Statement Modifiers .... 16

Teradata Stored Procedure Language .. 17
BTEQ Commands ....................... 19
PreProcessor 2 Statements ........... 24
Archive / Recovery Commands ......... 27
Fastload Utility Commands ........... 32
Multiload Utility Commands .......... 34
Data Dictionary Views ............... 37
Builtin Values and Functions ........ 45
Maximum Limits for Teradata DBMS .... 48
Manual Names and Numbers ............ 49
TDP Operator Commands ............... 51
Console Operator Commands
.........
55
Copyright 1989-2003, NCR Corporation, Dayton, Ohio, USA. All rights reserved.
SYNTAX CONVENTIONS
Uppercase characters indicate keywords.
Lower case characters indicate that a value or name is to be substituted in their

place.
Underscores indicate the default value.
Special characters, including blanks, are required as shown unless specified

otherwise.
Braces {} indicate a choice of options; one of these choices must be entered.
A vertical bar | indicates alternatives (same as braces, but on one line)
Brackets [] indicate an optional entry.
Horizontal ellipses indicate a phrase that can be repeated.
Vertical ellipses indicate omitted portions of the statement or command.
Page 2
Teradata DBMS Quick Reference Guide
TERADATA SQL STATEMENTS
SQL statements are listed alphabetically. Defaults are underscored.

ABORT ['msgtext'] [FROM tname] [WHERE cond]
ALTER TABLE [dbname.]tname [,option [... ,option] ]

[
[
[
[
{
{ ADD
{
{
{
{datadesc }
{ cname {constraint}
{
{NULL
}
{ [CONSTRAINT name] constraint
}
}
}
}
}
}
}
}
]
]
]
]
[ { ADD RANGE BETWEEN range [..., range] [,NOT IN RANGE [OR UNKNOWN]] [,UNKNOWN]
} ]
[
[
[
[
}
}
}
}
{
{ cname
{ DROP { [cname
] constraint
{
{ [CONSTRAINT name]
{
{ INCONSISTANT REFERENCES
}
}
}
}
]
]
]
]
[ { DROP RANGE { WHERE expr [..., expr]

}
} ]
{ BETWEEN range [..., range] }[,NOT IN RANGE [OR UNKNOWN]] [,UNKNOWN]
[ { MODIFY {cname
} CHECK expr
[ {
{CONSTRAINT name}
} ]
} ]
[ { MODIFY [UNIQUE] PRIMARY INDEX [idxname | (cname [..., cname])]

{ NOT PARTITIONED
}
{ PARTITION BY partexpr [WITH {DELETE | INSERT [INTO] tname}] }
} ]
[ { RENAME {cname
} TO name
[ {
{CONSTRAINT name}
} ]
} ]
[ { REVALIDATE PRIMARY INDEX [WITH {DELETE | INSERT [INTO] tname}]
} ]
Any of the following options may be listed in any order:

[NO] FALLBACK [PROTECTION]
[NO ]
[
] [BEFORE] JOURNAL
[DUAL]
[ [NO
]
]
[ [DUAL
] AFTER JOURNAL ]
[ [[NOT] LOCAL]
]
WITH JOURNAL TABLE = [dbname.] tname

[ FREESPACE = n [PERCENT] ]
[ DEFAULT FREESPACE
]
[
[
[
[
[
[
[ BYTES
] ]
DATABLOCKSIZE = n [ KBYTES
] ]
[ KILOBYTES ] ]
{ MINIMUM }
] [ IMMEDIATE ]
{ MAXIMUM } DATABLOCKSIZE
]
{ DEFAULT }
]
The following options apply to Temporary tables only:

[NO] LOG
ON COMMIT { DELETE | PRESERVE } ROWS
Page 3
ALTER TRIGGER [dbname.]name {DISABLED}

{ENABLED }
BEGIN INDEX ANALYSIS [ ON tname [..., tname] ] FROM workloadname INTO qcdname
[ AS indextag ]
{
{
{
[ SET MAXIMUM {
{
{
{
Indexes Per Table

Tables Per Request
Search Space
Change Rate
Columns Per Index
NUSI Selectivity
VOSI Typical Percent
}
}
}
} = n
}
}
}
[ ... ] ] ;
only INSERT EXPLAIN NEW INDEX statements may be used here

END INDEX ANALYSIS;
BEGIN INSERT WORKLOAD INTO qcdname AS workloadname ;

only INSERT EXPLAIN statements may be used here
END WORKLOAD;
[FIRST
] {ALL
}
{BEGIN} LOGGING [DENIALS] [WITH TEXT] ON [LAST
] {GRANT
}
{END }
[FIRST AND LAST] {priv [... ,priv]}
[EACH
]
{
{
[ BY userid [... ,userid] ] [ ON {
{
{
DATABASE dbname
USER
userid
TABLE [dbname.]name
VIEW [dbname.]name
MACRO [dbname.]name
}
}
} ]
}
}
{BEGIN} QUERY LOGGING on ***TODO***

{ END }
{ BEGIN TRANSACTION }
{ BT
} ; statement; [... statement;]
{ END TRANSACTION }
{ ET
};
CALL [dbname.]tname ( [parm [(attributes)] [... ,parm [(attributes)] ] ] )
CHECKPOINT tname [ ,NAMED chkptname ]
COLLECT { STAT[ISTICS] | STATS } [ FOR SAMPLE percent [ PERCENT ] INTO qcdname ]

[ COLUMN cname
]
[ON] [TEMPORARY] tname [ INDEX name
]
[ INDEX (cname [... ,cname] ) ]
[ DATABASE ]
[ USER
]
[ TABLE
]
Page 4
[ [ AS ]
COMMENT [ON] [
[
[
[
VIEW
MACRO
COLUMN
TRIGGER
] objname
]
]
]
[ [
] 'string' ]
[ [ IS ]
]
COMMIT [WORK]
Page 5
{ CREATE DATABASE }
{
} dbname [FROM ownerdb]
{ CD
}
AS PERM[ANENT] = n [BYTES]
[ [,] option [... [,] option] ]
SPOOL = n [BYTES]
TEMPORARY = n [BYTES]
ACCOUNT = 'acctid'
[NO ]
[
] [BEFORE] JOURNAL
[DUAL]
[ [NO
]
]
[ [DUAL
] AFTER JOURNAL ]
[ [[NOT] LOCAL]
]
DEFAULT JOURNAL TABLE = [dbname.]tname
CREATE [UNIQUE] INDEX [name] [ALL] (cname [... ,cname ] )

{VALUES (cname)}
[ ORDER BY {HASH
(cname)} ]
{
(cname)}
[ ... [UNIQUE] INDEX [name] (cname [... ,cname ] ) ]
ON [TEMPORARY] tname
CREATE HASH INDEX name (cname [... ,cname ])

ON tname
BY (cname)
ORDER BY HASH (cname)
CREATE JOIN INDEX name [, FALLBACK] AS
SELECT
{
{
{
{
{
{ cname
{ SUM
(cname) AS
{ COUNT
(cname) AS
{ EXTRACT (YEAR FROM
(cname [..., cname])
}
}
alias
}
}
alias
} [..., cname ] }
datecol) AS alias }
}
, (cname [..., cname])
}
FROM
{ tname [[AS] aname ] [..., tname [[AS] aname ]]

{
{
[
INNER ]
{ tname [ LEFT [OUTER] ] JOIN tname [ON cond]
{
[ RIGHT [OUTER] ]
}
}
}
}
}
[ WHERE cond ]
[ GROUP BY (cname [..., cname]) ]
[ ORDER BY (cname) ]
[ PRIMARY INDEX [idxname] (cname [..., cname ] ) ] [ ORDER BY [HASH ] [(cname)] ]
[VALUES]
[ INDEX [idxname] [ALL]
Page 6
(cname [..., cname ] ) ] [ ORDER BY [HASH ] [(cname)] ]

[VALUES]
{ CREATE MACRO }
} macroname
{ CM
}
[ (pname datadesc [... ,pname datadesc ] ) ]
AS
( [USING clause] [LOCKING clause] statement; [... statement; ] )
CREATE PROFILE name [ AS option [ ... ,option ] ]

{ 'accountid'
}
ACCOUNT = { ('accountid' [ ... , 'account id' ]) }
{ NULL
}
DEFAULT DATABASE = { databasename | NULL }
SPOOL = { n [BYTES] | NULL }
TEMPORARY = { n [BYTES] | NULL }
PASSWORD [ATTRIBUTES] = { (attrib = val | NULL, [ ... ,attrib = val | NULL ]) | NULL
}
where attrib is one of the following, in any order:
EXPIRE = n
MINCHAR = n
MAXCHAR = n
DIGITS = Y | N
SPECCHAR = Y | N
MAXLOGONATTEMPTS = n
LOCKEDUSEREXPIRE = n
REUSE = n
(0 to 32767)
(1 to 30)
(1 to 30)
(0 to 256)
(-1 to 32767)
(0 to 32767)
{ [IN] }
{ [IN] }
CREATE PROCEDURE pname ( [ { OUT } vname vtype ] [... , { OUT } vname vtype] )
{ INOUT }
{ INOUT }
[label:] BEGIN [[NOT] ATOMIC]
[ variable declarations ]
[ error handler ]
SPL Statement; [... , SPL Statement;]
END [label] ;
CREATE ROLE rolename ;
[SET
] [VOLATILE
]
CREATE [MULTISET] [GLOBAL TEMPORARY] TABLE tname [,option [... ,option] ]
( cname Datadesc [ColumnConstraint] [... , cname Datadesc [ColumnConstraint] ]
[ , TableConstraint ] [... , TableConstraint]
)
[ [UNIQUE] PRIMARY INDEX [name] ( cname [... ,cname]) [PARTITION BY partexpr] ]
[ ... [,] [UNIQUE] INDEX [name] ( cname [... ,cname] ) ]
{[VALUES]
}
[ ... [,] INDEX [name] ( cname [... ,cname] ) ORDER BY {[HASH ] (cname) } ]
[ON COMMIT { DELETE
} ROWS ]
Page 7
{ PRESERVE }
Page 8
Applies to Temporary tables only

[NO ]
[
] [BEFORE] JOURNAL
[DUAL]
[ [NO
]
]
[ [DUAL
] AFTER JOURNAL ]
[ [[NOT] LOCAL]
]
WITH JOURNAL TABLE = [dbname.]tname

FREESPACE = n [PERCENT]
[
[ BYTES
] ]
[ DATABLOCKSIZE = n [ KBYTES
] ]
[
[ KILOBYTES ] ] [ IMMEDIATE ]
[ { MINIMUM }
]
[ { MAXIMUM } DATABLOCKSIZE
]
Applies to Temporary tables only
[NO] LOG
TableConstraint can be any of the following:
[CONSTRAINT name] {PRIMARY KEY} (cname [... ,cname])

{UNIQUE
}
[CONSTRAINT name] CHECK (expr operator expr)
[CONSTRAINT name] FOREIGN KEY ( cname [... ,cname] )
REFERENCES [dbname.]tname [( cname [... ,cname] )]
ColumnConstraint can be any of the following:
[CONSTRAINT name] {PRIMARY KEY}
{UNIQUE
}
[CONSTRAINT name] CHECK (expr operator expr)
[CONSTRAINT name] REFERENCES [dbname.]tname [( cname [... ,cname] )]
Datadesc consists of a Data Type and additional optional phrases:
Data Types:
BYTEINT
DECIMAL(n [,m])
CHAR(n)
BYTE(n)
GRAPHIC(n)
TIMESTAMP[(n)]
SMALLINT
NUMERIC(n [,m])
VARCHAR(n)
VARBYTE(n)
VARGRAPHIC(n)
TIME[(n)]
INTEGER
FLOAT [(n)]
DATE
REAL [(n)]
LONG VARCHAR
CHAR VARYING(n)
DOUBLE PRECISION
LONG VARGRAPHIC
INTERVAL type[n] [TO type[n]]
Optional phrases (general):

NOT NULL
FORMAT
TITLE
NAMED
'string'
'string'
name
COMPRESS {value | NULL }

[ DEFAULT {value | NULL | USER | DATE | TIME} ]
[ WITH DEFAULT
]
Optional phrases (character columns only):
UPPERCASE | UC
[NOT] CASESPECIFIC | CS
CHARACTER SET { LATIN | UNICODE | KANJISJIS | GRAPHIC | KANJI1 }
Page 9
[SET
] [VOLATILE
]
CREATE [MULTISET] [GLOBAL TEMPORARY] TABLE tname [,option [... ,option] ]
AS { [dbname.]tname
} WITH [NO] DATA
{ (select statement) }
{BEFORE
} {DELETE
}
CREATE TRIGGER name [ENABLED ] {AFTER
} {INSERT
}
[DISABLED] {INSTEAD OF} {UPDATE [OF (cname [, cname])] }
ON [dbname.]tname [ORDER integer]
[ [ REFERENCING OLD
[AS] name NEW
[AS] name ] FOR EACH ROW
]
[ [ REFERENCING OLD TABLE [AS] name NEW TABLE [AS] name ] FOR EACH STATEMENT ]
[ WHEN condition ]
( command; [..., command;])
CREATE USER username [FROM ownerdb]

AS PERM[ANENT] = n [BYTES] [,] PASSWORD = { NULL }
{ name }
[ [,] option [... [,] option] ] ;
SPOOL = n [BYTES]
STARTUP = 'string;'
{ 'acctid'
}
ACCOUNT = {
}
{ ('acctid' [... ,'acctid'] ) }
DEFAULT DATABASE = dbname
[NO ]
[
] [BEFORE] JOURNAL
[DUAL]
[ [NO
]
]
[ [DUAL
] AFTER JOURNAL ]
[ [[NOT] LOCAL]
]
DEFAULT JOURNAL TABLE = [dbname.]tname

COLLATION = { ASCII | EBCDIC | MULTINATIONAL | HOST | CHARSET_COLL | JIS_COLL }
DATEFORM
= { ANSIDATE | INTEGERDATE }
TIME ZONE = { LOCAL | NULL | [-] hh:mm }

DEFAULT CHARACTER SET { LATIN | UNICODE | KANJISJIS | GRAPHIC | KANJI1 }
{ CREATE VIEW }
} viewname [ (cname [... ,cname] ) ] AS
{ CV
}
[LOCKING clause] SELECT statement [GROUP BY clause] [HAVING clause]
Page 10
[WITH CHECK OPTION] [ORDER BY clause]

Note - no WITH clause is allowed on the select statement.
DATABASE dbname
DEL[ETE] FROM tname [[AS] aname]]
[ WHERE cond ]
[
]
[ ALL
]
{ DATABASE }
DEL[ETE] {
} name [ALL]
{ USER
}
{DUMP COSTS
DIAGNOSTIC {HELP COSTS
{SET
sysname [comment]
}
}
{ NOT }
{REQUEST}
COSTS {sysname} ON FOR {SESSION} }
{ TPA }
{SYSTEM }
DIAGNOSTIC ValidateIndex ON FOR SESSION;

only CREATE INDEX and COLLECT STATISTICS statements may be used here
DIAGNOSTIC ValidateIndex NOT ON FOR SESSION;
{
{
{
DROP {
{
{
{
{
DATABASE
}
JOIN INDEX
}
MACRO
}
PROCEDURE
} name
[TEMPORARY] TABLE }
TRIGGER
}
USER
}
VIEW
}
DROP INDEX [ALL] { ( cname [... ,cname ] ) }

{ IdxName
}
[ ORDER BY {VALUES} ] ON [TEMPORARY] tname
{HASH }
[ COLUMN cname
]
DROP STATISTICS [FROM qcdname] [ON] [TEMPORARY] tname [ INDEX IdxName
]
[ INDEX(cname [... ,cname] ) ]
{ 'string' }
ECHO {
}
{ 'command' }
Page 11
[ (expr [... ,expr ] )

]
[
]
[ (pname=expr [... ,pname=expr ] ) ]
EXEC[UTE] macroname
GIVE name TO recipientname
{ ALL [PRIVILEGES]
}
GRANT { privilege [... ,privilege ]
}
{ ALL BUT privilege [... ,privilege] }
{ dbname
}
{ [ALL] name [... ,[ALL] name] }
[ ON { dbname.objname } ] TO {
}
{ objname
}
{ PUBLIC
}
[WITH GRANT OPTION]
GRANT rolename [ ..., rolename ] TO user [ ..., user ] [WITH ADMIN OPTION]
{ MONITOR [ PRIVILEGES ]
}
GRANT { monpriv [ ..., monpriv ]
}
{ MONITOR BUT NOT monpriv [ ..., monpriv ] }
TO [ALL] name [ ..., [ALL] name ] [WITH GRANT OPTION]
{ hostid [... ,hostid] }

GRANT LOGON ON {
}
{
ALL
}
{
AS DEFAULT
}
{
} [WITH NULL PASSWORD]
{ TO username [... ,username] }
{
COLUMN
{
COLUMN
{
COLUMN
{
COLUMN
{
CONSTRAINT
{
DATABASE
{ [TEMPORARY] INDEX
{ [TEMPORARY] INDEX
HELP {
JOIN INDEX
{
MACRO
{
PROCEDURE
{
SESSION
{
{ [TEMPORARY] STATISTICS
{
{
TABLE
{
TRIGGER
{
VIEW
{
VOLATILE
{
USER
{ ARCHIVE
{ BULKLOAD
Page 12
cname [... ,cname] FROM tname [... ,tname ]

* FROM [dbname.]tname [... ,tname]
[dbname.]tname.cname [... ,tname.cname]
[dbname.]tname.*
[dbname.]tname
dbname
[dbname.]tname [(cname [... ,cname]) ]
[dbname.]idxname
[dbname.]idxname
[dbname.]macroname
[dbname.]tname [ATTR[IBUTES]]
}
}
}
}
}
}
}
}
}
}
}
}
[FROM
qcdname
]
[USING SAMPLE] tblname [COLUMN cname
]
[INDEX (cname [..., cname])]
[dbname.]tblname
}
[dbname.]trigname
}
[dbname.]viewname
}
TABLE
}
username
}
}
}
}
}
}
{
{
{
HELP ' {
{
{
{
{
{
DUMP
FASTLOAD
FASTEXPORT
HELP
MULTILOAD
PMPC
SPL
SQL
TPCCONS
}
}
}
} [ CommandName ] '
}
}
}
}
}
Page 13
{
[VALUES] (expr [... ,expr] )
INS[ERT] [INTO] tname {
(cname [... ,cname]) VALUES (expr [... ,expr] )
{ [ (cname [... ,cname]) ] subquery
}
{ DEFAULT VALUES
}
}
}
MODIFY DATABASE dbname

AS option [... [,] option ] ;
PERM[ANENT] = n [BYTES]
SPOOL = n [BYTES]
ACCOUNT = 'acctid'
[NO ]
[
] [BEFORE] JOURNAL
[DUAL]
[ [NO
]
]
[ [DUAL
] AFTER JOURNAL ]
[ [[NOT] LOCAL]
]
[DEFAULT JOURNAL TABLE = [dbname.]tname ]

[
]
[DROP DEFAULT JOURNAL TABLE [= tname]
]
MODIFY PROFILE name [ AS option [ ... ,option ] ]

{ 'accountid'
}
ACCOUNT = { ('accountid' [ ... , 'account id' ]) }
{ NULL
}
DEFAULT DATABASE = { databasename | NULL }
SPOOL = { n [BYTES] | NULL }
TEMPORARY = { n [BYTES] | NULL }
PASSWORD [ATTRIBUTES] = { (attrib = val | NULL, [ ... ,attrib = val | NULL ]) | NULL
}
where attrib is one of the following, in any order:
EXPIRE = n
MINCHAR = n
MAXCHAR = n
DIGITS = Y | N
SPECCHAR = Y | N
MAXLOGONATTEMPTS = n
LOCKEDUSEREXPIRE = n
REUSE = n
Page 14
(0 to 32767)
(1 to 30)
(1 to 30)
(0 to 256)
(-1 to 32767)
(0 to 32767)
MODIFY USER username

AS option [... [,] option ] ;
PERM[ANENT] = n [BYTES]
PASSWORD = { name | NULL }
SPOOL = n [BYTES]
STARTUP = { 'string' | NULL }
{ 'acctid'
}
ACCOUNT = {
}
{ ('acctid' [... ,'acctid'] ) }
DEFAULT DATABASE = dbname
[NO ]
[
] [BEFORE] JOURNAL
[DUAL]
[ [NO
]
]
[ [DUAL
] AFTER JOURNAL ]
[ [[NOT] LOCAL]
]
[DEFAULT JOURNAL TABLE = [dbname.]tname ]

[
]
[DROP DEFAULT JOURNAL TABLE [= tname]
]
RELEASE PASSWORD LOCK
COLLATION = { ASCII | EBCDIC | MULTINATIONAL | HOST | CHARSET_COLL | JIS_COLL }
DATEFORM
= { ANSIDATE | INTEGERDATE }
TIME ZONE = { LOCAL | NULL | [-] hh:mm }

DEFAULT CHARACTER SET { LATIN | UNICODE | KANJISJIS | GRAPHIC | KANJI1 }
{
RENAME {
{
{
{
MACRO
PROCEDURE
TABLE
TRIGGER
VIEW
}
} oldname { TO } newname
}
{ AS }
}
}
REPLACE MACRO macroname

[ (pname datadesc [... ,pname datadesc ] ) ]
AS
( [USING clause] [LOCKING clause] statement; [... statement; ] )
Page 15
{ [IN] }
{ [IN] }
REPLACE PROCEDURE pname ( [ { OUT } vname vtype ] [... , { OUT } vname vtype] )
{ INOUT }
{ INOUT }
[label:] BEGIN [[NOT] ATOMIC]
SPL Statement; [... , SPL Statement;]
END [label:] ;
{ BEFORE
} { DELETE
}
REPLACE TRIGGER name [ENABLED ] { AFTER
} { INSERT
}
[DISABLED] { INSTEAD OF } { UPDATE [OF cname [..., cname]] }
ON [dbname.]tname
[ ORDER integer ]
[ [ REFERENCING OLD
[AS] name NEW
[AS] name ] FOR EACH ROW
]
[ [ REFERENCING OLD TABLE [AS] name NEW TABLE [AS] name ] FOR EACH STATEMENT ]
[ WHEN condition ]
( command; [..., command;])
REPLACE VIEW
viewname
[ (cname [... ,cname] ) ] AS
[LOCKING clause] SELECT statement

[WITH CHECK OPTION]
Note - no WITH clause is allowed on the select statement.
{ ALL [PRIVILEGES]
}
REVOKE [GRANT OPTION FOR] { privilege [... ,privilege]
}
{ ALL BUT privilege [... ,privilege] }
{ dbname
} {FROM} { [ALL] name [... ,[ALL] name] }
ON { dbname.objname } {
} {
}
{ objname
} { TO } { PUBLIC
}
{ MONITOR [ PRIVILEGES ]
}
REVOKE [GRANT OPTION FOR] { monpriv [ ..., monpriv ]
}
{ MONITOR BUT NOT monpriv [ ..., monpriv ] }
{ FROM } [ALL] name [ ..., [ALL] name ]
{ TO }
{ hostid [... ,hostid] } { AS DEFAULT

}
REVOKE LOGON ON {
} { {FROM} name [... ,name] }
{
ALL
} { { TO }
}
ROLLBACK [WORK] ['msgtext'] [FROM tname [ ..., tname ]] [WHERE cond ] ;
Page 16
[ALL
] { *
}
SEL[ECT] [
] { expr [[AS] name] [... ,expr [[AS] name] ] }
[DISTINCT] { tname.*
[... ,tname.*
] }
[
[
[
[
FROM [
[
[
[
[
[
tname [[AS] aname] ]
]
]
{
[INNER] }
]
{ LEFT [OUTER] }
]
tname { RIGHT [OUTER] } JOIN tname ON [cond] ] [... ,tname ... ]
{ FULL [OUTER] }
]
]
tname CROSS JOIN tname
]
]
(subquery) [AS] aname ([cname] [... ,cname]) ]
[WHERE
{
{
{
{
{
{
{
{ expr
} {operator} [ANY ]
}
{
} {IN
} [SOME] subquery }
{(expr [...,expr])} {NOT IN } [ALL ]
} [... OR cond]
}
]
[NOT] EXISTS subquery
} [... AND cond]
}
comparison
}
{ cname
}
{ cname
}
[GROUP BY {
} [... , {
} ] ]
{ col-pos }
{ col-pos }
{ cname
} [ASC ]
[ORDER BY {
} [
]
{ col-pos } [DESC]
[HAVING
cond ]
[QUALIFY
cond ]
[SAMPLE
n [... , n] ]
{ cname } [ASC ]
[... ,{
} [
] ] ]
{ col-pos} [DESC]
[WITH expr [... , expr] [ BY expr [... , expr] ] ]
SET SESSION ACCOUNT acct-id FOR { SESSION | REQUEST }
[
{ SET SESSION }
[
{
} COLLATION [
{ SS
}
[
[
[
ASCII
EBCDIC
MULTINATIONAL
HOST
CHARSET_COLL
JIS_COLL
]
]
]
]
]
]
SET SESSION DATEFORM = { ANSIDATE | INTEGERDATE }
{
SET SESSION EXPORT FOR {
{
{
LATIN1
UNICODE
KANJISJIS
GRAPHIC
}
} { DEFAULT }
} { n
}
}
SET SESSION OVERRIDE REPLICATION { ON | OFF }
Page 17
{ LOCAL
}
SET TIME ZONE { USER
}
{ INTERVAL [-] hh:mm HOUR TO MINUTE }
{
{
SHOW {
{
{
{
SHOW
JOIN INDEX
MACRO
PROCEDURE
TABLE
TRIGGER
VIEW
}
}
} name
}
}
}
dml-statement
UPD[ATE] tname [[AS] aname]

[ FROM
SET
tname [[AS] aname] [... ,tname [[AS] aname] ] ]
cname = expr [... , cname = expr]
[ WHERE cond ]
[
] ;
[ ALL
]
UPDATE tname
SET cname = expr [... , cname = expr]
[ WHERE cond ]
ELSE
INSERT INTO tname [ (colname [... , colname] ) ]
VALUES (expr [... , expr])
Page 18
SQL STATEMENT MODIFIERS

The following modifiers can be used with any SQL statement.
Note - To use ROW locking, the statement must be a SELECT statement that uses a UNIQUE index.
(Preparing for an UPDATE of that row)
EXPLAIN statement
DUMP EXPLAIN
INTO qcdname [ AS queryname ] statement
INSERT EXPLAIN [WITH [NO] STAT[ISTICS] [AND DEMOGRAPHICS] FOR (tname [...,
tname]]) ]
INTO (qcdname) [ AS (queryname) ]
[ LIMIT [ SQL [ = n] ] ]
[ FOR (frequency) ] statement
INSERT EXPLAIN NEW INDEX { FOR queryid | ALL }
{
LOCK[ING] {
{
{
[DATABASE] dbname
[TABLE] tname
[VIEW] vname
ROW
USING ( name datadesc
<== only valid after BEGIN INDEX ANALYSIS
{ ACCESS
} [FOR] { EXCL[USIVE]
} [
] { SHARE
} [IN ] { READ
}
{ WRITE
}
}
} [MODE] [NOWAIT] statement
}
}
[... ,name datadesc ] ) request
Page 19
STORED PROCEDURE LANGUAGE
SPL statements are listed alphabetically. Variables used within SQL statements must be prefixed by a semi-colon.
The following system variables may be referenced:
SQLCODE
SQLSTATE
ACTIVITY_COUNT
CALL [dbname.]procname (arg [... ,arg])
CASE
expr
WHEN val THEN
statement; [... statement;]
[ WHEN val THEN
statement; [... statement;] ] ...
[ ELSE
statement; [... statement;] ]
END CASE ;
CASE
WHEN cond THEN
[ WHEN cond THEN
statement; [... statement;] ] ...
[ ELSE
statement; [... statement;] ]
END CASE ;
CLOSE CURSOR cursorname ;
DECLARE {CONTINUE} HANDLER FOR {SQLSTATE nnnnn [... ,SQLSTATE nnnnn]}

{ EXIT }
{SQLEXCEPTION
}
{NOT FOUND
}
{ statement
}
{ BEGIN statement; [... statement;] END} ;
DECLARE varname [... ,varname] datatype [DEFAULT literal | NULL] ;
DECLARE cursorname [[NO]SCROLL] CURSOR FOR

SelectStatement
[ FOR {READ ONLY | UPDATE} ] ;
FETCH [FIRST | NEXT] FROM cursorname INTO var1 [... ,varn] ;
[label:] FOR var AS [ cursorname CURSOR FOR ] selectstatment DO

END FOR [label] ;
Page 20
IF cond THEN
statement;
[ ELSEIF cond
statement;
[ ELSE
statement;
END IF ;
[... statement;]
THEN
[... statement;] ] ...
[... statement;] ]
ITERATE label ;
LEAVE label ;
[label:] LOOP
END LOOP [label] ;
OPEN cursorname ;
PRINT { varname } [... , { varname } ] ;

{ literal }
{ literal }
REPEAT
statement; [ ... statement;]
UNTIL cond
END REPEAT;
SELECT
INTO
FROM
WHERE
expr [... , expr]

:var [... , :var]
tname
cond
SET varname = expression ;
[label:] WHILE cond DO

statement; [... ,statement;]
END WHILE [label] ;
Page 21
BTEQ COMMANDS
BTEQ commands are listed alphabetically. Defaults are underscored.

Quoted strings may use either single (') or double (") quote marks.
.ABORT
.CMS
[
SUBSET
]
[
]
[ cms-command ]
{ FILE }
{'filename'}
{ SPL }
.COMPILE { DD } [=] { filename } [ WITH { PRINT } ]
{DDNAME}
{"filename"}
{ NOSPL }
{NOPRINT}
.EXIT
.EXPORT
.EXPORT
[
n
]
[ ERRORLEVEL ]
[ ERRORCODE ]
[ ACTIVITYCO ]
{
{
{
{
{
DATA
INDICDATA
REPORT
REPORTWIDE
DIF [DATALABELS]
}
} {DDNAME} = name [,LIMIT=n] [,{CLOSE} ]
} { FILE }
[ {OPEN } ]
}
}
[AXSMOD [name] ['init str']]
RESET
= [ n ]
.GOTO
labelname
.HANG
[ n ]
.HELP
BTEQ
.IF
{
ERRORCODE
}
{ BTEQ command }
{
ERRORLEVEL } operator n THEN {
}
{ ACTIVITYCOUNT }
{ SQL request }
.IMPORT
{
DATA
} { FILE }
{
} { DDNAME } = name [,SKIP=n]
{ INDICDATA }
Page 22
Channel client
{
.IMPORT {
{
{
.LABEL
DATA
INDICDATA
REPORT
VARTEXT ['c']
}
} {DDNAME} { name } [,SKIP=n] [AXSMOD [name] ['init str']]
} { FILE } {'name'}
}
{"name"}
labelname
.LOGOFF
.LOGON
[tdpid /] username [,password [,'acctid'] ]
{ file }
.MESSAGEOUT {
} = name
{ ddname }
.OS command
.QUIT
[
n
]
[ ERRORLEVEL ]
[ ERRORCODE ]
[ ACTIVITYCO ]
.REMARK 'string [ //string [... //string ] ]'
Can use single or double quotes
[ n ]
.REPEAT [
]
[ * ]
.RUN
{
DD
}
{ 'name' }
{ DDNAME } = { name } [,SKIP=n]
{ FILE }
{ "name" }
.[SET] DEFAULTS
.[SET] ECHOREQ
[ OFF ]
[
]
[ ON ]
{ { UNKNOWN
}
}
.[SET] ERRORLEVEL { { nnnn
} SEVERITY nn [ ... ,] }
{ {(nnnn ... ,nnnn)}
}
{ ON
}
{ OFF
}
Page 23
.[SET] ERROROUT
[ STDOUT ]
[
]
[ STDERR ]
.[SET] FOLDLINE
[ OFF ] [ n [... ,n] ]

[
] [
]
[ ON ] [ ALL
]
.[SET] FOOTING
'string [ //string [... //string ] ]'
.[SET] FORMAT
[ OFF ]
[
]
[ ON ]
.[SET] FORMCHAR
[
ON
]
[
OFF
]
[ 'hexstring'xb ]
.[SET] FULLYEAR
[ OFF ]
[
]
[ ON ]
.[SET] HEADING
[ OFF]
.[SET] INDICDATA [
]
[ ON ]
[ ON ]
.[SET] LOGONPROMPT [
]
[ OFF ]
.[SET] MAXERROR
.[SET] NOTIFY
nn
[ OFF
] [ EXIT
name
]
[ LOW
] [ MSG
[text]
]
[ MEDIUM ] [ QUEUE [options] ]
[ HIGH ]
.[SET] NULL [AS] 'string'
.[SET] OMIT
Page 24
[ OFF ] [ n [..., n] ]
[
] [
]
[ ON ] [ ALL
]
[ OFF ] [ n [,n ,n ...] ]

.[SET] PAGEBREAK [
] [
]
[ ON ] [ ALL
]
.[SET] PAGELENGTH n
.[SET] QUIET
[ OFF ]
[
]
[ ON ]
[ OFF ]
.[SET] RECORDMORE [
]
[ ON ]
[ OFF ]
.[SET] REPEATSTOP [
]
[ ON ]
.[SET] RETCANCEL
[ OFF ]
[
]
[ ON ]
.[SET] RETLIMIT
.[SET] RETRY
[ OFF ]
[
]
[ ON ]
.[SET] RTITLE
.[SET] SECURITY
{
ALL
}
{ PASSWORD[S] }
{
NONE
}
.[SET] SEPARATOR
[ 'string' ]
[ "string" ] [ALL]
[
n
]
{ charsetnum
}
.[SET] SESSION CHARSET { 'charsetname' }
{ "charsetname" }
[ NONE
]
.[SET] SESSION SQLFLAG [ INTERMEDIATE ]
[ ENTRY
]
Page 25
{ BTET }
.[SET] SESSION TRANS[ACTION] {
}
{ ANSI }
.[SET] SESSIONS
.[SET] SIDETITLES
[ OFF ] [ 0
]
[
] [ wn [... ,wn] ]
[ ON ] [ ALL
]
.[SET] SKIPDOUBLE
[ OFF ] [ n [... ,n] ]

[
] [
]
[ ON ] [ ALL
]
.[SET] SKIPLINE
[ OFF ] [ n [... ,n] ]

[
] [
]
[ ON ] [ ALL
]
.[SET] SUPPRESS
[ OFF ] [ n [... ,n] ]

[
] [
]
[ ON ] [ ALL
]
.[SET] TDP
TDPn
.[SET] TIMEMSG
[ DEFAULT ]
[
]
[ QUERY
]
[ OFF ] [ 0
]
.[SET] TITLEDASHES [
] [ wn [... ,wn] ]
[ ON ] [ ALL
]
.[SET] UNDERLINE
[ OFF ] [ n [... ,n] ]

[
] [
]
[ ON ] [ ALL
]
.[SET] WIDTH
.SHOW CONTROL[S]
.SHOW ERRORMAP
.SHOW VERSION[S]
Page 26
.TDP xx[xxxxxx]
(Optional form for VM users only)
.TSO string
Page 27
PREPROCESSOR2 STATEMENTS
Preprocessor2 statements are shown below in alphabetical order.

In addition to the DML statement variations shown here you may also use other DML and DDL statements
described in the DBC Reference Manual.
Each statement must be prefixed by 'EXEC SQL' and followed by the statement terminator. ('END-EXEC' in
Cobol, or ';' in PL/1 or C.)
BEGIN DECLARE SECTION

.
< Variable Definitions >
.
END DECLARE SECTION
Note: Use in 'C' programs only.
[
{ckpt-label}]
CHECKPOINT [dbname.]tbname [,NAMED {
}] INTO [:]host-variable
[
{:labelvar }]
[[INDICATOR] :host-variable]
CLOSE cursor-name
COMMENT [ON] objkind objref [IS] 'comment'

[AS]
COMMENT [ON] objkind objref INTO [:]host-variable [[INDICATOR] :host-variable]
COMMIT [WORK [RELEASE] ]
CONNECT [:]id-var IDENTIFIED BY [:]password-var
{dbname
}
DATABASE {
}
{:dbnamevar}
{cursor-specification
}
DECLARE cursor-name CURSOR FOR {statement-name
}
{'request-specification'
}
{EXEC [dbname.]macroname[(parms)]}
DECLARE statement-name [ ... , statement-name] STATEMENT
Page 28
{ Table-name }
DECLARE {
} TABLE ( column-spec [ ... , column-spec] )
{ View-name }
DEL[ETE] FROM tbl-name WHERE CURRENT OF cursor-name
[
{NAMES }
DESCRIBE statement-name INTO [:]descriptor-area [ USING {ANY
}
[
{BOTH }
[
{LABELS}
]
]
]
]
[
{stmt-number} ]
[ FOR STATEMENT {
} ]
[
{[:]numvar } ]
EXEC [dbname.] macroname [ (parm-list) ]
[
{[:]h-var [[INDICATOR] :h-var] [... , h-var] } ]
EXECUTE statement-name [ USING {
} ]
[
{DESCRIPTOR [:]descriptor-area
} ]
{statement-string }
EXECUTE IMMEDIATE {
}
{[:]stmt-string-var}
{ INTO [:]host-var [[INDICATOR] :host-var] [... , host-var] }

FETCH cursor-name {
}
{ USING DESCRIPTOR [:]descriptor-area
}
{SQLCA
}
INCLUDE {SQLDA
}
{text-name}
INS[ERT] [INTO] tname [ (cname [... ,cname]) ] VALUES ( [:]h-var [... , [:]h-var] )
LOGON [:]logonstr
[
{ [:]h-var [[INDICATOR] :h-var] [... , h-var] } ]
OPEN cursor-name [ USING {
} ]
[
{ DESCRIPTOR [:]descriptor-area
} ]
[ TO NEXT
]
POSITION cursor-name [ TO [STATEMENT] {stmt-number} ]
[
{[:]numvar } ]
Page 29
PREPARE statement-name
[
{NAMES }]
[ INTO [:]descriptor-area [ USING {ANY
}] [ FOR STATEMENT {stmt-number} ] ]
[
{BOTH }]
{[:]numvar }
[
{LABELS}]
FROM {statement-string }
{[:]stmt-string-var}
REWIND cursor-name
ROLLBACK [WORK [RELEASE]] [abort-message] [WHERE abort-cond]
SEL[ECT] [ALL
] expr [... , expr]
[DISTINCT]
INTO [:]host-var [[INDICATOR] :host-var] [... , host-var]
from-clause
[where-clause]
SET BUFFERSIZE size
{ set-name
}
SET CHARSET {
}
{ :set-name-var }
{MACRO}
SHOW {TABLE} [dbname.]obj-name INTO [:]host-variable [[INDICATOR] :host-variable]
{VIEW }
UPD[ATE] [dbname.]tbl-name [alias-name] SET col-name = expr [... ,col-name = expr]

WHERE CURRENT OF cursor-name
{ SQLERROR
} { CONTINUE
WHENEVER { SQLWARNING } { GO TO [:]label
{ NOT FOUND } { GOTO [:]label
{ PERFORM code
{ CALL function
Page 30
}
}
}
}
}
COBOL Only
ARCHIVE / RECOVERY COMMANDS
This section summarizes the syntax used by the Archive and Recovery utility. Statements are listed
alphabetically.
(Note - The Keyword DDNAME may be used in place of FILE on MVS & VM)
{
{
ANALYZE {
{
*
ALL
{ ( databasename )
}
{ ( databasename1 ) TO ( databasename2 )} [ ,... ]
}
}
}
}
[ CATALOG ]
{ DISPLAY [LONG] }
[, {
} ]
{ VALIDATE
}
[, USE {ASCII } COLLATION ]
{EBCDIC}
, FILE = name
{
DATA
}
ARCHIVE {DICTIONARY } TABLE[S]
{NO FALLBACK}
{ JOURNAL }
{ (databasename)
[ (EXCLUDE TABLES (tblname [..., tblname] )) ] }
{ (databasename) ALL [ (EXCLUDE TABLES (db.tname [..., db.tname] )) ] } [, ...]
{ (databasename.tablename)
}
[, option [ ... ,option ] ]
,
FILE = name [, FILE = name]
Any of the following options may be listed:

EXCLUDE
{ ( databasename ) [ ALL ]
}
{
} [, ...]
{ ( databasename1 ) TO ( databasename2 ) }
{ PN = ccc-p [... , ccc-p ]

}
{ AMP = n
[... , n ]
}
{ CLUSTER[S] = nnn [... , nnn] }
V1 systems only
V2 systems only
RELEASE LOCK
INDEXES
ABORT
{ READ }
USE [GROUP] {
}
{ LOCK }
NONEMPTY DATABASE[S]
Page 31
BUILD
[
DATA TABLES
] { ( databasename ) [ALL]
}
[
JOURNAL TABLES
] {
} [,...]
[NO FALLBACK TABLE[S]] { ( databasename.tablename ) }
}
[, EXCLUDE {
} [,...] ]
{ ( databasename1) TO ( databasename2 ) }
[, RELEASE LOCK ]
[, ABORT ]
CHECKPOINT
{ ( databasename ) [ALL]
}
{
} [ ,...]
{ ( databasename.tablename ) }
[, EXCLUDE
}
{
} [ ,...] ]
{ ( databasename1 ) TO ( databasename2 )}
[, WITH SAVE ]
[
{ACCESS}
]
[, USE {
} LOCK ]
[
{ READ }
]
[, NAMED chkptname]
{
DATA
COPY { DICTIONARY
{
JOURNAL
{ NO FALLBACK
}
{ ( databasename )
}
} TABLE[S] {
}
}
}
[, option [ ... , option ] ] , FILE = name;

Any of the following options may be entered:
( [ FROM { ( databasename
) } ]
[
{ ( databasename.tablename ) } ]
[ , NO FALLBACK ]
[
{ NO JOURNAL
[ , { WITH JOURNAL TABLE = db.tablename
[
{ APPLY TO (db.tablename) [..., (db.tablename) ]
)
{ PN = ccc-p [... , ccc-p ]
}
{ AMP = n
[... , n ]
}
} ]
} ]
} ]
V1 systems only
V2 systems only
NO BUILD
RELEASE LOCK
ABORT
USE {ASCII } COLLATION
{EBCDIC}
REPLACE CREATORNAME
Page 32
DELETE DATABASE ( databasename ) [ALL] [, ...]

}
[, EXCLUDE {
} [,...] ]
DELETE
{SAVED
}
}
{
} JOURNAL {
} [,...]
{RESTORED}
}
[, EXCLUDE {
} [,...] ]
LOGOFF
LOGON [tdpid/] username , password [ , 'accid' ]
{ (databasename) [ALL]
}
RELEASE LOCK {
} [, ...]
{ (databasename.tablename) }
[, option [... , option ] ] ;
EXCLUDE
}
{
} [, ...]
{ (databasename1) TO (databasename2) }
{ PN = ccc-p [... , ccc-p ]

}
{ AMP = n
[... , n ]
}
V1 systems only
V2 systems only
ALL
OVERRIDE
BACKUP NOT DOWN
Page 33
{
DATA
}
}
RESTORE {DICTIONARY } TABLE[S] {
} [,...]
{NO FALLBACK}
{ (databasename.tablename) }
{ JOURNAL }
[, option [... , option] ]
, FILE = filename
}
EXCLUDE {
} [,...]
{ PN = ccc-p [... , ccc-p ]
}
{ AMP = n
[... , n ]
}
V1 systems only
V2 systems only
RESTORE FALLBACK
NO BUILD
RELEASE LOCK
ABORT
USE {ASCII } COLLATION
{EBCDIC}
}
REVALIDATE REFERENCES FOR {
} [,...]
}
[, EXCLUDE {
} [,...] ]
[, RELEASE LOCK ]
[, ERRORDB = dbname ]
Page 34
ROLLBACK
}
{
} [,...]
[, option [... , [ option ] ]

{ CURRENT }
, USE {
} JOURNAL
{ RESTORED }
}
EXCLUDE {
} [,...]
{ chkptname
}
TO { chkptname, eventno }
{ eventno
}
{ PN = ccc-p [... , ccc-p] }
{ AMP = n
[... , n]
}
V1 systems only
V2 systems only
RELEASE LOCK
[NO] DELETE
ABORT
ROLLFORWARD
}
{
} [,...]
[, option [... , [ option ] ]

{ CURRENT }
, USE {
} JOURNAL
{ RESTORED }
EXCLUDE
}
{
} [,...]
{ chkptname
}
TO { chkptname, eventno }
{ eventno
}
{ PN = ccc-p [... , ccc-p] }
{ AMP = n
[... , n]
}
V1 systems only
V2 systems only
PRIMARY DATA
RELEASE LOCK
[NO] DELETE
ABORT
Page 35
FASTLOAD COMMANDS
This section summarizes the command syntax used by the Fastload utility. All statements are listed
alphabetically.
BEGIN
LOADING
[dbname.]tblname
ERRORFILES [dbname.]tblname , [dbname.]tblname

[CHECKPOINT n]
[INDICATORS
CLEAR
DEF[INE] [
fldname ( datatype [ ,NULLIF [=] value ] )
[... ,fldname ( datatype [ ,NULLIF [=] value ] ) ] ]
[ { DDNAME = filename } ]
[ { FILE
= filename } ]
[ { INMOD = mod-name } ]
END LOADING
ERRLIMIT rows
HELP
[ TABLE [dbname.]tblname ]
INS[ERT] [INTO] [dbname.]tblname.*
INS[ERT] [INTO] [dbname.]tblname [ (cname [... ,cname] ) ]

VALUES ( :fldname [... , :fldname] )
LOGOFF
LOGON
[tdpid /] username , password [ , 'acctid' ]
OS
command
QUIT
Page 36
RECORD
[startnum] [THRU endnum]
SESSIONS n
SET RECORD [ { FORMATTED } ]

[ {UNFORMATTED} ]
{
ASCII
SET SESSION CHARSET { KANJIEUC_0U
{ KANJISJIS_0S
{
n
Network attached systems only
}
}
}
}
Network attached systems only
SHOW [VERSION[S]]
The following SQL statements are also supported by Fastload:
CREATE TABLE
DATABASE
DELETE
DROP TABLE
The following parameters are supported by the fastload command:

On Channel attached systems
On network attached systems
BUFSIZE = n
CHARSET = char-set-name
ERRLOG = filename
TENACITY = hours
-s mins
INMODTYPE = SAS_C
-b
-c
-e
-t
n
char-set-name
filename
hours
Page 37
MULTILOAD COMMANDS
This section summarizes the command syntax used by the Multiload utility. All statements are listed
alphabetically.
{pos1
}
.ACCEPT var [... ,var] [FROM] FILE fileid [ IGNORE {pos1 THRU
} ]
{THRU pos2
}
{pos1 THRU pos2}
.BEGIN
DELETE
MLOAD TABLES [dbname.]tname [... ,[dbname.]tname]

[ WORKTABLES
[dbname.]tname [... ,[dbname.]tname] ]
[ ERRORTABLES
[dbname.]tname [... , [dbname.]tname] ]
[ TENACITY
hours ]
[ SLEEP
mins
[ NOTIFY
{
{
{
{
OFF
LOW
MEDIUM
HIGH
} { MSG
text
}
} { EXIT name
} ]
} { QUEUE option }
}
.BEGIN [IMPORT] MLOAD TABLES [dbname.]tname [... , [dbname.]tname]

[ WORKTABLES
[ ERRORTABLES
[ ERRORLIMIT
errcount [errpercent] ]
[ CHECKPOINT
rate ]
[ SESSIONS
limit ]
[ TENACITY
hours ]
[ SLEEP
mins
[ AMPCHECK
[ NOTIFY
{ NONE }
{ APPLY } ]
{ ALL
}
{
{
{
{
OFF
LOW
MEDIUM
HIGH
} { MSG
text
}
} { EXIT name
} ]
} { QUEUE option }
}
DEL[ETE] [FROM] [dbname.]tblname

WHERE
colname = :fldname [{AND} colname = :fldname]

{OR }
.DISPLAY 'text' [TO] FILE fileid

Page 38
{
{
{
.DML LABEL label [ {
{
{
{
{ MARK
} DUPLICATE [{INSERT}] }
{ IGNORE }
[{UPDATE}] }
}
{ MARK
} MISSING
[{UPDATE}] } ROWS ]
{ IGNORE }
[{DELETE}] }
}
DO INSERT FOR [MISSING UPDATE] }
.END MLOAD ;
.FIELD fldname { startpos datadesc } [ NULLIF nullexpr ]

{ fieldexpr
}
[ DROP {LEADING } {NULLS } [ [AND] {TRAILING} {NULLS } ] ]
{TRAILING} {BLANKS}
{LEADING } {BLANKS}
.FILLER [fldname] startpos datadesc
.IF conditional-expression [THEN] ;

statement 1
...
statement n
[
.ELSE ;
statement 1
...
statement n
]
.ENDIF
.IMPORT
{ INFILE filename { FREE }

}
{
{ HOLD }
}
{ [INFILE filename] INMOD modname [USING (parms)] }
[ FROM m ] [ { FOR n } ] LAYOUT layoutname
{ THRU n }
[ APPLY label [ WHERE condition ] ] [ APPLY ... ]
INSERT
INTO [dbname.]tblname {.*

}
{VALUES (:fldname [... ,fldname])}
.LAYOUT
layoutname [ CONTINUEIF condition ] [ INDICATORS ]
.LOGOFF
[retcode]
.LOGON
[tdpid /] username [,password [,'acctid']]
.LOGTABLE [dbname.]tablename
Page 39
{ [TO] FILE fileid

}
.ROUTE MESSAGES {
[WITH] ECHO {[TO] FILE fileid} }
{ [TO] FILE fileid [WITH] ECHO {OFF
} }
.RUN
.SET
{
FILE fileid [ IGNORE {
{
{
pos1
pos1 THRU
THRU pos2
pos1 THRU pos2
}
} ]
}
}
var [TO] expression
.SYSTEM 'command'
.TABLE tableref
UPDATE [dbname.]tblname SET colname = :fldname [... ,colname = :fldname]

WHERE colname = :fldname [{AND} colname = :fldname]
{OR }
Page 40
DATA DICTIONARY VIEWS
Data Dictionary/Directory view contents are listed alphabetically.

Those views with an 'X' suffix restrict the data returned to rows associated with the executing user.
AccLogRules
AccessLog
AccountInfo[X]
AllRights
AllRoleRights
AllSpace[X]
{
{
{
{
{
{
{
{
{
{
{
{
{
{
UserName,
AcrAlterFunction,
AcrCreateFunction,
AcrCreateUser,
AcrDelete,
AcrDropMacro,
AcrDropView,
AcrExecute,
AcrGrant,
AcrReference,
AcrUpdate,
AcrCreateRole,
AcrDropProfile,
CreateTimeStamp
{
{
{
{
{
{
{
LogDate,
LogonTime,
SessionNo,
OwnerName,
EventCount,
TVMName,
{ UserName,
{
{
{
{
DatabaseName,
AcrCheckpoint,
AcrCreateMacro,
AcrCreateView,
AcrDropDatabase,
AcrDropTable,
AcrDropProcedure,
AcrExecuteFunction,
AcrIndex,
AcrRestore,
AcrCreateTrigger,
AcrDropRole,
AcrAlterProcedure,
LogTime,
LogicalHostId,
UserName,
AccessType,
Result,
ColumnName,
LogonDate,
IFPNo,
AccountName,
Frequency,
DatabaseName,
StatementType,
StatementText
}
}
}
}
}
}
}
AccountName,
UserOrProfile
UserName,
DataBaseName,
ColumnName,
AccessRight,
GrantorName,
AllnessFlag,
CreateTimeStamp
TableName,
}
GrantAuthority, }
CreatorName,
}
}
{ RoleName,
{ AccessRight,
DataBaseName,
GrantorName,
TableName,
ColumnName, }
CreateTimeStamp
}
{
{
{
{
DataBaseName,
MaxSpool,
CurrentSpool,
PeakSpool,
AccountName,
MaxTemp,
CurrentTemp,
PeakTemp
Vproc,
MaxPerm,
CurrentPerm,
PeakPerm,
AllTempTables[X] { HostNo,
SessionNo,
{ B_DatabaseName, B_TableName,
All_RI_Children
TVMName,
}
AcrCreateDatabase, }
AcrCreateTable,
}
AcrCreateProcedure, }
AcrDropFunction,
}
AcrDropUser,
}
AcrDump,
}
AcrExecuteProcedure,}
AcrInsert,
}
AcrSelect,
}
AcrDropTrigger,
}
AcrCreateProfile,
}
CreatorName,
}
}
{
{
{
{
IndexID,
ChildTable,
ParentTable,
CreatorName,
UserName,
E_TableId
TableName,
}
}
}
}
}
}
IndexName,
ChildDB,
ChildKeyColumn, ParentDB,
ParentKeyColumn, InconsistencyFlag,
CreateTimeStamp
}
}
}
}
Page 41
All_RI_Parents
AMPusage
{
{
{
{
IndexID,
ParentTable,
ChildTable,
CreatorName,
IndexName,
ParentDB,
ParentKeyColumn, ChildDB,
ChildKeyColumn, InconsistencyFlag,
CreateTimeStamp
}
}
}
}
{ AccountName, UserName, CpuTime, DiskIO, }

{ Vproc,
VprocType, Model
}
Association
{
{
{
{
{
DataBaseName, TableName,
Original_DatabaseName,
Original_TableKind,
Original_ProtectionType,
Original_CreatorName,
CharSets
{ CharSetName }
EventNum,
}
Original_TableName,
}
Original_Version,
}
Original_JournalFlag, }
Original_CommentString}
CharTranslations { CharSetName, CharSetId, InstallFlag, }

{ E2I, E2IUp, I2E, I2EUp
}
Children[X]
{ Child, Parent }
Collations
{ CollName,
CollInstall, CollEqvClass, }
{ CollOrderCS, CollOrderUC
}
Columns[X]
{
{
{
{
{
{
{
{
{
DataBaseName,
TableName,
ColumnFormat,
ColumnTitle,
ColumnType,
ColumnLength,
Commentstring, DecimalTotalDigits,
ColumnId,
UppercaseFlag,
CompressValue, ColumnConstraint,
CreatorName,
CreateTimeStamp,
LastAlterTimeStamp, CharType,
AccessCount,
LastAccessTimeStamp,
ColumnName,
SSParameterType,
DefaultValue,
Nullable,
DecimalFractionalDigit,
Compressible,
ConstraintCount,
LastAlterName,
IdColType
CompressValueList
ColumnStats
{ DatabaseName,
TableName,
ColumnName,
}
{ ColumnType,
ColumnLength,
ColumnFormat, }
{ DecimalTotalDigits, DecimalFractionalDigit, SeqNumber
}
CSPSessionInfo
{ SessionNo, HostNo, StartMBox, LogonSource }
Databases[X]
{
{
{
{
{
Page 42
DataBaseName,
AccountName,
PermSpace,
CommentString,
LastAlterTimestamp,
CreatorName,
ProtectionType,
SpoolSpace,
CreateTimeStamp,
DBKind, AccessCount,
OwnerName,
JournalFlag,
TempSpace,
LastAlterName,
LastAccessTimeStamp
}
}
}
}
}
}
}
}
}
}
}
}
}
}
Databases2
{ DataBaseName, DataBaseId, UnResolvedRICount }
DataBase_Default_Journals[X] { DataBaseName, Journal_DB, JournalName }
DBCInfo
{ InfoKey, InfoDate }
DBQLRules
{
{
{
{
{
DeleteAccessLog
{ LogDate, LogTime }
DeleteOldInDoubt
DiskSpace[X]
EventType,
DatabaseName,
ObjFlag,
SummaryFlag,
SummaryVal1,
ThreshValue
AccountString,
SQLFlag,
ThresholdFlag,
SummaryVal2,
{
{
{
{
{
{
LogicalHostId,
CoordTaskId,
LogonUserName,
CommitOrRollback,
UserLogonTime,
CompletionTime,
{
{
{
{
Vproc,
MaxPerm,
CurrentPerm,
PeakPerm,
ExplainFlag,
StepFlag,
TextSizeLimit,
SummaryVal3,
SessionNumber,
RunUnitId,
ResolvingUserLogonName,
UserLogonDate,
CompletionDate,
Options
DataBaseName,
MaxSpool,
CurrentSpool,
PeakSpool,
AccountName,
MaxTemp,
CurrentTemp,
PeakTemp
}
}
}
}
}
}
}
}
}
}
{ CreateDate,
CreateTime,
EventNum,
{ UserName,
DatabaseName,
ObjectType,
{ RestartSeqNum,
OperationInProcess, TableName,
AllAMPsFlag,
}
Events[X]
CheckpointName,}
{ LinkingEventNum, DataSetName,
JournalUsed,
}
}
}
}
}
LockMode,
DupeDumpSet
{ JournalSaved,
}
IndexPresent,
{ CreateDate,
CreateTime,
EventNum,
EventType,}
Events_Configuration[X] { UserName,
LogProcessor, PhyProcessor, Vproc,
}
{ ProcessorState, RestartSeqNum
}
Events_Media[X]
{ CreateDate,
{ UserName,
{ DupeDumpSet
Functions
{
{
{
{
{
CreateTime, EventNum,
EventType,
}
DataSetName, VolSerialID, VolSequenceNum, }
}
DatabaseName,
FunctionId,
FunctionType,
NoSQLDataAccess,
NullCall,
FunctionName,
NumParameters,
ExternalName,
ParameterStyle,
PrepareCount,
SpecificName,
ParameterDataTypes,
SrcFileLanguage,
DeterministicOpt,
ExecProtectionMode
}
}
}
}
}
Page 43
{ ExtFileReference, CharacterType,
{
{
{
Hardware_Event_Log {
{
{
{
{
HostInfo
IndexConstraints
IndexStats
Indices[X]
InDoubtLog
Journals[X]
LogOnOff
LogonRules
MultiColumnStats
Page 44
TheDate,
Category,
Revision_Level,
PMA,
SubSlot,
Vcc_Margin,
Vcc_Amps,
Text,
Platform
TheTime,
Severity,
Secondary_Part_Number,
Module_Type,Slot,
SubSlot_Type,
Frequency_Margin,
Temperature,
Error_Data
Event_Tag
}
Primary_Part_Number,}
Serial_Number,
}
Slot_Type,
}
FW_Version,
}
Vcc_Volts,
}
Line,
}
}
{ LogicalHostId, HostName, DefaultCharSet }
{
{
{
{
DataBaseName,
TableName,
IndexName,
IndexNumber,
ConstraintType, ConstraintText,
ConstraintCollation, CollationName, CreatorName
CreateTimeStamp
{
{
{
{
{
DatabaseName,
IndexName,
ColumnPosition,
ColumnLength,
DecimalTotalDigits,
{
{
{
{
{
DataBaseName,
IndexType,
ColumnName,
CreateTimeStamp,
IndexMode,
{
{
{
{
LogicalHostId,
RunUnitId,
UserLogonDate,
CompletionTime,
TableName,
IndexType,
ColumnName,
ColumnFormat,
DecimalFractionalDigit,
TableName,
UniqueFlag,
ColumnPosition,
LastAlterName,
AccessCount,
SessionNumber,
LogonUserName,
UserLogonTime,
CommitOrRollback,
}
}
}
}
IndexNumber,
UniqueFlag,
ColumnType,
}
}
}
}
IndexStatistics }
IndexNumber,
IndexName,
CreatorName,
LastAlterTimestamp,
LastAccessTimeStamp
}
}
}
}
}
CoordTaskId,
ResolvingUserLogonName,
CompletionDate,
Options
}
}
}
}
{ Tables_DB,
TableName, }
{ Journals_DB, JournalName }
{ LogDate,
LogTime,
UserName,
AccountName, }
{ Event,
LogicalHostId, IFPNo,
SessionNo,
}
{ LogonDate, LogonTime,
LogonSource
}
{ UserName,
LogicalHostId, LogonStatus,
}
{ NullPassword, CreatorName,
CreateTimeStamp }
{ DatabaseName,
{ ColumnPosition,
{ ColumnLength,
TableName,
ColumnName,
ColumnFormat,
StatisticsId,
ColumnType,
}
}
}
{ DecimalTotalDigits, DecimalFractionalDigit, ColumnStatistics }
OwnerDB
ProfileInfo[X]
{ Id, Name, NameI }
{
{
{
{
{
{
ProfileName,
SpoolSpace,
PasswordMinChar,
PasswordSpecChar,
PasswordReuse,
CreateTimeStamp,
DefaultAccount,
TempSpace,
PasswordMaxChar,
MaxLogonAttempts,
CommentString,
LastAlterName,
DefaultDB,
ExpirePassword,
PasswordDigits,
LockedUserExpire,
CreatorName,
LastAlterTimeStamp
}
}
}
}
}
}
Page 45
QryLog
QryLogExplain
QryLogObjects
QryLogSQL
QryLogSteps
{
{
{
{
{
{
{
{
{
{
{
{
{
{
{
{
ProcId,
UserID,
SessionID,
LogonDateTime,
AcctStringDate,
QueryBrand,
FirstStepTime,
NumSteps,
NumResultRows,
TotalCPUTime,
TDQMFlag,
HotAmp1CPU,
LowAmp1CPU,
HotAmp1IO,
LowAmp1IO,
SpoolUsage,
CollectTimeStamp, QueryID,
}
AcctString,
ExpandAcctString, }
LogicalHostID,
RequestNum,
}
AcctStringTime,
AcctStringHour,
}
AppID,
ClientID,
}
ProfileID,
StartTime,
}
FirstRespTime,
LastRespTime,
}
NumStepswPar,
MaxStepsInPar,
}
ResultRowSize,
TotalIOCount,
}
ErrorCode,
ErrorText,
}
AbortFlag, CacheFlag, QueryText,
}
HotAmp2CPU, HotAmp3CPU,
}
LowAmp2CPU, LowAmp3CPU, AvgAmpCPUSec,}
HotAmp2IO, HotAmp3IO,
}
LowAmp2IO, LowAmp3IO, AvgAmpIOCnt, }
<Extra fields>
}
{ ProcId,
CollectTimeStamp, QueryID, }
{ ExpRowNo, ExplainText
}
{
{
{
{
ProcId,
ObjectDatabaseName,
ObjectID,
FreqOfUse,
CollectTimeStamp, QueryID,
ObjectTableName, ObjectColumnName,
ObjectNum,
ObjectType,
TypeOfUse
{ ProcId,
CollectTimeStamp, QueryID, }
{ SqlRowNo, SqlTextInfo
}
{
{
{
{
{
{
{
{
{
ProcId,
StepLev1Num,
StepStartDate,
IOCount,
HotAmp1CPU,
LowAmp1CPU,
HotAmp1IO,
LowAmp1IO,
<Extra fields>
CollectTimeStamp,
StepLev2Num,
StepStopDate,
RowCount,
HotAmp2CPU,
LowAmp2CPU,
HotAmp2IO,
LowAmp2IO,
QueryID,
StepName,
CPUTime,
}
}
}
}
HotAmp3CPU,
}
LowAmp3CPU, AvgAmpCPUSec,}
HotAmp3IO,
}
LowAmp3IO, AvgAmpIOCnt, }
}
QryLogSummary
{ ProcId,
CollectTimeStamp, SessionID,
}
{ QueryCount, QuerySeconds,
LowHist,
HighHist }
RCC_Configuration[X]
{ EventNum, LogProcessor,
PhyProcessor, }
{ Vproc,
ProcessorState, RestartSeqNum }
RCC_Media[X]
{ EventNum, VolSerialId, VolSequenceNum, DupeDumpSet }
ResCPUUsageByAMPView
Page 46
}
}
}
}
{
{
{
{
TheDate, TheTime,
Secs,
AMPWorkTaskExec,
AMPMiscUserServ,
Vproc,
NCPUs,
AMPWorkTaskServ,
AMPTotalUserExec,
NodeId,
GroupId,
AMPMiscUserExec,
AMPTotalUserServ
}
}
}
}
ResCPUUsageByPEView
{
{
{
{
{
{
TheDate, TheTime,
Secs,
PEDispExec,
PEParsServ,
PEMiscUserExec,
PETotalUserServ
Vproc,
NCPUs,
PEDispServ,
PESessExec,
PEMiscUserServ,
NodeId,
GroupId,
PEParsExec,
PESessServ,
PETotalUserExec,
}
}
}
}
}
}
{ TheDate, TheTime, Vproc,
NodeId,
{ Secs,
GroupId,
NCPUs,
{ CPUBusy,
CPUOpSys,
CPUWaitIO,
{ DiskSegmentIO,
LogicalDeviceIO,
LogicalDeviceReads,
}
}
}
}
{ LogicalDeviceWrites,
LogicalDeviceWriteKB,}
{ MemAgings,
MemBackupPartialSegs,}
{ MemFails,
}
ResGeneralInfoView
{ MemTextAllocs,
}
{ NetAttempts,
}
{ NetChannelSR,
}
{ NetReadKB,
}
{ NetWrites,
}
{ ProcBlksDBLock,
}
{ ProcWaits,
}
ResShstGroupView
ResSldvGroupView
RI_Child_Tables
{
{
{
{
{
{
TheDate, TheTime,
Secs,
CollectIntervals,
HostMessageReads,
HostWriteKB,
HostReadFails,
{
{
{
{
{
{
{
{
TheDate, TheTime,
Secs,
CollectIntervals,
LdvReads,
LdvWriteKB,
LdvReadRespMax,
LdvWriteRespSq,
LdvOutReqTime
{
{
{
{
IndexID,
ChildTID,
ParentTID,
CreatorName,
LogicalDeviceReadKB,
MemBackupCompleteSegs,
MemFreeKB,
MemSize,
MemVprAllocs,
NetBackoffs,
NetMultiIO,
NetPtoPIO,
NetReads,
NetWriteKB,
PageOrSwapIO,
ProcActiveAvg,
ProcBlockedAvg,
ProcBlocks,
UserStmtsArriving,
UserStmtsInProgress
NodeId, VprId,
NominalSecs,
HostBlockReads,
HostMessageWrites,
HostQLenSum,
HostWriteFails
NodeId, VprId,
NominalSecs,
LdvConcurrentSum,
LdvWrites,
LdvReadRespTot,
LdvWriteRespMax,
LdvConcurrentMax,
HstId, HstType,
GroupId,
HostBlockWrites,
HostReadKB,
HostQLenMax,
LdvId, LdvType,
GroupId,
LdvOutReqSum,
LdvReadKB,
LdvWriteRespTot,
LdvReadRespSq,
LdvOutReqMax,
IndexName,
ChildDbID,
ChildKeyFID,
ParentDbID,
ParentKeyFID,
InconsistencyFlag,
CreateTimeStamp
}
}
}
}
}
}
}
}
}
}
}
}
Page 47
}
}
}
}
}
}
RI_Distinct_Children
{ IndexID,
IndexName,
ChildDB,
}
{ ChildTable,
ParentDB,
ParentTable
}
{ InconsistencyFlag, CreatorName, CreateTimeStamp }
RI_Distinct_Parents
{ IndexID,
IndexName,
ParentDB,
}
{ ParentTable,
ChildDB,
ChildTable
}
{ InconsistencyFlag, CreatorName, CreateTimeStamp }
RI_Parent_Tables
Page 48
{
{
{
{
IndexID,
ParentTID,
ChildTID,
CreatorName,
IndexName,
ParentDbID,
ParentKeyFID,
ChildDbID,
ChildKeyFID,
InconsistencyFlag,
CreateTimeStamp
}
}
}
}
RoleInfo[X]
{ RoleName,
CreatorName, CommentString, }
{ CreateTimeStamp
}
RoleMembers[X]
{ RoleName, Grantee,
GranteeKind,
}
{ Grantor, WhenGranted, DefaultRole, WithAdmin }
SecurityDefaults
SecurityLog[X]
SessionInfo[X]
{ ExpirePassword,
PasswordMinChar, PasswordMaxChar, }
{ PasswordDigits,
PasswordSpecChar, MaxLogonAttempts, }
{ LockedUserExpire, PasswordReUse
}
{ LogDate,
LogTime,
LogType,
UserName, }
{ AccountName, DataBaseName, TableName, Text
}
{
{
{
{
{
{
UserName,
DefaultDataBase,
LogicalHostId,
LogonDate,
LogonSource,
Transaction_Mode,
AccountName,
IFPNo,
HostNo,
LogonTime,
ExpiredPassword,
CurrentRole,
SessionNo,
Partition,
CurrentCollation,
LogonSequenceNo,
TwoPCMode,
LogonAcct
ShowColChecks
{ DatabaseName, TableName,
ColumnName, }
{ ColCheck,
CreatorName, CreateTimeStamp
ShowTblChecks
{ DatabaseName, TableName,
CheckName,
}
{ TblCheck,
CreatorName, CreateTimeStamp }
Software_Event_Log
{
{
{
{
{
TheDate,
Category,
Vproc,
SW_Version
StackTrace,
TheTime,
Severity,
Partition,Task,
Line,
Error_Data
Event_Tag,
PMA,
TheFunction,
Text,
}
}
}
}
}
}
}
}
}
}
}
{ DataBaseName,
TableName,
Version,
{ TableKind,
ProtectionType,
JournalFlag,
{ CreatorName,
RequestText,
CommentString,
{ ParentCount,
ChildCount,
NamedTblCheckCount,
}
}
Tables[X]
}
}
{ UnnamedTblCheckExist, PrimaryKeyIndexId,
CreateTimeStamp,
}
{ LastAlterName
LastAlterTimeStamp,
{ AccessCount,
LastAccessTimeStamp
RequestTextOverFlow,}
}
Tables2
{ TVMName,
TVMId,
DatabaseId, }
{ ParentCount, ChildCount
}
Page 49
TableSize[X]
{ Vproc,
DataBaseName, AccountName, }
{ TableName, CurrentPerm, PeakPerm
}
TableText[X]
{ DataBaseName, TableName, TableKind, }

{ RequestText, LineNo
}
Table_LevelConstraints
Triggers
{
{
{
{
{
{
{ DatabaseName,
TableName,
ConstraintName, }
{ ConstraintText, CreatorName, CreateTimeStamp }
EnabledfFlag, ActionTime,
Kind,
OrderNumber,
RequestText,
CreatorName,
LastAlterName, LastAlterTimeStamp,
LastAccessTimeStamp
TriggerName,
}
Event,
}
TriggerComment }
CreateTimeStamp,}
AccessCount,
}
}
UserDB
{ Id, Name }
UserGrantedRights
{ DataBaseName, TableName,
ColumnName,
}
{ Grantee,
AccessRight, GrantAuthority, }
{ AllnessFlag, CreatorName, CreateTimeStamp }
UserRights
{ DataBaseName, TableName,
ColumnName, }
{ AccessRight, GrantAuthority, GrantorName }
{ CreatorName, CreateTimeStamp
}
UserRoleRights
Users
{ RoleName,
ColumnName, }
{ AccessRight, GrantorName, CreateTimeStamp
}
{
{
{
{
{
{
{
{
{
{
UserName,
PasswordLastModTime,
SpoolSpace,
JournalFlag,
DefaultDataBase,
PasswordChgDate,
LockedCount,
DefaultDateForm,
LastAlterTimeStamp,
ProfileName,
User_Default_Journals[X]
Page 50
CreatorName,
Ownername,
TempSpace,
StartUpString,
CommentString,
LockedDate,
TimeZoneHour,
CreateTimeStamp,
DefaultCharType,
AccessCount,
PasswordLastModDate,
PermSpace
ProtectionType,
DefaultAccount,
DefaultCollation
LockedTime,
TimeZoneMinute,
LastAlterName,
RoleName,
LastAccessTimeStamp
}
}
}
}
}
}
}
}
}
}
{ UserName, Journal_DB, JournalName }
Builtin Values and Functions
Built in Value
Value Returned
Data Type
ACCOUNT
Current User Account
VARCHAR(30)
CURRENT_DATE
Current Date
DATE
CURRENT_TIME [(n)]
Current Time
TIME(n) WITH TIMEZONE
CURRENT_TIMESTAMP [(n)]
Current Date/Time
TIMESTAMP(n) WITH TIMEZONE
DATABASE
Current Default DB
VARCHAR(30)
DATE
Current Date
DATE
NULL
The NULL value
As required
PARTITION
The Index Partition
INTEGER
ROWID
The Internal Row Id
INTEGER
SESSION
Current Session Number
INTEGER
TIME
Current Time
FLOAT
USER
Current User Id
VARCHAR(30)
Descriptor Functions
BYTE[S]
(arg)
Value Returned
Data Type
Length of arg
INTEGER
CHAR[ACTERS] (string)
Length of str
INTEGER
MCHAR[ACTERS] (string)
Length (Mbyte Chars)
INTEGER
CHAR[ACTER]_LENGTH(string)
Length of str (Chars)
INTEGER
OCTET_LENGTH (string [charset])
Length of str (Bytes)
INTEGER
FORMAT
(arg)
Format of arg
VARCHAR(30)
NAMED
(arg)
Name assigned to arg
VARCHAR(30)
TITLE
(arg)
Title on arg
VARCHAR(60)
TYPE
(arg)
Data Type of arg
VARCHAR(??)
Math Functions
Value Returned
Data Type
ABS
(num)
Absolute value
Same as arg
ACOS
(num)
ArcCosine
FLOAT
ACOSH
(num)
Hyperbolic ArcCosine
FLOAT
ASIN
(num)
ArcSine
FLOAT
ASINH
(num)
Hyperbolic ArcSine
FLOAT
ATAN
(num)
ArcTangent
FLOAT
ATANH
(num)
Hyperbolic ArcTangent
FLOAT
COS
(num)
Cosine
FLOAT
COSH
(num)
Hyperbolic Cosine
FLOAT
EXP
(num)
e to the power arg
FLOAT
LOG
(num)
Base 10 Logarithm
FLOAT
LN
(num)
Base e
FLOAT
SIN
(num)
Sine
FLOAT
SINH
(num)
Hyperbolic Sine
FLOAT
SQRT
(num)
Square Root
FLOAT
Logarithm
Page 51
TAN
(num)
Tangent
FLOAT
TANH
(num)
Hyperbolic Tangent
FLOAT
Page 52
Builtin Values and Functions - Continued
Conversion Functions
Value Returned
Data Type
ADD_MONTHS (date, n)
(timestamp, n)
Add n months to date
DATE
TIMESTAMP
CASE
Value substitution
Same as valn
WHEN exp1 THEN val1

[WHEN exp2 THEN val2]
... [ELSE valn] END
CASE_N
(expr [.. ,expr] [,NO CASE [OR UNKNOWN]] [,UNKNOWN]) INTEGER
CAST
(expr AS typeinfo)
CHAR2HEXINT (string)
COALESCE
DATE
Type/Format conversion
as in typeinfo
HEX display of string
VARCHAR
(expr1, expr2 [.. ,exprn]) First non-Null expr

YYYY-MM-DD
Same as expr
YYYY-MM-DD as a date
DATE
part type
EXTRACT
(part FROM date)
Day, Hour, Minute etc
HASHROW
(expr, expr)
The Row Hash
HASHBUCKET (expr)
The Hash Bucket
HASHAMP
The Primary AMP
(expr)
HASHBACKAMP (expr)
The Backup AMP
INDEX
Start pos. of substr
INTEGER
String in LowerCase
CHAR
LOWER
(string, substr)
(string)
MINDEX
(MBstring, substr)
Start pos. of substr
INTEGER
NULLIF
(expr1, expr2)
Null if e1=e2 else e1
Same as expr1
NULLIFZERO (num)
NULL if arg is Zero
Same as arg
(start,end) OVERLAPS (start,end)
Dates/intervals overlap?
BOOLEAN
POSITION
Start pos of str1 in str2 INTEGER
RANGE_N
RANDOM
(str1 IN str2)
(expr BETWEEN start [AND end] [EACH size] [..., ]

[,NOT IN RANGE [OR UNKNOWN]] [,UNKNOWN] )
(low-bound, high_bound)
SOUNDEX
( )
SUBSTR
(string, start, len)
INTEGER
A random number
FLOAT
Sub-String of string
CHAR
[BOTH
]
TRIM ([[LEADING ] [chr] FROM] string) Remove blanks (or chr)
[TRAILING]
CHAR
UPPER
String in UpperCase
CHAR
Zero if arg is NULL
Same as arg
(string)
WIDTH_BUCKET ( )
ZEROIFNULL (num)
Page 53
Builtin Values and Functions - Continued
Aggregate and OLAP Functions
Description
AVG
([DISTINCT] arg)
Average value
CORREL
(y, x)
Correlation
COUNT
([DISTINCT] arg)
Number occurrences
COUNT
(*)
Number of rows
COVARIANCE (y, x)
Covariance
COVAR_SAMP (y, x)
Sample Covariance
CSUM
(col, sort-expr [ ,sort-expr] )
Cumulative Sum
GCOUNT
(col)
GSUM
(col)
KURTOSIS
(arg)
Kurtosis
LINREGSLOPE (y, x)
Slope: Linear Reg
LINREGINTERCEPT(y, x)
Intercept: Linear Reg
MAX[IMUM]
(arg)
Maximum value
MIN[IMUM]
(arg)
Minimum value
MAVG
(col, #rows, sort-expr [ ,sort-expr] )
Moving Average
MDIFF
Moving Difference
MLINREG
(col, #rows, sort-expr )
Linear Regression
MSUM
Moving Sum
PERCENT_RANK() OVER ([PARTITION BY spec] ORDER BY spec [ASC | DESC])

QUANTILE
(#partitions, sort-expr [ ,sort-expr] )
Quantile position
RANK
(sort-expr [ ,sort-expr] )
Rank Position
RANK
() OVER ([PARTITION BY spec] ORDER BY spec [ASC | DESC])
REGR_AVGX
(y, x)
Avg of x values in regression
REGR_AVGY
(y, x)
Avg of y values in regression
REGR_COUNT (y, x)
# non-null pairs in
regression
REGR_R2
(y, x)
R squared of Regression
REGR_SXX
(y, x)
? in regression
REGR_SXY
(y, x)
? in regression
REGR_SYY
(y, x)
? in regression
SKEW
([DISTINCT] arg)
Skew
STDEV
(arg)
Standard Deviation
STDEVP
(arg)
Standard Deviation (pop)
STDDEV_POP ([DISTINCT] arg)
Population Std Deviation
STDDEV_SAMP ([DISTINCT] arg)
Sample Std Deviation
SUM
([DISTINCT] arg)
Sum of values
SUM
VARIANCE
(arg) OVER ( [PARTITION BY spec]

[ORDER BY
spec]
ROWS {windowsize} PRECEDING [ASC | DESC] )
{UNBOUNDED }
(arg)
Variance
VARIANCEP
(arg)
Population Variance
VAR_POP
([DISTINCT] arg)
Population Variance
Page 54
VAR_SAMP
([DISTINCT] arg)
Sample Variance
Page 55
Maximum Limits on the Teradata RDBMS
SYSTEM
Number of Data bases

4.2 Billion
Message length
1 MB
SQL request length
1 MB
Active transactions
2,048
Data Parcel Length
65,104
Parcels in one message
256
SQL title length
60
String constant length
255
Data Format Descriptor Length
30
Error message text in failure parcel
255
Sessions per gateway (Max 1 gateway / Node)
1,200
Sessions per PE
120
Concurrent Utility jobs
15
Vprocs per system
16,384
Vprocs per Node
128
Data capacity per AMP - Unformatted
1.3
DATABASE
Tables per database

32,000
Journal tables per database
1
Columns per table
2,048
LOB columns per table
32
Columns per View / Spool file
512
Block Size
130,560
Row size
(approx) 64,256
Column size
(approx) 64,000
LOB size
2 GB
Column / Table name length
30
Number of fields per index
62
Secondary / Join indexes per table
32
Table level constraints per table
100
Referential constraints per table
64
Tables that can reference a table
64
Columns in Foreign & Parent key
16
View / Macro nesting levels
8
Rows per table
limited by space available
SESSION
Spool Files
Global Temporary Tables
Volatile Temporary Tables
Parallel steps performed ( If no channels)
Number of channels
Tbyte
2048
1000
2000
20
10
(Redistribution across AMPs uses 4 channels,

Non prime Index (without redistribution) uses 2 channels)
Page 56
TERADATA DOCUMENTATION
Document Name
------------------------------------------------Release Summary for Version 2 Release 5
Introduction to the Teradata RDBMS
Messages Reference
Manual #
--------BD35-1098
BD35-1091
BD35-1096
Data Dictionary Reference

Database Administration Guide
Database Design Guide
Database Window Reference
Performance Optimization
Resource Usage Macros and Tables
Security Administration Guide
Database Utilities Reference
SystemFE Macros
BD35-1092
BD35-1093
BD35-1094
BD35-1095
BD35-1097
BD35-1099
BD35-1100
BD35-1102
BD35-1103
Teradata SQL Reference

Performance Monitor (PM/API) Reference
BD35-1101
BD35-1090
SQL Mapping and Collation Tables

International Character Set Support
BD35-1105
BD35-1125
SQL / Data Dictionary Quick Reference

Utilities Quick Reference
BD35-1510
BD35-1511
Teradata Tools and Utilities (TTU) 7.0 Release Summary
BD35-2427
Multiload Reference
Fast Export Reference
Fastload Reference
Archive/Recovery Reference Manual for Channel attached
BTEQ Reference
Tpump Reference
BD35-2409
BD35-2410
BD35-2411
BD35-2412
BD35-2414
BD35-3021
Teradata Manager Installation Guide

Getting Started with Teradata Manager
SQL Assistant Users Guide
BD35-2402
BD35-2428
BD35-2430
TeraBuilder Operators Reference

TeraBuilder Operator Programming Reference
TeraBuilder Reference
BD35-2433
BD35-2435
BD35-2436
TDQM Administrators Guide

TDQM Users Guide
TDQM Programmers Guide
BD35-3027
BD35-3028
BD35-3029
MDS Programmers Guide

MDS Installation and Configuration Guide
MDS Administrators Guide
BD35-3037
BD35-3045
BD35-3117
Page 57
TERADATA DOCUMENTATION - Continued
Document Name
------------------------------------------------ODBC driver for Windows User Guide
JDBC driver Installation and User Guide
CLI2 Developers Kit for Windows
Call Level Interface V2 for Channel attached
Call Level Interface V2 for Network attached
Access Module Programming Reference
Access Module Reference
Manual #
--------BD35-3061
BD35-2403
BD35-2408
BD35-2417
BD35-2418
BD35-2424
BD35-2425
TDP Reference
Teradata Application programming
Data Definition Language Processor Reference
CICS Interface to the Teradata DBS
IMS Interface to the Teradata DBS
TS/API User's Guide
BD35-2416
BD35-2446
BD35-2449
BD35-2448
BD35-2447
BD35-2419
Page 58
TDP COMMAND SUMMARY
TDP commands are listed alphabetically. Capital letters are used to indicate the minimum abbreviation
required for that keyword.
These commands may be entered from the MVS or VM console, or by a VM/TSO user (Through SMSG or
DBCCMD) who has been so AUTHORIZED.
ADD
{XMSCELLS}
{
} SIZe cellsize NUMber numcells
{CELLS
}
ATTach
ifpname
{userid}
AUthoriz {job
}
{ALL
}
{RESOLVE }
{None
}
{Display }
{Any
}
{AUthoriz}
{ ALL
}
COMMIT {
} COORD name [ HOST id ]
{ SESSION number }
DETach
ifpname
DISAble
IRF
DISAble
LGUX
DISAble
LOGONS
DISAble
POOL
DISable
SESSRSRV
DISAble
SMF
DISAble
TEST
{ ID poolid }
{ ALL
}
{ SUBn
{ ALL
[... SUBn] }
}
Page 59
DISAble
TIMe
DISAble
TMON
DISAble
UAX
DISAble
USEC
Display
CELls [VERify]
Display
{ IFP
} [STATE]
{ ifpname }
Display
{ SESSIONS COORD name [RESOLVED] }

INDoubt {
} [HOST id]
{ COORDS
}
Display
POOL {ID poolid}

{ALL
}
Display
Queues
Display
{
{ sessnumber } }
{ SESsions { ENDing
} }
{
{ ALL
} }
{
}
{ JOB jobname
}
Display
SMF
Display
[TDP]
ENAble
IRF
ENAble
LGUX
ENAble
LOGONS
Page 60
ENAble
POOL
ENAble
SESSRSRV
ENAble
SMF
ENAble
TEST
ENAble
TIMe
ENAble
TMON
ENAble
UAX
ENAble
USEC
LOGOFF
{
{ sessnumber } }
{ SESsions {
} }
{
{ ALL
} }
{
}
{ JOB jobname
}
LOGOFF
MODIFY
POOL
POOL
{ ID poolid }
{ ALL
}
{ SUBn
{ ALL
[... SUBn] }
}
{ID poolid}
{ALL
}
ID poolid
NUM number
{ ALL
}
ROLLBACK {
} COORD name [ HOST id ]
{ SESSION number }
RUN
[TDPn]
SET
{ comchar }
COMchar {
}
{ OFF
}
Page 61
SET
MAXSess numberofsessions
{ CANCEL }
SHUTDOWN { QUIck
}
{ Orderly }
STArt
ifpname
STArt
POOL
DDNAME filename
STArt
POOL
NUM number [JOB jobname] [RUN string] [ID poolid]

CHarset charactersetname
{ LOG username, password [, 'acctid'] }
{ NULLpwd LOG username
[,,'acctid'] }
STOp
ifpname
STOp
POOL
Page 62
{ID poolid}
{ALL
}
CONSOLE OPERATOR COMMANDS
{ hostid:session# }
{ hostid.username }
SESSION {
*.username } [LOGOFF] [LIST] [OVERRIDE]
{ hostid.*
}
{
*.*
}
ABORT
CNSGET
CNSSET
{
{
{
{
DBWTIMEOUT
LINES
STATEPOL
TIMEOUT
DISABLE
LOGONS
ENABLE
LOGONS
GET
GRANT
start
{
{
{
{
{
{
{
{
}
} n
}
}
CONFIG
LOGTABLE { tblname }
{ ALL
}
PERMISSIONS userid@host
RESOURCE
TIME
VERSION
SSO
userid@host
priv
}
}
}
}
}
}
}
}
[... priv]
RSS Table names:

SVPR
all
log
SPMA
abort
SCTL
grant
IPMA
SLDV
logons
set
restart
interactive(<pgmname>)
LOG
ErrorLogText
QUERY
STATE
RESTART
{ NODUMP
}
TPA [ { DUMP={YES} } ]
{
{NO } }
REVOKE
userid@host
SET
LOGTABLE
priv
{ COLD
}
[ { COLDWAIT } ]
commentstring
[... priv]
{ ALL
} {ON }
{ tblname } {OFF}
See above for table names
Page 63
SHST
SET
RESOURCE COLL[ECTION] n1 { NODE } LOG[GING] n2

{ VPROC }
SET
SESSION COLL[ECTION] n
SET
{ OFF }
SSO { ON
}
{ ONLY }
START
{
{
{
{
{
{
{
{
{
1 ]
[-Vn
] {
2 ] [,DEBUG] [,VPROC=n] {
3 ]
[-V=n
] {
4 ]
{
{
{
{
{
{
{
{
{
[
[
[
[
{
{
{
{
STOP
1
2
3
4
ABORTHOST
CHECKTABLE
CONFIG
DBSCONTROL
DIP
DUMPLOCKLOG
FERRET
FILER
LOCKDISP
QRYCONFIG
QRYSESSN
RCVMANAGER
REBUILD
RECONFIG
SHOWLOCKS
SYSINIT
TPCCONS
UPDATEDBC
UPDATESPACE
VPROCMANAGER
XGTWGLOBAL nw
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
Subcommand for CHECKTABLE:
{
CHECK {
{
{
ALL TABLES
}
dbname
}
dbname.tblname }
<wildcard spec>]}
[
[
[ BUT
[
[
[
{
{ ONLY } {
{
} {
{ NOT } {
{
{
INDEX ID = nnn
UNIQUE INDEXES
NONUNIQUE INDEXES
DATA
REFERENCE indexes
REFERENCE ID= nnn
}
}
}
}
}
}
]
]
]
]
]
]
{ ONE }
AT LEVEL { TWO } [ WITH {NO ERROR LIMIT } ]
{ THREE } [
{ERROR LIMIT = n} ]
[ SKIPLOCKS ] [ IN { SERIAL
} ] [ PRIORITY = pg ]
{ PARRALLEL }
Subcommands for FERRET:
DATE
Page 64
DEFRAG[MENT] [/Y]
ERRORS
[ TO
{ file
} ]
[ INTO { STDERR } ]
[ OVER { ME
} ]
EXIT
(Same as END, QUIT, STOP)
H[ELP]
[ keyword ]
[/L] [ ALL
]
[ ?
]
IN[PUT]
FROM file
[ TO
{ file
} ]
OUT[PUT] [ INTO { STDERR } ]
[ OVER { ME
} ]
PACKDISK [/Y] [ { FREE [SPACEPERCENT] } [=] n ]

[ { FSP
}
]
Q[UIT]
RADIX
(Same as END, EXIT, STOP)
[ IN[PUT] ] [ H[EX] ]
[ OUT[PUT] ] [ D[EC] ]
[/S] [ DB
SCANDISK [/M] [ CI
[/L] [ MI
[ FREE[CIS]
SCOPE
]
] [ FIX ]
]
]
{ALL
{PER[MANENT]
{PJ
{SP[OOL]
{( PER[MANENT] [, PJ] [, SP[OOL]] )
{CY[LINDER] {ALL
}
[ CLASS {
{drive cyl [... drive cyl]}
{TA[BLE]
{ALL
}
{
{tableid
[... tableid]}
{VPROC
{ALL
}
{
{vprocid}
}
{
{(vprocid TO vprocid)}
}
}
}
}
}
}
} ]
}
}
}
}
}
[/S]
SHOWBLOCKS [/M]
[/L]
Page 65
SHOWD[EFAULTS]
SHOWFSP
SHOWSPACE [/S]
[/L]
TABLEID
{ dbname.tblname }
{ dbname.tblname }
TIME
Subcommands for RCVMANAGER:
{ STATUS }
LIST {
} ;
{ LOCKS }
Subcommands for REBUILD:
QUERY
{ALL TABLES } {ALL

}
REBUILD AMP nnnn {dbname
} {PRIMARY } DATA [, Options] ;
{dbname.tname} {FALLBACK}
REBUILD AMP nnnn FALLBACK TABLES [, Options] ;
RESTART REBUILD ON AMP nnnn ;
Options:
LOG INTO logDB.logTbl
NO LOCK [ON NO FALLBACK TABLES]
{DATABASE}
WITH {TABLE
} LOCK
{ROWRANGE}
Page 66

TD

Uploaded by

TD

Uploaded by

Teradata DBMS

Quick Reference Guide

Syntax Conventions ..................

Teradata SQL Statements .............

Teradata SQL Statement Modifiers .... 16

Uppercase characters indicate keywords.

Lower case characters indicate that a value or name is to be substituted in their

Underscores indicate the default value.

Special characters, including blanks, are required as shown unless specified

Braces {} indicate a choice of options; one of these choices must be entered.

A vertical bar | indicates alternatives (same as braces, but on one line)

Brackets [] indicate an optional entry.

Horizontal ellipses indicate a phrase that can be repeated.

Vertical ellipses indicate omitted portions of the statement or command.

Teradata DBMS Quick Reference Guide

TERADATA SQL STATEMENTS

SQL statements are listed alphabetically. Defaults are underscored.

ALTER TABLE [dbname.]tname [,option [... ,option] ]

[ { DROP RANGE { WHERE expr [..., expr]

[ { MODIFY [UNIQUE] PRIMARY INDEX [idxname | (cname [..., cname])]

[ { REVALIDATE PRIMARY INDEX [WITH {DELETE | INSERT [INTO] tname}]

Any of the following options may be listed in any order:

WITH JOURNAL TABLE = [dbname.] tname

The following options apply to Temporary tables only:

Teradata DBMS Quick Reference Guide

ALTER TRIGGER [dbname.]name {DISABLED}

Indexes Per Table

VOSI Typical Percent

only INSERT EXPLAIN NEW INDEX statements may be used here

BEGIN INSERT WORKLOAD INTO qcdname AS workloadname ;

{BEGIN} QUERY LOGGING on ***TODO***

CALL [dbname.]tname ( [parm [(attributes)] [... ,parm [(attributes)] ] ] )

CHECKPOINT tname [ ,NAMED chkptname ]

COLLECT { STAT[ISTICS] | STATS } [ FOR SAMPLE percent [ PERCENT ] INTO qcdname ]

Teradata DBMS Quick Reference Guide

Teradata DBMS Quick Reference Guide

DEFAULT JOURNAL TABLE = [dbname.]tname

CREATE [UNIQUE] INDEX [name] [ALL] (cname [... ,cname ] )

CREATE HASH INDEX name (cname [... ,cname ])

CREATE JOIN INDEX name [, FALLBACK] AS

{ tname [[AS] aname ] [..., tname [[AS] aname ]]

(cname [..., cname ] ) ] [ ORDER BY [HASH ] [(cname)] ]

Teradata DBMS Quick Reference Guide

( [USING clause] [LOCKING clause] statement; [... statement; ] )

CREATE PROFILE name [ AS option [ ... ,option ] ]

CREATE ROLE rolename ;

Teradata DBMS Quick Reference Guide

Applies to Temporary tables only

Teradata DBMS Quick Reference Guide

Any of the following options may be listed in any order:

WITH JOURNAL TABLE = [dbname.]tname

[CONSTRAINT name] {PRIMARY KEY} (cname [... ,cname])

Optional phrases (general):

COMPRESS {value | NULL }

Teradata DBMS Quick Reference Guide

CREATE USER username [FROM ownerdb]

DEFAULT JOURNAL TABLE = [dbname.]tname

TIME ZONE = { LOCAL | NULL | [-] hh:mm }

Teradata DBMS Quick Reference Guide

[WITH CHECK OPTION] [ORDER BY clause]

DEL[ETE] FROM tname [[AS] aname]]

DIAGNOSTIC ValidateIndex ON FOR SESSION;

DROP INDEX [ALL] { ( cname [... ,cname ] ) }

Teradata DBMS Quick Reference Guide

[ (expr [... ,expr ] )

GIVE name TO recipientname

{ hostid [... ,hostid] }

cname [... ,cname] FROM tname [... ,tname ]

Teradata DBMS Quick Reference Guide

MODIFY DATABASE dbname

[DEFAULT JOURNAL TABLE = [dbname.]tname ]

MODIFY PROFILE name [ AS option [ ... ,option ] ]

Teradata DBMS Quick Reference Guide

MODIFY USER username

[DEFAULT JOURNAL TABLE = [dbname.]tname ]

TIME ZONE = { LOCAL | NULL | [-] hh:mm }

{BEGIN} QUERY LOGGING on TODO