7.11 otstranlist

名前

otstranlist －トランザクションの状態管理

形式

otstranlist

機能説明

otstranlistコマンドは、処理中のトランザクションの状態管理に使用します。本コマンドはOTSシステムの起動中に実行します。本コマンドは、実行中のトランザクションの一覧を出力します。ユーザは出力されたトランザクションの一覧に対してcommitまたはrollbackを操作します。

サブコマンド

以下に、otstranlistコマンドのサブコマンドを説明します。

info [-tampicr]

処理中のトランザクションの一覧を表示します。出力内容を以下に説明します。

No: トランザクション一覧の項番

Transaction-ID: トランザクションごとに割り振られる識別子

Status:     トランザクションの状態（get_statusの情報）
    トランザクションの状態には以下の状態があります。
      Active: トランザクション実行中
      MarkRB: ロールバックにマーク
      Prepared: プリペアされた
      Unknown: 不明
      Preparing: プリペア中
      Comiting: コミット中
      Commited: コミットされた
      RingBack: ロールバック中
      RollBack: ロールバックされた

Result:     トランザクション操作の結果以下の状態があります。
      成功時 : Normal
      異常時 : Error
      表示なし: トランザクション操作を行っていない

Start: トランザクションの開始時間（24H形式）

Timeout: トランザクションのタイムアウト値（set_timeoutの情報）

また、オプションを指定することで、トランザクションの状態をキーにフィルタリングすることができます。

-t: すべてのトランザクションを表示します。（デフォルト）

-a: 実行中のトランザクションを表示します。

-m: ロールバックにマークされたトランザクションを表示します。

-p: プリペアされたトランザクションを表示します。

-i: プリペア中のトランザクションを表示します。

-c: コミット中のトランザクションを表示します。

-r: ロールバック中のトランザクションを表示します。

commit n [, n1, ...]: nで指定するトランザクションをcommitします。nにはトランザクションの一覧で表示されるNoを指定します。またnにallを指定することにより、すべてのトランザクションをcommitすることができます。

rollback n [, n1, ...]: nで指定するトランザクションをrollbackします。nにはトランザクションの一覧で表示されるNoを指定します。またnにallを指定することにより、すべてのトランザクションをrollbackすることができます。

scroll: トランザクション一覧画面を下スクロールします。

save filename:   表示中のトランザクション一覧をfilenameで指定したファイルに保存します。
  filenameに指定できるパス名の最大長は251バイトです。

  補助文字を含むパス名は指定できません。

help: otstranlistコマンドのサブコマンド一覧を出力します。

quit: otstranlistコマンドを終了します。

注意事項

本コマンドは、管理者権限だけが実行可能です。
otstranlistコマンドのサブコマンドinfoを実行した際の1画面に出力されるトランザクション一覧の行数は20行(デフォルト)です。1画面に出力される一覧の行数を変更する場合は、環境変数OTS_SCROLL_SIZEに1画面に出力したいトランザクション一覧の行数を設定してください。環境変数OTS_SCROLL_SIZEはotstranlistコマンドおよびotspendlistコマンドのトランザクション一覧を1画面に表示できる行数を設定します。
commit, rollbackサブコマンドのパラメタにallが指定された場合は、infoサブコマンドで表示されたすべてのトランザクションが対象となります。
saveサブコマンドのパラメタに空白を含むパスを指定する場合、半角ダブルクォート（”）で囲まなければなりません。
ターミナルにより、サブコマンドの入力行が256文字に制限される場合があります。
コマンド実行時には、データベース連携サービス(サービス名:ObjectTransactionService)およびCORBAサービス(サービス名:OD_start,Naming Service)が起動されている必要があります。停止している場合には、手動でサービスを起動してからコマンドを投入するようにしてください。
CORBAサービスおよびネーミングサービスが起動されている必要があります。

使用例

実行中のトランザクション一覧を出力し、一覧上のNo.1のトランザクションをrollbackする場合

  otstranlist
    info
        No  Transaction-ID    Status    Result    Start-Time  Timeout
       ---  --------------    ------    ------   ----------   -------
        1  a155d0a10abb       active               20:24:11        0
        2  a156d0c20431       active               20:40:05       60
    rollback 1
    quit