7.4 otspendlist

Interstage Application Server リファレンスマニュアル（コマンド編）

目次索引

第2部 OLTPシステム運用編

> 第7章データベース連携サービス運用コマンド

7.4 otspendlist

名前

　otspendlist　－　インダウト状態のトランザクションの回収

形式

　otspendlist { -s | -n リソース定義名}

機能説明

　otspendlistコマンドは、リソース管理プログラムの未解決トランザクションを回収する場合に使用します。
　以下に、otspendlistコマンドのオプションを説明します。

-s

　OTSシステム側の未解決トランザクションリストを表示します。本コマンドを実行する場合、OTSシステムが動作していなければいけません。

-n リソース定義名

　指定されたリソース定義名で起動したリソース管理プログラムの未解決トランザクションリストを表示します。本コマンドを実行する場合、関連するデータベース、リソース管理プログラムが動作していなければいけません。

　リソース管理プログラムの未解決トランザクションを解決する場合、OTSシステムおよびリソース管理プログラムの未解決トランザクションの一覧を比較し、以下のようにリソース管理プログラムのcommit、rollbackを決定する必要があります。もしcommitするべきところをrollbackした場合はデータベースに矛盾が発生するため細心の注意が必要です。

OTSシステムに同一の未解決トランザクションが存在するか	リソース管理プログラム側での操作
存在する	commit
存在しない	rollback

サブコマンド

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

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

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

　Status
　　トランザクション回収操作後の状態。以下の状態があります。
　　　Commited: コミットした
　　　RollBack: ロールバックした
　　　deleted : 削除した
　　　表示なし: トランザクション回収操作を行っていない

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

commit n [, n1, ...]
　nで指定するトランザクションをcommitします。nにはトランザクションの一覧で表示されるNoを指定します。またnにallを指定することにより、すべてのトランザクションをcommitすることができます。本コマンドは、リソース管理プログラムの未解決トランザクションリスト表示時に有効です。

rollback n [, n1, ...]
　nで指定するトランザクションをrollbackします。nにはトランザクションの一覧で表示されるNoを指定します。またnにallを指定することにより、すべてのトランザクションをrollbackすることができます。
　本コマンドは、リソース管理プログラムの未解決トランザクション一覧表示時に有効です。

delete n [, n1, ...]
　nで指定するトランザクションログを削除します。nにはトランザクションの一覧で表示されるNoを指定します。またnにallを指定することにより、すべてのトランザクションログを削除することができます。本コマンドは、OTSシステムの未解決トランザクションリスト表示時に有効です。
　通常OTSシステムの未解決トランザクションはリカバリ処理が完了した時点で削除されるので、通常は削除する必要はありませんが、以下の場合に削除する必要があります。

対象のリソース管理プログラムを別ホストに移動しました。
対象のリソース管理プログラムを削除しました。

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

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

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

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

注意事項

本コマンドは、管理者権限だけが実行可能です。
otspendlistコマンドを使用した場合、データベースの不整合が生じる可能性があります。ネットワークの回線を復旧し、OTSシステムおよびリソース管理プログラムを再起動することによるリカバリ処理を行うことを推奨します。
otspendlistコマンドのサブコマンド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サービスが起動されている必要があります。

使用例

　未解決のトランザクション一覧を出力し、すべてのトランザクションをrollbackする場合

  otspendlist -n resource1
  info
     No   Transaction-ID    Status    Result
     ---  --------------    ------    ------
     1  a155-d0a1-0abb
     2  a156-d0c2-0431
  rollback all
  quit

目次索引