setmqenv ( IBM MQ 環境の設定)
setmqenv コマンドを使用して、 UNIX, Linux®, and Windows上に IBM® MQ 環境をセットアップします。
目的
setmqenv コマンドを使用して、 IBM MQのインストールで使用する環境を自動的にセットアップできます。 あるいは、 crtmqenv コマンドを使用して環境変数と値のリストを作成し、システムの各環境変数を手動で設定することもできます。詳しくは、 crtmqenv ( IBM MQ 環境の作成) を参照してください。
注: 環境に対して行った変更は永続的ではありません。 ログアウトして、再度ログインすると、変更は失われます。
環境をセットアップする対象となるインストールを指定するには、キュー・マネージャー名、インストール名、またはインストール・パスを指定します。 setmqenv コマンドにパラメーター -s を指定して発行することで、このコマンドが発行されたインストール用の環境をセットアップすることもできます。
setmqenv コマンドは、ご使用のシステムに合わせて次の環境変数を設定します。
- CLASSPATH
- INCLUDE
- LIB
- MANPATH
- MQ_DATA_PATH
- MQ_ENV_MODE
- MQ_FILE_PATH
- MQ_JAVA_INSTALL_PATH
- MQ_JAVA_DATA_PATH
- MQ_JAVA_LIB_PATH
- MQ_JAVA_JVM_FLAG
- MQ_JRE_PATH
- PATH
UNIX and Linux システムでは、 -l フラグまたは -k フラグが指定されている場合は、以下のようになります。
- LIBPATH 環境変数は、 AIX®で設定されます。
- 以下のプラットフォームでは LD_LIBRARY_PATH 環境変数が設定されます。
- HP-UX
- Linux
- Solaris
使用上の注意
- setmqenv コマンドは、環境をセットアップする対象のインストール済み環境に新しい参照を追加する前に、すべての IBM MQ インストール済み環境のすべてのディレクトリーを環境変数から削除します。 したがって、 IBM MQを参照する追加の環境変数を設定する場合は、 setmqenv コマンドを発行した後でそれらの変数を設定します。 例えば、
MQ_INSTALLATION_PATH
/java/lib - 一部のシェルでは、コマンド行パラメーターは setmqenv で使用することはできず、発行された setmqenv コマンドは
setmqenv -s
コマンドであると見なされます。 このコマンドは、setmqenv -s
コマンドが発行されたかのようにコマンドが実行されたことを示す通知メッセージを生成します。 そのため、これらのシェルでは、必ず環境を設定する対象となるインストール済み環境からこのコマンドを発行する必要があります。 これらのシェルでは、LD_LIBRARY_PATH 変数を手動で設定する必要があります。 crtmqenv コマンドに -l または -k パラメーターを指定して使用し、LD_LIBRARY_PATH 変数および値をリストします。 次に、この値を使用して、LD_LIBRARY_PATH を設定します。
Syntax
オプション・パラメーター
- -m QMgrName
- キュー・マネージャー QMgrName に関連付けられているインストール用に環境を設定します。
- -n InstallationName
- InstallationName という名前のインストールの環境を設定します。
- -p InstallationPath
- パス InstallationPath にあるインストールの環境を設定します。
- -r
- すべてのインストールを環境から削除します。
- -s
- setmqenv コマンドを発行したインストールの環境を設定します。
- -k
- UNIX and Linux のみ。
- -l
- UNIX and Linux のみ。
- -x モード
- Mode の値は、32 または 64 になります。
戻りコード
戻りコード | 説明 |
---|---|
0 | コマンドは正常に終了しました。 |
10 | コマンドは終了しましたが、予期しない結果が出ました。 |
20 | 処理中にエラーが発生しました。 |
例
以下の例では、 IBM MQ のコピーが UNIX システムまたは Linux システムの /opt/mqm ディレクトリーにインストールされていることを前提としています。
注: 各コマンドの先頭にピリオド文字
(.)
を使用すると、 setmqenv スクリプトが現行シェルで実行されます。 そのため、setmqenv スクリプトによる環境の変更は、現行シェルに対して適用されます。 ピリオド文字 (.)
を付けないと、別のシェル内の環境変数が変更され、コマンドの発行元シェルには変更が適用されません。- 次のコマンドは、/opt/mqm ディレクトリーにインストールされているインストールの環境をセットアップします。
. /opt/mqm/bin/setmqenv -s
- 次のコマンドは、/opt/mqm2 ディレクトリーにインストールされているインストール用に環境をセットアップし、LD_LIBRARY_PATH 変数の現在の値の最後に、このインストールへのパスを含めます。
. /opt/mqm/bin/setmqenv -p /opt/mqm2 -l
- 次のコマンドは、キュー・マネージャー
QM1
の環境を 32 ビット環境でセットアップします。. /opt/mqm/bin/setmqenv -m QM1 -x 32
以下の例では、 Windows システム上の C:\Program Files\IBM\MQ に IBM MQ のコピーがインストールされていることを想定しています。 次のコマンドは、
Installation1
という名前のインストールの環境をセットアップします。
"C:\Program Files\IBM\MQ\bin\setmqenv.cmd" -n Installation1