5. CORBA

5.1. 例外クラス名

5.2. 例外のマイナーコード一覧

例外のマイナーコードにはOMGが標準として定義しているコードとWebOTXが独自に定義しているコードの2種類あります。

5.2.1. OMG標準定義

いくつかの標準システム例外について、次のように採番されています。

OMGのマイナーコードには、OMGを特定するOMGVMCID（0x4f4d0000）と論理和をとった値が使用されています。

5.2.2. WebOTX Object Broker Java^TM

WebOTX Object Broker C++ではマイナー番号は1000番台ですが、WebOTX Object Broker Java^TM では5000番台になっています。

JavaのクライアントからC++のサーバを呼び出したときに例外が発生すると、例外がサーバで起きたのかクライアントで起きたのかわかりません。しかし、WebOTX Object Broker Java^TM のマイナー番号は5000番台ですから、もしもマイナー番号が5000番台ならばJavaクライアント側であることが推測できます。

マイナーコードはjp.co.nec.orb.SystemExceptionPackageパッケージに含まれています。以下にその定義の一部を示します。

package jp.co.nec.orb.SystemExceptionPackage;

public interface Minor {

    // minor number

    public static final int STARTERRNUM = 5000;

    public static final int BAD_MAGIC = STARTERRNUM+1;

    public static final int BAD_GIOP_VERSION = STARTERRNUM+2;

    public static final int BAD_IIOP_VERSION = STARTERRNUM+3;

    ...

}

マイナーコードはORBの各ベンダが独自に決めています。したがって マイナーコードの判定結果により処理を分岐させるプログラムは、 ポータビリティがありません。また、WebOTX Object Broker Java^TM において、 今後のOMGでの標準化の進展に伴い、CORBA標準に準拠させるために マイナーコードを変更する可能性があります。マイナーコードは問題発生時の 原因解析のために使用することができます。

5.2.3. WebOTX Object Broker C++

5.2.4. Transactionサービス

5.2.4.1. Transactionサービス共通

以下に示すコードの形式はC++のものです。Javaの場合は、EMinor_部分を
jp.co.nec.WebOTX_S.OTXSCurパッケージのCurMinorのメンバに読みかえてください。
例えば、C++でのEMinor_BAD_INV_ORDERは、Javaではjp.co.nec.WebOTX_S.OTXSCur.CurMinor.BAD_INV_ORDERとなります。

5.2.4.2. RCS

5.2.4.3. RecoveryServer

5.2.4.4. ResourceManager

5.2.4.5. Current

以下はC++でのコードです。Javaの場合は、EMinor_部分を
jp.co.nec.WebOTX_S.OTXSCurパッケージのCurMinorのメンバに読みかえてください。
例えば、C++でのEMinor_NO_TXCONTEXTは、Javaではjp.co.nec.WebOTX_S.OTXSCur.CurMinor.NO_TXCONTEXTとなります。

5.3. Standard/Enterprise のCORBA例外

Standard、およびEnterpriseに実装されているトランザクションモニタ機能は、検出した障害をCORBAシステム例外としてクライアントへ返却します。ここではこのとき返却されるCORBAシステム例外について説明します。なお、これまでのバージョンでは、CORBA例外の種別と実際のエラーの事象の対応が妥当ではない、完了状態(completion_status)を考慮していない、一部の例外が他ベンダとの相互接続において相性が悪い、などの問題がありました。そのため本バージョンでは例外種別の見直しを行っており、(既定の設定では)従来の割り当てとの互換がありません。互換を保ったモードの使用方法及び説明については5.3.2、5.3.3を参照してください。

5.3.1. CORBA例外一覧

説明の見方

例外を次の書式で説明しています。
1行目：マイナーコードのマクロ(マイナー番号),完了状態
2行目：事象の説明
3行目：対処方針
また、説明は例外クラスごとに分けて記載しています。
マイナーコードのマクロは、Javaの場合、jp.co.nec.WebOTX.exceptionsパッケージのWOMinorクラスに定義されています。このclassファイルはsvsimjパッケージに含まれています。
C++の場合、以降で説明しているマクロ名の頭にWOMinor_を付加したものになり、WOMinor.hで定義しています。
一部定義していないマクロがあります。
完了状態(completion_status)の正式な値はCOMPLETED_NO、COMPLETED_MAYBEですが、ここではそれぞれno、maybeと略して記載しています。

5.3.1.1. ユーザ要因の例外

例外クラス名 CORBA::NO_RESPONSE

NO_RESPONSE_FROM_AP(3920), completion_status=maybe

[説明]

サーバアプリケーションがAP応答監視タイマで設定した時間内に応答を返しませんでした。

[対処]

サーバトレースなどでオペレーションに時間がかかる原因を調べてください。必要があればAP応答監視タイマの設定を見直してください。

OP_RETRY_OVER(3922), completion_status=no

[説明]

TPSRestart()によるオペレーションの再実行、もしくはDB連携機能でデッドロック自動検出後のオペレーション再実行の回数が、再試行回数で設定した値を超えました。

[対処]

サーバトレースなどでオペレーションが再実行となった原因を調査してください。必要があればオペレーション再試行回数の設定を見直してください。

ELPTIME_OVER(3927), completion_status=maybe

[説明]

オペレーションの実行時間が実行時間上限で設定した時間を超えたため、処理を打ち切りました。

[対処]

サーバトレースなどで処理に時間がかかる原因を調査してください。必要があれば実行時間上限の設定を見直してください。

例外クラス名 CORBA::UNKNOWN

SET_TX_STATUS(3921), completion_status=no

[説明]

TPSSetTxStatus()で終了状態に0以外の値が設定されたため、オペレーションの終了状態が不正となりました。

[対処]

サーバトレースなどで終了状態に0以外を設定した原因を調査してください。

EXCEPTION_OCCURRED(3923), completion_status=maybe

[説明]

オペレーション実行中に例外が発生しました。

[対処]

syslog（イベントログ)に出力されたTPS10-04401メッセージのCODEを確認し、オペレーションの処理を見直してください。CODEにはUNIX版ではシグナル番号、Windows版ではGetExceptionCode()が返す値が入ります。

TPSABORT_T_END(3924), completion_status=no

[説明]

TPSAbort(0) （スレッドの終了）が呼び出されました。ユーザ実装部でTPSAbort(0)を呼び出した場合と、常駐オブジェクト(Java)のコールバックでランタイム例外が発生してオブジェクトマネージャがTPSAbort(0)を呼び出した場合があります。

[対処]

サーバトレースなどでTPSAbort(0)を呼び出した原因を調査してください。もしくは、Javaのランタイム例外が発生した原因を調査してください。

TPSABORT_T_RESTART(3925), completion_status=no

[説明]

TPSAbort(1) （スレッドのリスタート）が呼び出されました。

[対処]

サーバトレースなどでTPSAbort(1)を呼び出した原因を調査してください。

TPSABORT_P_END(3926), completion_status=maybe

[説明]

TPSAbort(-1) （プロセスの終了）が呼び出されたか、もしくはJavaのユーザ実装部でランタイム例外が発生しました。

[対処]

サーバトレースなどでTPSAbort(-1)を呼び出した原因を調査してください。もしくはJavaのユーザ実装部で発生した例外を調査してください。

(3934), completion_status=maybe

[説明]

リクエストの処理中にサーバアプリケーションプロセスが異常終了し、処理が完了しませんでした。

[対処]

サーバトレースやsyslog(イベントログ)から異常終了の原因を調査してください。

(3935), completion_status=maybe

[説明]

WebOTXの制御外でスレッドの消滅を検出しました。

[対処]

ユーザ実装部で独自にスレッドを終了していないか確認してください。

例外クラス名 CORBA::IMP_LIMIT

LENGTH_OVER(3933), completion_status=maybe

[説明]

オペレーション要求または応答の電文長が99,999,999byte以上のため、電文長エラーが発生しました。まれに、JavaサーバAPが終了処理中にリクエストを受け付けて本エラーを返すことがあります。

[対処]

電文長（上り、下り）に問題がないか確認してください。

5.3.1.2. 一時的な障害

例外クラス名 CORBA::TRANSIENT

AP_TERMINATE(3882), completion_status=no

[説明]

アプリケーショングループが停止処理中のため実行できません。

[対処]

リトライしてください。

PCG_JUST_TERMINATE(3888), completion_status=no

[説明]

プロセスグループが停止処理中のため実行できません。

[対処]

リトライしてください。

AFTER_TPSABORT(3889), completion_status=no

[説明]

サーバアプリケーションがTPSAbort(-1)によって終了処理中のため実行できません。

[対処]

リトライしてください。

AFTER_FINAL_THREAD_END(3892), completion_status=no

[説明]

サーバアプリケーションが終了処理中でオペレーションを実行できるスレッドが無いため実行できません。

[対処]

リトライしてください。

AFTER_ELPTIME_OVER(3893), completion_status=no

[説明]

オペレーションで実行時間上限超過が発生し、プロセスが終了処理中のため実行できません。

[対処]

リトライしてください。

ANOTHER_THREAD_EXCEPTION(3894), completion_status=no

[説明]

他のスレッドで例外が発生したため、DB連携機能を使用したプロセスが強制終了されました。

[対処]

リトライしてください。

ANOTHER_THREAD_ELPOVER(3895), completion_status=no

[説明]

他スレッドで実行時間超過が発生したため、DB連携機能を使用したプロセスが強制終了されました。

[対処]

リトライしてください。

(3897), completion_status=no

[説明]

ステートフルアプリケーションへのリクエストを受け付けましたが、実行する前にプロセスが異常終了したため処理されませんでした。

[対処]

リトライしてください。

(3898), completion_status=no

[説明]

ステートレスアプリケーションへのリクエストを受け付けましたが、実行する前にプロセスグループの全プロセスが異常終了したため、処理されませんでした。

[対処]

リトライしてください。

5.3.1.3. コネクション切断時(または切断直前)のエラー

例外クラス名 CORBA::COM_FAILURE

(3878), completion_status=maybe

[説明]

コネクションでプロトコルエラーを検出したためコネクションを切断しました。

[対処]

リトライしてください。リスナトレースなどでプロトコルエラーの原因を調査してください。

(3879), completion_status=maybe

[説明]

コネクションが無通信の時間が無通信監視間隔の設定値を超えたためコネクションを切断しました。

[対処]

リトライしてください。必要があれば無通信監視間隔の設定を見直してください。

DISCON_FROM_SERVER(3883), completion_status=maybe

[説明]

クライアントアライブチェック処理またはオペレータによりコネクションが切断されました。

[対処]

リトライしてください。必要があればクライアントアライブチェック間隔の設定を見直してください。

5.3.1.4. 資源不足エラー

例外クラス名 CORBA::NO_RESOURCES

QUEUING_OVER(3840), completion_status=no

[説明]

キューイング数が最大数を超過したためリクエストの受付を拒否しました。

[対処]

しばらく待ってリトライしてください。頻発するようであればキューの最大数の設定を見直してください。

NO_MEMORY_SHMEM(3843), completion_status=no

[説明]

受信バッファが不足しているためリクエストを受信できません。

[対処]

しばらく待ってリトライしてください。頻発するようであればメモリプールサイズの設定を見直してください。

MULTITX_OVER(3844), completion_status=no

[説明]

１コネクションで設定以上の多重要求がありました。

[対処]

しばらく待ってリトライしてください。頻発するようであれば１プロセスあたりの多重度の設定を見直してください。

SHM_ALLOCATE_FAIL(3845), completion_status=maybe

[説明]

WebOTXが使用する共有メモリの確保に失敗しました。

[対処]

しばらく待ってリトライしてください。頻発するようであればメモリプールサイズの設定を見直してください。

QUEUE_HANDLING_QCR(3846), completion_status=no

[説明]

共有メモリが不足したためキュー制御（QCReceive)に失敗しました。

[対処]

しばらく待ってリトライしてください。頻発するようであればメモリプールサイズの設定を見直してください。

QUEUE_HANDLING_QCS(3847), completion_status=maybe

[説明]

共有メモリが不足したためキュー制御（QCSend)に失敗しました。

[対処]

しばらく待ってリトライしてください。頻発するようであればメモリプールサイズの設定を見直してください。

QUEUE_HANDLING_QCT(3848), completion_status=maybe

[説明]

共有メモリが不足したためキュー制御(QCtxcompletion2)に失敗した。

[対処]

しばらく待ってリトライしてください。頻発するようであればメモリプールサイズの設定を見直してください。

NO_MEMORY_SPA(3849), completion_status=maybe

[説明]

ローカルメモリが不足したためSPA領域を確保できませんでした。

[対処]

しばらく待ってリトライしてください。頻発するようであればサーバマシンのメモリ量もしくはSPA領域のサイズを見直してください。

NO_MEMORY_RCVBUF(3850), completion_status=no

[説明]

オペレーション要求処理のための受信用バッファのメモリ確保に失敗しました。

[対処]

しばらく待ってリトライしてください。。頻発するようであればサーバマシンのメモリ量もしくは送受信データサイズを見直してください。

NO_MEMORY_SENDBUF(3851), completion_status=maybe

[説明]

オペレーション応答処理のための送信用バッファのメモリ確保に失敗しました。

[対処]

しばらく待ってリトライしてください。。頻発するようであればサーバマシンのメモリ量もしくは送受信データサイズを見直してください。

5.3.1.5. サービス停止時の例外

例外クラス名 CORBA::INV_OBJREF

SERVER_SHUTDOWN(3881), completion_status=maybe

[説明]

WebOTXシステムが終了処理を開始しました。

[対処]

WebOTXシステムを起動してください。

INVALID_SG_OP(3960), completion_status=no

[説明]

アプリケーショングループは停止しています。

[対処]

アプリケーショングループを起動してください。

AP_INACTIVE(3880), completion_status=no

[説明]

プロセスグループが停止しているか、もしくはステートフルアプリケーションのプロセスが停止しています。

[対処]

プロセスグループが停止している場合は起動してください。また、プロセスグループが以前に異常終了していないかサーバトレースなどで確認してください。

OP_TERMINATE(3887), completion_status=no

[説明]

オペレーションがオペレータにより停止されているか、もしくは過去に異常終了があったため停止状態になっています。

[対処]

オペレーションを起動してください。また、過去に該当オペレーションで障害がなかったかサーバトレースなどで確認してください。

(4000), completion_status=no

[説明]

サーバオブジェクトの取得に失敗しました。ステートレスアプリケーションの場合はオペレータの操作によりコンポーネントが閉塞中です。ステートフルアプリケーションの場合はコンポーネントが閉塞したあと活性化された状態となっているか、もしくは既にReleaseServerObjectが実行されたオブジェクトのリファレンスを使用して呼び出しを行っています。

[対処]

コンポーネントが閉塞している場合はコンポーネントを活性化してください。ステートフルアプリケーションの呼び出し時に発生している場合はCreateServerObjectを実行してから呼び出しを行ってください。

5.3.1.6. 内部エラー

例外クラス名 CORBA::INTERNAL

INVALID_TABLE(3962), completion_status=no

[説明]

定義情報を展開した内部テーブルが破壊されて、内部テーブル不正が発生しています。

[対処]

WebOTXを再起動してください。

NO_ACTIVE_PERMISSION(3963), completion_status=maybe

[説明]

activeディレクトリに書き込み権がないため、操作に失敗しました。

[対処]

activeディレクトリ（<WebOTXインストール先>/domains/<ドメイン名>/config/tpsystem/active）に書き込み権があるか確認してください。

INVALID_SV_COMP(3964), completion_status=no

[説明]

サーバコンポーネントのsl（so、dll）の形式が不正です。

[対処]

サーバコンポーネントの作成、登録を再度行ってください。

VD_WRITE_ERROR(3965), completion_status=maybe

[説明]

ディスク容量不足のため、ファイル型VDへの書き込みに失敗しました。

[対処]

空きディスク容量を確認してください。

DB_ERROR(3966), completion_status=maybe

[説明]

データベース（Oracle)エラーが発生しました。

[対処]

syslog（イベントログ）に出力されたTPS10-05301のメッセージでoracleのエラーコードを確認し、原因を調査してください。

INVALID_SG_TXINIT(3967), completion_status=no

[説明]

アプリケーショングループの定義に誤りがあります。定義ファイルが壊れた可能性があります。定義ファイル不正(オペレーション)

[対処]

該当するアプリケーショングループを再登録してください。解決しない場合はシステム部門へ連絡してください。

INVALID_SG_CODE(3968), completion_status=no

[説明]

クライアントの定義に誤りがあります。定義ファイルが壊れた可能性があります。定義ファイル不正（クライアントコード）

[対処]

.termファイルを確認してください。

INVALID_SG_TXTYPE(3969), completion_status=no

[説明]

アプリケーショングループの定義に誤りがあります。定義ファイルが壊れた可能性があります。定義ファイル不正（オペレーション型）

[対処]

該当するアプリケーショングループを再登録してください。解決しない場合はシステム部門へ連絡してください。

INVALID_SG_LINK(3970), completion_status=no

[説明]

アプリケーショングループの定義に誤りがあります。定義ファイルが壊れた可能性があります。定義ファイル不正（リンク形態）

[対処]

該当するアプリケーショングループを再登録してください。解決しない場合はシステム部門へ連絡してください。

INVALID_SG_LANG(3971), completion_status=no

[説明]

クライアントの定義に誤りがあります。定義ファイルが壊れた可能性があります。定義ファイル不正（言語種別）

[対処]

.termファイルを確認してください。

(4082), completion_status=no

[説明]

キュー操作でエラーが発生しました。

[対処]

syslog（イベントログ）に出力されたメッセージから障害内容を確認し、解決してください。

VERSION_MISMATCH(4083), completion_status=maybe

[説明]

WebOTXの実行モジュール間でバージョンの不整合が発生しています。

[対処]

システム部門へ連絡してください。

SHM_FREE_FAIL(4085), completion_status=maybe

[説明]

メモリの解放でエラーが発生しました。

[対処]

システム部門へ連絡してください。

LOCK_FAIL(4086), completion_status=maybe

[説明]

ロック制御でエラーが発生し、排他ロックが失敗しました。

[対処]

システム部門へ連絡してください。

EVENT_WAIT_ERROR(4087), completion_status=maybe

[説明]

内部イベント待ちでエラーが発生しました。

[対処]

システム部門へ連絡してください。

EVENT_NOTIFY_ERROR(4088), completion_status=maybe

[説明]

内部イベントの通知でエラーが発生し、失敗しました。

[対処]

システム部門へ連絡してください。

WEBOTX_S_LINK_ERROR(4079), completion_status=maybe

[説明]

WebOTX Transaction Service との連携で致命的なエラーが発生しました。

[対処]

システム部門へ連絡してください。

5.3.1.7. その他のエラー

例外クラス名 CORBA::UNKNOWN

UNKNOWN(4095), completion_status=maybe

[説明]

想定外の障害が発生しました。

[対処]

システム部門へ連絡してください。

5.3.2. CORBA例外一覧(Ver3.2互換動作時)

互換動作選択の方法

Ver3.2互換動作をさせるためには設定ファイルを手修正する必要があります。
以下の手順で修正を行って下さい。

1. MySystemなどのカタログディレクトリに存在するファイルIIOPLsn.sg.svをIIOPLsn.sgにリネームする。
2. IIOPLsn.sgをエディタで開く
3. 下記行をファイル中に記述する
   ExcepVersion 3
4. 該当ファイルには以下のようにデフォルトでデバックトレースの設定が入っています。
   TraceLevel 7
   このままでは性能がでないのでその設定を以下のようにコメント化して下さい。
   #TraceLevel 7
5. ファイルを書き込んだ後に該当WebOTXシステムを再起動する。

本設定はWebOTXシステム毎の設定になるので、複数システムを構築している場合は、各システムでこの設定が必要になります。

表の見方

個々の例外クラスについて、取りうるマイナーコードを列挙しています。
Javaの場合、マクロはjp.co.nec.WebOTX.exceptionsパッケージのWOMinorクラスに定義されています。classファイルはsvsimjパッケージに含まれています。
C++の場合、マクロ名は下表のマクロ名の頭にWOMinor_を付加したものになります。WOMinor.hで定義しています。
一部マクロを定義していないものがあります。
completion_statusは基本的にCOMPLETED_NOになります。一部COMPLETED_MAYBEのものがあり、それについては値の下にmaybeと記述しています。

例外クラス名 CORBA::BAD_OPERATION

例外クラス名 CORBA::TRANSIENT

例外クラス名 CORBA::NO_RESOURCES

例外クラス名 CORBA::INTERNAL

例外クラス名 CORBA::COM_FAILURE

例外クラス名 CORBA::UNKNOWN

5.3.3. CORBA例外一覧(エラー詳細化しない場合)

本例外体系の選択方法

運用管理ツールのシステムのプロパティで「CORBAエラーの詳細化を行う」のチェックを外すことにより可能です。
マクロは定義していません。
completion_statusは基本的にCOMPLETED_NOになります。一部COMPLETED_MAYBEのものがあり、それについては値の下にmaybeと記述しています。

表の見方

個々の例外クラスについて、取りうるマイナーコードを列挙しています。
マクロは定義していません。

例外クラス名 CORBA::BAD_OPERATION

例外クラス名 CORBA::INTERNAL

例外クラス名 CORBA::INV_OBJREF

例外クラス名 CORBA::NO_RESOURCES

例外クラス名 CORBA::NO_RESPONSE

例外クラス名 CORBA::TRANSIENT

例外クラス名 CORBA::COM_FAILURE

例外クラス名 CORBA::UNKNOWN

5.4. CORBA, EJBゲートウェイのエラー一覧

CORBAゲートウェイ および、EJBゲートウェイは実行時にエラーが発生した場合、クライアントアプリケーションにエラーメッセージを次のような形式で返却します。

実行時エラー 'Error Code1(Error Code2)':
オートメーションエラーです。

この Error Code2の値からエラーの原因を判定することができます。この値が "-xxxxxxxxxx" （x は、任意の10進数）の場合は、この値を16進数に変換した値がエラーコードになります。

エラーコードの先頭2バイトが A1の場合、WebOTXの内部でエラーが発生したことを示します。先頭2バイトが A1以外の場合、WebOTXの外部でエラーが発生したことを示し、この値は Visual Basicや ActiveXコントロールなどのエラーコードになります。