名称

create-jmsdest - 物理的な送信先の登録

形式

create-jmsdest --user admin_user [--password admin_password] [--host host_name] [--port port_number] [--passwordfile filename] [--terse=true|false] [--echo=true|false] [--interactive] [--desttype|-T topic|queue] [--consumerFlowLimitNum limit_num] [--limitBehavior behavior] [--maxBytesPerMsg max_bytes] [--maxNumActiveConsumers num_active_consumers] [--maxNumBackupConsumers num_backup_consumers] [--maxNumMsgs num_msgs] [--maxNumProducers num_producers] [--maxTotalMsgBytes total_msg_bytes] [--isLocalOnly is_Local_Only] [--localDeliveryPreferred local_Delivery_Preferred] [--property (name=value) [:name=value]*] dest_name

説明

JMSの物理的な送信先を作成します。create-jms-resourceコマンドでJMS送信先リソースを作成する場合、--wojmsDestinationNameオプションには、このコマンドで作成した物理的な送信先を指定します。このコマンドはリモートモードでのみ使用できます。

オプション

--user

ドメインアプリケーションサーバの管理ユーザ名

--password

ドメインアプリケーションサーバの管理ユーザのパスワード

--host

ドメインアプリケーションサーバが起動しているマシン名

--port

ドメインアプリケーションサーバのポート番号(既定値：6212)

--passwordfile

ドメインアプリケーションサーバの管理ユーザのパスワード を含むファイル

--terse

trueを指定すると、出力データがスクリプトによる処理のための簡潔なデータとなります。既定値はfalseです。

--echo

trueを指定すると、標準出力でコマンドライン文が表示されます。既定値はfalseです。

--interactive

true(既定値)を指定すると、パスワードオプション入力用のプロンプトを表示します。

--desttype

JMS送信先の種類。有効な値はtopicとqueueです。

--consumerFlowLimitNum

JMSサーバが一度の処理でコンシューマに配信するメッセージの最大数を指定します。ただし、各コンシューマが使用するコネクションファクトリで指定された制限値の方が低い場合は、その値が優先します。-1は無制限です。既定値は1000です。

--limitBehavior

メモリ制限のしきい値に到達したときのJMSサーバの振る 舞いを指定します。FLOW_CONTROLは、プロデューサとの間でフロー制御（低速化）を行います。REMOVE_OLDESTは、最古のメッセージを破棄します（プロデューサがメッセージ削除の通知を受け取ることはありません）。 REMOVE_LOW_PRIORITYは、メッセージの有効期限に従い優先度が最低のメッセージを破棄します（プロデューサがメッセージ削除の通知を受け取ることはありません）。REJECT_NEWESTは、最新のメッセージを拒否します（永続メッセージの場合はプロデューサに拒否に関する例外が発生しますが、非永続メッセージの場合には発生しません）。既定値はREJECT_NEWESTです。

--maxBytesPerMsg

１メッセージあたりの最大サイズ（バイト単位）を指定します（永続メッセージの場合はプロデューサに例外が発生しますが、非永続メッセージの場合には何も通知されません）。-1は無制限を意味します。既定値は-1です。

--maxNumActiveConsumers

Queueからの配信が負荷分散されているアクティブコンシューマの最大数を指定します。-1は無制限を意味します。既定値は-1です。この指定はQueueにのみ有効です。

--maxNumBackupConsumers

アクティブコンシューマの障害時にバックアップするバックアップコンシューマの最大数を指定します。-1は無制限を意味します。既定値は0です。この指定はQueueにのみ有効です。

--maxNumMsgs

送信先に滞留可能なメッセージの最大数を指定します。-1は無制限を意味します。既定値は-1です。

--maxNumProducers

送信先に接続可能なプロデューサ数を指定します。この制限に到達すると、新たなプロデューサは生成できません。-1は無制限を意味します。既定値は-1です。

--maxTotalMsgBytes

送信先に滞留可能なメッセージの最大合計サイズ（バイト単位）を指定します。-1は無制限を意味します。既定値は-1です。

--isLocalOnly

ローカル配信のみかどうかを指定します。送信先の作成後は変更できません。true：ローカルコンシューマ (送信先が作成されたブローカに接続しているコンシューマ) だけにメッセージを配信するように制限されます。false：クラスタ内のすべてのコンシューマが配信対象となります。既定値はfalseです。

--localDeliveryPreferred

ローカル配信優先かどうかを指定します。true：メッセージは、ローカルのJMSサーバにコンシューマが存在しない場合にのみ、リモートコンシューマに配信されます。この場合は、ローカル配信のみかどうかの指定(isLocalOnly)をfalseにする必要があります。false：ローカル、リモートに関係なく、準備のできているコンシューマへメッセージを配信します。既定値はfalseです。

--property

作成される送信先をさらにカスタマイズするためにJMS特有の属性を指定するのに使用される名称/値

オペランド

dest_name

JMS送信先の名称。Java識別子となるあらゆる名称が有効です。具体的には、英数字と、"_"、"$"が使えます。先頭の文字として、数字を使うことはできません。

使用例

例1: create-jmsdestの使用法
otxadmin> create-jmsdest --user admin --password adminadmin --host bluestar --port 6212 --desttype queue --maxNumMsgs 10000 --maxNumProducers 10 MyPhysicalQueue
Command create-jmsdest executed successfully

終了ステータス

0 :	コマンド実行成功
1 :	コマンド実行失敗

関連事項

create-jms-resource(1) delete-jmsdest(1) list-jmsdest(1)