リファレンス・ガイド

Oracle Tuxedo Message Queue MIBリファレンス

この章には、次の項があります。

OTMQ_MIB

名前

OTMQ_MIB - Oracle Tuxedo Message Queue (OTMQ)の管理情報ベース

説明

OTMQ_MIBは、OTMQアプリケーション・キューを管理できるクラスを定義します。

OTMQ_MIBは、次のクラスで構成されています。

各クラスの説明セクションには、次の4つのサブセクションがあります。

概要

このクラスに関連付けられている属性の概要

属性表

クラスの各属性に関する名前、型、パーミッション、値、およびデフォルト値を示す表。属性表の形式については以下に示してあります。

属性のセマンティクス

各属性の意味の説明

制限

このクラスにアクセスし、このクラスを解釈する場合の制限事項

属性表の形式

このMIBに含まれる各クラスは、4つの部分で記述されています。その1つが属性表です。属性表はクラス内の属性のリファレンス・ガイドであり、管理者、オペレータ、一般ユーザーがそれらの属性を使用してアプリケーションと対話するための方法を説明しています。

TA_FLAGS値

MIBは、共通TA_FLAGS属性を定義します。この属性はlong型で、共通MIBフラグ値とコンポーネントMIB固有フラグ値の両方を持ちます。次のフラグの値はOTMQ_MIBのために定義されています。これらのフラグ値は、任意の共通MIBフラグを使用してOR結合する必要があります。

QMIB_FORCECLOSE

T_OTMQSPACEオブジェクトのTA_STATE属性をCLEaningに設定する場合、このフラグは、キュー・スペースの状態がACTiveであっても、状態の変更が成功する必要があることを示します。

QMIB_FORCEDELETE

T_OTMQSPACEオブジェクトのTA_STATE属性をINValidに設定する場合、このフラグは、キュー・スペースの状態がACTiveであったり、そのキュー内にメッセージが存在していても、状態の変更が成功する必要があることを示します。同様に、T_OTMQオブジェクトのTA_STATE属性をINValidに設定する場合、このフラグは、メッセージが存在していたり、キュー・スペースにプロセスがアタッチされていても、キューの削除を許可します。

QMIB_FORCEPURGE

T_OTMQオブジェクトのTA_STATE属性をINValidに設定する場合、このフラグは、キューにメッセージが存在していても、状態の変更が成功する必要があることを示します。ただし、現在、選択したT_OTMQに格納されているメッセージがトランザクションに含まれる場合、状態の変更は失敗し、ユーザー・ログにエラーが書き込まれます。

FML32フィールド表

このリファレンス・ページで説明する属性のフィールド表は、システムにインストールしたOracle Tuxedoソフトウェアのルート・ディレクトリからの相対パスで指定されるudataobj/tpadmファイルにあります。${TUXDIR}/udataobjディレクトリは、FLDTBLDIR32環境変数で指定されるパス・リスト(Windowsの場合はセミコロン区切りのリスト、それ以外の場合はコロン区切りのリスト)にアプリケーションによって追加される必要があり、フィールド表名tpadmは、FIELDTBLS32環境変数で指定されるカンマ区切りのリストに追加される必要があります。

制限

このMIBはOracle Tuxedo Message Queue 12cリリース2 (12.1.3)以上のサイトでのみ提供されます(ネイティブおよびワークステーションの両方)。

T_OTMQクラスの定義

概要

T_OTMQクラスは、アプリケーション・キューを表します。単一のアプリケーション・キュー・スペースに1つ以上のアプリケーション・キューが存在する可能性があります。

制限

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。反対に、1つのアプリケーション・キュー・スペースを明示的に指定するには、適切なキー・フィールドを用意する必要があります。これらの必須キー・フィールドはTA_APPQSPACENAME、TA_QMCONFIGおよびTA_LMIDです。ただし、アプリケーションが構成されていない場合(つまり、TUXCONFIG環境変数が設定されていない場合)は、TA_LMIDを省略する必要があります。たとえば、TA_APPQSPACENAME、TA_QMCONFIGおよびTA_LMID属性が、tpcall()を使用するリクエストに設定されると、指定されたキュー・スペース内のすべてのT_OTMQオブジェクトが取得されます。

属性表

^a T_OTMQクラスのすべての属性はローカル属性です。

^b アプリケーションが構成されていない(TUXCONFIG環境変数が設定されていない)場合を除き、TA_LMIDはキー・フィールドとして指定する必要があります。

^c T_OTMQオブジェクトのすべての操作(GETとSETの両方)は、関連付けられているキュー・スペースをサイレントに開きます。つまり、キュー・スペースの状態がOPEnまたはACTiveになっていない場合、暗黙的にOPEnに設定します。キュー・スペースが大きいと、この操作は時間がかかります。

^d アプリケーション・キューの作成後は、TA_APPQORDERを変更できません。

^e 1つのアプリケーション・キュー・スペースを明示的に指定するには、GET操作で適切なキー・フィールドを指定する必要があります。

属性のセマンティクス

TA_APPQNAME: string[1..127]

TA_APPQSPACENAME: string[1..15]

TA_QMCONFIG: string[1..78]

TA_LMID: string[1..30] (カンマなし)

TA_STATE

TA_APPQORDER

PRIO

PRIO,TIME,LIFO

TIME,PRIO,FIFO

TIME,FIFO

EXPIR

EXPIR,PRIO,FIFO

TIME,EXPIR,PRIO,FIFO

TA_CMD: shell-command-string[0..127]

TA_CMDHW: 0 <= num[bBm%]およびTA_CMDLW: 0 <= num[bBm%]

TA_CMDNONPERSIST: shell-command-string[0..127]

TA_CMDNONPERSISTHW: 0 <= num[bB%]およびTA_CMDNONPERSISTLW: 0 <= num[bB%]

TA_CURBLOCKS: 0 <= num

TA_CURMSG: 0 <= num

TA_DEFAULTEXPIRATIONTIME

TA_DEFDELIVERYPOLICY

TA_MAXRETRIES: 0 <= num

TA_OUTOFORDER: {NONE | TOP | MSGID}

TA_RETRYDELAY: 0 <= num

TA_CURNONPERSISTBYTES: 0 <= num

TA_CURNONPERSISTMSG: 0 <= num

TA_PID: 0 <= num

TA_ATTACHSTATE: {ATTACHED | NOTATTACHED}

TA_ACTIVESTATE = {Y | N}

TA_QUETYPE: {P | S | M | U}

TA_PRIMQUE: string[1..127]

TA_TATTACH: YY[MM[DD[hh[mm[ss]]]]]

TA_TDETACH: YY[MM[DD[hh[mm[ss]]]]]

TA_MSGSENT: 0 <= num

TA_MSGRCV: 0 <= num

TA_CONFIRM: {EO|II}

TA_TIMERESTART: 1 <= num

TA_CURTIME: 1 <= num

T_OTMQMSGクラスの定義

概要

T_OTMQMSGクラスは、アプリケーション・キューに格納されているメッセージを表します。メッセージは管理者によって作成されるのではなく、tpenqplus()の呼出しの結果として生成されます。メッセージの破棄は、tpdeqplus()の呼出しによって行うか、管理者によって行われます。また、管理者はメッセージの特定の属性を変更できます。たとえば、管理者は同じキュー・スペース内のキュー間でメッセージを移動したり、その優先度を変更したりできます。

制限

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。反対に、1つのアプリケーション・キュー・スペースを明示的に指定するには、適切なキー・フィールドを用意する必要があります。これらの必須キー・フィールドはTA_APPQSPACENAME、TA_QMCONFIGおよびTA_LMIDです。ただし、アプリケーションが構成されていない場合(つまり、TUXCONFIG環境変数が設定されていない場合)は、TA_LMIDを省略する必要があります。たとえば、TA_APPQSPACENAME、TA_QMCONFIGおよびTA_LMID属性が、tpcall()を使用するリクエストに設定されると、指定されたキュー・スペース内のすべてのキューのすべてのT_OTMQMSGオブジェクトが取得されます。

属性表

^aT_OTMQMSGクラスのすべての属性はローカル属性です。

^bアプリケーションが構成されていない(TUXCONFIG環境変数が設定されていない)場合を除き、TA_LMIDはキー・フィールドとして指定する必要があります。

^c T_OTMQMSGオブジェクトのすべての操作(GETとSETの両方)は、関連付けられているキュー・スペースをサイレントに開きます。つまり、キュー・スペースの状態がOPEnまたはACTiveになっていない場合、暗黙的にOPEnに設定します。キュー・スペースが大きいと、この操作は時間がかかります。

^d1つのアプリケーション・キュー・スペースを明示的に指定するには、GET操作で適切なキー・フィールドを指定する必要があります。

属性のセマンティクス

TA_APPQMSGID: string[1..32]

TA_APPQNAME: string[1..127]

TA_APPQSPACENAME: string[1..15]

TA_QMCONFIG: string[1..78]

TA_LMID: string[1..30] (カンマなし)

TA_STATE

TA_CURRETRIES: 0 <= num

TA_CORRID: string[0..32]

TA_EXPIRETIME: {YY[MM[DD[hh[mm[ss]]]]] | +seconds}

TA_LOWPRIORITY: 1 <= num <= 100 and TA_HIGHPRIORITY: 1 <= num <= 100

TA_MSGEXPIRESTARTTIME: {YY[MM[DD[hh[mm[ss]]]]] | +seconds}およびTA_MSGEXPIREENDTIME: {YY[MM[DD[hh[mm[ss]]]]] | +seconds|NONE}

TA_MSGSIZE: 0 <= num

TA_MSGSTARTTIME: {YY[MM[DD[hh[mm[ss]]]]] | +seconds}およびTA_MSGENDTIME: {YY[MM[DD[hh[mm[ss]]]]] | +seconds}

TA_NEWAPPQNAME: string[1..127]

TA_PERSISTENCE: {PERSIST|NONPERSIST}

TA_PRIORITY: 1 <= num <= 100

TA_REPLYPERSISTENCE: {PERSIST | NONPERSIST | DEFAULT}

TA_TIME: {YY[MM[DD[hh[mm[ss]]]]] | +seconds}

T_OTMQSPACEクラスの定義

概要

T_OTMQSPACEクラスはアプリケーション・キュー・スペースを表します。アプリケーション・キュー・スペースは、Oracle Tuxedoシステム・デバイス内の領域です。デバイスや属性の詳細は、TM_MIB(5)の T_DEVICEクラスを参照してください。各キュー・スペースには、通常は1つ以上のアプリケーション・キューが含まれます。各キューはメッセージを格納できます。

キュー・スペースは、複数の属性によって一意に識別されます。これには、名前(TA_APPQSPACENAME属性)、キュー・スペースが含まれるデバイス(TA_QMCONFIG属性)、およびデバイスが格納されている論理マシン(TA_LMID属性)があります。

通常、キュー・スペースは厳密に、構成済アプリケーション内の1つのサーバー・グループに関連付けられます。キュー・スペース名およびデバイス名は、T_GROUPオブジェクトのTA_OPENINFO属性のコンポーネントです。

制限

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。かわりに、3つのキー・フィールドすべてを指定して単一のアプリケーション・キュー・スペースを明示的に指定する必要があります。唯一の例外は、アプリケーションが構成されていない状況(TUXCONFIG環境変数が設定されていない状況)でtpadmcall()を介してローカル・キュー・スペースにアクセスする場合です。この場合、TA_LMIDキー・フィールドを省略する必要があります。

キュー・スペースのアクセス可能性に関する前述の制限は、T_OTMQ、T_OTMQMSGおよびT_OTMQTRANSオブジェクトにも当てはまります。これは、OTMQ MIB内のすべてのオブジェクトに対する操作にキュー・スペースが暗黙的に関与するためです。

属性表

a. T_OTMQSPACEクラスの属性はすべてローカルです。

b.アプリケーションが構成されていない(TUXCONFIG環境変数が設定されていない)場合を除き、TA_LMIDはキー・フィールドとして指定する必要があります。

c. T_OTMQ、T_OTMQMSGおよびT_OTMQTRANSオブジェクトのすべての操作(GETとSET)は、関連付けられているキュー・スペースをサイレントに開きます。つまり、キュー・スペースの状態がOPEnまたはACTiveになっていない場合、暗黙的にOPEnに設定します。キュー・スペースが大きいと、この操作は時間がかかります。

d.キュー・スペースの作成後は、TA_MAXQUEUESを変更できません。

属性のセマンティクス

TA_APPQSPACENAME: string[1..15]

TA_QMCONFIG: string[1..78]

TA_LMID: string[1..30] (カンマなし)

TA_STATE

TA_BLOCKING: 0 <= num

TA_CURACTIONS: 0 <= num

TA_CURCURSORS: 0 <= num

TA_CUREXTENT: 0 <= num <= 100

TA_CURHANDLES: 0 <= num

TA_CURMEMFILTERS: 0 <= num

TA_CURMEMNONPERSIST: 0 <= num

TA_CURMEMOVERFLOW: 0 <= num

TA_CURMSG: 0 <= num

TA_CUROWNERS: 0 <= num

TA_CURPROC: 0 <= num

TA_CURQUEUES: 0 <= num

TA_CURTMPQUEUES: 0 <= num

TA_CURTRANS: 0 <= num

TA_ERRORQNAME: string[0..127]

TA_FORCEINIT: {Y | N}

TA_HWACTIONS: 0 <= num

TA_HWCURSORS: 0 <= num

TA_HWHANDLES: 0 <= num

TA_HWMEMFILTERS: 0 <= num

TA_HWMEMNONPERSIST: 0 <= num

TA_HWMEMOVERFLOW: 0 <= num

TA_HWMSG: 0 <= num

TA_HWOWNERS: 0 <= num

TA_HWPROC: 0 <= num

TA_HWQUEUES: 0 <= num

TA_HWTMPQUEUES: 0 <= num

TA_HWTRANS: 0 <= num

TA_IPCKEY: 32769 <= num <= 262143

TA_MAXACTIONS: 0 <= num

TA_MAXCURSORS: 0 <= num

TA_MAXHANDLES: 0 <= num

TA_MAXMSG: 0 <= num

TA_MAXOWNERS: 0 <= num

TA_MAXPAGES: 0 <= num

TA_MAXPROC: 0 <= num

TA_MAXQUEUES: 0 <= num

TA_MAXTMPQUEUES: 0 <= num

TA_MAXTRANS: 0 <= num

TA_MEMFILTERS: 0 <= num

TA_MEMNONPERSIST: 0 <= num [bB]

TA_MEMOVERFLOW: 0 <= num

TA_MEMSYSTEMRESERVED: 0 <= num

TA_MEMTOTALALLOCATED: 0 <= num

TA_PERCENTINIT: 0 <= num <= 100

TA_FIRSTTMPQ: 0 <= num

TA_MSGSENT: 0 <= num

TA_MSGRCV: 0 <= num

TA_MRSJRNSAF: {ENABLE|DISABLE}

TA_MRSJRNDQF: {ENABLE|DISABLE}

TA_MRSJRNDLJ: {ENABLE|DISABLE}

TA_MRSJRNPCJ: {ENABLE|DISABLE}

TA_TIMERESTART: 1 <= num

TA_CURTIME: 1 <= num

T_OTMQTRANSクラスの定義

概要

T_OTMQTRANSクラスは、アプリケーション・キューに関連付けられるトランザクションの実行時属性を表します。

制限

すべてのキー・フィールドを未設定にすると、このクラスのインスタンスをすべて検索できません。反対に、1つのアプリケーション・キュー・スペースを明示的に指定するには、適切なキー・フィールドを指定する必要があります。たとえば、tpcall()を使用して、TA_XIDを除くすべてのキー・フィールドをリクエストで設定した場合、指定されたキュー・スペースに対応するT_OTMQTRANSオブジェクトがすべて検索されます。

このクラスのオブジェクトで表現されるトランザクションは必ずしも検索対象のアプリケーションに関連付けられないので注意してください。トランザクションは実際には別のアプリケーションに属していたり、別のアプリケーションに影響を与えたりする場合があるため、トランザクションをヒューリスティックにコミットまたは中断するときには注意が必要です。TA_XID属性の値は、アプリケーション間でユニークであるとはかぎりません。

属性表

a.T_OTMQTRANSクラスのすべての属性はローカル属性です。

b.T_OTMQTRANSオブジェクトのすべての操作(GETとSETの両方)は、関連付けられているキュー・スペースをサイレントに開きます。つまり、キュー・スペースの状態がOPEnまたはACTiveになっていない場合、暗黙的にOPEnに設定します。キュー・スペースが大きいと、この操作は時間がかかります。

c.1つのアプリケーション・キュー・スペースを明示的に指定するには、GET操作で適切なキー・フィールドを指定する必要があります。

属性のセマンティクス

TA_XID: string[1..78]

TA_APPQSPACENAME: string[1..15]

TA_QMCONFIG: string[1..78]

TA_LMID: string[1..30] (カンマなし)

TA_STATE

T_OTMQNAMINGクラスの定義

概要

T_OTMQNAMINGはOTMQ NAMINGエイリアスのクラスです。このクラスを使用して、キュー・スペースのエイリアスを取得します。

制限

T_OTMQNAMINGクラスでは、すべてのネーミング・エイリアスをリストするGETリクエストのみがサポートされています。

属性表

a.T_OTMQNAMINGクラスのすべての属性はローカル属性です。

b.アプリケーションが構成されていない(TUXCONFIG環境変数が設定されていない)場合を除き、TA_LMIDはキー・フィールドとして指定する必要があります。

属性のセマンティクス

TA_APPQSPACENAME

TA_OTMQALIAS

TA_OTMQALIASSCOPE

TA_OTMQSPACETARGET

TA_OTMQTARGET

TA_STATE

TA_LMID: string[1..30] (カンマなし)

OTMQ_MIBに関する追加情報

キュー・スペースに関するOTMQ MIBの使用

Tuxedoドメイン内のすべてのOTMQキュー・スペース(Qspace)のリスト

TSAMエージェントでは、OTMQ_MIBを使用して、特定のTuxedoドメインで構成されたすべてのキュー・スペースを取得します。

アプリケーションが認識しているアプリケーション・キュー・スペースを表示するには、2段階の検索を行います。まず、OTMQトランザクション・マネージャTMS_TMQMを使用するグループがアプリケーション環境設定から検索され、次に各グループが参照しているキュー・スペースが検索されます。以下のコードは、キュー・スペースを使用する各GROUPエントリに1つの論理マシンが関連付けられていると仮定します(つまり、サーバー移行は未使用)。

/* Build the request to retrieve all TMS_TMQM groups */

Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);

Fchg32(rqbuf, TA_CLASS, 0, "T_GROUP", 0);

Fchg32(rqbuf, TA_TMSNAME, 0, "TMS_TMQM", 0);

fldid1 = TA_OPENINFO;

fldid2 = TA_LMID;

Fchg32(rqbuf, TA_FILTER, 0, (char *)fldid1, 0);

Fchg32(rqbuf, TA_FILTER, 0, (char *)fldid2, 1);

/* Make the request, assuming we are joined to the application */

rval = tpcall(".TMIB", rqbuf, 0, rpbuf, rplen, flags);

/* For each TMS_TMQM group, build the request to retrieve its queue space */

rval = Fget32(*rpbuf, TA_OCCURS, 0, (char *)occurs, NULL);

for (i = 0; i occurs; i++) {

  /* Reinitialize the buffer and set all common attributes */

  Finit32(rqbuf, (FLDLEN) Fsizeof32(rqbuf));

  Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);

  Fchg32(rqbuf, TA_CLASS, 0, "T_OTMQSPACE", 0);

  /* Get the OPENINFO to determine device and queue space name */

  /* OPENINFO has the format <resource-mgr>:<qmconfig>:<appqspacename> */

  /* or on Windows <resource-mgr>:<qmconfig>;<appqspacename> */

  rval = Fget32(rpbuf, TA_OPENINFO, i, openinfo, NULL);

  /* The device is the 2nd field in OPENINFO */

  qmconfig = strchr(openinfo, ':') + 1;

  /* The queue space name is the 3rd field in OPENINFO */

#if defined(_TMDOWN) || defined(_TM_NETWARE)

#define pathsep ";" /* separator for PATH */

#else

#define pathsep ":" /* separator for PATH */

#endif

  appqspacename = strchr(qmconfig, pathsep);

  appqspacename[0] = '\e0'; /* NULL-terminate qmconfig */

  appqspacename++; /* bump past the NULL */

  /* Set the APPQSPACENAME and QMCONFIG keys */

  Fchg32(rqbuf, TA_APPQSPACENAME, 0, appqspacename, 0);

  Fchg32(rqbuf, TA_QMCONFIG, 0, qmconfig, 0);

  /* Get the LMID (assume no migration for this group) */

  rval = Fget32(rpbuf, TA_LMID, i, lmid, NULL);

  Fchg32(rqbuf, TA_LMID, 0, lmid, 0);

  /* Make the request */

  rval = tpcall(".TMIB", rqbuf, 0, rpbuf2, rplen2, flags);

}

上記のコードでは、キュー・スペースが作成されていても、アプリケーションの構成に対応するGROUPエントリがないと、キュー・スペースは検索されません。このようなキュー・スペースは、キュー・スペースのキー・フィールド(TA_OTMQSPACENAME、TA_QMCONFIGおよびTA_LMID)の優先順位がわかっていなければ検索できません。

OTMQキュー・スペース(Qspace)構成データの表示

TSAMエージェントでは、OTMQ_MIBを使用して、特定のTuxedoドメインで構成された特定のキュー・スペースに関する構成情報を取得します。

/* Build the request */ 

Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);

Fchg32(rqbuf, TA_CLASS, 0, "T_OTMQSPACE", 0);

Fchg32(rqbuf, TA_APPQSPACENAME, 0, "QSPACE1", 0);

Fchg32(rqbuf, TA_QMCONFIG, 0, "/dev/q/dsk001", 0);

Fchg32(rqbuf, TA_LMID, 0, "SITE1", 0);

/* Make the request;*/

キューに関するOTMQ MIBの使用

OTMQキュー・スペース(Qspace)内のすべてのOTMQキューのリスト

TSAMエージェントでは、OTMQ_MIBを使用して、特定のTuxedoドメインで構成されたキュー・リストを取得します。

次のコードは、論理マシンSITE1上のデバイス/dev/q/dsk001のキュー・スペースQSPACE1のすべてのキューを取得します。

/* Build the request */ Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);

Fchg32(rqbuf, TA_CLASS, 0, "T_OTMQ", 0);

Fchg32(rqbuf, TA_APPQSPACENAME, 0, "QSPACE1", 0);

Fchg32(rqbuf, TA_QMCONFIG, 0, "/dev/q/dsk001", 0);

Fchg32(rqbuf, TA_LMID, 0, "SITE1", 0);

/* Make the request; see above */

キューに関する詳細情報の取得

TSAMエージェントでは、OTMQ_MIBを使用して、特定のTuxedoドメインで構成された特定のキューのメッセージ・カウンタおよび割当てなどの詳細情報を取得します。

/* Build the request */ 

Fchg32(rqbuf, TA_OPERATION, 0, "GET", 0);

Fchg32(rqbuf, TA_CLASS, 0, "T_OTMQ", 0);

Fchg32(rqbuf, TA_APPQNAME, 0, "errque", 0);

Fchg32(rqbuf, TA_APPQSPACENAME, 0, "QSPACE1", 0);

Fchg32(rqbuf, TA_QMCONFIG, 0, "/dev/q/dsk001", 0);

Fchg32(rqbuf, TA_LMID, 0, "SITE1", 0);

/* Make the request;*/

関連項目