|
|
Oracle Tuxedoシステムには、時間に依存しない通信にアプリケーション・キューを使用する機能が組み込まれています。Tuxedo Application Queue MIBは、アプリケーション・キューへのアクセスの管理と制御に必要な管理環境を提供します。Application Queue MIBによってアプリケーション・キューの構造が定義されます。
Tuxedoアプリケーションでは、メッセージがキューに登録され、キューは特定のキュー・スペース内で定義されます。キューへの登録とキューからの取出しはトランザクション内で実行されます。Application Queue MIBは、キュー・アクセス、キュー、メッセージ、キュー・スペース、およびキュー・トランザクションを定義する5種類のグループで構成されます。
Application Queue MIBは以下のグループで構成されています。
tuxTAppQctrlグループでは、アプリケーション・キュー関連のすべてのMIBグループに対するアクセスの制御が可能です。
アプリケーション・キュー関連のすべてのMIBグループに適用されます。このオブジェクト値は、値が返されるマシンを制御します。
値がlocal(1)の場合は、Oracle SNMPエージェントが実行されているローカル・ホストのみが考慮されます。あるいは、値がall(2)の場合は、アプリケーションで既知のすべてのLMIDが考慮されます。
アプリケーション・キュー関連のすべてのMIBグループに適用されます。このオブジェクト値は、値が返されるデバイスを制御します。
このオブジェクトのデフォルト値は"*"で、この場合は既知のすべてのデバイス()が考慮されます。
アプリケーション・キュー関連のすべてのMIBグループに適用されます。このオブジェクト値は、値が返されるキュー・スペースを制御します。
このオブジェクトのデフォルト値は"*"で、この場合はデバイス(tuxTAppQctrlQmConfigで修飾される)のすべてのキュー・スペースが考慮されます。
このオブジェクト値は、値が返されるキューを制御します。tuxTAppQTblとtuxTAppQmsgTblに適用されます。
このオブジェクトのデフォルト値は"*"で、この場合はデバイス(tuxTAppQctrlQmConfigで修飾される)とキュー・スペース(tuxTAppQctrlSpaceNameで修飾される)のすべてのキューが考慮されます。
このオブジェクトはtuxTAppQmsgTblのみに適用されます。tuxTAppQmsgTblインスタンスのオカレンスを検索する最低の優先順位です。このオブジェクト値はPRIOベースのキューにのみ有効です。デフォルトでは、優先順位の最小値が考慮されます。デフォルト設定に戻す場合には、このオブジェクトを0に設定します。
このオブジェクトはtuxTAppQmsgTblのみに適用されます。tuxTAppQmsgTblインスタンスのオカレンスを検索する最高の優先順位です。このオブジェクト値はPRIOベースのキューにのみ有効です。デフォルトでは、優先順位の最大値が考慮されます。デフォルト設定に戻す場合には、このオブジェクトを0に設定します。
このオブジェクトはtuxTAppQmsgTblのみに適用されます。tuxTAppQmsgTblインスタンスのオカレンスを検索する終了時刻です。範囲には両端が含まれます。このオブジェクト値はTIMEベースのキューにのみ有効です。デフォルト値はそのマシンで設定可能な最小値です。デフォルト設定を使用する場合には、このオブジェクトを"*"に設定します。
YY[MM[DD[hh[mm[ss]]]]]
このオブジェクトはtuxTAppQmsgTblのみに適用されます。tuxTAppQmsgTblインスタンスのオカレンスを検索する開始時刻です。範囲には両端が含まれます。このオブジェクト値はTIMEベースのキューにのみ有効です。デフォルトでは、最小値は0とみなされます。デフォルト設定を使用する場合には、このオブジェクトを"*"に設定します。
YY[MM[DD[hh[mm[ss]]]]]
このオブジェクトはtuxTAppQmsgTblのみに適用されます。tuxTAppQmsgTblインスタンスのオカレンスを検索する有効期限の終了時刻です。範囲には両端が含まれます。このオブジェクト値はTIMEベースのキューにのみ有効です。デフォルト値はそのマシンで設定可能な最小値です。デフォルト設定を使用する場合には、このオブジェクトを"*"に設定します。
YY[MM[DD[hh[mm[ss]]]]]
このオブジェクトはtuxTAppQmsgTblのみに適用されます。tuxTAppQmsgTblインスタンスのオカレンスを検索する有効期限の開始時刻です。範囲には両端が含まれます。このオブジェクト値はTIMEベースのキューにのみ有効です。デフォルトでは、最小値は0とみなされます。デフォルト設定を使用する場合には、このオブジェクトを"*"に設定します。
YY[MM[DD[hh[mm[ss]]]]]
tuxTAppQTblグループには、アプリケーション・キューを表すオブジェクトが含まれます。1つのアプリケーション・キュー・スペースに1つ以上のアプリケーション・キューが存在できます。この表のオブジェクトには、ローカル・マシンにインストールされているTuxedo SNMPエージェントを通じてのみアクセスできます。
新しいキューの作成: 新しいキュー(行)を作成する場合には、このグループでSETリクエストにtuxTAppQname、tuxTAppQspaceName、tuxTAppQmConfigの値を指定します。また、tuxTAppQgrpNoの値(索引の一部)はそのキュー・スペースに対応するグループ番号、または40000 (それに該当するグループが存在しない場合)に設定する必要があります。
| 注意: | これを含め、アプリケーション・キュー関連のすべてのMIBグループには、その一部として返されるデータをフィルタする制御MIBがあります。tuxTAppQctrlを参照してください。 |
この表で新しい行を作成するには、少なくともtuxTAppQname、tuxTAppQspaceName、tuxTAppQmConfigの値を指定するSETリクエストを発行する必要があります。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
アプリケーション・キューを含むアプリケーション・キュー・スペースの名前。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
アプリケーション・キュー・スペースが存在するファイルまたはデバイスの絶対パス名。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
アプリケーション・キュー・スペースが存在する論理マシンの識別子。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
このキューがリソース・マネージャとなるサーバー・グループのグループ番号。つまり、そのグループのopeninfo文字列tuxTgroupOpenInfoに、このキューのデバイス名とキュー・スペース名が含まれます。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
INTEGER { valid(1), invalid(2) }
GET: valid(1)
valid(1)
SET: invalid(2)
SET操作は、選択したアプリケーション・キューの特性を変更するか、または新しいキューを作成します。以下に、SETリクエストによって返されるtuxTAppQstateの意味を示します。これ以外の状態を設定することはできません。
invalid(2)
invalid(2)になります。
キューのメッセージが処理される順序。有効な値はPRIOまたはTIMEです。その後で、カンマに続けてオプションで別のPRIOまたはTIMEを指定し、さらにLIFOまたはFIFOのいずれかを指定します。FIFOもLIFOも指定しない場合は、FIFOと想定されます。キューの作成時に何も指定しない場合、デフォルトはFIFOです。有効な設定の例は、次のとおりです。
PRIO
PRIO,TIME,LIFO
TIME,PRIO,FIFO
TIME,FIFO
DisplayString (SIZE(0..127)) (Oracle Tuxedo 8.0以前では最大78バイト)
上限値であるtuxTAppQcmdHwに達したとき自動的に実行されるコマンド。このコマンドは、下限値tuxTAppQcmdLwに達した後で再び上限値に達したときにも再実行されます。
上限値。詳細はtuxTAppQcmdLwを参照してください。
tuxTAppQcmdオブジェクトで指定したコマンドの自動実行を制御する下限値。それぞれがゼロ以上の整数で、オプションとして以下のいずれかのキー文字を続けます。キー文字は、tuxTAppQcmdHwおよびtuxTAppQcmdLwと一致している必要があります。
b
B
m
%
たとえば、tuxTAppQcmdLwを50m、tuxTAppQcmdHwを100mと指定した場合、tuxTAppQcmdで指定されるコマンドはキューに100個のメッセージが登録されたときに実行され、その後はキューからメッセージが取り出されてメッセージ数が50個まで減り、再び100個まで戻ったときに再実行されます。
キュー・メッセージが失敗したときに再試行する最大回数。再試行の最大回数に達すると、メッセージは関連付けられたアプリケーション・キュー・スペースのエラー・キューに登録されます。エラー・キューがない場合、メッセージは破棄されます。デフォルトはゼロです。
INTEGER { none(1), top(2), msgid(3) }
問題のあるメッセージを処理する方法。デフォルトはnone(1)です。
キュー・メッセージが失敗した場合の再試行の遅延時間(単位は秒)。デフォルトはゼロです。
このオブジェクトは、明示的に期限切れ時間を指定せずにキューに登録されているメッセージに対して期限切れ時間を指定します。期限切れ時間は、相対時間で指定するか、または何も指定しません。相対期限切れ時間は、メッセージがキュー・マネージャ・プロセスに達してからの一定時間をメッセージに関連付けて決定されます。メッセージが期限切れになったとき、キューからの取出しも管理者による削除も行われていない場合、メッセージに関連付けられているすべてのリソースがシステムによって開放され、統計が更新されます。トランザクション中にメッセージが期限切れになった場合、期限切れによってトランザクションが失敗することはありません。トランザクション内でキューへの登録中、またはキューからの取出し中に期限切れになったメッセージは、トランザクションが終了した時点でキューから削除されます。メッセージの有効期限が切れたことの通知は行われません。キューにデフォルトの期限切れ時間が指定されていない場合、明示的に期限切れが設定されていないメッセージは期限切れになりません。キューの期限切れ時間を変更しても、変更前にキューに登録されていたメッセージの期限切れ時間は変更されません。
形式は+secondsです。secondsはキュー・マネージャが正常に操作を完了してから、メッセージが期限切れになるまでに経過する秒数です。secondsをゼロ(0)に設定した場合、メッセージはすぐ期限切れになります。
このオブジェクトの値を文字列"none"に設定することもできます。none文字列を指定すると、明示的な期限切れ時間を指定せずにキューに登録されたメッセージが期限切れになりません。すでにキューにあるメッセージの期限切れ時間は、tuxTAppQmsgTblグループのtuxTAppQmsgExpireTimeオブジェクトで変更できます。
INTEGER { persist(1), non-persist(2) }
このオブジェクトは、キューに登録されるメッセージに配信モードが指定されていないとき、キューのデフォルトの配信ポリシーを指定します。値がpersistの場合、明示的に配信モードを指定せずにキューに登録されたメッセージは永続(ディスク・ベース)配信モードを使用して配信されます。値がnon-persistの場合、明示的に配信モードを指定せずにキューに登録されたメッセージは非永続(メモリー内)配信モードを使用して配信されます。キューのデフォルトの配信ポリシーを変更しても、変更前にキューにあったメッセージのサービスの配信品質は変化しません。変更中のキューが現在キュー・スペースにあるメッセージに対して名前が付けられている応答キューである場合、キューのデフォルトの配信ポリシーを変更しても、そのメッセージのサービスの応答品質は変わりません。
非永続の配信で、メモリー領域が使い切られたか断片化してメッセージをキューに登録できなくなった場合には、メッセージに十分な永続記憶領域が存在していても、キューへの登録操作が失敗します。同じように、永続記憶領域が使い切られたか断片化してメッセージをキューに登録できなくなった場合には、メッセージに十分な非永続領域が存在していても、キューへの登録操作が失敗します。tuxTQspaceTblグループのtuxTQspaceMemNonPersistオブジェクトでキュー・スペースがゼロ(0)の場合、非永続メッセージ用のスペースは確保されません。この場合、非永続メッセージを登録しようとすると失敗します。このタイプのエラーは、たとえばメッセージにサービスの配信品質が指定されておらず、ターゲット・キューのtuxTAppQDefDeliveryPolicyオブジェクトが"non-persist"に設定されている場合に発生します。
DisplayString (SIZE(1..127)) (Oracle Tuxedo 8.0以前では最大78バイト)
このオブジェクトは、非永続(メモリー・ベースの配信)メッセージの上限値であるtuxTAppQCmdNonPersistHwに達したとき自動的に実行されるコマンドを指定します。このコマンドは、非永続(メモリー・ベースの配信)メッセージの下限値tuxTAppQCmdNonPersistLwに達した後で再び上限値に達したときにも再実行されます。
これらのオブジェクトは、 tuxTAppQCmdNonPersistオブジェクトで指定したコマンドの自動実行を制御する上限値と下限値を指定します。それぞれがゼロ以上の整数で、オプションとして以下のいずれかのキー文字を続けます。キー文字は、tuxTAppQCmdNonPersistHwおよびtuxTAppQCmdNonPersistLwと一致している必要があります。
b
B
%
tuxTAppQCmdHwオブジェクトとtuxTAppQcmdLwオブジェクト(mが続く場合)で指定されるメッセージしきい値タイプは、永続メッセージと非永続メッセージの両方を含めてキューのすべてのメッセージに適用されます。したがって、tuxTAppQCmdNonPersistHwおよびtuxTAppQCmdNonPersistLwのしきい値タイプとしては使用できません。
これらのオブジェクトは、 tuxTAppQCmdNonPersistオブジェクトで指定したコマンドの自動実行を制御する上限値と下限値を指定します。それぞれがゼロ以上の整数で、オプションとして以下のいずれかのキー文字を続けます。キー文字は、tuxTAppQCmdNonPersistHwおよびtuxTAppQCmdNonPersistLwと一致している必要があります。
b
B
%
tuxTAppQCmdHwオブジェクトとtuxTAppQcmdLwオブジェクト(mが続く場合)で指定されるメッセージしきい値タイプは、永続メッセージと非永続メッセージの両方を含めてキューのすべてのメッセージに適用されます。したがって、tuxTAppQCmdNonPersistHwおよびtuxTAppQCmdNonPersistLwのしきい値タイプとしては使用できません。
このオブジェクトは、キューにある非永続メッセージによって現在消費されている共有メモリーのバイト数を指定します。
このオブジェクトは、現在キューにある非永続メッセージの数を示します。キューにあるメッセージの合計数を判別するには、tuxTAppQcurMsgの値をこの値に加えます。
tuxTAppQmsgTblグループには、アプリケーション・キューに登録されているメッセージを表すオブジェクトが含まれます。メッセージは管理者によって作成されるのではなく、tpenqueue(3)を呼び出した結果として生成されます。メッセージの破棄は、tpdequeue(3)の呼出しによっても管理者によっても可能です。また、メッセージの一部のオブジェクトは管理者が変更できます。たとえば、管理者は同じキュー・スペース内のキュー間でメッセージを移動したり、その優先順位を変更したりできます。
この表のオブジェクトには、ローカル・マシンにインストールされているTuxedo SNMPエージェントを通じてのみアクセスできます。
キュー・メッセージの一意な識別子。GETまたはSET操作でメッセージを選択するときに使用できます。等しいかどうかを比較する以外、この値に意味はありません。
キュー・メッセージのtuxTAppQmsgIdに対応する実行番号。この表のコンポジット索引の一部です。
このキューがリソース・マネージャとなるサーバー・グループのグループ番号。つまり、そのグループのopeninfo文字列tuxTgroupOpenInfoに、このキューのデバイス名とキュー・スペース名が含まれます。
このメッセージを含むキューのアプリケーション・キュー・スペースが存在するファイルまたはデバイスの絶対パス名。
このメッセージが存在するアプリケーション・キューを含むアプリケーション・キュー・スペースの名前。
このメッセージを含むキューが存在するマシンの論理マシンID。
INTEGER { valid(1), invalid(2) }
GET: valid(1)
valid(1)
SET: invalid(2)
invalid(2)
選択したメッセージを移動する移動先のキューの名前。これは同じキュー・スペースに存在するキューでなければなりません。この操作が成功するには、メッセージがvalid(1)状態である必要があります。GET操作でオブジェクト値は返されません。
メッセージの優先順位。このオブジェクト値はPRIOベースのキューにのみ有効です。キューがPRIOベースでない場合は、GET操作で-1の値が返されます。
メッセージが処理される時間。このオブジェクト値はTIMEベースのキューにのみ有効です。キューがTIMEベースでない場合は、GET操作で空の文字列が返されます。形式は次のいずれかです。
+seconds
YY[MM[DD[hh[mm[ss]]]]]
tpenqueue(3)リクエストでアプリケーションによって指定されるメッセージの相関識別子。空の文字列を指定すると、相関識別子が存在しないことを意味します。
このオブジェクトは、メッセージが期限切れになる時間(つまり、キューからの取出しも管理者による削除も行われていない場合に、メッセージをキューから削除する必要がある時刻)を指定します。メッセージが期限切れになると、そのメッセージが使用していたリソースはすべてシステムによって開放され、統計が更新されます。トランザクション中にメッセージが期限切れになった場合、期限切れによってトランザクションが失敗することはありません。トランザクション内でキューへの登録中、またはキューからの取出し中に期限切れになったメッセージは、トランザクションが終了した時点でキューから削除されます。メッセージの有効期限が切れたことの通知は行われません。この値の変更を行うキュー・マネージャがメッセージの期限切れをサポートしている場合でも、メッセージの期限切れをサポートしていないバージョンのOracle Tuxedoシステムで登録されたメッセージに、期限切れ時間を追加することはできません。期限切れ時間を追加しようとすると、エラーになります。
期限切れ時間が設定されている場合には、GET操作で空の文字列が返されます。期限切れ時間の形式は次のいずれかです。
+seconds
YY[MM[DD[hh]MM[SS]]]]
なし
読取り専用の状態で、非永続メッセージの場合には"no"、永続メッセージの場合には"yes"に設定されます。これはメッセージのサービスの配信品質です。
読取り専用の状態で、非永続メッセージの場合には"no"、永続メッセージの場合には"yes"に設定されます。これはメッセージに応答する配信品質です。
tuxTQspaceTblグループには、アプリケーション・キュー・スペースを表すオブジェクトが含まれます。この表のオブジェクトには、ローカル・マシンにインストールされているTuxedo SNMPエージェントを通じてのみアクセスできます。
| 注意: | このMIBによって返される値は、tuxTAppQctrlによって制御されます。詳細は、上記のグループの説明を参照してください。 |
この表で新しい行を作成するには、索引(tuxTQspaceGrpNo)に40000を指定してSETリクエストを発行する必要があります。これは、表に行を作成するために予約されている値です。SETリクエストには少なくともtuxTQspaceQmConfig、tuxTQspaceName、tuxTQspaceLmid、tuxTQspaceIpckey、tuxTQspaceMaxMsg、tuxTQspaceMaxPages、tuxTQspaceMaxProc、tuxTQspaceMaxQueues、tuxTQspaceMaxTransを指定する必要があります。新しく作成されるインスタンス(行)は、いずれかのサーバー・グループにアタッチされるまで表示されません。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
アプリケーション・キュー・スペースが存在するファイルまたはデバイスの絶対パス名。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
アプリケーション・キュー・スペースが存在する論理マシンの識別子。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
このキュー・スペースがリソース・マネージャとなるサーバー・グループのグループ番号。つまり、そのグループのopeninfo文字列tuxTgroupOpenInfoに、このキュー・スペースのデバイス名とキュー・スペース名が含まれます。
| 注意: | このオブジェクトは、行の作成中にのみ更新できます。 |
INTEGER { inactive(1), initializing(2), open(3), active(4), cleaning(5), invalid(6) }
GET: inactive(1)|initializing(2)|open(3)|active(4)
GET操作は、選択したアプリケーション・キュー・スペースに関する情報を検索します。以下に、GETリクエストに対する応答で返されるtuxTQspaceStateの意味を示します。これら以外の状態は返されません。
inactive(1)
initializing(2)
open(3)
active(4)
TMS_QM、TMQUEUE、および多くの場合TMQFORWARD)、qmadmin(1)などの管理プロセス、または別のアプリケーションに関連付けられたプロセスです。
SET: open(3)|cleaning(5)|invalid(6)
SET操作は、選択したアプリケーション・キュー・スペースを変更するか、または新しいキュー・スペースを作成します。以下に、SETリクエストによって返されるtuxTQspaceStateオブジェクトの意味を示します。これ以外の状態を設定することはできません。
open(3)
cleaning(5)
active(4)またはopen(3)状態の場合にのみ実行できます。正常に終了すると、オブジェクトの状態はinactive(1)になります。
invalid(6)
active(4)、またはメッセージがキュー・スペースのいずれかのキューに存在する場合、エラーが報告されます。正常に終了すると、オブジェクトの状態はinvalid(6)になります。
キュー・スペースのディスク領域管理で使用するブロック化係数。 新しいキュー・スペースが作成された場合のデフォルト値は16です。
キュー・スペースに関連付けるエラー・キューの名前。エラー・キューが存在しない場合、GETリクエストで空文字列が返されます。
このオブジェクトは、キュー・スペースに対して、新規のエクステントでディスク・ページを初期化するかどうかを指定します。デフォルト値は、「初期化しない」です。デバイス・タイプ(通常ファイルやrawスライスなど)によっては、リクエストしなくても初期化が発生することがあります。
キュー・スペースの共有メモリーにアクセスするときに使用するIPCキー。
キュー・スペース内のすべてのキューに対する最大ディスク・ページ数。tuxTQspaceMaxPagesオブジェクトが増加するごとに、新しいエクステントが割り当てられます(tuxTQspaceCurExtentを参照)。このオブジェクトに小さい値を指定してページ数を減少させることはできません。この場合、エラーが報告されます。
キュー・スペースで同時にアクティブにできる最大トランザクション数。
キュー・スペースによって使用される現在のエクステント数。指定できる最大値は100です。tuxTQspaceMaxPagesオブジェクトが増加するごとに、新しいエクステントが割り当てられます
キュー・スペース内の現在のメッセージ数。この数は、キュー・スペースがopen(3)またはactive(4)の場合、またはキュー・スペースを新規に作成する場合にのみ指定できます。どの条件も適用されない場合は、-1が返されます。
キュー・スペースに存在する現在のキュー数。この数は、キュー・スペースがopen(3)またはactive(4)の場合、またはキュー・スペースを新規に作成する場合にのみ指定できます。どの条件も適用されない場合は、-1が返されます。
キュー・スペースを使用する未処理トランザクションの現在の数。
キュー・スペースが最後に開かれた後の、キュー・スペースに最大メッセージ数。キュー・スペースの状態がcleaning(5)に設定されると、この値は0にリセットされます。
キュー・スペースが最後に開かれた後に、キュー・スペースに同時にアタッチされる最大プロセス数。キュー・スペースの状態がcleaning(5)に設定されると、この値は0にリセットされます。
キュー・スペースが最後に開かれた後に、キュー・スペースに存在する最大キュー数。キュー・スペースの状態がcleaning(5)に設定されると、この値は0にリセットされます。
キュー・スペースが最後に開かれてからの特定の時点でキュー・スペースを使用する未処理トランザクションの最大数。キュー・スペースが複数のアプリケーションからアクセスされる場合、TUXCONFIG環境変数で指定されるアプリケーションだけではなく、すべてのアプリケーションを含む値になります。キュー・スペースの状態がcleaning(5)に設定されると、この値は0にリセットされます。
キュー・スペース用に初期化されるディスク領域のパーセンテージ(0以上100以下の整数)。
このオブジェクトは、Oracle Engineのキューイング・サービス・コンポーネントが同時に処理できる追加アクション数を指定します。ブロッキング操作の発生時に追加操作を利用できる場合、ブロッキング操作は条件を満たす状態になるまで保留されるように設定されます。ブロッキング操作が保留されると、他の操作リクエストを処理できます。ブロッキング操作が完了すると、その操作に関連する操作は続く操作でも実行できるようになります。システムでは、キュー・スペースにアタッチ可能なプロセスの数と同じ数だけ操作が予約されているため、それぞれのキュー・マネージャ・プロセスは少なくとも1つブロッキング操作を所有できます。システムによって予約されているブロッキング操作の数を超える場合、管理者は予約数より多くの追加ブロッキング操作に対応できるようにシステムを設定することができます。ブロッキング操作がリクエストされた時点ですぐに条件を満たす状態にならず、利用可能な操作もない場合には、操作は失敗します。
このオブジェクトは、Oracle Engineのキューイング・サービス・コンポーネントのユーザーが同時に使用できるハンドル数を指定します。キューイング・サービスAPIによって操作されるオブジェクトでは、そのオブジェクトにアクセスするためのハンドルが必要です。キューイング・サービスAPIの呼出しによりオブジェクトが開かれると、新しいハンドルが作成されてユーザーに返されます。オブジェクト・ハンドルを閉じると、そのハンドルは開かれている次のオブジェクトの操作に利用できるようになります。キューイング・サービスAPIがアプリケーションによって使用される場合、管理者は、同時に開かれる最大ハンドル数に対応できるようにシステムを構成する必要があります。ユーザーがキューイング・サービス・オブジェクトを開く際に利用可能なハンドルがないと、操作は失敗します。この値を調整しても、共有メモリーを必要以上に浪費するだけで、Tuxedoアプリケーションには何の効果もありません。
このオブジェクトは、キューイング・サービスのリソースを同時に使用することを許可された、Oracle Engineの認証済みユーザーの追加数を指定します。開いているハンドルの数に関係なく、各ユーザーに1つのオーナー・レコードがあります。開いているハンドルがない場合、次のユーザーがオーナー・レコードを使用できます。システムでは、操作数と同じ数だけオーナーが予約されているため、異なるオーナーが各操作を開始できます。同時にキューイング・サービス・リソースを使用できるシステムによって予約されているオーナー数を超える場合、管理者は予約数より多くの追加オーナーに対応できるようにシステムを設定することができます。ユーザーがハンドルを開こうとした時点で開いているハンドルがなく、利用できるオーナーがないと、操作は失敗します。この値を調整しても、共有メモリーを必要以上に浪費するだけで、Oracle Tuxedoアプリケーションには何の効果もありません。この値を調整しても、共有メモリーを必要以上に浪費するだけで、Tuxedoアプリケーションには何の効果もありません。
このオブジェクトは、Oracle Engineのキューイング・サービス・コンポーネントで同時に開くことができる一時キューの数を指定します。一時キューは、動的な自己設定型アプリケーションによって使用され、管理者はアプリケーションで使用する各キューを設定する必要がなくなります。一時キューには、永続的メッセージは登録されません。一時キューへのすべてのハンドルが閉じると、一時キューのリソースは次の一時キューの作成で使用できるようになります。一時キューがアプリケーションによって使用される場合は、管理者は同時にアクティブにできる一時キューの最大数に対応できるようにシステムを設定する必要があります。ユーザーが一時キューを開く際に、利用可能な一時キューのリソースがないと、操作は失敗します。このオブジェクトは、キューイング・サービスを同時に使用することを許可された、Oracle Engineの認証済みユーザーの追加数を指定します。
このオブジェクトは、Oracle Engineのキューイング・サービス・コンポーネントのユーザーが同時に使用できるカーソル数を指定します。カーソルは、キューの操作に使用されます。カーソルを破棄すると、そのカーソル・リソースは次のカーソル作成操作に利用できるようになります。カーソルがアプリケーションによって使用される場合、管理者は同時に割り当てることができるカーソルの最大数に対応するようにシステムを設定する必要があります。ユーザーがカーソルを作成する際に利用可能なカーソル・リソースがないと、操作は失敗します。このオブジェクトは、キューイング・サービスを同時に使用することを許可された、Oracle Engineの認証済みユーザーの追加数を指定します。
このオブジェクトは、キュー・スペース内のすべてのキューの一時的メッセージを格納するために、共有メモリーに確保する領域のサイズを指定します。メモリーのサイズは、バイト(b)またはブロック(B)で指定します。ここでは、ブロックのサイズはディスク・ブロックのサイズと等しくなります。
[bB]接尾辞は指定してもしなくても構いませんが、指定しなかった場合はデフォルトでブロックになります。リクエストされるバイト数は次に近いデータ・サイズに丸められます。読み込まれるときには、値は常に割り当てられるバイト単位(b)の実際のメモリー容量になります。
コマンドが正常に完了すると、指定されたキュー・スペースのすべての一時的メッセージが完全に失われます。
非永続メッセージで、キュー・スペースの変数がゼロ(0)の場合、キュー・スペースは確保されません。この場合、非永続メッセージを登録しようとすると失敗します。このタイプのエラーは、たとえばメッセージにサービスの配信品質が指定されておらず、ターゲット・キューのtuxTAppTblグループのtuxTAppQDefDeliverPolicyオブジェクトがNONPERSISTに設定されている場合に発生します。非永続の配信で、メモリー領域が使い切られたか断片化してメッセージをキューに登録できなくなった場合には、メッセージに十分な永続記憶領域が存在していても、キューへの登録操作が失敗します。同じように、永続記憶領域が使い切られたか断片化してメッセージをキューに登録できなくなった場合には、メッセージに十分な非永続領域が存在していても、キューへの登録操作が失敗します。
このオブジェクトは、ユーザー定義フィルタのコンパイル表現を格納するために、共有メモリーで確保するメモリー領域のサイズを指定します。メモリー・サイズはバイト単位で指定します。フィルタは、キューからのメッセージの取出し操作やカーソル操作においてメッセージを選択する際に、Oracle Engineのキューイング・サービス・コンポーネントによって使用されます。いろいろな文法を使用して指定されたフィルタは、エンジンの通常の形式にコンパイルされて、共有メモリーに格納されます。フィルタは、コンパイル時に返されるハンドルによって参照されます。フィルタを破棄すると、そのフィルタが使用していたメモリーを、次のコンパイル済みフィルタで利用できるようになります。フィルタがアプリケーションによって定義される場合、管理者は同時にコンパイルできるフィルタの最大数に対応できるようにシステムを設定する必要があります。ユーザーが新しいフィルタを作成する際に、コンパイル後のフィルタに割り当てるための十分なメモリーがないと、操作は失敗します。この値を調整しても、共有メモリーを必要以上に浪費するだけで、Tuxedoアプリケーションには何の効果もありません。
このオブジェクトは、割当て済みの共有メモリーの一部または全部が使用されたピーク負荷状況に対応するために共有メモリー内に確保する領域のサイズを指定します。メモリー・サイズはバイト単位で指定します。追加オブジェクトは、先着順でこの追加メモリーから割り当てられます。追加メモリーで作成されたオブジェクトを閉じるか破棄すると、次に共有メモリー・リソース不足が発生するときに備えてメモリーは解放されます。この追加メモリー領域では、設定数より多くのオブジェクトを生成できますが、特定のオブジェクトに対していつでも使用できるとはかぎりません。現在オーバーフローを使用できるのは、アクション、ハンドル、カーソル、オーナー、一時キュー、タイマー、およびフィルタだけです。
このオブジェクトは、キューイング・サービス・システムが使用するために共有メモリー内に確保するメモリー容量の合計(バイト)を指定します。
このオブジェクトは、すべてのキューイング・サービス・オブジェクトに割り当てられる共有メモリー容量の合計(バイト)を指定します。
このオブジェクトは、キュー・スペースで使用される現在のアクション数を指定します。この数は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合に指定できます。どの条件にも該当しない場合は、-1が返されます。
このオブジェクトは、キュー・スペースで使用される現在のカーソル数を指定します。この数は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合に指定できます。どの条件にも該当しない場合は、-1が返されます。
このオブジェクトは、キュー・スペースで使用される現在のオーナー数を指定します。この数は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合に指定できます。どの条件にも該当しない場合は、-1が返されます。
このオブジェクトは、キュー・スペースで使用される現在の一時キュー数を指定します。この数は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合に指定できます。どの条件にも該当しない場合は、-1が返されます。
このオブジェクトは、キュー・スペースで使用される現在のカーソル数を指定します。この数は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合に指定できます。どの条件にも該当しない場合は、-1が返されます。
このオブジェクトは、キュー・スペースにある非永続メッセージで使用される現在のメモリー容量をバイト単位で指定します。この値は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合に指定できます。どの条件にも該当しない場合は、-1が返されます。
このオブジェクトは、キュー・スペースのフィルタで使用される現在のバイト数を指定します。この数は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合に指定できます。どの条件にも該当しない場合は、-1が返されます。
このオブジェクトは、キュー・スペースで使用されるオーバーフロー・メモリーの現在のバイト数を指定します。この数は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合に指定できます。どの条件にも該当しない場合は、-1が返されます。
このオブジェクトは、キュー・スペースが最後に開かれた後に、キュー・スペースに同時に到達するアクションの最大数を指定します。キュー・スペースの状態がCLEaningに設定されると、この値は0にリセットされます。
このオブジェクトは、キュー・スペースが最後に開かれた後に、キュー・スペースで同時に開かれるハンドルの最大数を指定します。キュー・スペースの状態がCLEaningに設定されると、この値は0にリセットされます。
このオブジェクトは、キュー・スペースが最後に開かれた後に、キュー・スペースに同時に到達するオーナーの最大数を指定します。キュー・スペースの状態がCLEaningに設定されると、この値は0にリセットされます。
このオブジェクトは、キュー・スペースが最後に開かれた後に、キュー・スペースで同時に開かれる一時キューの最大数を指定します。キュー・スペースの状態がCLEaningに設定されると、この値は0にリセットされます。
このオブジェクトは、キュー・スペースが最後に開かれた後に、キュー・スペースに同時に作成されるカーソルの最大数を指定します。キュー・スペースの状態がCLEaningに設定されると、この値は0にリセットされます。
このオブジェクトは、キュー・スペースが最後に開かれた後に、一時的メッセージによって使用される最大メモリー容量(バイト)を示します。キュー・スペースの状態がCLEaningに設定されると、この値は0にリセットされます。
このオブジェクトは、キュー・スペースが最後に開かれた後に、キュー・スペースでフィルタに使用されるバイトの最大数を指定します。キュー・スペースの状態がCLEaningに設定されると、この値は0にリセットされます。
このオブジェクトは、キュー・スペースが最後に開かれた後に、キュー・スペースでオーバーフロー・メモリーに使用されるバイトの最大数を指定します。キュー・スペースの状態がCLEaningに設定されると、この値は0にリセットされます。
tuxTQtransTblグループには、アプリケーション・キュー・スペースに関連付けられているトランザクションの実行時特性を表すオブジェクトが含まれます。この表のオブジェクトには、ローカル・マシンにインストールされているTuxedo SNMPエージェントを通じてのみアクセスできます。
tx_info(3)によって返され、文字列表現にマップされるトランザクション識別子。等号比較の場合を除き、ユーザーはこのフィールドのデータを直接解釈することはできません。
tuxTQtransTblに対する整数の索引。ユーザーがこれを解釈することはできません。Indx1からIndx5の組合せによって、この表の特定の行を一意に識別するためにのみ使用されます。
tuxTQtransTblに対する整数の索引。ユーザーがこれを解釈することはできません。Indx1からIndx5の組合せによって、この表の特定の行を一意に識別するためにのみ使用されます。
tuxTQtransTblに対する整数の索引。ユーザーがこれを解釈することはできません。Indx1からIndx5の組合せによって、この表の特定の行を一意に識別するためにのみ使用されます。
tuxTQtransTblに対する整数の索引。ユーザーがこれを解釈することはできません。Indx1からIndx5の組合せによって、この表の特定の行を一意に識別するためにのみ使用されます。
tuxTQtransTblに対する整数の索引。ユーザーがこれを解釈することはできません。Indx1からIndx5の組合せによって、この表の特定の行を一意に識別するためにのみ使用されます。
このトランザクションに関連するキュー・スペースがリソース・マネージャとなるサーバー・グループのグループ番号。つまり、そのグループのopeninfo文字列tuxTgroupOpenInfoに、このトランザクションに関連するキュー・スペースのデバイス名とキュー・スペース名が含まれます。
トランザクションに関連付けるアプリケーション・キュー・スペースの名前。
アプリケーション・キュー・スペースが存在するファイルまたはデバイスの絶対パス名。
アプリケーション・キュー・スペースが存在する論理マシンの識別子。
INTEGER { active(1), abort-only(2), aborted(3), com-called(4), ready(5), decided(6), suspended(7), habort(8), hcommit(9) }
GET: {actdive(1)|abort-only(2)|aborted(3)|com-called(4)|ready(5)| decided(6)|suspended(7)}
active(1)
aborted(3)
com-called(4)
ready(5)
decided(6)
SET: {habort(8)|hcommit(9)}
SET操作は、選択したトランザクションの状態を更新します。以下に、SETリクエストによって返されるtuxTQtransStateオブジェクトの意味を示します。これ以外の状態を設定することはできません。
habort(8)
hcommit(9)
  
|