管理コンソール・オンライン・ヘルプ

     前  次    新規ウィンドウで目次を開く  新規ウィンドウで索引を開く  PDFとして表示 - 新規ウィンドウ  Adobe Readerを入手 - 新規ウィンドウ
コンテンツはここから始まります

アプリケーション・キューの作成と構成

Oracle Tuxedoシステムは、時間に依存しない通信にアプリケーション・キューを使用します。Oracle Tuxedoシステム・アプリケーションでは、メッセージはキューに格納され、キューは特定のキュー・スペース内に定義されています。キューイングとデキューはトランザクション内で行われます。BEA Tuxedo管理コンソールには、アプリケーション・キューの管理とアクセス制御に必要な管理環境が用意されています。次のヘルプ・トピックには、アプリケーション・キュー・リソースに関する情報が記載されています。

 


アプリケーション・キュー

「アプリケーション・キュー」ツリー・リソースでは、パス名、マシンID、処理順序など、アプリケーション・キューの属性を管理できます。

<a name="N_APPQ"></a>

 


アプリケーション・キューの作成

新規アプリケーション・キューを作成するには、次の手順に従います。

  1. ツリーで「アプリケーション・キュー」フォルダを選択し、クイック・メニューの「新規」(マウスを右クリック)を選択して、「新規オブジェクトの作成」ウィンドウを表示します。
  2. 次のフィールドに値を入力します。
  3. 「作成」をクリックしてウィンドウを閉じ、新規アプリケーション・キューを作成します。

「新規オブジェクトの作成」ウィンドウの使用方法は、「管理クラス・オブジェクトの作成」を参照してください。

<a name="T_APPQ"></a>

 


アプリケーション・キューの構成(T_APPQクラス)

アプリケーション・キューの属性は、次のタブ・ページにリストされます。

構成ツールには、読取り専用のフィールドがいくつかあります。これらの表示専用フィールドで提供される情報は簡単に説明されています。構成ツールを使用した管理リソースの構成に関する一般情報は、「管理オブジェクトの構成」を参照してください。

<a name="C_APPQ"></a>

「全般」タブ

「一般」タブ・ページには、次のフィールドがあります。

<a name="13029"></a><a name="12238"></a>

 


アプリケーション・キュー名(TA_APPQNAME)

説明

操作するアプリケーション・キューの名前。

有効な値

1から127文字の長さの文字列。

Q_OPENACCT

<a name="13030"></a><a name="12240">

 


アプリケーション・キュー・スペース名(TA_APPQSPACENAME)

説明

アプリケーション・キューに関連付けられるアプリケーション・キュー・スペースの名前。このフィールドに入力すると、該当するキュー・スペースを識別するために行う必要のある操作の半分が終わります。また、アプリケーション・キュー・スペース・デバイス(TA_QMCONFIG)に値を入力する必要もあります。

有効な値

1から15文字の長さの文字列。

QSP_BANKAPP

<a name="13031"></a><a name="12245"></a>

 


アプリケーション・キュー・スペース・デバイス(TA_QMCONFIG)

説明

アプリケーション・キュー構成デバイスのパス名です。非アクティブ化した構成を使用している現在のマシン上のパス名にする必要があります。このフィールドに入力すると、アプリケーション・キューに関連付けられたキュー・スペースを識別するために行う必要のある操作の半分が終わります。また、アプリケーション・キュー・スペース名(TA_APPQSPACENAME)に値を入力する必要もあります。

有効な値

1から78文字の長さの文字列。

Q_DEVICE

<a name="13028"></a><a name="12246"></a>

 


論理マシン名(TA_LMID)

説明

アプリケーション・キュー・スペースが存在するマシンの論理マシン識別子。

有効な値

1から30文字の長さの文字列

SITE1

ノート

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

<a name="12237"></a>

 


オブジェクト状態(TA_STATE)

説明

このフィールドには、アプリケーション・キューの状態が表示されます。アプリケーション・キューは、次のいずれかの状態になります。

アプリケーション・キューに対するすべての操作は(GETかSETかにかかわらず)、関連付けられているキュー・スペースを自動的にオープンします(つまり、キュー・スペースの状態がOPENまたはACTIVEになっていない場合は、暗黙的にOPENに設定します)。キュー・スペースが大きいと、この操作は時間がかかります。

「キュー・メッセージ」タブ

「キュー・メッセージ」タブ・ページには、次のフィールドがあります。

<a name="12239"></a><a name="13028"></a>

 


キュー・メッセージの処理順序(TA_APPQORDER)

説明

キュー内のメッセージを処理する順序。アプリケーションの順序を選択する前にニーズをじっくり検討してください。アプリケーション・キューの作成後には、このフィールドの値を変更できません。

有効な値

次にリストする組合せの1つを選択します。カンマは、プライマリ処理順序内のセカンダリ(下位)処理順序を示します。たとえば、PRIO, LIFOは、キューが優先度順に処理されますが、キュー内の2つのアイテムが同じ優先度を持つ場合は、後入れ先出し順序で処理されることを意味します。

FIFO - 先入れ先出し

PRIO, LIFO - 優先度(次に後入れ先出し)

PRIO, FIFO - 優先度(次に先入れ先出し)

TIME, LIFO - 実行時間(次に後入れ先出し)

PRIO, TIME, LIFO - 優先度(次に実行時間、次に後入れ先出し)

PRIO, TIME, LIFO - 優先度(次に実行時間、次に先入れ後出し)

TIME, PRIO, LIFO - 実行時間(次に優先度、次に後入れ先出し)

デフォルト値

FIFO

<a name="12244"></a>

 


不正なメッセージの処理(TA_OUTOFORDER)

説明

不正なメッセージ処理の処理方法。

有効な値

以下のいずれか1つを選択します。

デフォルト値

なし

<a name="12234"></a>

 


現在のメッセージ数(TA_CURMSG)

説明

このフィールドには、現在キューにあるメッセージ数が表示されます。

<a name="12233"></a>

 


使用された現在のディスク・ページ数(TA_CURBLOCKS)

説明

このフィールドには、現在キューにあるディスク・ページ数が表示されます。

<a name="retries"></a>

「再試行」タブ

「再試行」タブ・ページには、次のフィールドがあります。

<a name="12235"></a>

 


再試行の最大回数(TA_MAXRETRIES)

説明

失敗したキュー・メッセージの最大再試行回数。この再試行回数に達すると、メッセージは「エラー・キュー名」(TA_ERRORQNAME)で定義されているキューのアプリケーション・キュー・スペースのエラー・キューに配置されます。エラー・キューがない場合、メッセージは破棄されます。

有効な値

0以上の数値

デフォルト値

ゼロ

<a name="12236"></a>

 


再試行の間の遅延(秒単位)(TA_RETRYDELAY)

説明

失敗したキュー・メッセージの再試行の間の遅延(秒単位)。

有効な値

0以上の数値

デフォルト値

ゼロ

<a name="c_retries"></a>

「コマンド」タブ

「コマンド」タブ・ページには、次のフィールドがあります。

<a name="12242"></a>

 


コマンド実行の上限(TA_CMDHW)

説明

コマンド実行の上限は、ゼロ以上の整数にオプションで次のいずれかが続く値で表現されます。

Bまたはb - 上限はディスク・ブロック数で表されます。

Mまたはm - 上限はメッセージ数で表されます。

% - 上限はキュー容量に対する割合で表されます。

構文

num [b | m | %](numはゼロ以上の数値)

デフォルト値

デフォルトは100です。

<a name="12243"></a>

 


コマンド実行の下限(TA_CMDLW)

説明

コマンド実行の下限は、ゼロ以上の整数にオプションで次のいずれかが続く値で表現されます。

Bまたはb - 下限はディスク・ブロック数で表されます。

Mまたはm - 下限はメッセージ数で表されます。

% - 下限はキュー容量に対する割合で表されます。

有効な値

num [b | m | %](numはゼロ以上の数値)

デフォルト値

デフォルトは0です。

<a name="12241"></a>

 


実行するコマンド(TA_CMD)

説明

上限に達した場合に実行するコマンド。下限の後に上限に達した場合は、コマンドが再実行されます。

有効な値

シェル・コマンド。78文字までの長さの文字列である必要があります。

デフォルト値

エントリなし

 


アプリケーション・キュー・スペース

アプリケーション・キュー・スペース・オブジェクトでは、アプリケーション・キュー・スペースの属性を管理できます。

<a name="N_APPQSPACE"></a>

 


アプリケーション・キュー・スペースの作成

新規アプリケーション・キュー・スペースを作成するには、次の手順に従います。

  1. ツリーでアプリケーション・キュー・スペース・フォルダを選択します。
  2. クイック・メニューで「新規」(右クリック)を選択して、「新規オブジェクトの作成」ウィンドウを表示します。
  3. 次のフィールドに値を入力します。

「新規オブジェクトの作成」ウィンドウの使用方法は、「管理クラス・オブジェクトの作成」を参照してください。

<a name="T_APPQSPACE"></a>

 


アプリケーション・キュー・スペースの構成(T_APPQSPACEクラス)

アプリケーション・スペースの属性は、次のラベルの6つのタブ・ページにリストされます。

構成ツールを使用した管理リソースの構成に関する一般情報は、「管理オブジェクトの構成」を参照してください。

<a name="C_APPQSPACE"></a>

「全般」タブ

「一般」タブ・ページには、次のフィールドがあります。

この項では、これらのフィールドについて説明します。

<a name="13038"></a> <a name="12265"></a>

 


アプリケーション・キュー・スペース名(TA_APPQSPACENAME)

説明

アプリケーション・キュー・スペースの識別に使用される名前。

有効な値

1から15文字の長さの文字列。

QSP_BANKAPP

<a name="12268"></a>

 


アプリケーション・キュー・スペース・デバイス(TA_QMCONFIG)

説明

アプリケーション・キュー・スペースが存在するファイルまたはデバイスの絶対パス名。

有効な値

1から78文字の長さの文字列。

/HOME4/APPS/BANKAPP/QSPDVC

<a name="12269"></a>

 


論理マシン名(TA_LMID)

説明

アプリケーション・キュー・スペースが存在する論理マシンの識別子。

有効な値

1から30文字の長さの文字列。

SITE1

ノート

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

<a name="13032"></a> <a name="12249"></a>

 


IPCキー(TA_IPCKEY)

説明

キュー・スペースの共有メモリーにアクセスするときに使用する数値キー。

有効な値

32769から262143までの範囲の数値。

88945

<a name="12266"></a>

 


エラー・キュー名(TA_ERRORQNAME)

説明

キュー・スペースに関連付けられているエラー・キューの名前。

有効な値

0から127文字の長さの文字列。

デフォルト値

エントリなし

Q_ERROR

<a name="12264"></a>

 


オブジェクト状態(TA_STATE)

説明

このフィールドには、アプリケーション・キュー・スペースの状態が表示されます。アプリケーション・キュー・スペースは、次のいずれかの状態になります。

アプリケーション・キュー・クラスに対するすべての操作は、関連付けられているキュー・スペースを自動的にオープンします(つまり、キュー・スペースの状態がOPENまたはACTIVEになっていない場合は、暗黙的にOPENに設定します)。キュー・スペースが大きいと、この操作は時間がかかります。

<a name="diskpg"></a>

「ディスク/ページ数」タブ

「ディスク/ページ数」タブ・ページには、次のフィールドがあります。

この項では、これらのフィールドについて説明します。

<a name="13035"></a> <a name="12260"></a>

 


最大ディスク・ページ数(TA_MAXPAGES)

説明

キュー・スペース内のすべてのキューによって使用されるディスク・ページの最大数。この属性が増加するたびに、新しいエクステントが使用されます。このフィールドに小さい値を入力することでページ数を減らすことはできません。

有効な値

0以上の数値。

200

<a name="12251"></a>

 


ブロッキング・ファクタ(TA_BLOCKING)

説明

キュー・スペースのディスク領域管理で使用するブロッキング・ファクタ。新しいキュー・スペースが作成された場合のデフォルト値は16です。

有効な値

0以上の数値。

デフォルト値

16

<a name="12252"></a>

 


現在のエクステント数(TA_CUREXTENT)

説明

このフィールドには、キュー・スペースで現在使用中のエクステント数が表示されます。使用できる最大エクステント数は100です。

<a name="12263"></a>

 


ディスクの初期化率(TA_PERCENTINIT)

説明

このフィールドには、キュー・スペース用に初期化されたディスク領域のパーセンテージが表示されます。

<a name="12267"></a>

 


新しいエクステントの初期化を強制(TA_FORCEINIT)

説明

Yes」を選択してアプリケーション・キュー・スペースを即時に強制的に初期化するか、「No」を選択して初期化を遅延します。

有効な値

YesまたはNo

デフォルト値

No

<a name="queuefolder"></a>

「キュー」タブ

「キュー」タブ・ページには、次のフィールドがあります。

この項では、これらのフィールドについて説明します。

<a name="13033"></a><a name="12250"></a>

 


最大キュー数(TA_MAXQUEUES)

説明

キュー・スペースに保存可能な最大キュー数。

有効な値

0以上の数値。

20

<a name="12247"></a>

 


現在のキュー数(TA_CURQUEUES)

説明

このフィールドには、キュー・スペースに現在存在するサーバー・キューの数が表示されます。この数は、キュー・スペースが新規、オープン、またはアクティブの場合にのみ決定できます。それ以外の場合は、-1の値が表示されます。

<a name="12248"></a>

 


最大キュー数(TA_HWQUEUES)

説明

このフィールドには、キュー・スペースが最後にオープンされてから、ある特定の時点にキュー・スペース内に存在していたキューの最大数が表示されます。

<a name="transaction"></a>

「トランザクション」タブ

「トランザクション」タブ・ページには、次のフィールドがあります。

この項では、これらのフィールドについて説明します。

<a name="13037"></a> <a name="12262"></a>

 


最大オープン・トランザクション数(TA_MAXTRANS)

説明

キュー・スペースでオープンできる最大トランザクション数。

有効な値

0以上の数値。

5

<a name="12255"></a>

 


現在のオープン・トランザクション数(TA_CURTRANS)

説明

このフィールドには、キュー・スペースを使用する未処理トランザクションの現在の数が表示されます。

<a name="12258"></a>

 


最大オープン・トランザクション数(TA_HWTRANS)

説明

このフィールドには、キュー・スペースが最後にオープンされた後、キュー・スペースを使用する未処理トランザクションの最大数が表示されます。キュー・スペースが最後にオープンされた後にキュー・スペースに存在する最大キュー数です。キュー・スペースの状態がCLEANINGに設定されると、この値は0にリセットされます。

<a name="process"></a>

「プロセス」タブ

「プロセス」タブ・ページには、次のフィールドがあります。

この項では、次のフィールドについて説明します。

<a name="13036"></a> <a name="12261"></a>

 


最大プロセス数(TA_MAXPROC)

説明

キュー・スペースに同時にアクセスできる最大プロセス数。

有効な値

0以上の数値。

5

<a name="12254"></a>

 


現在のプロセス数(TA_CURPROC)

説明

このフィールドには、キュー・スペースに現在アクセスしているプロセス数が表示されます。

<a name="12257"></a>

 


最大プロセス数(TA_HWPROC)

説明

このフィールドには、キュー・スペースが最後にオープンされてから、ある特定の時点にキュー・スペースに同時にアタッチされる最大プロセス数が表示されます。

<a name="trans_message"></a>

「メッセージ」タブ

「メッセージ」タブ・ページには、次のフィールドがあります。

この項では、これらのフィールドについて説明します。

<a name="13034"></a> <a name="12259"></a>

 


最大メッセージ数(TA_MAXMSG)

説明

キュー・スペースに保存できる最大メッセージ数。

有効な値

0以上の数値。

200

<a name="12253"></a>

 


現在のメッセージ数(TA_CURMSG)

説明

このフィールドには、キュー・スペース内の現在のメッセージ数が表示されます。この数は、キュー・スペースがOPEnまたはACTiveの場合、またはキュー・スペースを新規に作成する場合にのみ指定できます。どの条件にも該当しない場合は、値-1が戻されます。

<a name="12256"></a>

 


最大メッセージ数(TA_HWMSG)

説明

このフィールドには、キュー・スペースが最後にオープンされてから、ある特定の時点にキュー・スペースに同時に存在する最大メッセージ数が表示されます。

 


アプリケーション・キュー・メッセージ

アプリケーション・キュー・メッセージ・オブジェクトでは、アプリケーション・キュー・メッセージの属性を管理できます。

<a name="T_APPQMSG"></a>

 


アプリケーション・キュー・メッセージの構成(T_APPQMSGクラス)

アプリケーション・キュー・メッセージの属性は、次のラベルの3つのタブ・ページにリストされます。

構成ツールを使用した管理リソースの構成に関する一般情報は、「管理オブジェクトの構成」を参照してください。

<a name="C_APPQMSG"></a>

「全般」タブ

「一般」タブ・ページには、次のフィールドがあります。

この項では、これらのフィールドについて説明します。

 


オブジェクト状態(TA_STATE)

説明

このフィールドには、アプリケーション・キュー・メッセージの状態が表示されます。アプリケーション・キュー・メッセージには、VALIDという1つの状態のみあります。

注: アプリケーション・キュー・メッセージに対するすべての操作(GETとSETの両方)は、関連付けられているキュー・スペースを自動的にオープンします(つまり、キュー・スペースの状態がOPENまたはACTIVEになっていない場合は、暗黙的にOPENに設定します)。キュー・スペースが大きいと、この操作は時間がかかります。

<a name="12276"></a>

 


アプリケーション・キュー・メッセージID(TA_APPQMSGID)

説明

このフィールドには、キュー・メッセージの一意の識別子が表示され、GETまたはSET操作のメッセージの選択に使用できます。この値は等価性を比較する際に便宜上付与されるだけなので、重要視しないでください。

<a name="12277"></a>

 


アプリケーション・キュー名(TA_APPQNAME)

説明

このフィールドには、メッセージが格納されているアプリケーション・キューの名前が表示されます。

<a name="12278"></a>

 


アプリケーション・キュー・スペース名(TA_APPQSPACENAME)

説明

このフィールドには、メッセージが格納されているアプリケーション・キュー・スペースの名前が表示されます。

<a name="12283"></a>

 


アプリケーション・キュー・スペース・デバイス(TA_QMCONFIG)

説明

このフィールドには、アプリケーション・キュー・スペースが存在するファイルまたはデバイスの絶対パス名が表示されます。

<a name="12285"></a>

 


論理マシン名(TA_LMID)

説明

このフィールドには、アプリケーション・キュー・スペースが存在する論理マシンの識別子が表示されます。

<a name="q_msgs">

「キュー・メッセージ」タブ

「キュー・メッセージ」タブ・ページには、次のフィールドがあります。

この項では、これらのフィールドについて説明します。

<a name="12270"></a>

 


再試行回数(TA_CURRETRIES)

説明

このフィールドには、このメッセージに対してこれまでに試行された再試行回数が表示されます。

<a name="12273"></a>

 


メッセージ・サイズ(TA_MSGSIZE)

説明

このフィールドには、メッセージのサイズ(バイト単位)が表示されます。

<a name="12274"></a>

 


メッセージの優先度(TA_PRIORITY)

説明

メッセージの優先度。このフィールドの値は、PRIOベースのキューに対してのみ有効です。キューがPRIOベースでない場合は、GET操作によって値-1が戻されます。

有効な値

1から100までの範囲の数値。

4

<a name="12279"></a>

 


相関識別子(TA_CORRID)

説明

このフィールドには、tpenqueue(3)リクエストでアプリケーションによって提供される、このメッセージの相関識別子が表示されます。空の文字列は、相関識別子が存在しないことを示します。

<a name="12282"></a>

 


新規アプリケーション・キュー名(TA_NEWAPPQNAME)

説明

選択したメッセージの移動先のキューの名前。このキューは、同じキュー・スペース内の既存のキューである必要があります。メッセージがVALID状態でないかぎり、この操作は成功しません。

有効な値

1から127文字の長さの文字列。

APPQ3

<a name="12284"></a>

 


メッセージを処理する時間(TA_TIME)

説明

メッセージが処理される時刻。このフィールドの値は、TIMEベースのキューに対してのみ有効です。(キューがTIMEベースでない場合は、GET操作によって空の文字列が戻されます。)

有効な値

次のいずれかの形式を使用します。

形式1:

+seconds

メッセージがseconds秒後に処理されることを指定します。値0(ゼロ)は、メッセージが即時に処理されることを指定します。

形式2:

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

メッセージが処理される時刻の年、月、日、時、分および秒を指定します。

省略した単位のデフォルトは、可能な最小値になります。

形式2の例:

9506

これは、950601000000と等しくなります。00から37までの年は、2000年から20037年として処理され、70から99までの年は1970年から1999年まで、38から69までは無効となります。

<a name="q_stats">

「統計」タブ

「統計」タブ・ページには、次のフィールドがあります。

この項では、これらのフィールドについて説明します。

<a name="12271">

 


高優先度(TA_HIGHPRIORITY)

説明

アプリケーション・メッセージの発生を検索する範囲の最高優先度。

<a name="12272"></a>

 


低優先度(TA_LOWPRIORITY)

説明

アプリケーション・メッセージの発生を検索する範囲の最低優先度。

<a name="12280"></a>

 


終了時刻(TA_MSGENDTIME)

説明

アプリケーション・キュー・メッセージの発生の検索が実行される期間の終わりを示す時刻。

<a name="12281"></a>

 


開始時刻(TA_MSGSTARTTIME)

説明

アプリケーション・キュー・メッセージの発生の検索が実行される期間の開始を示す時刻。

 


アプリケーション・キュー・トランザクション

アプリケーション・キュー・トランザクション・オブジェクトでは、アプリケーション・キュー・トランザクションの属性を管理できます。

<a name="T_APPQTRANS"></a>

 


アプリケーション・キュー・トランザクションの構成(T_APPQTRANSクラス)

アプリケーション・キュー・トランザクションの属性は、「一般」というラベルの付いたタブ・ページにリストされます。アプリケーション・キュー・トランザクションのフィールドは情報フィールドであり、編集できません。アプリケーション・キュー・トランザクションの「一般」タブ・ページ・フィールドは次のとおりです。

<a name="C_APPQTRANS"></a>

「全般」タブ

「一般」タブ・ページには、次のフィールドがあります。

<a name="12286"></a>

 


オブジェクト状態(TA_STATE)

このフィールドには、アプリケーション・キュー・トランザクションの状態が表示されます。アプリケーション・キュー・トランザクションの状態は、ACTIVEABORTONLYABORTEDCOMCALLEDREADYDECIDEDまたはSUSPENDEDのいずれかになります。

アプリケーション・キュー・トランザクションに対するすべての操作(GETとSETの両方)は、関連付けられているキュー・スペースを自動的にオープンします(つまり、キュー・スペースの状態がOPENまたはACTIVEになっていない場合は、暗黙的にOPENに設定します)。キュー・スペースが大きいと、この操作は時間がかかります。

<a name="12287"></a>

 


トランザクション識別子(TA_XID)

このフィールドには、tx_info(3)から戻され、文字列表現にマップされるトランザクション識別子が表示されます。このフィールドのデータは、等号比較の場合を除いて、ユーザーが直接解釈することはできません。

<a name="12288"></a>

 


アプリケーション・キュー・スペース名(TA_APPQSPACENAME)

このフィールドには、トランザクションに関連付けられているアプリケーション・キュー・スペースの名前が表示されます。

<a name="12289"></a>

 


アプリケーション・キュー・スペース・デバイス(TA_QMCONFIG)

このフィールドには、アプリケーション・キュー・スペースが存在するファイルまたはデバイスの絶対パス名が表示されます。

<a name="12290"></a>

 


論理マシン名(TA_LMID)

このフィールドには、アプリケーション・キュー・スペースが存在する論理マシンの識別子が表示されます。

構成ツールを使用した管理リソースの構成に関する一般情報は、「管理オブジェクトの構成」を参照してください。


  先頭に戻る       前  次