$TLEVEL

Synopsis

$TLEVEL
$TL

概要

$TLEVEL は、入れ子の開いているトランザクションの数である、現在のトランザクション・レベルを含みます。発行された TSTART コマンドの数がトランザクション・レベルを決定します。

• 各 TSTART は $TLEVEL を 1 つインクリメントします。

• 各 TCOMMIT は $TLEVEL を 1 つデクリメントします。

• 各 TROLLBACK 1 は $TLEVEL を 1 つデクリメントします。

• TROLLBACK は $TLEVEL を 0 にリセットします。

0 の $TLEVEL はデクリメントできません。$TLEVEL=0 が処理を実行しないとき、TROLLBACK (または TROLLBACK 1) が発行されます。$TLEVEL=0 のときに TCOMMIT を発行すると、<COMMAND> エラーが返されます。

トランザクションの最大レベル数は 255 です。255 のトランザクション・レベルを超えると、<TRANSACTION LEVEL> エラーになります。

この特殊変数は、SET コマンドを使用して変更することはできません。変更を試みると、<SYNTAX> エラーが返されます。

トランザクション・レベルとターミナル・プロンプト

既定では、$TLEVEL がターミナル・プロンプトから実行されるコマンド行またはプログラムの最後で 0 よりも大きい場合は、現在のトランザクション・レベルがターミナル・プロンプトの接頭語として表示されます。

• $TLEVEL=0 の場合は、ターミナル・プロンプトは現在のネームスペース名を表示します (既定)。例えば、USER> です。

• $TLEVEL>0 の場合は、ターミナル・プロンプトではネームスペース名の前に TLn: 接頭語が表示されます。n は 1 ～ 255 までの整数です。例えば、TL4:USER> です。

このターミナル・プロンプトは、ZNSPACE の説明に従って構成できます。

SQL シェル・プロンプトには、現在のトランザクション・レベルは表示されません。SQL シェルの終了時には、現在の $TLEVEL 値がターミナル・プロンプトに表示されます。これには、SQL シェルを起動する前に設定されたトランザクション・レベルと SQL シェル内で発生したトランザクション・レベルの変更が含まれる場合があります。

MV コマンド (引数なし) は、インタラクティブな MultiValue シェルを開始し、開いているトランザクションを即座にロールバックします。MultiValue シェル終了時の現在の $TLEVEL 値は 0 です。MV コマンドを MultiValue コマンド行の引数と使用しても現在のトランザクション・レベルには影響を与えません。

例

以下の例では、TSTART が $TLEVEL をインクリメントし、各 TCOMMIT が $TLEVEL をデクリメントします。

  WRITE !,"transaction level ",$TLEVEL  // 0
  TSTART
  WRITE !,"transaction level ",$TLEVEL  // 1
  TSTART
  WRITE !,"transaction level ",$TLEVEL  // 2
  TCOMMIT
  WRITE !,"transaction level ",$TLEVEL  // 1
  TCOMMIT
  WRITE !,"transaction level ",$TLEVEL  // 0

以下の例では、TSTART を繰り返し呼び出すことで $TLEVEL をインクリメントし、各 TROLLBACK 1 が $TLEVEL をデクリメントします。

  WRITE !,"transaction level ",$TLEVEL  // 0
  TSTART
  WRITE !,"transaction level ",$TLEVEL  // 1
  TSTART
  WRITE !,"transaction level ",$TLEVEL  // 2
  TROLLBACK 1
  WRITE !,"transaction level ",$TLEVEL  // 1

以下の例では、TSTART を繰り返し呼び出すことで $TLEVEL をインクリメントし、TROLLBACK が $TLEVEL を 0 にリセットします。

  WRITE !,"transaction level ",$TLEVEL  // 0
  TSTART
  TSTART
  TSTART
  WRITE !,"transaction level ",$TLEVEL  // 3
  TROLLBACK
  WRITE !,"transaction level ",$TLEVEL  // 0

以下の例は、$TLEVEL が 0 の場合に、TROLLBACK コマンドが効果がないことを示します。

  WRITE !,"transaction level ",$TLEVEL  // 0
  TROLLBACK
  WRITE !,"transaction level ",$TLEVEL  // 0
  TROLLBACK 1
  WRITE !,"transaction level ",$TLEVEL  // 0
  TROLLBACK
  WRITE !,"transaction level ",$TLEVEL  // 0

関連項目

• TCOMMIT コマンド

• TROLLBACK コマンド

• TSTART コマンド

• "Caché ObjectScript の使用法" の "トランザクション処理での ObjectScript の使用法"