目的
BTEQの1つまたはすべての設定の現在の値を標準出力ストリームに出力します。
構文
構文規則:
| <cmd>は次のとおり | ||
|---|---|---|
| CHARSET | LOGONPROMPT | RTITLE |
| DECIMALDIGITS | MAXERROR | RUN |
| ECHOREQ | MESSAGEOUT | SEPARATOR |
| ENCRYPTION | NOTIFY | SESSION CHARSET |
| ERRORLEVEL | NULL | SESSION RESPBUFLEN |
| EXPORT | OMIT | SESSION SQLFLAG |
| EXPORTEJECT | PACK | SESSION TRANSACTION |
| FOLDLINE | PAGELENGTH | SESSION TWORESPBUF |
| FOOTING | PREPAREMODE | SESSIONS |
| FORMAT | PAGEBREAK | SIDETITLES |
| FORMCHAR | QUIET | SKIPDOUBLE |
| FULLYEAR | RECORDLENGTH | SKIPLINE |
| HEADING | RECORDMODE | STATEMENTINDEPENDENCE |
| IMPORT | REPEAT | SUPPRESS |
| INDICATORMODE | REPEATSTOP | TDP |
| LARGEDATAMODE | REPORTALIGN | TIMEMSG |
| LIMITS | RETCANCEL | TITLEDASHES |
| LOGMECH | RETLIMIT | UNDERLINE |
| LOGON | RETRY | WIDTH |
使用上の注意
SHOW CONTROLSコマンドは、ユーザーが制御するBTEQの書式設定を確かめるために使用します。 (SHOW CONTROLSの表示は、QUIETコマンドによって抑制されることはありません。)
パラメータなしでSHOWコマンドを入れると、最後に使用したSQL文が表示されます。
SHOW CONTROLSコマンドはTeradata SQLマクロで使用できます。
任意ですが、SHOW CONTROLSコマンドは設定レベルで使用できます。
例えば、SHOW CONTROLS <cmd>で、"cmd"は任意の設定とすることができ、[SET] <cmd> = <value>として制御の表示に反映されます。
キーワード"LIMITS"は、SHOW CONTROLSコマンドと一緒に設定レベルで使うことができます。出力には、事前定義のデフォルト、最大セッション数や最大命令バイト数などの該当する設定の最小値と最大値が一覧表示されます。いくつかの項目にはデータベース制限が公開されており、データベース接続が未確立の場合には"NA"が表示されます。
SHOW CONTROLSコマンドの出力の"Client Platform Byte Order"行は、クライアント マシンのエンディアン タイプを示します。 SHOW CONTROLSコマンドと一緒に使用するキーフレーズ"byte order"は、設定レベルで出力を表示します。
例1 – SHOW CONTROLS
すべての制御の現在値を見るためには、次のように指定します。
.SHOW CONTROLS
BTEQの応答
メインフレーム接続システムとワークステーション接続システムでは、返される情報が異なります。
次はOSにBTEQを使用しているときに返される情報の例です。
.show controls ;
Maximum Instruction Bytes = 1048500
Maximum Record Bytes = 1024000
Maximum Request Buffer Bytes = 7340032
Maximum Response Buffer Bytes = 16775168
Maximum Packed Records = 64000
Activity Count Bytes = 8
Maximum Sessions = 200
Maximum Repeat Factor = 2147483647
Maximum String Length = 254
Maximum Report Columns = 65535
Maximum WITH Clauses for a Report = 10
Maximum Report Title Lines = 10
Maximum Report Page Lines = 2147483407
Minimum Report Width = 20
Maximum Report Width = 1048575
Maximum Notify MSG Text Bytes = 254
Maximum Bytes Saved for SUPPRESS,
PAGEBREAK, SKIPLINE, UNDERLINE,
and SKIPDOUBLE Commands, and for
&n Substitutions = 256
Client Platform Byte Order = BIG ENDIAN
EXPORT RESET
IMPORT RESET
LOGMECH = default
LOGON
REPEAT = 1
RUN
[SET] AUTOKEYRETRIEVE = OFF
[SET] DECIMALDIGITS = 0 (SPB DEFAULT)
[SET] ECHOREQ = ON
[SET] ENCRYPTION = OFF
[SET] ERRORLEVEL = ON
[SET] ERROROUT = STDOUT
[SET] EXPORTEJECT = ON
[SET] FOLDLINE = OFF ALL
[SET] FOOTING = NULL
[SET] FORMAT = OFF
[SET] FORMCHAR = DEFAULT
[SET] FULLYEAR = OFF
[SET] HEADING = NULL
[SET] INDICATORMODE (alias INDICDATA) = OFF
[SET] LARGEDATAMODE = OFF
[SET] MAXERROR = OFF
[SET] NOTIFY = OFF
[SET] NULL = ?
[SET] OMIT = OFF ALL
[SET] PACK = 0
[SET] PAGEBREAK = OFF ALL
[SET] PAGELENGTH = 55
[SET] PREPAREMODE = OFF
[SET] QUIET = OFF
[SET] RECORDLENGTH = Import/Export: MAX64 SYSPRINT: MAX1MB
[SET] RECORDMODE = OFF
[SET] REPEATSTOP = OFF
[SET] REPORTALIGN = EQUALWIDTH
[SET] RETCANCEL = OFF
[SET] RETLIMIT = Rows: No Limit Columns: 100
[SET] RETRY = ON
[SET] RTITLE = NULL
[SET] SEPARATOR = two spaces
[SET] SESSION CHARSET = EBCDIC
import/export encoding = EBCDIC
stdin/stdout encoding = EBCDIC
[SET] SESSION RESPBUFLEN = 32767
[SET] SESSION SQLFLAG = NONE
[SET] SESSION TRANSACTION = BTET
[SET] SESSION TWORESPBUFS = ON
[SET] SESSIONS = 1
[SET] SIDETITLES = OFF for the normal report.
And, it is ON for results of WITH clause number: 1 2 3 4 5 6 7 8 9 10.
[SET] SKIPDOUBLE = OFF ALL
[SET] SKIPLINE = OFF ALL
[SET] STATEMENTINDEPENDENCE = OFF
[SET] SUPPRESS = OFF ALL
[SET] TDP = NULL
[SET] TIMEMSG = DEFAULT
[SET] TITLEDASHES = ON for the normal report.
And, it is ON for results of WITH clause number: 1 2 3 4 5 6 7 8 9 10.
[SET] TRIMTRAILINGSPACES = ON
[SET] UNDERLINE = OFF ALL
[SET] WIDTH = 75
ログオフによるデフォルトのリセット
LOGONおよびLOGOFFコマンドによって書式設定コマンドの値がデフォルト値にリセットされることはありません。 最初のBTEQセッションからログオフし、もう一度LOGONコマンドを使用した場合、新しいセッションでは、前のセッションでの書式設定コマンドの値が引き継がれます。 書式設定コマンドの設定を最初のデフォルト値にリセットする場合には、DEFAULTSコマンドを使用しなければなりません。
書式設定コマンドが上記の値になるのは、BTEQ呼び出し後に初めてLOGONコマンドを実行したときと、DEFAULTSコマンドを使用したときだけです。
例2 – マクロによって出力されるSHOW CONTROLS
ワークステーション接続システムのTeradata SQLマクロでは、例1のSHOW CONTROLSコマンドは次のようになります。
ECHO '.SHOW CONTROLS';
*** Echo accepted.
*** Total elapsed time was 1 second.
Maximum Instruction Bytes = 1048500
Maximum Record Bytes = 1024000
Maximum Request Buffer Bytes = 7340032
Maximum Response Buffer Bytes = 16775168
Maximum Packed Records = 64000
Activity Count Bytes = 8
Maximum Sessions = 200
Maximum Repeat Factor = 2147483647
Maximum String Length = 254
Maximum Report Columns = 65535
Maximum WITH Clauses for a Report = 10
Maximum Report Title Lines = 10
Maximum Report Page Lines = 2147483647
Minimum Report Width = 20
Maximum Report Width = 1048575
Maximum Notify MSG Text Bytes = 254
Maximum Bytes Saved for SUPPRESS
PAGEBREAK, SKIPLINE, UNDERLINE
and SKIPDOUBLE Commands, and for
n Substitutions = 256
Client Platform Byte Order = LITTLE ENDIAN
EXPORT RESET
IMPORT RESET
LOGMECH = default
LOGON
REPEAT = 1
RUN
[SET] AUTOKEYRETRIEVE = OFF
[SET] DECIMALDIGITS = 0 (SPB DEFAULT)
[SET] ECHOREQ = OFF
[SET] ENCRYPTION = OFF
[SET] ERRORLEVEL = ON
[SET] ERROROUT = STDERR
[SET] EXITONDELAY = OFF
[SET] FOLDLINE = OFF ALL
[SET] FOOTING = NULL
[SET] FORMAT = OFF
[SET] FORMCHAR = OFF
[SET] FULLYEAR = OFF
[SET] HEADING = NULL
[SET] INDICATORMODE (alias INDICDATA) = OFF
[SET] LARGEDATAMODE = OFF
[SET] LOGONPROMPT = ON
[SET] MAXERROR = OFF
[SET] NOTIFY = OFF
[SET] NULL = ?
[SET] OMIT = OFF ALL
[SET] PACK = 0
[SET] PAGEBREAK = OFF ALL
[SET] PAGELENGTH = 55
[SET] PREPAREMODE = OFF
[SET] QUIET = OFF
[SET] RECORDLENGTH = Import/Export: MAX64 Stdout: MAX1MB
[SET] RECORDMODE = OFF
[SET] REPEATSTOP = OFF
[SET] REPORTALIGN = COMPATIBLE
[SET] RETCANCEL = OFF
[SET] RETLIMIT = Rows: No Limit Columns: 100
[SET] RETRY = ON
[SET] RTITLE = NULL
[SET] SEPARATOR = two spaces
[SET] SESSION CHARSET = ASCII
import/export encoding = ASCII
stdin/stdout encoding = ASCII
[SET] SESSION RESPBUFLEN = 8192
[SET] SESSION SQLFLAG = NONE
[SET] SESSION TRANSACTION = BTET
[SET] SESSION TWORESPBUFS = ON
[SET] SESSIONS = 1
[SET] SIDETITLES = OFF for the normal report.
And, it is ON for results of WITH clause number: 1 2 3 4 5 6 7 8 9 10.
[SET] SKIPDOUBLE = OFF ALL
[SET] SKIPLINE = OFF ALL
[SET] STATEMENTINDEPENDENCE = OFF
[SET] SUPPRESS = OFF ALL
[SET] TDP = dbc
[SET] TIMEMSG = DEFAULT
[SET] TITLEDASHES = ON for the normal report.
And, it is ON for results of WITH clause number: 1 2 3 4 5 6 7 8 9 10.
[SET] TMSMMSG = OFF
[SET] TRIMTRAILINGSPACES = ON
[SET] UNDERLINE = OFF ALL
[SET] WIDTH = 75