createWMQQueue コマンド
createWMQQueue コマンドを使用して、特定の有効範囲で WebSphere® MQ メッセージング・プロバイダーのキュー・タイプ宛先を作成します。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは、Qshell から実行されます。
詳しくは、『WebSphere Application
Server スクリプトを実行するための Qshell の構成』のトピックを参照してください。
このコマンドは、WebSphere Application Server バージョン 7 以降のアプリケーション・サーバーで使用した場合にのみ有効です。 これより前のバージョンでは使用しないでください。
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
目的
createWMQQueue コマンドを使用して、特定の有効範囲で WebSphere MQ メッセージング・プロバイダーのキュー・タイプ宛先を作成します。
- 同じ有効範囲において、同じ名前の WebSphere MQ メッセージング・プロバイダーのキュー・タイプ宛先が既に存在している。
- JNDI 名が、WebSphere Application Server JNDI 内の別の項目と競合している。
ターゲット・オブジェクト
WebSphere MQ メッセージング・プロバイダーのキュー・タイプ宛先を作成する、WebSphere MQ メッセージング・プロバイダーの有効範囲。
必須パラメーター
- -name
- この WebSphere MQ メッセージング・プロバイダーのキュー・タイプ宛先に割り当てられる管理名。
- -jndiName
- このオブジェクトを WebSphere Application Server JNDI にバインドするために使用する名前。
- -queueName
- WebSphere MQ メッセージング・プロバイダーのキュー・タイプ宛先定義に対するメッセージの保管に使用する、WebSphere MQ キューの名前。
オプション・パラメーター
- -description
- キュー・タイプ宛先に割り当てられる管理説明。
- -qmgr
- WebSphere MQ キューをホストするキュー・マネージャー。
- -persistence
- このパラメーターは、この宛先に送信されるメッセージの保管に使用するパーシスタンス・レベルを決定します。
以下のいずれかの値を指定します (大/小文字が区別されます)。
- APP
- QDEF
- PERS
- NON
- HIGH
デフォルト値は APP です。
- -priority
- この宛先に送信されるメッセージに割り当てる優先順位。以下のいずれかの値を指定します。
- APP注: (APP は大/小文字の区別があります)
- QDEF注: (QDEF は大/小文字の区別があります)
- <0 から 9 の範囲の正整数>
デフォルト値は APP です。
- APP
- -expiry
- この宛先に送信されたメッセージの有効期限が切れ、後処理オプションに従って処理されるまでの期間。
以下のいずれかの値を指定します。
- APP注: (APP は大/小文字の区別があります)
- UNLIM注: (UNLIM は大/小文字の区別があります)
- <任意の正整数>
デフォルト値は APP です。
- APP
- -ccsid
- コード化文字セット ID (CCSID)。
このパラメーターの値は正整数またはブランクである必要があります。詳しくは、IBM MQ メッセージング・プロバイダーのキューおよびトピックの拡張プロパティー設定を参照してください。
デフォルト値は 1208 です。
このフィールドを空にした場合、デフォルト値を使用する必要があることを示します。
- -useNativeEncoding
- このパラメーターは、ネイティブ・エンコードを使用するかどうかを指定します。
指定可能な値は、true または false です。
true に設定した場合、-integerEncoding、-decimalEncoding、および -floatingPointEncoding 属性の値は無視されます。
false に設定した場合は、-integerEncoding、-decimalEncoding、および -floatingPointEncoding 属性によってエンコードが指定されます。
- -integerEncoding
- このキューの整数エンコード設定。
Normal または Reversed のいずれかの値を指定します (大/小文字が区別されます)。
デフォルト値は Normal です。
- -decimalEncoding
- このキューの 10 進数エンコード設定。
Normal または Reversed のいずれかの値を指定します (大/小文字が区別されます)。
デフォルト値は Normal です。
- -floatingPointEncoding
- このキューの浮動小数点エンコード設定。
IEEENormal、IEEEReversed、または z/OS のいずれかの値を指定します (大/小文字が区別されます)。
デフォルト値は IEEENormal です。
- -useRFH2
- このパラメーターは、targetClient とも呼ばれるこの宛先に送信されるメッセージに、RFH バージョン 2 ヘッダーを付加するかどうかを決定します。
true または false (それぞれ、JMS targetClient または MQ targetClient と等価です) のいずれかの値 (大/小文字の区別があります) を入力します。
デフォルト値は true (JMS targetClient) です。
- -sendAsync
- このパラメーターは、キュー・マネージャーからメッセージが到着したことに対する確認応答がなくても
メッセージをこの宛先に送信できるかどうかを決定します。
YES、NO、または QDEF のいずれかの値を指定します (大/小文字が区別されます)。
デフォルト値は QDEF です。
- -readAhead
- このパラメーターは、非パーシスタント・コンシューマーのメッセージを先読みおよびキャッシュできるかどうかを決定します。
YES、NO、または QDEF のいずれかの値を指定します (大/小文字が区別されます)。
デフォルト値は QDEF です。
- -readAheadClose
- このパラメーターは、メッセージ・コンシューマーの先読みクローズ方法を指定します。
DELIVERALL または DELIVERCURRENT のいずれかの値を指定します (大/小文字が区別されます)。
デフォルト値は DELIVERALL です。
- -customProperties
- このパラメーターは、WebSphere MQ メッセージング・プロバイダーのキュー・タイプ宛先の実装に渡されるカスタム・プロパティーを指定します。
通常、カスタム・プロパティーは、WebSphere 管理インターフェースで直接的にはサポートされないキュー・タイプ宛先の属性を設定するために使用します。各カスタム・プロパティーは、name および value テーブル・ステップ・パラメーターを使用して指定します。 これらはテーブル・ステップであるため、2 つのパラメーターの順序は固定であり、必ず name を最初に、value を 2 番目に指定する必要があります。
- Jython の場合: [name value]
- Jacl の場合: {name value}
以下の例では、WebSphere MQ メッセージング・プロバイダーのキュー・タイプ宛先を作成しています。
- Jython の使用:
wsadmin>AdminTask.createWMQQueue("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)", ["-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1"])
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)
- Jacl を使用:
wsadmin>$AdminTask createWMQQueue 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1}
queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQQueue_1098737234986)