Interstage Application Server リファレンスマニュアル(コマンド編)
目次 索引 前ページ次ページ

第2部 OLTPシステム運用編> 第8章 CORBAサービス運用コマンド

8.13 odsetque

名前

 odsetque − サーバアプリケーションのキューイングポリシへの登録/削除

形式

(1) サーバアプリケーションのキューイングポリシへの登録
 odsetque -a {-q|-w} groupname membername1 [membername2 ...] [-M system]

(2) キューイングポリシからサーバアプリケーションの削除
 odsetque -d {-q|-w} groupname [-M system]

(3) キューイングポリシに登録されたサーバアプリケーションの一覧表示
 odsetque -l [-M system]

機能説明

 odsetqueコマンドは、キューイングポリシに対してサーバアプリケーションのインプリメンテーション情報を登録・削除・表示します。登録されたサーバアプリケーションはキューイングポリシに従ってクライアントからのリクエストを処理します。
 ただし、本コマンドで登録したインプリメンテーションリポジトリIDに相当するCORBAサーバアプリケーションは、CORBAワークユニットとして運用できません。

 本コマンドは、管理者権限で実行する必要があります。初めてキューイングポリシを使用する場合は、キューイングポリシ雛型ファイルのqueue_policy.defaultファイルを複写して、queue_policyファイルを作成しておく必要があります。キューイングポリシファイルの格納先は以下のディレクトリです。

(インストールパスはデフォルト)

 C:\Interstage\ODWIN\etc

(インストールパスはデフォルト)

 /opt/FSUNod/etc

 /opt/FJSVod/etc

 本コマンドで指定可能なオプションとパラメタを以下に示します。

-a

 指定されたインプリメンテーションリポジトリIDに相当するサーバアプリケーションをキューイングポリシへ登録します。

-d

 指定されたインプリメンテーションリポジトリIDに相当するサーバアプリケーションをキューイングポリシから削除します。

-l

 キューイングポリシに登録されたサーバアプリケーションの一覧を表示します。

-q

 キュー操作を行います。

-w

 キューグループ操作を行います。

groupname

 キューイングポリシの登録/削除を行うキュー名またはキューグループ名を指定します。最大255文字までの任意の文字列が指定可能です。

membername

 キューに登録するインプリメンテーションリポジトリIDまたはキューグループに登録するキュー名を指定します。

-M system

 拡張システムを生成した場合に、運用の対象となるシステム名systemを指定します。本オプションを省略すると、デフォルトシステムでの運用が対象となります。
 本オプションは、以下の製品で指定可能です。
 − Interstage Application Server Enterprise Edition

キューイングポリシへの登録

 サーバアプリケーションのキューイングポリシへの登録として、複数のインプリメンテーションリポジトリIDを1つのキューとして指定することができます。また、作成したキューを複数まとめてキューグループとして別名管理することができます。キューイングポリシへの登録は、先にOD_impl_instコマンドによりインプリメンテーションリポジトリIDを登録する必要があります。

 インプリメンテーションリポジトリIDをキューに登録する例を以下に示します。
 odsetque -a -q queue1 IDL:test1/intf1:1.0 IDL:test2/intf2:1.0

 キューイングポリシに登録した複数のキューをキューグループとしてさらに1つにまとめて管理する例を以下に示します。
 odsetque -a -w queue_group1 queue1 queue2 ...

 キューイングポリシに登録したアプリケーションは、odcntlqueコマンドで活性化、非活性化の操作が可能です。また、キューイングポリシに登録した情報はCORBAサービスを再起動しなければ有効になりません。

 キューイングポリシからの削除

 サーバアプリケーションをキューイングポリシから削除する例を以下に示します。キュー名またはキューグループ名を指定します。

 例を以下に示します。ネーミングサービス、インタフェースリポジトリのインプリメンテーションリポジトリIDをキューイングポリシから削除しないでください。
 odsetque -d -q queue1またはodsetque -d -w queue_group1

 キューイングポリシのリスト表示

 キューイングポリシに登録されているサーバアプリケーションの一覧を表示します。例を以下に示します。
 odsetque -l

 登録されているエントリがない場合は"No QueueGroup entry"または"No Queue entry"が表示されます。

 受付け可能リクエスト数の上限値について

 システム全体で受付け可能なリクエスト数の上限値はconfigファイルの値で設定できます。

 (システムの上限値)= limit_of_max_IIOP_resp_requests
 (上限値が256より小さい場合は256に設定されます。)

 キューごとに受付け可能なリクエスト数の最大値を設定するには、キューイングポリシファイルの[GUARANTY]セクションの下に上限値の定義が必要です。
 キュー名がqueue1のキューの上限値を64に設定する例を以下に示します。

 [GUARANTY]
  queue1 = 64

 上限の定義がない場合はシステムの上限値がキューの上限値に設定されます。

キューイングポリシとは

 CORBAサービスのキュー制御の動作を決定する定義です。キューイングポリシによりオブジェクトへのリクエストをどのキューに振り分けるのかを決定します。

注意事項

メッセージ

 起動時に表示されるメッセージと意味を以下に示します。

groupname already exists
 groupnameはすでに存在します。

groupname not found
 groupnameが見つかりません。

groupname is invalid
 groupnameが無効です。

groupname is too long
 groupnameが長過ぎます。

membername already registered
 membernameは登録済みです。

ImplementationRepositoryID not found
 インプリメンテーションリポジトリIDが見つかりません。

OD_HOME is not set
 環境変数OD_HOMEが未設定です。

cannot open queue_policy file
 queue_policyファイルがオープンできません。

cannot create queue_policy file
 queue_policyファイルが作成できません。

writing queue_policy file failed
 queue_policyファイルの書込みに失敗しました。

renaming queue_policy file failed
 queue_policyファイルの変名に失敗しました。

cannot open impl.db file
 impl.dbファイルがオープンできません。


目次 索引 前ページ次ページ

All Rights Reserved, Copyright(C) 富士通株式会社 2005