Interstage Application Server リファレンスマニュアル（コマンド編）

17.6 jmsmkfact

名前

　jmsmkfact　−　ConnectionFactory定義の登録

形式

　jmsmkfact [-t | -q] -i <client-id> [-x] <jndi-name> [-M system]
　jmsmkfact -o [-t | -q] [-i <client-id>] [-x] <jndi-name> [-M system]

機能説明

　JMSのConnectionFactory定義を登録します。指定できるオプションとパラメタを以下に示します。

-o

　登録時に、同名のConnectionFactory定義がすでに存在する場合に上書きします。同名のConnectionFactory定義が存在しない場合は、新規に登録します。
　本オプションを省略した場合は、同名のConnectionFactory定義が存在しない場合に登録します。

-t

　ConnectionFactoryのタイプがTopicConnectionFactoryの場合に指定します。
　-oオプション指定時に本オプションを省略すると、すでに登録されている情報が使用されます。

-q

　ConnectionFactoryのタイプがQueueConnectionFactoryの場合に指定します。
　-oオプション指定時に本オプションを省略すると、すでに登録されている情報が使用されます。

-i <client-id>

　ConnectionFactory定義に設定するクライアント識別子を指定します。JMSプロバイダは、durable Subscriberを識別するための情報として使用します。
　-oオプション指定時に本オプションを省略すると、すでに登録されている情報が使用されます。

-x

　グローバルトランザクション機能を使用する場合に指定します。
　-tオプションと共に指定した場合は、グローバルトランザクション機能をサポートするTopicConnectionFactoryとなります。
　-qオプションと共に指定した場合は、グローバルトランザクション機能をサポートするQueueConnectionFactoryとなります。
　-oオプション指定時に-tオプション、-qオプションと共に本オプションを省略すると、すでに登録されている情報が使用されます。

<jndi-name>

　ConnectionFactory定義に登録するJNDI名を指定します。JMSアプリケーションは指定したJNDI名を使用してConnectionFactory定義を取得することができます。

-M system

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

注意事項

• 本コマンドは、旧バージョン互換コマンドです。本バージョンでは、isj2eeadminコマンドを使用することをお勧めします。
• Solarisシステム、Linuxシステムの場合、本コマンドは管理者権限で実行してください。
• 新規登録の場合は、-tオプション、-qオプション共に省略すると、-tオプションを指定した動作となります。
• -oオプションを指定して登録済みの定義に上書きする場合は、-tオプション、-qオプション、-iオプション、または-xオプションを任意に指定してください。
• -Mオプションで拡張システム名を指定した場合、-xオプションは指定できません。
• jmsmkfact、jmsmkdst、jmsrmfact、jmsrmdstの各コマンド実行中は、本コマンドを実行することができません。また、JMSアプリケーション実行中は、本コマンドを実行できない場合があります。
• JNDI名およびクライアント識別子の制限として、以下があります。
  • 使用可能な文字種は、アルファベット（大文字小文字ともに）、数字、ピリオド(.)、コロン（:）、アンダースコア（_）、ハイフン（-）、スラッシュ（/）です。スラッシュは、JNDI名のアトミック名の区切り文字として認識されます。
  • アトミック名およびクライアント識別子の先頭文字は、アルファベット＋数字のみ指定可能です。
  • JNDI名の場合は、指定したJNDI名の先頭に「java:comp/env/jms/」を自動的に付加します。JMSアプリケーションからJNDI名を参照する場合は、「java:comp/env/jms/」を付加してください。
  • 指定可能な最大文字列長は、255バイトです。ただし、JNDI名は「java:comp/env/jms/」より後ろが255バイト以下となります。
• JNDI名に以下の文字を含めて設定した場合、Interstage管理コンソールを使用してConnectionFactoryの一覧を表示すると、エラーメッセージ“jms9997”が出力され操作することができません。Interstage管理コンソールを使用する場合は、JNDI名およびクライアント識別子には、以下の文字を含めないでください。
  • コロン(:)
• JNDI名"TopicCF001"のConnectionFactory定義は、TopicConnectionFactoryタイプのデフォルト定義として登録されています。また、JNDI名"QueueCF001"のConnectionFactory定義は、QueueConnectionFactoryタイプのデフォルト定義として登録されています。
  デフォルト定義は、-oオプションを指定して以下の設定内容を変更できます。
  • クライアント識別子（-iオプションで指定）
  • グローバルトランザクション機能の使用の有無（-xオプションで指定）

使用例

　クライアント識別子が「client1」で、JNDI名が「java:comp/env/jms/TestTopicFactory」というTopicConnectionFactoryタイプのConnectionFactory定義を新規に登録する場合

jmsmkfact -t -i client1 TestTopicFactory

　クライアント識別子が「client1」で、JNDI名が「java:comp/env/jms/TestQueueFactory」というQueueConnectionFactoryタイプのConnectionFactory定義を新規に登録する場合

jmsmkfact -q -i client1 TestQueueFactory

　JNDI名が「java:comp/env/jms/TestTopicFactory」というConnectionFactory定義のクライアント識別子を「client2」に変更する場合

jmsmkfact -o -i client2 TestTopicFactory