目的
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 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